Debian Codegraph @

docs/source/install/linux_miniconda.rst

raw
1 Linux detailed install from source instructions
2 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
3 .. _lnxsource:
4
5 #. Open a new terminal window (in many distros you can right click on the desktop
6 and select :menuselection:`New Terminal` or :menuselection:`Open in terminal`).
7
8 #. Download Miniconda Python (Python 3.x, e.g. 3.8) distribution and install.
9
10 * `https://docs.conda.io/en/latest/miniconda.html <https://docs.conda.io/en/latest/miniconda.html>`_
11
12 * Make sure you chose the python 3.x installer.
13
14 * Save to the downloads folder
15
16 * Open a terminal and run the following commands:
17
18 * ``cd ~/Downloads``
19
20 * :samp:`bash ./Miniconda3{-version}.sh` (where :samp:`{-version}`
21 which will depend on the version you download)
22
23 * Accept the default installation location.
24
25 * At the end, say “yes” to have the conda python install put in your system path.
26
27 * Close the terminal window.
28
29 #. Install python packages. Open a new terminal window and run the following commands
30 (in many distros you can right click on the desktop and select :menuselection:`New Terminal`
31 or :menuselection:`Open in terminal`).
32
33 * ``conda upgrade conda pip wheel setuptools``
34
35 * ``conda install numpy scipy matplotlib pillow numba h5py cython reportlab``
36
37 * ``conda install -c conda-forge wxpython dbus-python fabio pyfai hdf5plugin mmcif_pdbx svglib``
38
39 #. Download RAW source code from sourceforge
40
41 * `https://sourceforge.net/projects/bioxtasraw/files <https://sourceforge.net/projects/bioxtasraw/files>`_
42
43 * Go to the linked website and download the :file:`RAW-x.y.z-Source.zip`
44 file, where :file:`x.y.z` is the version number (for example, 1.0.0).
45
46 #. Expand the RAW download to your location of choice.
47
48 * We suggest :file:`~/raw`
49
50 * Make sure there are no spaces in the file path (you can check by navigating
51 to the raw directory in a terminal window and using ``pwd``).
52
53 * In the terminal or in the graphical file manager, confirm that the file named :file:`setup.py`
54 is in your raw directory. If it isn’t, it’s likely that when you expanded the
55 RAW download, you ended up with unnecessary layers of directories. Find the
56 directory with :file:`setup.py` in it, and make that the top level folder.
57
58 #. In a terminal, change directory into the top level RAW folder
59
60 * If you used the suggested path of :file:`~/raw` type: ``cd ~/raw``
61
62 #. Build the extensions.
63
64 * ``python setup.py build_ext --inplace``
65
66 #. Navigate to the :file:`bioxtasraw` subfolder
67
68 * From the top level RAW folder it should be ``cd ./bioxtasraw``
69
70 #. Run RAW
71
72 * ``python RAW.py``
73
74 #. RAW is now installed. Enjoy!
75
76 * If you want, see the section on :ref:`making a desktop shortcut for RAW <lnxsrt>`.
77
78 * If RAW doesn’t work, check out the :ref:`solutions to common problems <lnxtrb>`.