The hardware and bandwidth for this mirror is donated by dogado GmbH, the Webhosting and Full Service-Cloud Provider. Check out our Wordpress Tutorial.
If you wish to report a bug, or if you are interested in having us mirror your free-software or open-source project, please feel free to contact us at mirror[@]dogado.de.

Mappings Tab

Introduction

The Mappings tab is used to combine concepts and audit mapping decisions. Merge actions are available in patient mode.

The example below creates a small hierarchy-based mapping table from the bundled lc500 study. These are the kinds of candidate merges that can later be reviewed in the Mappings tab.

if (requireNamespace("nanoparquet", quietly = TRUE)) {
  studyDir <- system.file("example", "st", package = "CohortContrast")
  study <- CohortContrast::loadCohortContrastStudy("lc500", pathToResults = studyDir)

  maxMinDataFrame <- data.frame(
    descendant_concept_id = c(4008211, 4176729, 2107967, 2107968, 2108158, 32280, 32815),
    maximum_minimal_separation = c(0, 1, 0, 1, 1, 0, 1)
  )

  mappingTable <- CohortContrast::generateMappingTable(
    abstractionLevel = 0,
    data = study,
    maxMinDataFrame = maxMinDataFrame
  )
  utils::head(mappingTable, 4)
}
#> --------------------------------- 
#> Generating mapping table list ... 
#> --------------------------------- 
#> Timestamp:  2026-04-09 17:28:25 
#> 
#> ---------------------------------------------- 
#> Generating mapping for abstraction level 1 ... 
#> ---------------------------------------------- 
#> Timestamp:  2026-04-09 17:28:25
#>   CONCEPT_ID                                           CONCEPT_NAME
#> 1    4176729 Treatment planning for external beam radiation therapy
#> 2    2107968                                      Lobectomy of lung
#> 3    2108158                                  Partial pneumonectomy
#> 4      32815                                      Death Certificate
#>   NEW_CONCEPT_ID NEW_CONCEPT_NAME ABSTRACTION_LEVEL      TYPE
#> 1        4008211     Radiotherapy                 0 hierarchy
#> 2        2107967        Lobectomy                 0 hierarchy
#> 3        2107967        Lobectomy                 0 hierarchy
#> 4          32280            Death                 0 hierarchy

Each row links a more specific concept to a broader replacement concept, together with the mapping type and abstraction level used to generate the suggestion.

Manual Merge

Workflow:

  1. In Manual Merge, select concepts using the Map column (main concepts only).
  2. Click Merge Selected Concepts.
  3. Confirm New Concept ID, New Concept Name, and Heritage.
  4. Click Apply Merge.

Defaults in the merge form are prefilled from the most prevalent selected concept.

Manual merge workflow
Manual merge workflow

Hierarchy Suggestions

Use hierarchy-based candidate merges:

Hierarchy suggestions
Hierarchy suggestions

Correlation Suggestions

Use correlation-based candidate merges:

Correlation suggestions
Correlation suggestions

Mapping History

The history table records applied mappings, including source concept IDs/names, mapped concept IDs/names, mapping type, and heritage. Use it as an audit trail for post-processing decisions.

These binaries (installable software) and packages are in development.
They may not be fully stable and should be used with caution. We make no claims about them.
Health stats visible at Monitor.