source: trunk/doc/expgui_Win_readme.html @ 314

Last change on this file since 314 was 243, checked in by toby, 16 years ago

# on 2000/07/28 20:15:14, toby did:
add CCP14 mirrors for gsas dist.
  • Property rcs:author set to toby
  • Property rcs:date set to 2000/07/28 20:15:14
  • Property rcs:lines set to +36 -9
  • Property rcs:rev set to 1.13
  • Property rcs:state set to Exp
  • Property svn:keywords set to Author Date Revision Id
File size: 12.7 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
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 am testing a 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 an 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)
86
87<P><LI>The
88<A HREF="expgui.html">
89EXPGUI
90</A>
91code<BR>
92<A HREF="ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/expgui.exe">ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/expgui.exe</A>
93(~340 K bytes)
94<BR>for the absolute latest release (which may not have gotten
95a lot of testing, but probably has new capabilities and bug fixes) use<BR>
96<A HREF="ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/expgui_alpha.zip">
97ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/expgui_alpha.zip</A><BR>
98You will need an unzip program, such as WinZip or pkZip, to use this file.
99<P><LI>
100If you are using an older version of GSAS (before April, 2000) you may
101want to download the TCLDUMP program to speed and enhance liveplot and the
102EXPTOOL program which allows EXPGUI to add phases, histograms and atoms
103to .EXP files. More recent versions of GSAS include these programs in the
104distributions.<BR>
105<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)
106<BR>
107or <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)
108<P>
109<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)
110<BR>
111or <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)
112</UL>
113You can put these .EXE (and .ZIP) files anywhere on your computer, but make a note of the
114locations for steps 2, 3 and 5, below.
115
116<P><B>2. Run the programs</B>
117<UL>Use a DOS window to run, gsaskit.exe,
118tcltk80p2+.exe, and expgui.exe (the order should not matter):
119<PRE>
120        mkdir c:\gsas
121        chdir c:\gsas
122        c:\temp\gsaskit.exe -d
123        c:\temp\tcltk80p2+.exe
124        c:\temp\expgui.exe
125</PRE>
126
127Note that gsaskit.exe must be run in the location where you want the
128files to be placed and that you must use the -d option. For this
129reason you must know what you are doing to do this from the Windows interface.
130(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
131expgui.exe files can be run from Windows.
132<P>
133The previous steps will cause the files to be unpacked. The default
134locations for installation are:
135<PRE>
136           gsaskit.exe         c:\gsas
137           tcltk80p2+.exe      c:\expgui
138           expgui.exe          c:\gsas\expgui
139</PRE>
140
141<P>These files can be located on other disks and in directories with
142other names, but the expgui files in expgui.exe
143<I><U>must</U></I> be located in a subdirectory of the GSAS files.
144If these files will be located on a fileserver, the file server
145must be mapped to appear as a disk drive (must be assigned a name
146such as F:).
147</UL>
148<P><B>3. When needed, install TCLDUMP and EXPTOOL</B>
149<UL>
150If TCLDUMP and EXPTOOL <I>are not already present</I>,
151place the <tt>tcldump.exe</tt> and
152<tt>exptool.exe</tt> files in the <tt>exe</tt> directory of GSAS,
153(usually <tt>c:\gsas\exe\</tt>).
154(If you downloaded <tt>tcldump.zip</tt> & <tt>exptool.zip</tt>, expand
155them first.)
156</UL>
157<P><B>4. Create a shortcut:</B>
158<UL>
159<LI>
160On a blank part of the Windows desktop, click the <I><U>right</U></I> mouse
161button and then select NEW and then shortcut and click with the <I><U>left</U></I>
162mouse button.</LI>
163
164<LI>
165provide command</LI>
166
167<UL><TT>c:\tcl\bin\wish80.exe c:\gsas\expgui\expgui</TT></UL>
168</UL>
169
170<UL>(modify previous paths, if you have located the files in different places)</UL>
171
172<UL>
173<LI>
174click on NEXT with the <I><U>left</U></I> mouse button.</LI>
175
176<LI>
177Enter name EXPGUI</LI>
178
179<LI>
180click on FINISH with the <I><U>left</U></I> mouse button.</LI>
181</UL>
182
183<UL>You may want to modify the shortcut by modifying the properties to
184change the icon or the default properties.</UL>
185<B>5. Delete the downloaded .exe (and .zip) files to save space (optional)</B>
186
187<DL>
188<DD>          gsaskit.exe
189<DD>          tcltk80p2+.exe
190<DD>          expgui.exe
191<DD>          (tcldump.zip)
192<DD>          (exptool.zip)
193<DD>          (expgui_alpha.zip)
194</DL> 
195
196<P>More information about EXPGUI, including information on how it
197can be customized, can be found on web pages <A HREF="expgui.html">expgui.html</A>
198and <A HREF="expgui_cfg.html">expgui_cfg.html</A>,
199found in the \gsas\expgui\doc directory.
200<BR> 
201<H2>
202Questions</H2>
2031. Can I use a different version of Tcl/Tk than the one here?
204<UL>Yes -- but: you will need both Tcl/Tk and the Winexec package (see
205http://www.du.edu/~mschwart/tcl-tk.htm) for the GUI to work. Further,
206several utility routines (liveplot and widplt)
207require the BLT package to be properly configured as a loadable
208package to run. If you care what vintage of Tcl/Tk you are using, you are
209obviously a "power user" so take a look at the pkgIndex.tcl files and fix
210your version appropriately. Please note that EXPGUI seems to run very
211slowly in Tcl/Tk version 8.1, but OK in 8.0 and 8.2.
212<BR> </UL>
2132. Do I need to modify the PATH, etc in my AUTOEXEC.BAT file?
214<UL>Only if you will use the PC-GSAS or GSAS.BAT menu programs as well.
215If so, do the following (from the
216<A HREF="ftp://ftp.lanl.gov/public/gsas/ms-dos/readme.txt">GSAS readme file</A>):
217<BR> 
218<UL><TT>5. Modify the PATH statement in your autoexec.bat file to add C:\GSAS\EXE
219to the path (or whatever disk letter you choose for \GSAS)</TT>
220
221<P><TT>6. Add the statement "SET GSAS=C:\GSAS" (again pick the appropriate
222drive letter) to your auto exec.bat file.</TT>
223
224<P><TT>7. Add the statement "SET PGPLOT_FONT=C:\GSAS\FONTS\GRFONT.DAT"</TT>
225
226<P><TT>8. Make sure you have sufficient environment space for these additions
227and two more that are done by gsas.bat each time you run gsas.</TT></UL>
228<P>
229Note, to add more environment space in Win95/98, add the following line to the
230CONFIG.SYS file in the root directory
231<PRE>
232        SHELL=C:\WINDOWS\COMMAND.COM /P /E:4096
233</PRE>
234add the following line to the SYSTEM.INI file (in c:\windows) under
235the heading [NonWindowsApp]
236<PRE>
237
238        CommandEnvSize=2424
239</PRE>
240(thanks to Louis Farrugia [louis@chem.gla.ac.uk] for this).
241
242</UL>
2433. What versions of Windows can I use?
244<UL>This package has gotten some testing under Win95 and WinNT v4.0.
245My limited experience with Win98 seems to show that EXPGUI runs OK.
246It might be possible to get some parts of the package to run under Win32s on Win3.1, but
247don't ask me for help.
248</UL>
2494. EXPGUI seems pretty slow, or is it my imagination?
250<UL>
251Well, actually the problem is Windows. EXPGUI is pretty zippy in LINUX, but some operations
252(reading a histogram in liveplot for example) can take 3-5 times longer in Windows than in UNIX.
253
254</UL>
2555. When I run one of the GSAS graphics programs (POWPLOT, RAWPLOT,...) the
256program starts, and I can answer questions, but when it comes to the part
257of the program that should display a plot, I get no plot (and possibly
258the DOS window disappears without a trace.)
259<UL>
260There are two problems I know of that can cause graphics errors:
261One is that the graphics package (PGPLOT) cannot find the PGPLOT_FONT
262environment variable (that points to file GRFONT.DAT). EXPGUI does this
263correctly, unless you are out of environment space (and I don't know how to
264fix that in Windows.)
265<P>
266The other appears to be a graphics mode problem. Not all modes work
267on all machines. Try mode A. If you still have problems, see if it is an
268EXPGUI problem: Try using a plotting program
269(RAWPLOT is a good choice) from PC-GSAS or GSAS.BAT.  If the plotting
270program does not work there either, first check PGPLOT_FONT is defined
271(by opening a DOS box and type SET, also see question 2, above.)
272If the plotting program runs in PC-GSAS or GSAS.BAT but not EXPGUI, you have a
273real EXPGUI bug.
274</UL>
275
276<H2>
277Acknowledgements</H2>
278The 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
279Khan</A> and the Winexec package, which is needed to allow Tcl/Tk to run
280the 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
281I. Schwartz</A>.
282
283<P>
284<A Href="http://www.ncnr.nist.gov/programs/crystallography/software/gsas.html">
285GSAS</A>
286is written by Allen C. Larson and Robert B. Von Dreele,  MS-H805,
287Los Alamos National Laboratory, Los Alamos, NM 87545. Problems, questions
288or kudos concerning GSAS should be sent to Robert B. Von Dreele at
289<A HREF="MAILTO:vondreele@lanl.gov">vondreele@lanl.gov</A>
290<P>GSAS is Copyright, 1984-1997, The Regents of the University of California.
291The GSAS software was produced under a U.S. Government contract (W-7405-ENG-36)
292by the Los Alamos National Laboratory, which is operated by the University
293of California for the U.S. Department of Energy. The U.S. Government is
294licensed to use, reproduce, and distribute this software. Permission is
295granted to the public to copy and use this software without charge, provided
296that this notice and any statement of authorship are reproduced on all
297copies. Neither the Government nor the University makes any warranty, express
298or implied, or assumes any liability or responsibility for the use of this
299software.
300<P>EXPGUI is written by Brian H. Toby of the NIST Center for Neutron Research,
301<A HREF="MAILTO:Brian.Toby@NIST.GOV">Brian.Toby@NIST.GOV</A> 
302with help from Jonathan Wasserman.
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
312<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>)
313<br>
314$Revision: 243 $ $Date: 2009-12-04 23:02:47 +0000 (Fri, 04 Dec 2009) $
315</body>
316</html>
Note: See TracBrowser for help on using the repository browser.