BINoculars is a tool for data reduction and analysis of large sets of surface diffraction data that have been acquired with a 2D X-ray detector. The intensity of each pixel of a 2D-detector is projected onto a 3-dimensional grid in reciprocal lattice coordinates using a binning algorithm. This allows for fast acquisition and processing of high-resolution datasets and results in a significant reduction of the size of the dataset. The subsequent analysis then proceeds in reciprocal space. It has evolved from the specific needs of the ID03 beamline at the ESRF, but it has a modular design and can be easily adjusted and extended to work with data from other beamlines or from other measurement techniques.

Grab the latest sourcecode as zip or clone the Git repository. Run binoculars.py, fitaid.py, gui.py or processwizard.py directly from the command line.

The BINoculars wiki contains a detailed tutorial to get started.

If you want more complex operations than offered by the command line or GUI tools, you can manipulation BINoculars data directly from Python. Some examples with detailed comments can be found in the repository. The API documentation on the BINoculars and BINoculars.space modules can be accessed via pydoc, e.g. run pydoc -w BINoculars BINoculars.space to generate HTML files.

If you want to use BINoculars with your beamline, you need to write a backend module. The code contains an example implementation with many hints and comments.