source: branches/sandbox/doc/gsas+expgui.html

Last change on this file was 1223, checked in by toby, 9 years ago

update refs to .xor.aps

  • Property svn:mime-type set to text/html
File size: 9.6 KB
3   <title>GSAS Notes</title>
4   <meta name="keywords" content="crystallography, Rietveld, diffraction,
9      topmargin="0" leftmargin="0" marginwidth="0" marginheight="0" 
10      text="#000000" link="#0033ff" vlink="#0033ff" alink="#0033ff">
12<blockquote><font face="arial, helvetica, sans-serif">
14<HR noshade width="75%" size="2" align="center">
16GSAS/EXPGUI Self-Installer for Windows</H1>
17<HR noshade width="75%" size="2" align="center">
21<B>Please note:</B>
22A new mechanism for installing GSAS & EXPGUI is now recommended. See
23<A HREF="">
24this link</a>. If this method is used, EXPGUI or a batch file can
25be used to update GSAS & EXPGUI quickly and easily.
26The installer described below will be updated for the foreseeable
27   future, but likely with less frequency.
32<P>A self-installing version of
33<a href="">GSAS (General Structure Analysis System)</a>
35<a href="">EXPGUI</a>
36is available. This program uncompresses itself, copies the required files
37(including the Tcl/Tk files used in EXPGUI)
38to a selected directory and either modifies the <TT>AUTOEXEC.BAT</TT> file
39and/or creates the appropriate registry entries needed to run GSAS,
40optionally with EXPGUI. This web page documents the screens displayed by the
43The self-installer can be downloaded as file gsas+expgui.exe from
44<a href="">Argonne</a>
47<a href="">
48CCP14 </A>
51<B>Mailing List.</B>
52If you would like to get news about about new features
53& bug fixes in EXPGUI, as well as have input into develop goals
54please join the EXPGUI mailing list at
55<a href="">
58<P><B>Previous GSAS/EXPGUI versions.</B>
59If you already have GSAS & EXPGUI loaded on your computer,
60with this installer, you can simply run the new gsas+expgui.exe file. You
61will get a message reminding you are upgrading and you will not be
62offered a choice of where to install -- files will be placed in the same
63directory as before.
65If you previously installed using the gsaskit.exe file, you can probably
66do fine if you ignore the old version and follow the directions below. However,
67it is perhaps safer to either delete these files from your computer, or else
68move them into a new directory (like c:\oldgsas or c:\1999gsas) so there is
69no possibility that you will access any of the old programs by accident.
70Also, in Windows-95, -95 and -ME, remove previous references to GSAS from
71your AUTOEXEC.BAT file
72(<a href="#AUTOEXEC">see notes about <tt>AUTOEXEC.BAT</tt></a>
73and <a href="#oldTcl">old Tcl/Tk files</a> following this paragraph.)
74Note that it is possible to run multiple versions of GSAS using EXPGUI
75(by setting up shortcuts to the different copies of the expgui files
76in the different locations), but PC-GSAS will run the first version of the GSAS
77programs found in the path, and thus will run only the most recently
78installed version.
80<P><a name="AUTOEXEC"></a><B>Previous <tt>AUTOEXEC.BAT</tt> modifications.</B>
81Note that if you are using Windows-95, -98 or -ME, and had older versions
82of GSAS installed,
83you have references to GSAS in your <tt>AUTOEXEC.BAT</tt> file.
84You should edit this file in
85NOTEPAD (or SYSEDIT) to remove the references in your PATH definition.
86You do not need to define the GSAS environment variable anymore, unless
87you are using Windows-95, -98 or -ME and install the software in a
88location other than c:\GSAS.
89<P><a name="oldTcl"></a><B>Previous Tcl/Tk versions</B>.
90The previous instructions for EXPGUI recommended installing the Tcl/Tk programs
91in a directory <tt>C:\TCL</TT> or <tt>C:\TCL823</tt>. These files are
92no longer needed by this version of EXPGUI, as the self-installer now places
93these files in the GSAS directory. Thus, the
94old <tt>C:\TCL</TT> or <tt>C:\TCL823</tt> directories can be deleted to save
95disk space.
97<HR noshade width="50%" size="2" align="center">
100<img src="s1.gif" alt="setup in progress window" ALIGN=LEFT>
101After downloading the program, start it either from the Run entry in the
102Start menu, or by double-clicking on the icon for the downloaded file. The
103"Setup in progress..." screen will appear for the minute or two
104(perhaps as much as fifteen minutes on a very slow computer) while
105the file uncompresses itself. This step has failed on some computers
106with previous versions of the self-installer. If you get an error message, please sent it to <A HREF="MAILTO:Brian.Toby@ANL.GOV">me</a>.
107<BR clear=all><P>
108<HR noshade width="50%" size="2" align="center"><P>
109<img src="s2.gif" alt="Installer Intro screen" ALIGN=RIGHT>
110The first screen shows the program version.
112<BR clear=all><P>
113<HR noshade width="50%" size="2" align="center"><P>
114<img src="s3.gif" alt="Installer Copyright Intro screen"  ALIGN=RIGHT>
115The copyright information is shown, so that all the lawyers can be happy.
116<BR clear=all><P>
117<HR noshade width="50%" size="2" align="center"><P>
118<img src="s4.gif" alt="Screen to select default .EXP association" ALIGN=RIGHT>
119On this screen and the next you actually get to make some choices!
120You can decide what
121shortcuts will be provided for accessing EXPGUI and various GSAS programs.
122The options are explained immediately below.
124<DL><DT><img src="s11.gif" alt="Example of .EXP associations"><DD>
125If ".EXP association" is selected on the next screen,
126registry entries are created so that if
127one <I>right-clicks</I> on a .EXP file, a set of choices are offered for
128acting on the file, as shown above.
129For example, selecting EXPEDT from the pop-up menu,
130invokes the EXPEDT program to edit options in the file.
131Double-clicking (with the right mouse button) invokes the
132default action. The choices on the current screen, allow the
133selection of the
134which program will be invoked upon a double-click.
136<BR clear=all><P>
137<img src="s4a.gif" alt="Screen to select shortcut options" ALIGN=RIGHT>
140<DT><img src="s9.gif" alt="Example of Desktop icons"><DD>
141If desktop icons are selected, these two icons are placed on your desktop,
142as above.
143Clicking on them will start EXPGUI and PC-GSAS. Note that the default
144directory for these shortcuts will be MyWork in the directory selected
145for GSAS installation (typically C:\GSAS\MyWork). This can be changed by
146editing the shortcut properties.
148<DT><img src="s10.gif" alt="Example of Start menu entries"><DD>
149If the "Start menu" option is selected, a "GSAS + EXPGUI" menu folder
150 is placed in your Start menu, with two items, to start EXPGUI and PC-GSAS.
151See above. The default directory is set as described for the
152desktop shortcuts. This can also be changed by right-clicking on the
153start menu to open it and then setting the properties for the
154menu entries.
157The last option, if selected, causes the files described in the training
158section of the GSAS manual (for example, the Nickel and Garnet data files)
159to be placed in the GSAS work directory (typically C:\GSAS\MyWork). This
160makes it a bit easier to follow the examples given in the manual or
161on the EXPGUI tutorial web pages.
162<BR clear=all><P>
163<HR noshade width="50%" size="2" align="center"><P>
164<img src="s5.gif" alt="Screen to select install folder" ALIGN=RIGHT>
165In this screen you select where the software will be installed. The default,
166<tt>C:\GSAS</tt> is a good choice. You can use another drive, such as
167<tt>G:\GSAS</tt> or
168another directory, such as <tt>C:\SHAREDFILES\GSAS</tt>, but there have been problems
169noted by people trying to directories with spaces in them, such as
170<tt>C:\Program Files\GSAS</tt>,
171so it is suggested that you do your own debugging
172if you do this. Note that it is acceptable to use a directory on another
173computer (such as a file server) but the directory must be mapped as a drive
174(<I>e.g.</I> <tt>S:\GSAS</tt>, not <tt>\\server\GSAS</tt>).
175Note that all files installed by the program are placed in this directory
176or subdirectories below. No files are placed in windows system directories,
177other than registry information that allows the program to be uninstalled
178from the control panel.
180<BR clear=all><P>
181<HR noshade width="50%" size="2" align="center"><P>
182<img src="s6.gif" alt="Screen to confirm options" ALIGN=RIGHT>
183This screen summarizes the input you have supplied. Use the "Back" button
184to change any selections. Note that at this time, the GSAS work directory
185is set automatically from the location where the software will be installed.
187<BR clear=all><P>
188<HR noshade width="50%" size="2" align="center"><P>
189<img src="s7.gif" alt="Please wait screen" ALIGN=LEFT>
190This screen is displayed as the files are copied to the selected locations.
192<BR clear=all>
194After all installation steps have been completed, the screen that says
195"Setup complete" is shown. After pressing "Finish" all is done.
196A reboot is no longer
199<BR clear=all><P>
200<HR noshade width="75%" size="2" align="center"><P>
201Please note that unexpected behavior in Windows seems to be the rule
202rather than the exception, so report problems to:
203<A HREF="MAILTO:Brian.Toby@ANL.GOV">tell Brian Toby</a>.
204Corrections are far less likely without your feedback.
207<font size=-1><? lastmod(); ?></font>
208<BR>$Revision: 1.10 $ $Date: 2007/01/25 22:44:45 $
Note: See TracBrowser for help on using the repository browser.