Risk Engine

POST https://models-nl.dacadoo.com/risk/1.6.0

Request

Field Required Description
control No The control input. See table below.
mhm Yes The metric health model input. See table below.
smk No The smoking input. See table below.
mvm No The movement input. See table below.
slp No The sleep input. See table below.
nut No The nutrition input. See table below.
qlm No The quality of life input. See table below.
preg No The pregnancy input. See table below.
clip No If true, clips out-of-bounds values instead of returning an error status; if false, returns an error status if a value is out-bounds as to the documented limits and an additional margin of tolerance.

The use of data values can by any combination of imputation (used to derive other values), imputed (either derived from other values or set to a default value), confidence (confidence intervals are provided), and estimation (used to estimate some risk) as given by the Use column in the tables below.

Control

Control parameters. These parameters control aspects of certain estimations in the engine, and provide feedback on control paths taken (on output).

Field Required Description Min Max Use
duration Time horizon of overall mortality, cancer, cardiovascular disease and metablic dysfunction estimates (default 15). Rounded down to the closest integer. [years] 1 15 estimation
conf_level Confidence level (default 0.95). Used both for confidence intervals and interview guidance. 0.5 1 confidence, guidance
conf_onesided Confidence interval one-sided = 1, two-sided = 0 (default) 0 1 confidence, guidance
inter_endpoint Desired endpoint for interview guidance [ see below ]
	inter_endpoint codes:

	   0  =>  Overall mortality. Mortality from all-cause excluding accidental death.
	   1  =>  Cancer.
	   2  =>  Cardiovascular disease.
	   3  =>  Hypertension.
	   4  =>  Type 2 diabetes mellitus.
	   5  =>  Metabolic dysfunction.
	   6  =>  COVID-19 susceptibility, i.e. risk if contracted.
	   7  =>  Chronic Obstructive Pulmonary Disease.
0 7 guidance
qlm_version Quality of life questionnaires used (either 2014 or 2021). Output only. estimation
shap_endpoint Desired endpoint for SHAP [ see below ]
	shap_endpoint codes:

	   0  =>  Overall mortality. Mortality from all-cause excluding accidental death.
	   1  =>  Cancer.
	   2  =>  Cardiovascular disease.
	   3  =>  Hypertension.
	   4  =>  Type 2 diabetes mellitus.
	   5  =>  Metabolic dysfunction.
	   6  =>  COVID-19 susceptibility, i.e. risk if contracted.
	   7  =>  Chronic Obstructive Pulmonary Disease.
0 7 shap
shap_ref Flag to select reference population [ see below ]
      shap_ref codes:

         0  =>  Self-contained: SHAP values are computed comparing to required information (default).
         1  =>  Average NHANES.
         2  =>  Best 25% from NHANES.
0 2 shap
min_entries_ts Minimum entries required in a time-series to be considered (default 1) 1 70 estimation

Metric Health Model

Health data. ICD-10 codes are provided where applicable. They cover the broad definition used in the underlying research.

