source: trunk/doc/expgui_Unix_readme.html @ 242

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

# on 2000/07/28 20:15:14, toby did:
pretty it up
  • Property rcs:author set to toby
  • Property rcs:date set to 2000/07/28 20:15:14
  • Property rcs:lines set to +8 -4
  • Property rcs:rev set to 1.9
  • Property rcs:state set to Exp
  • Property svn:keywords set to Author Date Revision Id
File size: 8.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
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.
43<P>
44Likewise, I will assume you have also loaded the appropriate GSAS release, if not see
45<A HREF="http://www.ncnr.nist.gov/programs/crystallography/software/unixgsas.html">
46http://www.ncnr.nist.gov/programs/crystallography/software/unixgsas.html
47</A> for installation instructions.
48
49<P>More information about EXPGUI, including information on how it
50can be customized, can be found on web pages <A HREF="expgui.html">expgui.html</A>
51and <A HREF="expgui_cfg.html">expgui_cfg.html</A>, found in the gsas/expgui/doc directory.
52
53<H2>
541. EXPGUI Downloading</H2>
55download file
56<A HREF="ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/expgui.tar.gz">
57ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/expgui.tar.gz</A> (~300 K)
58by shift-clicking on the previous link.
59<P>
60If you want to try the latest release (which may not have gotten
61a lot of testing, but probably has new bug fixes and capabilities) shift-click
62on <A HREF="ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/expgui_ALPHA.tar.gz">
63ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/expgui_ALPHA.tar.gz</A>
64<P>
65If you are using an older version of GSAS (before April, 2000) you may
66want to download the TCLDUMP program to speed and enhance liveplot and the
67EXPTOOL program which allows EXPGUI to add phases, histograms and atoms
68to .EXP files. More recent versions of GSAS include these programs in the
69distributions.
70<UL>
71<LI>LINUX: <BR>
72<A HREF="ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/exe_linux/tcldump.tar.gz">
73ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/exe_linux/tcldump.tar.gz</A> (~65 K)
74<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> (~292 K)
77</LI><P>
78or
79<P>
80<LI>Silicon Graphics: <BR>
81<A HREF="ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/exe_sgi/tcldump.tar.gz">
82ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/exe_sgi/tcldump.tar.gz</A> (~45 K)
83<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> (~377 K)
86</UL>Transfer the files by shift-clicking on the appropriate links.
87<H2>
882. EXPGUI Installation</H2>
89A few short steps are needed to load EXPGUI on your computer.
90<H4>
912.1 Create a directory and restore the files</H4>
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<H4>
1142.2a Installing a shortcut to EXPGUI in .cshrc</H4>
115<P>To use EXPGUI, you probably need to create an easy way to access it.
116One way to do this is to add an alias to your ~/.cshrc file:
117<PRE>
118                cat >> ~/.cshrc
119                alias expgui "wish /usr/local/gsas/expgui/expgui"
120                ^D
121</PRE>
122<H4>
1232.2b Installing EXPGUI in the path</H4>
124<P>
125Another way to simplify access to EXPGUI
126is to create a file which will execute the GUI script from
127a command in your system's path, for example <TT>/usr/bin</TT>.
128<PRE>
129                cat > /usr/bin/expgui
130                wish /usr/local/gsas/expgui/expgui
131                ^D
132                chmod +x /usr/bin/expgui
133</PRE>
134<H4>
1352.2c Linking EXPGUI in the path</H4>
136<P>
137Another way to simplify access to EXPGUI
138is to create a link in your system's path to the GUI script.
139Note that you may need to modify the first line of
140<TT>/usr/local/gsas/expgui/expgui</TT>, if wish is located somewhere
141other than <TT>/usr/local/bin/wish</TT>.
142
143<PRE>
144                chmod +x /usr/local/gsas/expgui/expgui
145                ln -s /usr/local/gsas/expgui/expgui /usr/bin/expgui
146</PRE>
147
148<em>Note that in the above commands </em><TT>^D</TT><em> means control-D.</em>
149
150<H4>
1512.3 Installing TCLDUMP</H4>
152If not already present, the TCLDUMP program should be located with all of the GSAS executable files, for example in /usr/local/gsas/exe/.
153<PRE>
154            cd    /usr/local/gsas/exe
155            gunzip <  [/path/]tcldump.tar.gz  | tar xvf -
156</PRE>
157
158<H4>
1592.4 Installing EXPTOOL</H4>
160If not already present, the EXPTOOL program should be located with all of the GSAS executable files,
161for example in /usr/local/gsas/exe/.
162<PRE>
163            cd    /usr/local/gsas/exe
164            gunzip <  [/path/]exptool.tar.gz  | tar xvf -
165</PRE>
166
167<hr>
168<A Href="http://www.ncnr.nist.gov/programs/crystallography/software/gsas.html">
169GSAS</A>
170is 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">
171Robert B. Von Dreele</A>, MS-H805,
172Los Alamos National Laboratory, Los Alamos, NM 87545. Problems, questions
173or kudos concerning GSAS should be sent to Robert B. Von Dreele at
174<A HREF="MAILTO:vondreele@lanl.gov">vondreele@lanl.gov</A>
175<P>GSAS is Copyright, 1984-1997, The Regents of the University of California.
176The GSAS software was produced under a U.S. Government contract (W-7405-ENG-36)
177by the Los Alamos National Laboratory, which is operated by the University
178of California for the U.S. Department of Energy. The U.S. Government is
179licensed to use, reproduce, and distribute this software. Permission is
180granted to the public to copy and use this software without charge, provided
181that this notice and any statement of authorship are reproduced on all
182copies. Neither the Government nor the University makes any warranty, express
183or implied, or assumes any liability or responsibility for the use of this
184software.
185<P>EXPGUI is written by Brian H. Toby of the NIST Center for Neutron Research,
186<A HREF="MAILTO:Brian.Toby@NIST.GOV">Brian.Toby@NIST.GOV</A> 
187with help from Jonathan Wasserman.
188
189<P>EXPGUI is not subject to copyright. Have fun with it.
190
191<p>Neither the U.S. Government nor any author makes any warranty,
192expressed or implied, or assumes any liability or responsibility
193for the use of this information or the software described
194here. Brand names cited here are used for
195identification purposes and do not consitute an endorsement by NIST.
196
197<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>)
198<br>
199$Revision: 242 $ $Date: 2009-12-04 23:02:46 +0000 (Fri, 04 Dec 2009) $
200</body>
201</html>
Note: See TracBrowser for help on using the repository browser.