| 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>`. |