Installing GSAS-II on Windows with CanopyExpress

You will need to know if you are running 32- or 64-bit Windows (click here ?if y
ou 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 r
ecommend 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 instal
ler. 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 i
nstallation steps much easier. Click on the "Start Using Canopy" button.
2.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 w
ant to install GSAS-II (your desktop, your Documents folder, the D: drive,...)
3.You then need to execute the bootstrap.py file. This can be done a few differe
nt ways. The easiest is to double-click on the bootstrap.bat file (N.B. by defau
lt, no extension is shown for this). (If you did not make Canopy the default Pyt
hon in step 1, above, you will need to edit bootstrap.bat to include the full pa
th 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 d
ouble-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 addre
ss (see screen image?).
Proxy address: For most people, pressing return to use the default (no proxy) wo
rks fine, but for some sites a proxy address such as proxyout.securesite.gov:707
0 is needed. If you are not able to get the GSAS-II download to work, you probab
ly need a proxy. Check with your network/computer administrators; anyone compete
nt 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 installe
d. 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 locat
ions of GSAS-II and Python hard-coded. You should have a shortcut to start GSASII 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 pro
blems. 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.