Field Required Description Min Max ICD-10 Use
age Yes Age in years [years] 17 90 imputation, estimation
sex Yes Male = 1 Female = 0 [.] 0 1 imputation, estimation
hgt Yes Height [cm] 85 215 imputation, estimation
wgt Yes Weight [kg] 35 165 imputation, estimation
bmi Body-mass index (always computed from height and weight) [kg/m^2] 15.5 45.5 imputed
a1c Glycated hemoglobin [%] 3.5 10.5 imputation, imputed, confidence, estimation
abi Ankle-Brachial index [.] 0.7 1.5 imputed, confidence
acr Albumin-creatinine (urine) ratio [mg/mmol] 0 100 imputation, imputed, confidence, estimation
adi Adiponectin [ug/mL] 0.01 18 imputed
alb Serum albumin [g/L] 32 53 imputed, confidence
alt Alanine aminotransferase [units/L] 4 83 imputed, confidence
apoA Apolipoprotein A-1 [g/L] 0.8 2.3 imputed, confidence
apoB Apolipoprotein B-100 [g/L] 0.4 2 imputed, confidence
ast Aspartate aminotransferase [units/L] 10 60 imputed, confidence
bun Blood urea nitrogen [mmol/L] 1.5 13 imputed, confidence
cac Coronary Artery Calcium score [HU] 0 1001 imputed
cal Serum calcium [nmol/L] 2 3 imputed, confidence
cpt C-Peptide [nmol/L] 0 4 imputed, confidence
cre Serum creatinine [umol/L (micro-mol)] 20 180 imputation, imputed, confidence, estimation
crp High-sensitivity C-reactive protein [mg/L] 0.1 10 imputed, confidence, estimation
cys Serum Cystatin-C [mg/L] 0 2.5 imputation, imputed, confidence, estimation
dbp Diastolic blood pressure [mmHg] 40 120 imputation, imputed, confidence, estimation
eag Estimated average glucose [mmol/L] 3 14 imputation, imputed, confidence, estimation
fat Body fat % [%] 6 55 imputation, imputed, confidence, estimation
fbg Fasting blood glucose [mmol/L] 3 14 imputation, imputed, confidence, estimation
fev Forced expiratory volume (1 sec) [L] 0 6 imputed, confidence
fib Fibrinogen [g/L] 1 6 imputed, confidence
fvc Forced Vital capacity [L] 0.5 7 imputed, confidence
gfr Glomerular filtration rate [mL/min/1.73 m^2] 18 180 imputation, imputed, confidence, estimation
ggt gamma-Glutamyltransferase [units/L] 3 140 imputed, confidence
hcy Plasma Homocysteine [umol/L] 2 23 imputed, confidence
hdl High-density lipoprotein [mmol/L] 0.5 3 imputation, imputed, confidence, estimation
hgn Hemoglobin (whole blood) [g/L] 95 185 imputed, confidence
ins Serum insulin [pmol/L] 9 400 imputation, imputed, confidence
ldl Low-density lipoprotein [mmol/L] 1 7 imputation, imputed, confidence, estimation
map Mean arterial blood pressure [mmHg] 50 130 imputation, imputed, confidence, estimation
msy Metabolic Syndrome [.] 0 1 imputed
PDM Pre-diabetes / IGT [.] 0 1 imputed, estimation
pot Serum Potassium [mmol/L] 3 5 imputed, confidence
ppr Pulse pressure [mmHg] 20 125 imputation, imputed, confidence, estimation
qtc Bazett-corrected QTc interval [ms] 350 500 imputed
qrs QRS duration [ms] 62 195 imputed, confidence
rhr Resting heart rate [bpm] 35 120 imputation, imputed, confidence, estimation
sbp Systolic blood pressure [mmHg] 80 190 imputation, imputed, confidence, estimation
sfe Serum iron [umol/L] 3 50 imputed, confidence
sod Serum sodium [nmol/L] 130 150 imputed, confidence
spo2 Blood Oxygen Saturation (SpO2) [%] 92 100 imputed, estimation
tgl Triglycerides [mmol/L] 0.2 6.5 imputation, imputed, confidence, estimation
tsc Total serum cholesterol [mmol/L] 2 10 imputation, imputed, confidence, estimation
vdl Very low density lipoprotein [mmol/L] 0.1 2.8 imputation, imputed, estimation
vo2max Maximal aerobic capacity (VO2max) [mL/kg/min] 16.8 59.8 imputed, confidence, estimation
whr Waist to hip ratio [.] 0.6 1.2 imputation, imputed, confidence, estimation
wst Waist circumference [cm] 50 150 imputation, imputed, confidence, estimation
exh Self-reported exercise hours per week [hrs/week] 0 21 imputed, estimation
alc Alcohol daily intake [EtOH g/day] 0 70 imputed, confidence, estimation
cof Cups of coffee per day [number/day] 0 6 imputed, estimation
cst Corticosteroid usage 0 1 imputed, estimation
AFN Diagnosed with atrial fibrilation 0 1 I8 imputed
ANM Diagnosed with anemia 0 1 D50-53,D55-59,D60-64 imputed
CHD Coronary heart disease 0 1 I20-I25 imputed
CHF Diagnosed Heart Failure 0 1 I11.0,I13.0,I50 imputed
CKD Diagnosed with Chronic Kidney Disease 0 1 N18 imputation, imputed, estimation
CVD Diagnosed with cardiovascular disease 0 1 I11,I13,I15,I20-I28,I30-I52,I60-I79 imputed, estimation
DM2 Diagnosed with diabetes mellitus 0 1 E10-E14 imputation, imputed, estimation
DYS Has Dyspnoea (shortness of breath) when walking 0 1 R06.0 imputed, estimation
HTN Diagnosed with arterial hypertension or SBP >= 140 DBP >= 90 0 1 I10-I13,I15 imputation, imputed, estimation
LVH Diagnosed with left ventricular hypertrophy 0 1 I51.7 imputed, estimation
PAD Diagnosed with Peripheral Arterial Disease 0 1 I70.2,I73.9 imputed
PMI Has had an MI 0 1 I21-I22 imputation, imputed, estimation
PRA Diagnosed with proteinuria / albuminuria 0 1 R80 imputed
RBB Right bundle-branch block 0 1 I45.1 imputed
SPT Produces sputum (phlegm, thick type of mucus made in lungs) 0 1 R09.3 imputed, estimation
STH Has asthma 0 1 J45 imputed, estimation
TDM Currently in treatment for diabetes 0 1 imputation, imputed, estimation
THT Currently in treatment for hypertension 0 1 imputation, imputed, estimation
VDS Valvular disease (all) 0 1 I05-I08,I34-I37,Q22-Q23 imputed
fCV Immediate family history of premature heart disease or stroke (at age < 60) 0 1 imputed, estimation
fDM Immediate family history of diabetes 0 1 imputation, imputed, estimation
fMI Immediate family history of premature angina or heart attack (at age < 60) 0 1 imputed, estimation
pHT Parental hypertension: 0 (none), (1) one parent, (2) both 0 2 imputation, imputed, estimation
hrM Maximum heart rate 100 195 imputed, confidence

