source: trunk/doc/expgui_Win_readme.html @ 612

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

# on 2002/07/18 20:02:14, toby did:
make gsas+expgui.exe more obvious

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