source: trunk/doc/expgui_Win_readme.html @ 575

Last change on this file since 575 was 549, checked in by toby, 11 years ago

# on 2002/01/23 19:59:56, toby did:
reference the self-installer
cleanup font references

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