source: trunk/doc/expgui_Win_readme.html @ 614

Last change on this file since 614 was 614, checked in by toby, 14 years ago

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