Installing GSAS-II with Canopy Python on Mac OS X 10.12

Note that the single-step installer for GSAS-II? on Macs is probably easier to use than the instructions below, I suggest using them only if there is a particular reason you want to use Canopy Python.

1. Load subversion (svn)

(Note that this is process has not been tested recently.) Open a terminal window (in Finder navigate through Applications/Utilities/Terminal) type svn in that window.

The response is an error (as above), but the following dialog box also pops up:

Click on “Install” in the dialog window pops up saying the svn command requires the command-line developer tools. Would you like to install the tools now? Press Install.

The install takes a few minutes.

Confirm that svn was installed. This time when svn is typed in the terminal, the response is "Type 'svn help' for usage," as below.

Note that command-line subversion (svn) can be installed in many other ways, such as installing Xcode from the App Store or a number of other downloads for Macs. (I could not see how to install just the Apple "Command line developer tools" from the App store.)

2. Download and Install Canopy for Mac OS X

• Download a Canopy installer from ​https://store.enthought.com/downloads/. Use the standard installer (unless you want the full installer for some other reason) also select Python 2.7 and not Python 3.5 (since only 2.7 has wxPython.) FYI the URL I used was ​https://store.enthought.com/downloads/installer/182/.

• Open the downloaded .dmg file (canopy-2.1.9.macosx-x86_64-cp27.dmg for me) by double-clicking on it in finder. This shows a folder that can be dragged to where you want to install it (which need not be the system Applications folder)

• Control-click on the canopy.app file and select Open from the menu to start it for the 1st time (this will raise the message “Canopy.app is from an unidentified developer…”) — click on Open to run it.

Note: That you may need a admin account to run the app for the 1st time depending on your security preferences

• Once installation is complete (at least a few minutes) you will see the Canopy application. Select the Package Manager. At that point, I updated all packages, but this is optional.

• (In the package manager, I then confirmed that numpy, scipy, matplotlib, wxpython, pillow, hdf5 were installed as part of the standard install -- nothing needs to be done.)

• Also in the package manager, install the pyOpenGL, h5py, imageio packages

• Create a new directory for GSASII and download the bootstrap.py file to this directory from ​​https://subversion.xray.aps.anl.gov/pyGSAS/install/. Two ways to do this are with commands:

    cd <path>
    svn export https://subversion.xray.aps.anl.gov/pyGSAS/install/bootstrap.py .

or by loading this URL in a browser: ​

    https://subversion.xray.aps.anl.gov/trac/pyGSAS/browser/install/bootstrap.py?format=txt

and then move this file to <path>.

• There are two ways to run this bootstrap.py file:

Open this file with the Canopy editor using the File/Open menu command and run it using the Run/Run File (or use the blue triangle in the toolbar), answer questions in the lower right Python box.

It is also possible to run this file using the Tools/"Canopy terminal” menu command. Type python and at least one space, then drag the bootstrap.py file from a finder window (or type it with the full path)

• After bootstrap.py starts, you will be asked a series of questions (if running from the Canopy editor, answer questions in the Python panel to the lower right.) See here for an example of what to expect.

• Once the bootstrap.py script completes, you can put the GSASII.app file into the doc (shown here) and/or create an alias as shown here, which can be moved to another folder or the desktop.