1. Download the following files:

(Shift-click on the links below to download the files)
• Get GSAS from ftp://ftp.lanl.gov/public/gsas/windows/gsaskit.exe (~6 Mbytes)
  and read
  ftp://ftp.lanl.gov/public/gsas/windows/readme.txt

  Mirrors for these files can be found at

  http://www.ccp14.ac.uk/ccp/ccp14/ftp-mirror/gsas/public/gsas/windows/gsaskit.exe
  or http://ccp14.sims.nrc.ca/ccp/ccp14/ftp-mirror/gsas/public/gsas/windows/gsaskit.exe

  and

  http://www.ccp14.ac.uk/ccp/ccp14/ftp-mirror/gsas/public/gsas/windows/readme.txt
  or http://ccp14.sims.nrc.ca/ccp/ccp14/ftp-mirror/gsas/public/gsas/windows/readme.txt
  

  Note that the links for these files are on non-NIST servers.

• Get a Tcl/Tk distribution
  I recommend using this (not so new) version (Tcl/Tk v8.2) (why - see note 1 below):
  ftp://ftp.ncnr.nist.gov/pub/cryst/tcltk/tcltk82blt24qwinexec0601.exe (2686464 bytes)

• The EXPGUI code
  ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/expgui.exe (~340 K bytes)
  for the absolute latest release (which may not have gotten a lot of testing, but probably has new capabilities and bug fixes) use
  ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/expgui_alpha.zip
  You will need an unzip program, such as WinZip or pkZip, to use this file. (sometimes I update ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/expgui_alpha.exe but this may lag behind the .ZIP version or may not be present.)

• If you have a version of GSAS from September 2001, or earlier and wish to set up dummy histograms from EXPEDT, you will need to update the EXPTOOL program using one of the following files:
  ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/exe_win/exptool.zip (~300 K bytes)
  or ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/exe_win/exptool.exe (~700 K bytes)

You can put these .EXE (and .ZIP) files anywhere on your computer, but make a note of the locations for steps 2, 3 and 5, below.

2. Run the programs

Use a DOS window to run, gsaskit.exe, tcltk82blt24qwinexec0601.exe, and expgui.exe (the order should not matter):

        mkdir c:\gsas
	chdir c:\gsas
	c:\temp\gsaskit.exe -d
	c:\temp\tcltk82blt24qwinexec0601.exe
        c:\temp\expgui.exe

These files can be run from where they are downloaded using the Run command or by clicking on their icons in a Windows Explorer or other directory view window.

The previous steps will cause the files to be unpacked. The default locations for installation are:

           gsaskit.exe                     c:\gsas
           tcltk82blt24qwinexec0601.exe    c:\expgui
           expgui.exe                      c:\gsas\expgui

These files can be located on other disks and in directories with other names, but the expgui files in expgui.exe must be located in a subdirectory of the GSAS files and each directory name must be 8 characters or less, so location Z:\i\think\this\will\work\gsas should be OK, but C:\longwindows\namesarenotgood\for dos probably will not work. If these files will be located on a fileserver, the file server must be mapped to appear as a disk drive (must be assigned a name such as F:).

If you downloaded exptool.zip, unpack it and copy it to c:\gsas\exe, or if you downloaded exptool.exe, it can be copied directly to c:\gsas\exe.

3. Create a shortcut:

• On a blank part of the Windows desktop, click the right mouse button and then select NEW and then shortcut and click with the left mouse button.
• provide command
c:\tcl\bin\wish82.exe c:\gsas\expgui\expgui

(modify previous paths, if you have located the files in different places)

• click on NEXT with the left mouse button.
• Enter name EXPGUI
• click on FINISH with the left mouse button.

You may want to modify the shortcut by modifying the properties to change the icon or the default properties.

gsaskit.exe

tcltk82blt24qwinexec0601.exe

expgui.exe

(expgui_alpha.exe)

(expgui_alpha.zip)

More information about EXPGUI, including information on how it can be customized, can be found on web pages expgui.html and expgui_cfg.html, found in the \gsas\expgui\doc directory.