Smoking

Smoking history and status.

Field Required Description Min Max Use
now Currently a smoker; 0 = no, 1 = yes 0 1 imputation, imputed, estimation
evr Was a smoker at some point; 0 = no, 1 = yes 0 1 imputation, imputed, estimation
yrs Years smoked [years] 0 80 imputation, imputed, estimation
num Number per day [.] 0 30 imputed, confidence, estimation
qit Years since quitting [years] 0 80 imputation, imputed, estimation
slt Current use of smokeless tobacco; 0 = no, 1 = yes 0 1 imputed, estimation

Movement

Energy transfer from physical activity, represented as time series up to 70 days with array index 0 being today. Use null for gaps where the quantity is unknown. A proprietary aggregation is applied to the series. To control the aggregation externally, fill in index 0 only. In case that the time series is empty, the variable exh is used instead.

Field Required Description Min Max Use
nrg normenergy in MET h 0 imputation, estimation

Sleep

Sleep, represented as three time series (time asleep, time in bed and times awoken) up to 70 days with array index 0 being today. Use null for gaps where the quantity is unknown. A proprietary aggregation is applied to the series. To control the aggregation externally, fill in index 0 only. Note that for a night to be considered, time asleep must be provided. If no valid night is provided, the average sleep time slp_avg is used instead.

Field Required Description Min Max Time series Use
bed Time in bed, in hours 0 Yes estimation
slp Time asleep, in hours 0 Yes estimation
awk Times awoken 0 Yes estimation
slp_avg Average sleeping time, in hours 0 estimation

Nutrition

Nutrition questions. These questions are meant to be answered with a slider ranging from never (0) to all the time (1). The questions denoted as Starter must all be answered for the input to be considered.

