NoPriorCVDRisk_Policy: VARIANZ CVD (2018) Policy-level Risk Score for People Without...
In billy-nz/PredictRiskScores: Functions for generating PREDICT CVD risk scores

Description Usage Arguments Details Value See Also Author(s) References Examples

View source: R/NoPriorCVDRisk_Policy.R

NoPriorCVDRisk_Policy calculates the 5 year absolute risk of cardiovascular disease (CVD) for people without a history of atherosclerotic CVD that is intended for use at policy or general population level. The outcome of interest is the 5-year risk of a non-fatal or fatal CVD event, including hospitalisation for coronary heart disease, stroke or other cerebrovascular disease (including transient ischaemic attack), peripheral vascular disease and heart failure, or cardiovascular death.

1 2	NoPriorCVDRisk_Policy(dat, sex, age, eth, nzdep, diabetes, af, bpl, lld, athrombi, ...)

`dat`	an optional data.frame or data.table containing input data (see details)
`sex`	binary sex or gender
`age`	age in years (see details)
`eth`	ethnicity (see details)
`nzdep`	socio-economic deprivation (see details)
`diabetes`	diabetes status
`af`	atrial fibrillation status
`bpl`	receiving at least one blood pressure lowering medication
`lld`	receiving lipid lowering medication
`athrombi`	receiving antiplatelet or anticoagulant medication
`...`	further arguments (see values)

NoPriorCVDRisk_Policy is intended to be used at the policy or general population level. As such, a dataset containing a population should be provided, and outputs should be summarised. Using this function as a calculator for an individual is not recommended. When a dataset is supplied, a risk score is produced for each row of data, resulting in a numeric vector of the same length. Each argument requires the variable name from the dataset dat that corresponds with the parameter.

The risk prediction equations were developed from a cohort of people aged 30 to 74 years. Additional analyses indicate that the sex-specific risk equations performed adequately in those aged 75-79 years. People aged 18-29 years or 80 years and older, are outside the range used to derive the equation, and therefore risk will be even more of an approximation. The function will calculate ages 18-29 as 30; and ages 80-110 as 79. All other age inputs are invalid and will return NA.

The co-efficients for ethnicity apply only to the following groups: European, Maori, Pacific, Indian, and (non-Indian) Asian. To obtain a risk estimate, ensure that the ethnicity input is either labelled or encoded using one of the values listed below (see values). All other inputs are invalid and will return NA.

The scale for socioeconomic deprivation is derived from the New Zealand Index of Deprivation; a small area-based measure that combines census data relating to income, home ownership, employment, qualifications, family structure, housing, access to transport and communications. The equations require NZDep to be categorised as quintiles, with 1 being the least deprived and 5 being the most deprived.

returns either a single 5-year CVD risk estimate, or a numeric vector of risk estimates if dat is provided. Input values for each parameter must conform to the following convention:

`sex`	label or encode as one of the following: M, Male, 1 F, Female, 0
`age`	numeric value for years of age between 20 and 110
`eth`	label or encode as one of the following: NZ European, European, NZEO, Euro, E, 1, 10, 11, or 12 Maori, NZMaori, NZ Maori, M, 2, or 21 Pacific, Pacific Islander, PI, P, 3, 30, 31, 32, 33, 34, 35, 36, or 37 Indian, Fijian Indian, IN, I, or 43 Other, Middle Eastern, African, Latin American, South American, Latin, Asian, Other Asian, SE Asian, East Asian, Chinese, MELAA, ME, ASN, A, 4, 40, 41, 42, 44, 5, 51, 52, 53, 54, 61 note: Other Asian includes non-Indian South Asian
`nzdep`	numeric value between 1 and 5
`diabetes, af`	label or encode as one of the following: Y, Yes, 1, T, TRUE N, No, 0, F, FALSE
`bpl, lld, athrombi`	label or encode as one of the following: Y, Yes, 1, T, TRUE N, No, 0, F, FALSE
`...`	further arguments: `dp` numeric value to set decimal place; default is 4 `allow.age` logical. Whether or not age range is extended outside of 30 - 74; default is TRUE. If set to FALSE, then `NA` is returned as risk estimate. `allow.na` logical. Whether or not missing values for binary variables and smoking status are treated as 0; default is TRUE. If set to FALSE, then `NA` is returned as risk estimate.

NoPriorCVDRisk
NoPriorCVDRisk_BMI
NoPriorCVDRisk_Policy
NoPriorCVDBleedRisk
NoPriorT2DRisk
PostCVDRisk
PostACSRisk

Billy Wu (R Developer) and Suneela Mehta (Principal Investigator)

Mehta, S., Jackson, R., Pylypchuk, R., Poppe, K., Wells, S., & Kerr, A. J. (2018). Development and validation of alternative cardiovascular risk prediction equations for population health planning: a routine health data linkage study of 1.7 million New Zealanders. International journal of epidemiology, 47 (5), 1571-1584.

Full Article

1
2
3

# As a vectoriser (dataset provided)
NoPriorCVDRisk_Policy(dat=TEST, sex=sex, age=age, eth=eth, nzdep=nzdep, diabetes=diabetes, af=af, lld=lld,
                      athrombi=athromb, bpl=bpl, dp =6, allow.na = FALSE)