source: trunk/doc/expgui_Win_readme.html @ 203

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

# on 2000/06/09 03:54:23, toby did:
Update to reflect new GSAS kit, TclTk8.2 & FAQ stuff

  • Property rcs:author set to toby
  • Property rcs:date set to 2000/06/09 03:54:23
  • Property rcs:lines set to +48 -12
  • Property rcs:rev set to 1.11
  • Property rcs:state set to Exp
  • Property svn:keywords set to Author Date Revision Id
File size: 11.4 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<hr>
21
22<CENTER><H1>
23Windows-95
24and -NT Installation notes for <A HREF="expgui.html">
25EXPGUI
26</A>
27</H1></CENTER>
28<EM>Please note that <A HREF="expgui.html">EXPGUI</A>
29 is always under development and gets
30less testing by the author
31in Windows than in UNIX. Please report problems, including comments on
32these instructions to
33<A HREF="mailto:brian.toby@nist.gov">Brian Toby</A>
34</EM>
35<P><B>1. Download the following files:</B>
36<UL>
37<I>(Shift-click on the links below to download the files)</I>
38<P>
39<LI>Get
40<A Href="http://www.ncnr.nist.gov/programs/crystallography/software/gsas.html">
41GSAS</A> from
42<A HREF="ftp://ftp.lanl.gov/public/gsas/ms-dos/gsaskit.exe">ftp://ftp.lanl.gov/public/gsas/ms-dos/gsaskit.exe</A>
43(~6 Mbytes)<BR>
44and read<BR>
45<A HREF="ftp://ftp.lanl.gov/public/gsas/ms-dos/readme.txt">ftp://ftp.lanl.gov/public/gsas/ms-dos/readme.txt</A>
46<P>
47Note that these files are from a Los Alamos web server, not NIST.
48
49<P><LI>Get a
50<A Href="http://www.ncnr.nist.gov/programs/crystallography/software/tclpkgs.html">
51Tcl/Tk</A> distribution<BR>
52I am testing a new version (Tcl/Tk v8.2):<BR>
53<A HREF="ftp://ftp.ncnr.nist.gov/pub/cryst/tcltk/tcltk82blt24qwinexec0601.exe">
54ftp://ftp.ncnr.nist.gov/pub/cryst/tcltk/tcltk82blt24qwinexec0601.exe</A>
55(2686464 bytes)
56<BR>or an older version (Tcl/Tk v8.0):<BR>
57<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>
58(3604992 bytes)
59
60<P><LI>The
61<A HREF="expgui.html">
62EXPGUI
63</A>
64code<BR>
65<A HREF="ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/expgui.exe">ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/expgui.exe</A>
66(~340 K bytes)
67<BR>for the absolute latest release (which may not have gotten
68a lot of testing, but probably has new capabilities and bug fixes) use<BR>
69<A HREF="ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/expgui_alpha.zip">
70ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/expgui_alpha.zip</A><BR>
71You will need an unzip program, such as WinZip or pkZip, to use this file.
72<P><LI>
73If you are using an older version of GSAS (before April, 2000) you may
74want to download the TCLDUMP program to speed and enhance liveplot and the
75EXPTOOL program which allows EXPGUI to add phases, histograms and atoms
76to .EXP files. More recent versions of GSAS include these programs in the
77distributions.<BR>
78<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)
79<BR>
80or <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)
81<P>
82<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)
83<BR>
84or <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)
85</UL>
86You can put these .EXE (and .ZIP) files anywhere on your computer, but make a note of the
87locations for steps 2, 3 and 5, below.
88
89<P><B>2. Run the programs</B>
90<UL>Use a DOS window to run, gsaskit.exe,
91tcltk80p2+.exe, and expgui.exe (the order should not matter):
92<PRE>
93        mkdir c:\gsas
94        chdir c:\gsas
95        c:\temp\gsaskit.exe -d
96        c:\temp\tcltk80p2+.exe
97        c:\temp\expgui.exe
98</PRE>
99
100Note that gsaskit.exe must be run in the location where you want the
101files to be placed and that you must use the -d option. For this
102reason you must know what you are doing to do this from the Windows interface.
103(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
104expgui.exe files can be run from Windows.
105<P>
106The previous steps will cause the files to be unpacked. The default
107locations for installation are:
108<PRE>
109           gsaskit.exe         c:\gsas
110           tcltk80p2+.exe      c:\expgui
111           expgui.exe          c:\gsas\expgui
112</PRE>
113
114<P>These files can be located on other disks and in directories with
115other names, but the expgui files in expgui.exe
116<I><U>must</U></I> be located in a subdirectory of the GSAS files.
117If these files will be located on a fileserver, the file server
118must be mapped to appear as a disk drive (must be assigned a name
119such as F:).
120</UL>
121<P><B>3. When needed, install TCLDUMP and EXPTOOL</B>
122<UL>
123If TCLDUMP and EXPTOOL <I>are not already present</I>,
124place the <tt>tcldump.exe</tt> and
125<tt>exptool.exe</tt> files in the <tt>exe</tt> directory of GSAS,
126(usually <tt>c:\gsas\exe\</tt>).
127(If you downloaded <tt>tcldump.zip</tt> & <tt>exptool.zip</tt>, expand
128them first.)
129</UL>
130<P><B>4. Create a shortcut:</B>
131<UL>
132<LI>
133On a blank part of the Windows desktop, click the <I><U>right</U></I> mouse
134button and then select NEW and then shortcut and click with the <I><U>left</U></I>
135mouse button.</LI>
136
137<LI>
138provide command</LI>
139
140<UL><TT>c:\tcl\bin\wish80.exe c:\gsas\expgui\expgui</TT></UL>
141</UL>
142
143<UL>(modify previous paths, if you have located the files in different places)</UL>
144
145<UL>
146<LI>
147click on NEXT with the <I><U>left</U></I> mouse button.</LI>
148
149<LI>
150Enter name EXPGUI</LI>
151
152<LI>
153click on FINISH with the <I><U>left</U></I> mouse button.</LI>
154</UL>
155
156<UL>You may want to modify the shortcut by modifying the properties to
157change the icon or the default properties.</UL>
158<B>5. Delete the downloaded .exe (and .zip) files to save space (optional)</B>
159
160<DL>
161<DD>          gsaskit.exe
162<DD>          tcltk80p2+.exe
163<DD>          expgui.exe
164<DD>          (tcldump.zip)
165<DD>          (exptool.zip)
166<DD>          (expgui_alpha.zip)
167</DL> 
168
169<P>More information about EXPGUI, including information on how it
170can be customized, can be found on web pages <A HREF="expgui.html">expgui.html</A>
171and <A HREF="expgui_cfg.html">expgui_cfg.html</A>,
172found in the \gsas\expgui\doc directory.
173<BR> 
174<H2>
175Questions</H2>
1761. Can I use a different version of Tcl/Tk than the one here?
177<UL>Yes -- but: you will need both Tcl/Tk and the Winexec package (see
178http://www.du.edu/~mschwart/tcl-tk.htm) for the GUI to work. Further,
179several utility routines (liveplot and widplt)
180require the BLT package to be properly configured as a loadable
181package to run. If you care what vintage of Tcl/Tk you are using, you are
182obviously a "power user" so take a look at the pkgIndex.tcl files and fix
183your version appropriately. Please note that EXPGUI seems to run very
184slowly in Tcl/Tk version 8.1, but OK in 8.0 and 8.2.
185<BR> </UL>
1862. Do I need to modify the PATH, etc in my AUTOEXEC.BAT file?
187<UL>Only if you will use the PC-GSAS or GSAS.BAT menu programs as well.
188If so, do the following (from the
189<A HREF="ftp://ftp.lanl.gov/public/gsas/ms-dos/readme.txt">GSAS readme file</A>):
190<BR> 
191<UL><TT>5. Modify the PATH statement in your autoexec.bat file to add C:\GSAS\EXE
192to the path (or whatever disk letter you choose for \GSAS)</TT>
193
194<P><TT>6. Add the statement "SET GSAS=C:\GSAS" (again pick the appropriate
195drive letter) to your auto exec.bat file.</TT>
196
197<P><TT>7. Add the statement "SET PGPLOT_FONT=C:\GSAS\FONTS\GRFONT.DAT"</TT>
198
199<P><TT>8. Make sure you have sufficient environment space for these additions
200and two more that are done by gsas.bat each time you run gsas.</TT></UL>
201</UL>
2023. What versions of Windows can I use?
203<UL>This package has gotten some testing under Win95 and WinNT v4.0.
204My limited experience with Win98 seems to show that EXPGUI runs OK.
205It might be possible to get some parts of the package to run under Win32s on Win3.1, but
206don't ask me for help.
207</UL>
2084. EXPGUI seems pretty slow, or is it my imagination?
209<UL>
210Well, actually the problem is Windows. EXPGUI is pretty zippy in LINUX, but some operations
211(reading a histogram in liveplot for example) can take 3-5 times longer in Windows than in UNIX.
212
213</UL>
2145. When I run one of the GSAS graphics programs (POWPLOT, RAWPLOT,...) the
215program starts, and I can answer questions, but when it comes to the part
216of the program that should display a plot, I get no plot (and possibly
217the DOS window disappears without a trace.)
218<UL>
219There are two problems I know of that can cause graphics errors:
220One is that the graphics package (PGPLOT) cannot find the PGPLOT_FONT
221environment variable (that points to file GRFONT.DAT). EXPGUI does this
222correctly, unless you are out of environment space (and I don't know how to
223fix that in Windows.)
224<P>
225The other appears to be a graphics mode problem. Not all modes work
226on all machines. Try mode A. If you still have problems, see if it is an
227EXPGUI problem: Try using a plotting program
228(RAWPLOT is a good choice) from PC-GSAS or GSAS.BAT.  If the plotting
229program does not work there either, first check PGPLOT_FONT is defined
230(by opening a DOS box and type SET, also see question 2, above.)
231If the plotting program runs in PC-GSAS or GSAS.BAT but not EXPGUI, you have a
232real EXPGUI bug.
233</UL>
234
235<H2>
236Acknowledgements</H2>
237The 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
238Khan</A> and the Winexec package, which is needed to allow Tcl/Tk to run
239the 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
240I. Schwartz</A>.
241
242<P>
243<A Href="http://www.ncnr.nist.gov/programs/crystallography/software/gsas.html">
244GSAS</A>
245is written by Allen C. Larson and Robert B. Von Dreele,  MS-H805,
246Los Alamos National Laboratory, Los Alamos, NM 87545. Problems, questions
247or kudos concerning GSAS should be sent to Robert B. Von Dreele at
248<A HREF="MAILTO:vondreele@lanl.gov">vondreele@lanl.gov</A>
249<P>GSAS is Copyright, 1984-1997, The Regents of the University of California.
250The GSAS software was produced under a U.S. Government contract (W-7405-ENG-36)
251by the Los Alamos National Laboratory, which is operated by the University
252of California for the U.S. Department of Energy. The U.S. Government is
253licensed to use, reproduce, and distribute this software. Permission is
254granted to the public to copy and use this software without charge, provided
255that this notice and any statement of authorship are reproduced on all
256copies. Neither the Government nor the University makes any warranty, express
257or implied, or assumes any liability or responsibility for the use of this
258software.
259<P>EXPGUI is written by Brian H. Toby of the NIST Center for Neutron Research,
260<A HREF="MAILTO:Brian.Toby@NIST.GOV">Brian.Toby@NIST.GOV</A> 
261with help from Jonathan Wasserman.
262
263<P>EXPGUI is not subject to copyright. Have fun with it.
264
265<p>Neither the U.S. Government nor any author makes any warranty,
266expressed or implied, or assumes any liability or responsibility
267for the use of this information or the software described
268here. Brand names cited here are used for
269identification purposes and do not consitute an endorsement by NIST.
270
271<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>)
272<br>
273$Revision: 203 $ $Date: 2009-12-04 23:02:07 +0000 (Fri, 04 Dec 2009) $
274</body>
275</html>
Note: See TracBrowser for help on using the repository browser.