source: trunk/doc/win_old_notes.html @ 930

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

rcs:* properties removed

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