Field Required Description Min Max Starter Use
nqs01 ... eat less than 2 servings of fruit a day? 0 1 Yes estimation
nqs02 ... eat less than 1 serving of peanuts or peanut butter, other nuts, nut butters, and seeds a day? 0 1 Yes estimation
nqs03 ... eat less than 2 servings of dark leafy green vegetables or other types of vegetables? 0 1 Yes estimation
nqs04 ... eat less than 2 servings of legumes a week? 0 1 estimation
nqs05 ... prefer whole grain breads, pasta, or cereal instead of refined breads, pasta, or cereal? 0 1 Yes estimation
nqs06 ... prefer fish that was neither fried nor breaded instead of red or processed meat? 0 1 estimation
nqs07 ... eat more than 2 servings of fried or breaded foods a week? 0 1 estimation
nqs08 ... prefer olive, canola, high oleic safflower, [...] instead of other oils or fats for cooking? 0 1 estimation
nqs09 ... eat candy bars, pastries, cookies, cakes, or frozen desserts (ice cream) more than twice a day? 0 1 estimation
nqs10 ... limit your salt intake by reducing [...] the salt content of processed foods? 0 1 estimation
nqs11 ... drink more than 6 glasses of water or other unsweetened beverages a day? 0 1 estimation
nqs12 ... drink 2 glasses or more of sugar-sweetened beverages a day? 0 1 Yes estimation
nqs13 ... drink more than 1 serving of alcohol a day? 0 1 estimation
nqs14 ... take a moment before you ate to appreciate the colors and smells of your food? 0 1 estimation
nqs15 ... eat more than 3 servings of processed foods a week? 0 1 estimation
nqs16 ... eat at least two main meals a day? 0 1 Yes estimation
nqs17 ... snack without noticing that you were eating? 0 1 Yes estimation
nqs18 ... eat 3 or more meals a week from a fast food restaurant? 0 1 estimation
nqs19 ... stop eating when you were full even when eating something you love? 0 1 estimation
nqs20 ... recognize when food advertisements made you want to eat? 0 1 estimation
nqs21 ... go find something to eat when you were feeling stressed? 0 1 estimation
nqs22 ... skip breakfast and eat your first main meal at lunchtime? 0 1 estimation

Quality of Life

Psychometric questions. These inputs relate to multiple questionnaires and are meant to be answered with a slider as follows:

Prefix Designation Status Preamble Slider
q Quality of Life (2014) Superseded by GAD-7, PHQ-9, PSS-10, GSRH and MAAS None not at all (0) to very much so (1)
gad General Anxiety Disorder-7 (GAD-7)1 Current Over the last two weeks, how often have you been bothered by the following problems ... not at all (0) to nearly every day (1)
phq Patient Health Questionnaire-9 (PHQ-9)2 Current Over the last two weeks, how often have you been bothered by the following problems ... not at all (0) to nearly every day (1)
pss Perceived Stress Scale (PSS-10)3 Current In the last month, how often have you ... never (0) to very often (1)
gsrh General Self-Related Health Current None poor health (0) to excellent health (1)
maas Mindful Attention and Awareness Scale (MAAS)4 Current None almost never (0) to almost always (1)

References:

  1. From "A Brief Measure for Assessing Generalized Anxiety Disorder: The GAD-7" by Spitzer RL, Kroenke K, Williams JBW, Löwe B, Arch Intern Med., 2006, doi:10.1001/archinte.166.10.1092.
  2. From "The PHQ-9: validity of a brief depression severity measure" by Kroenke K, Spitzer RL, Williams JB, J Gen Intern Med., 2001, 10.1046/j.1525-1497.2001.016009606.x.
  3. From "Perceived stress in a probability sample of the United States" by Cohen S, Williamson G, Spacapan S, Oskamp S, The social psychology of health., 1988, doi.org/10.21961/mdm:24503, Reprinted with permission.
  4. From "The benefits of being present: Mindfulness and its role in psychological well-being" by Brown KW, Ryan RM, Journal of Personality and Social Psychology, 2003, doi:10.1037/0022-3514.84.4.822, Reprinted with permission.

The superseded Quality of Life (2014) model is used if and only if at least one of its inputs is provided and none of the GAD, PHQ, PSS or GSRH (2021) model inputs are provided. In all other cases, including no input at all, the 2021 model is used. If a transition from the 2014 model to the 2021 model takes place, it should be for as many inputs as possible at once, as the 2014 inputs are no longer used once a single 2021 input is provided. The control structure (see table above) indicates on output which model was used. A similar logic is used for imputations as well: if the 2014 model is used, then imputations to PHQ, PSS and GSRH are not produced. Because in the old model anxiety was not included, imputations to GAD are always returned. In all other cases, both imputations to the 2021 and 2014 models are returned. The MAAS questionnaire works independently: if at least one input of the superseded Quality of Life (2014) model and no input of the MAAS (2021) model is provided, then no imputation is produced for MAAS. In all other cases, both imputations to MAAS and the 2014 model are returned.

Note that SHAP values are not supported when working with the old questionnaire.

