source: trunk/doc/expgui_Win_readme.html @ 549

Last change on this file since 549 was 549, checked in by toby, 12 years ago

# on 2002/01/23 19:59:56, toby did:
reference the self-installer
cleanup font references

  • Property rcs:author set to toby
  • Property rcs:date set to 2002/01/23 19:59:56
  • Property rcs:lines set to +54 -21
  • Property rcs:rev set to 1.19
  • Property rcs:state set to Exp
  • Property svn:keywords set to Author Date Revision Id
File size: 14.2 KB
[140]3   <META NAME="Author" CONTENT="Brian H. Toby">
[34]4   <TITLE>Windows Installation Notes for EXPGUI</TITLE>
[515]5   <meta name="keywords" content="crystallography, Rietveld, diffraction,
6   GSAS, EXPGUI, Windows">
9A:link {text-decoration:none}
10A:vlink {text-decoration:none}
14      topmargin="0" leftmargin="0" marginwidth="0" marginheight="0" 
15      text="#000000" link="#0033ff" vlink="#0033ff" alink="#0033ff">
18   include("/var/www/include/");
19   include("/var/www/include/");
21<blockquote><font face="arial, helvetica, sans-serif">
24<TR><TH><A  Href="expgui.html">EXPGUI home</A> 
[243]28<HR noshade width="75%" size="2" align="center">
[515]29Windows-95/98 and -NT/-2000<BR>Installation notes for
30<A HREF="expgui.html">EXPGUI</A>
[243]31<HR noshade width="75%" size="2" align="center">
[147]34<EM>Please note that <A HREF="expgui.html">EXPGUI</A>
35 is always under development and gets
36less testing by the author
[80]37in Windows than in UNIX. Please report problems, including comments on
38these instructions to
[243]39<A HREF="">Brian Toby</A>.
[549]42<P><B>0. A one-step self-installer for Windows</B>
44It is possible to download a single file that installs
45<a href="">GSAS (General Structure Analysis System)</a>
47<a href="">EXPGUI</a>,
48as well as the Tcl/Tk package, needed by EXPGUI. This self-installing
49file uncompresses itself, copies the required files
50to a selected directory and either modifies the <TT>AUTOEXEC.BAT</TT> file
51and/or creates the appropriate registry entries needed to run the programs.
53<a href="">separate web page</a>
54details how to use this self-installer,
55(<a href="">
57</a> or from CCP14 mirrors). To use this program, refer to these
58<a href="">
59Windows self-installer instructions</a>, rather than the instructions below.
[34]62<P><B>1. Download the following files:</B>
[140]64<I>(Shift-click on the links below to download the files)</I>
67<A Href="">
68GSAS</A> from
[442]69<A HREF=""></A>
[140]70(~6 Mbytes)<BR>
[203]71and read<BR>
[442]72<A HREF=""></A>
[243]74Mirrors for these files can be found at
75<P><A HREF="
81<A HREF="
[243]85</A><P>and<P><A HREF="
91<A HREF="
97Note that the links for these files are on non-NIST servers.
[140]99<P><LI>Get a
100<A Href="">
101Tcl/Tk</A> distribution<BR>
[442]102I recommend using this (not so new) version (Tcl/Tk v8.2)
103(why - <a href="#Winexec">see note 1 below</a>):<BR>
[140]104<A HREF="">
106(2686464 bytes)
109<A HREF="expgui.html">EXPGUI</A> code<BR>
[107]110<A HREF=""></A>
[80]111(~340 K bytes)
[140]112<BR>for the absolute latest release (which may not have gotten
113a lot of testing, but probably has new capabilities and bug fixes) use<BR>
114<A HREF="">
116You will need an unzip program, such as WinZip or pkZip, to use this file.
[367]117(sometimes I update
118<A HREF="">
[442]120but this may lag behind the .ZIP version or may not be present.)
[442]123If you have a version of GSAS from September 2001, or earlier and wish
124to set up dummy histograms from EXPEDT, you will need to
125update the EXPTOOL program using one of the following files:
[107]127<A HREF=""></A> (~300 K bytes)
129or <A HREF=""></A> (~700 K bytes)
[80]132You can put these .EXE (and .ZIP) files anywhere on your computer, but make a note of the
[140]133locations for steps 2, 3 and 5, below.
135<P><B>2. Run the programs</B>
[203]136<UL>Use a DOS window to run, gsaskit.exe,
[442]137tcltk82blt24qwinexec0601.exe, and expgui.exe (the order should not matter):
[203]139        mkdir c:\gsas
140        chdir c:\gsas
141        c:\temp\gsaskit.exe -d
[442]142        c:\temp\tcltk82blt24qwinexec0601.exe
[203]143        c:\temp\expgui.exe
[442]146These files can be run from where they are downloaded using the Run command
147or by clicking on their icons in a Windows Explorer or other directory view
150The previous steps will cause the files to be unpacked. The default
[34]151locations for installation are:
[442]153           gsaskit.exe                     c:\gsas
154           tcltk82blt24qwinexec0601.exe    c:\expgui
155           expgui.exe                      c:\gsas\expgui
158<P>These files can be located on other disks and in directories with
[80]159other names, but the expgui files in expgui.exe
[374]160<I><U>must</U></I> be located in a subdirectory of the GSAS files and
161each directory name <I><U>must</U></I> be 8 characters or less, so
[549]163<font face="courier">Z:\i\think\this\will\work\gsas</font> should be OK, but
164<font face="courier">C:\longwindows\namesarenotgood\for dos</font> probably
[374]165will not work.
[34]166If these files will be located on a fileserver, the file server
167must be mapped to appear as a disk drive (must be assigned a name
168such as F:).
170If you downloaded, unpack it and copy it to
[549]171<font face="courier">c:\gsas\exe</font>, or if you downloaded exptool.exe, it can be copied
172directly to <font face="courier">c:\gsas\exe</font>.
[442]174<P><B>3. Create a shortcut:</B>
177On a blank part of the Windows desktop, click the <I><U>right</U></I> mouse
178button and then select NEW and then shortcut and click with the <I><U>left</U></I>
179mouse button.</LI>
182provide command</LI>
[549]184<UL><FONT FACE="COURIER">c:\tcl\bin\wish82.exe c:\gsas\expgui\expgui</FONT></UL>
187<UL>(modify previous paths, if you have located the files in different places)</UL>
191click on NEXT with the <I><U>left</U></I> mouse button.</LI>
194Enter name EXPGUI</LI>
197click on FINISH with the <I><U>left</U></I> mouse button.</LI>
200<UL>You may want to modify the shortcut by modifying the properties to
201change the icon or the default properties.</UL>
[442]202<B>4. Delete the downloaded .exe files to save space (optional)</B>
[155]205<DD>          gsaskit.exe
[442]206<DD>          tcltk82blt24qwinexec0601.exe
[80]207<DD>          expgui.exe
[442]208<DD>          (expgui_alpha.exe)
[80]209<DD>          (
212<P>More information about EXPGUI, including information on how it
[107]213can be customized, can be found on web pages <A HREF="expgui.html">expgui.html</A>
214and <A HREF="expgui_cfg.html">expgui_cfg.html</A>,
[65]215found in the \gsas\expgui\doc directory.
[341]218<a name="Winexec"></a>Questions</H2>
[34]2191. Can I use a different version of Tcl/Tk than the one here?
220<UL>Yes -- but: you will need both Tcl/Tk and the Winexec package (see
[367]221 for the GUI to work
222with Windows-95, -98 and -me. Further,
[549]223several utility routines (for example, liveplot and widplt)
[34]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
[367]227your version, if you get an error about loading Blt_ZoomStack.
228Please note that EXPGUI seems to run very
[140]229slowly in Tcl/Tk version 8.1, but OK in 8.0 and 8.2.
[80]230<BR> </UL>
[442]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="">GSAS readme file</A>)
236Note, to add more environment space in Win95/98, add the following line to the
237CONFIG.SYS file in the root directory
[216]239        SHELL=C:\WINDOWS\COMMAND.COM /P /E:4096
[216]241add the following line to the SYSTEM.INI file (in c:\windows) under
242the heading [NonWindowsApp]
245        CommandEnvSize=2424
[216]247(thanks to Louis Farrugia [] for this).
2503. What versions of Windows can I use?
[442]251<UL>This package has gotten some testing under Win-95/98 and Win-NT 4.0 & 2000.
[80]2534. EXPGUI seems pretty slow, or is it my imagination?
[367]255Well, actually the problem is Windows. EXPGUI is pretty zippy in LINUX,
256but some operations
257(reading a histogram in liveplot for example) can take 3-5 times
258longer in Windows than in UNIX on the exact same hardware.
259By all means, take this up with the folks in Redmond, WA.
[203]2625. When I run one of the GSAS graphics programs (POWPLOT, RAWPLOT,...) the
263program starts, and I can answer questions, but when it comes to the part
264of the program that should display a plot, I get no plot (and possibly
265the DOS window disappears without a trace.)
267There are two problems I know of that can cause graphics errors:
268One is that the graphics package (PGPLOT) cannot find the PGPLOT_FONT
269environment variable (that points to file GRFONT.DAT). EXPGUI does this
[367]270for you and warns if it can't find this file, so the likely reason is
271that you are out of environment space (see 2, above).
273The other appears to be a graphics mode problem. Not all modes work
274on all machines. Try mode A. If you still have problems, see if it is an
275EXPGUI problem: Try using a plotting program
276(RAWPLOT is a good choice) from PC-GSAS or GSAS.BAT.  If the plotting
277program does not work there either, first check PGPLOT_FONT is defined
278(by opening a DOS box and type SET, also see question 2, above.)
279If the plotting program runs in PC-GSAS or GSAS.BAT but not EXPGUI, you have a
[367]280real EXPGUI bug and should bug me.
283<a name="NetPath"></a>
2846. Can GSAS and EXPGUI be located on a shared network drive?
[367]286Yes, but. The path must be mapped to a "logical drive."
287(e.g. F:) since GSAS is basically a set of DOS programs.
[549]288EXPGUI will warn you, if you try to do this.
289I am not sure if GSAS will work properly if you can access
290experiment and data files on a networked drive without mapping the
291path to a "logical drive." I have not seen anything that breaks,
292if you do this, but I have not done much testing.
[549]2957. Can I use Windows-ME or Windows-XP with GSAS and EXPGUI?
297I do not have any direct experience with either OS. I am not aware of any
298problems running EXPGUI & GSAS on -ME. I have heard that there are minor
299problems with running EXPGUI on -XP -- after GSAS programs are run, EXPGUI
300may remain minimized (on the taskbar) rather than reopen itself. This
301problem can be avoided by unselecting the "Minimize on GSAS" checkbutton
302in the Options menu.
[515]308Thanks to <A HREF="">Mumit
309Khan</A> for help with Tcl/Tk on Windows
310and to <A HREF="">Michael
311I. Schwartz</A> for the Winexec package, which is needed to allow Tcl/Tk to run
312the GSAS DOS .exe files.
[147]314<A Href="">
316is written by Allen C. Larson and Robert B. Von Dreele,  MS-H805,
[34]317Los Alamos National Laboratory, Los Alamos, NM 87545. Problems, questions
318or kudos concerning GSAS should be sent to Robert B. Von Dreele at
319<A HREF=""></A>
[515]320<P>EXPGUI is written by Brian H. Toby of the NIST Center for Neutron Research,
321<A HREF="MAILTO:Brian.Toby@NIST.GOV">Brian.Toby@NIST.GOV</A> 
322with help from Jonathan Wasserman.
326GSAS is Copyright, 1984-1997, The Regents of the University of California.
[34]327The GSAS software was produced under a U.S. Government contract (W-7405-ENG-36)
328by the Los Alamos National Laboratory, which is operated by the University
329of California for the U.S. Department of Energy. The U.S. Government is
330licensed to use, reproduce, and distribute this software. Permission is
331granted to the public to copy and use this software without charge, provided
332that this notice and any statement of authorship are reproduced on all
333copies. Neither the Government nor the University makes any warranty, express
334or implied, or assumes any liability or responsibility for the use of this
337<P>EXPGUI is not subject to copyright. Have fun with it.
339<p>Neither the U.S. Government nor any author makes any warranty,
340expressed or implied, or assumes any liability or responsibility
341for the use of this information or the software described
342here. Brand names cited here are used for
343identification purposes and do not consitute an endorsement by NIST.
347<TR><TH><A  Href="expgui.html">EXPGUI home</A> 
349<a href="">Brian Toby</a> (<a href="">Brian.Toby@NIST.GOV</a>)
351$Revision: 549 $ $Date: 2009-12-04 23:08:02 +0000 (Fri, 04 Dec 2009) $
Note: See TracBrowser for help on using the repository browser.