User Tools

Site Tools


documentation:cdm:source_to_concept_map

This is an old revision of the document!


SOURCE_TO_CONCEPT_MAP table

The source to concept map table is a legacy data structure within the OMOP Common Data Model, recommended for use in ETL processes to maintain local source codes which are not available as Concepts in the Standardized Vocabularies, and to establish mappings for each source code into a Standard Concept as target_concept_ids that can be used to populate the Common Data Model tables. The SOURCE_TO_CONCEPT_MAP table is no longer populated with content within the Standardized Vocabularies published to the OMOP community.

FieldRequiredTypeDescription
source_codeYesvarchar(50)The source code being translated into a standard concept.
source_concept_idYesintegerA foreign key to the source concept to which the source code is being mapped.
source_vocabulary_idNovarchar(20)A foreign key to the vocabulary table defining the vocabulary of the source code that is being mapped to the Standardized Vocabularies.
source_code_descriptionNovarchar(255)An optional description for the source code. This is included as a convenience to compare the description of the source code to the name of the concept.
target_concept_idYesintegerA foreign key to the target concept to which the source code is being mapped.
target_vocabulary_idYesvarchar(20)A foreign key to the vocabulary table defining the vocabulary of the target concept.
valid_start_dateYesdateThe date when the mapping instance was first recorded.
valid_end_dateYesdateThe date when the mapping instance became invalid because it was deleted or superseded (updated) by a new relationship. Default value is 31-Dec-2099.
invalid_reasonNovarchar(1)Reason the mapping instance was invalidated. Possible values are D (deleted), U (replaced with an update) or NULL when valid_end_date has the default value.

Conventions

  • This table is no longer used to store mapping information between source codes and Standard Concepts. Instead, the CONCEPT_RELATIONSHIP table under is used for this purpose, using the relationship_id='Maps to';
  • The combination of the fields source_code and the source_vocabulary_id uniquely identifies the information in the source. It is the equivalent to the concept_id_1 field in the CONCEPT_RELATIONSHIP table.
  • The target_concept_id contains the Concept code is mapped to. It is equivalent to the concept_id_2 in the CONCEPT_RELATIONSHIP table
  • The source_code_description contains an optional description of the source code.
  • The target_vocabulary_id field contains the vocabulary_id of the target concept. It is a duplication of the same information in the CONCEPT record of the Target Concept.
  • The fields valid_start_date, valid_end_date and invalid_reason are used to define the life cycle of the mapping information. Invalid mapping records should not be used for mapping information.
documentation/cdm/source_to_concept_map.1416057072.txt.gz · Last modified: 2014/11/15 13:11 by cgreich