Installing GSAS-II with a Single-Step Download (with figures)

This process downloads an installer that will place a working version of Python and the required packages onto your computer, it will then initially install a slightly out-of-date version of GSAS-II including the binaries files needed for running on a Mac. Finally, the distribution site will be checked and updates will be applied to bring GSAS-II up to date (usually with minor download requirements). The installer can be moved to and run on computers without an internet connection, but the update step will fail, leaving a working up not out-of-date version of GSAS-II.

Step 1:

Open a terminal window (use the Terminal app in Applications/Utilities folder; typing terminal.app into the finder search box should find this for you).

In that window cut and paste the three commands below:

mkdir -p ~/.conda
g2="https://subversion.xray.aps.anl.gov/admin_pyGSAS/downloads/gsas2full-latest-MacOSX-x86_64.sh"
curl "$g2" > /tmp/g2.sh; bash /tmp/g2.sh

Note that this will fail if your network requires a proxy to access the internet. In that case you can download the file with a browser and run it using steps listed below. You will need to know the proxy information in order to get GSAS-II to properly update. If you want to install GSAS-II onto a computer that does not have an internet connection (or has a slow or expensive connection, subsequent downloads will be small), use those steps and then move the downloaded file on a USB stick, etc.

Step 2:

Answer prompts from the install script.

1. Press enter to start the procedure

2. Press space several times to page through the copyright notice

3. Type "yes" to accept the copyright information and start the installation.

4. Enter a location for where the files should be installed, if the default is not what you prefer. The default will usually be OK, in which case you can simply press enter. Installation has not been tested where paths contain spaces or special characters, so it is a good idea to install GSAS-II in an alternate location if the default has spaces or Unicode characters. Note that GSAS-II cannot be moved once installed. If you need it to move it please reinstall and delete the old copy.

Make a note of where you have installed GSAS-II; this will be needed if you have problems with the software.

5. Pressing enter to accept the default installation location or providing a installation location will trigger installation of the software with a series of messages. If the installation progresses normally, the final messages will appear as below:

If error or warning messages are seen, it is suggested that you save a screen image or use cut and paste to save the text in the window to a file. The most common error message is discussed below.

6. It is recommended that you type "no" for the question about initializing gsas2full using conda init as it is not needed to run GSAS-II. If you say "yes" or use the default, then the version of Python installed by GSAS-II becomes the default version, which usually will not cause problems either. The installation completes with these messages (which can be ignored):

Update Error Message

After Python and packages are installed, the GSASII/bootstrap.py file is invoked. This tests that the GSAS-II binaries files work, creates shortcuts and updates the GSAS-II files using program svn (subversion) from the APS server https://subversion.xray.aps.anl.gov/pyGSAS. The svn update requires a working internet connection. If the svn program is not able to update properly then this

Note that the location of the Python image is shown here (/Users/toby/g2full/bin/python) this is worth noting in case you have installation problems and need to rerun the bootstrap.py script (see below).

There will be a brief delay while the installer script processes the files and creates a shortcut app for starting GSAS-II. Note that the warning message "Sorry, failed to find..." will occur with older installers.

Then an svn command is executed an update to the current GSAS-II version number and newer files are downloaded (if an internet connection is available.) This script requests the name of a proxy server. Most people will use the default and press return. However, some sites block web traffic unless it is passed through a particular computer. If needed, enter that computer name or IP address here (e.g. proxyout.lanl.gov). You will be requested to also supply a port number, which defaults to 8080.

The final question to be asked is should the installation location be placed into your system's path. If you plan to run other Python scripts from the command line, you may want to type "yes", but this is not needed for GSAS-II, so the suggested answer is "no".

The Python and GSAS-II installation is now complete, and you can close the terminal window, but there are some optional steps you may want to complete.

Step 5: (optional)

The installation procedure creates an app to help launch GSAS-II and places that app in the GSAS-II folder. It also opens a Finder window, showing that app, as below. This app will not run if moved to another location, but it can be dragged to the toolbar, as is shown below.

Step 6: (optional)

If you would like place the GSAS-II app in another location (for example your computer's desktop) to make it convenient to start GSAS-II, you need to make an alias. The alias can be moved. Press control and click on the GSAS-II app (or use right-click with a 2 or 3 button mouse) and a menu of options is shown. Click on "Make Alias" and a new file, "GSAS-II alias" is created in that folder.

Note that the "GSAS-II alias" file can be dragged to the desktop, or wherever it is convenient for your use.

Installing with a web proxy or to a system without the internet

Step A1:

Download this file in a web browser:

• ​https://subversion.xray.aps.anl.gov/admin_pyGSAS/downloads/gsas2full-Latest-MacOSX-x86_64.sh (provides Python 3.7, all required Python packages and a recent version of GSAS-II which will be updated via the internet; can be installed on computers without an internet connection, but without that update.)

Step A2:

Execute this file.

Type "bash " into a terminal window, then drag the downloaded file from a finder window into the terminal window.

This places the file name with full path name into the terminal window, then press Enter.

Older installers

These links offer an older distributions that have worked for many people, if you have trouble with the previous (but please do report problems). Note that these installers require an internet connection to complete the installation:

• ​https://subversion.xray.aps.anl.gov/admin_pyGSAS/downloads/g2conda-1.0.1-MacOSX-x86_64.sh (Python 3.7, wxPython 4.0.3, NumPy 1.51.1, SciPy 1.1.0, matplotlib 2.2.3,...)
• ​https://subversion.xray.aps.anl.gov/admin_pyGSAS/downloads/g2conda-py27-1.0.2-MacOSX-x86_64.sh (Python 2.7.x, wxPython 3.0.0...)
• g2conda-0.1.2-MacOSX-x86_64.sh from this URL ​https://anl.box.com/v/GSASII4mac12 (quite old, not recommended)