Jump to: navigation, search

SciAnalysis is a set of Python scripts for batch processing of image data, including x-ray scattering detector images. The code was written primarily by Kevin Yager.


  1. Install Python: To use SciAnalysis, you must have Python installed (preferably Python3). There are many Python distributions that can be installed. The 'right one' depends on your preferences, operating system, etc. The canonical Python distribution can be donwloaded from You may prefer to install a version of Python that handles packages/dependencies for you; e.g. Anaconda.
  2. Install libraries: SciAnalysis uses a bunch of standard Python libraries to perform parts of the analysis. These will of course need to be installed. You can either install them one at a time yourself, or use one of the Python environments that handles this for you.
  3. Copy code
    1. Move the SciAnalysis folder somewhere on your computer. These are the primary code files (you generally shouldn't modify them).
    2. Make a copy of a "" file, and put it somewhere. (There are examples in the folder "SciAnalysis/main/examples/".) You will end up having multiple "" files on your computer (for different analyses you want to perform).
    3. Modify your "" file, updating the line (near the top) that specifies the "SciAnalysis_PATH". You should update this to point to the location where you moved the "SciAnalysis" folder.


  1. Modify a particular "" file, to specify the detector calibration, the mask, the files you want to analyze, and the protocols you want to run.
  2. Use Python to run the file. For example:
    python3 ./

See Also