source: trunk/doc/expgui_Win_readme.html @ 84

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

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