source: trunk/doc/expgui_Win_readme.html @ 987

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

Updates to doc's

  • Property svn:keywords set to Author Date Revision Id
  • Property svn:mime-type set to text/html
File size: 12.7 KB
RevLine 
[34]1<HTML>
2<HEAD>
[812]3   <TITLE>Windows Installation Information for EXPGUI</TITLE>
[515]4   <meta name="keywords" content="crystallography, Rietveld, diffraction,
5   GSAS, EXPGUI, Windows">
[34]6</HEAD>
7
[515]8<BODY BGCOLOR="#FFFFFF"
9      topmargin="0" leftmargin="0" marginwidth="0" marginheight="0" 
10      text="#000000" link="#0033ff" vlink="#0033ff" alink="#0033ff">
11
12<blockquote><font face="arial, helvetica, sans-serif">
13
[973]14
[515]15<TABLE BORDER BGCOLOR="#FFFF40" ALIGN=RIGHT>
[812]16<TR>
17<TH>
[973]18<a href="gsas+expgui.html">self-installer notes</a></TH>
[812]19<TH><A  Href="win_old_notes.html">Windows install details</A></TH>
20<TH><A  Href="expgui.html">EXPGUI home</A></TH>
21</TR></TABLE><BR CLEAR=ALL>
[515]22
[812]23
[515]24<CENTER><H1>
[243]25<HR noshade width="75%" size="2" align="center">
[812]26Installating and Updating
27<BR>
[515]28<A HREF="expgui.html">EXPGUI</A>
[812]29(& 
30<a href="http://www.ncnr.nist.gov/xtal/software/gsas.html">GSAS</a>)
31on Windows
[243]32<HR noshade width="75%" size="2" align="center">
[515]33</H1></CENTER>
34
[973]35<TABLE BORDER BGCOLOR="#FFFF40" ALIGN=CENTER><TR><TH>
36<B>Please note:</B>
37A new mechanism for installing GSAS & EXPGUI is now recommended. See
38<A HREF="https://subversion.xor.aps.anl.gov/trac/EXPGUI/wiki/InstallWindows">
39this link</a>. If this method is used, EXPGUI or a batch file can
40be used to update GSAS & EXPGUI quickly and easily.
41The installer described below will be updated for the foreseeable
42   future, but likely with less frequency.
43</TH></TR></TABLE><BR CLEAR=ALL>
44
[147]45<EM>Please note that <A HREF="expgui.html">EXPGUI</A>
46 is always under development and gets
47less testing by the author
[812]48in Windows than in other platforms.
49Please report problems, including improvements on
[80]50these instructions to
[899]51<A HREF="mailto:brian.toby@anl.gov">Brian Toby</A>.
[812]52Otherwise, Windows-specific issues are unlikely to be addressed or repaired.
[80]53</EM>
[243]54
[812]55<H2>Installing GSAS and EXPGUI in Windows</H2>
56Most users who install
57<a href="http://www.ncnr.nist.gov/xtal/software/gsas.html">GSAS (General Structure Analysis System)</a>
58and
[973]59<a href="https://subversion.xor.aps.anl.gov/EXPGUI/trunk/doc/expgui.html">EXPGUI</a>
[812]60will do so by downloading a single file that installs the GSAS programs,
61the Tcl/Tk package (with some extensions), the EXPGUI scripts, as well as
[864]62makes registry entries & defines shortcuts. This will
[812]63be described in brief in the next section of this page.
64It is also possible to download and install GSAS, Tcl/Tk & EXPGUI from
65separate distributions; please see the
66<A Href="win_old_notes.html">Windows install details</A> web page
67for more details.
68<P>More information about EXPGUI, including information on how it
69can be customized, can be found on web pages <A HREF="expgui.html">expgui.html</A>
70and <A HREF="expgui_cfg.html">expgui_cfg.html</A>. These files are also
71found in the <TT>...\gsas\expgui\doc</TT> directory after EXPGUI is installed.
72
73
74<H3>Using the GSAS and EXPGUI self-installer for Windows</H3>
[549]75<DL><DL>
[612]76You can download a single file that installs
[973]77  <a href="http://www.ncnr.nist.gov/xtal/software/gsas.html">GSAS</A>
[549]78and
[973]79<a href="expgui.html">EXPGUI</a>,
[549]80as well as the Tcl/Tk package, needed by EXPGUI. This self-installing
81file uncompresses itself, copies the required files
[864]82to a selected directory and
83creates the appropriate registry entries needed to run the programs.
[549]84A
[973]85<a href="gsas+expgui.html">
[812]86separate web page</a>
[973]87provides details a detailed description on this self-installer.
[614]88
[973]89  Here are the steps in brief:
90
[614]91<OL>
92<P><LI><B>Download
[973]93gsas+expgui.exe
94from
95<a href="http://11bm.xor.aps.anl.gov/downloads/gsas/windows/">Argonne</a>
96(http://11bm.xor.aps.anl.gov/downloads/gsas/windows/)
[812]97or
[973]98<a href="http://www.ccp14.ac.uk/ccp/ccp14/ftp-mirror/gsas/public/gsas/windows/">
99CCP14 </A>
100(http://www.ccp14.ac.uk/ccp/ccp14/ftp-mirror/gsas/public/gsas/windows/) 
[812]101
[973]102  <P><LI><B>Run the gsas+expgui.exe file</B>
[812]103
[614]104<P><LI><B>Page through the installation screens & select install options</B>
105
[864]106<P><LI><B>Wait while the files are installed. </B>
[614]107
108<P><LI><B>Delete the gsas+expgui.exe file (optional)</B>
109</OL>
110<P>
111For more details on the sequence of operations and the installation
112options refer to the detailed
[973]113<a href="gsas+expgui.html">
[614]114Windows self-installer instructions</a> web page.
[549]115
116</DL></DL>
[612]117
[812]118<H2>Updating to a new GSAS release</H2>
119<DL><DL>
120It is quite common that Bob Von Dreele will release an update to the
[821]121GSAS programs more frequently than the combination gsas+expgui.exe
[812]122package can be updated. It is possible to update a previous version of the
123GSAS software.
124First, make a note where you have installed the GSAS/EXPGUI software.
125The default is <TT>C:\GSAS</TT>, but you can check by looking at the properties for the
126PC-GSAS or EXPGUI icon. Second, note the GSAS package date, by
127running a GSAS program, such as EXPEDT or SPACEGRP and noting the
128date where it says "Distributed on ..."
129Then download the latest GSAS release from CCP14:
130<DL>
131<DT>UK:<DD>
[888]132<A HREF="http://www.ccp14.ac.uk/ccp/ccp14/ftp-mirror/gsas/public/gsas/windows/gsaskit.exe">
[812]133http://www.ccp14.ac.uk/ccp/ccp14/ftp-mirror/gsas/public/gsas/windows/gsaskit.exe</A>
134<BR>or<BR>
[888]135<A HREF="
[812]136ftp://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>
[734]137
[812]138<DT>Canada:<DD>
[888]139<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>
[734]140
[812]141<DT>Australia:<DD>
[888]142<A HREF="
[812]143http://ccp14.minerals.csiro.au/ccp/ccp14/ftp-mirror/gsas/public/gsas/windows/gsaskit.exe">
144http://ccp14.minerals.csiro.au/ccp/ccp14/ftp-mirror/gsas/public/gsas/windows/gsaskit.exe</A>
[734]145</DL>
[812]146<P>When you run the downloaded file, you will be asked where the GSAS software
147should be installed (with a default of <tt>C:\GSAS</TT>). Make sure to use the same
148location as before.
149<P>
150Finally, check that GSAS has indeed been updated by
151again running a GSAS program, such as EXPEDT or SPACEGRP and noting the
152date where it says "Distributed on ..."
153</DL></DL>
[734]154
[812]155<H2>Updating to a new EXPGUI release</H2>
156<DL><DL>
157It is also common that new features will be added to EXPGUI or
158bug fixes will be made without an update to the
[821]159combination gsas+expgui.exe
[812]160package.
161The absolute latest release (which may not have gotten
162a lot of testing)
[973]163is found as a .tar or .zip file in
164<A HREF="http://11bm.xor.aps.anl.gov/downloads/gsas/">
165  http://11bm.xor.aps.anl.gov/downloads/gsas/</A>.
[812]166On the newest versions of Windows, support for .zip files is built in, but
167for older versions, you will need an unzip program, such as WinZip or pkZip.
[203]168<P>
[812]169To update EXPGUI,
170first, make a note where you have installed the GSAS/EXPGUI software.
171The default is <TT>C:\GSAS\EXPGUI</TT>, but you can check by looking at the
172properties for the PC-GSAS or EXPGUI icon.
173Second, note the EXPGUI package date, by
174using the Help/About menu command in EXPGUI.
[973]175You then want to download file expgui.zip from :
[812]176is distributed as
177<DL>
[973]178<A HREF="http://11bm.xor.aps.anl.gov/downloads/gsas/">
179  http://11bm.xor.aps.anl.gov/downloads/gsas/</A>.
[812]180</DL><P>
181 and unpack it to subdirectory <tt>...\gsas\expgui\</tt>.
182Depending how you work with the zip directory, you may want to copy the
183files in the .zip archive into the existing <tt>gsas\expgui</tt> directory or
184rename the original <tt>expgui</tt> in <tt>gsas</tt> 
185and then drag the new expgui directory into the gsas folder.
186Finally, you can check if the EXPGUI program has been updated, by restarting
187it and again using the Help/About menu option.
188</DL></DL>
189<H2>Problems & Questions</H2>
190<OL>
[864]191<LI>Where can the software be installed?
192<UL>
193Do not install the software on a directory containing a space (for example,
194C:\Program files\GSAS). This will cause some of the shortcuts to break.
195<P>
196On Windows-95/-98 or -ME, if you install in a location other than C:\GSAS,
197you will need to define the GSAS environment variable in your AUTOEXEC.BAT file
198by adding a line like this:
199<FONT FACE="COURIER"><PRE>
200        SET GSAS=G:\MySoftware\GSAS
201</PRE></FONT>
202</UL>
203
[812]204<LI>How do I increase the Environment variable space
205<UL>This is only needed on -95/-98 or -ME.
206To add more environment space in Win95/98, add the following line to the
[216]207CONFIG.SYS file in the root directory
[549]208<FONT FACE="COURIER"><PRE>
[216]209        SHELL=C:\WINDOWS\COMMAND.COM /P /E:4096
[549]210</PRE></FONT>
[812]211Also add the following line to the SYSTEM.INI file (in c:\windows) under
[216]212the heading [NonWindowsApp]
[549]213<FONT FACE="COURIER"><PRE>
[216]214
215        CommandEnvSize=2424
[549]216</PRE></FONT>
[216]217(thanks to Louis Farrugia [louis@chem.gla.ac.uk] for this).
218
[34]219</UL>
[812]220<LI>What versions of Windows can I use?
[752]221<UL>As far as I am aware, EXPGUI will run under all releases of Windows from
[812]222-95/-98/-ME/-NT/-2000 through -XP, but it is not tested
223here on most of those platforms.
[752]224I depend on feedback from users to tell me of OS conflicts, but none have
225been reported.
[34]226</UL>
[812]227<LI>EXPGUI seems pretty slow, or is it my imagination?
[80]228<UL>
[367]229Well, actually the problem is Windows. EXPGUI is pretty zippy in LINUX,
230but some operations
231(reading a histogram in liveplot for example) can take 3-5 times
232longer in Windows than in UNIX on the exact same hardware.
233By all means, take this up with the folks in Redmond, WA.
[203]234
[80]235</UL>
[812]236<LI>When I run one of the GSAS graphics programs (POWPLOT, RAWPLOT,...) the
[203]237program starts, and I can answer questions, but when it comes to the part
238of the program that should display a plot, I get no plot (and possibly
239the DOS window disappears without a trace.)
240<UL>
241There are two problems I know of that can cause graphics errors:
242One is that the graphics package (PGPLOT) cannot find the PGPLOT_FONT
243environment variable (that points to file GRFONT.DAT). EXPGUI does this
[367]244for you and warns if it can't find this file, so the likely reason is
245that you are out of environment space (see 2, above).
[203]246<P>
247The other appears to be a graphics mode problem. Not all modes work
248on all machines. Try mode A. If you still have problems, see if it is an
249EXPGUI problem: Try using a plotting program
250(RAWPLOT is a good choice) from PC-GSAS or GSAS.BAT.  If the plotting
251program does not work there either, first check PGPLOT_FONT is defined
252(by opening a DOS box and type SET, also see question 2, above.)
253If the plotting program runs in PC-GSAS or GSAS.BAT but not EXPGUI, you have a
[367]254real EXPGUI bug and should bug me.
[341]255
[549]256</UL>
257<a name="NetPath"></a>
[812]258<LI>Can GSAS and EXPGUI be located on a shared network drive?
[341]259<UL>
[577]260Yes. With earlier versions of GSAS path had to be mapped to a
261"logical drive." (e.g. F:). In the current versions of GSAS, this does not
262seem to be needed, but
263EXPGUI will warn you, if you try to do this, since I am not certain
264that this works.
265<P>
266I do not know if GSAS will work properly with
[549]267experiment and data files on a networked drive without mapping the
[577]268path to a "logical drive."
269There are some definite problems in GSAS where directory and file
270names contain
[864]271spaces so EXPGUI generates warning messages if you do this.
[203]272</UL>
[34]273
[812]274</OL>
[549]275
[34]276<H2>
277Acknowledgements</H2>
278<P>
[147]279<A Href="http://www.ncnr.nist.gov/programs/crystallography/software/gsas.html">
280GSAS</A>
281is written by Allen C. Larson and Robert B. Von Dreele,  MS-H805,
[34]282Los Alamos National Laboratory, Los Alamos, NM 87545. Problems, questions
283or kudos concerning GSAS should be sent to Robert B. Von Dreele at
[734]284<A HREF="MAILTO:vondreele@anl.gov">vondreele@anl.gov</A>
[515]285<P>EXPGUI is written by Brian H. Toby of the NIST Center for Neutron Research,
[899]286<A HREF="MAILTO:Brian.Toby@ANL.GOV">Brian.Toby@ANL.GOV</A> 
[515]287with help from Jonathan Wasserman.
288
289<P>
290<hr><blockquote>
291GSAS is Copyright, 1984-1997, The Regents of the University of California.
[34]292The GSAS software was produced under a U.S. Government contract (W-7405-ENG-36)
293by the Los Alamos National Laboratory, which is operated by the University
294of California for the U.S. Department of Energy. The U.S. Government is
295licensed to use, reproduce, and distribute this software. Permission is
296granted to the public to copy and use this software without charge, provided
297that this notice and any statement of authorship are reproduced on all
298copies. Neither the Government nor the University makes any warranty, express
299or implied, or assumes any liability or responsibility for the use of this
300software.
301
302<P>EXPGUI is not subject to copyright. Have fun with it.
303
304<p>Neither the U.S. Government nor any author makes any warranty,
305expressed or implied, or assumes any liability or responsibility
306for the use of this information or the software described
307here. Brand names cited here are used for
308identification purposes and do not consitute an endorsement by NIST.
[515]309</blockquote>
310<hr>
311<TABLE BORDER BGCOLOR="#FFFF40" ALIGN=RIGHT>
[812]312<TR>
313<TH>
[973]314<a href="gsas+expgui.html">self-installer notes</a></TH>
[812]315<TH><A  Href="win_old_notes.html">Windows install details</A></TH>
316<TH><A  Href="expgui.html">EXPGUI home</A></TH>
317</TR></TABLE><BR CLEAR=ALL>
[577]318
[899]319<P>
[577]320<font size=-1><? lastmod(); ?> </font>
[34]321<br>
322$Revision: 973 $ $Date: 2010-03-28 17:19:55 +0000 (Sun, 28 Mar 2010) $
[515]323</blockquote>
[34]324</body>
325</html>
Note: See TracBrowser for help on using the repository browser.