Version 19 (modified by toby, 3 years ago) (diff)


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 into the finder search box should find this for you).

In that window cut and paste the three commands below:

mkdir -p ~/.conda
curl "$g2" > /tmp/; bash /tmp/

screen image with file download & start of self-installer

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
  1. Press space several times to page through the copyright notice

start of "license" information

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

End of "license" information

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

enter install location

  1. 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:

after successful install

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.

  1. 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):

after successful install completed

Step 3:

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 (labeled as GSAS-II), as below. This app will not run if moved to another location, but it can be dragged to the toolbar, as is shown below. It may not appear with the GSAS-II icon, as shown in the figure (the reason for this is not yet understood.)

Confirm that GSAS-II can run from this app by double-clicking on it. The first time this is done, you will likely be asked to confirm this app should have access to the Terminal app with this message:

permissions message

Click OK and three windows should open (the terminal window, the GSAS-II main window and the GSAS-II Plots window).

Step 4: (drag to dock, optional)

The GSAS-II app created by the installation procedure can be dragged to the dock to make launching GSAS-II simple. Note the app will not run if moved to another location, such as the desktop. See the next step on how to create a desktop icon.

Step 5: (Desktop icon, 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. This alias file 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. It can also be renamed after the file is moved.

Update Error Message

After Python and packages are installed, the GSASII/ 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 The svn update requires a working internet connection. If the svn program is not able to update properly then this error message is shown:

proxy or no internet error

If there computer does not have an internet connection, this error is expected and can be ignored. If the computer is later connected to the internet, you are recommended to use the

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

Step A1:

Download this file in a web browser:

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:

Attachments (24)

Download all attachments as: .zip