source: trunk/doc/expgui_Unix_readme.html @ 548

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

# on 2002/01/23 19:59:22, toby did:
reference the RPM file
cleanup font use

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