Provided by: horae_071~svn537+ds1-1_all bug

NAME

       athena - interactive XAS data processing

SYNOPSIS

       athena  file...

DESCRIPTION

       This  manpage documents the athena program, for interactive XAS data processing, including
       converting raw data to mu(E), aligning, merging, deglitching,  Fourier  transforming,  and
       plotting.   Basically,  Athena  is intended to handle all chores involving XAS data except
       for quantitative analysis by fitting to theoretical standards.   Athena's  sister  program
       Artemis is the fitting program.

       Athena  has  two interesting and unusual features.  The first is that there are no buttons
       for explicitly  removing  the  background  from  mu(E)  data  or  for  performing  Fourier
       transforms.   The  only  active  buttons  displayed  on  the main window are for plotting.
       Athena always knows when data requires a background removal or  a  Fourier  transform  and
       will perform the necessary analysis steps before displaying the plot.

       The second interesting feature is that it is just as easy to perform analysis and plotting
       chores on multiple data sets as on an individual data  set.   Athena  automates  the  most
       common data processing chores and automatically generates plots of one or more data sets.

SYNOPSIS

       Athena  is  a  graphical and interactive program written in the perl programming language,
       using the Tk display engine, the IFEFFIT EXAFS library, and the PGPLOT  plotting  library.
       (See below for a list of relevant URLs.)

       When  Athena  starts,  you  are  presented with a window whose layout looks something like
       this:

              +----------------------------------------+
              |    menubar                             |
              +---------------------------+------------+
              |                           |            |
              |                           |            |
              |                           |   Group    |
              |     Group                 |   List     |
              |    Parameters             |            |
              |                           |            |
              |                           |            |
              |                           +------------+
              |                           | Plot crrnt |
              |                           +------------+
              |                           | Plot mrked |
              |                           +------------+
              |                           |            |
              |                           |   Plot     |
              |                           |  Features  |
              |                           |            |
              |                           |            |
              +---------------------------+------------+
              |    echo area                           |
              +----------------------------------------+

       As you import data into Athena, data groups are created and those groups are listed in the
       section  labeled `Group List' .  You select a group as the active one by clicking the left
       mouse button on its entry in the group list.  When selected, the list entry is highlighted
       with  an  orange background and the parameters associated with that group are displayed in
       the large area on the left labeled `Group Parameters'.  When you pass  the  mouse  over  a
       label in the group parameters section, you will notice that the label changes color.  This
       indicates that a mouse click on the label will have an effect.  Clicking  the  left  mouse
       button will display a hint in the echo area as to the function of that parameter.  See the
       section on group operations for the effect of a right mouse click.

       The view of the group parameters is replaced when certain features  of  Athena  are  used.
       Choosuing  any  of  the  options  from  the  Data,  Align,  Diff,  or  Analysis menus will
       temporarily replace the group parameters with views of parameters relevant to  the  chosen
       task.   For  example, when the log-ratio option is chosen from the Analysis menu, the view
       of  group  parameters  is  replaced   by   a   view   of   the   interface   to   Athena's
       log-ratio/phase-difference analysis.

       Below  the  group  list are two rows of button for plotting data.  The red buttons are for
       plotting the selected data group.  The purple  buttons  are  for  plotting  multiple  data
       groups.   These buttons are labeled according to the data space of the plot.  E, k, R, and
       q refer to energy, photoelectron k, real space R, and backtransform k, respectively.

       Below the plot buttons are a set of tabs for specifying the details of the plots  in  each
       space.  For each space you can specify the range of the x-axis.  For energy plots, you can
       select whether the background function is plotted along with the data and whether the data
       and  background  are  normalized.   For  k-space  plots,  you  can  select  the  amount of
       k-weighting.  For R- and q-space plots,  you  can  select  which  part  of  those  complex
       functions  are  plotted.   There  are  also  tabs  for  setting  up  stacked plots and for
       establishing plot indicators.  For a complete discussion see the section on plotting.

       Finally, at the bottom of the page is the echo area.  Athena uses  this  area  to  display
       hints,  brief  help  messages,  warnings, and updates about recently performed analysis or
       plotting actions.  A few features of Athena will prompt the user for a  text  string.   In
       those situations, the echo area is temporarily replaced by text string dialog.

       Throughout  Athena  the  right mouse button serves to post context sensitive menus.  These
       include parameter labels, groups list entries, and other  elements  on  the  screen.   You
       should  try clicking the right mouse button in different places to see what usefuls things
       might pop up.

REFERENCES

       Here are the relevant URLs:

       IFEFFIT
           http://cars.uchicago.edu/ifeffit

       PGPLOT
           http://www.astro.caltech.edu/~tjp/pgplot/

       Perl
           http://www.perl.com

       perl/Tk
           http://www.lehigh.edu/~sol0/ptk/

       Central atom phase shifts
           http://leonardo.phys.washington.edu/~ravel/software/feff_tables/

MISSING FEATURES

       You betcha!  Lots!  Here's a partial list:

       *   Principal Component Analysis on the set of marked groups

       *   XANES analysis by fitting a sum of scans to an unknown

       *   Dead-time and self-absorption corrections

       *   Handle dispersive data sets, i.e. data sets wherein the I0 and IT measurements are  in
           separate data files becuase the data were obtained sequentially

       *   Calibrate dispersive data to a trusted standard

       *   Handle  SPEC  files. An independent perl module would be ideal. This is a project some
           eager contributor could tackle without having to delve into ATHENA's source code.

       *   Alignment of scans using a reference, either of the same edge or  of  a  nearby  edge.
           (Any suggestions? I am lacking a good idea about how to implement this...)

       *   Formulas for the energy axis (useful for converting encoder readings to energy values)

       *   R and q space records, that is to be able to read and write data in R and q space just
           as easily as E or k space.

       *   Internationalization. That is, build a framework for having  text  strings  read  from
           external files and for the language to be a configuration option.

       *   Documentation, documentation, documentation

WHAT'S IN A NAME?

       Athena was the goddess of wisdom and is also associated with skill and justice.  Those are
       all good qualities for a data analysis program!

OPTIONS

       This program requires no options.

SEE ALSO

       This program is part of the horae XAS analysis suite which can be obtained at
       http://cars9.uchicago.edu/~ravel/software/

AUTHOR

       Bruce Ravel <ravel@phys.washington.edu> (c) 2001 - 2003

       Ifeffit is copyright (c) 1992 - 2003 Matt Newville
       newville@cars.uchicago.edu
       http://cars9.uchicago.edu/~newville/ifeffit/

                                          June 26, 2006                                 athena(1)