source: trunk/doc/win_old_notes.html @ 931

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

include rest of files

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