Changeset 548


Ignore:
Timestamp:
Dec 4, 2009 5:08:01 PM (14 years ago)
Author:
toby
Message:

# on 2002/01/23 19:59:22, toby did:
reference the RPM file
cleanup font use

File:
1 edited

Legend:

Unmodified
Added
Removed

  • trunk/doc/expgui_Unix_readme.html

    • Property rcs:date changed from 2001/12/19 18:55:42 to 2002/01/23 19:59:22
    • Property rcs:lines changed from +39 -27 to +60 -41
    • Property rcs:rev changed from 1.15 to 1.16
    r514 r548  
    3434</H1></CENTER>
    3535Note that root access is not required to load GSAS, Tcl/Tk and
    36 <A HREF="expgui.html">EXPGUI</A>.
    37 
    38 <H2>0. Prerequisites</H2>
     36<A HREF="expgui.html">EXPGUI</A>, unless the files will be put in
     37a central location (such as /usr/local) or you will use the RPM package.
     38
     39<H2>0. A one-step process for Linux</H2>
     40Many Linux releases incorporate a package-loading program called RPM.
     41The RPM package file loads, <A Href="http://www.ncnr.nist.gov/programs/crystallography/software/gsas.html">GSAS</A> and
     42<A Href="http://www.ncnr.nist.gov/xtal/software/expgui">
     43EXPGUI</A>, as well as checks that your Linux system has been configured
     44properly to run these programs (for example, has Tcl/Tk and BLT loaded).
     45The most recent <font face="courier">GSAS-EXPGUI-yyyy.mm.dd-x.i386.rpm</font>
     46file
     47(where yyyy, mm & dd are year, month and day)
     48can be found in directory
     49<a href="ftp://ftp.ncnr.nist.gov/pub/cryst/gsas">
     50ftp://ftp.ncnr.nist.gov/pub/cryst/gsas</a> or a CCP14 mirror site.
     51See the
     52<A Href="http://www.ncnr.nist.gov/xtal/software/installGSASrpm.html">RPM instructions</a>
     53for details on how to load this package,
     54rather than the following paragraphs.
     55
     56<H2>1. Prerequisites</H2>
    3957
    4058I will assume that you already have the Tcl/Tk package loaded on your computer. If this
    … …  
    6078
    6179<H2>
    62 1. EXPGUI Downloading</H2>
     802. EXPGUI Downloading</H2>
    6381download file
    6482<A HREF="ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/expgui.tar.gz">
    … …  
    86104</UL>Transfer the appropriate file by shift-clicking on the appropriate link.
    87105<H2>
    88 2. EXPGUI Installation</H2>
     1063. EXPGUI Installation</H2>
    89107A few short steps are needed to load EXPGUI on your computer.
    90108<H3>
    911092.1 Create a directory and restore the files</H3>
    92110The EXPGUI scripts are set up to be run from a <B>subdirectory in the main GSAS
    93 directory</B>, by convention I assume the directory name <tt>expgui</tt>, but this is
     111directory</B>, by convention I assume the directory name
     112<font face="courier">expgui</font>, but this is
    94113not required. Thus, if you have located the GSAS package in
    95 <TT>/usr/local/gsas</TT> (so that there is a directory
    96 <TT>/usr/local/gsas/exe</TT>, <TT>/usr/local/gsas/data</TT>, ...)
     114<FONT FACE="COURIER">/usr/local/gsas</FONT> (so that there is a directory
     115<FONT FACE="COURIER">/usr/local/gsas/exe</FONT>, <FONT FACE="COURIER">/usr/local/gsas/data</FONT>, ...)
    97116I assume you will put
    98 these files in <TT>/usr/local/gsas/expgui</TT> but any subdirectory,
    99 such as <TT>/usr/local/gsas/tcl</TT> will work fine.
     117these files in <FONT FACE="COURIER">/usr/local/gsas/expgui</FONT> but any subdirectory,
     118such as <FONT FACE="COURIER">/usr/local/gsas/tcl</FONT> will work fine.
    100119Change the subsequent commands if GSAS is located somewhere
    101 other than <TT>/usr/local/gsas</TT>.
    102 
    103 <PRE>
     120other than <FONT FACE="COURIER">/usr/local/gsas</FONT>.
     121
     122<FONT FACE="COURIER"><PRE>
    104123            cd    /usr/local/gsas
    105124            mkdir expgui
    106125            cd    expgui
    107126            gunzip <  [/path/]expgui.tar.gz  | tar xvf -
    108 </PRE>
     127</PRE></FONT>
    109128<P>When restoring the GSAS files from the tar file,
    110 note that <TT>[/path/]</TT> in the example above indicates the location
     129note that <FONT FACE="COURIER">[/path/]</FONT> in the example above indicates the location
    111130where you downloaded the tar file in section 2, above.
    112131
    … …  
    1141332.2 Installing a shortcut to EXPGUI</H3>
    115134While it is possible to invoke EXPGUI by typing
    116 <PRE>
     135<FONT FACE="COURIER"><PRE>
    117136                wish /usr/local/gsas/expgui/expgui
    118 </PRE>
     137</PRE></FONT>
    119138or
    120 <PRE>
     139<FONT FACE="COURIER"><PRE>
    121140                /home/toby/mywish/wish /home/toby/mygsas/expgui/expgui
    122 </PRE>
     141</PRE></FONT>
    123142or whatever, you will likely want to create an easier command to type.
    124143Below are three ways to do this. Note that only one is needed. Do not use all
    … …  
    126145
    127146<em>Also, note that in the commands below,
    128 </em><TT>^D</TT><em> means control-D.</em>
     147</em><FONT FACE="COURIER">^D</FONT><em> means control-D.</em>
    129148
    130149
    … …  
    133152<P>To use EXPGUI, you probably need to create an easy way to access it.
    134153One way to do this is to add an alias to your ~/.cshrc file:
    135 <PRE>
     154<FONT FACE="COURIER"><PRE>
    136155                cat >> ~/.cshrc
    137156                alias expgui "wish /usr/local/gsas/expgui/expgui"
    138157                ^D
    139 </PRE>
     158</PRE></FONT>
    140159<H4>
    1411602.2b Installing EXPGUI in the path</H4>
    … …  
    143162Another way to simplify access to EXPGUI
    144163is to create a file which will execute the GUI script from
    145 a command in your system's path, for example <TT>/usr/bin</TT>.
    146 <PRE>
     164a command in your system's path, for example <FONT FACE="COURIER">/usr/bin</FONT>.
     165<FONT FACE="COURIER"><PRE>
    147166                cat > /usr/bin/expgui
    148167                wish /usr/local/gsas/expgui/expgui
    149168                ^D
    150169                chmod +x /usr/bin/expgui
    151 </PRE>
     170</PRE></FONT>
    152171<I>Note that this step (2.2b) is incompatible with the one below (2.2c).</I>
    153172<H4>
    … …  
    157176is to create a link in your system's path to the GUI script.
    158177Note that you may need to modify the first line of
    159 <TT>/usr/local/gsas/expgui/expgui</TT>, if wish is located somewhere
    160 other than <TT>/usr/local/bin/wish</TT>.
    161 
    162 <PRE>
     178<FONT FACE="COURIER">/usr/local/gsas/expgui/expgui</FONT>, if wish is located somewhere
     179other than <FONT FACE="COURIER">/usr/local/bin/wish</FONT>.
     180
     181<FONT FACE="COURIER"><PRE>
    163182                chmod +x /usr/local/gsas/expgui/expgui
    164183                ln -s /usr/local/gsas/expgui/expgui /usr/bin/expgui
    165 </PRE>
     184</PRE></FONT>
    166185<I>Note that this step (2.2c) is incompatible with the one above (2.2b).</I>
    167186</UL>
    … …  
    172191directory with the GSAS executable files,
    173192for example in /usr/local/gsas/exe/.
    174 <PRE>
     193<FONT FACE="COURIER"><PRE>
    175194            cd    /usr/local/gsas/exe
    176195            gunzip <  [/path/]exptool.tar.gz  | tar xvf -
    177 </PRE>
     196</PRE></FONT>
    178197
    179198<a name="testtcltk"></a><H2>
    180199Is Tcl/Tk installed already?</H2>
    181200To test if Tcl/Tk is installed correctly on your system
    182 do the following commands. (Commands you type are in this <tt>typewriter</tt>
    183 font, computer responses are this <tt><I>italic font</I></tt>.
     201do the following commands. (Commands you type are in this <font face="courier">typewriter</font>
     202font, computer responses are this <font face="courier"><I>italic font</I></font>.
    184203My comments are provided in this text font and are <U>underlined</U>).
    185204<UL>
    186205<TABLE>
    187 <TR><TD><tt>[tammy@beryl tammy]$ wish</tt></TD>
     206<TR><TD><font face="courier">[tammy@beryl tammy]$ wish</font></TD>
    188207<TD><U>(note a window is created)</U></TD></TR>
    189 <TR><TD><tt><I>%</I> set tcl_version</TD></TR>
    190 <TR><TD><tt><I>8.0</I></tt></TD>
     208<TR><TD><font face="courier"><I>%</I> set tcl_version</font></TD></TR>
     209<TR><TD><font face="courier"><I>8.0</I></font></TD>
    191210<TD><U>(8.0 is the Tcl/Tk version number. EXPGUI requires 8.0 or higher)</U></TD></TR>
    192 <TR><TD><tt><I>%</I> package require BLT</tt></TD></TR>
    193 <TR><TD><tt><I>2.4</I></tt></TD>
     211<TR><TD><font face="courier"><I>%</I> package require BLT</font></TD></TR>
     212<TR><TD><font face="courier"><I>2.4</I></font></TD>
    194213<TD><U>(2.4 is the BLT package version number.
    195214EXPGUI requires 2.3 or higher.
    196215If you get "can't find package BLT" then
    197216BLT is not installed [properly] on your system)</U></TD></TR>
    198 <TR><TD><tt><I>%</I> blt::graph .g</tt></TD></TR>
    199 <TR><TD><tt><I>.g</I></tt></TD>
     217<TR><TD><font face="courier"><I>%</I> blt::graph .g</font></TD></TR>
     218<TR><TD><font face="courier"><I>.g</I></font></TD>
    200219<TD><U>(nothing happens. You should not get an error message here.)</U></TD></TR>
    201 <TR><TD><tt><I>%</I> pack .g</tt></TD>
     220<TR><TD><font face="courier"><I>%</I> pack .g</font></TD>
    202221<TD><U>(now a graph is displayed)</U></TD></TR>
    203 <TR><TD><tt><I>%</I> Blt_ZoomStack .g</tt></TD>
     222<TR><TD><font face="courier"><I>%</I> Blt_ZoomStack .g</font></TD>
    204223<TD><U>(if error message: invalid command name "Blt_ZoomStack" appears
    205224there is a problem with your BLT installation, see below.)</U></TD></TR>
Note: See TracChangeset for help on using the changeset viewer.