source: trunk/doc/expgui_Win_readme.html @ 752

Last change on this file since 752 was 752, checked in by toby, 11 years ago

# on 2003/11/13 17:34:33, toby did:
reassure folks with -me & -xp that EXPGUI should run

  • Property rcs:author set to toby
  • Property rcs:date set to 2003/11/13 17:34:33
  • Property rcs:lines set to +6 -3
  • Property rcs:rev set to 1.24
  • Property rcs:state set to Exp
  • Property svn:keywords set to Author Date Revision Id
File size: 15.4 KB
Line 
1<HTML>
2<HEAD>
3   <TITLE>Windows Installation Notes 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><TH><A  Href="expgui.html">EXPGUI home</A> 
24</TH></TR></TABLE><BR CLEAR=ALL>
25
26<CENTER><H1>
27<HR noshade width="75%" size="2" align="center">
28Windows installation notes for
29<A HREF="expgui.html">EXPGUI</A>
30<HR noshade width="75%" size="2" align="center">
31</H1></CENTER>
32
33<EM>Please note that <A HREF="expgui.html">EXPGUI</A>
34 is always under development and gets
35less testing by the author
36in Windows than in UNIX. Please report problems, including comments on
37these instructions to
38<A HREF="mailto:brian.toby@nist.gov">Brian Toby</A>.
39</EM>
40
41<H2>A single-step program to install GSAS and EXPGUI for Windows</H2>
42<DL><DL>
43You can download a single file that installs
44<a href="http://www.ncnr.nist.gov/xtal/software/gsas.html">GSAS (General Structure Analysis System)</a>
45and
46<a href="http://www.ncnr.nist.gov/xtal/software/expgui">EXPGUI</a>,
47as well as the Tcl/Tk package, needed by EXPGUI. This self-installing
48file uncompresses itself, copies the required files
49to a selected directory and either modifies the <TT>AUTOEXEC.BAT</TT> file
50and/or creates the appropriate registry entries needed to run the programs.
51A
52<a href="http://www.ncnr.nist.gov/xtal/software/gsas+expgui.html">separate web page</a>
53details how to use this self-installer,
54(<a href="ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/gsas+expgui.exe">
55ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/gsas+expgui.exe
56</a> or from CCP14 mirrors). Here are the steps in brief:
57
58<OL>
59<P><LI><B>Download
60<a href="ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/gsas+expgui.exe">
61ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/gsas+expgui.exe</A>
62</B>
63
64<P><LI><B>Run the gsas+expgui.exe file</B>
65
66<P><LI><B>Page through the installation screens & select install options</B>
67
68<P><LI><B>Wait while the files are installed and then continue,
69allowing the computer to be rebooted</B>
70
71<P><LI><B>Delete the gsas+expgui.exe file (optional)</B>
72</OL>
73<P>
74For more details on the sequence of operations and the installation
75options refer to the detailed
76<a href="http://www.ncnr.nist.gov/xtal/software/gsas+expgui.html">
77Windows self-installer instructions</a> web page.
78
79</DL></DL>
80
81<H2>The old, multistep, process for loading GSAS and EXPGUI</H2>
82If for some reason you want to install GSAS and EXPGUI from the
83component distributions (which are sometimes more recent than the
84single-step file, described above), you can follow the steps listed
85below.
86<P><B>1. Download the following files:</B>
87<UL>
88<I>(Shift-click on the links below to download the files)</I>
89<P>
90<LI>Get
91<A Href="http://www.ncnr.nist.gov/programs/crystallography/software/gsas.html">
92GSAS</A> from one of the following sites:
93<DL><P>
94<DT>UK<DD>
95
96<A HREF="http://www.nist.gov/cgi-bin/exit_nist.cgi?url=http://www.ccp14.ac.uk/ccp/ccp14/ftp-mirror/gsas/public/gsas/windows/gsaskit.exe">http://www.ccp14.ac.uk/ccp/ccp14/ftp-mirror/gsas/public/gsas/windows/gsaskit.exe</A>
97or<BR>
98<A HREF="http://www.nist.gov/cgi-bin/exit_nist.cgi?url=ftp://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>
99
100<DT>USA<DD>
101<A HREF="http://www.nist.gov/cgi-bin/exit_nist.cgi?url=http://www.semo.edu/ccp/ccp14/ftp-mirror/gsas/public/gsas/windows/gsaskit.exe">http://www.semo.edu/ccp/ccp14/ftp-mirror/gsas/public/gsas/windows/gsaskit.exe</A>
102
103<DT>Canada<DD>
104<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>
105
106<DT>Australia<DD>
107<A HREF="http://www.nist.gov/cgi-bin/exit_nist.cgi?url=http://minerals.csiro.au/ccp/ccp14/ftp-mirror/gsas/public/gsas/windows/gsaskit.exe">http://minerals.csiro.au/ccp/ccp14/ftp-mirror/gsas/public/gsas/windows/gsaskit.exe</A>
108</DL>
109
110<P>be sure to read
111<A HREF="http://www.nist.gov/cgi-bin/exit_nist.cgi?url=http://www.ccp14.ac.uk/ccp/ccp14/ftp-mirror/gsas/public/gsas/windows/readme.txt">http://www.ccp14.ac.uk/ccp/ccp14/ftp-mirror/gsas/public/gsas/windows/readme.txt</A>
112<P>
113<P><LI>Get a
114<A Href="http://www.ncnr.nist.gov/programs/crystallography/software/tclpkgs.html">
115Tcl/Tk</A> distribution<BR>
116I recommend using this (not so new) version (Tcl/Tk v8.2)
117(why - <a href="#Winexec">see note 1 below</a>):<BR>
118<A HREF="ftp://ftp.ncnr.nist.gov/pub/cryst/tcltk/tcltk82blt24qwinexec0601.exe">
119ftp://ftp.ncnr.nist.gov/pub/cryst/tcltk/tcltk82blt24qwinexec0601.exe</A>
120(2686464 bytes)
121<P>
122<LI>The
123<A HREF="expgui.html">EXPGUI</A> code<BR>
124<A HREF="ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/expgui.exe">ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/expgui.exe</A>
125(~340 K bytes)
126<BR>for the absolute latest release (which may not have gotten
127a lot of testing, but probably has new capabilities and bug fixes) use<BR>
128<A HREF="ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/expgui_alpha.zip">
129ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/expgui_alpha.zip</A><BR>
130You will need an unzip program, such as WinZip or pkZip, to use this file.
131(sometimes I update
132<A HREF="ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/expgui_alpha.exe">
133ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/expgui_alpha.exe</A>
134but this may lag behind the .ZIP version or may not be present.)
135<P>
136You can put these .EXE (and .ZIP) files anywhere on your computer, but make a note of the
137locations for steps 2, 3 and 5, below.
138</UL>
139<P><B>2. Run the programs</B>
140<UL>Use a DOS window to run, gsaskit.exe,
141tcltk82blt24qwinexec0601.exe, and expgui.exe (the order should not matter):
142<FONT FACE="COURIER"><PRE>
143        mkdir c:\gsas
144        chdir c:\gsas
145        c:\temp\gsaskit.exe -d
146        c:\temp\tcltk82blt24qwinexec0601.exe
147        c:\temp\expgui.exe
148</PRE></FONT>
149
150These files can be run from where they are downloaded using the Run command
151or by clicking on their icons in a Windows Explorer or other directory view
152window.
153<P>
154The previous steps will cause the files to be unpacked. The default
155locations for installation are:
156<FONT FACE="COURIER"><PRE>
157           gsaskit.exe                     c:\gsas
158           tcltk82blt24qwinexec0601.exe    c:\tcl
159           expgui.exe                      c:\gsas\expgui
160</PRE></FONT>
161
162<P>These files can be located on other disks and in directories with
163other names, but the expgui files in expgui.exe
164<I><U>must</U></I> be located in a subdirectory of the GSAS files and
165each directory name should not have a space in the name
166so location
167<font face="courier">Z:\i\think\this\will\work\gsas</font> should be OK,
168as should
169<font face="courier">C:\longwindows\namesarenotgood\fordos</font> 
170but you may have trouble with<BR>
171<font face="courier">C:\Program Files\names with spaces\make problems</font> 
172probably will break drag-and-drop -- at least for EXPGUI.
173If these files will be located on a fileserver, the file server
174must be mapped to appear as a disk drive (must be assigned a name
175such as F:). But note, installing GSAS on a file server does not
176fully install
177GSAS on each PC that accesses the file server, since short-cuts and
178environment changes are needed.
179</UL>
180<P><B>3. Create a shortcut:</B>
181<UL>
182<LI>
183On a blank part of the Windows desktop, click the <I><U>right</U></I> mouse
184button and then select NEW and then shortcut and click with the <I><U>left</U></I>
185mouse button.</LI>
186
187<LI>
188provide command</LI>
189
190<UL><FONT FACE="COURIER">c:\tcl\bin\wish82.exe c:\gsas\expgui\expgui</FONT></UL>
191</UL>
192
193<UL>(modify previous paths, if you have located the files in different places)</UL>
194
195<UL>
196<LI>
197click on NEXT with the <I><U>left</U></I> mouse button.</LI>
198
199<LI>
200Enter name EXPGUI</LI>
201
202<LI>
203click on FINISH with the <I><U>left</U></I> mouse button.</LI>
204</UL>
205
206<UL>You may want to modify the shortcut by modifying the properties to
207change the icon or the default properties.</UL>
208<B>4. Delete the downloaded .exe files to save space (optional)</B>
209
210<DL>
211<DD>          gsaskit.exe
212<DD>          tcltk82blt24qwinexec0601.exe
213<DD>          expgui.exe
214<DD>          (expgui_alpha.exe)
215<DD>          (expgui_alpha.zip)
216</DL> 
217
218<P>More information about EXPGUI, including information on how it
219can be customized, can be found on web pages <A HREF="expgui.html">expgui.html</A>
220and <A HREF="expgui_cfg.html">expgui_cfg.html</A>,
221found in the \gsas\expgui\doc directory.
222<BR> 
223<H2>
224<a name="Winexec"></a>Questions</H2>
2251. Can I use a different version of Tcl/Tk than the one here?
226<UL>Yes -- but: you will need both Tcl/Tk and the Winexec package (see
227http://www.du.edu/~mschwart/tcl-tk.htm) for the GUI to work
228with Windows-95, -98 and -me. Further,
229several utility routines (for example, liveplot and widplt)
230require the BLT package to be properly configured as a loadable
231package to run. If you care what vintage of Tcl/Tk you are using, you are
232obviously a "power user" so take a look at the pkgIndex.tcl files and fix
233your version, if you get an error about loading Blt_ZoomStack.
234Please note that EXPGUI seems to run very
235slowly in Tcl/Tk version 8.1, but OK in 8.0 and 8.2.
236<BR> </UL>
2372. Do I need to modify the PATH, etc in my AUTOEXEC.BAT file or in my Start/Settings/... menus?
238<UL>Only if you will use the PC-GSAS program as well as EXPGUI.
239If so, do follow the steps in the
240<A HREF="http://www.nist.gov/cgi-bin/exit_nist.cgi?url=http://www.ccp14.ac.uk/ccp/ccp14/ftp-mirror/gsas/public/gsas/windows/readme.txt">
241GSAS readme file</A>)
242<P>
243Note, to add more environment space in Win95/98, add the following line to the
244CONFIG.SYS file in the root directory
245<FONT FACE="COURIER"><PRE>
246        SHELL=C:\WINDOWS\COMMAND.COM /P /E:4096
247</PRE></FONT>
248add the following line to the SYSTEM.INI file (in c:\windows) under
249the heading [NonWindowsApp]
250<FONT FACE="COURIER"><PRE>
251
252        CommandEnvSize=2424
253</PRE></FONT>
254(thanks to Louis Farrugia [louis@chem.gla.ac.uk] for this).
255
256</UL>
2573. What versions of Windows can I use?
258<UL>As far as I am aware, EXPGUI will run under all releases of Windows from
259-95 through -XP, but it is not tested here on most of those platforms.
260I depend on feedback from users to tell me of OS conflicts, but none have
261been reported.
262</UL>
2634. EXPGUI seems pretty slow, or is it my imagination?
264<UL>
265Well, actually the problem is Windows. EXPGUI is pretty zippy in LINUX,
266but some operations
267(reading a histogram in liveplot for example) can take 3-5 times
268longer in Windows than in UNIX on the exact same hardware.
269By all means, take this up with the folks in Redmond, WA.
270
271</UL>
2725. When I run one of the GSAS graphics programs (POWPLOT, RAWPLOT,...) the
273program starts, and I can answer questions, but when it comes to the part
274of the program that should display a plot, I get no plot (and possibly
275the DOS window disappears without a trace.)
276<UL>
277There are two problems I know of that can cause graphics errors:
278One is that the graphics package (PGPLOT) cannot find the PGPLOT_FONT
279environment variable (that points to file GRFONT.DAT). EXPGUI does this
280for you and warns if it can't find this file, so the likely reason is
281that you are out of environment space (see 2, above).
282<P>
283The other appears to be a graphics mode problem. Not all modes work
284on all machines. Try mode A. If you still have problems, see if it is an
285EXPGUI problem: Try using a plotting program
286(RAWPLOT is a good choice) from PC-GSAS or GSAS.BAT.  If the plotting
287program does not work there either, first check PGPLOT_FONT is defined
288(by opening a DOS box and type SET, also see question 2, above.)
289If the plotting program runs in PC-GSAS or GSAS.BAT but not EXPGUI, you have a
290real EXPGUI bug and should bug me.
291
292</UL>
293<a name="NetPath"></a>
2946. Can GSAS and EXPGUI be located on a shared network drive?
295<UL>
296Yes. With earlier versions of GSAS path had to be mapped to a
297"logical drive." (e.g. F:). In the current versions of GSAS, this does not
298seem to be needed, but
299EXPGUI will warn you, if you try to do this, since I am not certain
300that this works.
301<P>
302I do not know if GSAS will work properly with
303experiment and data files on a networked drive without mapping the
304path to a "logical drive."
305There are some definite problems in GSAS where directory and file
306names contain
307spaces. EXPGUI should help avoid some of these problems, so if you find
308anything file names that break EXPGUI & GSAS, let me know how to
309duplicate exactly what you are doing.
310</UL>
311
3127. Can I use Windows-ME or Windows-XP with GSAS and EXPGUI?
313<UL>
314I do not have any direct experience with either OS. I am not aware of any
315problems running EXPGUI & GSAS on -ME. I have heard that there are minor
316problems with running EXPGUI on -XP -- after GSAS programs are run, EXPGUI
317may remain minimized (on the taskbar) rather than reopen itself. This
318problem can be avoided by unselecting the "Minimize on GSAS" checkbutton
319in the Options menu.
320
321</UL>
322
323<H2>
324Acknowledgements</H2>
325Thanks to <A HREF="http://www.nist.gov/cgi-bin/exit_nist.cgi?url=http://www.xraylith.wisc.edu/~khan/software/tcl/index.html#tcltk-80p2-ming">Mumit
326Khan</A> for help with Tcl/Tk on Windows
327and to <A HREF="http://www.nist.gov/cgi-bin/exit_nist.cgi?url=http://www.du.edu/~mschwart/tcl-tk.htm">Michael
328I. Schwartz</A> for the Winexec package, which is needed to allow Tcl/Tk to run
329the GSAS DOS .exe files.
330<P>
331<A Href="http://www.ncnr.nist.gov/programs/crystallography/software/gsas.html">
332GSAS</A>
333is written by Allen C. Larson and Robert B. Von Dreele,  MS-H805,
334Los Alamos National Laboratory, Los Alamos, NM 87545. Problems, questions
335or kudos concerning GSAS should be sent to Robert B. Von Dreele at
336<A HREF="MAILTO:vondreele@anl.gov">vondreele@anl.gov</A>
337<P>EXPGUI is written by Brian H. Toby of the NIST Center for Neutron Research,
338<A HREF="MAILTO:Brian.Toby@NIST.GOV">Brian.Toby@NIST.GOV</A> 
339with help from Jonathan Wasserman.
340
341<P>
342<hr><blockquote>
343GSAS is Copyright, 1984-1997, The Regents of the University of California.
344The GSAS software was produced under a U.S. Government contract (W-7405-ENG-36)
345by the Los Alamos National Laboratory, which is operated by the University
346of California for the U.S. Department of Energy. The U.S. Government is
347licensed to use, reproduce, and distribute this software. Permission is
348granted to the public to copy and use this software without charge, provided
349that this notice and any statement of authorship are reproduced on all
350copies. Neither the Government nor the University makes any warranty, express
351or implied, or assumes any liability or responsibility for the use of this
352software.
353
354<P>EXPGUI is not subject to copyright. Have fun with it.
355
356<p>Neither the U.S. Government nor any author makes any warranty,
357expressed or implied, or assumes any liability or responsibility
358for the use of this information or the software described
359here. Brand names cited here are used for
360identification purposes and do not consitute an endorsement by NIST.
361</blockquote>
362<hr>
363<TABLE BORDER BGCOLOR="#FFFF40" ALIGN=RIGHT>
364<TR><TH><A  Href="expgui.html">EXPGUI home</A> 
365</TH></TR></TABLE>
366
367<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>
368<font size=-1><? lastmod(); ?> </font>
369<br>
370$Revision: 752 $ $Date: 2009-12-04 23:11:25 +0000 (Fri, 04 Dec 2009) $
371</blockquote>
372</body>
373</html>
Note: See TracBrowser for help on using the repository browser.