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

Step 2:

Execute this file.

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

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

Step 3:

Answer prompts from the install script.

1. Press enter to start the procedure

2. Press enter to read 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 loaded, if the default is not OK and press enter. If the default is OK, simply press enter. Note that no tests have been done with paths that contain spaces.

5. Wait while the installation of Python, etc occurs. There will typically be a long delay while nothing happens followed by a series of messages as packages are installed.

Step 4:

After Python and packages are installed, the GSASII/bootstrap.py file (also called bin/gsas2-install.py) is invoked to install the GSAS-II files using program svn (subversion) from the APS server https://subversion.xray.aps.anl.gov/pyGSAS

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.

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

Once the svn command is executed a large number of files are downloaded ending with display of the current GSAS-II version number.

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..." is expected for this installation (and will eventually be removed).

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.