source: trunk/doc/expgui_Win_readme.html @ 606

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

# on 2002/04/12 19:49:04, toby did:
remove identification stuff

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