Debian Codegraph @

docs/source/install/win_detailsource.rst

raw
1 Windows detailed install from source instructions
2 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
3 .. _winsource:
4
5 #. RAW on windows can be installed using 64 bit or 32 bit python. Unless you know
6 you need a 32 bit build, you should install the 64 bit version. Some libraries,
7 such as pyFAI, maybe hard to install on 32 bit windows.
8
9 #. Download and install the Microsoft Visual C++ 14.2 Standalone: Build Tools for Visual Studio 2019.
10
11 * `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 <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>`_
12
13 * Download from here: https://visualstudio.microsoft.com/downloads/#build-tools-for-visual-studio-2019
14
15 * Run the installer and install the C++ build tools with the default options.
16
17 #. Install Miniconda python distribution
18
19 * Download the free miniconda python 3.x, e.g. 3.8, installer from:
20 `https://docs.conda.io/en/latest/miniconda.html <https://docs.conda.io/en/latest/miniconda.html>`_
21
22 * Make sure you get the python 3.x version!
23
24 * Pick the appropriate 64 bit/32 bit version (64 bit recommended!).
25
26 * Run the installer with the default options.
27
28 * More detailed install instructions are available here:
29 `https://conda.io/docs/user-guide/install/windows.html <https://conda.io/docs/user-guide/install/windows.html>`_
30
31 #. Install the necessary python packages
32
33 * Open an anaconda prompt by clicking on the start menu -> All Programs -> Anaconda3 -> Anaconda Prompt
34
35 * Run the following commands in the anaconda prompt:
36
37 * ``conda upgrade conda pip wheel setuptools``
38
39 * ``conda install numpy scipy matplotlib pillow numba h5py cython reportlab``
40
41 * ``conda install -c conda-forge wxpython hdf5plugin fabio pyfai mmcif_pdbx svglib``
42
43 #. Download RAW from sourceforge (
44 `https://sourceforge.net/projects/bioxtasraw <https://sourceforge.net/projects/bioxtasraw>`_)
45
46 * Go to the Files tab on the linked website and download the :file:`RAW-x.y.z-Source.zip`
47 file, where :file:`x.y.z` is the version number (for example, 1.0.0).
48
49 #. Expand the downloaded zip file into the downloads folder
50
51 * Right click on the download and select :menuselection:`Extract All`
52
53 * Accept the default location for files to be extracted.
54
55 #. In Windows Explorer, confirm that the file named :file:`setup.py`
56 is in your top level expanded raw directory. If it isn’t, it’s likely that
57 when you expanded the RAW download, you ended up with unnecessary layers of
58 directories. Find the directory with :file:`setup.py` in it, and make that
59 the top level folder.
60
61 #. Build the extensions
62
63 * Open an anaconda prompt as in Step 4 of these instructions.
64
65 * Type ``cd C:\raw``
66
67 * Hit enter
68
69 * Type ``python setup.py build_ext --inplace``
70
71 * Hit enter
72
73 #. Run :file:`RAW.py` from the command line
74
75 * Open an anaconda prompt as in Step 4 of these instructions.
76
77 * Type ``cd C:\raw\bioxtasraw``
78
79 * Hit enter
80
81 * Type ``python RAW.py``
82
83 * Hit enter
84
85 #. Enjoy!
86
87 * If you have trouble with the installation, please see the
88 :ref:`solutions to common problems <wintrb>` section below.