Linkr
Home Resources Tools Documentation Blog Demo
FR
  • What is Linkr?
  • Deployment modes
  • Quickstart
  • Local install
  • Your first project
  • Workspace, project, plugin WIP
  • The data pipeline WIP
  • Versioning and collaboration WIP
  • Schemas WIP
  • Databases WIP
  • Data quality WIP
  • ETL pipelines WIP
  • Introduction
  • Mapping projects
  • Overview
  • Target Concepts
  • Mapping Editor
  • Suggestions
  • Evaluation
  • Export
  • Data catalog WIP
  • Cohorts WIP
  • Patient-level data WIP
  • Datasets WIP
  • Script collections WIP
  • IDE WIP
  • Dashboards WIP
  • Reports WIP
  • Wiki WIP
  • Versioning WIP
  • Production install WIP
  • Authentication and permissions WIP
  • Configuration WIP
  • Backup and restore WIP
  • Build a plugin WIP
  • Release notes WIP
  • Glossary WIP
Documentation Concept mapping Evaluation

Evaluation

Review, validation, comments and multi-reviewer voting on created mappings.

Summary

The Evaluation tab is the review dashboard: every created mapping is listed, with its status, its comments, and tools to validate, flag or reject as a team.

Client Available in client-only mode — runs entirely in the browser, no backend. Backend Backend (FastAPI) under development.

The table

linkr-v2-b1800b.frama.io
Source vocabulary
Source concept name
Equivalence
Target vocabulary
Target concept name
Domain
Concept class
Standard
Mapped by
✓
⚑
✗
Evaluation
ICCATA_systolique_invasiveExactSNOMEDInvasive systolic arterial pressureMeasurementObservable EntitySJohn Doe———
ICCAFC_bpmExactLOINCHeart rateMeasurementClinical ObservationSJane Smith1——
MIMIC-IVcreatinine_serumExactLOINCCreatinine [Mass/volume] in Serum or PlasmaMeasurementLab TestSClaude Opus 4.72——
MIMIC-IVfr_respExactLOINCRespiratory rateMeasurementClinical ObservationSMarie Dupont11—
MIMIC-IVpoids_kgExactLOINCBody weightMeasurementClinical ObservationSJane Smith3——
ICCADT2_sans_compliNarrowSNOMEDType 2 diabetes mellitus without complicationConditionDisorderSClaude Opus 4.7——1
REAIMCExactLOINCBody mass index (BMI) [Ratio]MeasurementClinical ObservationSPaul Bernard———
The mappings table: one row per source concept → target mapping, with its SKOS equivalence and vote counters.

Each row represents a source concept → target mapping. The columns describe the source concept (vocabulary, name, code), the chosen SKOS equivalence, the target concept (vocabulary, name, domain, class, Standard badge), who proposed the mapping, and three vote counters (approved, flagged, rejected) before the Evaluation column which gathers the actions.

The Evaluation column

On the right-hand side of each row, an Evaluation column groups six buttons side by side. Their availability depends on context: you cannot vote on a mapping you created yourself.

Features

The six buttons of the Evaluation column, in the order they appear in the table.

From left to right:

  • View detail — opens the full mapping detail sheet (see below).
  • Comments — opens the comment thread attached to the mapping (see below). A badge shows the total number of comments.
  • Reviews — lists every reviewer’s vote (approved, flagged, rejected) with date and optional comment. The button is outlined when you’ve already voted; a badge shows the total number of votes.
  • Approve — casts your “approved” vote on the mapping. The button turns solid green once your vote is recorded. Disabled on your own mappings.
  • Reject — casts your “rejected” vote (you consider the target wrong). The button turns solid red once your vote is recorded. Disabled on your own mappings.
  • Flag — casts your “to review” vote: you want to draw the team’s attention without deciding. The button turns solid orange once your vote is recorded. Useful for borderline cases that need discussion before a verdict.

Clicking an action updates the mapping immediately. In edit mode (top Edit button), checkboxes appear and let you delete the selected mappings.

Mapping detail sheet

linkr-v2-b1800b.frama.io
TA_systolique_invasive→Invasive systolic arterial pressure
ExactApproved· John Doe· 2026-05-14 14:32
1 / 7

Source concept

Source vocabularyICCA
Source concept nameTA_systolique_invasive
Source concept codeM0118
Patients1,842
Records24,380

