Differences

This shows you the differences between two versions of the page.

--- documentation:cdm:condition_occurrence [2014/12/04 09:37] – created cgreich
+++ documentation:cdm:condition_occurrence [2017/09/25 15:02] (current) – clairblacketer
@@ Line 1: / Line 1: @@
 ===== CONDITION_OCCURRENCE table =====
+**THIS IS OUTDATED. All documentation is now on the [[https://github.com/OHDSI/CommonDataModel/wiki|github wiki]]. Please refer there or to the [[projects:workgroups:cdm-wg|CDM working group]] for more information**
+This table changed in version 5.1 of the OMOP CDM. The fields condition_start_datetime and condition_end_datetime were added. For 5.0.1, this table changed in version 5.X of the OMOP CDM. The fields condition_status_concept_id and condition_status_source_value were added.
+----
 Conditions are records of a Person suggesting the presence of a disease or medical condition stated as a diagnosis, a sign or a symptom, which is either observed by a Provider or reported by the patient. Conditions are recorded in different sources and levels of standardization, for example:
-  * Medical claims data include diagnoses coded in ICD-9-CM that are submitted as part of a reimbursement claim for health services and procedures.
+  * Medical claims data include diagnoses coded in ICD-9-CM that are submitted as part of a reimbursement claim for health services and
-•	EHRs may capture Person Conditions in the form of diagnosis codes or symptoms.
+  * EHRs may capture Person Conditions in the form of diagnosis codes or symptoms.
+^ Field                          ^ Required  ^ Type         ^ Description                                                                                                                                                                                                      ^
+| condition_occurrence_id        | Yes       | integer      | A unique identifier for each Condition Occurrence event.                                                                                                                                                         |
+| person_id                      | Yes       | integer      | A foreign key identifier to the Person who is experiencing the condition. The demographic details of that Person are stored in the PERSON table.                                                                 |
+| condition_concept_id           | Yes       | integer      | A foreign key that refers to a Standard Condition Concept identifier in the Standardized Vocabularies.                                                                                                           |
+| condition_start_date           | Yes       | date         | The date when the instance of the Condition is recorded.                                                                                                                                                         |
+| condition_start_datetime       | No        | datetime     | The date and time when the instance of the Condition is recorded.                                                                                                                                                |
+| condition_end_date             | No        | date         | The date when the instance of the Condition is considered to have ended.                                                                                                                                         |
+| condition_end_datetime         | No        | date         | The date when the instance of the Condition is considered to have ended.                                                                                                                                         |
+| condition_type_concept_id      | Yes       | integer      | A foreign key to the predefined Concept identifier in the Standardized Vocabularies reflecting the source data from which the condition was recorded, the level of standardization, and the type of occurrence.  |
+| stop_reason                    | No        | varchar(20)  | The reason that the condition was no longer present, as indicated in the source data.                                                                                                                            |
+| provider_id                    | No        | integer      | A foreign key to the Provider in the PROVIDER table who was responsible for capturing (diagnosing) the Condition.                                                                                                |
+| visit_occurrence_id            | No        | integer      | A foreign key to the visit in the VISIT table during which the Condition was determined (diagnosed).                                                                                                             |
+| condition_status_concept_id    | No        | integer      | A foreign key to the predefined concept in the standard vocabulary reflecting the condition status.                                                                                                              |
+| condition_source_concept_id    | No        | integer      | A foreign key to a Condition Concept that refers to the code used in the source.                                                                                                                                 |
+| condition_source_value         | No        | varchar(50)  | The source code for the condition as it appears in the source data. This code is mapped to a standard condition concept in the Standardized Vocabularies and the original code is stored here for reference.     |
+| condition_status_source_value  | No        | varchar(50)  |
+==== Conventions ====
+  * Valid Condition Concepts belong to the "Condition" domain.
+  * Condition records are typically inferred from diagnostic codes recorded in the source data. Such code system, like ICD-9-CM, ICD-10-CM, Read etc., provide a comprehensive coverage of conditions. However, if the diagnostic code in the source does not define a condition, but rather an observation or a procedure, then such information is not stored in the CONDITION_OCCURRENCE table, but in the respective tables instead.
+  * Source Condition identifiers are mapped to Standard Concepts for Conditions in the Standardized Vocabularies. When the source code cannot be translated into a Standard Concept, a CONDITION_OCCURRENCE entry is stored with only the corresponding source_concept_id and source_value, while the condition_concept_id is set to 0.
+  * Family history and past diagnoses ("history of") are not recorded in the CONDITION_OCCURRENCE table. Instead, they are listed in the OBSERVATION table.
+  * Codes written in the process of establishing the diagnosis, such as "question of" of and "rule out", are not represented here.  Instead, they are listed in the OBSERVATION table, if they are used for analyses.
+  * A Condition Occurrence Type is assigned based on the data source and type of condition attribute, for example:
+    * ICD-9-CM Primary Diagnosis from inpatient and outpatient Claims
+    * ICD-9-CM Secondary Diagnoses from inpatient and outpatient Claims
+    * Diagnoses or problems recorded in an EHR.
+  * The Stop Reason indicates why a Condition is no longer valid with respect to the purpose within the source data. Typical values include "Discharged", "Resolved", etc.  Note that a Stop Reason does not necessarily imply that the condition is no longer occurring.
+  * Condition source codes are typically ICD-9-CM, Read or ICD-10 diagnosis codes from medical claims or discharge status/visit diagnosis codes from EHRs.
+  * The Condition Status reflects when the condition was diagnosed, implying a different depth of diagnostic work-up:
+    * Admitting diagnosis: use concept_id 4203942
+    * Preliminary diagnosis: use concept_id 4033240
+    * Final diagnosis: use concept_id 4230359 – should also be used for ‘Discharge diagnosis’