You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: webdocs/install-g2f-linux.rst
+18-1Lines changed: 18 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -32,7 +32,24 @@ The exact details for how the installation is performed will depend on "flavor"
32
32
:alt:completion commands in terminal window
33
33
:align:right
34
34
35
-
2) This will run for a few minutes (or longer depending on download speeds) and then the conda installation process will start, with the display of lots of text. At the end, the terminal window will appear as seen to the right. Note the addition of the GSASII file on the desktop (this may not happen on all Linux desktop managers.). The installation has been completed.
35
+
Note that binary compatibility between Linux systems is not all that
36
+
good. The above is constructed on an Ubuntu 24.04.2 LTS GitHub runner, but
37
+
that will not run on APS Redhat Enterprise Linux systems. For RHEL a
38
+
separate installer is available. Use this command, instead::
2) The previous install step will run for a few minutes (or longer depending on download speeds) and then the conda installation process will start, with the display of lots of text. At the end, the terminal window will appear as seen to the right. Note the addition of the GSASII file on the desktop (this may not happen on all Linux desktop managers.). The installation has been completed.
Copy file name to clipboardExpand all lines: webdocs/install.rst
+13-3Lines changed: 13 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -61,7 +61,16 @@ where:
61
61
62
62
<install-loc> is where you want to install the software. (Use of ``~/g2main``, a subdirectory named ``g2main`` in your home directory is a good choice.)
63
63
64
-
More complete installation instructions are provided for `Linux separately <install-g2f-linux.html>`_.
64
+
More complete installation instructions are provided for `Linux
65
+
separately <install-g2f-linux.html>`_.
66
+
67
+
Note that binary compatibility between Linux systems is not all that
68
+
good. The above is constructed on an Ubuntu 24.04.2 LTS GitHub runner, but
69
+
that will not run on APS Redhat Enterprise Linux systems. For RHEL a
70
+
separate installer is available. Use this command, instead::
This creates a conda virtual environment named ``GSASII`` (this can be changed) for use by GSAS-II. While it is also possible to install GSAS-II into the conda base environment, this is not recommended as it can create conflicts between Python and package versions needed by GSAS-II and those required by other packages. (If you choose to do this anyway, be sure to specify ``conda install python=3.11 briantoby::gsas2pkg`` as Python is likely to be pinned to a different version.)
97
+
This creates a conda virtual environment named ``GSASII`` (this can be changed) for use by GSAS-II. While it is also possible to install GSAS-II into the conda base environment, this is not recommended as it can create conflicts between Python and package versions needed by GSAS-II and those required by other packages. (If you choose to do this anyway, be sure to specify ``conda install python=3.13 briantoby::gsas2pkg`` as Python is likely to be pinned to a different version.)
89
98
90
99
After this command is run, use command ``conda activate GSASII`` to access the
91
100
conda environment that has been created. On Linux and MacOS computers, two shortcut commands will then be available in the path, The first command, ``gsasII.sh``, which will start GSAS-II. This can optionally be used as ``gsasII.sh project.gpx`` to open existing project file ``project.gpx`` in GSAS-II. The second command, ``reset-gsasII.sh`` will rarely be used. This command will download the latest version of GSAS-II and update to that version, replacing any locally modified files with the original versions. This can be used to update GSAS-II when the program will not start, so the normal Help->Update menu command cannot be accessed. (Shortcuts available with gsas2pkg v5.1+.)
@@ -102,7 +111,8 @@ A small number of users or sites prefer to use Python distributions supplied via
102
111
`found here <install-pip.html>`_. Independent of how Python is installed, multiple packages are needed, please see the
103
112
`discussion on Python package requirements <https://gsas-ii.readthedocs.io/en/latest/packages.html#gui-requirements>`_, noting that the GSAS-II GUI requires at a minimum wxPython, matplotlib,
104
113
PyOpenGL, NumPy and SciPy, while for scripting use, only NumPy and SciPy are required. For full functionality, several other optional packages are needed.
105
-
If versions other than those recommended are selected (Python=3.11 and NumPy=1.26), you will likely need to either locate older binaries and install them manually or compile them yourself (`see compilation information <https://advancedphotonsource.github.io/GSAS-II-tutorials/compile.html>`_).
114
+
If versions other than those recommended are selected (
115
+
Python=3.13 with NumPy=2.2 or Python=3.11 with NumPy=1.26), you will likely need to either locate older binaries and install them manually or compile them yourself (`see compilation information <https://advancedphotonsource.github.io/GSAS-II-tutorials/compile.html>`_).
106
116
107
117
A simple way to install GSAS-II with a supplied Python environment uses the ``gitstrap.py`` script provided for this purpose. Use these commands (on any platform) to install GSAS-II::
0 commit comments