source: trunk/doc/expgui_Win_readme.html @ 440

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

# on 2001/02/26 19:52:54, toby did:
long name warning

  • Property rcs:author set to toby
  • Property rcs:date set to 2001/02/26 19:52:54
  • Property rcs:lines set to +7 -2
  • Property rcs:rev set to 1.16
  • Property rcs:state set to Exp
  • Property svn:keywords set to Author Date Revision Id
File size: 13.8 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 and
145each directory name <I><U>must</U></I> be 8 characters or less, so
146location
147<tt>Z:\i\think\this\will\work\gsas</tt> should be OK, but
148<tt>C:\longwindows\namesarenotgood\for dos</tt> probably
149will not work.
150If these files will be located on a fileserver, the file server
151must be mapped to appear as a disk drive (must be assigned a name
152such as F:).
153</UL>
154<P><B>3. When needed, install TCLDUMP and EXPTOOL</B>
155<UL>
156If TCLDUMP and EXPTOOL <I>are not already present</I>,
157place the <tt>tcldump.exe</tt> and
158<tt>exptool.exe</tt> files in the <tt>exe</tt> directory of GSAS,
159(usually <tt>c:\gsas\exe\</tt>).
160(If you downloaded <tt>tcldump.zip</tt> & <tt>exptool.zip</tt>, expand
161them first.)
162</UL>
163<P><B>4. Create a shortcut:</B>
164<UL>
165<LI>
166On a blank part of the Windows desktop, click the <I><U>right</U></I> mouse
167button and then select NEW and then shortcut and click with the <I><U>left</U></I>
168mouse button.</LI>
169
170<LI>
171provide command</LI>
172
173<UL><TT>c:\tcl\bin\wish80.exe c:\gsas\expgui\expgui</TT></UL>
174</UL>
175
176<UL>(modify previous paths, if you have located the files in different places)</UL>
177
178<UL>
179<LI>
180click on NEXT with the <I><U>left</U></I> mouse button.</LI>
181
182<LI>
183Enter name EXPGUI</LI>
184
185<LI>
186click on FINISH with the <I><U>left</U></I> mouse button.</LI>
187</UL>
188
189<UL>You may want to modify the shortcut by modifying the properties to
190change the icon or the default properties.</UL>
191<B>5. Delete the downloaded .exe (and .zip) files to save space (optional)</B>
192
193<DL>
194<DD>          gsaskit.exe
195<DD>          tcltk80p2+.exe
196<DD>          expgui.exe
197<DD>          (tcldump.zip)
198<DD>          (exptool.zip)
199<DD>          (expgui_alpha.zip)
200</DL> 
201
202<P>More information about EXPGUI, including information on how it
203can be customized, can be found on web pages <A HREF="expgui.html">expgui.html</A>
204and <A HREF="expgui_cfg.html">expgui_cfg.html</A>,
205found in the \gsas\expgui\doc directory.
206<BR> 
207<H2>
208<a name="Winexec"></a>Questions</H2>
2091. Can I use a different version of Tcl/Tk than the one here?
210<UL>Yes -- but: you will need both Tcl/Tk and the Winexec package (see
211http://www.du.edu/~mschwart/tcl-tk.htm) for the GUI to work
212with Windows-95, -98 and -me. Further,
213several utility routines (liveplot and widplt)
214require the BLT package to be properly configured as a loadable
215package to run. If you care what vintage of Tcl/Tk you are using, you are
216obviously a "power user" so take a look at the pkgIndex.tcl files and fix
217your version, if you get an error about loading Blt_ZoomStack.
218Please note that EXPGUI seems to run very
219slowly in Tcl/Tk version 8.1, but OK in 8.0 and 8.2.
220<BR> </UL>
2212. Do I need to modify the PATH, etc in my AUTOEXEC.BAT file?
222<UL>Only if you will use the PC-GSAS or GSAS.BAT menu programs as well.
223If so, do the following (from the
224<A HREF="ftp://ftp.lanl.gov/public/gsas/ms-dos/readme.txt">GSAS readme file</A>):
225<BR> 
226<UL><TT>5. Modify the PATH statement in your autoexec.bat file to add C:\GSAS\EXE
227to the path (or whatever disk letter you choose for \GSAS)</TT>
228
229<P><TT>6. Add the statement "SET GSAS=C:\GSAS" (again pick the appropriate
230drive letter) to your auto exec.bat file.</TT>
231
232<P><TT>7. Add the statement "SET PGPLOT_FONT=C:\GSAS\FONTS\GRFONT.DAT"</TT>
233
234<P><TT>8. Make sure you have sufficient environment space for these additions
235and two more that are done by gsas.bat each time you run gsas.</TT></UL>
236<P>
237Note, to add more environment space in Win95/98, add the following line to the
238CONFIG.SYS file in the root directory
239<PRE>
240        SHELL=C:\WINDOWS\COMMAND.COM /P /E:4096
241</PRE>
242add the following line to the SYSTEM.INI file (in c:\windows) under
243the heading [NonWindowsApp]
244<PRE>
245
246        CommandEnvSize=2424
247</PRE>
248(thanks to Louis Farrugia [louis@chem.gla.ac.uk] for this).
249
250</UL>
2513. What versions of Windows can I use?
252<UL>This package has gotten some testing under Win95 and WinNT v4.0.
253My limited experience with Win98 seems to show that EXPGUI runs OK.
254It might be possible to get some parts of the package to run under
255Win3.1 with the Tcl/Tk version (8.0) that runs in Win32s, but
256you are on your own.
257</UL>
2584. EXPGUI seems pretty slow, or is it my imagination?
259<UL>
260Well, actually the problem is Windows. EXPGUI is pretty zippy in LINUX,
261but some operations
262(reading a histogram in liveplot for example) can take 3-5 times
263longer in Windows than in UNIX on the exact same hardware.
264By all means, take this up with the folks in Redmond, WA.
265
266</UL>
2675. When I run one of the GSAS graphics programs (POWPLOT, RAWPLOT,...) the
268program starts, and I can answer questions, but when it comes to the part
269of the program that should display a plot, I get no plot (and possibly
270the DOS window disappears without a trace.)
271<UL>
272There are two problems I know of that can cause graphics errors:
273One is that the graphics package (PGPLOT) cannot find the PGPLOT_FONT
274environment variable (that points to file GRFONT.DAT). EXPGUI does this
275for you and warns if it can't find this file, so the likely reason is
276that you are out of environment space (see 2, above).
277<P>
278The other appears to be a graphics mode problem. Not all modes work
279on all machines. Try mode A. If you still have problems, see if it is an
280EXPGUI problem: Try using a plotting program
281(RAWPLOT is a good choice) from PC-GSAS or GSAS.BAT.  If the plotting
282program does not work there either, first check PGPLOT_FONT is defined
283(by opening a DOS box and type SET, also see question 2, above.)
284If the plotting program runs in PC-GSAS or GSAS.BAT but not EXPGUI, you have a
285real EXPGUI bug and should bug me.
286
287<a name="NetPath"></a></UL>
2884. Can GSAS and EXPGUI be located on a shared network drive?
289<UL>
290Yes, but. The path must be mapped to a "logical drive."
291(e.g. F:) since GSAS is basically a set of DOS programs.
292Likewise, you will have troubles accessing
293experiment and data files on a networked drive unless
294that path is also mapped to a "logical drive."
295EXPGUI will warn you, if you do either.
296</UL>
297
298<H2>
299Acknowledgements</H2>
300The 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
301Khan</A> and the Winexec package, which is needed to allow Tcl/Tk to run
302the 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
303I. Schwartz</A>.
304
305<P>
306<A Href="http://www.ncnr.nist.gov/programs/crystallography/software/gsas.html">
307GSAS</A>
308is written by Allen C. Larson and Robert B. Von Dreele,  MS-H805,
309Los Alamos National Laboratory, Los Alamos, NM 87545. Problems, questions
310or kudos concerning GSAS should be sent to Robert B. Von Dreele at
311<A HREF="MAILTO:vondreele@lanl.gov">vondreele@lanl.gov</A>
312<P>GSAS is Copyright, 1984-1997, The Regents of the University of California.
313The GSAS software was produced under a U.S. Government contract (W-7405-ENG-36)
314by the Los Alamos National Laboratory, which is operated by the University
315of California for the U.S. Department of Energy. The U.S. Government is
316licensed to use, reproduce, and distribute this software. Permission is
317granted to the public to copy and use this software without charge, provided
318that this notice and any statement of authorship are reproduced on all
319copies. Neither the Government nor the University makes any warranty, express
320or implied, or assumes any liability or responsibility for the use of this
321software.
322<P>EXPGUI is written by Brian H. Toby of the NIST Center for Neutron Research,
323<A HREF="MAILTO:Brian.Toby@NIST.GOV">Brian.Toby@NIST.GOV</A> 
324with help from Jonathan Wasserman.
325
326<P>EXPGUI is not subject to copyright. Have fun with it.
327
328<p>Neither the U.S. Government nor any author makes any warranty,
329expressed or implied, or assumes any liability or responsibility
330for the use of this information or the software described
331here. Brand names cited here are used for
332identification purposes and do not consitute an endorsement by NIST.
333
334<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>)
335<br>
336$Revision: 374 $ $Date: 2009-12-04 23:05:06 +0000 (Fri, 04 Dec 2009) $
337</body>
338</html>
Note: See TracBrowser for help on using the repository browser.