Column output files

Writing output for your favorite plotting program

After doing a lot of analysis, you will eventually need to make beautiful pictures for publication. As a glance at any of the screenshots in this document will attest, the graphical output of ATHENA is adequate but far from beautiful. Fortunately, ATHENA can export your data in a variety of ways and in a format that can be imported easily into almost any other program, such as a spreadsheet or a graphics package such as Origin or Kaleidegraph.

The current data set -- the one marked in red in the group list and the one whose parameters are displayed in the main window -- can be saved in a number of ways. The various choices are listed under the File menu, as seen in the figure below. Note that χ(k) data can be saved with various k-weightings using the entries in the submenu.

Exporting a column data file for a group.

The columns in the μ(E) output file are:

  1. energy

  2. μ(E)

  3. background

  4. pre-edge line

  5. post-edge line

  6. derivative of μ(E)

  7. second derivative of μ(E)

  8. I0

If the data group is marked as being XANES data, then the background column will be all zeros.

The columns in the norm(E) output file are:

  1. energy

  2. normalized μ(E)

  3. normalized background

  4. flattened μ(E)

  5. flattened background

  6. derivative of normalized μ(E)

  7. second derivative of normalized μ(E)

If the data group is marked as being XANES data, then the normalized and flattened background columns will be all zeros.

The columns in the χ(k) output files are:

  1. k

  2. unweighted χ(k)

  3. k-weighted χ(k)

  4. k-squared-weighted χ(k)

  5. k-cubed-weighted χ(k)

  6. Fourier transform window

  7. Energy in absolute units

The χ(R) output file contains both parts of the complex Fourier transform, as well as the magnitude and phase. That is, of course, redundant, but it's also convenient. The columns are:

  1. R

  2. real part of χ(R)

  3. imaginary part of χ(R)

  4. magnitude of χ(R)

  5. phase of χ(R)

  6. back transform window

For the sake of clarity, we use the letter “q” to represent Fourier filtered wavenumber. The χ(q) output file also contains both parts of the complex back transform, as well as the magnitude and phase.

  1. q

  2. real part of χ(q)

  3. imaginary part of χ(q)

  4. magnitude of χ(q)

  5. phase of χ(q)

  6. Fourier transform window

  7. χ(k) with the k-weighting used in the FT

In certain situations, it is much more convenient to write column data files containing data from many groups. This is done with the help of the mark buttons. The data from each of the marked groups can be saved in a variety of forms using the “saved marked groups” submenu, as shown below.

Exporting column data files for the set of marked groups.

The output file will contain the x-axis value (i.e. energy, k, R, or q) in the first column. The remaining columns will contain each of the marked data groups, in the order they appear in the group list.

The final column output option is to export each of the marked groups as a single data column file of the sort described above. When you select one of the output file types shown below you are prompted to select a directory. Each marked group will be exported to a file in that directory with a file name formed from the group label.

Exporting column data files for each of the marked groups.

The standard folder selection dialog is used for exporting each marked group. Select a folder and each file will be recorded there.

To do! Show correct header -- what is shown below is out-of-date

All of the output files discussed on this page have a header of the form shown below. The first line identifies the version of ATHENA used to write the file. The second line identifies the type of file. The next several lines summarize all the parameters from the main window. The remaining lines are any header files recognized by ATHENA from the original data file.

# Athena data file -- Athena version 0.8.052
# Saving fe.300 as mu(E)
# .  Element=Fe   Edge=K
# Background parameters
# .  E0=7106.497  Eshift=0.000  Rbkg=1.000
# .  Standard=0: None
# .  Kweight=1.0  Edge step=2.825
# .  Fixed step=no    Flatten=yes
# .  Pre-edge range: [ -150.000 : -30.000 ]
# .  Pre-edge line: 3.2697 -0.00046675 * E
# .  Normalization range: [ 50.000 : 1836.447 ]
# .  Post-edge polynomial: 32.673 -0.006723 * E + 3.5408e-07 * E^2
# .  Spline range: [ 0.000 : 1856.458 ]   Clamps: None/Strong
# Foreward FT parameters
# .  Kweight=0.5   Window=kaiser-bessel   Phase correction=no
# .  k-range: [ 2.000 : 21.900 ]   dk=1.00
# Backward FT parameters
# .  R-range: [ 1.000 : 3.000 ]
# .  dR=0.00   Window=kaiser-bessel
# Plotting parameters
# .  Multiplier=1   Y-offset=0.000
# .
# XDAC V1.2 Datafile V1
# "fe.300" created on 10/4/02 at 9:37:52 AM on X-11A
# ring energy= 2.58 GeV
# E0= 7112.00
# NUM_REGIONS= 3
# RB= -200 -20 20 22k
# RSS= 5 0.5 0.05k
# PP= 2 2 2
# settling time= 0.50
# offsets= 9925.80 9914.40
# gains= 7.00 7.00
# iron foil, I0: 50N2, It:N2, 300K
#------------------------