VitalStatus
This element can be used to report whether the individual is living or dead at the timepoint when the phenopacket was created (or if the status is unknown).
Data model
Field |
Type |
Multiplicity |
Description |
---|---|---|---|
status |
1..1 |
one of UNKNOWN_STATUS, ALIVE, DECEASED. REQUIRED. |
|
time_of_death |
0..1 |
Should be left blank if patient not known to be deceased |
|
cause_of_death |
0..1 |
Should be left blank if patient not known to be deceased |
|
survival_time_in_days |
integer |
0..1 |
Number of days the patient was alive after their primary diagnosis |
The vital status is commonly collected in cohort studies on cancer.
The following shows how the element can be used to report the time and cause of death.
Status
Name |
Ordinal |
Description |
---|---|---|
UNKNOWN_STATUS |
0 |
Not assessed or not available. |
ALIVE |
1 |
Alive. Maps to NCIT:C37987 |
DECEASED |
2 |
Dead. Maps to NCIT:C28554 |
vitalStatus:
status: "DECEASED"
timeOfDeath:
timestamp: "2015-10-01T10:54:20.021Z"
causeOfDeath:
id: "NCIT:C36263"
label: "Metastatic Malignant Neoplasm"
The following element should be used to report the individual is alive.
vitalStatus:
status: "ALIVE"
In practice, this element is useful in cohort studies in which the association of some treatment or genetic variation is compared with mortality. For many other applications, it may not be necessary to use a VitalStatus element.