Installing GSAS-II on Windows with mini-SVN kit

Be sure to read the Windows Installation Instructions for a discussion of prerequisites for running GSAS-II.

The minimal files needed to run subversion can be downloaded as a zip file, along with a batch file that will install GSAS-II from the server.

1. Download the svn kit using one of these URLs: ​https://subversion.xor.aps.anl.gov/pyGSAS/install/GSASIIsvn.zip or ​https://subversion.xor.aps.anl.gov/trac/pyGSAS/browser/install/GSASIIsvn.zip?format=raw

2. Open the downloaded GSASIIsvn.zip in the Windows Explorer -- you should see a single folder named GSAS-II. Drag this folder to where you would like to install the software.

3. Open this folder in its new location and double-click on the bootstrap.bat file. A "DOS" (cmd.exe) window will open and you should see:

       ***********************************************************
       Please enter proxy server information, if required for your
       web environment. Note that the proxy address will be a
       computer address (proxy.mysite.com) and the proxy port will
       be a number, such as 80. If not needed or you are unsure,
       leave the next answer blank.
       ***********************************************************
       Enter the proxy address [none needed]:
   

4. If a proxy is entered in step 3, then supply a port for the proxy:

       Enter the proxy port [8080]:
   

5. You will then see this text:

       *****************************************
       Preparing to load/update GSAS-II
       *****************************************
       Press any key to continue . . .
   

Press Enter and the transfer of files should start. Note that a message like this:

svn: OPTIONS of 'https://subversion.xor.aps.anl.gov/pyGSAS/trunk': Could not con
nect to server (https://subversion.xor.aps.anl.gov)

is an indication that a proxy server may be needed.

If it runs correctly, after it completes you should see:

...
A    gsas2mac.ico
A    GSASIIstruct.py
A    ImageCalibrants.py
A    GSASIIspc.py
Checked out revision 331.
Files have been loaded. Press Return to start GSAS-II.
Press any key to continue . . .

If GSAS-II fails to start, you should debug that by starting a DOS window (use Start to run cmd.exe) and then in that window type

cd <...>\GSASII
python GSASII.py

to see what error is occurring.

After GSAS-II has been installed, it can be started by clicking on the GSASII.BAT file. Note that this file should not be moved from the installation directory. Also, it assumes that the Python package is found in the path. If this is not the case, it will be necessary to edit the .BAT file to add a full path for the python command (change python %gsasloc%\GSASII.py %1 to "C:\EPD dist\PYTHON27\python.exe" %gsasloc%\GSASII.py %1, etc.)

4. Make a desktop shortcut to GSAS-II (optional)

Right-click on the GSASII.py file and select "Create Shortcut". Drag the new shortcut to the desktop (or your preferred location). This may work for you as-is, but you may want to or need to make changes. To do that right-click on the shortcut and select properties. This opens the properties dialog. In that window make these changes:

Target: If you obtain an error where Windows does not know what program to associate with .py files, either associate them with the python installed on your computer or add the full path to python before the path to the GSASII.bat file in the "Target:" box:

C:\PYTHON27\python.exe C:\GSASII\GSASII.bat $*

If you used a directory that has spaces in the name put the names in quotes, e.g.:

"C:\EPD dist\PYTHON27\python.exe" C:\GSASII\GSASII.bat $*

Note the $* is optional, but it allows files to be "dropped" onto the shortcut.

Start in: Change this box to wherever you would like to have GSAS-II start -- where you keep your data files. (Optional)

Change Icon: Use this button to change the icon to the GSAS2.ico file in the C:\GSASII directory (optional).

You may also want to rename this shortcut.

5. Add shortcut(s) to Start Menu (optional)

Right-click on Start Menu, select open from list of choices

Left-click on Programs folder

Right-click on a blank section of folder and select new->folder to create place for shortcuts, name the new folder GSAS-II (or whatever you prefer)

Copy the shortcut(s) created above from the desktop to the new folder in Start Menu\Programs

Updating GSAS-II to the latest version

GSAS-II is updated often (sometimes daily). The version that has been installed can be determined from the revision number listed when the Help/About? GSAS-II menu is used. A summary of what is changed in each revision can be found in ​https://subversion.xor.aps.anl.gov/trac/pyGSAS/timeline. At any point, the bootstrap.bat file (see step 3, above) can be run again. When this is done, only the files that have been changed will be downloaded, so the transfer will take much less time. If you have made changes in any files, the subversion program (svn) will attempt to merge your changes with the updates on the server. This will usually succeed, but if there are conflicts, you will need to resolve them yourself before GSAS-II will run properly.