Field Required Description Min Max Use
q01 Do you feel you are in good health? 0 1 imputed, estimation
q02 Are you satisfied with your state of health? 0 1 imputed, estimation
q03 How often are you in physical or emotional pain? 0 1 imputed
q04 Does pain interfere with your enjoyment of life? 0 1 imputed, estimation
q05 Does your physical health interfere with your daily activities? 0 1 imputed
q06 Does your emotional health interfere with your daily activities? 0 1 imputed, estimation
q07 Do you feel hopeful about the future? 0 1 imputed, estimation
q08 Do you feel anxious or under stress? 0 1 imputed, estimation
q10 Do you enjoy eating? 0 1 imputed, estimation
q11 Do you feel full of energy? 0 1 imputed, estimation
q12 Do you feel sad or depressed? 0 1 imputed, estimation
q13 Do you feel calm and relaxed? 0 1 imputed, estimation
q14 Do you feel that your efforts are fully appreciated? 0 1 imputed, estimation
q15 Do you feel good about your life in general? 0 1 imputed, estimation
q16 Do you feel good about your social interactions? 0 1 imputed, estimation
q17 Do you feel good about yourself? 0 1 imputed, estimation
q18 Do you feel good about your financial situation? 0 1 imputed, estimation
q19 Do you feel good about the quality of your sleep? 0 1 imputed, estimation
q20 Do you feel good about your work? 0 1 imputed, estimation
q21 Do you exercise regularly? 0 1 imputed, estimation
q22 Do you keep a healthy diet? 0 1 imputed, estimation
q24 Do you think your physical health will improve in the near future? 0 1 imputed, estimation
q25 Do you think your emotional health will improve in the near future? 0 1 imputed, estimation
q26 Do you think the overall quality of your life will improve in the near future? 0 1 imputed, estimation
q27 Do you think your outlook on life will improve in the near future? 0 1 imputed, estimation
gad01 ... feeling nervous, anxious, or on edge? 0 1 imputed, estimation
gad02 ... feeling you are unable to stop or control worrying? 0 1 imputed, estimation
gad03 ... feeling you worry too much about different things? 0 1 imputed, estimation
gad04 ... having trouble relaxing? 0 1 imputed, estimation
gad05 ... feeling so restless that it is hard to sit still? 0 1 imputed, estimation
gad06 ... becoming annoyed or irritated? 0 1 imputed, estimation
gad07 ... feeling afraid of something awful happening? 0 1 imputed, estimation
phq01 ... little interest or pleasure in doing things? 0 1 imputed, estimation
phq02 ... feeling down, depressed, or hopeless? 0 1 imputed, estimation
phq03 ... trouble falling or staying asleep, or sleeping too much? 0 1 imputed, estimation
phq04 ... feeling tired or having little energy? 0 1 imputed, estimation
phq05 ... poor appetite or overeating? 0 1 imputed, estimation
phq06 ... feeling bad about yourself, or that you are a failure or have let yourself or your family down? 0 1 imputed, estimation
phq07 ... trouble concentrating on things, such as watching television? 0 1 imputed, estimation
phq08 ... moving or speaking so slowly that other people could have noticed or being so fidgety or restless that you have been moving around a lot more than usual? 0 1 imputed, estimation
phq09 ... thoughts that you would be better off dead or of hurting yourself in some way? 0 1 imputed, estimation
pss01 ... been upset because of something that happened unexpectedly? 0 1 imputed, estimation
pss02 ... felt that you were unable to control the important things in your life? 0 1 imputed, estimation
pss03 ... felt nervous and stressed? 0 1 imputed, estimation
pss04 ... felt confident about your ability to handle your personal problems? 0 1 imputed, estimation
pss05 ... felt that things were going your way? 0 1 imputed, estimation
pss06 ... found that you could not cope with all the things that you had to do? 0 1 imputed, estimation
pss07 ... been able to control irritations in your life? 0 1 imputed, estimation
pss08 ... felt that you were on top of things? 0 1 imputed, estimation
pss09 ... been angered because of things that happened that were outside of your control? 0 1 imputed, estimation
pss10 ... felt difficulties were piling up so high that you could not overcome them? 0 1 imputed, estimation
gsrh How would you rate your health? 0 = poor health, 1 = excellent health 0 1 imputed, estimation
maas01 I could be experiencing some emotion and not be conscious of it until some time later. 0 1 imputed
maas02 I break or spill things because of carelessness, not paying attention, or thinking of something else. 0 1 imputed
maas03 I find it difficult to stay focused on what’s happening in the present. 0 1 imputed
maas04 I tend to walk quickly to get where I’m going without paying attention to what I experience along the way. 0 1 imputed
maas05 I tend not to notice feelings of physical tension or discomfort until they really grab my attention. 0 1 imputed
maas06 I forget a person’s name almost as soon as I’ve been told it for the first time. 0 1 imputed
maas07 It seems I am “running on automatic” without much awareness of what I'm doing. 0 1 imputed
maas08 I rush through activities without being really attentive to them. 0 1 imputed
maas09 I get so focused on the goal I want to achieve that I lose touch with what I am doing right now to get there. 0 1 imputed
maas10 I do jobs or tasks automatically, without being aware of what I’m doing. 0 1 imputed
maas11 I find myself listening to someone with one ear, doing something else at the same time. 0 1 imputed
maas12 I drive places on “automatic pilot” and then wonder why I went there. 0 1 imputed
maas13 I find myself preoccupied with the future or the past. 0 1 imputed
maas14 I find myself doing things without paying attention. 0 1 imputed
maas15 I snack without being aware that I’m eating. 0 1 imputed

