wiki:WinCanopyInstall

Installing GSAS-II on Windows with CanopyExpress

You will need to know if you are running 32- or 64-bit Windows (click here if you are not sure).

  1. Download the free CanopyExpress package from Enthought, Inc. download page. (Supplying an e-mail address is optional.) Select the 32-bit version (upper right) if on 32-bit Windows. For 64-bit Windows, either version can be used, but we recommend the 64-bit version as that will handle much larger refinement projects.

You will download a file such as canopy-1.5.2-win-32.msi (32-bit) or "canopy-1.5.2-win-64.msi (64-bit). Click on that file to launch the Windows software installer. Most users can use all the default installation options.

When the installation is nearly complete, you are given an option to make Canopy the default Python option. Using the default is not required, but makes later installation steps much easier. Click on the "Start Using Canopy" button.

  1. Download file ​https://subversion.xray.aps.anl.gov/pyGSAS/install/GSASIIproxy.zip. Click on this file in Windows Explorer (see screen image), you should see a single folder named GSASII (see screen image). Drag this file anywhere you want to install GSAS-II (your desktop, your Documents folder, the D: drive,...)
  1. You then need to execute the bootstrap.py file. This can be done a few different ways. The easiest is to double-click on the bootstrap.bat file (N.B. by default, no extension is shown for this). (If you did not make Canopy the default Python in step 1, above, you will need to edit bootstrap.bat to include the full path to python.exe.) Alternately, you can also use a command something like:

python \Users\<me>\Desktop\GSASII\bootstrap.py

in a "All Programs"/Enthought Canopy/"Canopy command prompt" window. Note that double-clicking on the bootstrap.py file will open it in the Canopy code editor. This can also be used to execute this install script, but this is a bit clunky.

This script will check to see that the Python packages needed to run GSAS-II are installed and that the subversion program needed to install and update from the Internet (included in the .zip file) is present. It then asks for a proxy address (see screen image).

Proxy address: For most people, pressing return to use the default (no proxy) works fine, but for some sites a proxy address such as proxyout.securesite.gov:7070 is needed. If you are not able to get the GSAS-II download to work, you probably need a proxy. Check with your network/computer administrators; anyone competent should know if a proxy is in use. Supply the address (proxyout.securesite.gov) on the first line and the port number (7070) on the second.

Note that many seemingly nasty warning messages appear when PyOpenGl is installed. This is not a problem, provided the installation and script complete normally.

After the script completes, a file named RunGSASII.bat is created with the locations of GSAS-II and Python hard-coded. You should have a shortcut to start GSAS-II on your desktop linked to that .bat file (see screen image). GSAS-II project files (with extension .gpx) will appear with the same icon and clicking on them will open them in GSAS-II.

Note also that the bootstrap.py (or bootstrap.bat) file can be rerun without problems. If there are any updates to GSAS-II they will be downloaded, but only any new files will be downloaded and the script should complete very quickly.

Last modified 7 years ago Last modified on May 26, 2015 5:44:59 PM

Attachments (4)

Download all attachments as: .zip