A condition represents a patients diagnosed and self-reported health conditions and diseases. The patients medical history and current state may both be represented.
Fields
Condition code.Some codes will contain leading zeroes, and different levels of decimal precision may also be present. This field is a character field, not numeric, to accommodate these coding conventions. Please populate the exact value of this diagnosis code, but remove any source-specific suffixes and prefixes. (Description updated in v4.)
stringPlease note: The ‘Patient-reported’ category can include reporting by a proxy, such as patient’s family or guardian. Guidance: ‘Registry cohort’ generally refers to cohorts of patients flagged with a certain set of characteristics for management within a health system. ‘Patient-reported’ can include self-reported medical history and/or current medical conditions, not captured via healthcare problem lists or registry cohorts.
stringCondition status corresponding with REPORT_DATE. Guidance: The value of IN=Inactive may be used in situations where a condition is not resolved, but is not currently active (for example, psoriasis).
stringCondition code type. Please note: The ‘Other’ category is meant to identify internal use ontologies and codes. Value set items updated to reference both the Clinical Modification (CM) and the Procedure Coding (PCS) context for ICD-9, ICD-10, and ICD-11 (update made in v4).
stringArbitrary identifier for each unique record. Does not need to be persistent across refreshes, and may be created by methods such as sequence or GUID.
stringRefers to: encounter / encounterid
Arbitrary encounter-level identifier used to link across tables. This is an optional field, and should only be populated if the item was collected as part of a healthcare encounter. If more than one encounter association is present, this field should be populated with the ID of the encounter when the condition was first entered into the system. However, please note that many conditions may be recorded outside of an encounter context.
stringThe onset date concept here refers to ‘the date and time when problem (illness, disorder, or symptom) started’ (ONC:MU Clinical Data Set, caDSR 4973971). This is a different concept than report date, which is the date on which the medical status was collected. An onset date should generally be considered independently of the observer or provider. However, the judgment of when a condition ‘started’ depends on the disease, the frequency of visits, and many other factors. It is not clear that any facility or physician employs this field in a manner which can be trusted without validation during analysis. (New definition added in v4.)
dateRefers to: demographic / patid
Arbitrary person-level identifier. Used to link across tables.
stringOptional field for originating value of field, prior to mapping into the PCORnet CDM value set.
stringOptional field for originating value of field, prior to mapping into the PCORnet CDM value set.
stringOptional field for originating value of field, prior to mapping into the PCORnet CDM value set.
stringOptional field for originating value of field, prior to mapping into the PCORnet CDM value set.
stringDate condition was noted, which may be the date when it was recorded by a provider or nurse, or the date on which the patient reported it. Please note that this date may not correspond to onset date.
dateDate condition was resolved, if resolution of a transient condition has been achieved. A resolution date is not generally expected for chronic conditions, even if the condition is managed.
dateReported mortality information for patients.
Fields
Date of death.
dateWhen date of death is imputed, this field indicates which parts of the date were imputed.
stringFor situations where a probabilistic patient matching strategy is used, this field indicates the confidence that the patient drawn from external source data represents the actual patient. Should not be present where DEATH_SOURCE is L (locally-defined). May not be applicable for DEATH_SOURCE=T (tumor registry data)
stringGuidance: “Other, locally defined” may be used to indicate presence of deaths reported from EHR systems, such as inpatient hospital deaths or dead on arrival.
stringRefers to: demographic / patid
Arbitrary person-level identifier used to link across tables.
stringThe individual causes associated with a reported death.
Fields
Cause of death code. Please include the decimal point in ICD codes (if any).
stringCause of death code type.
stringConfidence in the accuracy of the cause of death based on source, match, number of reporting sources, discrepancies, etc.
stringSource of cause of death information. Guidance: “Other, locally defined” may be used to indicate presence of deaths reported from EHR systems, such as inpatient hospital deaths or dead on arrival.
stringCause of death type. There should be only one underlying cause of death.
stringRefers to: demographic / patid
Arbitrary person-level identifier used to link across tables.
stringDemographics record the direct attributes of individual patients.
Fields
Flag to indicate that one or more biobanked specimens are stored and available for research use. Examples of biospecimens could include plasma, urine, or tissue. If biospecimens are available, locally maintained ‘mapping tables’ would be necessary to map between the DEMOGRAPHIC record and the originating biobanking system(s). If no known biobanked specimens are available, this field should be marked ‘No’.
stringDate of birth.
dateTime of birth.
stringCurrent gender identity.
stringA person of Cuban, Mexican, Puerto Rican, South or Central American, or other Spanish culture or origin, regardless of race.
stringPreferred spoken language of communication as expressed by the patient. New field in v4.
stringArbitrary person-level identifier used to link across tables. PATID is a pseudoidentifier with a consistent crosswalk to the true identifier retained by the source Data Partner. For analytical data sets requiring patient-level data, only the pseudoidentifier is used to link across all information belonging to a patient. The PATID must be unique within the data source being queried. Creating a unique identifier within a CDRN would be beneficial and acceptable. The PATID is not the basis for linkages across partners.
stringTotal: 24
| Table | Field | Name |
|---|---|---|
| condition | patid | fk_condition_patid |
| death | patid | fk_death_patid |
| death_cause | patid | fk_death_cause_patid |
| diagnosis | patid | fk_diagnosis_patid |
| dispensing | patid | fk_dispensing_patid |
| encounter | patid | fk_encounter_patid |
| enrollment | patid | fk_enrollment_patid |
| hash_token | patid | fk_hash_token_patid |
| immunization | patid | fk_immun_patid |
| lab_result_cm | patid | fk_lab_result_cm_patid |
| lds_address_history | patid | fk_lds_addhist_patid |
| med_admin | patid | fk_medadmin_patid |
| obs_clin | patid | fk_obsclin_patid |
| obs_gen | patid | fk_obsgen_patid |
| pcornet_trial | patid | fk_pcornet_trial_patid |
| prescribing | patid | fk_prescribing_patid |
| private_address_history | patid | fk_add_history_patid |
| private_demographic | patid | fk_priv_demographic_patid |
| pro_cm | patid | fk_pro_cm_patid |
| procedures | patid | fk_procedures_patid |
| vital | patid | fk_vital_patid |
| external_meds | patid | fk_ext_meds_patid |
| pat_relationship | patid_1 | fk_pat_rel_patid_1 |
| pat_relationship | patid_2 | fk_pat_rel_patid_2 |
Please use only one race value per patient. Details of categorical definitions: American Indian or Alaska Native: A person having origins in any of the original peoples of North and South America (including Central America), and who maintains tribal affiliation or community attachment. Asian: A person having origins in any of the original peoples of the Far East, Southeast Asia, or the Indian subcontinent including, for example, Cambodia, China, India, Japan, Korea, Malaysia, Pakistan, the Philippine Islands, Thailand, and Vietnam. Black or African American: A person having origins in any of the black racial groups of Africa. Native Hawaiian or Other Pacific Islander: A person having origins in any of the original peoples of Hawaii, Guam, Samoa, or other Pacific Islands. White: A person having origins in any of the original peoples of Europe, the Middle East, or North Africa.
stringField to indicate whether patient identifies with the categories of American Indian or Alaska Native race/ethnicity. Details of categorical definition: American Indian or Alaska Native: Individuals with origins in any of the original peoples of North, Central, and South America, including, for example, Navajo Nation, Blackfeet Tribe of the Blackfeet Indian Reservation of Montana, Native Village of Barrow Inupiat Traditional Government, Nome Eskimo Community, Aztec, and Maya.
stringField to indicate whether patient identifies with the categories of Asian race/ethnicity. Details of categorical definition: Asian: Individuals with origins in any of the original peoples of Central or East Asia, Southeast Asia, or South Asia, including, for example, Chinese, Asian Indian, Filipino, Vietnamese, Korean, and Japanese.
stringField to indicate whether patient identifies with the categories of Black or African American race/ethnicity. Details of categorical definition: Black or African American: Individuals with origins in any of the Black racial groups of Africa, including, for example, African American, Jamaican, Haitian, Nigerian, Ethiopian, and Somali.
stringField to indicate whether patient identifies with the categories of Hispanic or Latino race/ethnicity. Details of categorical definition: Hispanic or Latino: Includes individuals of Mexican, Puerto Rican, Salvadoran, Cuban, Dominican, Guatemalan, and other Central or South American or Spanish culture or origin.
stringField to indicate whether patient identifies with the categories of Middle Eastern or North African race/ethnicity. Details of categorical definition: Middle Eastern or North African: Individuals with origins in any of the original peoples of the Middle East or North Africa, including, for example, Lebanese, Iranian, Egyptian, Syrian, Iraqi, and Israeli.
stringField to indicate whether patient has refused to provide a response to question(s) related to race/ethnicity or if a response does not conform to other values.
stringField to indicate whether patient identifies with the categories of Native Hawaiian or Pacific Islander race/ethnicity. Details of categorical definition: Native Hawaiian or Pacific Islander: Individuals with origins in any of the original peoples of Hawaii, Guam, Samoa, or other Pacific Islands, including, for example, Native Hawaiian, Samoan, Chamorro, Tongan, Fijian, and Marshallese.
stringField to indicate whether patient identifies with the categories of White race/ethnicity. Details of categorical definition: White: Individuals with origins in any of the original peoples of Europe, including, for example, English, German, Irish, Italian, Polish, and Scottish.
stringOptional field for originating value of field, prior to mapping into the PCORnet CDM value set.
stringOptional field for originating value of field, prior to mapping into the PCORnet CDM value set.
stringPreferred spoken language of communication as expressed by the patient
stringOptional field for originating value of field, prior to mapping into the PCORnet CDM value set.
stringOptional field for originating value of field, prior to mapping into the PCORnet CDM value set.
stringOptional field for originating value of field, prior to mapping into the PCORnet CDM value set.
stringAdministrative sex. v4 definition updated: Sex assigned at birth v2.0 guidance added: The “Ambiguousâ€ù category may be used for individuals who are physically undifferentiated from birth. The “Otherâ€ù category may be used for individuals who are undergoing gender re-assignment.
stringSexual orientation.
stringDiagnosis codes indicate the results of diagnostic processes and medical coding within healthcare delivery.
Fields
Please note: This is a field replicated from the ENCOUNTER table. See the ENCOUNTER table for definitions.
dateArbitrary identifier for each unique record. Does not need to be persistent across refreshes, and may be created by methods such as sequence or GUID.
stringDiagnosis code. Leading zeroes and different levels of decimal precision are permissible in this field. Please populate the exact textual value of this diagnosis code, but remove source-specific suffixes and prefixes. Other codes should be listed as recorded in the source data. Some codes will contain leading zeroes, and different levels of decimal precision may also be present. This field is a character field, not numeric, to accommodate these coding conventions. (Description updated in v4.)
stringDate diagnosis was recorded if known.
dateSource of the diagnosis information. Billing pertains to internal healthcare processes and data sources. Claim pertains to data from the bill fulfillment, generally data sources held by insurers and other health plans. New field added in v4.
stringFlag to denote whether diagnosis was present on inpatient admission.
stringClassification of diagnosis source. We include these categories to allow some flexibility in implementation. The context is to capture available diagnoses recorded during a specific encounter. It is not necessary to populate interim diagnoses unless readily available. Ambulatory encounters would generally be expected to have a source of “Final.”
stringDiagnosis code type. We provide values for ICD and SNOMED code types. Other code types will be added as new terminologies are more widely used. Please note: The “Other” category is meant to identify internal use ontologies and codes.
stringPlease note: This is a field replicated from the ENCOUNTER table. See the ENCOUNTER table for definitions.
stringRefers to: encounter / encounterid
Arbitrary encounter-level identifier. Used to link across tables.
stringRefers to: demographic / patid
Arbitrary person-level identifier. Used to link across tables.
stringPrincipal discharge diagnosis flag. Relevant only on IP and IS encounters. For ED, AV, and OA encounter types, mark as X=Unable to Classify. (Billing systems do not require a primary diagnosis for ambulatory visits (eg, professional services).) One principle diagnosis per encounter is expected, although in some instances more than one diagnosis may be flagged as principal.
stringRefers to: provider / providerid
Please note: This is a field replicated from the ENCOUNTER table. See the ENCOUNTER table for definitions.
stringOptional field for originating value of field, prior to mapping into the PCORnet CDM value set.
stringField for originating value, prior to mapping into the PCORnet CDM value set.
stringOptional field for originating value of field, prior to mapping into the PCORnet CDM value set.
stringOptional field for originating value of field, prior to mapping into the PCORnet CDM value set.
stringOptional field for originating value of field, prior to mapping into the PCORnet CDM value set.
stringOutpatient pharmacy dispensing, such as prescriptions filled through a neighborhood pharmacy with a claim paid by an insurer. Outpatient dispensing may not be directly captured within healthcare systems.
Fields
Number of units (pills, tablets, vials) dispensed. Net amount per NDC per dispensing. This amount is typically found on the dispensing record. Positive values are expected. Important: Please do not calculate during CDM implementation. This field should only reflect originating source system calculations. Number precision and scale updated in v4.
numberDispensing date (as close as possible to date the person received the dispensing).
dateDose of a given mediation, as dispensed
numberUnits of measure associated with the dose of the medication as dispensed
stringRoute of delivery
stringSource of the dispensing information.
stringDays supply. Number of days that the medication supports based on the number of doses as reported by the pharmacist. This amount is typically found on the dispensing record. Integer values are expected. Important: Please do not calculate during CDM implementation. This field should only reflect originating source system calculations. Number precision and scale updated in v4.
numberArbitrary identifier for each unique record. Does not need to be persistent across refreshes, and may be created by methods such as sequence or GUID.
stringNational Drug Code in the 11-digit, no-dash, HIPAA format. Please expunge any place holders (such as dashes or extra digits). If needed, guidance on normalization for other forms of NDC can be found: http://www.nlm.nih.gov/research/umls/rxnorm/docs/2012/rxnorm_doco_full_2012-1.html (see section 6)
stringRefers to: demographic / patid
Arbitrary person-level identifier. Used to link across tables.
stringRefers to: prescribing / prescribingid
This is an optional relationship to the PRESCRIBING table, and may not be generally available. One prescribing order may generate multiple dispensing records.
stringField for originating value, prior to mapping into the PCORnet CDM value set.
stringField for originating value, prior to mapping into the PCORnet CDM value set.
stringField for originating value, prior to mapping into the PCORnet CDM value set.
stringOptional field for originating value of field, prior to mapping into the PCORnet CDM value set.
stringEncounters are interactions between patients and providers within the context of healthcare delivery.
Fields
Encounter or admission date.
dateEncounter or admission time.
stringAdmitting source. Should be populated for Inpatient Hospital Stay (IP) and Non-Acute Institutional Stay (IS) encounter types. May be populated for Emergency Department (ED) and ED-to-Inpatient (EI) encounter types. Should be missing for ambulatory visit (AV or OA) encounter types.
stringDischarge date. Should be populated for all Inpatient Hospital Stay (IP) and Non-Acute Institutional Stay (IS) encounter types. May be populated for Emergency Department (ED) and ED-to-Inpatient (EI) encounter types. Should be missing for ambulatory visit (AV or OA) encounter types.
dateVital status at discharge. Should be populated for Inpatient Hospital Stay (IP) and Non-Acute Institutional Stay (IS) encounter types. May be populated for Emergency Department (ED) and ED-to-Inpatient (EI) encounter types. Should be missing for ambulatory visit (AV or OA) encounter types.
stringDischarge status. Should be populated for Inpatient Hospital Stay (IP) and Non-Acute Institutional Stay (IS) encounter types. May be populated for Emergency Department (ED) and ED-to-Inpatient (EI) encounter types. Should be missing for ambulatory visit (AV or OA) encounter types.
stringDischarge time.
string3-digit Diagnosis Related Group (DRG). Should be populated for IP and IS encounter types. May be populated for Emergency Department (ED) and ED-to-Inpatient (EI) encounter types. Should be missing for AV or OA encounters. Use leading zeroes for codes less than 100. The DRG is used for reimbursement for inpatient encounters. It is a Medicare requirement that combines diagnoses into clinical concepts for billing. Frequently used in observational data analyses.
stringDRG code version. MS-DRG (current system) began on 10/1/2007. Should be populated for IP and IS encounter types. May be populated for Emergency Department (ED) and ED-toInpatient (EI) encounter types. Should be missing for AV or OA encounters.
stringEncounter type. Details of categorical definitions: Ambulatory Visit: Includes visits at outpatient clinics, physician offices, same day/ambulatory surgery centers, urgent care facilities, and other same-day ambulatory hospital encounters, but excludes emergency department encounters. Emergency Department (ED): Includes ED encounters that become inpatient stays (in which case inpatient stays would be a separate encounter). Excludes urgent care visits. ED claims should be pulled before hospitalization claims to ensure that ED with subsequent admission won’t be rolled up in the hospital event. Does not include observation stays, where known (guidance added in v4). Emergency Department Admit to Inpatient Hospital Stay: Permissible substitution for preferred state of separate ED and IP records. Only for use with data sources where the individual records for ED and IP cannot be distinguished (new to v2.0). Inpatient Hospital Stay: Includes all inpatient stays, including: same-day hospital discharges, hospital transfers, and acute hospital care where the discharge is after the admission date. Does not include observation stays, where known (guidance added in v4). Observation Stay: ‚ÄúHospital outpatient services given to help the can be discharged. Observations services may be given in the emergency department or another area of the hospital.‚Äù Definition from Medicare, CMS Product No. 11435, https://www.medicare.gov/Pubs/pdf/11435.pdf (new value set item added in v4). Institutional Professional Consult: Permissible substitution when services provided by a medical professional cannot be combined with the given encounter record, such as a specialist consult in an inpatient setting; this situation can be common with claims data sources (new value set item added in v4). Non-Acute Institutional Stay: Includes hospice, skilled nursing facility (SNF), rehab center, nursing home, residential, overnight non-hospital dialysis and other non-hospital stays. Other Ambulatory Visit: Includes other non-overnight AV encounters such as hospice visits, home health visits, skilled nursing facility visits, other non-hospital visits, as well as telemedicine, telephone and email consultations. May also include “lab only” visits (when a lab is ordered outside of a patient visit), “pharmacy only” (e.g., when a patient has a refill ordered without a face-to-face visit), “imaging only”, etc.
stringArbitrary encounter-level identifier. Used to link across tables, including the ENCOUNTER, DIAGNOSIS, and PROCEDURE tables.
stringTotal: 11
| Table | Field | Name |
|---|---|---|
| condition | encounterid | fk_condition_encounterid |
| diagnosis | encounterid | fk_diagnosis_encounterid |
| immunization | encounterid | fk_immun_encounterid |
| lab_result_cm | encounterid | fk_lab_result_cm_encounterid |
| med_admin | encounterid | fk_medadmin_encounterid |
| obs_clin | encounterid | fk_obsclin_encounterid |
| obs_gen | encounterid | fk_obsgen_encounterid |
| prescribing | encounterid | fk_prescribing_encounterid |
| pro_cm | encounterid | fk_pro_cm_encounterid |
| procedures | encounterid | fk_procedures_encounterid |
| vital | encounterid | fk_vital_encounterid |
Geographic location (5 digit zip code). Should be null if not recorded in source system.
stringAppendix for a list of acceptable values. Description of the facility where the encounter occurred.
stringArbitrary local facility code that identifies the hospital or clinic. Used for chart abstraction and validation. FACILITYID can be a true identifier, or a pseudoidentifier with a consistent crosswalk to the true identifier retained by the source Data Partner.
stringRefers to: demographic / patid
Arbitrary person-level identifier used to link across tables.
stringCategorization of payer type for primary payer associated with the encounter
stringCategorization of payer type for secondary payer associated with the encounter
stringRefers to: provider / providerid
Provider code for the provider who is most responsible for this encounter. For encounters with multiple providers choose one so the encounter can be linked to the diagnosis and procedure tables. As with the PATID, the provider code is a pseudoidentifier with a consistent crosswalk to the real identifier.
stringOptional field for originating value of field, prior to mapping into the PCORnet CDM value set.
stringOptional field for originating value of field, prior to mapping into the PCORnet CDM value set.
stringOptional field for originating value of field, prior to mapping into the PCORnet CDM value set.
stringOptional field for originating value of field, prior to mapping into the PCORnet CDM value set.
stringOptional field for originating value of field, prior to mapping into the PCORnet CDM value set.
stringField for originating value, prior to mapping into the PCORnet CDM value set.
stringPrimary PAYER identifier as denoted in the source system. Used to derive PAYER_TYPE_PRIMARY if validated process does not exist.
stringSecondary PAYER identifier as denoted in the source system. Used to derive PAYER_TYPE_SECONDARY if validated process does not exist.
stringPrimary payer name as denoted in the source system. Used to derive PAYER_TYPE_PRIMARY if validated process does not exist.
stringSecondary payer name as denoted in the source system. Used to derive PAYER_TYPE_SECONDARY if validated process does not exist.
stringField for originating value, prior to mapping into the PCORnet CDM value set.
stringField for originating value, prior to mapping into the PCORnet CDM value set.
stringThis field is new to v2.0. Optional field for locally-defined identifier intended for local use; for example, where a network may have multiple sites contributing to a central data repository. This attribute may be sensitive in certain contexts; the intent is for internal network use only, and not to enable site quality comparisons.
stringEnrollment is a concept that defines a period of time during which all medically-attended events are expected to be observed. This concept is often insurance-based, but other methods of defining enrollment are possible.
Fields
Chart abstraction flag is intended to answer the question, “Are you able to request (or review) charts for this person?” This flag does not address chart availability. Mark as “Yes” if there are no contractual or other restrictions between you and the individual (or sponsor) that would prohibit you from requesting any chart for this member. Note: This field is most relevant for health insurers that can request charts from affiliated providers. This field allows exclusion of patients from studies that require chart review to validate exposures and/or outcomes. It identifies patients for whom charts are never available and for whom the chart can never be requested.
stringWhen insurance information is not available but complete capture can be asserted some other way, please identify the basis on which complete capture is defined. Additional information on the approach identified will be required from each partner. ENR_BASIS is a property of the time period defined. A patient can have multiple entries in the table. Details of categorical definitions: Medical insurance coverage: The start and stop dates are based upon enrollment where the health plan has any responsibility for covering medical care for the member during this enrollment period (i.e., if you expect to observe medical care provided to this member during the enrollment period). Outpatient prescription drug coverage: The start and stop dates are based on enrollment where the health plan has any responsibility for covering outpatient prescription drugs for the member during this enrollment period (i.e., if you expect to observe outpatient pharmacy dispensings for this member during this enrollment period). (New value set item added in v4.) Geography: An assertion of complete data capture between the start and end dates based upon geographic characteristics, such as regional isolation. Algorithmic: An assertion of complete data capture between the start and end dates, based on a locally developed or applied algorithm, often using multiple criteria. Encounter-based: The start and stop dates are populated from the earliest-observed encounter and latest-observed encounter. Field definition and value sets modified in v4 to include drug coverage.
stringDate of the end of the enrollment period. If the exact date is unknown, use the last day of the month.
dateDate of the beginning of the enrollment period. If the exact date is unknown, use the first day of the month. For implementation of the CDM, a long span of longitudinal data is desirable; however, especially for historical data more than a decade old, the appropriate beginning date should be determined by the partner’s knowledge of the validity and usability of the data. More specific guidance can be provided through implementation discussions.
dateRefers to: demographic / patid
Arbitrary person-level identifier used to link across tables.
stringMedications external to the originating health system. Examples include medications as reported by the patient and those obtained from external health systems.
Fields
Basis of the external medication. Use patient-reported for medications that come from the patient, such as through a kiosk or portal. Use this value even if the patient-reported medication is ultimately recorded or confirmed by the provider. Use external health system / health information exchange for medications that are pulled into the EHR from outside health systems.
stringDose of a given external mediation
numberThe form of the external medication. This is equivalent to RxNorm Dose Form.
stringUnits of measure associated with the dose of the external medication
stringDate the external medication was ended or canceled in the EHR.
dateDate the patient reports stopping the external medication, if known.
dateDate the patient reports taking the external medication, if known.
dateDate the external medication was recorded in the EHR.
dateRoute of medication delivery.
stringSource of the external medication information.
stringArbitrary identifier for each unique EXTERNAL_MEDS record.
stringRefers to: demographic / patid
Arbitrary person-level identifier used to link across tables.
stringField for originating value, prior to mapping into the PCORnet CDM value set.
stringField for originating value, prior to mapping into the PCORnet CDM value set.
stringField for originating, full textual medication name from the source.
stringField for originating value, prior to mapping into the PCORnet CDM value set.
stringField for originating value, prior to mapping into the PCORnet CDM value set.
stringField for originating value, prior to mapping into the PCORnet CDM value set.
stringWhere an RxNorm mapping exists for the source medication, this field contains the RxNorm concept identifier (CUI) at the highest possible specificity.
stringAttributes associated with the specific PCORnet datamart implementation.
Fields
Data management strategy currently present in the ADDRESS_PERIOD_END_MGMT field on the LDS_ADDRESS_HISTORY table Please see notes for additional definitions.
stringData management strategy currently present in the ADDRESS_PERIOD_START_MGMT field on the LDS_ADDRESS_HISTORY table Please see notes for additional definitions.
stringData management strategy currently present in the ADMIT_DATE field on the ENCOUNTER table Please see notes for additional definitions.
stringData management strategy currently present in the BIRTH_DATE field on the DEMOGRAPHIC table Please see notes for additional definitions.
stringVersion currently implemented within this datamart (for example, 1.0, 2.0, 3.0). Number precision and scale updated in v4.
stringDatamart includes claims data source(s)
stringDatamart includes EHR data source(s)
stringDescriptive name of the datamart. This identifier is assigned by the PCORnet Distributed Research Network Operations Center (DRN OC) (description updated in v4)
stringstringThis identifier is assigned by the PCORnet Distributed Research Network Operations Center (DRN OC) (description updated in v4)
stringData management strategy employed for the DEATH_DATE field in the DEATH table.
stringData management strategy currently present in the DISCHARGE_DATE field on the ENCOUNTER table Please see notes for additional definitions.
stringData management strategy currently present in the DISPENSE_DATE field on the DISPENSING table Please see notes for additional definitions.
stringData management strategy currently present in the DX_DATE field on the DIAGNOSIS table Please see notes for additional definitions.
stringData management strategy currently present in the ENR_END_DATE field on the ENROLLMENT table Please see notes for additional definitions.
stringData management strategy currently present in the ENR_START_DATE field on the ENROLLMENT table Please see notes for additional definitions.
stringData management strategy currently present in the LAB_ORDER_DATE field on the LAB_RESULT_CM table Please see notes for additional definitions.
stringData management strategy employed for the MEDADMIN_START_DATE field in the MED_ADMIN table.
stringData management strategy employed for the MEDADMIN_END_DATE field in the MED_ADMIN table.
stringDescriptive name of the network. This identifier is assigned by the PCORnet Distributed Research Network Operations Center (DRN OC) (description updated in v4)
stringThis identifier is assigned by the PCORnet Distributed Research Network Operations Center (DRN OC) (description updated in v4)
stringData management strategy employed for the OBSCLIN_START_DATE field in the OBS_CLIN table.
stringData management strategy employed for the OBSCLIN_STOP_DATE field in the OBS_CLIN table.
stringData management strategy employed for the OBSGEN_START_DATE field in the OBS_GEN table.
stringData management strategy employed for the OBSGEN_STOP_DATE field in the OBS_GEN table.
stringData management strategy currently present in the ONSET_DATE field on the CONDITION table Please see notes for additional definitions.
stringData management strategy currently present in the PRO_DATE field on the PRO_CM table Please see notes for additional definitions.
stringData management strategy currently present in the PX_DATE field on the PROCEDURES table Please see notes for additional definitions.
stringMost recent date on which the present data were loaded into the CONDITION table. This date should be null if the table does not have records.
dateMost recent date on which the present data were loaded into the DEATH_CAUSE table. This date should be null if the table does not have records.
dateMost recent date on which the present data were loaded into the DEATH table. This date should be null if the table does not have records.
dateMost recent date on which the present data were loaded into the DEMOGRAPHIC table. This date should be null if the table does not have records.
dateMost recent date on which the present data were loaded into the DIAGNOSIS table. This date should be null if the table does not have records.
dateMost recent date on which the present data were loaded into the DISPENSING table. This date should be null if the table does not have records.
dateMost recent date on which the present data were loaded into the ENCOUNTER table. This date should be null if the table does not have records.
dateMost recent date on which the present data were loaded into the ENROLLMENT table. This date should be null if the table does not have records.
dateMost recent date on which the present data were loaded into the HASH TOKEN table. This date should be null if the table does not have records.
dateMost recent date on which the present data were loaded into the IMMUNIZATION table. This date should be null if the table does not have records.
dateMost recent date on which the present data were loaded into the LAB_RESULT_CM table. This date should be null if the table does not have records.
dateMost recent date on which the present data were loaded into the LDS_ADDRESS_HISTORY table. This date should be null if the table does not have records.
dateMost recent date on which the present data were loaded into the MED_ADMIN table. This date should be null if the table does not have records.
dateMost recent date on which the present data were loaded into the OBS_CLIN table. This date should be null if the table does not have records.
dateMost recent date on which the present data were loaded into the OBS_GEN table. This date should be null if the table does not have records.
dateMost recent date on which the present data were loaded into the PCORNET_TRIAL table. This date should be null if the table does not have records.
dateMost recent date on which the present data were loaded into the PRESCRIBING table. This date should be null if the table does not have records.
dateMost recent date on which the present data were loaded into the PRO_CM table. This date should be null if the table does not have records.
dateMost recent date on which the present data were loaded into the PROCEDURES table. This date should be null if the table does not have records.
dateMost recent date on which the present data were loaded into the PROVIDER table. This date should be null if the table does not have records.
dateData management strategy currently present in the REPORT_DATE field on the CONDITION table Please see notes for additional definitions.
stringData management strategy currently present in the RESOLVE_DATE field on the CONDITION table Please see notes for additional definitions.
stringData management strategy currently present in the RESULT_DATE field on the LAB_RESULT_CM table Please see notes for additional definitions.
stringData management strategy currently present in the RX_END_DATE field on the PRESCRIBING table Please see notes for additional definitions.
stringData management strategy currently present in the RX_ORDER_DATE field on the PRESCRIBING table Please see notes for additional definitions.
stringData management strategy currently present in the RX_START_DATE field on the PRESCRIBING table Please see notes for additional definitions.
stringData management strategy currently present in the SPECIMEN_DATE field on the LAB_RESULT_CM table Please see notes for additional definitions.
stringSampling strategy used when loading high volume records into the CDM. Will primarily apply to inpatient vitals.
stringData management strategy currently present in the VX_ADMIN_DATE_MGMT field on the IMMUNIZATION table Please see notes for additional definitions.
stringData management strategy currently present in the VX_EXP_DATE_MGMT field on the IMMUNIZATION table Please see notes for additional definitions.
stringData management strategy currently present in the VX_RECORD_DATE_MGMT field on the IMMUNIZATION table Please see notes for additional definitions.
string“Encrypted hash tokens that are used to match patient records across DataMarts using privacy-preserving record linkage methods.”
Fields
Refers to: demographic / patid
Arbitrary person-level identifier. Used to link across tables..
stringEncrypted keyed hash generated from PII using Datavant token strategy 01
stringEncrypted keyed hash generated from PII using Datavant token strategy 02
stringEncrypted keyed hash generated from PII using Datavant token strategy 03
stringEncrypted keyed hash generated from PII using Datavant token strategy 04
stringEncrypted keyed hash generated from PII using Datavant token strategy 05
stringEncrypted keyed hash generated from PII using Datavant token strategy 06
stringEncrypted keyed hash generated from PII using Datavant token strategy 07
stringEncrypted keyed hash generated from PII using Datavant token strategy 08
stringEncrypted keyed hash generated from PII using Datavant token strategy 09
stringEncrypted keyed hash generated from PII using Datavant token strategy 101
stringEncrypted keyed hash generated from PII using Datavant token strategy 102
stringEncrypted keyed hash generated from PII using Datavant token strategy 103
stringEncrypted keyed hash generated from PII using Datavant token strategy 104
stringEncrypted keyed hash generated from PII using Datavant token strategy 105
stringEncrypted keyed hash generated from PII using Datavant token strategy 106
stringEncrypted keyed hash generated from PII using Datavant token strategy 107
stringEncrypted keyed hash generated from PII using Datavant token strategy 108
stringEncrypted keyed hash generated from PII using Datavant token strategy 109
stringEncrypted keyed hash generated from PII using Datavant token strategy 110
stringEncrypted keyed hash generated from PII using Datavant token strategy 111
stringEncrypted keyed hash generated from PII using Datavant token strategy 12
stringEncrypted keyed hash generated from PII using Datavant token strategy 14
stringEncrypted keyed hash generated from PII using Datavant token strategy 15
stringEncrypted keyed hash generated from PII using Datavant token strategy 16
stringEncrypted keyed hash generated from PII using Datavant token strategy 17
stringEncrypted keyed hash generated from PII using Datavant token strategy 18
stringEncrypted keyed hash generated from PII using Datavant token strategy 23
stringEncrypted keyed hash generated from PII using Datavant token strategy 24
stringEncrypted keyed hash generated from PII using Datavant token strategy 25
stringEncrypted keyed hash generated from PII using Datavant token strategy 26
stringEncrypted keyed hash generated from PII using Datavant token strategy 29
stringEncrypted keyed hash generated from PII using Datavant token strategy 30
stringName of the key used to generate the encrypted hash tokens.
string“Records of immunizations that have been delivered within the health system as well as reports of those administered elsewhere.”
Fields
Refers to: encounter / encounterid
Arbitrary encounter-level identifier. Used to link across tables. This should be present if the immunization activity is directly associated with an encounter.
stringArbitrary identifier for each unique IMMUNIZATION record.
stringRefers to: demographic / patid
Arbitrary person-level identifier. Used to link across tables.
stringRefers to: procedures / proceduresid
This is an optional relationship to the PROCEDURES table and is not expected to be available for all immunizations. One procedure may generate multiple immunization records.
stringField for originating value, prior to mapping into the PCORnet CDM value set.
stringField for originating value, prior to mapping into the PCORnet CDM value set.
stringField for originating value, prior to mapping into the PCORnet CDM value set.
stringField for originating value, prior to mapping into the PCORnet CDM value set.
stringField for originating value, prior to mapping into the PCORnet CDM value set.
stringField for originating value, prior to mapping into the PCORnet CDM value set.
stringField for originating value, prior to mapping into the PCORnet CDM value set.
stringField for originating value, prior to mapping into the PCORnet CDM value set.
stringField for originating value, prior to mapping into the PCORnet CDM value set.
stringField for originating value, prior to mapping into the PCORnet CDM value set.
stringDate immunization was administered, if known.
dateImmunization administration body site.
stringImmunization code
stringImmunization code type.
stringDose of a given immunization
numberUnits of measure associated with the dose of the immunization as delivered by the provider
stringExpiration date of the immunization.
dateLot number of the immunization.
stringManufacturer of the immunization.
stringRefers to: provider / providerid
Provider code for the provider who delivered the immunization. The provider code is a pseudoidentifier with a consistent crosswalk to the real identifier.
stringDate immunization was recorded (i.e., date record was created).
dateImmunization administration route.
stringSource of the prescribing information.
stringStatus of the immunization.
stringReason immunization is incomplete or not done.
stringTable for storing historical information about units of measure and reference ranges for laboratory test results.
Fields
Maximum age to which this unit and range applies, in weeks.
numberMinimum age to which this unit and range applies, in weeks.
numberArbitrary local code that identifies the facility providing lab results.Used in instances where partners are aggregating laboratory results from a number of different organizations. LAB_FACILITYID can be a true identifier, or a pseudoidentifier with a consistent crosswalk to the true identifier retained by the source data partner.
stringLogical Observation Identifiers, Names, and Codes (LOINC®) from the Regenstrief Institute. Current LOINC codes are from 3-7 characters long but Regenstrief suggests a length of 10 for future growth. The last digit of the LOINC code is a check digit and is always preceded by a hyphen. All parts of the LOINC code, including the hyphen, must be included. Do not pad the LOINC code with leading zeros.
stringArbitrary identifier for each unique LAB_HISTORY record.
stringModifier for NORM_RANGE_HIGH values.
stringModifier for NORM_RANGE_LOW values.
stringUpper bound of the normal range assigned by the laboratory.
stringLower bound of the normal range assigned by the laboratory.
stringDate when the unit and range are no longer in use for the specified age range, race, sex and facility.
dateInitial date when the unit and range are known to be in use for the specified age range, race, sex and facility.
dateRace to which this unit and range applies.
stringLocal name related to an individual lab test.
stringOriginal reference range in your source data.
stringOriginal units in your source data.
stringConverted/standardized units for the specified LOINC.
stringSex to which this unit and range applies.
stringLaboratory result Common Measures (CM) use specific types of quantitative and qualitative measurements from blood and other body specimens. The common measures are defined in the same way across all PCORnet networks, but this table can also include other types of lab results.
Fields
Abnormal result indicator. This value comes from the source data; do not apply logic to create it.
stringRefers to: encounter / encounterid
Arbitrary encounter-level identifier used to link across tables. This is an optional field, and should only be populated if the lab was collected as part of a healthcare encounter.
stringLogical Observation Identifiers, Names, and Codes (LOINC) from the Regenstrief Institute. Results with local versions of LOINC codes (e.g., LOINC candidate codes) should be included in the RAW_table field, but the LOINC variable should be set to missing. Current LOINC codes are from 3-7 characters long but Regenstrief suggests a length of 10 for future growth. The last digit of the LOINC code is a check digit and is always preceded by a hyphen. All parts of the LOINC code, including the hyphen, must be included. Do not pad the LOINC code with leading zeros. Please see the LOINC reference table for known LOINC codes for each LAB_NAME.
stringSource/provenance of the LOINC code for this result.
stringDate test was ordered.
dateOptional variable for local and standard procedure codes, used to identify the originating order for the lab test.
stringProcedure code type, if applicable. Value set modified in v4 to combine CPT and HCPCS codes into one category; also, ICD-9 value set item typo corrected to specify ICD-9-PCS
stringArbitrary identifier for each unique LAB_RESULT_CM record. Does not need to be persistent across refreshes, and may be created by methods such as sequence or GUID.
stringSource of the information for the lab result
stringModifier for NORM_RANGE_HIGH values. For numeric results one of the following needs to be true: 1) Both MODIFIER_LOW and MODIFIER_HIGH contain EQ (e.g. normal values fall in the range 40) 2) MODIFIER_LOW contains GT or GE and MODIFIER_HIGH contains NO (e.g. normal values are >3 with no upper boundary) 3) MODIFIER_HIGH contains LT or LE and MODIFIER_LOW contains NO (e.g. normal values are <=10 with no lower boundary)
stringModifier for NORM_RANGE_LOW values. For numeric results one of the following needs to be true: 1) Both MODIFIER_LOW and MODIFIER_HIGH contain EQ (e.g. normal values fall in the range 40) 2) MODIFIER_LOW contains GT or GE and MODIFIER_HIGH contains NO (e.g. normal values are >3 with no upper boundary) 3) MODIFIER_HIGH contains LT or LE and MODIFIER_LOW contains NO (e.g. normal values are <=10 with no lower boundary)
stringUpper bound of the normal range assigned by the laboratory. Value should only contain the value of the upper bound. The symbols >, <, >=, <= should be removed. For example, if the normal range for a test is >100 and <300, then “300” should be entered.
stringLower bound of the normal range assigned by the laboratory. Value should only contain the value of the lower bound. The symbols >, <, >=, <= should be removed. For example, if the normal range for a test is >100 and <300, then “100” should be entered.
stringRefers to: demographic / patid
Arbitrary person-level identifier. Used to link across tables.
stringImmediacy of test. The intent of this variable is to determine whether the test was obtained as part of routine care or as an emergent/urgent diagnostic test (designated as Stat or Expedite).
stringLocal facility code that identifies the hospital or clinic. Taken from facility claims.
stringLocal code related to an individual lab test. This variable will not be used in queries, but may be used by local programmers to associate a record with a particular LAB_NAME.
stringLocal code related to an individual lab test. This variable will not be used in queries, but may be used by local programmers to associate a record with a particular LAB_NAME.
stringLocal code for ordering provider department.
stringLocal code related to a battery or panel of lab tests. This variable will not be used in queries, but may be used by local programmers to associate a record with a particular LAB_NAME.
stringThe original test result value as seen in your source data. Values may include a decimal point, a sign or text (e.g., POSITIVE, NEGATIVE, DETECTED). The symbols >, <, >=, <= should be removed from the value and stored in the Modifier variable instead.
stringOriginal units for the result in your source data.
stringResult date.
dateLocation of the test result. Point of Care locations may include anticoagulation clinic, newborn nursery, finger stick in provider office, or home. The default value is ‘L’ unless the result is Point of Care. There should not be any missing values.
stringModifier for result values. Any symbols in the RAW_RESULT value should be reflected in the RESULT_MODIFIER variable. For example, if the original source data value is “<=200” then RAW_RESULT=200 and RESULT_MODIFIER=LE. If the original source data value is text then RESULT_MODIFIER=TX. If the original source data value is a numeric value then RESULT_MODIFIER=EQ.
stringStandardized/converted result for quantitative results. Please see the Implementation Guidance for additional details (description updated for v4). v3.1 modification: SAS data type corrected to Numeric. Number precision and scale updated in v3.1.
numberStandardized result for qualitative results. This variable should be NI for quantitative results. Please see the Implementation Guidance for additional details and information on acceptable values for each qualitative LAB_NAME (description updated in v4).
stringIf the qualitative result has been mapped to SNOMED CT, the corresponding SNOMED code can be placed here.
stringResult time.
stringConverted/standardized units for the result. Please see the Implementation Guidance for additional details (description updated in v4).
stringDate specimen was collected.
dateSpecimen source. All records will have a specimen source; some tests have several possible values for SPECIMEN_SOURCE. Please see the Implementation Guidance for additional details. (Description updated for v4.)
stringTime specimen was collected.
string“Longitudinal record of a patients address that adheres to the requirements of a Limited Data Set.”
Fields
The name of the city, town, village or other community.
stringThe name of the county associated with the address.
stringDate when address was no longer in use.
dateInitial date when the address is known to be in use.
dateIndicates whether this address is the preferred one for a given patient, address use and address type within a given address period.
stringState, as represented by 2-digit postal abbreviation.
stringType of address.
stringPurpose of the address. Details of categorical definitions: Home: A communication address at home. Work: An office address. First choice for business-related contacts during business hours. Temp: A temporary address. Old/Incorrect: This address is no longer in use (or was never correct but retained for records). Other Home: An address where the patient resides, but is not considered the primary home address.
string5-digit postal code for the address.
string9-digit postal code for the address.
stringArbitrary identifier for each unique address record.
stringFive-digit Federal Information Processing System (FIPS) code for the county associated with the address record. The first two digits of the county FIPS code correspond to the state.
stringFlag to indicate whether this address record should be considered as the patients current physical home address.
stringRefers to: demographic / patid
Arbitrary person-level identifier. Used to link across tables.
stringRural Urban Commuting Area (RUCA) code for the 5-digit zip code associated with the address record.
stringTwo-digit Federal Information Processing System (FIPS) code for the state associated with the address record.
stringRecords of medications administered to patients by healthcare providers. These administrations may take place in any setting, including inpatient, outpatient or home health encounters
Fields
Refers to: encounter / encounterid
Arbitrary encounter-level identifier. This is an optional relationship because not all vital sign measures will be associated with a healthcare encounter. (New description added in v4.)
stringMedication code
stringDose of a given mediation, as administered by the provider. Do not impute or derive if not expressly defined in the source system as a discrete field.
numberUnits of measure associated with the dose of the medication as administered by the provider. Do not impute or derive if not expressly defined in the source system as a discrete field. Choose the standardized unit of measure that is most reflective of the source data. The Value Set Appendix contains a list of the units most commonly associated with medication records. Partners can use this table to aid in their mapping efforts, but they should refer back to the full value set if they have a medication record with a unit of measure that is not present in this curated list.
stringRefers to: provider / providerid
Provider code for the provider who prescribed the medication. The provider code is a pseudoidentifier with a consistent crosswalk to the real identifier.
stringRoute of medication delivery.
stringSource of the medication administration record. This field is a derived attribute, and is not expected to be an explicit data field within a source system. Use “OD” for medication orders entered into the EHR. Use “DR” for all medication orders that are derived or imputed through analytical procedures (e.g., natural language processing). This does not apply to administrations mapped from a superset terminology or drug database (e.g., MediSpan, FDB). For those records, use “OD” (General Guidance #4).
stringDate medication administration started/occurred
dateTime medication administration started/occurred
stringDate medication administration ended
dateTime medication administration ended
stringThis field is a derived attribute, and is not expected to be an explicit data field within a source system If mapping from medication database (e.g., MediSpan, FDB), and it is possible to map to RxNorm and NDC, RxNorm is the preferred term type. If medication administration records are stored natively as NDC, do not convert to RxNorm.
stringArbitrary identifier for each unique MED_ADMIN record.
stringRefers to: demographic / patid
Arbitrary person-level identifier used to link across tables.
stringThis is an optional relationship to the PRESCRIBING table, and may not be generally available. One prescribing order may generate multiple administration records.
stringField for originating value, prior to mapping into the PCORnet CDM value set.
stringField for originating value, prior to mapping into the PCORnet CDM value set.
stringField for originating value, prior to mapping into the PCORnet CDM value set.
stringField for originating, full textual medication name from the source.
stringField for originating value, prior to mapping into the PCORnet CDM value set.
stringStandardized qualitative and quantitative clinical observations about a patient
Fields
Refers to: encounter / encounterid
Arbitrary encounter-level identifier used to link across tables.
stringAbnormal result indicator. This value comes from the source data; do not apply logic to create it. If field is blank in source data, map to the appropriate flavor of null.
stringCode of the clinical observation in the vocabulary/terminology specified in OBSCLINTYPE. Results with local versions of LOINC codes (e.g., LOINC candidate codes) should be included in the RAW table field. The last digit of the LOINC code is a check digit and is always preceded by a hyphen. All parts of the LOINC code, including the hyphen, must be included. Do not pad codes with leading zeros.
stringRefers to: provider / providerid
Provider code for the provider who ordered the observation. The provider code is a pseudoidentifier with a consistent crosswalk to the real identifier.
stringModifier for result values.
stringStandardized/converted result for quantitative results. Used to store quantitative results, including the numeric component of numeric results that contain operators (e.g., “= 0.5”). See guidance for RESULT_MODIFIER for further details.
numberStandardized result for qualitative results. This variable should be NI for quantitative results. If qualitative result cannot be harmonized to a value in OBSCLIN_RESULT_QUAL value set, please ensure that RAW_OBSCLIN_RESULT is populated with result value.
stringIf the qualitative result has been mapped to SNOMED CT, the corresponding SNOMED code can be placed here. Partners are not expected to derive or impute if not present in the source system.
stringNarrative/textual clinical observations
stringConverted/standardized units for the result.
stringSource of the information for the lab result.
stringDate of observation/measurement
dateTime of observation/measurement.
stringDate of observation/measurement
dateTime of observation/measurement.
stringTerminology / vocabulary used to describe the clinical observation.
stringArbitrary identifier for each unique OBS_CLIN record.
stringRefers to: demographic / patid
Arbitrary person-level identifier. Used to link across tables.
stringLocal code related to an individual clinical observation/measurement.
stringThe original modifier text as represented in your source data.
stringLocal name related to an individual clinical observation/measurement.
stringThe original test result value as seen in your source data. Values may include a decimal point, a sign or text (e.g., POSITIVE, NEGATIVE, DETECTED). The symbols >, <, >=, <= should be removed from the value and stored in the Modifier variable instead.
stringTerminology related to the code in RAW_OBSGEN_CODE.
stringOriginal units for the result in your source data.
string“This table provides a generalized structure for storing observations and is not optimized for analytical efficiency. As elements from this table are used in studies and/or distributed queries
Fields
Refers to: encounter / encounterid
Arbitrary encounter-level identifier used to link across tables. This field should be populated if the observation was recorded as part of a healthcare encounter.
stringAbnormal result indicator. This value comes from the source data; do not apply logic to create it. If field is blank in source data, map to the appropriate flavor of null.
stringStandardized code denoting the observations based on the terminology/vocabulary specified in OBSGEN_TYPE
stringIdentifier when observation describes attributes of an existing record in the CDM. If observation record modifies something other than the patient (i.e., attribute about an encounter), a link to that record can be included here. If a value is listed in OBSGEN_TABLE_MODIF IED, then a corresponding ID should be listed in OBSGEN_ID_MODIFIED. If modifying a record in OBS_GEN, the value of OBSGEN_ID_MODIFIED must be different than the value of OBSGENID for that record.
stringRefers to: provider / providerid
Provider code for the provider who recorded the observation. The provider code is a pseudoidentifier with a consistent crosswalk to the real identifier.
stringModifier for result values. Any symbols in the RAW_RESULT value should be reflected in the RESULT_MODIFIER variable.For example, if the original source data value is “<=200” then RAW_RESULT=200 and RESULT_MODIFIER=LE. RESULT_NUM would also be set to “200”. If the original source data value is text, then RESULT_MODIFIER=TX If the original source data value is a numeric value, then RESULT_MODIFIER=EQ
stringStandardized/converted result for quantitative results. Used to store quantitative results, including the numeric component of numeric results that contain operators (e.g., “= 0.5”). See guidance for RESULT_MODIFIER for further details.
numberStandardized result for qualitative results. This variable should be NI for quantitative results. Use RAW_OBSGEN_RESULT to store qualitative results that cannot be harmonized to the defined value set.
stringNarrative/textual observations.
stringConverted/standardized units for the result.
stringSource of the information for the lab result.
stringDate of observation/measurement
dateTime of observation/measurement.
stringDate of observation/measurement
dateTime of observation/measurement.
stringTable name when observation describes attributes of an existing record in the CDM. If observation record modifies something other than the patient (i.e., attribute about an encounter), a link to that table can be included here. If a value is listed in OBSGEN_TABLE_MODIF IED, then a corresponding ID should be listed in OBSGEN_ID_MODIFIED.
stringTerminology/vocabulary used to describe the observation. Networks/partners can define their own terminologies with strings starting with UD. Strings that start with PC are reserved for network-wide activities and will be assigned by the Coordinating Center.
stringArbitrary identifier for each unique OBS_GEN record.
stringRefers to: demographic / patid
Arbitrary person-level identifier. Used to link across tables.
stringLocal code related to an individual clinical observation/measurement.
stringLocal name related to an individual clinical observation/measurement.
stringThe original test result value as seen in your source data.
stringTerminology related to the code in RAW_OBSGEN_CODE.
stringOriginal units for the result in your source data.
stringThis table is used to store information about the relationships between patients within a given PCORnet Common Data Model.
Fields
Refers to: demographic / patid
Arbitrary person-level identifier used to link across tables. PATID of the first patient in the relationship link.
stringRefers to: demographic / patid
Arbitrary person-level identifier used to link across tables. PATID of the second patient in the relationship link.
stringThe date the indicated relationship was believed to have ended, if known.
dateThe date the indicated relationship was believed to have started, if known.
dateCode denoting the relationship between the two patients. The order of the terms indicates directionality. For instance, if using birth mother child, PATID_1 represents birth mother, PATID_2, the child.
stringPatients who are enrolled in PCORnet clinical trials.
Fields
Arbitrary person-level identifier used to uniquely identify a participant in a PCORnet trial. PARTICIPANTID is never repeated or reused for a specific clinical trial, and is generally assigned by trial-specific processes. It may be the same as a randomization ID.
stringRefers to: demographic / patid
Arbitrary person-level identifier used to link across tables.
stringDate on which the participant completes participation in the trial.
dateDate on which the participant enrolled in the trial (generally coincides with trial consent process).
dateTextual strings used to uniquely identify invitations sent to potential participants, and allows acceptances to be associated back to the originating source. Where used, there should generally be a unique combination of PATID, TRIAL_NAME, and INVITE_CODE within each datamart. For example, this might include “co-enrollment ID strings” for e-mail invites or “verification codes” for letter invites
stringEach TRIAL_SITEID is assigned by the PCORnet trial coordinating center.
stringIf applicable, date on which the participant withdraws consent from the trial.
dateEach TRIALID is assigned by the PCORnet trial’s coordinating center.
stringProvider orders for medication dispensing and/or administration. These orders may take place in any setting, including the inpatient or outpatient basis.
Fields
Refers to: encounter / encounterid
Arbitrary encounter-level identifier. This is an optional relationship; the ENCOUNTERID should be present if the prescribing activity is directly associated with an encounter.
stringRefers to: demographic / patid
Arbitrary person-level identifier used to link across tables.
stringArbitrary identifier for each unique PRESCRIBING record. Does not need to be persistent across refreshes, and may be created by methods such as sequence or GUID.
stringTotal: 1
| Table | Field | Name |
|---|---|---|
| dispensing | prescribingid | fk_dispensing_prescribingid |
Field for originating value, prior to mapping into the PCORnet CDM value set.
stringField for originating value, prior to mapping into the PCORnet CDM value set.
stringOptional field for originating value of field, prior to mapping into the PCORnet CDM value set.
stringOptional field for originating, full textual medication name from the source.
stringOptional field for originating value of field, prior to mapping into the PCORnet CDM value set..
stringOptional field for originating value of field, prior to mapping into the PCORnet CDM value set.
stringField for originating value, prior to mapping into the PCORnet CDM value set.
stringField for originating value, prior to mapping into the PCORnet CDM value set.
stringOptional field for originating value of field, prior to mapping into the PCORnet CDM value set. v4 modification: field types changed to character because the National Library of Medicine specifies this variable as a character type.
stringBasis of the medication order. The PRESCRIBING table can contain orders for many different activities, and this field is intended to connect the provider’s prescribing order with how the order was fulfilled (such as outpatient dispensing or administration by a healthcare professional). (Value set items updated and field definition expanded in v4.)
stringNumber of days supply ordered, as specified by the prescription. Number precision and scale updated in v4.
numberFlag to indicate whether the provider indicated that the medication order was to be dispensed as written.
stringThe unit associated with the quantity prescribed.
stringDose of a given mediation, as ordered by the provider
numberUnits of measure associated with the dose of the medication as ordered by the provider
stringEnd date of order (if available).
dateSpecified frequency of medication.
stringOrder date of the prescription by the provider.
dateOrder time of the prescription by the provider.
stringFlag to indicate that all or part of medication frequency instructions includes Òas needed.Ó
stringProvider code for the provider who prescribed the medication. The provider code is a pseudoidentifier with a consistent crosswalk to the real identifier.
stringQuantity ordered. Number precision and scale updated in v4.
numberThe unit associated with the quantity prescribed. New field added in v4.
stringNumber of refills ordered (not including the original prescription). If no refills are ordered, the value should be zero. Number precision and scale updated in v4.
numberRoute of medication delivery.
stringSource of the prescribing information.
stringStart date of order. This attribute may not be consistent with the date on which the patient actually begin taking the medication.
dateWhere an RxNorm mapping exists for the source medication, this field contains the RxNorm concept identifier (CUI) at the highest possible specificity. If more than one option exists for mapping, the following ordered strategy may be adopted: 1)Semantic generic clinical drug 2)Semantic Branded clinical drug 3)Generic drug pack 4)Branded drug pack
string“Protected table that can be used to store the results of geocoding algorithms.”
Fields
Refers to: private_address_history / addressid
Arbitrary identifier for each unique address record.
stringDate that the geocoding was completed.
dateLevel of accuracy of the geocoded address based on the method used.
stringReference to the methodology/software and parameters used to assign the geocode.
stringCensus Block associated with the address.
stringCounty associated with the address.
stringField that can be used to store a custom/local geocode for a given address.
stringText description of the terminology/approach used to assign the custom geocode.
stringCensus Block Group associated with the address.
stringLatitude assigned to the address by the geocoding algorithm. WGS84 format.
stringLongitude assigned to the address by the geocoding algorithm. WGS84 format.
stringState associated with the address.
stringCensus Tract associated with the address.
stringZip code tabulation area associated with the address.
stringArbitrary person-level identifier. Used to link across tables.
stringName of shapefile used in the geocoding process.
string“Protected table that can be used to store elements of a patients address that are considered personal health information (PHI). These data can be used for geocoding or other linkage projects.”
Fields
The name of the city, town, village or other community.
stringThe name of the county associated with the address.
stringRemaining address details (e.g., suite, post office box, other details)
stringDate when address was no longer in use.
dateInitial date when the address is known to be in use.
dateIndicates whether this address is the preferred one for a given patient, address use and address type within a given address period.
stringState, as represented by 2-digit postal abbreviation.
stringPrimary address line (e.g., street name and number)
stringType of address.
stringPurpose of the address. Details of categorical definitions: Home: A communication address at home. Work: An office address. First choice for business-related contacts during business hours. Temp: A temporary address. Old/Incorrect: This address is no longer in use (or was never correct but retained for records). Other Home: An address where the patient resides, but is not considered the primary home address.
string5-digit postal code for the address.
string9-digit postal code for the address.
stringArbitrary identifier for each unique address record.
stringTotal: 1
| Table | Field | Name |
|---|---|---|
| private_address_geocode | addressid | fk_gecode_addressid |
Five-digit Federal Information Processing System (FIPS) code for the county associated with the address record. The first two digits of the county FIPS code correspond to the state.
stringFlag to indicate whether this address record should be considered as the patients current physical home address.
stringRefers to: demographic / patid
Arbitrary person-level identifier. Used to link across tables.
stringText representation of the address
stringRural Urban Commuting Area (RUCA) code for the 5-digit zip code associated with the address record.
stringTwo-digit Federal Information Processing System (FIPS) code for the state associated with the address record.
string“Protected table that is intended to provide a standardized representation of the personally-identifiable information (PII) that is needed to support local activities related to record linkage.”
Fields
Flag to indicate that one or more biobanked specimens are stored and available for research use. Examples of biospecimens could include plasma, urine, or tissue. If biospecimens are available, locally maintained ‘mapping tables’ would be necessary to map between the DEMOGRAPHIC record and the originating biobanking system(s). If no known biobanked specimens are available, this field should be marked ‘No’.
stringDate of birth.
dateTime of birth.
stringCurrent gender identity.
stringA person of Cuban, Mexican, Puerto Rican, South or Central American, or other Spanish culture or origin, regardless of race.
stringOrganization where record originated
stringLocal Medical Record Number for the patient
stringCorresponds to PATID in the originating CDM if receiving data from multiple managing organizations.
stringGiven name of the patient.
stringSurname of the patient.
stringSurname or family name prior to marriage.
stringMiddle name of the patient.
stringPreferred spoken language of communication as expressed by the patient. New field in v4.
stringSocial Security Number (SSN; whole or part).
stringRefers to: demographic / patid
Arbitrary person-level identifier used to link across tables. PATID is a pseudoidentifier with a consistent crosswalk to the true identifier retained by the source Data Partner. For analytical data sets requiring patient-level data, only the pseudoidentifier is used to link across all information belonging to a patient. The PATID must be unique within the data source being queried. Creating a unique identifier within a CDRN would be beneficial and acceptable. The PATID is not the basis for linkages across partners.
stringPrimary e-mail address for the patient.
stringPrimary phone number for the patient (if known).
stringPlease use only one race value per patient. Details of categorical definitions: American Indian or Alaska Native: A person having origins in any of the original peoples of North and South America (including Central America), and who maintains tribal affiliation or community attachment. Asian: A person having origins in any of the original peoples of the Far East, Southeast Asia, or the Indian subcontinent including, for example, Cambodia, China, India, Japan, Korea, Malaysia, Pakistan, the Philippine Islands, Thailand, and Vietnam. Black or African American: A person having origins in any of the black racial groups of Africa. Native Hawaiian or Other Pacific Islander: A person having origins in any of the original peoples of Hawaii, Guam, Samoa, or other Pacific Islands. White: A person having origins in any of the original peoples of Europe, the Middle East, or North Africa.
stringField to indicate whether patient identifies with the categories of American Indian or Alaska Native race/ethnicity. Details of categorical definition: American Indian or Alaska Native: Individuals with origins in any of the original peoples of North, Central, and South America, including, for example, Navajo Nation, Blackfeet Tribe of the Blackfeet Indian Reservation of Montana, Native Village of Barrow Inupiat Traditional Government, Nome Eskimo Community, Aztec, and Maya.
stringField to indicate whether patient identifies with the categories of Asian race/ethnicity. Details of categorical definition: Asian: Individuals with origins in any of the original peoples of Central or East Asia, Southeast Asia, or South Asia, including, for example, Chinese, Asian Indian, Filipino, Vietnamese, Korean, and Japanese.
stringField to indicate whether patient identifies with the categories of Black or African American race/ethnicity. Details of categorical definition: Black or African American: Individuals with origins in any of the Black racial groups of Africa, including, for example, African American, Jamaican, Haitian, Nigerian, Ethiopian, and Somali.
stringField to indicate whether patient identifies with the categories of Hispanic or Latino race/ethnicity. Details of categorical definition: Hispanic or Latino: Includes individuals of Mexican, Puerto Rican, Salvadoran, Cuban, Dominican, Guatemalan, and other Central or South American or Spanish culture or origin.
stringField to indicate whether patient identifies with the categories of Middle Eastern or North African race/ethnicity. Details of categorical definition: Middle Eastern or North African: Individuals with origins in any of the original peoples of the Middle East or North Africa, including, for example, Lebanese, Iranian, Egyptian, Syrian, Iraqi, and Israeli.
stringField to indicate whether patient has refused to provide a response to question(s) related to race/ethnicity or if a response does not conform to other values.
stringField to indicate whether patient identifies with the categories of Native Hawaiian or Pacific Islander race/ethnicity. Details of categorical definition: Native Hawaiian or Pacific Islander: Individuals with origins in any of the original peoples of Hawaii, Guam, Samoa, or other Pacific Islands, including, for example, Native Hawaiian, Samoan, Chamorro, Tongan, Fijian, and Marshallese.
stringField to indicate whether patient identifies with the categories of White race/ethnicity. Details of categorical definition: White: Individuals with origins in any of the original peoples of Europe, including, for example, English, German, Irish, Italian, Polish, and Scottish.
stringOptional field for originating value of field, prior to mapping into the PCORnet CDM value set.
stringOptional field for originating value of field, prior to mapping into the PCORnet CDM value set.
stringFull name of the patient, as represented in the source.
stringPreferred spoken language of communication as expressed by the patient
stringOptional field for originating value of field, prior to mapping into the PCORnet CDM value set.
stringOptional field for originating value of field, prior to mapping into the PCORnet CDM value set.
stringOptional field for originating value of field, prior to mapping into the PCORnet CDM value set.
stringAdministrative sex. v4 definition updated: Sex assigned at birth v2.0 guidance added: The “Ambiguousâ€ù category may be used for individuals who are physically undifferentiated from birth. The “Otherâ€ù category may be used for individuals who are undergoing gender re-assignment.
stringSexual orientation.
stringThis table is used to store responses to patient-reported outcome measures (PROs), surveys, and questionnaires. This table can be used to store item-level responses as well as the overall score for each measure.
Fields
Refers to: encounter / encounterid
Arbitrary encounter-level identifier used to link across tables. This is an optional field, and should only be populated if the item was collected as part of a healthcare encounter.
stringRefers to: demographic / patid
Arbitrary person-level identifier for the patient for whom the PRO response was captured. Used to link across tables.
stringIndicates whether Computer Adaptive Testing (CAT) was used to administer the survey or instrument that the item was part of. May apply to electronic (EC) and telephonic (PH or IV) modes.
stringArbitrary identifier for each unique record. Does not need to be persistent across refreshes, and may be created by methods such as sequence or GUID.
stringStandardized code for the PRO item or measure, if available.
stringThe date of the response.
dateFull name of the PRO item or measure.
stringMethod of administration. Electronic includes responses captured via a personal or tablet computer, at web kiosks, or via a smartphone.
stringThe person who responded on behalf of the patient for whom the response was captured. A proxy report is a measurement based on a report by someone other than the patient reporting as if he or she is the patient, such as a parent responding for a child, or a caregiver responding for an individual unable to report for themselves. Assistance excludes providing interpretation of the patient response.
stringShort name of the PRO item or measure in the vocabulary/terminology specified in PRO_TYPE.
stringThe numeric response recorded for the item. Please see the Common Measures reference table for the list of valid responses for each item. Number precision and scale updated in v4.
numberText version of the response recorded for the item or measure, if available/applicable.
stringArbitrary ID/sequence number used to link PRO item responses that are associated with the same measure/form.
stringSource of the information for the PRO result.
stringText of the PRO item question or measure.
stringThe time of the response.
stringTerminology / vocabulary used to describe the PRO item.
stringVersion of the item/question or measure.
stringProcedure codes indicate the discreet medical interventions and diagnostic testing, such as surgical procedures and lab orders, delivered within a healthcare context.
Fields
Please note: This is a field replicated from the ENCOUNTER table. See ENCOUNTER table for definitions.
datePlease note: This is a field replicated from the ENCOUNTER table. See ENCOUNTER table for definitions.
stringRefers to: encounter / encounterid
Arbitrary encounter-level identifier. Used to link across tables.
stringRefers to: demographic / patid
Arbitrary person-level identifier. Used to link across tables.
stringPrincipal procedure flag.
stringArbitrary identifier for each unique record. Does not need to be persistent across refreshes, and may be created by methods such as sequence or GUID.
stringTotal: 1
| Table | Field | Name |
|---|---|---|
| immunization | proceduresid | fk_immun_procedureid |
Refers to: provider / providerid
Please note: This is a field replicated from the ENCOUNTER table. See ENCOUNTER table for definitions.
stringProcedure code.
stringPX_DATE should reflect the date the procedure was performed, if known. Leave blank if you cannot determine if or when the procedure was performed.
dateNew to v2.0. Source of the procedure information. Order and billing pertain to internal healthcare processes and data sources. Claim pertains to data from the bill fulfillment, generally data sources held by insurers and other health plans. Length of data types updated in v4.
stringProcedure code type. We include a number of code types for flexibility, but the basic requirement that the code refer to a medical procedure remains. Revenue codes are a standard concept in Medicare billing and can be useful for defining care settings. If those codes are available they can be included. Medications administered by clinicians can be captured in billing data and Electronic Health Records (EHRs) as HCPCS procedure codes. Administration (infusion) of chemotherapy is an example. We are now seeing NDCs captured as part of procedures because payers are demanding it for payment authorization. Inclusion of this code type enables those data partners that capture the NDC along with the procedure to include the data. Please note: The “Other” category is meant to identify internal use ontologies and codes. Value set modified in v4 to combine CPT and HCPCS codes into one category; also, ICD-9 value set item typo corrected to ICD-9-PCS.
stringField for originating value, prior to mapping into the PCORnet CDM value set.
stringOptional field for originating value of field, prior to mapping into the PCORnet CDM value set.
stringOptional field for originating value of field, prior to mapping into the PCORnet CDM value set.
stringData about the providers who are involved in the care processes documented in the CDM
Fields
National Provider Identifier (NPI) of the provider.
numberFlag to indicate whether partner has access to the National Provider Identifier (NPI) of the provider. This field is a derived attribute, and is not expected to be an explicit data field within a source system
stringSex assigned at birth. The “Ambiguous” category may be used for individuals who are physically undifferentiated from birth. The “Other” category may be used for individuals who are undergoing gender re-assignment.
stringPrimary specialty of the provider
stringArbitrary identifier for each unique PROVIDER record. Does not need to be persistent across refreshes, and may be created by methods such as sequence or GUID.
stringTotal: 7
| Table | Field | Name |
|---|---|---|
| diagnosis | providerid | fk_diagnosis_providerid |
| encounter | providerid | fk_encounter_providerid |
| immunization | vx_providerid | fk_immun_providerid |
| med_admin | medadmin_providerid | fk_medadmin_providerid |
| obs_clin | obsclin_providerid | fk_obsclin_providerid |
| obs_gen | obsgen_providerid | fk_obsgen_providerid |
| procedures | providerid | fk_procedures_providerid |
Field for originating value of field, prior to mapping into the PCORnet CDM value set.
string“Vital signs (such as height, weight, and blood pressure) directly measure an individualÕs current state of attributes.”
Fields
Position for orthostatic blood pressure. This value should be null if blood pressure was not measured.
stringDiastolic blood pressure (in mmHg). Only populated if measure was taken on this date. If missing, this value should be null. Number precision and scale updated in v4
numberRefers to: encounter / encounterid
Arbitrary encounter-level identifier. This is an optional relationship because not all vital sign measures will be associated with a healthcare encounter. (New description added in v4.)
stringHeight (in inches) measured by standing. Only populated if measure was taken on this date. If missing, this value should be null. Decimal precision is permissible. Number precision and scale updated in v4
numberDate of vitals measure.
dateTime of vitals measure.
stringBMI if calculated in the source system. Decimal precision is permissible (new guidance added in v4). Important: Please do not calculate BMI during CDM implementation. This field should only reflect originating source system calculations, if height and weight are not stored in the source. Number precision and scale updated in v4.
numberRefers to: demographic / patid
Arbitrary person-level identifier. Used to link across tables.
stringOptional field for originating value of field, prior to mapping into the PCORnet CDM value set.
stringOptional field for originating value of field, prior to formatting into the PCORnet CDM.
stringOptional field for originating value of field, prior to mapping into the PCORnet CDM value set.
stringOptional field for originating value of field, prior to formatting into the PCORnet CDM.
stringOptional field for originating value of field, prior to mapping into the PCORnet CDM value set. New to v2.0.
stringOptional field for originating value of field, prior to mapping into the PCORnet CDM value set. New to v2.0.
stringIndicator for any form of tobacco that is smoked. Per Meaningful Use guidance, “…smoking status includes any form of tobacco that is smoked, but not all tobacco use.” “’Light smoker’ is interpreted to mean less than 10 cigarettes per day, or an equivalent (but less concretely defined) quantity of cigar or pipe smoke. ‘Heavy smoker’ is interpreted to mean greater than 10 cigarettes per day or an equivalent (but less concretely defined) quantity of cigar or pipe smoke.” “…we understand that a “current every day smoker” or “current some day smoker” is an individual who has smoked at least 100 cigarettes during his/her lifetime and still regularly smokes every day or periodically, yet consistently; a “former smoker” would be an individual who has smoked at least 100 cigarettes during his/her lifetime but does not currently smoke; and a “never smoker” would be an individual who has not smoked 100 or more cigarettes during his/her lifetime.” http://www.healthit.gov/sites/default/files/standardscertification/2014-edition-draft-test-procedures/170-314-a-11- smoking-status-2014-test-procedure-draft-v1.0.pdf [retrieved May 11, 2015]
stringSystolic blood pressure (in mmHg). Only populated if measure was taken on this date. If missing, this value should be null. Number precision and scale updated in v4
numberThis field is new to v2.0 with revised value set and field definition in v4.0. Indicator for any form of tobacco
stringThis field is new to v2.0, with revised value set in v4.1. Type(s) of tobacco used.
stringPlease note: The “Patient-reported” category can include reporting by patient’s family or guardian. v2.0 amendment: The new categorical value of PD and HD have been added. v2.0 guidance added with slight modification in v4.1: If unknown whether data are received directly from a device feed, use the more general context (such as patient-reported, healthcare delivery setting, or registry).
stringArbitrary identifier for each unique VITAL record. Does not need to be persistent across refreshes, and may be created by methods such as sequence or GUID.
stringWeight (in pounds). Only populated if measure was taken on this date. If missing, this value should be null. Decimal precision is permissible. Number precision and scale updated in v4
number