Pregnancy

Pregnancy related inputs for risk adjustments.

Field Required Description Min Max Use
is_pregnant Current pregnancy status; 0 = no, 1 = yes 0 1 imputation
wgt_week Pregnancy week when wgt was last measured 0 57 imputation, estimation
prewgt Pre-pregnancy weight [kg] 35 165 imputation, estimation
dbp_week Pregnancy week when dbp was last measured 0 57 imputation, estimation
hdl_week Pregnancy week when hdl was last measured 0 57 imputation, estimation
ldl_week Pregnancy week when ldl was last measured 0 57 imputation, estimation
rhr_week Pregnancy week when rhr was last measured 0 57 imputation, estimation
sbp_week Pregnancy week when sbp was last measured 0 57 imputation, estimation
tgl_week Pregnancy week when tgl was last measured 0 57 imputation, estimation
tsc_week Pregnancy week when tsc was last measured 0 57 imputation, estimation
end_week End of pregnancy week 0 45 imputation, estimation

Response

Field Guaranteed Description
control Yes The control output. See table above.
risks Yes The estimated risks. See table below.
mhm Yes The metric health model output, including imputed values. See table above. Imputed values are clipped to the specified bounds.
smk Yes The smoking output, including imputed values. See table above. Imputed values are clipped to the specified bounds.
qlm Yes The Quality of Life output, including imputed values. See table above. Imputed values are clipped to the specified bounds. Note that all values are imputed but that only some of them are being used. See description above and control outputs.
conf Yes The confidence output. See table below.
inter No The interview guidance output. See table below.
shap No SHAP values. See table below.
clip Yes Whether out-of-bounds values would have been clipped instead of returning an error status.
version Yes The endpoint version.

Risks

Condition-based mortality and morbidity risks, specifically:

Some fields are based on a reference population and related stratification. The reference population is prepared individually using customer-supplied data on a sufficient number of lives, and using an agreed stratification for the business case. In evaluation mode, a proxy reference population stratified by age and sex is used. To select the reference population, age is rounded to the closest integer (nearest birthday).

Field Guaranteed Description Min Max
condition Yes The underlying condition of the risk. See enumeration above.
type Yes Whether the risk is for mortality or morbidity.
index Yes The risk index. A relative measure of risk (0 to 100) based on worldwide data. Higher values imply higher risk. 0 100
ratio The risk ratio. A relative measure of risk (0 to infinity) based on a reference population. It is defined as the ratio of the individual risk index to the mean risk index of the reference population. 0
zscore The risk z-score. A relative measure of risk (-infinity to +infinity) based on a reference population as above. It is defined as the difference of the individual risk index and the mean risk index of the reference population with the difference then divided by the standard deviation of the risk index of the reference population.
percentile The risk percentile. A relative measure of risk (0 to 100), derived from the z-score and thus based on a reference population. It assumes the fiction of a normal distirbution of risk indexes. 0 100

Confidence

Confidence intervals. Confidence intervals are provided as per the Metric Health Model table above where the Use column includes confidence. Each confidence interval is represented as an array with its lower and upper bounds, in that order. Confidence values are clipped to the specified bounds of the metric health model.

Interview Guidance

