source: trunk/doc/expgui_Unix_readme.html @ 213

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

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