| 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> |
|---|
| 8 | Note that root access is not required to load GSAS, Tcl/Tk and |
|---|
| 9 | EXPGUI. |
|---|
| 10 | |
|---|
| 11 | <H2>0. Prerequisites</H2> |
|---|
| 12 | |
|---|
| 13 | I will assume that you already have the Tcl/Tk package loaded on your computer. If this |
|---|
| 14 | is not true, please see |
|---|
| 15 | <A HREF="http://rrdjazz.nist.gov/~toby/tclpkgs.html"> |
|---|
| 16 | http://rrdjazz.nist.gov/~toby/tclpkgs.html |
|---|
| 17 | </A> for installation instructions. |
|---|
| 18 | Likewise, I will assume you have also loaded the appropriate GSAS release, if not see |
|---|
| 19 | <A HREF="http://rrdjazz.nist.gov/~toby/unixgsas.html"> |
|---|
| 20 | http://rrdjazz.nist.gov/~toby/unixgsas.html |
|---|
| 21 | </A> for installation instructions. |
|---|
| 22 | |
|---|
| 23 | <H2> |
|---|
| 24 | 1. EXPGUI Downloading</H2> |
|---|
| 25 | download file |
|---|
| 26 | <A HREF="ftp://rrdjazz.nist.gov/bt1/gsas/expgui.tar.gz"> |
|---|
| 27 | ftp://rrdjazz.nist.gov/bt1/gsas/expgui.tar.gz</A> (? K) |
|---|
| 28 | by shift-clicking on the previous link. |
|---|
| 29 | <H2> |
|---|
| 30 | 2. EXPGUI Installation</H2> |
|---|
| 31 | A few short steps are needed to load EXPGUI on your computer. |
|---|
| 32 | <H4> |
|---|
| 33 | 2.1 Create a directory and restore the files</H4> |
|---|
| 34 | The EXPGUI scripts are set up to be run from a <B>subdirectory in the main GSAS |
|---|
| 35 | directory</B>, by convention I assume the directory name <tt>tcl</tt>, but this is |
|---|
| 36 | not required. Thus if you have located the GSAS package in |
|---|
| 37 | <TT>/usr/local/gsas</TT> (so that there is a directory |
|---|
| 38 | <TT>/usr/local/gsas/exe</TT>, <TT>/usr/local/gsas/data</TT>, ...) |
|---|
| 39 | I assume you will put |
|---|
| 40 | these files in <TT>/usr/local/gsas/tcl</TT> but any subdirectory, |
|---|
| 41 | such as <TT>/usr/local/gsas/expgui</TT> will work fine. |
|---|
| 42 | Change the first <TT>cd</TT> command if GSAS is located somewhere |
|---|
| 43 | other than <TT>/usr/local/gsas</TT>. |
|---|
| 44 | |
|---|
| 45 | <PRE> |
|---|
| 46 | cd /usr/local/gsas |
|---|
| 47 | mkdir tcl |
|---|
| 48 | cd tcl |
|---|
| 49 | gunzip < [/path]expgui.tar.gz | tar xvf - |
|---|
| 50 | </PRE> |
|---|
| 51 | <P>When restoring the GSAS files from the tar file, |
|---|
| 52 | note that <TT>[/path]</TT> in the example above indicates the location |
|---|
| 53 | where you downloaded the tar file in section 2, above. |
|---|
| 54 | |
|---|
| 55 | <H4> |
|---|
| 56 | 2.2a Installing a shortcut to EXPGUI in .cshrc</H4> |
|---|
| 57 | <P>To use EXPGUI, you need to create an easy way to access it. |
|---|
| 58 | One way to do this is to add an alias to your ~/.cshrc file: |
|---|
| 59 | <PRE> |
|---|
| 60 | cat >> ~/.cshrc |
|---|
| 61 | alias expgui "wish /usr/local/gsas/tcl/expgui" |
|---|
| 62 | ^D |
|---|
| 63 | </PRE> |
|---|
| 64 | <H4> |
|---|
| 65 | 2.2b Installing EXPGUI in the path</H4> |
|---|
| 66 | <P> |
|---|
| 67 | Another way to simplify access to EXPGUI |
|---|
| 68 | is to create a file which will execute the GUI script from |
|---|
| 69 | a command in your system's path, for example <TT>/usr/bin</TT>. |
|---|
| 70 | <PRE> |
|---|
| 71 | cat > /usr/bin/expgui |
|---|
| 72 | wish /usr/local/gsas/tcl/expgui |
|---|
| 73 | ^D |
|---|
| 74 | chmod +x /usr/bin/expgui |
|---|
| 75 | </PRE> |
|---|
| 76 | Note that in the above commands ^D means control-D. |
|---|
| 77 | <hr> |
|---|
| 78 | GSAS is written by Allen C. Larson and Robert B. Von Dreele, MS-H805, |
|---|
| 79 | Los Alamos National Laboratory, Los Alamos, NM 87545. Problems, questions |
|---|
| 80 | or kudos concerning GSAS should be sent to Robert B. Von Dreele at |
|---|
| 81 | <A HREF="MAILTO:vondreele@lanl.gov">vondreele@lanl.gov</A> |
|---|
| 82 | <P>GSAS is Copyright, 1984-1997, The Regents of the University of California. |
|---|
| 83 | The GSAS software was produced under a U.S. Government contract (W-7405-ENG-36) |
|---|
| 84 | by the Los Alamos National Laboratory, which is operated by the University |
|---|
| 85 | of California for the U.S. Department of Energy. The U.S. Government is |
|---|
| 86 | licensed to use, reproduce, and distribute this software. Permission is |
|---|
| 87 | granted to the public to copy and use this software without charge, provided |
|---|
| 88 | that this notice and any statement of authorship are reproduced on all |
|---|
| 89 | copies. Neither the Government nor the University makes any warranty, express |
|---|
| 90 | or implied, or assumes any liability or responsibility for the use of this |
|---|
| 91 | software. |
|---|
| 92 | <P>EXPGUI is written by Brian H. Toby of the NIST Center for Neutron Research, |
|---|
| 93 | <A HREF="MAILTO:Brian.Toby@NIST.GOV">Brian.Toby@NIST.GOV</A> |
|---|
| 94 | with help from Jonathan Wasserman. |
|---|
| 95 | |
|---|
| 96 | <P>EXPGUI is not subject to copyright. Have fun with it. |
|---|
| 97 | |
|---|
| 98 | <p>Neither the U.S. Government nor any author makes any warranty, |
|---|
| 99 | expressed or implied, or assumes any liability or responsibility |
|---|
| 100 | for the use of this information or the software described |
|---|
| 101 | here. Brand names cited here are used for |
|---|
| 102 | identification purposes and do not consitute an endorsement by NIST. |
|---|
| 103 | |
|---|
| 104 | <p><a href="http://rrdjazz.nist.gov/~toby/">Brian Toby</a> (<a href="mailto:brian.toby@nist.gov">Brian.Toby@NIST.GOV</a>) |
|---|
| 105 | <br> |
|---|
| 106 | $Revision: 33 $ $Date: 2009-12-04 22:59:15 +0000 (Fri, 04 Dec 2009) $ |
|---|
| 107 | </body> |
|---|
| 108 | </html> |
|---|
