source: trunk/doc/expgui_Unix_readme.html @ 106

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

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