== <table> ==

A table object is like a spreadsheet of values.

== Energy Levels ==

If you store output data in a table with one column as energy and the other as string labels, Rappture will interpret the data as a series of energy levels and draw it as shown below.  If one of the labels is "HOMO", then Rappture will draw the area underneath the HOMO level as shaded, indicating that the states are occupied.

[[rpimage(zoo_energies.gif)]]
{{{
  <table>
    <about>
      <label>Energy Levels</label>
    </about>
    <column id="labels">
      <label>Name</label>
    </column>
    <column id="energies">
      <label>Energy</label>
      <units>eV</units>
    </column>
    <data> 1  0.561
HOMO  2.24
3     5.05
...
    </data>
  </table>
}}}

You can see working code in the [browser:trunk/examples/zoo zoo of examples] in the [browser:trunk/examples/zoo/table table example] or on the hub in the directory /apps/rappture/examples/zoo/table.