source: trunk/doc/expgui_Unix_readme.html @ 820

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

# on 2004/09/30 15:23:52, toby did:
extensive revision for new packages
  • Property rcs:author set to toby
  • Property rcs:date set to 2004/09/30 15:23:52
  • Property rcs:lines set to +317 -137
  • Property rcs:rev set to 1.20
  • Property rcs:state set to Exp
  • Property svn:keywords set to Author Date Revision Id
File size: 16.9 KB
Line 
1<HTML>
2<HEAD>
3   <TITLE>UNIX Installation notes for EXPGUI</TITLE>
4   <meta name="keywords" content="crystallography, Rietveld, diffraction,
5   GSAS, EXPGUI, Windows">
6</HEAD>
7<style>
8A:link {text-decoration:none}
9A:vlink {text-decoration:none}
10</style>
11
12<BODY BGCOLOR="#FFFFFF"
13      topmargin="0" leftmargin="0" marginwidth="0" marginheight="0" 
14      text="#000000" link="#0033ff" vlink="#0033ff" alink="#0033ff">
15
16<?
17   include("/var/www/include/navigation.inc");
18   include("/var/www/include/utility.inc");
19?>
20<blockquote><font face="arial, helvetica, sans-serif">
21
22<TABLE BORDER BGCOLOR="#FFFF40" ALIGN=RIGHT>
23<TR><TH><A  Href="expgui.html">EXPGUI home</A> 
24</TH></TR></TABLE><BR CLEAR=ALL>
25
26<CENTER><H1>
27<HR noshade width="75%" size="2" align="center">
28Installing
29<A HREF="expgui.html">
30EXPGUI
31</A>
32on <BR>SGI & Linux Computers
33<HR noshade width="75%" size="2" align="center">
34</H1></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>).
38
39<H2>1. Prerequisites</H2>
40
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.
52
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>.
56<DL>
57<DT>SGI:
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=
64http://www.ccp14.ac.uk/ccp/ccp14/ftp-mirror/briantoby/pub/cryst/gsas/SGI_gsas+expgui.tar.gz"
65>UK</a>,
66
67<a href="http://www.nist.gov/cgi-bin/exit_nist.cgi?url=
68http://ccp14.sims.nrc.ca/ccp/ccp14/ftp-mirror/briantoby/pub/cryst/gsas/SGI_gsas+expgui.tar.gz"
69>Canada</a>,
70
71or
72
73<a href="http://www.nist.gov/cgi-bin/exit_nist.cgi?url=
74http://ccp14.minerals.csiro.au/ccp/ccp14/ftp-mirror/briantoby/pub/cryst/gsas/SGI_gsas+expgui.tar.gz"
75>Australia</a>).
76
77<DT>LINUX:
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=
84http://www.ccp14.ac.uk/ccp/ccp14/ftp-mirror/briantoby/pub/cryst/gsas/LINUX_gsas+expgui.tar.gz"
85>UK</a>,
86(<a href="http://www.nist.gov/cgi-bin/exit_nist.cgi?url=
87http://ccp14.sims.nrc.ca/ccp/ccp14/ftp-mirror/briantoby/pub/cryst/gsas/LINUX_gsas+expgui.tar.gz"
88>Canada</a>,
89
90or
91
92<a href="http://www.nist.gov/cgi-bin/exit_nist.cgi?url=
93http://ccp14.minerals.csiro.au/ccp/ccp14/ftp-mirror/briantoby/pub/cryst/gsas/LINUX_gsas+expgui.tar.gz"
94>Australia</a>).
95
96</DL>
97
98<P>
99<H2>
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>.
104
105<UL>
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.
111<pre>
112      cd
113      mkdir Programs
114      cd Programs
115</Pre>
116or
117<pre>
118      cd /usr/local
119</Pre>
120
121<LI>Expand the files:
122<P><DL>
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>
127</DL>
128</UL>
129
130<H2>
1314. Installing a shortcut to EXPGUI</H2>
132While it is possible to invoke EXPGUI by typing
133<FONT FACE="COURIER"><PRE>
134    /usr/local/gsas/tcltk84+ /usr/local/gsas/expgui/expgui
135</PRE></FONT>
136or
137<FONT FACE="COURIER"><PRE>
138   /home/toby/myprogs/gsas/tcltk84+ /home/toby/myprogs/gsas/expgui/expgui
139</PRE></FONT>
140(etc.) this would get old fast. Rather, you will likely want to
141create an easier command to type.
142Below are three ways to do this. Note that only one is needed. Do not use all
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.
147
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,
151</em><FONT FACE="COURIER">^D</FONT><em> means control-D.</em>
152
153
154<UL><H4>
1554.1 Installing an alias for EXPGUI</H4>
156<P>
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
160<PRE>
161    echo $SHELL
162</PRE>
163
164The response will likely be something like /usr/bin/bash (the bash shell) or
165/usr/bin/tcsh (the tcsh shell).
166<P>
167<DL>
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):
171<FONT FACE="COURIER"><PRE>
172         cat >> ~/.cshrc
173         alias expgui "/myprogs/gsas/tcltk84+ /myprogs/gsas/expgui/expgui"
174         ^D
175</PRE></FONT>
176
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):
180<FONT FACE="COURIER"><PRE>
181         cat >> ~/.bash_profile
182         alias expgui="/myprogs/gsas/tcltk84+ /myprogs/gsas/expgui/expgui"
183         ^D
184</PRE></FONT>
185</DL>
186
187<H4>
1884.2 Installing EXPGUI in the path</H4>
189<P>
190Another way to simplify access to EXPGUI
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:
194<PRE>
195    echo $PATH
196</PRE>
197Also, check to see that you do not alreay have expgui command in your path
198by typing:
199<PRE>
200    which expgui
201</PRE>
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.
205<P>
206The commands to create this executable file will be:
207<FONT FACE="COURIER"><PRE>
208        cat > /usr/bin/expgui
209        /myprogs/gsas/tcltk84+ /myprogs/gsas/expgui/expgui
210        ^D
211        chmod +x /usr/bin/expgui
212</PRE></FONT>
213(change <tt>/myprogs</tt> and <tt>/usr/bin</tt> as needed).
214
215<I>Note that this step (4.2) is incompatible with the one below (4.3).</I>
216<H4>
2174.3 Linking EXPGUI into the path</H4>
218<P>
219Another way to simplify access to EXPGUI
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
222<PRE>
223      exec wish "$0" "$@"
224</PRE>
225to
226<PRE>
227      exec /myprogs/gsas/tcltk84+ "$0" "$@"
228</PRE>
229(change <tt>/myprogs</tt> as needed).
230Then you will create a link using:
231                ln -s /myprogs/gsas/expgui/expgui /usr/bin/expgui
232</PRE></FONT>
233<I>Note that this step (4.3) is incompatible with the one above (4.2).</I>
234</UL>
235
236<HR noshade><HR noshade>
237<H2>Updating to a new GSAS release</H2>
238<DL><DL>
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:
252<DL>
253<DT>UK:<DD>
254<A HREF="http://www.nist.gov/cgi-bin/exit_nist.cgi?
255url=http://www.ccp14.ac.uk/ccp/ccp14/ftp-mirror/gsas/public/gsas/">
256http://www.ccp14.ac.uk/ccp/ccp14/ftp-mirror/gsas/public/gsas/</A>
257<BR>or<BR>
258<A HREF="http://www.nist.gov/cgi-bin/exit_nist.cgi?url=
259ftp://ftp.ccp14.ac.uk/ccp14/ftp-mirror/gsas/public/gsas/">ftp://ftp.ccp14.ac.uk/ccp14/ftp-mirror/gsas/public/gsas/</A>
260
261<DT>Canada:<DD>
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>
263
264<DT>Australia:<DD>
265<A HREF="http://www.nist.gov/cgi-bin/exit_nist.cgi?url=
266http://ccp14.minerals.csiro.au/ccp/ccp14/ftp-mirror/gsas/public/gsas/">
267http://ccp14.minerals.csiro.au/ccp/ccp14/ftp-mirror/gsas/public/gsas/</A>
268</DL>
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:
273
274<P><DL>
275<DT>SGI, use command
276<DD><PRE>
277cd /myprogs/gsas
278gunzip < /tmp/gsaskit.tar.gz | tar xvf -</PRE>
279<DT>LINUX, use command
280<DD><PRE>
281cd /myprogs/gsas
282tar xvzf /tmp/gsaskit.tar.gz</PRE>
283</DL>
284<P>
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 ..."
288</DL></DL>
289
290<H2>Updating to a new EXPGUI release</H2>
291<DL><DL>
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
295package.
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">
300ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/expgui_ALPHA.tar.gz</A>.
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">
303http://www.ncnr.nist.gov/xtal/software/expgui/alpha/wishlist.html</A>
304<P>
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:
313<DL>
314<A HREF="ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/expgui_ALPHA.tar.gz">
315ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/expgui_ALPHA.tar.gz</A>
316<BR>
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=
319http://www.ccp14.ac.uk/ccp/ccp14/ftp-mirror/briantoby/pub/cryst/gsas/">
320the UK</A>,
321
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
324
325<A HREF="http://www.nist.gov/cgi-bin/exit_nist.cgi?url=
326http://ccp14.minerals.csiro.au/ccp/ccp14/ftp-mirror/briantoby/pub/cryst/gsas/">
327Australia</A>.)
328</DL><P>
329and unpack it to subdirectory <tt>.../gsas/expgui/</tt>
330using commands like this:
331
332<P><DL>
333<DT>SGI:
334<DD><PRE>
335cd /myprogs/gsas/expgui
336gunzip < /tmp/expgui_ALPHA.tar.gz | tar xvf -</PRE>
337<DT>LINUX:
338<DD><PRE>
339cd /myprogs/gsas/expgui
340tar xvzf /tmp/expgui_ALPHA.tar.gz</PRE>
341</DL>
342</DL></DL>
343
344<P>
345<H2>
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.
355<P>
356<h2>The Tcl/Tk Starkit</H2>
357<P>
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.
365
366<a name="testtcltk"></a><H2>
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> 
373font, computer responses are this <font face="courier"><I>italic font</I></font>.
374My comments are provided in this text font and are <U>underlined</U>).
375<UL>
376<TABLE>
377<TR><TD width="50%"><font face="courier">[tammy@beryl]$ wish</font></TD>
378<TD><U>(note a window is created)</U></TD></TR>
379<TR><TD><font face="courier"><I>%</I> set tcl_version</font></TD></TR>
380<TR><TD><font face="courier"><I>8.0</I></font></TD>
381<TD><U>(8.0 is the Tcl/Tk version number. EXPGUI requires 8.0 or higher)</U></TD></TR>
382<TR><TD><font face="courier"><I>%</I> package require BLT</font></TD></TR>
383<TR><TD><font face="courier"><I>2.4</I></font></TD>
384<TD><U>(2.4 is the BLT package version number.
385EXPGUI requires 2.3 or higher.
386If you get "can't find package BLT" then
387BLT is not installed [properly] on your system)</U></TD></TR>
388<TR><TD><font face="courier"><I>%</I> blt::graph .g</font></TD></TR>
389<TR><TD><font face="courier"><I>.g</I></font></TD>
390<TD><U>(nothing happens. You should not get an error message here.)</U></TD></TR>
391<TR><TD><font face="courier"><I>%</I> pack .g</font></TD>
392<TD><U>(now a graph is displayed)</U></TD></TR>
393<TR><TD><font face="courier"><I>%</I> Blt_ZoomStack .g</font></TD>
394<TD><U>(if error message: invalid command name "Blt_ZoomStack" appears
395there is a problem with your BLT installation, see below.)</U></TD></TR>
396</TABLE>
397There is a common problem with the pkg_Index.tcl file in older
398versions BLT that makes
399the Blt_ZoomStack command inaccessible, see my updated copy
400<A HREF="ftp://ftp.ncnr.nist.gov/pub/cryst/tcltk/BLT2.4_pkgIndex.tcl">
401ftp://ftp.ncnr.nist.gov/pub/cryst/tcltk/BLT2.4_pkgIndex.tcl
402</A> for an example that works. Also see the
403<A HREF="http://www.ncnr.nist.gov/programs/crystallography/software/tclpkgs82linux.html">
404Compiling Tcl/Tk 8.2.3 & packages for Linux</A> example of how to install.
405</UL>
406<P>
407<HR noshade><HR noshade>
408<P><H2>
409Acknowledgements</H2>
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.
414<P>
415<A Href="http://www.ncnr.nist.gov/programs/crystallography/software/gsas.html">
416GSAS</A>
417is 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">
418Robert B. Von Dreele</A>, MS-H805,
419Los Alamos National Laboratory, Los Alamos, NM 87545. Problems, questions
420or kudos concerning GSAS should be sent to Robert B. Von Dreele at
421<A HREF="MAILTO:vondreele@anl.gov">vondreele@anl.gov</A>
422
423<P>EXPGUI is written by Brian H. Toby of the NIST Center for Neutron Research,
424<A HREF="MAILTO:Brian.Toby@NIST.GOV">Brian.Toby@NIST.GOV</A> 
425with help from Jonathan Wasserman.
426<P>
427<hr><blockquote>
428GSAS is Copyright, 1984-1997, The Regents of the University of California.
429The GSAS software was produced under a U.S. Government contract (W-7405-ENG-36)
430by the Los Alamos National Laboratory, which is operated by the University
431of California for the U.S. Department of Energy. The U.S. Government is
432licensed to use, reproduce, and distribute this software. Permission is
433granted to the public to copy and use this software without charge, provided
434that this notice and any statement of authorship are reproduced on all
435copies. Neither the Government nor the University makes any warranty, express
436or implied, or assumes any liability or responsibility for the use of this
437software.
438
439<P>EXPGUI is not subject to copyright. Have fun with it.
440
441<p>Neither the U.S. Government nor any author makes any warranty,
442expressed or implied, or assumes any liability or responsibility
443for the use of this information or the software described
444here. Brand names cited here are used for
445identification purposes and do not consitute an endorsement by NIST.
446</blockquote>
447<hr>
448<TABLE BORDER BGCOLOR="#FFFF40" ALIGN=RIGHT>
449<TR><TH><A  Href="expgui.html">EXPGUI home</A> 
450</TH></TR></TABLE>
451
452<P><font size=-1><A HREF="MAILTO:crystal@NIST.gov?subject=WWW page <?=$PHP_SELF?>">Comments, corrections or questions: crystal@NIST.gov</A></font><BR>
453<font size=-1><? lastmod(); ?> </font>
454<br>
455$Revision: 820 $ $Date: 2009-12-04 23:12:36 +0000 (Fri, 04 Dec 2009) $
456</blockquote>
457</body>
458</html>
Note: See TracBrowser for help on using the repository browser.