source: trunk/doc/expgui_Unix_readme.html @ 439

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

# on 2000/12/22 21:14:32, toby did:
Tcl/Tk? test section revised

  • Property rcs:author set to toby
  • Property rcs:date set to 2000/12/22 21:14:32
  • Property rcs:lines set to +5 -3
  • Property rcs:rev set to 1.13
  • Property rcs:state set to Exp
  • Property svn:keywords set to Author Date Revision Id
File size: 10.4 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.
50
51<P>More information about EXPGUI, including information on how it
52can be customized, can be found on web pages <A HREF="expgui.html">expgui.html</A>
53and <A HREF="expgui_cfg.html">expgui_cfg.html</A>, found in the gsas/expgui/doc directory.
54
55<H2>
561. EXPGUI Downloading</H2>
57download file
58<A HREF="ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/expgui.tar.gz">
59ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/expgui.tar.gz</A> (~300 K)
60by shift-clicking on the previous link.
61<P>
62If you want to try the latest release (which may not have gotten
63a lot of testing, but probably has new bug fixes and capabilities) shift-click
64on <A HREF="ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/expgui_ALPHA.tar.gz">
65ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/expgui_ALPHA.tar.gz</A>
66<P>
67If you are using an older version of GSAS (before April, 2000) you may
68want to download the TCLDUMP program to speed and enhance liveplot and the
69EXPTOOL program which allows EXPGUI to add phases, histograms and atoms
70to .EXP files. More recent versions of GSAS include these programs in the
71distributions.
72<UL>
73<LI>LINUX: <BR>
74<A HREF="ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/exe_linux/tcldump.tar.gz">
75ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/exe_linux/tcldump.tar.gz</A> (~65 K)
76<BR>
77<A HREF="ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/exe_linux/exptool.tar.gz">
78ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/exe_linux/exptool.tar.gz</A> (~292 K)
79</LI><P>
80or
81<P>
82<LI>Silicon Graphics: <BR>
83<A HREF="ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/exe_sgi/tcldump.tar.gz">
84ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/exe_sgi/tcldump.tar.gz</A> (~45 K)
85<BR>
86<A HREF="ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/exe_sgi/exptool.tar.gz">
87ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/exe_sgi/exptool.tar.gz</A> (~377 K)
88</UL>Transfer the files by shift-clicking on the appropriate links.
89<H2>
902. EXPGUI Installation</H2>
91A few short steps are needed to load EXPGUI on your computer.
92<H3>
932.1 Create a directory and restore the files</H3>
94The EXPGUI scripts are set up to be run from a <B>subdirectory in the main GSAS
95directory</B>, by convention I assume the directory name <tt>expgui</tt>, but this is
96not required. Thus, if you have located the GSAS package in
97<TT>/usr/local/gsas</TT> (so that there is a directory
98<TT>/usr/local/gsas/exe</TT>, <TT>/usr/local/gsas/data</TT>, ...)
99I assume you will put
100these files in <TT>/usr/local/gsas/expgui</TT> but any subdirectory,
101such as <TT>/usr/local/gsas/tcl</TT> will work fine.
102Change the subsequent commands if GSAS is located somewhere
103other than <TT>/usr/local/gsas</TT>.
104
105<PRE>
106            cd    /usr/local/gsas
107            mkdir expgui
108            cd    expgui
109            gunzip <  [/path/]expgui.tar.gz  | tar xvf -
110</PRE>
111<P>When restoring the GSAS files from the tar file,
112note that <TT>[/path/]</TT> in the example above indicates the location
113where you downloaded the tar file in section 2, above.
114
115<H3>
1162.2 Installing a shortcut to EXPGUI</H3>
117While it is possible to invoke EXPGUI by typing
118<PRE>
119                wish /usr/local/gsas/expgui/expgui
120</PRE>
121or
122<PRE>
123                /home/toby/mywish/wish /home/toby/mygsas/expgui/expgui
124</PRE>
125or whatever, you will likely want to create an easier command to type.
126Below are three ways to do this. Note that only one is needed. Do not use all
127three.
128
129<em>Also, note that in the commands below,
130</em><TT>^D</TT><em> means control-D.</em>
131
132
133<UL><H4>
1342.2a Installing a shortcut to EXPGUI in .cshrc</H4>
135<P>To use EXPGUI, you probably need to create an easy way to access it.
136One way to do this is to add an alias to your ~/.cshrc file:
137<PRE>
138                cat >> ~/.cshrc
139                alias expgui "wish /usr/local/gsas/expgui/expgui"
140                ^D
141</PRE>
142<H4>
1432.2b Installing EXPGUI in the path</H4>
144<P>
145Another way to simplify access to EXPGUI
146is to create a file which will execute the GUI script from
147a command in your system's path, for example <TT>/usr/bin</TT>.
148<PRE>
149                cat > /usr/bin/expgui
150                wish /usr/local/gsas/expgui/expgui
151                ^D
152                chmod +x /usr/bin/expgui
153</PRE>
154<I>Note that this step (2.2b) is incompatible with the one below (2.2c).</I>
155<H4>
1562.2c Linking EXPGUI in the path</H4>
157<P>
158Another way to simplify access to EXPGUI
159is to create a link in your system's path to the GUI script.
160Note that you may need to modify the first line of
161<TT>/usr/local/gsas/expgui/expgui</TT>, if wish is located somewhere
162other than <TT>/usr/local/bin/wish</TT>.
163
164<PRE>
165                chmod +x /usr/local/gsas/expgui/expgui
166                ln -s /usr/local/gsas/expgui/expgui /usr/bin/expgui
167</PRE>
168<I>Note that this step (2.2c) is incompatible with the one above (2.2b).</I>
169</UL>
170<H3>
1712.3 Installing TCLDUMP</H3>
172If not already present, the TCLDUMP program should be located with all of the GSAS executable files, for example in /usr/local/gsas/exe/.
173<PRE>
174            cd    /usr/local/gsas/exe
175            gunzip <  [/path/]tcldump.tar.gz  | tar xvf -
176</PRE>
177
178<H3>
1792.4 Installing EXPTOOL</H3>
180If not already present, the EXPTOOL program should be located with all of the GSAS executable files,
181for example in /usr/local/gsas/exe/.
182<PRE>
183            cd    /usr/local/gsas/exe
184            gunzip <  [/path/]exptool.tar.gz  | tar xvf -
185</PRE>
186
187<a name="testtcltk"></a><H2>
188Is Tcl/Tk installed already?</H2>
189To test if Tcl/Tk is installed correctly on your system
190do the following commands. (Commands you type are in this <tt>typewriter</tt> 
191font, computer responses are this <tt><I>italic font</I></tt>.
192My comments are provided in this text font and are <U>underlined</U>).
193<UL>
194<TABLE>
195<TR><TD><tt>[tammy@beryl tammy]$ wish</tt></TD>
196<TD><U>(note a window is created)</U></TD></TR>
197<TR><TD><tt><I>%</I> set tcl_version</TD></TR>
198<TR><TD><tt><I>8.0</I></tt></TD>
199<TD><U>(8.0 is the Tcl/Tk version number. EXPGUI requires 8.0 or higher)</U></TD></TR>
200<TR><TD><tt><I>%</I> package require BLT</tt></TD></TR>
201<TR><TD><tt><I>2.4</I></tt></TD>
202<TD><U>(2.4 is the BLT package version number.
203EXPGUI requires 2.3 or higher.
204If you get "can't find package BLT" then
205BLT is not installed [properly] on your system)</U></TD></TR>
206<TR><TD><tt><I>%</I> blt::graph .g</tt></TD></TR>
207<TR><TD><tt><I>.g</I></tt></TD>
208<TD><U>(nothing happens. You should not get an error message here.)</U></TD></TR>
209<TR><TD><tt><I>%</I> pack .g</tt></TD>
210<TD><U>(now a graph is displayed)</U></TD></TR>
211<TR><TD><tt><I>%</I> Blt_ZoomStack .g</tt></TD>
212<TD><U>(if error message: invalid command name "Blt_ZoomStack" appears
213there is a problem with your BLT installation, see below.)</U></TD></TR>
214</TABLE>
215There is a common problem with the pkg_Index.tcl file in BLT that makes
216the Blt_ZoomStack command inaccessible, see my updated copy
217<A HREF="ftp://ftp.ncnr.nist.gov/pub/cryst/tcltk/BLT2.4_pkgIndex.tcl">
218ftp://ftp.ncnr.nist.gov/pub/cryst/tcltk/BLT2.4_pkgIndex.tcl
219</A> for an example that works. Also see the
220<A HREF="http://www.ncnr.nist.gov/programs/crystallography/software/tclpkgs82linux.html">
221Compiling Tcl/Tk 8.2.3 & packages for Linux</A> example of how to install.
222</UL>
223<hr>
224<A Href="http://www.ncnr.nist.gov/programs/crystallography/software/gsas.html">
225GSAS</A>
226is 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">
227Robert B. Von Dreele</A>, MS-H805,
228Los Alamos National Laboratory, Los Alamos, NM 87545. Problems, questions
229or kudos concerning GSAS should be sent to Robert B. Von Dreele at
230<A HREF="MAILTO:vondreele@lanl.gov">vondreele@lanl.gov</A>
231<P>GSAS is Copyright, 1984-1997, The Regents of the University of California.
232The GSAS software was produced under a U.S. Government contract (W-7405-ENG-36)
233by the Los Alamos National Laboratory, which is operated by the University
234of California for the U.S. Department of Energy. The U.S. Government is
235licensed to use, reproduce, and distribute this software. Permission is
236granted to the public to copy and use this software without charge, provided
237that this notice and any statement of authorship are reproduced on all
238copies. Neither the Government nor the University makes any warranty, express
239or implied, or assumes any liability or responsibility for the use of this
240software.
241<P>EXPGUI is written by Brian H. Toby of the NIST Center for Neutron Research,
242<A HREF="MAILTO:Brian.Toby@NIST.GOV">Brian.Toby@NIST.GOV</A> 
243with help from Jonathan Wasserman.
244
245<P>EXPGUI is not subject to copyright. Have fun with it.
246
247<p>Neither the U.S. Government nor any author makes any warranty,
248expressed or implied, or assumes any liability or responsibility
249for the use of this information or the software described
250here. Brand names cited here are used for
251identification purposes and do not consitute an endorsement by NIST.
252
253<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>)
254<br>
255$Revision: 366 $ $Date: 2009-12-04 23:04:58 +0000 (Fri, 04 Dec 2009) $
256</body>
257</html>
Note: See TracBrowser for help on using the repository browser.