source: trunk/doc/expgui_Win_readme.html @ 475

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

# on 2001/09/25 23:18:12, toby did:
new GSAS website
new EXPTOOL
eliminate tcltk8.0

  • Property rcs:author set to toby
  • Property rcs:date set to 2001/09/25 23:18:12
  • Property rcs:lines set to +41 -69
  • Property rcs:rev set to 1.17
  • Property rcs:state set to Exp
  • Property svn:keywords set to Author Date Revision Id
File size: 12.2 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/windows/gsaskit.exe">ftp://ftp.lanl.gov/public/gsas/windows/gsaskit.exe</A>
47(~6 Mbytes)<BR>
48and read<BR>
49<A HREF="ftp://ftp.lanl.gov/public/gsas/windows/readme.txt">ftp://ftp.lanl.gov/public/gsas/windows/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/windows/gsaskit.exe
54">
55http://www.ccp14.ac.uk/ccp/ccp14/ftp-mirror/gsas/public/gsas/windows/gsaskit.exe
56</A><BR>
57or
58<A HREF="
59http://ccp14.sims.nrc.ca/ccp/ccp14/ftp-mirror/gsas/public/gsas/windows/gsaskit.exe
60">
61http://ccp14.sims.nrc.ca/ccp/ccp14/ftp-mirror/gsas/public/gsas/windows/gsaskit.exe
62</A><P>and<P><A HREF="
63http://www.ccp14.ac.uk/ccp/ccp14/ftp-mirror/gsas/public/gsas/windows/readme.txt
64">
65http://www.ccp14.ac.uk/ccp/ccp14/ftp-mirror/gsas/public/gsas/windows/readme.txt
66</A><BR>
67or
68<A HREF="
69http://ccp14.sims.nrc.ca/ccp/ccp14/ftp-mirror/gsas/public/gsas/windows/readme.txt
70">
71http://ccp14.sims.nrc.ca/ccp/ccp14/ftp-mirror/gsas/public/gsas/windows/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)
80(why - <a href="#Winexec">see note 1 below</a>):<BR>
81<A HREF="ftp://ftp.ncnr.nist.gov/pub/cryst/tcltk/tcltk82blt24qwinexec0601.exe">
82ftp://ftp.ncnr.nist.gov/pub/cryst/tcltk/tcltk82blt24qwinexec0601.exe</A>
83(2686464 bytes)
84<P>
85<LI>The
86<A HREF="expgui.html">EXPGUI</A> code<BR>
87<A HREF="ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/expgui.exe">ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/expgui.exe</A>
88(~340 K bytes)
89<BR>for the absolute latest release (which may not have gotten
90a lot of testing, but probably has new capabilities and bug fixes) use<BR>
91<A HREF="ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/expgui_alpha.zip">
92ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/expgui_alpha.zip</A><BR>
93You will need an unzip program, such as WinZip or pkZip, to use this file.
94(sometimes I update
95<A HREF="ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/expgui_alpha.exe">
96ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/expgui_alpha.exe</A>
97but this may lag behind the .ZIP version or may not be present.)
98<P>
99<P><LI>
100If you have a version of GSAS from September 2001, or earlier and wish
101to set up dummy histograms from EXPEDT, you will need to
102update the EXPTOOL program using one of the following files:
103<BR>
104<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)
105<BR>
106or <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)
107</UL>
108<P>
109You can put these .EXE (and .ZIP) files anywhere on your computer, but make a note of the
110locations for steps 2, 3 and 5, below.
111
112<P><B>2. Run the programs</B>
113<UL>Use a DOS window to run, gsaskit.exe,
114tcltk82blt24qwinexec0601.exe, and expgui.exe (the order should not matter):
115<PRE>
116        mkdir c:\gsas
117        chdir c:\gsas
118        c:\temp\gsaskit.exe -d
119        c:\temp\tcltk82blt24qwinexec0601.exe
120        c:\temp\expgui.exe
121</PRE>
122
123These files can be run from where they are downloaded using the Run command
124or by clicking on their icons in a Windows Explorer or other directory view
125window.
126<P>
127The previous steps will cause the files to be unpacked. The default
128locations for installation are:
129<PRE>
130           gsaskit.exe                     c:\gsas
131           tcltk82blt24qwinexec0601.exe    c:\expgui
132           expgui.exe                      c:\gsas\expgui
133</PRE>
134
135<P>These files can be located on other disks and in directories with
136other names, but the expgui files in expgui.exe
137<I><U>must</U></I> be located in a subdirectory of the GSAS files and
138each directory name <I><U>must</U></I> be 8 characters or less, so
139location
140<tt>Z:\i\think\this\will\work\gsas</tt> should be OK, but
141<tt>C:\longwindows\namesarenotgood\for dos</tt> probably
142will not work.
143If these files will be located on a fileserver, the file server
144must be mapped to appear as a disk drive (must be assigned a name
145such as F:).
146<P>
147If you downloaded exptool.zip, unpack it and copy it to
148<tt>c:\gsas\exe</tt>, or if you downloaded exptool.exe, it can be copied
149directly to <tt>c:\gsas\exe</tt>.
150</UL>
151<P><B>3. Create a shortcut:</B>
152<UL>
153<LI>
154On a blank part of the Windows desktop, click the <I><U>right</U></I> mouse
155button and then select NEW and then shortcut and click with the <I><U>left</U></I>
156mouse button.</LI>
157
158<LI>
159provide command</LI>
160
161<UL><TT>c:\tcl\bin\wish82.exe c:\gsas\expgui\expgui</TT></UL>
162</UL>
163
164<UL>(modify previous paths, if you have located the files in different places)</UL>
165
166<UL>
167<LI>
168click on NEXT with the <I><U>left</U></I> mouse button.</LI>
169
170<LI>
171Enter name EXPGUI</LI>
172
173<LI>
174click on FINISH with the <I><U>left</U></I> mouse button.</LI>
175</UL>
176
177<UL>You may want to modify the shortcut by modifying the properties to
178change the icon or the default properties.</UL>
179<B>4. Delete the downloaded .exe files to save space (optional)</B>
180
181<DL>
182<DD>          gsaskit.exe
183<DD>          tcltk82blt24qwinexec0601.exe
184<DD>          expgui.exe
185<DD>          (expgui_alpha.exe)
186<DD>          (expgui_alpha.zip)
187</DL> 
188
189<P>More information about EXPGUI, including information on how it
190can be customized, can be found on web pages <A HREF="expgui.html">expgui.html</A>
191and <A HREF="expgui_cfg.html">expgui_cfg.html</A>,
192found in the \gsas\expgui\doc directory.
193<BR> 
194<H2>
195<a name="Winexec"></a>Questions</H2>
1961. Can I use a different version of Tcl/Tk than the one here?
197<UL>Yes -- but: you will need both Tcl/Tk and the Winexec package (see
198http://www.du.edu/~mschwart/tcl-tk.htm) for the GUI to work
199with Windows-95, -98 and -me. Further,
200several utility routines (liveplot and widplt)
201require the BLT package to be properly configured as a loadable
202package to run. If you care what vintage of Tcl/Tk you are using, you are
203obviously a "power user" so take a look at the pkgIndex.tcl files and fix
204your version, if you get an error about loading Blt_ZoomStack.
205Please note that EXPGUI seems to run very
206slowly in Tcl/Tk version 8.1, but OK in 8.0 and 8.2.
207<BR> </UL>
2082. Do I need to modify the PATH, etc in my AUTOEXEC.BAT file or in my Start/Settings/... menus?
209<UL>Only if you will use the PC-GSAS program as well as EXPGUI.
210If so, do follow the steps in the
211<A HREF="ftp://ftp.lanl.gov/public/gsas/windows/readme.txt">GSAS readme file</A>)
212<P>
213Note, to add more environment space in Win95/98, add the following line to the
214CONFIG.SYS file in the root directory
215<PRE>
216        SHELL=C:\WINDOWS\COMMAND.COM /P /E:4096
217</PRE>
218add the following line to the SYSTEM.INI file (in c:\windows) under
219the heading [NonWindowsApp]
220<PRE>
221
222        CommandEnvSize=2424
223</PRE>
224(thanks to Louis Farrugia [louis@chem.gla.ac.uk] for this).
225
226</UL>
2273. What versions of Windows can I use?
228<UL>This package has gotten some testing under Win-95/98 and Win-NT 4.0 & 2000.
229</UL>
2304. EXPGUI seems pretty slow, or is it my imagination?
231<UL>
232Well, actually the problem is Windows. EXPGUI is pretty zippy in LINUX,
233but some operations
234(reading a histogram in liveplot for example) can take 3-5 times
235longer in Windows than in UNIX on the exact same hardware.
236By all means, take this up with the folks in Redmond, WA.
237
238</UL>
2395. When I run one of the GSAS graphics programs (POWPLOT, RAWPLOT,...) the
240program starts, and I can answer questions, but when it comes to the part
241of the program that should display a plot, I get no plot (and possibly
242the DOS window disappears without a trace.)
243<UL>
244There are two problems I know of that can cause graphics errors:
245One is that the graphics package (PGPLOT) cannot find the PGPLOT_FONT
246environment variable (that points to file GRFONT.DAT). EXPGUI does this
247for you and warns if it can't find this file, so the likely reason is
248that you are out of environment space (see 2, above).
249<P>
250The other appears to be a graphics mode problem. Not all modes work
251on all machines. Try mode A. If you still have problems, see if it is an
252EXPGUI problem: Try using a plotting program
253(RAWPLOT is a good choice) from PC-GSAS or GSAS.BAT.  If the plotting
254program does not work there either, first check PGPLOT_FONT is defined
255(by opening a DOS box and type SET, also see question 2, above.)
256If the plotting program runs in PC-GSAS or GSAS.BAT but not EXPGUI, you have a
257real EXPGUI bug and should bug me.
258
259<a name="NetPath"></a></UL>
2604. Can GSAS and EXPGUI be located on a shared network drive?
261<UL>
262Yes, but. The path must be mapped to a "logical drive."
263(e.g. F:) since GSAS is basically a set of DOS programs.
264Likewise, you will have troubles accessing
265experiment and data files on a networked drive unless
266that path is also mapped to a "logical drive."
267EXPGUI will warn you, if you do either.
268</UL>
269
270<H2>
271Acknowledgements</H2>
272The 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
273Khan</A> and the Winexec package, which is needed to allow Tcl/Tk to run
274the 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
275I. Schwartz</A>.
276
277<P>
278<A Href="http://www.ncnr.nist.gov/programs/crystallography/software/gsas.html">
279GSAS</A>
280is written by Allen C. Larson and Robert B. Von Dreele,  MS-H805,
281Los Alamos National Laboratory, Los Alamos, NM 87545. Problems, questions
282or kudos concerning GSAS should be sent to Robert B. Von Dreele at
283<A HREF="MAILTO:vondreele@lanl.gov">vondreele@lanl.gov</A>
284<P>GSAS is Copyright, 1984-1997, The Regents of the University of California.
285The GSAS software was produced under a U.S. Government contract (W-7405-ENG-36)
286by the Los Alamos National Laboratory, which is operated by the University
287of California for the U.S. Department of Energy. The U.S. Government is
288licensed to use, reproduce, and distribute this software. Permission is
289granted to the public to copy and use this software without charge, provided
290that this notice and any statement of authorship are reproduced on all
291copies. Neither the Government nor the University makes any warranty, express
292or implied, or assumes any liability or responsibility for the use of this
293software.
294<P>EXPGUI is written by Brian H. Toby of the NIST Center for Neutron Research,
295<A HREF="MAILTO:Brian.Toby@NIST.GOV">Brian.Toby@NIST.GOV</A> 
296with help from Jonathan Wasserman.
297
298<P>EXPGUI is not subject to copyright. Have fun with it.
299
300<p>Neither the U.S. Government nor any author makes any warranty,
301expressed or implied, or assumes any liability or responsibility
302for the use of this information or the software described
303here. Brand names cited here are used for
304identification purposes and do not consitute an endorsement by NIST.
305
306<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>)
307<br>
308$Revision: 442 $ $Date: 2009-12-04 23:06:14 +0000 (Fri, 04 Dec 2009) $
309</body>
310</html>
Note: See TracBrowser for help on using the repository browser.