Table name: STEM_TABLE

The STEM table is a staging area where source codes like ICD9 codes will first be mapped to concept_ids. The STEM table itself is an amalgamation of the OMOP event tables to facilitate record movement. This means that all fields present across the OMOP event tables are present in the STEM table. After a record is mapped and staged, the domain of the concept_id dictates which OMOP table (Condition_occurrence, Drug_exposure, Procedure_occurrence, Measurement, Observation, Device_exposure) the record will move to. Please see the STEM -> CDM mapping files for a description of which STEM fields move to which STEM tables.

Key conventions

  • VISIT_DETAIL must be built before STEM (refer to VISIT_DETAIL file)

  • Referential integrity is maintained with VISIT_DETAIL. For every record in STEM there should be 1 row record in VISIT_DETAIL (n:1 join).

  • For every record in VISIT_DETAIL there may be 0 to n rows in STEM.

Revenue Code Mappings

Records will be written from the INPATIENT_SERVICES table mapping the field REVCODE to STEM.CONCEPT_ID. Please see the table below for how this logic will be handled.

NOTE the revenue codes are mapped to concepts with the vocabulary_id “Revenue Code”. All these concepts have the domain of “Revenue Code” as well. Since there is no revenue table, all records coming from the REVCODE field should go to the OBSERVATION table.

Reading from INPATIENT_SERVICES

Destination Field Source field Logic Comment field  
DOMAIN_ID - - This should be the domain_id of the standard concept in the CONCEPT_ID field. If a code is mapped to CONCEPT_ID 0, put the domain_id as Observation  
PERSON_ID ENROLID - -  
VISIT_OCCURRENCE_ID VISIT_DETAIL
VISIT_OCCURRENCE_ID		 Refer to logic in building VISIT_OCCURRENCE table for linking with VISIT_OCCURRENCE_ID. -  
VISIT_DETAIL_ID VISIT_DETAIL
VISIT_DETAIL_ID		 Refer to logic in building VISIT_DETAIL table for linking with VISIT_DETAIL_ID. -  
PROVIDER_ID VISIT_DETAIL
PROVIDER_ID		 - -  
ID - System generated. -  
CONCEPT_ID PDX
DX1-5
PPROC
PROC1
REVCODE		 Use the Source-to-Standard Query.

If DXVER does not have a value, review to the “Key Conventions” under the “STEM Key Conventions and Lookup Files” page. If no map is made, assign CONCEPT_ID to 0 and set DOMAIN_ID as OBSERVATION.

[PDX, DX1-5]
If DXVER=9 use the filter:
WHERE SOURCE_VOCABULARY_ID IN (‘ICD9CM’)
AND TARGET_STANDARD_CONCEPT = 'S'
AND TARGET_INVALID_REASON IS NULL

If DXVER=0 use the filter:
WHERE SOURCE_VOCABULARY_ID IN (’ICD10CM’)
AND TARGET_STANDARD_CONCEPT = 'S'
AND TARGET_INVALID_REASON IS NULL

[PPROC, PROC1]
When PROCTYP <> 0:
WHERE SOURCE_VOCABULARY_ID IN ('ICD9Proc','HCPCS','CPT4',’ICD10PCS’)
AND TARGET_STANDARD_CONCEPT = 'S'
AND TARGET_INVALID_REASON IS NULL

