source: trunk/doc/expgui_Win_readme.html @ 140

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

# on 2000/05/17 20:09:20, toby did:
cleanup & update

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