source: trunk/doc/expgui_Win_readme.html @ 812

Last change on this file since 812 was 812, checked in by toby, 14 years ago

# on 2004/09/28 22:40:05, toby did:
major revision -- explain updates
  • Property rcs:author set to toby
  • Property rcs:date set to 2004/09/28 22:40:05
  • Property rcs:lines set to +164 -193
  • Property rcs:rev set to 1.25
  • Property rcs:state set to Exp
  • Property svn:keywords set to Author Date Revision Id
File size: 14.1 KB
Line 
1<HTML>
2<HEAD>
3   <TITLE>Windows Installation Information for EXPGUI</TITLE>
4   <meta name="keywords" content="crystallography, Rietveld, diffraction,
5   GSAS, EXPGUI, Windows">
6</HEAD>
7<style>
8A:link {text-decoration:none}
9A:vlink {text-decoration:none}
10</style>
11
12<BODY BGCOLOR="#FFFFFF"
13      topmargin="0" leftmargin="0" marginwidth="0" marginheight="0" 
14      text="#000000" link="#0033ff" vlink="#0033ff" alink="#0033ff">
15
16<?
17   include("/var/www/include/navigation.inc");
18   include("/var/www/include/utility.inc");
19?>
20<blockquote><font face="arial, helvetica, sans-serif">
21
22<TABLE BORDER BGCOLOR="#FFFF40" ALIGN=RIGHT>
23<TR>
24<TH>
25<a href="http://www.ncnr.nist.gov/xtal/software/gsas+expgui.html">self-installer notes</a></TH>
26<TH><A  Href="win_old_notes.html">Windows install details</A></TH>
27<TH><A  Href="expgui.html">EXPGUI home</A></TH>
28</TR></TABLE><BR CLEAR=ALL>
29
30
31<CENTER><H1>
32<HR noshade width="75%" size="2" align="center">
33Installating and Updating
34<BR>
35<A HREF="expgui.html">EXPGUI</A>
36(& 
37<a href="http://www.ncnr.nist.gov/xtal/software/gsas.html">GSAS</a>)
38on Windows
39<HR noshade width="75%" size="2" align="center">
40</H1></CENTER>
41
42<EM>Please note that <A HREF="expgui.html">EXPGUI</A>
43 is always under development and gets
44less testing by the author
45in Windows than in other platforms.
46Please report problems, including improvements on
47these instructions to
48<A HREF="mailto:brian.toby@nist.gov">Brian Toby</A>.
49Otherwise, Windows-specific issues are unlikely to be addressed or repaired.
50</EM>
51
52<H2>Installing GSAS and EXPGUI in Windows</H2>
53Most users who install
54<a href="http://www.ncnr.nist.gov/xtal/software/gsas.html">GSAS (General Structure Analysis System)</a>
55and
56<a href="http://www.ncnr.nist.gov/xtal/software/expgui">EXPGUI</a>,
57will do so by downloading a single file that installs the GSAS programs,
58the Tcl/Tk package (with some extensions), the EXPGUI scripts, as well as
59makes registry changes (or AUTOEXEC.BAT edits) as needed by GSAS. This will
60be described in brief in the next section of this page.
61It is also possible to download and install GSAS, Tcl/Tk & EXPGUI from
62separate distributions; please see the
63<A Href="win_old_notes.html">Windows install details</A> web page
64for more details.
65<P>More information about EXPGUI, including information on how it
66can be customized, can be found on web pages <A HREF="expgui.html">expgui.html</A>
67and <A HREF="expgui_cfg.html">expgui_cfg.html</A>. These files are also
68found in the <TT>...\gsas\expgui\doc</TT> directory after EXPGUI is installed.
69
70
71<H3>Using the GSAS and EXPGUI self-installer for Windows</H3>
72<DL><DL>
73You can download a single file that installs
74<a href="http://www.ncnr.nist.gov/xtal/software/gsas.html">GSAS</A>
75and
76<a href="http://www.ncnr.nist.gov/xtal/software/expgui">EXPGUI</a>,
77as well as the Tcl/Tk package, needed by EXPGUI. This self-installing
78file uncompresses itself, copies the required files
79to a selected directory and either modifies the <TT>AUTOEXEC.BAT</TT> file
80and/or creates the appropriate registry entries needed to run the programs.
81A
82<a href="http://www.ncnr.nist.gov/xtal/software/gsas+expgui.html">
83separate web page</a>
84provides details a detailed description on this self-installer
85(<a href="ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/gsas+expgui.exe">gsas+expgui.exe</A>).
86Here are the steps in brief:
87
88<OL>
89<P><LI><B>Download
90<a href="ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/gsas+expgui.exe">
91ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/gsas+expgui.exe</A>
92</B><BR>
93(Mirrors: select file gsas+expgui.exe from
94<A HREF="http://www.nist.gov/cgi-bin/exit_nist.cgi?url=
95http://www.ccp14.ac.uk/ccp/ccp14/ftp-mirror/briantoby/pub/cryst/gsas/">
96UK</A>,
97
98<A HREF="http://www.nist.gov/cgi-bin/exit_nist.cgi?url=http://ccp14.sims.nrc.ca/ccp/ccp14/ftp-mirror/briantoby/pub/cryst/gsas/">
99Canada</A>
100or
101
102<A HREF="http://www.nist.gov/cgi-bin/exit_nist.cgi?url=
103http://ccp14.minerals.csiro.au/ccp/ccp14/ftp-mirror/briantoby/pub/cryst/gsas/">
104Australia</A>.)
105
106
107<P><LI><B>Run the gsas+expgui.exe file</B>
108
109<P><LI><B>Page through the installation screens & select install options</B>
110
111<P><LI><B>Wait while the files are installed and then continue,
112allowing the computer to be rebooted</B>
113
114<P><LI><B>Delete the gsas+expgui.exe file (optional)</B>
115</OL>
116<P>
117For more details on the sequence of operations and the installation
118options refer to the detailed
119<a href="http://www.ncnr.nist.gov/xtal/software/gsas+expgui.html">
120Windows self-installer instructions</a> web page.
121
122</DL></DL>
123
124<H2>Updating to a new GSAS release</H2>
125<DL><DL>
126It is quite common that Bob Von Dreele will release an update to the
127GSAS programs more frequently than the combination gsas_expgui.exe
128package can be updated. It is possible to update a previous version of the
129GSAS software.
130First, make a note where you have installed the GSAS/EXPGUI software.
131The default is <TT>C:\GSAS</TT>, but you can check by looking at the properties for the
132PC-GSAS or EXPGUI icon. Second, note the GSAS package date, by
133running a GSAS program, such as EXPEDT or SPACEGRP and noting the
134date where it says "Distributed on ..."
135Then download the latest GSAS release from CCP14:
136<DL>
137<DT>UK:<DD>
138<A HREF="http://www.nist.gov/cgi-bin/exit_nist.cgi?
139url=http://www.ccp14.ac.uk/ccp/ccp14/ftp-mirror/gsas/public/gsas/windows/gsaskit.exe">
140http://www.ccp14.ac.uk/ccp/ccp14/ftp-mirror/gsas/public/gsas/windows/gsaskit.exe</A>
141<BR>or<BR>
142<A HREF="http://www.nist.gov/cgi-bin/exit_nist.cgi?url=
143ftp://ftp.ccp14.ac.uk/ccp14/ftp-mirror/gsas/public/gsas/windows/gsaskit.exe">ftp://ftp.ccp14.ac.uk/ccp14/ftp-mirror/gsas/public/gsas/windows/gsaskit.exe</A>
144
145<DT>Canada:<DD>
146<A HREF="http://www.nist.gov/cgi-bin/exit_nist.cgi?url=http://ccp14.sims.nrc.ca/ccp/ccp14/ftp-mirror/gsas/public/gsas/windows/gsaskit.exe">http://ccp14.sims.nrc.ca/ccp/ccp14/ftp-mirror/gsas/public/gsas/windows/gsaskit.exe</A>
147
148<DT>Australia:<DD>
149<A HREF="http://www.nist.gov/cgi-bin/exit_nist.cgi?url=
150http://ccp14.minerals.csiro.au/ccp/ccp14/ftp-mirror/gsas/public/gsas/windows/gsaskit.exe">
151http://ccp14.minerals.csiro.au/ccp/ccp14/ftp-mirror/gsas/public/gsas/windows/gsaskit.exe</A>
152</DL>
153<P>When you run the downloaded file, you will be asked where the GSAS software
154should be installed (with a default of <tt>C:\GSAS</TT>). Make sure to use the same
155location as before.
156<P>
157Finally, check that GSAS has indeed been updated by
158again running a GSAS program, such as EXPEDT or SPACEGRP and noting the
159date where it says "Distributed on ..."
160</DL></DL>
161
162<H2>Updating to a new EXPGUI release</H2>
163<DL><DL>
164It is also common that new features will be added to EXPGUI or
165bug fixes will be made without an update to the
166combination gsas_expgui.exe
167package.
168The absolute latest release (which may not have gotten
169a lot of testing)
170is distributed as
171<A HREF="ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/expgui_alpha.zip">
172ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/expgui_alpha.zip</A>.
173On the newest versions of Windows, support for .zip files is built in, but
174for older versions, you will need an unzip program, such as WinZip or pkZip.
175<P>
176To update EXPGUI,
177first, make a note where you have installed the GSAS/EXPGUI software.
178The default is <TT>C:\GSAS\EXPGUI</TT>, but you can check by looking at the
179properties for the PC-GSAS or EXPGUI icon.
180Second, note the EXPGUI package date, by
181using the Help/About menu command in EXPGUI.
182You then want to download this file:
183is distributed as
184<DL>
185<A HREF="ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/expgui_alpha.zip">
186ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/expgui_alpha.zip</A>
187<BR>
188(Mirrors: select file expgui_alpha.zip from
189<A HREF="http://www.nist.gov/cgi-bin/exit_nist.cgi?url=
190http://www.ccp14.ac.uk/ccp/ccp14/ftp-mirror/briantoby/pub/cryst/gsas/">
191UK</A>,
192
193<A HREF="http://www.nist.gov/cgi-bin/exit_nist.cgi?url=http://ccp14.sims.nrc.ca/ccp/ccp14/ftp-mirror/briantoby/pub/cryst/gsas/">
194Canada</A>
195or
196
197<A HREF="http://www.nist.gov/cgi-bin/exit_nist.cgi?url=
198http://ccp14.minerals.csiro.au/ccp/ccp14/ftp-mirror/briantoby/pub/cryst/gsas/">
199Australia</A>.)
200</DL><P>
201 and unpack it to subdirectory <tt>...\gsas\expgui\</tt>.
202Depending how you work with the zip directory, you may want to copy the
203files in the .zip archive into the existing <tt>gsas\expgui</tt> directory or
204rename the original <tt>expgui</tt> in <tt>gsas</tt> 
205and then drag the new expgui directory into the gsas folder.
206Finally, you can check if the EXPGUI program has been updated, by restarting
207it and again using the Help/About menu option.
208</DL></DL>
209<H2>Problems & Questions</H2>
210<OL>
211<LI>How do I increase the Environment variable space
212<UL>This is only needed on -95/-98 or -ME.
213To add more environment space in Win95/98, add the following line to the
214CONFIG.SYS file in the root directory
215<FONT FACE="COURIER"><PRE>
216        SHELL=C:\WINDOWS\COMMAND.COM /P /E:4096
217</PRE></FONT>
218Also add the following line to the SYSTEM.INI file (in c:\windows) under
219the heading [NonWindowsApp]
220<FONT FACE="COURIER"><PRE>
221
222        CommandEnvSize=2424
223</PRE></FONT>
224(thanks to Louis Farrugia [louis@chem.gla.ac.uk] for this).
225
226</UL>
227<LI>What versions of Windows can I use?
228<UL>As far as I am aware, EXPGUI will run under all releases of Windows from
229-95/-98/-ME/-NT/-2000 through -XP, but it is not tested
230here on most of those platforms.
231I depend on feedback from users to tell me of OS conflicts, but none have
232been reported.
233<P>
234I have heard that there are minor
235problems with running EXPGUI on -XP -- after GSAS programs are run, EXPGUI
236may remain minimized (on the taskbar) rather than reopen itself. This
237should be addressed as of EXPGUI 1.73, but
238problem can be avoided by unselecting the "Minimize on GSAS" checkbutton
239in the Options menu. Likewise, with older versions of EXPGUI on -XP, sometimes
240the program hangs at the point where one is asked if a .EXP file should
241loaded after a refinement. Use of the "Autoload .EXP" will bypass the problem,
242but the bug should have been fixed in EXPGUI 1.73.
243</UL>
244<LI>EXPGUI seems pretty slow, or is it my imagination?
245<UL>
246Well, actually the problem is Windows. EXPGUI is pretty zippy in LINUX,
247but some operations
248(reading a histogram in liveplot for example) can take 3-5 times
249longer in Windows than in UNIX on the exact same hardware.
250By all means, take this up with the folks in Redmond, WA.
251
252</UL>
253<LI>When I run one of the GSAS graphics programs (POWPLOT, RAWPLOT,...) the
254program starts, and I can answer questions, but when it comes to the part
255of the program that should display a plot, I get no plot (and possibly
256the DOS window disappears without a trace.)
257<UL>
258There are two problems I know of that can cause graphics errors:
259One is that the graphics package (PGPLOT) cannot find the PGPLOT_FONT
260environment variable (that points to file GRFONT.DAT). EXPGUI does this
261for you and warns if it can't find this file, so the likely reason is
262that you are out of environment space (see 2, above).
263<P>
264The other appears to be a graphics mode problem. Not all modes work
265on all machines. Try mode A. If you still have problems, see if it is an
266EXPGUI problem: Try using a plotting program
267(RAWPLOT is a good choice) from PC-GSAS or GSAS.BAT.  If the plotting
268program does not work there either, first check PGPLOT_FONT is defined
269(by opening a DOS box and type SET, also see question 2, above.)
270If the plotting program runs in PC-GSAS or GSAS.BAT but not EXPGUI, you have a
271real EXPGUI bug and should bug me.
272
273</UL>
274<a name="NetPath"></a>
275<LI>Can GSAS and EXPGUI be located on a shared network drive?
276<UL>
277Yes. With earlier versions of GSAS path had to be mapped to a
278"logical drive." (e.g. F:). In the current versions of GSAS, this does not
279seem to be needed, but
280EXPGUI will warn you, if you try to do this, since I am not certain
281that this works.
282<P>
283I do not know if GSAS will work properly with
284experiment and data files on a networked drive without mapping the
285path to a "logical drive."
286There are some definite problems in GSAS where directory and file
287names contain
288spaces. EXPGUI should help avoid some of these problems, so if you find
289anything file names that break EXPGUI & GSAS, let me know how to
290duplicate exactly what you are doing.
291</UL>
292
293</OL>
294
295<H2>
296Acknowledgements</H2>
297<P>
298<A Href="http://www.ncnr.nist.gov/programs/crystallography/software/gsas.html">
299GSAS</A>
300is written by Allen C. Larson and Robert B. Von Dreele,  MS-H805,
301Los Alamos National Laboratory, Los Alamos, NM 87545. Problems, questions
302or kudos concerning GSAS should be sent to Robert B. Von Dreele at
303<A HREF="MAILTO:vondreele@anl.gov">vondreele@anl.gov</A>
304<P>EXPGUI is written by Brian H. Toby of the NIST Center for Neutron Research,
305<A HREF="MAILTO:Brian.Toby@NIST.GOV">Brian.Toby@NIST.GOV</A> 
306with help from Jonathan Wasserman.
307
308<P>
309<hr><blockquote>
310GSAS is Copyright, 1984-1997, The Regents of the University of California.
311The GSAS software was produced under a U.S. Government contract (W-7405-ENG-36)
312by the Los Alamos National Laboratory, which is operated by the University
313of California for the U.S. Department of Energy. The U.S. Government is
314licensed to use, reproduce, and distribute this software. Permission is
315granted to the public to copy and use this software without charge, provided
316that this notice and any statement of authorship are reproduced on all
317copies. Neither the Government nor the University makes any warranty, express
318or implied, or assumes any liability or responsibility for the use of this
319software.
320
321<P>EXPGUI is not subject to copyright. Have fun with it.
322
323<p>Neither the U.S. Government nor any author makes any warranty,
324expressed or implied, or assumes any liability or responsibility
325for the use of this information or the software described
326here. Brand names cited here are used for
327identification purposes and do not consitute an endorsement by NIST.
328</blockquote>
329<hr>
330<TABLE BORDER BGCOLOR="#FFFF40" ALIGN=RIGHT>
331<TR>
332<TH>
333<a href="http://www.ncnr.nist.gov/xtal/software/gsas+expgui.html">self-installer notes</a></TH>
334<TH><A  Href="win_old_notes.html">Windows install details</A></TH>
335<TH><A  Href="expgui.html">EXPGUI home</A></TH>
336</TR></TABLE><BR CLEAR=ALL>
337
338<P><font size=-1><A HREF="MAILTO:crystal@NIST.gov?subject=WWW page <?=$PHP_SELF?>">Comments, corrections or questions: crystal@NIST.gov</A></font><BR>
339<font size=-1><? lastmod(); ?> </font>
340<br>
341$Revision: 812 $ $Date: 2009-12-04 23:12:28 +0000 (Fri, 04 Dec 2009) $
342</blockquote>
343</body>
344</html>
Note: See TracBrowser for help on using the repository browser.