source: trunk/doc/expgui_Win_readme.html @ 147

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

# on 2000/05/18 15:32:42, toby did:
add Tcl/tk logo, general editing
  • Property rcs:author set to toby
  • Property rcs:date set to 2000/05/18 15:32:42
  • Property rcs:lines set to +14 -6
  • Property rcs:rev set to 1.9
  • Property rcs:state set to Exp
  • Property svn:keywords set to Author Date Revision Id
File size: 9.7 KB
Line 
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" 
9alt="Link to NIST Center for Neutron Research home page"
10ALIGN=RIGHT></A>
11<A HREF=http://www.nist.gov>
12<IMG SRC="http://www.ncnr.nist.gov/images/webidblue_2lineright.gif" 
13alt="Link to National Institute of Standards & Technology home page"
14ALIGN=LEFT></A>
15<CENTER>
16<A Href="http://www.ncnr.nist.gov/programs/crystallography/software/tclpkgs.html">
17<IMG SRC="tcltklogo100.gif" 
18alt="Link to Tcl/Tk information">
19</CENTER></A>
20<hr>
21
22<CENTER><H1>
23Windows-95
24and -NT Installation notes for <A HREF="expgui.html">
25EXPGUI
26</A>
27</H1></CENTER>
28<EM>Please note that <A HREF="expgui.html">EXPGUI</A>
29 is always under development and gets
30less testing by the author
31in Windows than in UNIX. Please report problems, including comments on
32these instructions to
33<A HREF="mailto:brian.toby@nist.gov">Brian Toby</A>
34</EM>
35<P><B>1. Download the following files:</B>
36<UL>
37<I>(Shift-click on the links below to download the files)</I>
38<P>
39<LI>Get
40<A Href="http://www.ncnr.nist.gov/programs/crystallography/software/gsas.html">
41GSAS</A> from
42<A HREF="ftp://ftp.lanl.gov/public/gsas/ms-dos/gsaskit.exe">ftp://ftp.lanl.gov/public/gsas/ms-dos/gsaskit.exe</A>
43(~6 Mbytes)<BR>
44Note that this is not a NIST web server.
45
46<P><LI>Get a
47<A Href="http://www.ncnr.nist.gov/programs/crystallography/software/tclpkgs.html">
48Tcl/Tk</A> distribution<BR>
49I am testing a new version:<BR>
50<A HREF="ftp://ftp.ncnr.nist.gov/pub/cryst/tcltk/tcltk82blt24qwinexec0601.exe">
51ftp://ftp.ncnr.nist.gov/pub/cryst/tcltk/tcltk82blt24qwinexec0601.exe</A>
52(2686464 bytes)
53<BR>or an older version:<BR>
54<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>
55(3604992 bytes)
56
57<P><LI>The
58<A HREF="expgui.html">
59EXPGUI
60</A>
61code<BR>
62<A HREF="ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/expgui.exe">ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/expgui.exe</A>
63(~340 K bytes)
64<BR>for the absolute latest release (which may not have gotten
65a lot of testing, but probably has new capabilities and bug fixes) use<BR>
66<A HREF="ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/expgui_alpha.zip">
67ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/expgui_alpha.zip</A><BR>
68You will need an unzip program, such as WinZip or pkZip, to use this file.
69<P><LI>
70If you are using an older version of GSAS (before April, 2000) you may
71want to download the TCLDUMP program to speed and enhance liveplot and the
72EXPTOOL program which allows EXPGUI to add phases, histograms and atoms
73to .EXP files. More recent versions of GSAS include these programs in the
74distributions.<BR>
75<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)
76<BR>
77or <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)
78<P>
79<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)
80<BR>
81or <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)
82</UL>
83You can put these .EXE (and .ZIP) files anywhere on your computer, but make a note of the
84locations for steps 2, 3 and 5, below.
85
86<P><B>2. Run the programs</B>
87<UL>Use the file manager or Run command to succesively run, gsaskit_Jan98.exe,
88tcltk80p2+.exe, and expgui.exe (the order should not matter).
89[N.B. If using expgui_alpha.zip uncompress with a tool such as WinZip
90into c:\gsas\expgui]
91
92This will cause the files to be unpacked. The default
93locations for installation are:
94<PRE>
95           gsaskit_Jan98.exe   c:\gsas
96           tcltk80p2+.exe      c:\expgui
97           expgui.exe          c:\gsas\expgui
98</PRE>
99
100<P>These files can be located on other disks and in directories with
101other names, but the expgui files in expgui.exe
102<I><U>must</U></I> be located in a subdirectory of the GSAS files.
103If these files will be located on a fileserver, the file server
104must be mapped to appear as a disk drive (must be assigned a name
105such as F:).
106</UL>
107<P><B>3. When needed, install TCLDUMP and EXPTOOL</B>
108<UL>
109If TCLDUMP and EXPTOOL are not already present,
110place the <tt>tcldump.exe</tt> and
111<tt>exptool.exe</tt> files in the <tt>exe</tt> directory of GSAS,
112(usually <tt>c:\gsas\exe\</tt>).
113(If you downloaded <tt>tcldump.zip</tt> & <tt>exptool.zip</tt>, expand
114them first.)
115</UL>
116<P><B>4. Create a shortcut:</B>
117<UL>
118<LI>
119On a blank part of the Windows desktop, click the <I><U>right</U></I> mouse
120button and then select NEW and then shortcut and click with the <I><U>left</U></I>
121mouse button.</LI>
122
123<LI>
124provide command</LI>
125
126<UL><TT>c:\tcl\bin\wish80.exe c:\gsas\expgui\expgui</TT></UL>
127</UL>
128
129<UL>(modify previous paths, if you have located the files in different places)</UL>
130
131<UL>
132<LI>
133click on NEXT with the <I><U>left</U></I> mouse button.</LI>
134
135<LI>
136Enter name EXPGUI</LI>
137
138<LI>
139click on FINISH with the <I><U>left</U></I> mouse button.</LI>
140</UL>
141
142<UL>You may want to modify the shortcut by modifying the properties to
143change the icon or the default properties.</UL>
144<B>5. Delete the downloaded .exe (and .zip) files to save space (optional)</B>
145
146<DL>
147<DD>          gsaskit_Jan98.exe
148<DD>          tcltk80p2+.exe
149<DD>          expgui.exe
150<DD>          (tcldump.zip)
151<DD>          (exptool.zip)
152<DD>          (expgui_alpha.zip)
153</DL> 
154
155<P>More information about EXPGUI, including information on how it
156can be customized, can be found on web pages <A HREF="expgui.html">expgui.html</A>
157and <A HREF="expgui_cfg.html">expgui_cfg.html</A>,
158found in the \gsas\expgui\doc directory.
159<BR> 
160<H2>
161Questions</H2>
1621. Can I use a different version of Tcl/Tk than the one here?
163<UL>Yes -- but: you will need both Tcl/Tk and the Winexec package (see
164http://www.du.edu/~mschwart/tcl-tk.htm) for the GUI to work. Further,
165several utility routines (liveplot and widplt)
166require the BLT package to be properly configured as a loadable
167package to run. If you care what vintage of Tcl/Tk you are using, you are
168obviously a "power user" so take a look at the pkgIndex.tcl files and fix
169your version appropriately. Please note that EXPGUI seems to run very
170slowly in Tcl/Tk version 8.1, but OK in 8.0 and 8.2.
171<BR> </UL>
1722. Do I need to modify the PATH, etc in my AUTOEXEC.BAT file?
173<UL>Only if you will use the PC-GSAS or GSAS.BAT menu programs as well.
174If so, do the following (from the GSAS readme file):
175<BR> 
176<UL><TT>5. Modify the PATH statement in your autoexec.bat file to add C:\GSAS\EXE
177to the path (or whatever disk letter you choose for \GSAS)</TT>
178
179<P><TT>6. Add the statement "SET GSAS=C:\GSAS" (again pick the appropriate
180drive letter) to your auto exec.bat file.</TT>
181
182<P><TT>7. Add the statement "SET PGPLOT_FONT=C:\GSAS\FONTS\GRFONT.DAT"</TT>
183
184<P><TT>8. Make sure you have sufficient environment space for these additions
185and two more that are done by gsas.bat each time you run gsas.</TT></UL>
186</UL>
1873. What versions of Windows can I use?
188<UL>This package has gotten some testing under Win95 and WinNT v4.0.
189My limited experience with Win98 seems to show that EXPGUI runs OK.
190It might be possible to get some parts of the package to run under Win32s on Win3.1, but
191don't ask me for help.
192</UL>
1934. EXPGUI seems pretty slow, or is it my imagination?
194<UL>
195Well, actually the problem is Windows. EXPGUI is pretty zippy in LINUX, but some operations
196(reading a histogram in liveplot for example) can take 3-5 times longer in Windows than in UNIX.
197</UL>
198
199<H2>
200Acknowledgements</H2>
201The version of Tcl/Tk here 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
202Khan</A> and the Winexec package, which is needed to allow Tcl/Tk to run
203the 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
204I. Schwartz</A>.
205
206<P>
207<A Href="http://www.ncnr.nist.gov/programs/crystallography/software/gsas.html">
208GSAS</A>
209is written by Allen C. Larson and Robert B. Von Dreele,  MS-H805,
210Los Alamos National Laboratory, Los Alamos, NM 87545. Problems, questions
211or kudos concerning GSAS should be sent to Robert B. Von Dreele at
212<A HREF="MAILTO:vondreele@lanl.gov">vondreele@lanl.gov</A>
213<P>GSAS is Copyright, 1984-1997, The Regents of the University of California.
214The GSAS software was produced under a U.S. Government contract (W-7405-ENG-36)
215by the Los Alamos National Laboratory, which is operated by the University
216of California for the U.S. Department of Energy. The U.S. Government is
217licensed to use, reproduce, and distribute this software. Permission is
218granted to the public to copy and use this software without charge, provided
219that this notice and any statement of authorship are reproduced on all
220copies. Neither the Government nor the University makes any warranty, express
221or implied, or assumes any liability or responsibility for the use of this
222software.
223<P>EXPGUI is written by Brian H. Toby of the NIST Center for Neutron Research,
224<A HREF="MAILTO:Brian.Toby@NIST.GOV">Brian.Toby@NIST.GOV</A> 
225with help from Jonathan Wasserman.
226
227<P>EXPGUI is not subject to copyright. Have fun with it.
228
229<p>Neither the U.S. Government nor any author makes any warranty,
230expressed or implied, or assumes any liability or responsibility
231for the use of this information or the software described
232here. Brand names cited here are used for
233identification purposes and do not consitute an endorsement by NIST.
234
235<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>)
236<br>
237$Revision: 147 $ $Date: 2009-12-04 23:01:11 +0000 (Fri, 04 Dec 2009) $
238</body>
239</html>
Note: See TracBrowser for help on using the repository browser.