						14 January, 2004


	     Athena and Artemis Installation Instructions



If you are installing Athena and Artemis for the first time, then you
should read through the prerequisites to be sure you have all the
stuff needed for using this software.  If you are updating from
earlier versions of Athena and Artemis, you can skip past the
prerequisites.


Prerequisites
=============

  1. You must be running a recent version of Perl.  Perl is commonly
     installed on Unix systems, but if yours is old or missing, the
     latest version is free for download from http://www.perl.com.  It
     is not hard to install, although it must be done by the system
     administrator.  As of this writing, the current stable version is
     5.8.4.  If you use a recent linux distribution, your distribution
     CD almost certainly has a recent version of Perl on it.

  2. You must install Ifeffit and PGPLOT.  Ifeffit can be found on the
     Ifeffit homepage at http://cars9.uchicago.edu/~newville/ifeffit/.
     Follow the installation instructions that come with it to install
     Ifeffit and PGPLOT.  Again, the installation is not hard and
     should be done by the administrator.

  3. Execute this command at the command line:
         perl -e 'use Tk; print $Tk::VERSION,$/'
     If it returns and error message or if it returns a number smaller
     than 800.022, then you should update perl/Tk.  Again, this is
     simple.  As root, execute this command:
         perl -MCPAN -e shell
     then, at the CPAN> prompt, type
         install Tk


Installing Athena and Artemis
=============================

  1. Download the latest version of the Horae from its homepage,
     http://feff.phys.washington.edu/~ravel/software/exafs/

  2. Unpack the archive by issuing this command
         gzip -dc horae.XXX.tar.gz | tar xvf -
     This will unpack the contents to a directory called `horae-XXX/'
     where "XXX" indicates the release number of the latest release.

  3. cd into the `horae-XXX/' directory and issue the following
     commands
         perl Makefile.PL
         make
         make install
     The last step requires root privilege.  You can alternately
     install into your own diskspace by running the "private-install"
     script. 


You are ready to go.  The executables are called "atoms", "athena",
"artemis", and "hephaestus".  If you use csh or tcsh as your shell,
you will need to type "rehash" if you are installing for the first
time.  You will also have the "horae_update" program installed, which
can be used to update the horae package automagically in the future.

Good luck.  Submit bug reports to ravel@phys.washington.edu or to the
ifeffit mailing list and be sure to include enough information for me
to replicate the problem.


WINDOWS
=======

       Athena and Artemis Installation Instructions for Windows


IF YOU WANT TO INSTALL A BINARY PACKAGE FOR WINDOWS -- STOP!!

Download the Ifeffit binary installer package from
   http://cars9.uchicago.edu/ifeffit/download.html
It contains the Ifeffit DLL and recent versions of Athena, Artemis,
TkAtoms, and a few other programs written from other people.

Only follow the instructions on this page if you want to install the
Perl source code for Athena and Artemis on your Windows machine.

			  -----------------

If you really want to install the source code for Athena and Artemis
rather than binary executables, do the following:


1.  Read over the install.unix file.  This is not exactly what you
    need to to do, but you should be familiar with perl source code
    packages before continuing.

2.  Read this document from my web page:
      http://leonardo.phys.washington.edu/~ravel/software/exafs/perlapp.readme
    and follow it religiously.  Steps 0, 1, and 2 in that document
    tell you what you need to do to get Athena and Artemis running on
    your computer as interpreted perl programs.  Step 3 tells you how
    to build your own binary executable.  The "Additional files" step
    is only necessary if you want to work with PerlApp executables.
    All the files mentioned in that section will end up in the Perl
    installation tree in places where the interpreted programs will be
    able to find them.



MACINTOSH OSX
=============

See Ifeffit's web page for installing the disk image.  Once that is
done, the unix instructions can be followed from a terminal window.
See the Ifeffit FAQ for more details.


MACINTOSH OS9
=============

Athena and Artemis are not supported on Macintosh OS9.  This is
because the perl/Tk package does not work on OS9.

Athena and Artemis will probably never be supported on OS9.  Sorry.
