source: trunk/doc/expgui_Win_readme.html @ 538

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

# on 2001/12/19 18:55:42, toby did:
reformat to match NCNR style

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