Interview guidance uncertainties of estimation. Uncertainties are provided as per the table below for groups of inputs as well as overall. Each uncertainty is represented as an array with the lowest and highest expected index value of the chosen endpoint, in that order. For continuous variables, these values are based on the confidence intervals of imputations of missing inputs, at the specified confidence level (see Control above). If an input group is fully provided, there is no uncertainty, and the two values are identical and correspond to the estimated index value. Otherwise, there may be a difference between the two values. An interview implementation may consider that difference as the remaining uncertainty for the input group, and prefer input groups with a large difference.

Field Description
uncertainty Overall uncertainty of the estimation
group01
  • smk.now
  • smk.evr
  • smk.num
  • smk.qit
  • smk.yrs
group02
  • mhm.DM2
  • mhm.TDM
group03
  • mhm.HTN
  • mhm.THT
group04
  • mhm.PMI
group05
  • mhm.LVH
group06
  • mhm.fCV
group07
  • mhm.fDM
group08
  • mhm.fMI
group09
  • mhm.pHT
group10
  • mhm.sbp
  • mhm.dbp
group11
  • mhm.fbg
group12
  • mhm.a1c
group13
  • mhm.tsc
  • mhm.hdl
  • mhm.tgl
  • mhm.ldl
group14
  • mhm.wst
group15
  • mhm.fat
group16
  • mhm.rhr
group17
  • mhm.cre
group18
  • mhm.whr
group19
  • mhm.cst
group20
  • mhm.CKD
group21
  • smk.slt
group22
  • mhm.acr
group23
  • mhm.crp
group24
  • mhm.cys
group25
  • mhm.eag
group26
  • mhm.gfr
group27
  • mhm.PDM
group28
  • mhm.CVD
group29
  • mhm.DYS
group30
  • mhm.SPT
group31
  • mhm.STH
group32
  • mhm.vo2max

SHAP values

SHAP values of estimation. SHAP values are grouped as per the table below.

Field Description
average Reference point
age
  • mhm.age
sex
  • mhm.sex
bmi
  • mhm.hgt
  • mhm.wgt
a1c
  • mhm.a1c
  • mhm.eag
cre
  • mhm.cre
crp
  • mhm.crp
bp
  • mhm.dbp
  • mhm.sbp
  • mhm.ppr
  • mhm.map
fat
  • mhm.fat
fbg
  • mhm.fbg
col
  • mhm.tsc
  • mhm.hdl
  • mhm.ldl
  • mhm.vdl
  • mhm.tgl
rhr
  • mhm.rhr
spo2
  • mhm.spo2
whr
  • mhm.whr
wst
  • mhm.wst
cst
  • mhm.cst
PDM
  • mhm.PDM
DM2
  • mhm.DM2
  • mhm.TDM
HTN
  • mhm.HTN
  • mhm.THT
LVH
  • mhm.LVH
PMI
  • mhm.PMI
fCV
  • mhm.fCV
fDM
  • mhm.fDM
fMI
  • mhm.fMI
pHT
  • mhm.pHT
smk
  • smk.now
  • smk.evr
  • smk.qit
  • smk.num
  • smk.yrs
slt
  • smk.slt
STH
  • mhm.STH
SPT
  • mhm.SPT
DYS
  • mhm.DYS
vo2max
  • mhm.vo2max
acr
  • mhm.acr
gfr
  • mhm.gfr
cys
  • mhm.cys
CVD
  • mhm.CVD
CKD
  • mhm.CKD
mvm
  • mvm.nrg
cof
  • mhm.cof
alc
  • mhm.alc
slp
  • slp.slp
  • slp.bed
  • slp.awk
gsrh
  • qlm.gsrh
nut
  • nut.nqs01
  • nut.nqs02
  • nut.nqs03
  • nut.nqs04
  • nut.nqs05
  • nut.nqs06
  • nut.nqs07
  • nut.nqs08
  • nut.nqs09
  • nut.nqs10
  • nut.nqs11
  • nut.nqs12
  • nut.nqs13
  • nut.nqs14
  • nut.nqs15
  • nut.nqs16
  • nut.nqs17
  • nut.nqs18
  • nut.nqs19
  • nut.nqs20
  • nut.nqs21
  • nut.nqs22
gad
  • qlm.gad01
  • qlm.gad02
  • qlm.gad03
  • qlm.gad04
  • qlm.gad05
  • qlm.gad06
  • qlm.gad07
