source: trunk/doc/expgui_Unix_readme.html @ 465

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

# on 2001/09/25 23:20:06, toby did:
old GSAS warning
new EXPTOOL

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