Statistics

Min60
P25108
Median122
P75138
Max220

Boxplot (mmHg)

Target concept

Target vocabularySNOMED
Target concept ID4353843
Target concept nameInvasive systolic arterial pressure
Target concept code251071003
DomainMeasurement
Concept classObservable Entity
StandardS

Mapping metadata

EquivalenceExact
StatusApproved
Match score—
Mapped byJohn Doe
Created2026-05-14 14:32
Last edited2026-05-14 14:32

Reviews (1)

Jane SmithApproved

2026-05-14 15:08

The detail sheet takes over the main pane. The body splits into two columns: source concept on the left (label, code, patients, records, statistics), target concept and mapping metadata on the right (equivalence, status, method, dates, recorded reviews).

The Statistics block under the source concept is rendered from the source concept’s metadata when present. The full rendering (extended stats table, boxplot, histogram, distributions, properties) is described in Concept metadata.

Comment thread

linkr-v2-b1800b.frama.io

Comments

TA_systolique_invasive → Invasive systolic arterial pressure

Jane Smith
2026-05-15 09:42

Why not LOINC 8480-6 instead of SNOMED? More lab-side standardisation.

John Doe
2026-05-16 14:47

SNOMED 251071003 specifies "invasive", which LOINC 8480-6 doesn't. More specific source → broadMatch on the LOINC side.

Add a comment

The Comments panel opens on the right. List of existing comments (date and author in the header, body below) with edit / delete icons on your own comments. At the bottom, an 'Add a comment' block with a free-form textarea.

Reviews

linkr-v2-b1800b.frama.io

Reviews

TA_systolique_invasive → Invasive systolic arterial pressure

Jane SmithApproved

2026-05-14 15:08

My review (John Doe)

The Reviews panel opens on the right. List of reviews posted by other reviewers (author, date, verdict as a coloured badge). Below, a 'My review' block with an optional textarea and three buttons to Approve, Reject or Flag.

Multi-reviewer voting

Linkr is built for team work. Each reviewer records their own vote (approved, flagged, rejected) on a given mapping. All votes are kept in the mapping’s history.

The effective status shown in the table and used for exports is computed by majority:

  • More votes for approved than rejected → effective approved.
  • Tie or majority rejected → effective rejected.
  • Ambiguous case → priority approved > rejected > flagged.

You can't review your own mapping

If you created the mapping, Linkr blocks you from voting. A simple safeguard against self-validated mappings.

Mappings import / export

Above the table, two buttons let you export and re-import mappings in the Linkr internal format (mappings.json). For exports to other formats (SSSOM, OMOP STCM, Usagi), use the Export tab.

Export

The Export button downloads a mappings.json file containing every mapping in the current project, in the format described below.

Import

linkr-v2-b1800b.frama.io

Import mappings

Choose the source of the mappings to import.

The Import mappings dialog offers two sources: a previously exported mappings.json file, or an import from other projects in the workspace.

The Import button opens a dialog with two options:

  • From a file — loads a mappings.json exported previously. Linkr deduplicates automatically: a (source, target) mapping that already exists is not re-imported.
  • From other projects — picks mappings from other projects in the workspace. Useful for reusing work already done on a shared vocabulary.
linkr-v2-b1800b.frama.io

Import from other projects

Locally import every mapping flagged as "already mapped elsewhere" (blue dot) from the selected projects. Status, reviews and comments are preserved.

2,466 / 2,466 mapping(s) after filters (100 shown)
Source projectSource vocabularySource concept nameEquivalenceTarget vocabularyTarget concept nameStatus
Labo MIMIC-IVICCAcreatinine_serumExactLOINCCreatinine [Mass/volume] in Serum or PlasmaApproved
IMPACTICCAcreatinine_serumExactLOINCCreatinine [Mass/volume] in Serum or PlasmaApproved
PROSPERICCAcreatinine_serumExactLOINCCreatinine [Moles/volume] in Serum or PlasmaFlagged
OASISICCAFC_bpmExactLOINCHeart rateApproved
Labo MIMIC-IVICCAFC_bpmExactLOINCHeart rateApproved
PROSPERICCAfr_respExactLOINCRespiratory rateUnchecked
IMPACTICCAfr_respExactLOINCRespiratory rateRejected
OASISICCApoids_kgExactLOINCBody weightApproved
The Import from other projects dialog. Filterable table with one row per candidate mapping (source project, source/target vocabularies and names, equivalence, status), free-text search, column filters, multi-select with checkboxes, and Select all / Deselect all buttons. Status, reviews and comments from the originating project are preserved on import.

