--------------------------------------------
lines 110-187 of file: xrst/all_node_db.xrst
--------------------------------------------

{xrst_begin omega_all}

All Node omega Values
#####################
The combination of the omega_all and omega_index tables specify
the value of :ref:`glossary@omega` for all the nodes that have omega data.

omega_all Table
***************
This table specifies the value of :ref:`glossary@omega` for each
age, time point in the :ref:`omega_grid-name`, every node, and each reference
in the :ref:`split_reference_table-name`.
This data is used to compute the :ref:`omega_constraint-name` for each node.
If omega is not specified for a node, it will use the same *omega*
values as its nearest ancestor node.
It is an error if there is no ancestor of a
:ref:`goal node<glossary@fit_goal_set>` that has omega data.

omega_all_id
============
is the :ref:`all_node_db@Primary Key` for this table.

omega_all_value
===============
This column has type ``real`` and is the value of omega
for a specific node, age, and time; see omega_index table below.
Each value in this column is omega at a specific age and time
not on an age or time interval. If you only have omega on age and time
intervals, use the midpoint age and midpoint time in the omega grid.

omega_index Table
*****************
This table specifies the omega_all_id at which the omega values
for a particular node and split_reference begin.
Specifications for which age and time points
correspond to each omega_all_id are included below.

omega_index_id
==============
is the :ref:`all_node_db@Primary Key` for this table.

node_id
=======
This column has type ``integer`` and specifies a node by its index
in the root node database node table.

split_reference_id
==================
This column has type ``integer`` and it specifies the
index of a value in
:ref:`split_reference_table-name`.
If split_reference_table is empty (is not empty),
the values in this column must be (must not be) null.

omega_all_id
============
This column has type ``integer`` and specifies the index in the
omega_all table where the omega values begin,
for this node and split_reference value.
For the age index *i* equal 0 through
:ref:`n_omega_age-1<omega_grid@omega_age_grid Table@n_omega_age>`
and time index *j* equal 0 through
:ref:`n_omega_time-1<omega_grid@omega_time_grid Table@n_omega_time>` ::

   omega_all_id + i * n_omega_time + j

is the value of *omega_all_id* in the omega_all table where the
*omega_all_value* is located
for this *node_id*,
this *split_reference_id*,
the *i*-th age in the omega_grid,
and the *j*-th time in the omega_grid.
Note that each omega_all_id in the omega_index table
should be a multiple of n_omega_age * n_omega_time
(because there are that many omega entries for each node and each
split_reference value).

{xrst_end omega_all}