Questions

Yes -- but: you will need both Tcl/Tk and the Winexec package (see http://www.du.edu/~mschwart/tcl-tk.htm) for the GUI to work with Windows-95, -98 and -me. Further, several utility routines (liveplot and widplt) require the BLT package to be properly configured as a loadable package to run. If you care what vintage of Tcl/Tk you are using, you are obviously a "power user" so take a look at the pkgIndex.tcl files and fix your version, if you get an error about loading Blt_ZoomStack. Please note that EXPGUI seems to run very slowly in Tcl/Tk version 8.1, but OK in 8.0 and 8.2.

Only if you will use the PC-GSAS program as well as EXPGUI. If so, do follow the steps in the GSAS readme file)

Note, to add more environment space in Win95/98, add the following line to the CONFIG.SYS file in the root directory

        SHELL=C:\WINDOWS\COMMAND.COM /P /E:4096 

add the following line to the SYSTEM.INI file (in c:\windows) under the heading [NonWindowsApp]

        CommandEnvSize=2424 

(thanks to Louis Farrugia [louis@chem.gla.ac.uk] for this).

This package has gotten some testing under Win-95/98 and Win-NT 4.0 & 2000.

Well, actually the problem is Windows. EXPGUI is pretty zippy in LINUX, but some operations (reading a histogram in liveplot for example) can take 3-5 times longer in Windows than in UNIX on the exact same hardware. By all means, take this up with the folks in Redmond, WA.

There are two problems I know of that can cause graphics errors: One is that the graphics package (PGPLOT) cannot find the PGPLOT_FONT environment variable (that points to file GRFONT.DAT). EXPGUI does this for you and warns if it can't find this file, so the likely reason is that you are out of environment space (see 2, above).

The other appears to be a graphics mode problem. Not all modes work on all machines. Try mode A. If you still have problems, see if it is an EXPGUI problem: Try using a plotting program (RAWPLOT is a good choice) from PC-GSAS or GSAS.BAT. If the plotting program does not work there either, first check PGPLOT_FONT is defined (by opening a DOS box and type SET, also see question 2, above.) If the plotting program runs in PC-GSAS or GSAS.BAT but not EXPGUI, you have a real EXPGUI bug and should bug me.

Yes, but. The path must be mapped to a "logical drive." (e.g. F:) since GSAS is basically a set of DOS programs. Likewise, you will have troubles accessing experiment and data files on a networked drive unless that path is also mapped to a "logical drive." EXPGUI will warn you, if you do either.

Acknowledgements

GSAS is written by Allen C. Larson and Robert B. Von Dreele, MS-H805, Los Alamos National Laboratory, Los Alamos, NM 87545. Problems, questions or kudos concerning GSAS should be sent to Robert B. Von Dreele at vondreele@lanl.gov

GSAS is Copyright, 1984-1997, The Regents of the University of California. The GSAS software was produced under a U.S. Government contract (W-7405-ENG-36) by the Los Alamos National Laboratory, which is operated by the University of California for the U.S. Department of Energy. The U.S. Government is licensed to use, reproduce, and distribute this software. Permission is granted to the public to copy and use this software without charge, provided that this notice and any statement of authorship are reproduced on all copies. Neither the Government nor the University makes any warranty, express or implied, or assumes any liability or responsibility for the use of this software.

EXPGUI is written by Brian H. Toby of the NIST Center for Neutron Research, Brian.Toby@NIST.GOV with help from Jonathan Wasserman.

EXPGUI is not subject to copyright. Have fun with it.

Neither the U.S. Government nor any author makes any warranty, expressed or implied, or assumes any liability or responsibility for the use of this information or the software described here. Brand names cited here are used for identification purposes and do not consitute an endorsement by NIST.

Brian Toby (Brian.Toby@NIST.GOV)
$Revision: 442 $ $Date: 2009-12-04 23:06:14 +0000 (Fri, 04 Dec 2009) $