A condition represents a patient’s diagnosed and self-reported health conditions and diseases. The patient’s 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 v3.1.)
string
Please 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.
string
Condition 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).
string
Condition 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 v3.1).
string
Arbitrary identifier for each unique record. Does not need to be persistent across refreshes, and may be created by methods such as sequence or GUID.
string
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. 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.
string
The 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 v3.1.)
date
Refers to: demographic / patid
Arbitrary person-level identifier. Used to link across tables.
string
Optional field for originating value of field, prior to mapping into the PCORnet CDM value set.
string
Optional field for originating value of field, prior to mapping into the PCORnet CDM value set.
string
Optional field for originating value of field, prior to mapping into the PCORnet CDM value set.
string
Optional field for originating value of field, prior to mapping into the PCORnet CDM value set.
string
Date 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.
date
Date 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.
date
Reported mortality information for patients.
Fields
Date of death.
date
When date of death is imputed, this field indicates which parts of the date were imputed.
string
For 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)
string
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.
string
Refers to: demographic / patid
Arbitrary person-level identifier used to link across tables.
string
The individual causes associated with a reported death.
Fields
Cause of death code. Please include the decimal point in ICD codes (if any).
string
Cause of death code type.
string
Confidence in the accuracy of the cause of death based on source, match, number of reporting sources, discrepancies, etc.
string
Source 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.
string
Cause of death type. There should be only one underlying cause of death.
string
Refers to: demographic / patid
Arbitrary person-level identifier used to link across tables.
string
Demographics 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’.
string
Date of birth.
date
Time of birth.
string
Current gender identity. New field in v3.1
string
A person of Cuban, Mexican, Puerto Rican, South or Central American, or other Spanish culture or origin, regardless of race.
string
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.
string
Total: 13
Table | Field | Name |
---|---|---|
enrollment | patid | fk_enrollment_patid |
encounter | patid | fk_encounter_patid |
diagnosis | patid | fk_diagnosis_patid |
procedures | patid | fk_procedures_patid |
vital | patid | fk_vital_patid |
dispensing | patid | fk_dispensing_patid |
lab_result_cm | patid | fk_lab_result_cm_patid |
condition | patid | fk_condition_patid |
pro_cm | patid | fk_pro_cm_patid |
prescribing | patid | fk_prescribing_patid |
pcornet_trial | patid | fk_pcornet_trial_patid |
death | patid | fk_death_patid |
death_cause | patid | fk_death_cause_patid |
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.
string
Optional field for originating value of field, prior to mapping into the PCORnet CDM value set.
string
Optional field for originating value of field, prior to mapping into the PCORnet CDM value set.
string
Optional field for originating value of field, prior to mapping into the PCORnet CDM value set.
string
Optional field for originating value of field, prior to mapping into the PCORnet CDM value set.
string
Optional field for originating value of field, prior to mapping into the PCORnet CDM value set.
string
Administrative sex. v3.1 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.
string
Sexual orientation. New field in v3.1
string
Diagnosis 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.
date
Arbitrary identifier for each unique record. Does not need to be persistent across refreshes, and may be created by methods such as sequence or GUID.
string
Diagnosis 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 v3.1.)
string
Source 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 v3.1.
string
Classification 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.”
string
Diagnosis 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.
string
Please note: This is a field replicated from the ENCOUNTER table. See the ENCOUNTER table for definitions.
string
Refers to: encounter / encounterid
Arbitrary encounter-level identifier. Used to link across tables.
string
Refers to: demographic / patid
Arbitrary person-level identifier. Used to link across tables.
string
Principal 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.
string
Please note: This is a field replicated from the ENCOUNTER table. See the ENCOUNTER table for definitions.
string
Optional field for originating value of field, prior to mapping into the PCORnet CDM value set.
string
Optional field for originating value of field, prior to mapping into the PCORnet CDM value set.
string
Optional field for originating value of field, prior to mapping into the PCORnet CDM value set.
string
Optional field for originating value of field, prior to mapping into the PCORnet CDM value set.
string
Outpatient 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 v3.1.
number
Dispensing date (as close as possible to date the person received the dispensing).
date
Days 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 v3.1.
number
Arbitrary identifier for each unique record. Does not need to be persistent across refreshes, and may be created by methods such as sequence or GUID.
string
National 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)
string
Refers to: demographic / patid
Arbitrary person-level identifier. Used to link across tables.
string
Refers 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.
string
Optional field for originating value of field, prior to mapping into the PCORnet CDM value set.
string
Encounters are interactions between patients and providers within the context of healthcare delivery.
Fields
Encounter or admission date.
date
Encounter or admission time.
string
Admitting 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.
string
Discharge 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.
date
Vital 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.
string
Discharge 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.
string
Discharge time.
string
3-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.
string
DRG 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.
string
Encounter 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 v3.1). 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 v3.1). 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 v3.1). 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 v3.1). 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.
string
Arbitrary encounter-level identifier. Used to link across tables, including the ENCOUNTER, DIAGNOSIS, and PROCEDURE tables.
string
Total: 7
Table | Field | Name |
---|---|---|
diagnosis | encounterid | fk_diagnosis_encounterid |
procedures | encounterid | fk_procedures_encounterid |
vital | encounterid | fk_vital_encounterid |
lab_result_cm | encounterid | fk_lab_result_cm_encounterid |
condition | encounterid | fk_condition_encounterid |
pro_cm | encounterid | fk_pro_cm_encounterid |
prescribing | encounterid | fk_prescribing_encounterid |
Geographic location (3 digit zip code). Should be null if not recorded in source system.
string
Arbitrary 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.
string
Refers to: demographic / patid
Arbitrary person-level identifier used to link across tables.
string
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.
string
Optional field for originating value of field, prior to mapping into the PCORnet CDM value set.
string
Optional field for originating value of field, prior to mapping into the PCORnet CDM value set.
string
Optional field for originating value of field, prior to mapping into the PCORnet CDM value set.
string
Optional field for originating value of field, prior to mapping into the PCORnet CDM value set.
string
Optional field for originating value of field, prior to mapping into the PCORnet CDM value set.
string
This 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.
string
Enrollment 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.
string
When 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 v3.1.) 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 v3.1 to include drug coverage.
string
Date of the end of the enrollment period. If the exact date is unknown, use the last day of the month.
date
Date 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.
date
Refers to: demographic / patid
Arbitrary person-level identifier used to link across tables.
string
Attributes associated with the specific PCORnet datamart implementation.
Fields
Data management strategy currently present in the ADMIT_DATE field on the ENCOUNTER table Please see notes for additional definitions.
string
Data management strategy currently present in the BIRTH_DATE field on the DEMOGRAPHIC table Please see notes for additional definitions.
string
Version currently implemented within this datamart (for example, 1.0, 2.0, 3.0). Number precision and scale updated in v3.1.
number
Datamart includes claims data source(s)
string
Datamart includes EHR data source(s)
string
Descriptive name of the datamart. This identifier is assigned by the PCORnet Distributed Research Network Operations Center (DRN OC) (description updated in v3.1)
string
string
This identifier is assigned by the PCORnet Distributed Research Network Operations Center (DRN OC) (description updated in v3.1)
string
Data management strategy currently present in the DISCHARGE_DATE field on the ENCOUNTER table Please see notes for additional definitions.
string
Data management strategy currently present in the DISPENSE_DATE field on the DISPENSING table Please see notes for additional definitions.
string
Data management strategy currently present in the ENR_END_DATE field on the ENROLLMENT table Please see notes for additional definitions.
string
Data management strategy currently present in the ENR_START_DATE field on the ENROLLMENT table Please see notes for additional definitions.
string
Data management strategy currently present in the LAB_ORDER_DATE field on the LAB_RESULT_CM table Please see notes for additional definitions.
string
Data management strategy currently present in the MEASURE_DATE field on the VITAL table Please see notes for additional definitions.
string
Descriptive name of the network. This identifier is assigned by the PCORnet Distributed Research Network Operations Center (DRN OC) (description updated in v3.1)
string
This identifier is assigned by the PCORnet Distributed Research Network Operations Center (DRN OC) (description updated in v3.1)
string
Data management strategy currently present in the ONSET_DATE field on the CONDITION table Please see notes for additional definitions.
string
Data management strategy currently present in the PRO_DATE field on the PRO_CM table Please see notes for additional definitions.
string
Data management strategy currently present in the PX_DATE field on the PROCEDURES table Please see notes for additional definitions.
string
Most 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.
date
Most 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.
date
Most 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.
date
Most 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.
date
Most 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.
date
Most 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.
date
Most 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.
date
Most 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.
date
Most 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.
date
Most 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.
date
Most 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.
date
Most 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.
date
Most 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.
date
Most recent date on which the present data were loaded into the VITAL table. This date should be null if the table does not have records.
date
Data management strategy currently present in the REPORT_DATE field on the CONDITION table Please see notes for additional definitions.
string
Data management strategy currently present in the RESOLVE_DATE field on the CONDITION table Please see notes for additional definitions.
string
Data management strategy currently present in the RESULT_DATE field on the LAB_RESULT_CM table Please see notes for additional definitions.
string
Data management strategy currently present in the RX_END_DATE field on the PRESCRIBING table Please see notes for additional definitions.
string
Data management strategy currently present in the RX_ORDER_DATE field on the PRESCRIBING table Please see notes for additional definitions.
string
Data management strategy currently present in the RX_START_DATE field on the PRESCRIBING table Please see notes for additional definitions.
string
Data management strategy currently present in the SPECIMEN_DATE field on the LAB_RESULT_CM table Please see notes for additional definitions.
string
Laboratory 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.
string
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 lab was collected as part of a healthcare encounter.
string
Logical 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.
string
Laboratory result common measure, a categorical identification for the type of test, which is harmonized across all contributing data partners. Please note that it is possible for more than one LOINC code, CPT code, and/or local code to be associated with one LAB_NAME. Value set modified in v3.1 to add ‘null value’ options
string
Date test was ordered.
date
Optional variable for local and standard procedure codes, used to identify the originating order for the lab test.
string
Procedure code type, if applicable. Value set modified in v3.1 to combine CPT and HCPCS codes into one category; also, ICD-9 value set item typo corrected to specify ICD-9-PCS
string
Arbitrary 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.
string
Modifier 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 3-10) 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)
string
Modifier 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 3-10) 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)
string
Upper 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.
string
Lower 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.
string
Refers to: demographic / patid
Arbitrary person-level identifier. Used to link across tables.
string
Immediacy 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).
string
Local facility code that identifies the hospital or clinic. Taken from facility claims.
string
Local 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.
string
Local 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.
string
Local code for ordering provider department.
string
Local 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.
string
The 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.
string
Original units for the result in your source data.
string
Result date.
date
Location 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.
string
Modifier 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.
string
Standardized/converted result for quantitative results. Please see the Implementation Guidance for additional details (description updated for v3.1). v3.1 modification: SAS data type corrected to Numeric. Number precision and scale updated in v3.1.
number
Standardized 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 v3.1).
string
Result time.
string
Converted/standardized units for the result. Please see the Implementation Guidance for additional details (description updated in v3.1).
string
Date specimen was collected.
date
Specimen 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 v3.1.)
string
Time specimen was collected.
string
Patients 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.
string
Refers to: demographic / patid
Arbitrary person-level identifier used to link across tables.
string
Date on which the participant completes participation in the trial.
date
Date on which the participant enrolled in the trial (generally coincides with trial consent process).
date
Textual 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
string
Each TRIAL_SITEID is assigned by the PCORnet trial coordinating center.
string
If applicable, date on which the participant withdraws consent from the trial.
date
Each TRIALID is assigned by the PCORnet trial’s coordinating center.
string
Provider 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.
string
Refers to: demographic / patid
Arbitrary person-level identifier used to link across tables.
string
Arbitrary 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.
string
Total: 1
Table | Field | Name |
---|---|---|
dispensing | prescribingid | fk_dispensing_prescribingid |
Optional field for originating value of field, prior to mapping into the PCORnet CDM value set.
string
Optional field for originating, full textual medication name from the source.
string
Optional field for originating value of field, prior to mapping into the PCORnet CDM value set..
string
Optional field for originating value of field, prior to mapping into the PCORnet CDM value set.
string
Optional field for originating value of field, prior to mapping into the PCORnet CDM value set. v3.1 modification: field types changed to character because the National Library of Medicine specifies this variable as a character type.
string
Basis 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 v3.1.)
string
Number of days supply ordered, as specified by the prescription. Number precision and scale updated in v3.1.
number
End date of order (if available).
date
Specified frequency of medication.
string
Order date of the prescription by the provider.
date
Order time of the prescription by the provider.
string
Provider code for the provider who prescribed the medication. The provider code is a pseudoidentifier with a consistent crosswalk to the real identifier.
string
Quantity ordered. Number precision and scale updated in v3.1.
number
The unit associated with the quantity prescribed. New field added in v3.1.
string
Number of refills ordered (not including the original prescription). If no refills are ordered, the value should be zero. Number precision and scale updated in v3.1.
number
Start date of order. This attribute may not be consistent with the date on which the patient actually begin taking the medication.
date
Where 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
number
Patient-reported outcome Common Measures are standardized measures that are defined in the same way across all PCORnet networks. Each measure is recorded at the individual item level: an individual question/statement, paired with its standardized response options.
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.
string
Refers to: demographic / patid
Arbitrary person-level identifier for the patient for whom the PRO response was captured. Used to link across tables.
string
Indicates 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.
string
Arbitrary identifier for each unique record. Does not need to be persistent across refreshes, and may be created by methods such as sequence or GUID.
string
The date of the response.
date
PCORnet identifier for the specific Common Measure item. Please see the Common Measures reference table for more details. Character length increased in v3.1 to accommodate the potential for additional ontologies.
string
LOINC code for item context and stem. the Implementation Guidance for known LOINC codes for each common measure (description updated in v3.1). Logical 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 PRO_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.
string
Method of administration. Electronic includes responses captured via a personal or tablet computer, at web kiosks, or via a smartphone.
string
The 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’s response.
string
The 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 v3.1.
number
The time of the response.
string
Optional field for originating code, such as LOINC candidate codes that have not yet been adopted
string
Optional field for originating value of field, prior to mapping into the PCORnet CDM value set.
string
Procedure 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.
date
Please note: This is a field replicated from the ENCOUNTER table. See ENCOUNTER table for definitions.
string
Refers to: encounter / encounterid
Arbitrary encounter-level identifier. Used to link across tables.
string
Refers to: demographic / patid
Arbitrary person-level identifier. Used to link across tables.
string
Arbitrary identifier for each unique record. Does not need to be persistent across refreshes, and may be created by methods such as sequence or GUID.
string
Please note: This is a field replicated from the ENCOUNTER table. See ENCOUNTER table for definitions.
string
Procedure code.
string
New to v2.0. Date the procedure was performed.
date
New 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 v3.1.
string
Procedure 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 v3.1 to combine CPT and HCPCS codes into one category; also, ICD-9 value set item typo corrected to ICD-9-PCS.
string
Optional field for originating value of field, prior to mapping into the PCORnet CDM value set.
string
Optional 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.
string
Diastolic 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 v3.1
number
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 v3.1.)
string
Height (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 v3.1
number
Date of vitals measure.
date
Time of vitals measure.
string
BMI if calculated in the source system. Decimal precision is permissible (new guidance added in v3.1). 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 v3.1.
number
Refers to: demographic / patid
Arbitrary person-level identifier. Used to link across tables.
string
Optional field for originating value of field, prior to mapping into the PCORnet CDM value set.
string
Optional field for originating value of field, prior to formatting into the PCORnet CDM.
string
Optional field for originating value of field, prior to formatting into the PCORnet CDM.
string
Optional field for originating value of field, prior to mapping into the PCORnet CDM value set. New to v2.0.
string
Optional field for originating value of field, prior to mapping into the PCORnet CDM value set. New to v2.0.
string
Indicator 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]
string
Systolic 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 v3.1
number
This field is new to v2.0 with revised value set and field definition in v3.1.0. Indicator for any form of tobacco
string
This field is new to v2.0, with revised value set in v3.1.0. Type(s) of tobacco used.
string
Please 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 v3.1.0: 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).
string
Arbitrary 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.
string
Weight (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 v3.1
number