[REVCODE]
WHERE SOURCE_VOCABULARY_ID IN ('Revenue Code’)
AND TARGET_STANDARD_CONCEPT = 'S'
AND TARGET_INVALID_REASON IS NULL		 The concepts in the Revenue Code vocabulary all have the domain “Revenue Code”. These should go to the OBSERVATION table.  
SOURCE_VALUE PDX
DX1-5
PPROC
PROC1
REVCODE		 - -  
SOURCE_CONCEPT_ID PDX
DX1-5
PPROC
PROC1
REVCODE		 Use the Source-to-Source Query.

If DXVER does not have a value, review to the “Key Conventions” under the “STEM Key Conventions and Lookup Files” page. If no map is made, assign to 0.

[PDX, DX1-5]
If DXVER=9 use the filter:
WHERE SOURCE_VOCABULARY_ID IN (‘ICD9CM’)
AND TARGET_VOCABULARY_ID IN (‘ICD9CM’)

If DXVER=0 use the filter:
WHERE SOURCE_VOCABULARY_ID IN (’ICD10CM’)
AND TARGET_VOCABULARY_ID IN (‘ICD10CM’)

[PPROC, PROC1]
When PROCTYP <> 0:
WHERE SOURCE_VOCABULARY_ID IN ('ICD9Proc','HCPCS','CPT4',’ICD10PCS’)
AND TARGET_VOCABULARY_ID IN ('ICD9Proc','HCPCS','CPT4',’ICD10PCS’)

[REVCODE]
When PROCTYP <> 0:
WHERE SOURCE_VOCABULARY_ID IN ('Revenue Code’)
AND TARGET_VOCABULARY_ID IN ('Revenue Code’)		 -  
TYPE_CONCEPT_ID - Set all to 32854 (Inpatient claim detail) -  
START_DATE VISIT_DETAIL
VISIT_DETAIL_START_DATE		 - -  
START_DATETIME - START_DATE + midnight -  
END_DATE - NULL -  
END_DATETIME - NULL -  
VERBATIM_END_DATE - NULL -  
DAYS_SUPPLY - NULL -  
DOSE_UNIT_SOURCE_VALUE - NULL -  
LOT_NUMBER - NULL -  
MODIFIER_CONCEPT_ID PROCMOD Use the Source-to-Standard Query.

WHERE SOURCE_CONCEPT_CLASS_ID IN ('CPT4 Modifier')
AND TARGET_CONCEPT_CLASS_ID IN ('CPT4 Modifier')		 If PROCMOD is blank then leave this field blank as well  
MODIFIER_SOURCE_VALUE PROCMOD - -  
OPERATOR_CONCEPT_ID - 0 -  
QUANTITY QTY NULL -  
RANGE_HIGH - NULL -  
RANGE_LOW - NULL -  
REFILLS - NULL -  
ROUTE_CONCEPT_ID - 0 -  
ROUTE_SOURCE_VALUE - NULL -  
SIG - NULL “Sig” is short for the Latin, signetur, or “let it be labeled.”  
STOP_REASON - NULL -  
UNIQUE_DEVICE_ID - NULL -  
UNIT_CONCEPT_ID - 0 -  
UNIT_SOURCE_VALUE - NULL -  
VALUE_AS_CONCEPT_ID PDX
DX1-5
PPROC
PROC1		 TARGET_VALUE_AS_CONCEPT_ID from the Source_to_Standard Query (resulting from ‘Maps to value’ relationsip);
See SOURCE_CONCEPT_ID field logic of how to define SOURCE_CONCEPT_ID being mapped		 -  
VALUE_AS_NUMBER - NULL -  
VALUE_AS_STRING - NULL -  
VALUE_SOURCE_VALUE - NULL -  
ANATOMIC_SITE_CONCEPT_ID - 0 -  
DISEASE_STATUS_CONCEPT_ID - 0 -  
SPECIMEN_SOURCE_ID - NULL -  
ANATOMIC_SITE_SOURCE_VALUE - NULL -  
DISEASE_STATUS_SOURCE_VALUE - NULL -  
CONDITION_STATUS_CONCEPT_ID PDX, DX1-DX9 If the record is generated based on PDX set to 32902 else if the record is based on DX1-DX9 set to 32908 - -
CONDITION_STATUS_SOURCE_VALUE Use the name of the DX field. For example, if the record is generated based on DX1 put ‘DX1’ here NULL -  
EVENT_ID - NULL -  
EVENT_FIELD_CONCEPT_ID - 0 -  
VALUE_AS_DATETIME - NULL -  
QUALIFIER_CONCEPT_ID - 0 -  
QUALIFIER_SOURCE_VALUE - NULL -  

Change Log

January 18, 2023

  • Updated revenue code logic

November 1, 2021

  • Update CONDITION_STATUS_CONCEPT_ID so that only primary diagnoses and not DX1 are set to 32902

June 11, 2021

  • Added QTY to the table

June 9, 2021

  • Update type concept

  • Added CONDITION_STATUS_CONCEPT_ID information

  • Added information on how to map revenue codes

### Aug-01-2023

  • Added ‘Maps to value’ logic

Please contact Clair Blacketer (https://github.com/clairblacketer) if you have any questions