GSAS/EXPGUI Self-Installer for Windows

Please note: A new mechanism for installing GSAS & EXPGUI is now recommended. See this link. If this method is used, EXPGUI or a batch file can be used to update GSAS & EXPGUI quickly and easily. The installer described below will be updated for the foreseeable future, but likely with less frequency.

A self-installing version of GSAS (General Structure Analysis System) and EXPGUI is available. This program uncompresses itself, copies the required files (including the Tcl/Tk files used in EXPGUI) to a selected directory and either modifies the AUTOEXEC.BAT file and/or creates the appropriate registry entries needed to run GSAS, optionally with EXPGUI. This web page documents the screens displayed by the self-installer.

The self-installer can be downloaded as file gsas+expgui.exe from Argonne ( or CCP14 (

Mailing List. If you would like to get news about about new features & bug fixes in EXPGUI, as well as have input into develop goals please join the EXPGUI mailing list at

Previous GSAS/EXPGUI versions. If you already have GSAS & EXPGUI loaded on your computer, with this installer, you can simply run the new gsas+expgui.exe file. You will get a message reminding you are upgrading and you will not be offered a choice of where to install -- files will be placed in the same directory as before.

If you previously installed using the gsaskit.exe file, you can probably do fine if you ignore the old version and follow the directions below. However, it is perhaps safer to either delete these files from your computer, or else move them into a new directory (like c:\oldgsas or c:\1999gsas) so there is no possibility that you will access any of the old programs by accident. Also, in Windows-95, -95 and -ME, remove previous references to GSAS from your AUTOEXEC.BAT file (see notes about AUTOEXEC.BAT and old Tcl/Tk files following this paragraph.) Note that it is possible to run multiple versions of GSAS using EXPGUI (by setting up shortcuts to the different copies of the expgui files in the different locations), but PC-GSAS will run the first version of the GSAS programs found in the path, and thus will run only the most recently installed version.

Previous AUTOEXEC.BAT modifications. Note that if you are using Windows-95, -98 or -ME, and had older versions of GSAS installed, you have references to GSAS in your AUTOEXEC.BAT file. You should edit this file in NOTEPAD (or SYSEDIT) to remove the references in your PATH definition. You do not need to define the GSAS environment variable anymore, unless you are using Windows-95, -98 or -ME and install the software in a location other than c:\GSAS.

Previous Tcl/Tk versions. The previous instructions for EXPGUI recommended installing the Tcl/Tk programs in a directory C:\TCL or C:\TCL823. These files are no longer needed by this version of EXPGUI, as the self-installer now places these files in the GSAS directory. Thus, the old C:\TCL or C:\TCL823 directories can be deleted to save disk space.

setup in progress window After downloading the program, start it either from the Run entry in the Start menu, or by double-clicking on the icon for the downloaded file. The "Setup in progress..." screen will appear for the minute or two (perhaps as much as fifteen minutes on a very slow computer) while the file uncompresses itself. This step has failed on some computers with previous versions of the self-installer. If you get an error message, please sent it to me.

Installer Intro screen The first screen shows the program version.

Installer Copyright Intro screen The copyright information is shown, so that all the lawyers can be happy.

Screen to select default .EXP association On this screen and the next you actually get to make some choices! You can decide what shortcuts will be provided for accessing EXPGUI and various GSAS programs. The options are explained immediately below.

Example of .EXP associations
If ".EXP association" is selected on the next screen, registry entries are created so that if one right-clicks on a .EXP file, a set of choices are offered for acting on the file, as shown above. For example, selecting EXPEDT from the pop-up menu, invokes the EXPEDT program to edit options in the file. Double-clicking (with the right mouse button) invokes the default action. The choices on the current screen, allow the selection of the which program will be invoked upon a double-click.

Screen to select shortcut options

Example of Desktop icons
If desktop icons are selected, these two icons are placed on your desktop, as above. Clicking on them will start EXPGUI and PC-GSAS. Note that the default directory for these shortcuts will be MyWork in the directory selected for GSAS installation (typically C:\GSAS\MyWork). This can be changed by editing the shortcut properties.

Example of Start menu entries
If the "Start menu" option is selected, a "GSAS + EXPGUI" menu folder is placed in your Start menu, with two items, to start EXPGUI and PC-GSAS. See above. The default directory is set as described for the desktop shortcuts. This can also be changed by right-clicking on the start menu to open it and then setting the properties for the menu entries.

The last option, if selected, causes the files described in the training section of the GSAS manual (for example, the Nickel and Garnet data files) to be placed in the GSAS work directory (typically C:\GSAS\MyWork). This makes it a bit easier to follow the examples given in the manual or on the EXPGUI tutorial web pages.

Screen to select install folder In this screen you select where the software will be installed. The default, C:\GSAS is a good choice. You can use another drive, such as G:\GSAS or another directory, such as C:\SHAREDFILES\GSAS, but there have been problems noted by people trying to directories with spaces in them, such as C:\Program Files\GSAS, so it is suggested that you do your own debugging if you do this. Note that it is acceptable to use a directory on another computer (such as a file server) but the directory must be mapped as a drive (e.g. S:\GSAS, not \\server\GSAS). Note that all files installed by the program are placed in this directory or subdirectories below. No files are placed in windows system directories, other than registry information that allows the program to be uninstalled from the control panel.

Screen to confirm options This screen summarizes the input you have supplied. Use the "Back" button to change any selections. Note that at this time, the GSAS work directory is set automatically from the location where the software will be installed.

Please wait screen This screen is displayed as the files are copied to the selected locations.

After all installation steps have been completed, the screen that says "Setup complete" is shown. After pressing "Finish" all is done. A reboot is no longer performed.

Please note that unexpected behavior in Windows seems to be the rule rather than the exception, so report problems to: tell Brian Toby. Corrections are far less likely without your feedback.

$Revision: 1.10 $ $Date: 2007/01/25 22:44:45 $