phq
  • qlm.phq01
  • qlm.phq02
  • qlm.phq03
  • qlm.phq04
  • qlm.phq05
  • qlm.phq06
  • qlm.phq07
  • qlm.phq08
  • qlm.phq09
pss
  • qlm.pss01
  • qlm.pss02
  • qlm.pss03
  • qlm.pss04
  • qlm.pss05
  • qlm.pss06
  • qlm.pss07
  • qlm.pss08
  • qlm.pss09
  • qlm.pss10

Examples

Request Body

{
    "control": {
        "duration": 15,
        "conf_level": 0.95,
        "inter_endpoint": 1,
        "shap_endpoint": 0
    },
    "mhm": {
        "age": 35,
        "hgt": 173,
        "wgt": 86,
        "sex": 0    
    },
    "smk": {
        "now": 0,
        "evr": 0
    },
    "mvm": {
        "nrg": [ 6.5 ]
    },
    "slp": {
        "bed": [ 8.5 ],
        "slp": [ 7.5 ],
        "awk": [ 2 ]
    },
    "nut": {
        "nqs01": 0.5,
        "nqs02": 0.5,
        "nqs03": 0.5,
        "nqs05": 0.5,
        "nqs12": 0.5,
        "nqs16": 0.5,
        "nqs17": 0.5
    },
    "qlm": {
        "gshr": 0.5
    },
    "preg": {
        "is_pregnant": 1,
        "prewgt": 80,
        "wgt_week": 20
    },
    "clip": false
}

Response Body

{
    "control": {
        "min_entries_ts": 1,
        "conf_onesided": 0,
        "conf_level": 0.95,
        "duration": 15,
        "inter_endpoint": 1,
        "shap_ref": 0,
        "shap_endpoint": 0,
        "qlm_version": 2021
    },
    "risks": [
        {
            "percentile": 20.11,
            "index": 2.08,
            "condition": "overall",
            "zscore": -0.838,
            "ratio": 0.58,
            "type": "mortality"
        },
        {
            "percentile": 28.11,
            "index": 1.12,
            "condition": "cancer",
            "zscore": -0.58,
            "ratio": 0.734,
            "type": "mortality"
        },
        {
            "percentile": 14.72,
            "index": 0.46,
            "condition": "cardiovascular-disease",
            "zscore": -1.049,
            "ratio": 0.557,
            "type": "mortality"
        },
        {
            "percentile": 22.43,
            "index": 0.35,
            "condition": "hypertension",
            "zscore": -0.758,
            "ratio": 0.702,
            "type": "morbidity"
        },
        {
            "percentile": 13.04,
            "index": 0.32,
            "condition": "type-2-diabetes",
            "zscore": -1.124,
            "ratio": 0.558,
            "type": "morbidity"
        },
        {
            "percentile": 19.81,
            "index": 1.36,
            "condition": "metabolic-dysfunction",
            "zscore": -0.849,
            "ratio": 0.461,
            "type": "morbidity"
        },
        {
            "percentile": 33.47,
            "index": 0.22,
            "condition": "covid-19",
            "zscore": -0.427,
            "ratio": 0.613,
            "type": "mortality"
        },
        {
            "percentile": 36.3,
            "index": 0.25,
            "condition": "copd",
            "zscore": -0.35,
            "ratio": 0.6,
            "type": "morbidity"
        }
    ],
    "mhm": {
        "fbg": 5.2,
        "sbp": 112.4,
        "dbp": 71,
        "note": "74 values redacted in evaluation mode"
    },
	"smk": {
        "note": "6 values redacted in evaluation mode"
    },
    "qlm": {
        "note": "67 values redacted in evaluation mode"
    },
    "conf": {
        "dbp": [
            49.9,
            91.1
        ],
        "fbg": [
            3,
            7.4
        ],
        "sbp": [
            80.1,
            140.5
        ],
        "note": "41 values redacted in evaluation mode"
    },
    "inter": {
        "group10": [
            0.94,
            1.27
        ],
        "group11": [
            1.11,
            1.24
        ],
        "note": "31 values redacted in evaluation mode"
    },
    "shap": {
        "age": 0,
        "sex": 0,
        "bmi": 0.08,
        "average": 2.912,  
        "fbg": 0,
        "bp": 0,
        "note": "39 values redacted in evaluation mode"
    },
    "clip": false,
    "version": "1.6.0"
}