Installing EXPGUI on
SGI & Linux Computers

Note that root access is not required to load this GSAS/EXPGUI package. You may choose to do this work as root, so that the files may be installed a central location (such as /usr/local).

1. Prerequisites

Installation of GSAS & EXPGUI requires X windows, which is loaded with the operating system on virtually all Linux and SGI systems. It also requires only the shared libraries typically found on standard install configurations (tell me if I am wrong). The Linux version is compiled with g77 v2.96 on a Redhat 7.1 machine. It should be compatible with most modern versions of Linux. The SGI version has been compiled with f77 on a SGI running IRIX 6.5. It should be compatible with most recent versions of IRIX. New! This GSAS & EXPGUI is now distributed with a version of Tcl/Tk, so installation of Tcl/Tk is no longer a prerequisite.

2. Download the GSAS/EXPGUI Distribution

Make a note of where you download the file. In the following section it will be assumed the file was placed in /tmp/.
download file ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/SGI_gsas+expgui.tar.gz (~11 Mb) by shift-clicking on the previous link. (Alternately this file can also be downloaded from the CCP14 mirrors in UK, Canada, or Australia).
download file ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/LINUX_gsas+expgui.tar.gz (~10 Mb) by shift-clicking on the previous link. (Alternately this file can also be downloaded from the CCP14 mirrors in UK, (Canada, or Australia).

3. Unpack the distribution

In this step, it is assumed that you downloaded the distribution file in directory /tmp/.

4. Installing a shortcut to EXPGUI

While it is possible to invoke EXPGUI by typing
    /usr/local/gsas/tcltk84+ /usr/local/gsas/expgui/expgui
   /home/toby/myprogs/gsas/tcltk84+ /home/toby/myprogs/gsas/expgui/expgui
(etc.) this would get old fast. Rather, you will likely want to create an easier command to type. Below are three ways to do this. Note that only one is needed. Do not use all three. You could also create a startbar or desktop icon that can be clicked to start EXPGUI. The way this is done depends on how your system is set up and cannot be described here. Note that in the commands below, it is assumed that GSAS has been installed in /myprogs/gsas. Also, note that in the commands below, ^D means control-D.

Updating to a new GSAS release

It is quite common that Bob Von Dreele will release an update to the GSAS programs more frequently than the combination gsas+expgui is updated. It is possible to update only the GSAS software. To determine the date of the GSAS package release, run a GSAS program, such as EXPEDT or SPACEGRP and note the date where it says "Distributed on ..." To update, first determine where you have installed the GSAS/EXPGUI software (/myprogs in the previous example). You will want to install the GSAS distribution to the gsas subdirectory in that location. Then download the latest GSAS release from CCP14:

Select and download the appropriate gsaskit.tar.gz (making sure that the listing date is significantly later than the distribution date you currently have). Then use commands like this:

SGI, use command
cd /myprogs/gsas
gunzip < /tmp/gsaskit.tar.gz | tar xvf -
LINUX, use command
cd /myprogs/gsas
tar xvzf /tmp/gsaskit.tar.gz

Finally, check that GSAS has indeed been updated by again running a GSAS program, such as EXPEDT or SPACEGRP and noting the date where it says "Distributed on ..."

Updating to a new EXPGUI release

It is also common that new features will be added to EXPGUI or bug fixes will be made without an update to the combination gsas+expgui package. The absolute latest release (which may not have gotten a lot of testing) is distributed as ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/expgui_ALPHA.tar.gz. You can find the number of the latest alpha release by looking at file http://www.ncnr.nist.gov/xtal/software/expgui/alpha/wishlist.html

To update, first determine where you have installed the GSAS/EXPGUI software (/myprogs in the previous example). You will want to install the GSAS distribution to the gsas/expgui subdirectory in that location. Second, note the EXPGUI package date, by using the Help/About menu command in EXPGUI. You then want to download this file:

(for mirrors, select file expgui_ALPHA.tar.gz from CCP14 sites in the UK, Canada, or Australia.)

and unpack it to subdirectory .../gsas/expgui/ using commands like this:

cd /myprogs/gsas/expgui
gunzip < /tmp/expgui_ALPHA.tar.gz | tar xvf -
cd /myprogs/gsas/expgui
tar xvzf /tmp/expgui_ALPHA.tar.gz

RPMs for GSAS/EXPGUI are not being updated

I am no longer preparing an RPM distribution for GSAS & EXPGUI. This is because it was getting increasingly hard to find RPM distributions for Tcl/Tk and BLT. If one has to install & build these packages from source code, then one must also override the RPM package tracking system to install the GSAS & EXPGUI RPM. The current method, which includes the entire Tcl/Tk package is easier to deal with.

The Tcl/Tk Starkit

The GSAS-EXPGUI distribution now includes a single file version of the entire Tcl/Tk package, as well as a graphics package for Tcl/Tk, called BLT, that is used extensively within EXPGUI. The inclusion of this file within the package simplifies installation considerably. This file, tcltk84+, contains many other Tcl/Tk packages (that are not used within EXPGUI), but may be of value for use with other applications.

Using other versions of Tcl/Tk

If you have another version of Tcl/Tk installed on your computer, it must also have the BLT package installed and configured properly. To confirm this software is installed and working correctly on your system try the following commands. (Commands you type are in this typewriter font, computer responses are this italic font. My comments are provided in this text font and are underlined).


Thanks to Paul Kienzle of the NCNR DAVE project for providing the "all in one file" (starkit) version of Tcl/Tk for SGI and Linux.

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@anl.gov

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

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 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.


Comments, corrections or questions: crystal@NIST.gov

$Revision: 829 $ $Date: 2009-12-04 23:12:45 +0000 (Fri, 04 Dec 2009) $