------------------------------------------------
lines 13-53 of file: at_cascade/csv/set_truth.py
------------------------------------------------

{xrst_begin csv.set_truth}
{xrst_spell
  var
}

Set the Truth Table for a Fitted Database
#########################################

Prototype
*********
{xrst_literal
    # BEGIN_SET_TRUTH
    # END_SET_TRUTH
}

sim_dir
*******
Is the :ref:`csv.simulate@sim_dir` for the simulation
of this cascade data set.

fit_database
************
Is the name of a database, relative to the current directory,
that corresponds to a fit.

#. A new ``truth_var`` table is written to this database
   containing the dismod_at variable values corresponding to truth
   during the simulation.

#. Note that the rate random effects are in log space and relative
   to the fixed effect rate at the same age and time.

#. The contents of the database, and not its location relative to the
   :ref:`csv.fit@fit_dir` is used to determine the node and sex for
   the truth. In fact, this routine does not know what the *fit_dir* is.

root_database
*************
is the :ref:`glossary@root_database` .

{xrst_end csv.set_truth}