Prev Next

@(@\newcommand{\B}[1]{ {\bf #1} } \newcommand{\R}[1]{ {\rm #1} } \newcommand{\W}[1]{ \; #1 \; }@)@This is dismod_at-20221105 documentation: Here is a link to its current documentation .
The avgint Table: Defines Average Integrand Cases

See Also
Purpose
     Usage
     Parent Rates
     Child Rates
avgint_id
integrand_id
node_id
subgroup_id
weight_id
     null
age_lower
age_upper
time_lower
time_upper
Covariates
Example

See Also
predict_table .

Purpose
Given a value for the model_variables , this table contains the other information necessary so that the predict_command can compute average integrand values that correspond to any possible case, (not just the cases in the data_table ). For an example of how to use this table, see the discussion of parent and child rates below.

Usage
This table is only used by the predict_command . It can be changed, and the predict command can be re-run, without needing to re-run any other commands.

Parent Rates
The parent rates @(@ q_k (a, t) @)@ can be computed by using the following settings in this table:
  1. Set node_id to the parent node id .
  2. Set integrand_id to the integrand corresponding to rate k .
  3. Set age_lower and age_upper set to @(@ a @)@.
  4. Set time_lower and time_upper to @(@ t @)@.
  5. The weight_id does not matter because we are not averaging over age or time.
  6. Set the covariates to null.
Note that the rates and integrands have the following correspondence:
( iota , Sincidence ), ( rho , remission ), ( chi , mtexcess ), ( omega , mtother ).

Child Rates
The child rates can be computed as adjusted rates @(@ r_{i,k} (a, t) @)@ using the following modifications to the parent rate settings above:
  1. Set node_id to the node table node_id for this child.
  2. Set each covariate to its average value for this child.
  3. Set the subgroup_id to the subgroup of interest for this child.


avgint_id
This column has type integer and is the primary key for the avgint table. Its initial value is zero, and it increments by one for each row.

integrand_id
This column has type integer and is the integrand_id that identifies the integrand for this case.

node_id
This column has type integer and is the node_id that identifies the node for this case. If the integrand_name begins with mulcov_, node_id should be null. Otherwise node_id should not be null.

subgroup_id
This column has type integer and is the subgroup_id that identifies the subgroup for this case. The chosen subgroup affects the results through its affect on the covariate multipliers; see mulcov_table .

weight_id
This column has type integer and is the weight_id that identifies the weighting used for this case.

null
If weight_id is null, the constant weighting is used for this data point.

age_lower
This column has type real and is the lower age limit for this case. It must be greater than or equal the minimum age_table value.

age_upper
This column has type real and is the upper age limit for this case. It must be greater than or equal the corresponding age_lower and less than or equal the maximum age_table value.

time_lower
This column has type real and is the lower time limit for this case. It must be greater than or equal the minimum time_table value.

time_upper
This column has type real and is the upper time limit for this case. It must be greater than or equal the corresponding time_lower and less than or equal the maximum time_table value.

Covariates
The covariate columns have type real and column names that begin with the two characters x_. For each valid covariate_id , column x_covariate_id contains the value, for this measurement, of the covariate specified by covariate_id . The covariate value null is interpreted as the reference value for the corresponding covariate.

Example
The file avgint_table.py contains an example avgint table.
Input File: omh/table/avgint_table.omh