Prev

Next

Index-> contents reference index search external

Up-> dismod_at database input mulcov_table

@(@\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 mulcov Table: Covariate Multipliers
Discussion
mulcov_id
mulcov_type
     rate_value
     meas_value
     meas_noise
rate_id
integrand_id
covariate_id
group_id
group_smooth_id
     pini
subgroup_smooth_id
     meas_noise
     pini
Example

Discussion
This table specifies the covariate multipliers and their priors. If this table is empty, there are no covariate multipliers in the model. This table has the following columns

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

mulcov_type
This column has type text. The possible values are:

rate_value
This covariate multiplier adjusts a rate in the average integrand calculation; see alpha . A separate solution of the ordinary differential equation is required for each cohort and each measurement, that has values not equal to the reference for the covariate specified by covariate_id . In other words, measurements that have the reference value for all the rate covariates do not add as much to the computational load.

meas_value
This covariate multiplier adjusts the average integrand to match the measurement value ; see beta .

meas_noise
This covariate multiplier adjusts the measurement noise; see gamma_j .

rate_id
This column has type integer. If mulcov_type is rate_value, rate_id is the rate_id that determines the rate that this covariate and multiplier effects. If mulcov_type is meas_value or meas_noise, this column must be null.

integrand_id
This column has type integer. If mulcov_type is rate_value, this column should be null. If mulcov_type is meas_value or meas_noise, integrand_id is the integrand_id that determines which measurement integrand this multiplier effects. The corresponding integrand cannot be a covariate multiplier; see mulcov_mulcov_id below integrand_name .

covariate_id
This column has type integer and is a covariate_id in the covariate table. This specifies the covariate column in the data_table that this multiplier acts on.

group_id
This column has type integer and is a group_id . There is a fixed effect covariate multiplier for all the data that has a subgroup_id that corresponds to this group id. This covariate only affects the average integrand for data points in this group; see group_id . The group_id cannot be null.

group_smooth_id
This column has type integer and its value is a smooth_id in the smooth_grid table. This smoothing is the prior for the fixed effects corresponding to this covariate multiplier. If the group_smooth_id is null, these fixed effects are always zero and no model_variables are allocated for them.

pini
If group_smooth_id is not null, mulcov_type is rate_value, and rate_id corresponds to rate_name pini, group_smooth_id must correspond to n_age equal to one (because age will have no effect for this covariate multiplier).

subgroup_smooth_id
This column has type integer and its value is a smooth_id in the smooth_grid table. This smoothing is the prior for the random effects corresponding to this covariate multiplier. If the subgroup_smooth_id is null, these random effects are always zero and no model_variables are allocated for them.

meas_noise
If mulcov_type is meas_noise, subgroup_smooth_id must be null.

pini
If subgroup_smooth_is is not null, mulcov_type is rate_value and rate_id corresponds to rate_name pini, subgroup_smooth_id must correspond to n_age equal to one (because age will have no effect for these covariate multipliers).

Example
The file mulcov_table.py contains an example covariate table.

---

Input File: omh/table/mulcov_table.omh