source: trunk/doc/expgui_Win_readme.html @ 971

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

change web pages to html

  • Property svn:keywords set to Author Date Revision Id
  • Property svn:mime-type set to text/html
File size: 13.1 KB
[812]3   <TITLE>Windows Installation Information for EXPGUI</TITLE>
[515]4   <meta name="keywords" content="crystallography, Rietveld, diffraction,
5   GSAS, EXPGUI, Windows">
8A:link {text-decoration:none}
9A:vlink {text-decoration:none}
13      topmargin="0" leftmargin="0" marginwidth="0" marginheight="0" 
14      text="#000000" link="#0033ff" vlink="#0033ff" alink="#0033ff">
17   include("/var/www/include/");
18   include("/var/www/include/");
20<blockquote><font face="arial, helvetica, sans-serif">
25<a href="">self-installer notes</a></TH>
26<TH><A  Href="win_old_notes.html">Windows install details</A></TH>
27<TH><A  Href="expgui.html">EXPGUI home</A></TH>
[243]32<HR noshade width="75%" size="2" align="center">
[812]33Installating and Updating
[515]35<A HREF="expgui.html">EXPGUI</A>
37<a href="">GSAS</a>)
38on Windows
[243]39<HR noshade width="75%" size="2" align="center">
[147]42<EM>Please note that <A HREF="expgui.html">EXPGUI</A>
43 is always under development and gets
44less testing by the author
[812]45in Windows than in other platforms.
46Please report problems, including improvements on
[80]47these instructions to
[899]48<A HREF="">Brian Toby</A>.
[812]49Otherwise, Windows-specific issues are unlikely to be addressed or repaired.
[812]52<H2>Installing GSAS and EXPGUI in Windows</H2>
53Most users who install
54<a href="">GSAS (General Structure Analysis System)</a>
56<a href="">EXPGUI</a>,
57will do so by downloading a single file that installs the GSAS programs,
58the Tcl/Tk package (with some extensions), the EXPGUI scripts, as well as
[864]59makes registry entries & defines shortcuts. This will
[812]60be described in brief in the next section of this page.
61It is also possible to download and install GSAS, Tcl/Tk & EXPGUI from
62separate distributions; please see the
63<A Href="win_old_notes.html">Windows install details</A> web page
64for more details.
65<P>More information about EXPGUI, including information on how it
66can be customized, can be found on web pages <A HREF="expgui.html">expgui.html</A>
67and <A HREF="expgui_cfg.html">expgui_cfg.html</A>. These files are also
68found in the <TT>...\gsas\expgui\doc</TT> directory after EXPGUI is installed.
71<H3>Using the GSAS and EXPGUI self-installer for Windows</H3>
[612]73You can download a single file that installs
[812]74<a href="">GSAS</A>
76<a href="">EXPGUI</a>,
77as well as the Tcl/Tk package, needed by EXPGUI. This self-installing
78file uncompresses itself, copies the required files
[864]79to a selected directory and
80creates the appropriate registry entries needed to run the programs.
[812]82<a href="">
83separate web page</a>
84provides details a detailed description on this self-installer
85(<a href="">gsas+expgui.exe</A>).
86Here are the steps in brief:
90<a href="">
93(Mirrors: select file gsas+expgui.exe from
[888]94<A HREF="
[888]98<A HREF="">
[888]102<A HREF="
[614]107<P><LI><B>Run the gsas+expgui.exe file</B>
109<P><LI><B>Page through the installation screens & select install options</B>
[864]111<P><LI><B>Wait while the files are installed. </B>
113<P><LI><B>Delete the gsas+expgui.exe file (optional)</B>
116For more details on the sequence of operations and the installation
117options refer to the detailed
[549]118<a href="">
[614]119Windows self-installer instructions</a> web page.
[812]123<H2>Updating to a new GSAS release</H2>
125It is quite common that Bob Von Dreele will release an update to the
[821]126GSAS programs more frequently than the combination gsas+expgui.exe
[812]127package can be updated. It is possible to update a previous version of the
128GSAS software.
129First, make a note where you have installed the GSAS/EXPGUI software.
130The default is <TT>C:\GSAS</TT>, but you can check by looking at the properties for the
131PC-GSAS or EXPGUI icon. Second, note the GSAS package date, by
132running a GSAS program, such as EXPEDT or SPACEGRP and noting the
133date where it says "Distributed on ..."
134Then download the latest GSAS release from CCP14:
[888]137<A HREF="">
[888]140<A HREF="
[888]144<A HREF=""></A>
[888]147<A HREF="
[812]151<P>When you run the downloaded file, you will be asked where the GSAS software
152should be installed (with a default of <tt>C:\GSAS</TT>). Make sure to use the same
153location as before.
155Finally, check that GSAS has indeed been updated by
156again running a GSAS program, such as EXPEDT or SPACEGRP and noting the
157date where it says "Distributed on ..."
[812]160<H2>Updating to a new EXPGUI release</H2>
162It is also common that new features will be added to EXPGUI or
163bug fixes will be made without an update to the
[821]164combination gsas+expgui.exe
166The absolute latest release (which may not have gotten
167a lot of testing)
168is distributed as
169<A HREF="">
171On the newest versions of Windows, support for .zip files is built in, but
172for older versions, you will need an unzip program, such as WinZip or pkZip.
[812]174To update EXPGUI,
175first, make a note where you have installed the GSAS/EXPGUI software.
176The default is <TT>C:\GSAS\EXPGUI</TT>, but you can check by looking at the
177properties for the PC-GSAS or EXPGUI icon.
178Second, note the EXPGUI package date, by
179using the Help/About menu command in EXPGUI.
180You then want to download this file:
181is distributed as
[140]183<A HREF="">
186(Mirrors: select file from
[888]187<A HREF="
[888]191<A HREF="">
[888]195<A HREF="
199 and unpack it to subdirectory <tt>...\gsas\expgui\</tt>.
200Depending how you work with the zip directory, you may want to copy the
201files in the .zip archive into the existing <tt>gsas\expgui</tt> directory or
202rename the original <tt>expgui</tt> in <tt>gsas</tt> 
203and then drag the new expgui directory into the gsas folder.
204Finally, you can check if the EXPGUI program has been updated, by restarting
205it and again using the Help/About menu option.
207<H2>Problems & Questions</H2>
[864]209<LI>Where can the software be installed?
211Do not install the software on a directory containing a space (for example,
212C:\Program files\GSAS). This will cause some of the shortcuts to break.
214On Windows-95/-98 or -ME, if you install in a location other than C:\GSAS,
215you will need to define the GSAS environment variable in your AUTOEXEC.BAT file
216by adding a line like this:
218        SET GSAS=G:\MySoftware\GSAS
[812]222<LI>How do I increase the Environment variable space
223<UL>This is only needed on -95/-98 or -ME.
224To add more environment space in Win95/98, add the following line to the
[216]225CONFIG.SYS file in the root directory
[216]227        SHELL=C:\WINDOWS\COMMAND.COM /P /E:4096
[812]229Also add the following line to the SYSTEM.INI file (in c:\windows) under
[216]230the heading [NonWindowsApp]
233        CommandEnvSize=2424
[216]235(thanks to Louis Farrugia [] for this).
[812]238<LI>What versions of Windows can I use?
[752]239<UL>As far as I am aware, EXPGUI will run under all releases of Windows from
[812]240-95/-98/-ME/-NT/-2000 through -XP, but it is not tested
241here on most of those platforms.
[752]242I depend on feedback from users to tell me of OS conflicts, but none have
243been reported.
[812]245<LI>EXPGUI seems pretty slow, or is it my imagination?
[367]247Well, actually the problem is Windows. EXPGUI is pretty zippy in LINUX,
248but some operations
249(reading a histogram in liveplot for example) can take 3-5 times
250longer in Windows than in UNIX on the exact same hardware.
251By all means, take this up with the folks in Redmond, WA.
[812]254<LI>When I run one of the GSAS graphics programs (POWPLOT, RAWPLOT,...) the
[203]255program starts, and I can answer questions, but when it comes to the part
256of the program that should display a plot, I get no plot (and possibly
257the DOS window disappears without a trace.)
259There are two problems I know of that can cause graphics errors:
260One is that the graphics package (PGPLOT) cannot find the PGPLOT_FONT
261environment variable (that points to file GRFONT.DAT). EXPGUI does this
[367]262for you and warns if it can't find this file, so the likely reason is
263that you are out of environment space (see 2, above).
265The other appears to be a graphics mode problem. Not all modes work
266on all machines. Try mode A. If you still have problems, see if it is an
267EXPGUI problem: Try using a plotting program
268(RAWPLOT is a good choice) from PC-GSAS or GSAS.BAT.  If the plotting
269program does not work there either, first check PGPLOT_FONT is defined
270(by opening a DOS box and type SET, also see question 2, above.)
271If the plotting program runs in PC-GSAS or GSAS.BAT but not EXPGUI, you have a
[367]272real EXPGUI bug and should bug me.
275<a name="NetPath"></a>
[812]276<LI>Can GSAS and EXPGUI be located on a shared network drive?
[577]278Yes. With earlier versions of GSAS path had to be mapped to a
279"logical drive." (e.g. F:). In the current versions of GSAS, this does not
280seem to be needed, but
281EXPGUI will warn you, if you try to do this, since I am not certain
282that this works.
284I do not know if GSAS will work properly with
[549]285experiment and data files on a networked drive without mapping the
[577]286path to a "logical drive."
287There are some definite problems in GSAS where directory and file
288names contain
[864]289spaces so EXPGUI generates warning messages if you do this.
[147]297<A Href="">
299is written by Allen C. Larson and Robert B. Von Dreele,  MS-H805,
[34]300Los Alamos National Laboratory, Los Alamos, NM 87545. Problems, questions
301or kudos concerning GSAS should be sent to Robert B. Von Dreele at
[734]302<A HREF=""></A>
[515]303<P>EXPGUI is written by Brian H. Toby of the NIST Center for Neutron Research,
[899]304<A HREF="MAILTO:Brian.Toby@ANL.GOV">Brian.Toby@ANL.GOV</A> 
[515]305with help from Jonathan Wasserman.
309GSAS is Copyright, 1984-1997, The Regents of the University of California.
[34]310The GSAS software was produced under a U.S. Government contract (W-7405-ENG-36)
311by the Los Alamos National Laboratory, which is operated by the University
312of California for the U.S. Department of Energy. The U.S. Government is
313licensed to use, reproduce, and distribute this software. Permission is
314granted to the public to copy and use this software without charge, provided
315that this notice and any statement of authorship are reproduced on all
316copies. Neither the Government nor the University makes any warranty, express
317or implied, or assumes any liability or responsibility for the use of this
320<P>EXPGUI is not subject to copyright. Have fun with it.
322<p>Neither the U.S. Government nor any author makes any warranty,
323expressed or implied, or assumes any liability or responsibility
324for the use of this information or the software described
325here. Brand names cited here are used for
326identification purposes and do not consitute an endorsement by NIST.
332<a href="">self-installer notes</a></TH>
333<TH><A  Href="win_old_notes.html">Windows install details</A></TH>
334<TH><A  Href="expgui.html">EXPGUI home</A></TH>
[577]338<font size=-1><? lastmod(); ?> </font>
340$Revision: 971 $ $Date: 2010-03-28 14:19:30 +0000 (Sun, 28 Mar 2010) $
Note: See TracBrowser for help on using the repository browser.