source: trunk/doc/expgui_Unix_readme.html @ 50

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

# on 1999/01/20 21:34:54, toby did:
* empty log message *
  • Property rcs:author set to toby
  • Property rcs:date set to 1999/01/20 21:34:54
  • Property rcs:lines set to +23 -5
  • Property rcs:rev set to 1.2
  • Property rcs:state set to Exp
  • Property svn:keywords set to Author Date Revision Id
File size: 5.1 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://rrdjazz.nist.gov/~toby/tclpkgs.html">
16http://rrdjazz.nist.gov/~toby/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://rrdjazz.nist.gov/~toby/unixgsas.html">
20http://rrdjazz.nist.gov/~toby/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="http://rrdjazz.nist.gov/~toby/expgui/expgui.html">expgui.html</A>
25and <A HREF="http://rrdjazz.nist.gov/~toby/expgui/expgui_cfg.html">expgui_cfg.html</A>, found in the gsas/tcl/doc directory.
26
27<H2>
281. EXPGUI Downloading</H2>
29download file
30<A HREF="ftp://rrdjazz.nist.gov/bt1/gsas/expgui.tar.gz">
31ftp://rrdjazz.nist.gov/bt1/gsas/expgui.tar.gz</A> (~300 K)
32by shift-clicking on the previous link.
33<H2>
342. EXPGUI Installation</H2>
35A few short steps are needed to load EXPGUI on your computer.
36<H4>
372.1 Create a directory and restore the files</H4>
38The EXPGUI scripts are set up to be run from a <B>subdirectory in the main GSAS
39directory</B>, by convention I assume the directory name <tt>tcl</tt>, but this is
40not required. Thus, if you have located the GSAS package in
41<TT>/usr/local/gsas</TT> (so that there is a directory
42<TT>/usr/local/gsas/exe</TT>, <TT>/usr/local/gsas/data</TT>, ...)
43I assume you will put
44these files in <TT>/usr/local/gsas/tcl</TT> but any subdirectory,
45such as <TT>/usr/local/gsas/expgui</TT> will work fine.
46Change the subsequent commands if GSAS is located somewhere
47other than <TT>/usr/local/gsas</TT>.
48
49<PRE>
50            cd    /usr/local/gsas
51            mkdir tcl
52            cd    tcl
53            gunzip <  [/path]expgui.tar.gz  | tar xvf -
54</PRE>
55<P>When restoring the GSAS files from the tar file,
56note that <TT>[/path]</TT> in the example above indicates the location
57where you downloaded the tar file in section 2, above.
58
59<H4>
602.2a Installing a shortcut to EXPGUI in .cshrc</H4>
61<P>To use EXPGUI, you probably need to create an easy way to access it.
62One way to do this is to add an alias to your ~/.cshrc file:
63<PRE>
64                cat >> ~/.cshrc
65                alias expgui "wish /usr/local/gsas/tcl/expgui"
66                ^D
67</PRE>
68<H4>
692.2b Installing EXPGUI in the path</H4>
70<P>
71Another way to simplify access to EXPGUI
72is to create a file which will execute the GUI script from
73a command in your system's path, for example <TT>/usr/bin</TT>.
74<PRE>
75                cat > /usr/bin/expgui
76                wish /usr/local/gsas/tcl/expgui
77                ^D
78                chmod +x /usr/bin/expgui
79</PRE>
80<H4>
812.2c Linking EXPGUI in the path</H4>
82<P>
83Another way to simplify access to EXPGUI
84is to create a link in your system's path to the GUI script.
85Note that you may need to modify the first line of
86<TT>/usr/local/gsas/tcl/expgui</TT>, if wish is located somewhere
87other than <TT>/usr/local/bin/wish</TT>.
88
89<PRE>
90                chmod +x /usr/local/gsas/tcl/expgui
91                ln -s /usr/local/gsas/tcl/expgui /usr/bin/expgui
92</PRE>
93
94<em>Note that in the above commands </em><TT>^D</TT><em> means control-D.</em>
95<hr>
96GSAS is written by Allen C. Larson and Robert B. Von Dreele,  MS-H805,
97Los Alamos National Laboratory, Los Alamos, NM 87545. Problems, questions
98or kudos concerning GSAS should be sent to Robert B. Von Dreele at
99<A HREF="MAILTO:vondreele@lanl.gov">vondreele@lanl.gov</A>
100<P>GSAS is Copyright, 1984-1997, The Regents of the University of California.
101The GSAS software was produced under a U.S. Government contract (W-7405-ENG-36)
102by the Los Alamos National Laboratory, which is operated by the University
103of California for the U.S. Department of Energy. The U.S. Government is
104licensed to use, reproduce, and distribute this software. Permission is
105granted to the public to copy and use this software without charge, provided
106that this notice and any statement of authorship are reproduced on all
107copies. Neither the Government nor the University makes any warranty, express
108or implied, or assumes any liability or responsibility for the use of this
109software.
110<P>EXPGUI is written by Brian H. Toby of the NIST Center for Neutron Research,
111<A HREF="MAILTO:Brian.Toby@NIST.GOV">Brian.Toby@NIST.GOV</A> 
112with help from Jonathan Wasserman.
113
114<P>EXPGUI is not subject to copyright. Have fun with it.
115
116<p>Neither the U.S. Government nor any author makes any warranty,
117expressed or implied, or assumes any liability or responsibility
118for the use of this information or the software described
119here. Brand names cited here are used for
120identification purposes and do not consitute an endorsement by NIST.
121
122<p><a href="http://rrdjazz.nist.gov/~toby/">Brian Toby</a> (<a href="mailto:brian.toby@nist.gov">Brian.Toby@NIST.GOV</a>)
123<br>
124$Revision: 38 $ $Date: 2009-12-04 22:59:20 +0000 (Fri, 04 Dec 2009) $
125</body>
126</html>
Note: See TracBrowser for help on using the repository browser.