source: trunk/doc/RCS/win_old_notes.html,v @ 932

Last change on this file since 932 was 932, checked in by toby, 16 years ago

address missing files
File size: 14.1 KB
Line 
1head    1.1;
2access;
3symbols;
4locks
5        toby:1.1; strict;
6comment @# @;
7
8
91.1
10date    2004.09.24.18.15.52;    author toby;    state Exp;
11branches;
12next    ;
13
14
15desc
16@how to install without the installer
17@
18
19
201.1
21log
22@Initial revision
23@
24text
25@<HTML>
26<HEAD>
27   <TITLE>Windows Installation Notes for EXPGUI</TITLE>
28   <meta name="keywords" content="crystallography, Rietveld, diffraction,
29   GSAS, EXPGUI, Windows">
30</HEAD>
31<style>
32A:link {text-decoration:none}
33A:vlink {text-decoration:none}
34</style>
35
36<BODY BGCOLOR="#FFFFFF"
37      topmargin="0" leftmargin="0" marginwidth="0" marginheight="0"
38      text="#000000" link="#0033ff" vlink="#0033ff" alink="#0033ff">
39
40<?
41   include("/var/www/include/navigation.inc");
42   include("/var/www/include/utility.inc");
43?>
44<blockquote><font face="arial, helvetica, sans-serif">
45
46<TABLE BORDER BGCOLOR="#FFFF40" ALIGN=RIGHT>
47<TR><TH><A Href="expgui.html">EXPGUI home</A> 
48</TH></TR></TABLE><BR CLEAR=ALL>
49
50<CENTER><H1>
51<HR noshade width="75%" size="2" align="center">
52Windows installation notes for
53<A HREF="expgui.html">EXPGUI</A>
54<HR noshade width="75%" size="2" align="center">
55</H1></CENTER>
56
57<EM>These notes describe how GSAS & EXPGUI are installed
58using separate distribution files for GSAS, EXPGUI and Tcl/Tk.
59This is not the easiest way to go. Unless you really want to
60know the OS-specific details about EXPGUI
61on windows, please see the
62<A HREF="expgui_Win_readme.html">
63"Installating and Updating EXPGUI (& GSAS) on Windows"</A> web page,
64as that discusses a much simpler approach.
65<P>
66These notes are not completely up to date.
67Nonetheless, please report problems, including improvements on
68these instructions to
69<A HREF="mailto:brian.toby@@nist.gov">Brian Toby</A>.
70Otherwise, Windows-specific issues are unlikely to be addressed or repaired.
71</EM>
72
73<H2>The old, multistep, process for loading GSAS and EXPGUI</H2>
74If for some reason you want to install GSAS and EXPGUI from the
75component distributions (which are sometimes more recent than the
76single-step file, described above), you can follow the steps listed
77below.
78<P><B>1. Download the following files:</B>
79<UL>
80<I>(Shift-click on the links below to download the files)</I>
81<P>
82<LI>Get
83<A Href="http://www.ncnr.nist.gov/programs/crystallography/software/gsas.html">
84GSAS</A> from one of the following sites:
85<DL><P>
86<DT>UK<DD>
87
88<A HREF="http://www.nist.gov/cgi-bin/exit_nist.cgi?
89url=http://www.ccp14.ac.uk/ccp/ccp14/ftp-mirror/gsas/public/gsas/windows/gsaskit.exe">
90http://www.ccp14.ac.uk/ccp/ccp14/ftp-mirror/gsas/public/gsas/windows/gsaskit.exe</A>
91or<BR>
92<A HREF="http://www.nist.gov/cgi-bin/exit_nist.cgi?url=
93ftp://ftp.ccp14.ac.uk/ccp14/ftp-mirror/gsas/public/gsas/windows/gsaskit.exe">ftp://ftp.ccp14.ac.uk/ccp14/ftp-mirror/gsas/public/gsas/windows/gsaskit.exe</A>
94
95<DT>USA<DD>
96<A HREF="http://www.nist.gov/cgi-bin/exit_nist.cgi?url=http://www.semo.edu/ccp/ccp14/ftp-mirror/gsas/public/gsas/windows/gsaskit.exe">http://www.semo.edu/ccp/ccp14/ftp-mirror/gsas/public/gsas/windows/gsaskit.exe</A>
97
98<DT>Canada<DD>
99<A HREF="http://www.nist.gov/cgi-bin/exit_nist.cgi?url=http://ccp14.sims.nrc.ca/ccp/ccp14/ftp-mirror/gsas/public/gsas/windows/gsaskit.exe">http://ccp14.sims.nrc.ca/ccp/ccp14/ftp-mirror/gsas/public/gsas/windows/gsaskit.exe</A>
100
101<DT>Australia<DD>
102<A HREF="http://www.nist.gov/cgi-bin/exit_nist.cgi?url=http://ccp14.minerals.csiro.au/ccp/ccp14/ftp-mirror/gsas/public/gsas/windows/gsaskit.exe">http://ccp14.minerals.csiro.au/ccp/ccp14/ftp-mirror/gsas/public/gsas/windows/gsaskit.exe</A>
103</DL>
104
105<P>be sure to read
106<A HREF="http://www.nist.gov/cgi-bin/exit_nist.cgi?url=http://www.ccp14.ac.uk/ccp/ccp14/ftp-mirror/gsas/public/gsas/windows/readme.txt">http://www.ccp14.ac.uk/ccp/ccp14/ftp-mirror/gsas/public/gsas/windows/readme.txt</A>
107<P>
108<P><LI>Get a
109<A Href="http://www.ncnr.nist.gov/programs/crystallography/software/tclpkgs.html">
110Tcl/Tk</A> distribution<BR>
111I have been using a quite old version (Tcl/Tk v8.2)
112as EXPGUI needed the Winexec package
113<a href="#Winexec">see note 1 below</a>) on Win-95/-98/-ME until version
1141.73 of EXPGUI.
115<BR>
116<A HREF="ftp://ftp.ncnr.nist.gov/pub/cryst/tcltk/tcltk82blt24qwinexec0601.exe">
117ftp://ftp.ncnr.nist.gov/pub/cryst/tcltk/tcltk82blt24qwinexec0601.exe</A>
118(2686464 bytes) until very recently. This verion has some problems with Windows
119XP. The single-file self installer now contains a newer release of Tcl/Tk as a
120starkit that contains the
121<A HREF="http://sourceforge.net/projects/tomasoft">Winutils</A>
122package which can subsitute
123for Winexec. This version can be downloaded as
124<A HREF="ftp://ftp.ncnr.nist.gov/pub/cryst/tcltk/tcl84winstarkit.zip">
125ftp://ftp.ncnr.nist.gov/pub/cryst/tcltk/tcl84winstarkit.zip</A>.
126<P>
127<LI>The
128<A HREF="expgui.html">EXPGUI</A> code<BR>
129The absolute latest release (which may not have gotten
130a lot of testing, but probably has new capabilities and bug fixes)
131is distributed as
132<A HREF="ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/expgui_alpha.zip">
133ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/expgui_alpha.zip</A><BR>
134You will need an unzip program, such as WinZip or pkZip, to use this file.
135<P>
136You can put these .EXE (and .ZIP) files anywhere on your computer, but make a note of the
137locations for steps 2, 3 and 5, below.
138</UL>
139<P><B>2. Unpack the distributions</B>
140<UL>Use a DOS window to run gsaskit.exe
141and an unzip program (for example Winzip) to unpack Tcl/Tk and EXPGUI.
142For newer versions of Windows, the .zip files can be viewed as
143folders.
144<FONT FACE="COURIER"><PRE>
145        mkdir c:\gsas
146        chdir c:\gsas
147        c:\temp\gsaskit.exe -d
148</PRE></FONT>
149
150<P>
151The previous steps cause the files to be unpacked. The suggested
152locations for installation are:
153<FONT FACE="COURIER"><PRE>
154           gsaskit.exe                     c:\gsas
155           EXPGUI                          c:\gsas\expgui
156           Tcl/Tk    c:\tcl
157</PRE></FONT>
158
159<P>These files can be located on other disks and in directories with
160other names, but the EXPGUI files
161<I><U>must</U></I> be located in a subdirectory of the GSAS files and
162each directory name should not have a space in the name
163so location
164<font face="courier">Z:\i\think\this\will\work\gsas</font> should be OK,
165as should
166<font face="courier">C:\longwindows\namesarenotgood\fordos</font> 
167but you may have trouble with<BR>
168<font face="courier">C:\Program Files\names with spaces\make problems</font> 
169probably will break drag-and-drop -- at least for EXPGUI -- on older
170versions of Windows.
171If these files will be located on a fileserver, the file server
172must be mapped as a disk drive (must be assigned a name
173such as F:). But note, installing GSAS on a file server does not
174fully install
175GSAS on each PC that accesses the file server, since short-cuts and
176environment changes are needed.
177</UL>
178<P><B>3. Create a shortcut:</B>
179<UL>
180<LI>
181On a blank part of the Windows desktop, click the <I><U>right</U></I> mouse
182button and then select NEW and then shortcut and click with the <I><U>left</U></I>
183mouse button.</LI>
184
185<LI>
186provide command</LI>
187
188<UL><FONT FACE="COURIER">c:\tcl\bin\wish82.exe c:\gsas\expgui\expgui</FONT></UL>
189</UL>
190
191<UL>(modify previous paths, if you have located the files in different places)</UL>
192
193<UL>
194<LI>
195click on NEXT with the <I><U>left</U></I> mouse button.</LI>
196
197<LI>
198Enter name EXPGUI</LI>
199
200<LI>
201click on FINISH with the <I><U>left</U></I> mouse button.</LI>
202</UL>
203
204<UL>You may want to modify the shortcut by modifying the properties to
205change the icon or the default properties.</UL>
206<B>4. Delete the downloaded files to save space (optional)</B>
207
208<P>More information about EXPGUI, including information on how it
209can be customized, can be found on web pages <A HREF="expgui.html">expgui.html</A>
210and <A HREF="expgui_cfg.html">expgui_cfg.html</A>,
211found in the \gsas\expgui\doc directory.
212<BR> 
213<H2>
214<a name="Winexec"></a>Questions</H2>
2151. Can I use a different version of Tcl/Tk than the one here?
216<UL>Yes -- but: you will need both Tcl/Tk and the Winexec package (see
217http://www.du.edu/~mschwart/tcl-tk.htm)
218or the package
219<A HREF="http://sourceforge.net/projects/tomasoft">Winutils</A>
220(<A HREF="http://cvs.sourceforge.net/viewcvs.py/*checkout*/tomasoft/winutils/winutils.html?rev=1.15">documentation</A>)
221for 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="http://www.nist.gov/cgi-bin/exit_nist.cgi?url=http://www.ccp14.ac.uk/ccp/ccp14/ftp-mirror/gsas/public/gsas/windows/readme.txt">
235GSAS readme file</A>)
236<P>
237Note, to add more environment space in Win95/98, add the following line to the
238CONFIG.SYS file in the root directory
239<FONT FACE="COURIER"><PRE>
240        SHELL=C:\WINDOWS\COMMAND.COM /P /E:4096
241</PRE></FONT>
242add the following line to the SYSTEM.INI file (in c:\windows) under
243the heading [NonWindowsApp]
244<FONT FACE="COURIER"><PRE>
245
246        CommandEnvSize=2424
247</PRE></FONT>
248(thanks to Louis Farrugia [louis@@chem.gla.ac.uk] for this).
249
250</UL>
2513. What versions of Windows can I use?
252<UL>As far as I am aware, EXPGUI will run under all releases of Windows from
253-95 through -XP, but it is not tested here on most of those platforms.
254I depend on feedback from users to tell me of OS conflicts, but none have
255been reported.
256</UL>
2574. EXPGUI seems pretty slow, or is it my imagination?
258<UL>
259Well, actually the problem is Windows. EXPGUI is pretty zippy in LINUX,
260but some operations
261(reading a histogram in liveplot for example) can take 3-5 times
262longer in Windows than in UNIX on the exact same hardware.
263By all means, take this up with the folks in Redmond, WA.
264
265</UL>
2665. When I run one of the GSAS graphics programs (POWPLOT, RAWPLOT,...) the
267program starts, and I can answer questions, but when it comes to the part
268of the program that should display a plot, I get no plot (and possibly
269the DOS window disappears without a trace.)
270<UL>
271There are two problems I know of that can cause graphics errors:
272One is that the graphics package (PGPLOT) cannot find the PGPLOT_FONT
273environment variable (that points to file GRFONT.DAT). EXPGUI does this
274for you and warns if it can't find this file, so the likely reason is
275that you are out of environment space (see 2, above).
276<P>
277The other appears to be a graphics mode problem. Not all modes work
278on all machines. Try mode A. If you still have problems, see if it is an
279EXPGUI problem: Try using a plotting program
280(RAWPLOT is a good choice) from PC-GSAS or GSAS.BAT.  If the plotting
281program does not work there either, first check PGPLOT_FONT is defined
282(by opening a DOS box and type SET, also see question 2, above.)
283If the plotting program runs in PC-GSAS or GSAS.BAT but not EXPGUI, you have a
284real EXPGUI bug and should bug me.
285
286</UL>
287<a name="NetPath"></a>
2886. Can GSAS and EXPGUI be located on a shared network drive?
289<UL>
290Yes. With earlier versions of GSAS path had to be mapped to a
291"logical drive." (e.g. F:). In the current versions of GSAS, this does not
292seem to be needed, but
293EXPGUI will warn you, if you try to do this, since I am not certain
294that this works.
295<P>
296I do not know if GSAS will work properly with
297experiment and data files on a networked drive without mapping the
298path to a "logical drive."
299There are some definite problems in GSAS where directory and file
300names contain
301spaces. EXPGUI should help avoid some of these problems, so if you find
302anything file names that break EXPGUI & GSAS, let me know how to
303duplicate exactly what you are doing.
304</UL>
305
306</UL>
307
308<H2>
309Acknowledgements</H2>
310Thanks 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
311Khan</A> for help with Tcl/Tk on Windows
312and to <A HREF="http://www.nist.gov/cgi-bin/exit_nist.cgi?url=http://www.du.edu/~mschwart/tcl-tk.htm">Michael
313I. Schwartz</A> for the Winexec package, which is needed to allow Tcl/Tk to run
314the GSAS DOS .exe files.
315<P>
316<A Href="http://www.ncnr.nist.gov/programs/crystallography/software/gsas.html">
317GSAS</A>
318is written by Allen C. Larson and Robert B. Von Dreele,  MS-H805,
319Los Alamos National Laboratory, Los Alamos, NM 87545. Problems, questions
320or kudos concerning GSAS should be sent to Robert B. Von Dreele at
321<A HREF="MAILTO:vondreele@@anl.gov">vondreele@@anl.gov</A>
322<P>EXPGUI is written by Brian H. Toby of the NIST Center for Neutron Research,
323<A HREF="MAILTO:Brian.Toby@@NIST.GOV">Brian.Toby@@NIST.GOV</A> 
324with help from Jonathan Wasserman.
325
326<P>
327<hr><blockquote>
328GSAS is Copyright, 1984-1997, The Regents of the University of California.
329The GSAS software was produced under a U.S. Government contract (W-7405-ENG-36)
330by the Los Alamos National Laboratory, which is operated by the University
331of California for the U.S. Department of Energy. The U.S. Government is
332licensed to use, reproduce, and distribute this software. Permission is
333granted to the public to copy and use this software without charge, provided
334that this notice and any statement of authorship are reproduced on all
335copies. Neither the Government nor the University makes any warranty, express
336or implied, or assumes any liability or responsibility for the use of this
337software.
338
339<P>EXPGUI is not subject to copyright. Have fun with it.
340
341<p>Neither the U.S. Government nor any author makes any warranty,
342expressed or implied, or assumes any liability or responsibility
343for the use of this information or the software described
344here. Brand names cited here are used for
345identification purposes and do not consitute an endorsement by NIST.
346</blockquote>
347<hr>
348<TABLE BORDER BGCOLOR="#FFFF40" ALIGN=RIGHT>
349<TR><TH><A Href="expgui.html">EXPGUI home</A> 
350</TH></TR></TABLE>
351
352<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>
353<font size=-1><? lastmod(); ?> </font>
354<br>
355$Revision: 1.24 $ $Date: 2003/11/13 17:34:33 $
356</blockquote>
357</body>
358</html>
359@
Note: See TracBrowser for help on using the repository browser.