Structure of mappings.json

The exported file is a JSON array of objects, one per mapping. Here is a complete example:

[
  {
    "id": "map_3f2c9a",
    "projectId": "icca-rea-2026",
    "sourceVocabularyId": "ICCA",
    "sourceConceptCode": "M0118",
    "sourceConceptName": "TA_systolique_invasive",
    "sourceDomainId": "Measurement",
    "sourceFrequency": 24380,
    "sourceCategoryId": "Haemodynamics",
    "targetConceptId": 4353843,
    "targetConceptCode": "251071003",
    "targetConceptName": "Invasive systolic arterial pressure",
    "targetVocabularyId": "SNOMED",
    "targetDomainId": "Measurement",
    "targetConceptClassId": "Observable Entity",
    "equivalence": "exactMatch",
    "status": "approved",
    "matchScore": 0.97,
    "comment": "Invasive ICU measurement.",
    "mappedBy": "John Doe",
    "mappedOn": "2026-05-14T14:32:11Z",
    "reviewedBy": "Jane Smith",
    "reviewedOn": "2026-05-14T15:08:00Z",
    "createdAt": "2026-05-14T14:32:11Z",
    "updatedAt": "2026-05-14T15:08:00Z"
  }
]
KeyTypeRequiredDescription
idstringyesUnique mapping identifier (generated by Linkr at creation).
projectIdstringyesIdentifier of the mapping project the mapping belongs to.
sourceVocabularyIdstringyesSource concept vocabulary (e.g. ICCA, MIMIC-IV).
sourceConceptCodestringyesSource concept code in its origin vocabulary.
sourceConceptNamestringyesSource concept label.
sourceDomainIdstringyesExpected OMOP domain (Measurement, Condition, Drug, Observation…).
sourceFrequencynumbernoNumber of records observed for this concept in the source.
sourceCategoryIdstringnoClinical category of the source concept (from the dictionary).
sourceSubcategoryIdstringnoClinical subcategory.
sourceConceptClassIdstringnoSource concept class (if OMOP).
targetConceptIdnumberyesOMOP concept_id of the target concept.
targetConceptCodestringyesCode in the target vocabulary (e.g. LOINC 2160-0, SNOMED 251071003).
targetConceptNamestringyesTarget concept label.
targetVocabularyIdstringyesTarget vocabulary (LOINC, SNOMED, RxNorm…).
targetDomainIdstringyesTarget concept’s OMOP domain.
targetConceptClassIdstringnoTarget concept class (Lab Test, Observable Entity…).
equivalencestringyesSKOS equivalence: exactMatch, closeMatch, narrowMatch, broadMatch, relatedMatch.
statusstringyesReview status: unchecked, approved, flagged, rejected, invalid, ignored.
matchScorenumbernoCombined score (0–1) carried over from pre-ranking, if available.
commentstringnoMapping’s main comment.
commentsarraynoStructured comment thread (mapping and reviews).
conceptSetIdstringnoIdentifier of the concept set used to propose this mapping, if any.
mappedBystringnoName of the mapping author (or automatic method: Syntactic, BioLORD, Claude Sonnet…).
mappedOnstringnoISO 8601 timestamp of mapping creation.
assignedReviewerstringnoReviewer explicitly assigned to this mapping. Kept mostly for Usagi compatibility (column in OHDSI’s CSV export).
reviewedBystringnoLast reviewer who cast a vote.
reviewedOnstringnoDate of the last vote.
reviewCommentstringnoComment attached to the last vote.
createdAtstringyesISO 8601 creation timestamp (never modified).
updatedAtstringyesISO 8601 last-modified timestamp.
PreviousSuggestionsNextExport

Product

  • Home
  • Demo

Resources

  • Documentation
  • Resources
  • Tools
  • Blog

Community

  • Framagit source code
  • Github source code

About

  • InterHop.org
  • Contact

2021–2026 InterHop — CC BY-NC-SA 4.0 (site) · GPLv3 (software)