source: trunk/doc/expgui_Unix_readme.html @ 141

Last change on this file since 141 was 141, checked in by toby, 14 years ago

# on 2000/05/17 20:11:07, toby did:
cleanup & update
  • Property rcs:author set to toby
  • Property rcs:date set to 2000/05/17 20:11:07
  • Property rcs:lines set to +27 -9
  • Property rcs:rev set to 1.7
  • Property rcs:state set to Exp
  • Property svn:keywords set to Author Date Revision Id
File size: 7.6 KB
Line 
1<HTML>
2<HEAD>
3   <META NAME="Author" CONTENT="Brian H. Toby">
4   <TITLE>Installation notes for EXPGUI in Unix</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
16<CENTER><H1>
17UNIX Installation notes for GSAS with
18<A HREF="expgui.html">
19EXPGUI
20</A>
21</H1></CENTER>
22Note that root access is not required to load GSAS, Tcl/Tk and
23EXPGUI.
24
25<H2>0. Prerequisites</H2>
26
27I will assume that you already have the Tcl/Tk package loaded on your computer. If this
28is not true, please see
29<A HREF="http://www.ncnr.nist.gov/programs/crystallography/software/tclpkgs.html">
30http://www.ncnr.nist.gov/programs/crystallography/software/tclpkgs.html
31</A> for installation instructions. Please note that EXPGUI seems to run very
32slowly in Tcl/Tk version 8.1, but OK in 8.0 and 8.2.
33<P>
34Likewise, I will assume you have also loaded the appropriate GSAS release, if not see
35<A HREF="http://www.ncnr.nist.gov/programs/crystallography/software/unixgsas.html">
36http://www.ncnr.nist.gov/programs/crystallography/software/unixgsas.html
37</A> for installation instructions.
38
39<P>More information about EXPGUI, including information on how it
40can be customized, can be found on web pages <A HREF="expgui.html">expgui.html</A>
41and <A HREF="expgui_cfg.html">expgui_cfg.html</A>, found in the gsas/expgui/doc directory.
42
43<H2>
441. EXPGUI Downloading</H2>
45download file
46<A HREF="ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/expgui.tar.gz">
47ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/expgui.tar.gz</A> (~300 K)
48by shift-clicking on the previous link.
49<P>
50If you want to try the latest release (which may not have gotten
51a lot of testing, but probably has new bug fixes and capabilities) shift-click
52on <A HREF="ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/expgui_ALPHA.tar.gz">
53ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/expgui_ALPHA.tar.gz</A>
54<P>
55If you are using an older version of GSAS (before April, 2000) you may
56want to download the TCLDUMP program to speed and enhance liveplot and the
57EXPTOOL program which allows EXPGUI to add phases, histograms and atoms
58to .EXP files. More recent versions of GSAS include these programs in the
59distributions.
60<UL>
61<LI>LINUX: <BR>
62<A HREF="ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/exe_linux/tcldump.tar.gz">
63ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/exe_linux/tcldump.tar.gz</A> (~65 K)
64<BR>
65<A HREF="ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/exe_linux/exptool.tar.gz">
66ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/exe_linux/exptool.tar.gz</A> (~292 K)
67</LI><P>
68or
69<P>
70<LI>Silicon Graphics: <BR>
71<A HREF="ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/exe_sgi/tcldump.tar.gz">
72ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/exe_sgi/tcldump.tar.gz</A> (~45 K)
73<BR>
74<A HREF="ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/exe_sgi/exptool.tar.gz">
75ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/exe_sgi/exptool.tar.gz</A> (~377 K)
76</UL>Transfer the files by shift-clicking on the appropriate links.
77<H2>
782. EXPGUI Installation</H2>
79A few short steps are needed to load EXPGUI on your computer.
80<H4>
812.1 Create a directory and restore the files</H4>
82The EXPGUI scripts are set up to be run from a <B>subdirectory in the main GSAS
83directory</B>, by convention I assume the directory name <tt>expgui</tt>, but this is
84not required. Thus, if you have located the GSAS package in
85<TT>/usr/local/gsas</TT> (so that there is a directory
86<TT>/usr/local/gsas/exe</TT>, <TT>/usr/local/gsas/data</TT>, ...)
87I assume you will put
88these files in <TT>/usr/local/gsas/expgui</TT> but any subdirectory,
89such as <TT>/usr/local/gsas/tcl</TT> will work fine.
90Change the subsequent commands if GSAS is located somewhere
91other than <TT>/usr/local/gsas</TT>.
92
93<PRE>
94            cd    /usr/local/gsas
95            mkdir expgui
96            cd    expgui
97            gunzip <  [/path/]expgui.tar.gz  | tar xvf -
98</PRE>
99<P>When restoring the GSAS files from the tar file,
100note that <TT>[/path/]</TT> in the example above indicates the location
101where you downloaded the tar file in section 2, above.
102
103<H4>
1042.2a Installing a shortcut to EXPGUI in .cshrc</H4>
105<P>To use EXPGUI, you probably need to create an easy way to access it.
106One way to do this is to add an alias to your ~/.cshrc file:
107<PRE>
108                cat >> ~/.cshrc
109                alias expgui "wish /usr/local/gsas/expgui/expgui"
110                ^D
111</PRE>
112<H4>
1132.2b Installing EXPGUI in the path</H4>
114<P>
115Another way to simplify access to EXPGUI
116is to create a file which will execute the GUI script from
117a command in your system's path, for example <TT>/usr/bin</TT>.
118<PRE>
119                cat > /usr/bin/expgui
120                wish /usr/local/gsas/expgui/expgui
121                ^D
122                chmod +x /usr/bin/expgui
123</PRE>
124<H4>
1252.2c Linking EXPGUI in the path</H4>
126<P>
127Another way to simplify access to EXPGUI
128is to create a link in your system's path to the GUI script.
129Note that you may need to modify the first line of
130<TT>/usr/local/gsas/expgui/expgui</TT>, if wish is located somewhere
131other than <TT>/usr/local/bin/wish</TT>.
132
133<PRE>
134                chmod +x /usr/local/gsas/expgui/expgui
135                ln -s /usr/local/gsas/expgui/expgui /usr/bin/expgui
136</PRE>
137
138<em>Note that in the above commands </em><TT>^D</TT><em> means control-D.</em>
139
140<H4>
1412.3 Installing TCLDUMP</H4>
142If not already present, the TCLDUMP program should be located with all of the GSAS executable files, for example in /usr/local/gsas/exe/.
143<PRE>
144            cd    /usr/local/gsas/exe
145            gunzip <  [/path/]tcldump.tar.gz  | tar xvf -
146</PRE>
147
148<H4>
1492.4 Installing EXPTOOL</H4>
150If not already present, the EXPTOOL program should be located with all of the GSAS executable files,
151for example in /usr/local/gsas/exe/.
152<PRE>
153            cd    /usr/local/gsas/exe
154            gunzip <  [/path/]exptool.tar.gz  | tar xvf -
155</PRE>
156
157<hr>
158GSAS is 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">
159Robert B. Von Dreele</A>, MS-H805,
160Los Alamos National Laboratory, Los Alamos, NM 87545. Problems, questions
161or kudos concerning GSAS should be sent to Robert B. Von Dreele at
162<A HREF="MAILTO:vondreele@lanl.gov">vondreele@lanl.gov</A>
163<P>GSAS is Copyright, 1984-1997, The Regents of the University of California.
164The GSAS software was produced under a U.S. Government contract (W-7405-ENG-36)
165by the Los Alamos National Laboratory, which is operated by the University
166of California for the U.S. Department of Energy. The U.S. Government is
167licensed to use, reproduce, and distribute this software. Permission is
168granted to the public to copy and use this software without charge, provided
169that this notice and any statement of authorship are reproduced on all
170copies. Neither the Government nor the University makes any warranty, express
171or implied, or assumes any liability or responsibility for the use of this
172software.
173<P>EXPGUI is written by Brian H. Toby of the NIST Center for Neutron Research,
174<A HREF="MAILTO:Brian.Toby@NIST.GOV">Brian.Toby@NIST.GOV</A> 
175with help from Jonathan Wasserman.
176
177<P>EXPGUI is not subject to copyright. Have fun with it.
178
179<p>Neither the U.S. Government nor any author makes any warranty,
180expressed or implied, or assumes any liability or responsibility
181for the use of this information or the software described
182here. Brand names cited here are used for
183identification purposes and do not consitute an endorsement by NIST.
184
185<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>)
186<br>
187$Revision: 141 $ $Date: 2009-12-04 23:01:05 +0000 (Fri, 04 Dec 2009) $
188</body>
189</html>
Note: See TracBrowser for help on using the repository browser.