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