source: trunk/doc/expgui_Win_readme.html @ 367

Last change on this file since 367 was 367, checked in by toby, 12 years ago

# on 2000/12/22 21:14:32, toby did:
minor edits, recommend tcl 8.2 now
  • Property rcs:author set to toby
  • Property rcs:date set to 2000/12/22 21:14:32
  • Property rcs:lines set to +29 -21
  • Property rcs:rev set to 1.15
  • Property rcs:state set to Exp
  • Property svn:keywords set to Author Date Revision Id
File size: 13.6 KB
Line 
1<HTML>
2<HEAD>
3   <META NAME="Author" CONTENT="Brian H. Toby">
4   <TITLE>Windows Installation Notes for EXPGUI</TITLE>
5</HEAD>
6<BODY BGCOLOR="#FFFFFF">
7<A HREF=http://www.ncnr.nist.gov>
8<IMG SRC="http://www.ncnr.nist.gov/images/ncnrtrans.gif" 
9alt="Link to NIST Center for Neutron Research home page"
10ALIGN=RIGHT></A>
11<A HREF=http://www.nist.gov>
12<IMG SRC="http://www.ncnr.nist.gov/images/webidblue_2lineright.gif" 
13alt="Link to National Institute of Standards & Technology home page"
14ALIGN=LEFT></A>
15<CENTER>
16<A Href="http://www.ncnr.nist.gov/programs/crystallography/software/tclpkgs.html">
17<IMG SRC="tcltklogo100.gif" 
18alt="Link to Tcl/Tk information">
19</CENTER></A>
20<br clear=all>
21
22<CENTER>
23<HR noshade width="75%" size="2" align="center">
24<H1>
25Windows-95 and -NT <BR>Installation notes for <A HREF="expgui.html">
26EXPGUI
27</A>
28</H1>
29<HR noshade width="75%" size="2" align="center">
30</CENTER>
31<EM>Please note that <A HREF="expgui.html">EXPGUI</A>
32 is always under development and gets
33less testing by the author
34in Windows than in UNIX. Please report problems, including comments on
35these instructions to
36<A HREF="mailto:brian.toby@nist.gov">Brian Toby</A>.
37</EM>
38
39<P><B>1. Download the following files:</B>
40<UL>
41<I>(Shift-click on the links below to download the files)</I>
42<P>
43<LI>Get
44<A Href="http://www.ncnr.nist.gov/programs/crystallography/software/gsas.html">
45GSAS</A> from
46<A HREF="ftp://ftp.lanl.gov/public/gsas/ms-dos/gsaskit.exe">ftp://ftp.lanl.gov/public/gsas/ms-dos/gsaskit.exe</A>
47(~6 Mbytes)<BR>
48and read<BR>
49<A HREF="ftp://ftp.lanl.gov/public/gsas/ms-dos/readme.txt">ftp://ftp.lanl.gov/public/gsas/ms-dos/readme.txt</A>
50<P>
51Mirrors for these files can be found at
52<P><A HREF="
53http://www.ccp14.ac.uk/ccp/ccp14/ftp-mirror/gsas/public/gsas/ms-dos/gsaskit.exe
54">
55http://www.ccp14.ac.uk/ccp/ccp14/ftp-mirror/gsas/public/gsas/ms-dos/gsaskit.exe
56</A><BR>
57or
58<A HREF="
59http://ccp14.sims.nrc.ca/ccp/ccp14/ftp-mirror/gsas/public/gsas/ms-dos/gsaskit.exe
60">
61http://ccp14.sims.nrc.ca/ccp/ccp14/ftp-mirror/gsas/public/gsas/ms-dos/gsaskit.exe
62</A><P>and<P><A HREF="
63http://www.ccp14.ac.uk/ccp/ccp14/ftp-mirror/gsas/public/gsas/ms-dos/readme.txt
64">
65http://www.ccp14.ac.uk/ccp/ccp14/ftp-mirror/gsas/public/gsas/ms-dos/readme.txt
66</A><BR>
67or
68<A HREF="
69http://ccp14.sims.nrc.ca/ccp/ccp14/ftp-mirror/gsas/public/gsas/ms-dos/readme.txt
70">
71http://ccp14.sims.nrc.ca/ccp/ccp14/ftp-mirror/gsas/public/gsas/ms-dos/readme.txt
72</A><BR><P>
73<em>
74Note that the links for these files are on non-NIST servers.
75</em>
76<P><LI>Get a
77<A Href="http://www.ncnr.nist.gov/programs/crystallography/software/tclpkgs.html">
78Tcl/Tk</A> distribution<BR>
79I recommend using this (not so new) version (Tcl/Tk v8.2):<BR>
80<A HREF="ftp://ftp.ncnr.nist.gov/pub/cryst/tcltk/tcltk82blt24qwinexec0601.exe">
81ftp://ftp.ncnr.nist.gov/pub/cryst/tcltk/tcltk82blt24qwinexec0601.exe</A>
82(2686464 bytes)
83<BR>Or, you could also load this older version (Tcl/Tk v8.0):<BR>
84<A HREF="ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/win/tcltk80p2+.exe">ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/win/tcltk80p2+.exe</A>
85(3604992 bytes). I think 8.2 is a better choice.
86<P>
87<LI>The
88<A HREF="expgui.html">EXPGUI</A> code<BR>
89<A HREF="ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/expgui.exe">ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/expgui.exe</A>
90(~340 K bytes)
91<BR>for the absolute latest release (which may not have gotten
92a lot of testing, but probably has new capabilities and bug fixes) use<BR>
93<A HREF="ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/expgui_alpha.zip">
94ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/expgui_alpha.zip</A><BR>
95You will need an unzip program, such as WinZip or pkZip, to use this file.
96(sometimes I update
97<A HREF="ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/expgui_alpha.exe">
98ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/expgui_alpha.exe</A>
99but this may lag behind the .ZIP version or be deleted.)
100<P><LI>
101If you are using an older version of GSAS (before April, 2000) you may
102want to download the TCLDUMP program to speed and enhance liveplot and the
103EXPTOOL program which allows EXPGUI to add phases, histograms and atoms
104to .EXP files. More recent versions of GSAS include these programs in the
105distributions.<BR>
106<A HREF="ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/exe_win/tcldump.zip">ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/exe_win/tcldump.zip</A> (~85 K bytes)
107<BR>
108or <A HREF="ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/exe_win/tcldump.exe">ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/exe_win/tcldump.exe</A> (~160 K bytes)
109<P>
110<A HREF="ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/exe_win/exptool.zip">ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/exe_win/exptool.zip</A> (~300 K bytes)
111<BR>
112or <A HREF="ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/exe_win/exptool.exe">ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/exe_win/exptool.exe</A> (~700 K bytes)
113</UL>
114You can put these .EXE (and .ZIP) files anywhere on your computer, but make a note of the
115locations for steps 2, 3 and 5, below.
116
117<P><B>2. Run the programs</B>
118<UL>Use a DOS window to run, gsaskit.exe,
119tcltk80p2+.exe, and expgui.exe (the order should not matter):
120<PRE>
121        mkdir c:\gsas
122        chdir c:\gsas
123        c:\temp\gsaskit.exe -d
124        c:\temp\tcltk80p2+.exe
125        c:\temp\expgui.exe
126</PRE>
127
128Note that gsaskit.exe must be run in the location where you want the
129files to be placed and that you must use the -d option. For this
130reason you must know what you are doing to do this from the Windows interface.
131(Using WinZip is another good way to unzip the file with the correct directory structure or to uncompress expgui_alpha.zip). The tcltk80p2+.exe and
132expgui.exe files can be run from Windows.
133<P>
134The previous steps will cause the files to be unpacked. The default
135locations for installation are:
136<PRE>
137           gsaskit.exe         c:\gsas
138           tcltk80p2+.exe      c:\expgui
139           expgui.exe          c:\gsas\expgui
140</PRE>
141
142<P>These files can be located on other disks and in directories with
143other names, but the expgui files in expgui.exe
144<I><U>must</U></I> be located in a subdirectory of the GSAS files.
145If these files will be located on a fileserver, the file server
146must be mapped to appear as a disk drive (must be assigned a name
147such as F:).
148</UL>
149<P><B>3. When needed, install TCLDUMP and EXPTOOL</B>
150<UL>
151If TCLDUMP and EXPTOOL <I>are not already present</I>,
152place the <tt>tcldump.exe</tt> and
153<tt>exptool.exe</tt> files in the <tt>exe</tt> directory of GSAS,
154(usually <tt>c:\gsas\exe\</tt>).
155(If you downloaded <tt>tcldump.zip</tt> & <tt>exptool.zip</tt>, expand
156them first.)
157</UL>
158<P><B>4. Create a shortcut:</B>
159<UL>
160<LI>
161On a blank part of the Windows desktop, click the <I><U>right</U></I> mouse
162button and then select NEW and then shortcut and click with the <I><U>left</U></I>
163mouse button.</LI>
164
165<LI>
166provide command</LI>
167
168<UL><TT>c:\tcl\bin\wish80.exe c:\gsas\expgui\expgui</TT></UL>
169</UL>
170
171<UL>(modify previous paths, if you have located the files in different places)</UL>
172
173<UL>
174<LI>
175click on NEXT with the <I><U>left</U></I> mouse button.</LI>
176
177<LI>
178Enter name EXPGUI</LI>
179
180<LI>
181click on FINISH with the <I><U>left</U></I> mouse button.</LI>
182</UL>
183
184<UL>You may want to modify the shortcut by modifying the properties to
185change the icon or the default properties.</UL>
186<B>5. Delete the downloaded .exe (and .zip) files to save space (optional)</B>
187
188<DL>
189<DD>          gsaskit.exe
190<DD>          tcltk80p2+.exe
191<DD>          expgui.exe
192<DD>          (tcldump.zip)
193<DD>          (exptool.zip)
194<DD>          (expgui_alpha.zip)
195</DL> 
196
197<P>More information about EXPGUI, including information on how it
198can be customized, can be found on web pages <A HREF="expgui.html">expgui.html</A>
199and <A HREF="expgui_cfg.html">expgui_cfg.html</A>,
200found in the \gsas\expgui\doc directory.
201<BR> 
202<H2>
203<a name="Winexec"></a>Questions</H2>
2041. Can I use a different version of Tcl/Tk than the one here?
205<UL>Yes -- but: you will need both Tcl/Tk and the Winexec package (see
206http://www.du.edu/~mschwart/tcl-tk.htm) for the GUI to work
207with Windows-95, -98 and -me. Further,
208several utility routines (liveplot and widplt)
209require the BLT package to be properly configured as a loadable
210package to run. If you care what vintage of Tcl/Tk you are using, you are
211obviously a "power user" so take a look at the pkgIndex.tcl files and fix
212your version, if you get an error about loading Blt_ZoomStack.
213Please note that EXPGUI seems to run very
214slowly in Tcl/Tk version 8.1, but OK in 8.0 and 8.2.
215<BR> </UL>
2162. Do I need to modify the PATH, etc in my AUTOEXEC.BAT file?
217<UL>Only if you will use the PC-GSAS or GSAS.BAT menu programs as well.
218If so, do the following (from the
219<A HREF="ftp://ftp.lanl.gov/public/gsas/ms-dos/readme.txt">GSAS readme file</A>):
220<BR> 
221<UL><TT>5. Modify the PATH statement in your autoexec.bat file to add C:\GSAS\EXE
222to the path (or whatever disk letter you choose for \GSAS)</TT>
223
224<P><TT>6. Add the statement "SET GSAS=C:\GSAS" (again pick the appropriate
225drive letter) to your auto exec.bat file.</TT>
226
227<P><TT>7. Add the statement "SET PGPLOT_FONT=C:\GSAS\FONTS\GRFONT.DAT"</TT>
228
229<P><TT>8. Make sure you have sufficient environment space for these additions
230and two more that are done by gsas.bat each time you run gsas.</TT></UL>
231<P>
232Note, to add more environment space in Win95/98, add the following line to the
233CONFIG.SYS file in the root directory
234<PRE>
235        SHELL=C:\WINDOWS\COMMAND.COM /P /E:4096
236</PRE>
237add the following line to the SYSTEM.INI file (in c:\windows) under
238the heading [NonWindowsApp]
239<PRE>
240
241        CommandEnvSize=2424
242</PRE>
243(thanks to Louis Farrugia [louis@chem.gla.ac.uk] for this).
244
245</UL>
2463. What versions of Windows can I use?
247<UL>This package has gotten some testing under Win95 and WinNT v4.0.
248My limited experience with Win98 seems to show that EXPGUI runs OK.
249It might be possible to get some parts of the package to run under
250Win3.1 with the Tcl/Tk version (8.0) that runs in Win32s, but
251you are on your own.
252</UL>
2534. EXPGUI seems pretty slow, or is it my imagination?
254<UL>
255Well, actually the problem is Windows. EXPGUI is pretty zippy in LINUX,
256but some operations
257(reading a histogram in liveplot for example) can take 3-5 times
258longer in Windows than in UNIX on the exact same hardware.
259By all means, take this up with the folks in Redmond, WA.
260
261</UL>
2625. When I run one of the GSAS graphics programs (POWPLOT, RAWPLOT,...) the
263program starts, and I can answer questions, but when it comes to the part
264of the program that should display a plot, I get no plot (and possibly
265the DOS window disappears without a trace.)
266<UL>
267There are two problems I know of that can cause graphics errors:
268One is that the graphics package (PGPLOT) cannot find the PGPLOT_FONT
269environment variable (that points to file GRFONT.DAT). EXPGUI does this
270for you and warns if it can't find this file, so the likely reason is
271that you are out of environment space (see 2, above).
272<P>
273The other appears to be a graphics mode problem. Not all modes work
274on all machines. Try mode A. If you still have problems, see if it is an
275EXPGUI problem: Try using a plotting program
276(RAWPLOT is a good choice) from PC-GSAS or GSAS.BAT.  If the plotting
277program does not work there either, first check PGPLOT_FONT is defined
278(by opening a DOS box and type SET, also see question 2, above.)
279If the plotting program runs in PC-GSAS or GSAS.BAT but not EXPGUI, you have a
280real EXPGUI bug and should bug me.
281
282<a name="NetPath"></a></UL>
2834. Can GSAS and EXPGUI be located on a shared network drive?
284<UL>
285Yes, but. The path must be mapped to a "logical drive."
286(e.g. F:) since GSAS is basically a set of DOS programs.
287Likewise, you will have troubles accessing
288experiment and data files on a networked drive unless
289that path is also mapped to a "logical drive."
290EXPGUI will warn you, if you do either.
291</UL>
292
293<H2>
294Acknowledgements</H2>
295The 8.0 version of Tcl/Tk was compiled by <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
296Khan</A> and the Winexec package, which is needed to allow Tcl/Tk to run
297the GSAS DOS .exe files was created by <A HREF="http://www.nist.gov/cgi-bin/exit_nist.cgi?url=http://www.du.edu/~mschwart/tcl-tk.htm">Michael
298I. Schwartz</A>.
299
300<P>
301<A Href="http://www.ncnr.nist.gov/programs/crystallography/software/gsas.html">
302GSAS</A>
303is written by Allen C. Larson and Robert B. Von Dreele,  MS-H805,
304Los Alamos National Laboratory, Los Alamos, NM 87545. Problems, questions
305or kudos concerning GSAS should be sent to Robert B. Von Dreele at
306<A HREF="MAILTO:vondreele@lanl.gov">vondreele@lanl.gov</A>
307<P>GSAS is Copyright, 1984-1997, The Regents of the University of California.
308The GSAS software was produced under a U.S. Government contract (W-7405-ENG-36)
309by the Los Alamos National Laboratory, which is operated by the University
310of California for the U.S. Department of Energy. The U.S. Government is
311licensed to use, reproduce, and distribute this software. Permission is
312granted to the public to copy and use this software without charge, provided
313that this notice and any statement of authorship are reproduced on all
314copies. Neither the Government nor the University makes any warranty, express
315or implied, or assumes any liability or responsibility for the use of this
316software.
317<P>EXPGUI is written by Brian H. Toby of the NIST Center for Neutron Research,
318<A HREF="MAILTO:Brian.Toby@NIST.GOV">Brian.Toby@NIST.GOV</A> 
319with help from Jonathan Wasserman.
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
329<p><a href="http://www.ncnr.nist.gov/staff/toby/">Brian Toby</a> (<a href="mailto:brian.toby@nist.gov">Brian.Toby@NIST.GOV</a>)
330<br>
331$Revision: 367 $ $Date: 2009-12-04 23:04:59 +0000 (Fri, 04 Dec 2009) $
332</body>
333</html>
Note: See TracBrowser for help on using the repository browser.