Dec 4, 2009 5:12:36 PM (14 years ago)

# on 2004/09/30 15:23:52, toby did:
extensive revision for new packages

1 edited


  • trunk/doc/expgui_Unix_readme.html

    • Property rcs:date changed from 2003/08/11 19:36:42 to 2004/09/30 15:23:52
    • Property rcs:lines changed from +2 -2 to +317 -137
    • Property rcs:rev changed from 1.19 to 1.20
    r733 r820  
    2727<HR noshade width="75%" size="2" align="center">
    28 UNIX Installation notes for
    2929<A HREF="expgui.html">
     32on <BR>SGI & Linux Computers
    3233<HR noshade width="75%" size="2" align="center">
    34 Note that root access is not required to load GSAS, Tcl/Tk and
    35 <A HREF="expgui.html">EXPGUI</A>, unless the files will be put in
    36 a central location (such as /usr/local) or you will use the RPM package.
    38 <H2>0. A one-step process for Linux</H2>
    39 Many Linux releases incorporate a package-loading program called RPM.
    40 The RPM package file loads, <A Href="http://www.ncnr.nist.gov/programs/crystallography/software/gsas.html">GSAS</A> and
    41 <A Href="http://www.ncnr.nist.gov/xtal/software/expgui">
    42 EXPGUI</A>, as well as checks that your Linux system has been configured
    43 properly to run these programs (for example, has Tcl/Tk and BLT loaded).
    44 The most recent <font face="courier">GSAS-EXPGUI-yyyy.mm.dd-x.i386.rpm</font>
    45 file
    46 (where yyyy, mm & dd are year, month and day)
    47 can be found in directory
    48 <a href="ftp://ftp.ncnr.nist.gov/pub/cryst/gsas">
    49 ftp://ftp.ncnr.nist.gov/pub/cryst/gsas</a> or a CCP14 mirror site.
    50 See the
    51 <A Href="http://www.ncnr.nist.gov/xtal/software/installGSASrpm.html">RPM instructions</a>
    52 for details on how to load this package. But in short, you can download file
    53 <A Href="ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/GSAS-EXPGUI.i386.rpm">
    54 ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/GSAS-EXPGUI.i386.rpm</a>. To install,
    55 use<FONT FACE="COURIER"><PRE>
    56       rpm -ihv GSAS-EXPGUI.i386.rpm
    57 </PRE></FONT>
    58 and to upgrade, use
    60       rpm -Uhv GSAS-EXPGUI.i386.rpm
    61 </PRE></FONT>
    62 If you have a fast network connection, you can even use
    64       rpm -ihv ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/GSAS-EXPGUI.i386.rpm
    65 </PRE></FONT>
    67 <HR noshade width="75%" size="2" align="center">
    68 <HR noshade width="75%" size="2" align="center">
     35Note that root access is not required to load this GSAS/EXPGUI package.
     36You may choose to do this work as root, so that the files may be installed
     37a central location (such as <tt>/usr/local</tt>).
    6939<H2>1. Prerequisites</H2>
    71 I will assume that you already have the Tcl/Tk package loaded on your computer. If this
    72 is not true, please see
    73 <A HREF="http://www.ncnr.nist.gov/programs/crystallography/software/tclpkgs.html">
    74 http://www.ncnr.nist.gov/programs/crystallography/software/tclpkgs.html
    75 </A> for installation instructions. Please note that EXPGUI seems to run very
    76 slowly in Tcl/Tk version 8.1, but OK in 8.0 and 8.2.
    77 Also see <a href="#testtcltk">below</a> on how to test if Tcl/Tk is properly
    78 installed.
    79 <P>
    80 Likewise, I will assume you have also loaded the appropriate GSAS release, if not see
    81 <A HREF="http://www.ncnr.nist.gov/programs/crystallography/software/unixgsas.html">
    82 http://www.ncnr.nist.gov/programs/crystallography/software/unixgsas.html
    83 </A> for installation instructions.  The current versions of EXPGUI must be
    84 used with GSAS versions released on or after April, 2001.
    85 <I>EXPGUI v. 1.40 and later are not compatible with earlier Unix versions of
    86 GSAS -- as the file formats have changed.</I>
    88 <P>More information about EXPGUI, including information on how it
    89 can be customized, can be found on web pages <A HREF="expgui.html">expgui.html</A>
    90 and <A HREF="expgui_cfg.html">expgui_cfg.html</A>, found in the gsas/expgui/doc directory.
     41Installation of GSAS & EXPGUI requires X windows, which is loaded with
     42the operating system on virtually all Linux and SGI systems.
     43It also requires only the shared libraries typically found on standard
     44install configurations (tell me if I am wrong).
     45The Linux version is compiled with g77 v2.96 on a Redhat 7.1 machine.
     46It should be compatible with most modern versions of Linux.
     47The SGI version has been compiled with f77 on a SGI running IRIX 6.5. It should
     48be compatible with most recent versions of IRIX.
     49<IMG SRC="new.gif" HEIGHT=13 WIDTH=36 alt="New!">
     50This GSAS & EXPGUI is now distributed with a version of Tcl/Tk,
     51so installation of Tcl/Tk is no longer a prerequisite.
     53<H2>2. Download the GSAS/EXPGUI Distribution</H2>
     54<I>Make a note of where you download the file. In the following section
     55it will be assumed the file was placed in</I> <tt>/tmp/</tt>.
     58<DD>download file
     59<A HREF="ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/SGI_gsas+expgui.tar.gz">
     60ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/SGI_gsas+expgui.tar.gz</A> (~10 Mb)
     61by shift-clicking on the previous link.
     62(<I>Alternately this file can also be downloaded from the CCP14 mirrors in</I>
     63<a href="http://www.nist.gov/cgi-bin/exit_nist.cgi?url=
     67<a href="http://www.nist.gov/cgi-bin/exit_nist.cgi?url=
     73<a href="http://www.nist.gov/cgi-bin/exit_nist.cgi?url=
     78<DD>download file
     79<A HREF="ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/LINUX_gsas+expgui.tar.gz">
     80ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/LINUX_gsas+expgui.tar.gz</A> (~10 Mb)
     81by shift-clicking on the previous link.
     82(<I>Alternately this file can also be downloaded from the CCP14 mirrors in</I>
     83<a href="http://www.nist.gov/cgi-bin/exit_nist.cgi?url=
     86(<a href="http://www.nist.gov/cgi-bin/exit_nist.cgi?url=
     92<a href="http://www.nist.gov/cgi-bin/exit_nist.cgi?url=
    93 2. EXPGUI Downloading</H2>
    94 download file
    95 <A HREF="ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/expgui.tar.gz">
    96 ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/expgui.tar.gz</A> (~300 K)
    97 by shift-clicking on the previous link.
    98 <P>
    99 If you want to try the latest release (which may not have gotten
    100 a lot of testing, but probably has new bug fixes and capabilities) shift-click
    101 on <A HREF="ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/expgui_ALPHA.tar.gz">
    102 ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/expgui_ALPHA.tar.gz</A>
     1003. Unpack the distribution</H2>
     101<I>In this step,
     102it is assumed that you downloaded the distribution file in
     103directory</I> <tt>/tmp/</tt>.
     106<LI>Determine a directory where the software should be installed.
     107<I>If you do not have root access, this will likely be in your
     108own working area, typically</I> <tt>/usr/people/</tt>account
     109<I>or</I> <tt>/home/</tt>account. Note that the files will be
     110placed in a subdirectory named <tt>gsas</tt> in this location.
     112      cd
     113      mkdir Programs
     114      cd Programs
     118      cd /usr/local
     121<LI>Expand the files:
     123<DT>SGI, use command
     124<DD><PRE>gunzip < /tmp/SGI_gsas+expgui.tar.gz | tar xvf -</PRE>
     125<DT>LINUX, use command
     126<DD><PRE>tar xvzf /tmp/LINUX_gsas+expgui.tar.gz</PRE>
    105 3. EXPGUI Installation</H2>
    106 A few short steps are needed to load EXPGUI on your computer.
    107 <H3>
    108 2.1 Create a directory and restore the files</H3>
    109 The EXPGUI scripts are set up to be run from a <B>subdirectory in the main GSAS
    110 directory</B>, by convention I assume the directory name
    111 <font face="courier">expgui</font>, but this is
    112 not required. Thus, if you have located the GSAS package in
    113 <FONT FACE="COURIER">/usr/local/gsas</FONT> (so that there is a directory
    114 <FONT FACE="COURIER">/usr/local/gsas/exe</FONT>, <FONT FACE="COURIER">/usr/local/gsas/data</FONT>, ...)
    115 I assume you will put
    116 these files in <FONT FACE="COURIER">/usr/local/gsas/expgui</FONT> but any subdirectory,
    117 such as <FONT FACE="COURIER">/usr/local/gsas/tcl</FONT> will work fine.
    118 Change the subsequent commands if GSAS is located somewhere
    119 other than <FONT FACE="COURIER">/usr/local/gsas</FONT>.
    122             cd    /usr/local/gsas
    123             mkdir expgui
    124             cd    expgui
    125             gunzip <  [/path/]expgui.tar.gz  | tar xvf -
    126 </PRE></FONT>
    127 <P>When restoring the GSAS files from the tar file,
    128 note that <FONT FACE="COURIER">[/path/]</FONT> in the example above indicates the location
    129 where you downloaded the tar file in section 2, above.
    131 <H3>
    132 2.2 Installing a shortcut to EXPGUI</H3>
     1314. Installing a shortcut to EXPGUI</H2>
    133132While it is possible to invoke EXPGUI by typing
    134133<FONT FACE="COURIER"><PRE>
    135                 wish /usr/local/gsas/expgui/expgui
     134    /usr/local/gsas/tcltk84+ /usr/local/gsas/expgui/expgui
    138137<FONT FACE="COURIER"><PRE>
    139                 /home/toby/mywish/wish /home/toby/mygsas/expgui/expgui
    140 </PRE></FONT>
    141 or whatever, you will likely want to create an easier command to type.
     138   /home/toby/myprogs/gsas/tcltk84+ /home/toby/myprogs/gsas/expgui/expgui
     140(etc.) this would get old fast. Rather, you will likely want to
     141create an easier command to type.
    142142Below are three ways to do this. Note that only one is needed. Do not use all
    143 three.
    145 <em>Also, note that in the commands below,
     143three. You could also create a startbar or desktop icon that can be clicked
     144to start EXPGUI.
     145The way this is done depends on how your system is set up and cannot
     146be described here.
     148<em>Note that in the commands below, it is assumed that
     149GSAS has been installed in <tt>/myprogs/gsas</tt>.
     150Also, note that in the commands below,
    146151</em><FONT FACE="COURIER">^D</FONT><em> means control-D.</em>
    150 2.2a Installing a shortcut to EXPGUI in .cshrc</H4>
    151 <P>To use EXPGUI, you probably need to create an easy way to access it.
    152 One way to do this is to add an alias to your ~/.cshrc file:
     1554.1 Installing an alias for EXPGUI</H4>
     157One way to create a easy way to invoke EXPGUI is to add an alias to your
     158default shell.
     159First, determine what shell you are using. Type
     161    echo $SHELL
     164The response will likely be something like /usr/bin/bash (the bash shell) or
     165/usr/bin/tcsh (the tcsh shell).
     168<DT>If you use tcsh or csh:
     169<DD>to add an alias to your ~/.cshrc file, type these commands
     170(change <tt>/myprogs</tt> as needed):
    153171<FONT FACE="COURIER"><PRE>
    154                 cat >> ~/.cshrc
    155                 alias expgui "wish /usr/local/gsas/expgui/expgui"
    156                 ^D
    157 </PRE></FONT>
     172         cat >> ~/.cshrc
     173         alias expgui "/myprogs/gsas/tcltk84+ /myprogs/gsas/expgui/expgui"
     174         ^D
     177<DT>If you use bash:
     178<DD>to add an alias to your ~/.bash_profile, type these commands
     179(change <tt>/myprogs</tt> as needed):
     181         cat >> ~/.bash_profile
     182         alias expgui="/myprogs/gsas/tcltk84+ /myprogs/gsas/expgui/expgui"
     183         ^D
    159 2.2b Installing EXPGUI in the path</H4>
     1884.2 Installing EXPGUI in the path</H4>
    161190Another way to simplify access to EXPGUI
    162 is to create a file which will execute the GUI script from
    163 a command in your system's path, for example <FONT FACE="COURIER">/usr/bin</FONT>.
     191is to create a file that will invoke the GUI script.
     192The file must be placed in a directory in your path and
     193flagged as executable. You can examine the directories in your path by typing:
     195    echo $PATH
     197Also, check to see that you do not alreay have expgui command in your path
     198by typing:
     200    which expgui
     202You should get a response "expgui not found in...". A response of
     203<tt>/usr/bin/expgui</tt> tells you there is already a shortcut to expgui
     204in that location. Either replace it or choose a name other than expgui.
     206The commands to create this executable file will be:
    164207<FONT FACE="COURIER"><PRE>
    165                 cat > /usr/bin/expgui
    166                 wish /usr/local/gsas/expgui/expgui
    167                 ^D
    168                 chmod +x /usr/bin/expgui
    169 </PRE></FONT>
    170 <I>Note that this step (2.2b) is incompatible with the one below (2.2c).</I>
     208        cat > /usr/bin/expgui
     209        /myprogs/gsas/tcltk84+ /myprogs/gsas/expgui/expgui
     210        ^D
     211        chmod +x /usr/bin/expgui
     213(change <tt>/myprogs</tt> and <tt>/usr/bin</tt> as needed).
     215<I>Note that this step (4.2) is incompatible with the one below (4.3).</I>
    172 2.2c Linking EXPGUI in the path</H4>
     2174.3 Linking EXPGUI into the path</H4>
    174219Another way to simplify access to EXPGUI
    175 is to create a link in your system's path to the GUI script.
    176 Note that you may need to modify the first line of
    177 <FONT FACE="COURIER">/usr/local/gsas/expgui/expgui</FONT>, if wish is located somewhere
    178 other than <FONT FACE="COURIER">/usr/local/bin/wish</FONT>.
    181                 chmod +x /usr/local/gsas/expgui/expgui
    182                 ln -s /usr/local/gsas/expgui/expgui /usr/bin/expgui
    183 </PRE></FONT>
    184 <I>Note that this step (2.2c) is incompatible with the one above (2.2b).</I>
     220is to create a link in your system's path to the GUI script.
     221First, you will need to edit the 3rd line in the EXPGUI script from
     223      exec wish "$0" "$@"
     227      exec /myprogs/gsas/tcltk84+ "$0" "$@"
     229(change <tt>/myprogs</tt> as needed).
     230Then you will create a link using:
     231                ln -s /myprogs/gsas/expgui/expgui /usr/bin/expgui
     233<I>Note that this step (4.3) is incompatible with the one above (4.2).</I>
    186 H3>
    188 2.3 Installing EXPTOOL</H3>
    189 If being upgraded, the EXPTOOL program should be placed in the
    190 directory with the GSAS executable files,
    191 for example in /usr/local/gsas/exe/.
    193             cd    /usr/local/gsas/exe
    194             gunzip <  [/path/]exptool.tar.gz  | tar xvf -
    195 </PRE></FONT>
     236<HR noshade><HR noshade>
     237<H2>Updating to a new GSAS release</H2>
     239It is quite common that Bob Von Dreele will release an update to the
     240GSAS programs more frequently than the combination gsas+expgui
     241is updated. It is possible to update only the
     242GSAS software.
     243To determine the date of the GSAS package release,
     244run a GSAS program, such as EXPEDT or SPACEGRP and note the
     245date where it says "Distributed on ..."
     246To update,
     247first determine where you have installed the GSAS/EXPGUI software
     248(<tt>/myprogs</tt> in the previous example).
     249You will want to install the GSAS distribution to the <tt>gsas</tt>
     250subdirectory in that location.
     251Then download the latest GSAS release from CCP14:
     254<A HREF="http://www.nist.gov/cgi-bin/exit_nist.cgi?
     258<A HREF="http://www.nist.gov/cgi-bin/exit_nist.cgi?url=
     262<A HREF="http://www.nist.gov/cgi-bin/exit_nist.cgi?url=http://ccp14.sims.nrc.ca/ccp/ccp14/ftp-mirror/gsas/public/gsas/">http://ccp14.sims.nrc.ca/ccp/ccp14/ftp-mirror/gsas/public/gsas/</A>
     265<A HREF="http://www.nist.gov/cgi-bin/exit_nist.cgi?url=
     269<P>Select and download the appropriate gsaskit.tar.gz (making sure that the
     270listing date is significantly later than the distribution date
     271you currently have).
     272Then use commands like this:
     275<DT>SGI, use command
     277cd /myprogs/gsas
     278gunzip < /tmp/gsaskit.tar.gz | tar xvf -</PRE>
     279<DT>LINUX, use command
     281cd /myprogs/gsas
     282tar xvzf /tmp/gsaskit.tar.gz</PRE>
     285Finally, check that GSAS has indeed been updated by
     286again running a GSAS program, such as EXPEDT or SPACEGRP and noting the
     287date where it says "Distributed on ..."
     290<H2>Updating to a new EXPGUI release</H2>
     292It is also common that new features will be added to EXPGUI or
     293bug fixes will be made without an update to the
     294combination gsas+expgui
     296The absolute latest release (which may not have gotten
     297a lot of testing)
     298is distributed as
     299<A HREF="ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/expgui_ALPHA.tar.gz">
     301You can find the number of the latest alpha release by looking at file
     302<A Href="http://www.ncnr.nist.gov/xtal/software/expgui/alpha/wishlist.html">
     305To update,
     306first determine where you have installed the GSAS/EXPGUI software
     307(<tt>/myprogs</tt> in the previous example).
     308You will want to install the GSAS distribution to the <tt>gsas/expgui</tt>
     309subdirectory in that location.
     310Second, note the EXPGUI package date, by
     311using the Help/About menu command in EXPGUI.
     312You then want to download this file:
     314<A HREF="ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/expgui_ALPHA.tar.gz">
     317(for mirrors, select file expgui_ALPHA.tar.gz from CCP14 sites in
     318<A HREF="http://www.nist.gov/cgi-bin/exit_nist.cgi?url=
     320the UK</A>,
     322<A HREF="http://www.nist.gov/cgi-bin/exit_nist.cgi?url=http://ccp14.sims.nrc.ca/ccp/ccp14/ftp-mirror/briantoby/pub/cryst/gsas/">
     323Canada</A>, or
     325<A HREF="http://www.nist.gov/cgi-bin/exit_nist.cgi?url=
     329and unpack it to subdirectory <tt>.../gsas/expgui/</tt>
     330using commands like this:
     335cd /myprogs/gsas/expgui
     336gunzip < /tmp/expgui_ALPHA.tar.gz | tar xvf -</PRE>
     339cd /myprogs/gsas/expgui
     340tar xvzf /tmp/expgui_ALPHA.tar.gz</PRE>
     346<a name="NoRPM"></a><H2>
     347RPMs for GSAS/EXPGUI are not being updated</H2>
     348I am no longer preparing an RPM distribution for GSAS & EXPGUI. This
     349is because it was getting increasingly hard to find RPM distributions
     350for Tcl/Tk and BLT. If one has to install & build these packages from
     351source code, then one must also override the RPM package tracking
     352system to install the GSAS & EXPGUI RPM.
     353The current method, which includes the entire Tcl/Tk package is
     354easier to deal with.
     356<h2>The Tcl/Tk Starkit</H2>
     358The GSAS-EXPGUI distribution now includes a single file version of the
     359entire Tcl/Tk package, as well as a graphics package for Tcl/Tk, called
     360BLT, that is used extensively within EXPGUI. The inclusion of this file
     361within the package simplifies installation considerably.
     362This file,
     363<tt>tcltk84+</tt>, contains many other Tcl/Tk packages (that are
     364not used within EXPGUI), but may be of value for use with other applications.
    197366<a name="testtcltk"></a><H2>
    198 Is Tcl/Tk installed already?</H2>
    199 To test if Tcl/Tk is installed correctly on your system
    200 do the following commands. (Commands you type are in this <font face="courier">typewriter</font>
     367Using other versions of Tcl/Tk</H2>
     368If you have another version of Tcl/Tk installed on your computer,
     369it must also have the BLT package installed and configured properly.
     370To confirm this
     371software is installed and working correctly on your system
     372try the following commands. (Commands you type are in this <font face="courier">typewriter</font>
    201373font, computer responses are this <font face="courier"><I>italic font</I></font>.
    202374My comments are provided in this text font and are <U>underlined</U>).
    205 <TR><TD><font face="courier">[tammy@beryl tammy]$ wish</font></TD>
     377<TR><TD width="50%"><font face="courier">[tammy@beryl]$ wish</font></TD>
    206378<TD><U>(note a window is created)</U></TD></TR>
    207379<TR><TD><font face="courier"><I>%</I> set tcl_version</font></TD></TR>
    223395there is a problem with your BLT installation, see below.)</U></TD></TR>
    225 There is a common problem with the pkg_Index.tcl file in BLT that makes
     397There is a common problem with the pkg_Index.tcl file in older
     398versions BLT that makes
    226399the Blt_ZoomStack command inaccessible, see my updated copy
    227400<A HREF="ftp://ftp.ncnr.nist.gov/pub/cryst/tcltk/BLT2.4_pkgIndex.tcl">
    231404Compiling Tcl/Tk 8.2.3 & packages for Linux</A> example of how to install.
     407<HR noshade><HR noshade>
     410<P>Thanks to Paul Kienzle of the
     411<a href="http://www.ncnr.nist.gov/dave/">
     412NCNR DAVE project</A> for providing the "all in one file" (starkit)
     413version of Tcl/Tk for SGI and Linux.
    235415<A Href="http://www.ncnr.nist.gov/programs/crystallography/software/gsas.html">
Note: See TracChangeset for help on using the changeset viewer.