OS X and macOS install from source instructions

  1. Install Miniconda python distribution
  2. Install the necessary python packages.
    • Open a new terminal window as in the previous step
    • Type conda upgrade conda pip wheel setuptools and hit enter. Agree to all the prompts.
    • Type conda install numpy scipy matplotlib pillow numba h5py cython numexpr reportlab and hit enter. Agree to all the prompts.
    • Type conda install -c conda-forge wxpython hdf5plugin fabio pyfai mmcif_pdbx and hit enter. Agree to all prompts.
  3. Download RAW from sourceforge
    • https://sourceforge.net/projects/bioxtasraw
    • Navigate to the Files tab and download the latest source code, RAW-x.y.z-Source.zip. Or download the latest development version from the git by navigating to the Code tab.
  4. Expand the downloaded zip file in the Downloads folder by double clicking on it.
    • This step may not be necessary, some browsers may automatically expand zip files.
  5. In the terminal or in the graphical file manager, confirm that the file named setup.py is in your expanded raw directory. If it isn’t, it’s likely that when you expanded the RAW download, you ended up with unnecessary layers of directories. Find the directory with setup.py in it, and make that the top level folder.
  6. Move the RAW files to Applications folder
    • Move the folder that contains all of the RAW files to the Applications folder. As above, this would be the folder with setup.py in it.
    • Rename the folder that you just moved to raw.
  7. In a terminal, change directory into the top level RAW folder
    • If you used the suggested path of Applications/raw type: cd /Applications/raw
  8. Build the extensions.
    • python setup.py build_ext --inplace
  9. Navigate to the bioxtasraw subfolder
    • From the top level RAW folder it should be cd ./bioxtasraw
  10. Run RAW
    • pythonw RAW.py
  11. Enjoy!