source: trunk/doc/expgui_Unix_readme.html @ 514

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

# on 2001/12/19 18:55:42, toby did:
reformat to match NCNR style

  • Property rcs:author set to toby
  • Property rcs:date set to 2001/12/19 18:55:42
  • Property rcs:lines set to +39 -27
  • Property rcs:rev set to 1.15
  • Property rcs:state set to Exp
  • Property svn:keywords set to Author Date Revision Id
File size: 10.2 KB
Line 
1<HTML>
2<HEAD>
3   <META NAME="Author" CONTENT="Brian H. Toby">
4   <TITLE>UNIX Installation notes for EXPGUI</TITLE>
5   <meta name="keywords" content="crystallography, Rietveld, diffraction,
6   GSAS, EXPGUI, Windows">
7</HEAD>
8<style>
9A:link {text-decoration:none}
10A:vlink {text-decoration:none}
11</style>
12
13<BODY BGCOLOR="#FFFFFF"
14      topmargin="0" leftmargin="0" marginwidth="0" marginheight="0" 
15      text="#000000" link="#0033ff" vlink="#0033ff" alink="#0033ff">
16
17<?
18   include("/var/www/include/navigation.inc");
19   include("/var/www/include/utility.inc");
20?>
21<blockquote><font face="arial, helvetica, sans-serif">
22
23<TABLE BORDER BGCOLOR="#FFFF40" ALIGN=RIGHT>
24<TR><TH><A  Href="expgui.html">EXPGUI home</A> 
25</TH></TR></TABLE><BR CLEAR=ALL>
26
27<CENTER><H1>
28<HR noshade width="75%" size="2" align="center">
29UNIX Installation notes for
30<A HREF="expgui.html">
31EXPGUI
32</A>
33<HR noshade width="75%" size="2" align="center">
34</H1></CENTER>
35Note that root access is not required to load GSAS, Tcl/Tk and
36<A HREF="expgui.html">EXPGUI</A>.
37
38<H2>0. Prerequisites</H2>
39
40I will assume that you already have the Tcl/Tk package loaded on your computer. If this
41is not true, please see
42<A HREF="http://www.ncnr.nist.gov/programs/crystallography/software/tclpkgs.html">
43http://www.ncnr.nist.gov/programs/crystallography/software/tclpkgs.html
44</A> for installation instructions. Please note that EXPGUI seems to run very
45slowly in Tcl/Tk version 8.1, but OK in 8.0 and 8.2.
46Also see <a href="#testtcltk">below</a> on how to test if Tcl/Tk is properly
47installed.
48<P>
49Likewise, I will assume you have also loaded the appropriate GSAS release, if not see
50<A HREF="http://www.ncnr.nist.gov/programs/crystallography/software/unixgsas.html">
51http://www.ncnr.nist.gov/programs/crystallography/software/unixgsas.html
52</A> for installation instructions.  The current versions of EXPGUI must be
53used with GSAS versions released on or after April, 2001.
54<I>EXPGUI v. 1.40 and later are not compatible with earlier Unix versions of
55GSAS -- as the file formats have changed.</I>
56
57<P>More information about EXPGUI, including information on how it
58can be customized, can be found on web pages <A HREF="expgui.html">expgui.html</A>
59and <A HREF="expgui_cfg.html">expgui_cfg.html</A>, found in the gsas/expgui/doc directory.
60
61<H2>
621. EXPGUI Downloading</H2>
63download file
64<A HREF="ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/expgui.tar.gz">
65ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/expgui.tar.gz</A> (~300 K)
66by shift-clicking on the previous link.
67<P>
68If you want to try the latest release (which may not have gotten
69a lot of testing, but probably has new bug fixes and capabilities) shift-click
70on <A HREF="ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/expgui_ALPHA.tar.gz">
71ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/expgui_ALPHA.tar.gz</A>
72P>
73If you have a version of GSAS from September 2001, or earlier and wish
74to set up dummy histograms from EXPEDT, you will need to
75update the EXPTOOL program using one of the following files:
76<UL>
77<LI>LINUX: <BR>
78<A HREF="ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/exe_linux/exptool.tar.gz">
79ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/exe_linux/exptool.tar.gz</A> (~0.3 Mb)
80</LI><P>
81or
82<P>
83<LI>Silicon Graphics: <BR>
84<A HREF="ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/exe_sgi/exptool.tar.gz">
85ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/exe_sgi/exptool.tar.gz</A> (~0.4 Mb)
86</UL>Transfer the appropriate file by shift-clicking on the appropriate link.
87<H2>
882. EXPGUI Installation</H2>
89A few short steps are needed to load EXPGUI on your computer.
90<H3>
912.1 Create a directory and restore the files</H3>
92The EXPGUI scripts are set up to be run from a <B>subdirectory in the main GSAS
93directory</B>, by convention I assume the directory name <tt>expgui</tt>, but this is
94not required. Thus, if you have located the GSAS package in
95<TT>/usr/local/gsas</TT> (so that there is a directory
96<TT>/usr/local/gsas/exe</TT>, <TT>/usr/local/gsas/data</TT>, ...)
97I assume you will put
98these files in <TT>/usr/local/gsas/expgui</TT> but any subdirectory,
99such as <TT>/usr/local/gsas/tcl</TT> will work fine.
100Change the subsequent commands if GSAS is located somewhere
101other than <TT>/usr/local/gsas</TT>.
102
103<PRE>
104            cd    /usr/local/gsas
105            mkdir expgui
106            cd    expgui
107            gunzip <  [/path/]expgui.tar.gz  | tar xvf -
108</PRE>
109<P>When restoring the GSAS files from the tar file,
110note that <TT>[/path/]</TT> in the example above indicates the location
111where you downloaded the tar file in section 2, above.
112
113<H3>
1142.2 Installing a shortcut to EXPGUI</H3>
115While it is possible to invoke EXPGUI by typing
116<PRE>
117                wish /usr/local/gsas/expgui/expgui
118</PRE>
119or
120<PRE>
121                /home/toby/mywish/wish /home/toby/mygsas/expgui/expgui
122</PRE>
123or whatever, you will likely want to create an easier command to type.
124Below are three ways to do this. Note that only one is needed. Do not use all
125three.
126
127<em>Also, note that in the commands below,
128</em><TT>^D</TT><em> means control-D.</em>
129
130
131<UL><H4>
1322.2a Installing a shortcut to EXPGUI in .cshrc</H4>
133<P>To use EXPGUI, you probably need to create an easy way to access it.
134One way to do this is to add an alias to your ~/.cshrc file:
135<PRE>
136                cat >> ~/.cshrc
137                alias expgui "wish /usr/local/gsas/expgui/expgui"
138                ^D
139</PRE>
140<H4>
1412.2b Installing EXPGUI in the path</H4>
142<P>
143Another way to simplify access to EXPGUI
144is to create a file which will execute the GUI script from
145a command in your system's path, for example <TT>/usr/bin</TT>.
146<PRE>
147                cat > /usr/bin/expgui
148                wish /usr/local/gsas/expgui/expgui
149                ^D
150                chmod +x /usr/bin/expgui
151</PRE>
152<I>Note that this step (2.2b) is incompatible with the one below (2.2c).</I>
153<H4>
1542.2c Linking EXPGUI in the path</H4>
155<P>
156Another way to simplify access to EXPGUI
157is to create a link in your system's path to the GUI script.
158Note that you may need to modify the first line of
159<TT>/usr/local/gsas/expgui/expgui</TT>, if wish is located somewhere
160other than <TT>/usr/local/bin/wish</TT>.
161
162<PRE>
163                chmod +x /usr/local/gsas/expgui/expgui
164                ln -s /usr/local/gsas/expgui/expgui /usr/bin/expgui
165</PRE>
166<I>Note that this step (2.2c) is incompatible with the one above (2.2b).</I>
167</UL>
168H3>
169
1702.3 Installing EXPTOOL</H3>
171If being upgraded, the EXPTOOL program should be placed in the
172directory with the GSAS executable files,
173for example in /usr/local/gsas/exe/.
174<PRE>
175            cd    /usr/local/gsas/exe
176            gunzip <  [/path/]exptool.tar.gz  | tar xvf -
177</PRE>
178
179<a name="testtcltk"></a><H2>
180Is Tcl/Tk installed already?</H2>
181To test if Tcl/Tk is installed correctly on your system
182do the following commands. (Commands you type are in this <tt>typewriter</tt> 
183font, computer responses are this <tt><I>italic font</I></tt>.
184My comments are provided in this text font and are <U>underlined</U>).
185<UL>
186<TABLE>
187<TR><TD><tt>[tammy@beryl tammy]$ wish</tt></TD>
188<TD><U>(note a window is created)</U></TD></TR>
189<TR><TD><tt><I>%</I> set tcl_version</TD></TR>
190<TR><TD><tt><I>8.0</I></tt></TD>
191<TD><U>(8.0 is the Tcl/Tk version number. EXPGUI requires 8.0 or higher)</U></TD></TR>
192<TR><TD><tt><I>%</I> package require BLT</tt></TD></TR>
193<TR><TD><tt><I>2.4</I></tt></TD>
194<TD><U>(2.4 is the BLT package version number.
195EXPGUI requires 2.3 or higher.
196If you get "can't find package BLT" then
197BLT is not installed [properly] on your system)</U></TD></TR>
198<TR><TD><tt><I>%</I> blt::graph .g</tt></TD></TR>
199<TR><TD><tt><I>.g</I></tt></TD>
200<TD><U>(nothing happens. You should not get an error message here.)</U></TD></TR>
201<TR><TD><tt><I>%</I> pack .g</tt></TD>
202<TD><U>(now a graph is displayed)</U></TD></TR>
203<TR><TD><tt><I>%</I> Blt_ZoomStack .g</tt></TD>
204<TD><U>(if error message: invalid command name "Blt_ZoomStack" appears
205there is a problem with your BLT installation, see below.)</U></TD></TR>
206</TABLE>
207There is a common problem with the pkg_Index.tcl file in BLT that makes
208the Blt_ZoomStack command inaccessible, see my updated copy
209<A HREF="ftp://ftp.ncnr.nist.gov/pub/cryst/tcltk/BLT2.4_pkgIndex.tcl">
210ftp://ftp.ncnr.nist.gov/pub/cryst/tcltk/BLT2.4_pkgIndex.tcl
211</A> for an example that works. Also see the
212<A HREF="http://www.ncnr.nist.gov/programs/crystallography/software/tclpkgs82linux.html">
213Compiling Tcl/Tk 8.2.3 & packages for Linux</A> example of how to install.
214</UL>
215<P><H2>
216Acknowledgements</H2>
217<A Href="http://www.ncnr.nist.gov/programs/crystallography/software/gsas.html">
218GSAS</A>
219is written by Allen C. Larson and <A HREF="http://www.nist.gov/cgi-bin/exit_nist.cgi?url=http://lansce.lanl.gov/lujan/staff12/vondreele.htm">
220Robert B. Von Dreele</A>, MS-H805,
221Los Alamos National Laboratory, Los Alamos, NM 87545. Problems, questions
222or kudos concerning GSAS should be sent to Robert B. Von Dreele at
223<A HREF="MAILTO:vondreele@lanl.gov">vondreele@lanl.gov</A>
224
225<P>EXPGUI is written by Brian H. Toby of the NIST Center for Neutron Research,
226<A HREF="MAILTO:Brian.Toby@NIST.GOV">Brian.Toby@NIST.GOV</A> 
227with help from Jonathan Wasserman.
228<P>
229<hr><blockquote>
230GSAS is Copyright, 1984-1997, The Regents of the University of California.
231The GSAS software was produced under a U.S. Government contract (W-7405-ENG-36)
232by the Los Alamos National Laboratory, which is operated by the University
233of California for the U.S. Department of Energy. The U.S. Government is
234licensed to use, reproduce, and distribute this software. Permission is
235granted to the public to copy and use this software without charge, provided
236that this notice and any statement of authorship are reproduced on all
237copies. Neither the Government nor the University makes any warranty, express
238or implied, or assumes any liability or responsibility for the use of this
239software.
240
241<P>EXPGUI is not subject to copyright. Have fun with it.
242
243<p>Neither the U.S. Government nor any author makes any warranty,
244expressed or implied, or assumes any liability or responsibility
245for the use of this information or the software described
246here. Brand names cited here are used for
247identification purposes and do not consitute an endorsement by NIST.
248</blockquote>
249<hr>
250<TABLE BORDER BGCOLOR="#FFFF40" ALIGN=RIGHT>
251<TR><TH><A  Href="expgui.html">EXPGUI home</A> 
252</TH></TR></TABLE>
253<a href="http://www.ncnr.nist.gov/staff/toby/">Brian Toby</a> (<a href="mailto:brian.toby@nist.gov">Brian.Toby@NIST.GOV</a>)
254<br>
255$Revision: 514 $ $Date: 2009-12-04 23:07:26 +0000 (Fri, 04 Dec 2009) $
256</blockquote>
257</body>
258</html>
Note: See TracBrowser for help on using the repository browser.