[33] | 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 |
---|
[106] | 15 | <A HREF="http://www.ncnr.nist.gov/programs/crystallography/software/tclpkgs.html"> |
---|
| 16 | http://www.ncnr.nist.gov/programs/crystallography/software/tclpkgs.html |
---|
[33] | 17 | </A> for installation instructions. |
---|
| 18 | Likewise, I will assume you have also loaded the appropriate GSAS release, if not see |
---|
[106] | 19 | <A HREF="http://www.ncnr.nist.gov/programs/crystallography/software/unixgsas.html"> |
---|
| 20 | http://www.ncnr.nist.gov/programs/crystallography/software/unixgsas.html |
---|
[33] | 21 | </A> for installation instructions. |
---|
| 22 | |
---|
[38] | 23 | <P>More information about EXPGUI, including information on how it |
---|
[106] | 24 | can be customized, can be found on web pages <A HREF="expgui.html">expgui.html</A> |
---|
| 25 | and <A HREF="expgui_cfg.html">expgui_cfg.html</A>, found in the gsas/expgui/doc directory. |
---|
[38] | 26 | |
---|
[33] | 27 | <H2> |
---|
| 28 | 1. EXPGUI Downloading</H2> |
---|
| 29 | download file |
---|
[106] | 30 | <A HREF="ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/expgui.tar.gz"> |
---|
| 31 | ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/expgui.tar.gz</A> (~300 K) |
---|
[33] | 32 | by shift-clicking on the previous link. |
---|
[64] | 33 | <P> |
---|
| 34 | If you want to try the latest release (which may not have gotten |
---|
| 35 | a lot of testing, but probably has new bug fixes and capabilities) shift-click |
---|
[106] | 36 | on <A HREF="ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/expgui_ALPHA.tar.gz"> |
---|
| 37 | ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/expgui_ALPHA.tar.gz</A> |
---|
[69] | 38 | <P> |
---|
[95] | 39 | Optionally download the TCLDUMP program to speed and enhance liveplot and the |
---|
| 40 | EXPTOOL program which allows EXPGUI to add phases, histograms and atoms |
---|
| 41 | to .EXP files. |
---|
[69] | 42 | <UL> |
---|
[95] | 43 | <LI>LINUX: <BR> |
---|
[106] | 44 | <A HREF="ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/exe_linux/tcldump.tar.gz"> |
---|
| 45 | ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/exe_linux/tcldump.tar.gz</A> (~65 K) |
---|
[95] | 46 | <BR> |
---|
[106] | 47 | <A HREF="ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/exe_linux/exptool.tar.gz"> |
---|
| 48 | ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/exe_linux/exptool.tar.gz</A> (~292 K) |
---|
[95] | 49 | </LI><P> |
---|
| 50 | or |
---|
| 51 | <P> |
---|
| 52 | <LI>Silicon Graphics: <BR> |
---|
[106] | 53 | <A HREF="ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/exe_sgi/tcldump.tar.gz"> |
---|
| 54 | ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/exe_sgi/tcldump.tar.gz</A> (~45 K) |
---|
[95] | 55 | <BR> |
---|
[106] | 56 | <A HREF="ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/exe_sgi/exptool.tar.gz"> |
---|
| 57 | ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/exe_sgi/exptool.tar.gz</A> (~377 K) |
---|
[95] | 58 | </UL>Transfer the files by shift-clicking on the appropriate links. |
---|
[33] | 59 | <H2> |
---|
| 60 | 2. EXPGUI Installation</H2> |
---|
| 61 | A few short steps are needed to load EXPGUI on your computer. |
---|
| 62 | <H4> |
---|
| 63 | 2.1 Create a directory and restore the files</H4> |
---|
| 64 | The EXPGUI scripts are set up to be run from a <B>subdirectory in the main GSAS |
---|
[64] | 65 | directory</B>, by convention I assume the directory name <tt>expgui</tt>, but this is |
---|
[38] | 66 | not required. Thus, if you have located the GSAS package in |
---|
[33] | 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>, ...) |
---|
| 69 | I assume you will put |
---|
[64] | 70 | these files in <TT>/usr/local/gsas/expgui</TT> but any subdirectory, |
---|
| 71 | such as <TT>/usr/local/gsas/tcl</TT> will work fine. |
---|
[38] | 72 | Change the subsequent commands if GSAS is located somewhere |
---|
[33] | 73 | other than <TT>/usr/local/gsas</TT>. |
---|
| 74 | |
---|
| 75 | <PRE> |
---|
| 76 | cd /usr/local/gsas |
---|
[64] | 77 | mkdir expgui |
---|
| 78 | cd expgui |
---|
[69] | 79 | gunzip < [/path/]expgui.tar.gz | tar xvf - |
---|
[33] | 80 | </PRE> |
---|
| 81 | <P>When restoring the GSAS files from the tar file, |
---|
[69] | 82 | note that <TT>[/path/]</TT> in the example above indicates the location |
---|
[33] | 83 | where you downloaded the tar file in section 2, above. |
---|
| 84 | |
---|
| 85 | <H4> |
---|
| 86 | 2.2a Installing a shortcut to EXPGUI in .cshrc</H4> |
---|
[38] | 87 | <P>To use EXPGUI, you probably need to create an easy way to access it. |
---|
[33] | 88 | One way to do this is to add an alias to your ~/.cshrc file: |
---|
| 89 | <PRE> |
---|
| 90 | cat >> ~/.cshrc |
---|
[64] | 91 | alias expgui "wish /usr/local/gsas/expgui/expgui" |
---|
[33] | 92 | ^D |
---|
| 93 | </PRE> |
---|
| 94 | <H4> |
---|
| 95 | 2.2b Installing EXPGUI in the path</H4> |
---|
| 96 | <P> |
---|
| 97 | Another way to simplify access to EXPGUI |
---|
| 98 | is to create a file which will execute the GUI script from |
---|
| 99 | a command in your system's path, for example <TT>/usr/bin</TT>. |
---|
| 100 | <PRE> |
---|
| 101 | cat > /usr/bin/expgui |
---|
[64] | 102 | wish /usr/local/gsas/expgui/expgui |
---|
[33] | 103 | ^D |
---|
| 104 | chmod +x /usr/bin/expgui |
---|
| 105 | </PRE> |
---|
[38] | 106 | <H4> |
---|
| 107 | 2.2c Linking EXPGUI in the path</H4> |
---|
| 108 | <P> |
---|
| 109 | Another way to simplify access to EXPGUI |
---|
| 110 | is to create a link in your system's path to the GUI script. |
---|
| 111 | Note that you may need to modify the first line of |
---|
[64] | 112 | <TT>/usr/local/gsas/expgui/expgui</TT>, if wish is located somewhere |
---|
[38] | 113 | other than <TT>/usr/local/bin/wish</TT>. |
---|
| 114 | |
---|
| 115 | <PRE> |
---|
[64] | 116 | chmod +x /usr/local/gsas/expgui/expgui |
---|
| 117 | ln -s /usr/local/gsas/expgui/expgui /usr/bin/expgui |
---|
[38] | 118 | </PRE> |
---|
| 119 | |
---|
| 120 | <em>Note that in the above commands </em><TT>^D</TT><em> means control-D.</em> |
---|
[69] | 121 | |
---|
| 122 | <H4> |
---|
| 123 | 2.3 Installing TCLDUMP</H4> |
---|
| 124 | The 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 | |
---|
[95] | 130 | <H4> |
---|
| 131 | 2.4 Installing EXPTOOL</H4> |
---|
| 132 | The EXPTOOL program should be located with all of the GSAS executable files, |
---|
| 133 | for 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 | |
---|
[33] | 139 | <hr> |
---|
[106] | 140 | GSAS 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"> |
---|
[69] | 141 | Robert B. Von Dreele</A>, MS-H805, |
---|
[33] | 142 | Los Alamos National Laboratory, Los Alamos, NM 87545. Problems, questions |
---|
| 143 | or 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. |
---|
| 146 | The GSAS software was produced under a U.S. Government contract (W-7405-ENG-36) |
---|
| 147 | by the Los Alamos National Laboratory, which is operated by the University |
---|
| 148 | of California for the U.S. Department of Energy. The U.S. Government is |
---|
| 149 | licensed to use, reproduce, and distribute this software. Permission is |
---|
| 150 | granted to the public to copy and use this software without charge, provided |
---|
| 151 | that this notice and any statement of authorship are reproduced on all |
---|
| 152 | copies. Neither the Government nor the University makes any warranty, express |
---|
| 153 | or implied, or assumes any liability or responsibility for the use of this |
---|
| 154 | software. |
---|
| 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> |
---|
| 157 | with 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, |
---|
| 162 | expressed or implied, or assumes any liability or responsibility |
---|
| 163 | for the use of this information or the software described |
---|
| 164 | here. Brand names cited here are used for |
---|
| 165 | identification purposes and do not consitute an endorsement by NIST. |
---|
| 166 | |
---|
[106] | 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>) |
---|
[33] | 168 | <br> |
---|
| 169 | $Revision: 106 $ $Date: 2009-12-04 23:00:30 +0000 (Fri, 04 Dec 2009) $ |
---|
| 170 | </body> |
---|
| 171 | </html> |
---|