Windows detailed install from source instructions

1. RAW on windows can be installed using 64 bit or 32 bit python. Unless you know you need a 32 bit build, you should install the 64 bit version. Some libraries, such as pyFAI, maybe hard to install on 32 bit windows.

2. Download and install the Microsoft Visual C++ 14.2 Standalone: Build Tools for Visual Studio 2019.

   • https://wiki.python.org/moin/WindowsCompilers#Microsoft_Visual_C.2B-.2B-_14.2_standalone:_Build_Tools_for_Visual_Studio_2019_.28x86.2C_x64.2C_ARM.2C_ARM64.29

   • Download from here: https://visualstudio.microsoft.com/downloads/#build-tools-for-visual-studio-2019

   • Run the installer and install the C++ build tools with the default options.

3. Install Miniconda python distribution

   • Download the free miniconda python 3.x, e.g. 3.8, installer from: https://docs.conda.io/en/latest/miniconda.html

     • Make sure you get the python 3.x version!

     • Pick the appropriate 64 bit/32 bit version (64 bit recommended!).

   • Run the installer with the default options.

   • More detailed install instructions are available here: https://conda.io/docs/user-guide/install/windows.html

4. Install the necessary python packages

   • Open an anaconda prompt by clicking on the start menu -> All Programs -> Anaconda3 -> Anaconda Prompt

   • Run the following commands in the anaconda prompt:

   • conda upgrade conda pip wheel setuptools

   • conda install numpy scipy matplotlib pillow numba h5py cython reportlab

   • conda install -c conda-forge wxpython hdf5plugin fabio pyfai mmcif_pdbx svglib

5. Download RAW from sourceforge ( https://sourceforge.net/projects/bioxtasraw)

   • Go to the Files tab on the linked website and download the RAW-x.y.z-Source.zip file, where x.y.z is the version number (for example, 1.0.0).

6. Expand the downloaded zip file into the downloads folder

   • Right click on the download and select Extract All

   • Accept the default location for files to be extracted.

7. In Windows Explorer, confirm that the file named setup.py is in your top level 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.

8. Build the extensions

   • Open an anaconda prompt as in Step 4 of these instructions.

   • Type cd C:\raw

   • Hit enter

   • Type python setup.py build_ext --inplace

   • Hit enter

9. Run RAW.py from the command line

   • Open an anaconda prompt as in Step 4 of these instructions.

   • Type cd C:\raw\bioxtasraw

   • Hit enter

   • Type python RAW.py

   • Hit enter

10. Enjoy!

    • If you have trouble with the installation, please see the solutions to common problems section below.