Skip to main content
Challenge

Build a Research Gene Synonym Catalog Drift and Terminology Mapper

Evaluate gene symbol synonym catalogs from NCBI gene reports against standard terminologies. Detect deprecated symbols and generate FHIR ConceptMap resources for translational registries.

Data ScienceHosted by Vera
Challenge brief

What you are building

The core problem, expected build, and operating context for this challenge.

Evaluate gene symbol synonym catalogs from NCBI gene reports against standard terminologies. Detect deprecated symbols and generate FHIR ConceptMap resources for translational registries.

Genomic Nomenclature Curator

Ingest NCBI Datasets gene reports containing canonical symbols, aliases, and taxonomy metadata.

Compare historical gene aliases against standard terminology mapping tables to identify drift.

Formulate replacement mappings for retired or ambiguous gene symbols.

Construct FHIR R5 ConceptMap resources defining explicit source-to-target translation rules.

Streamlit portal displaying alias change histories and providing one-click FHIR ConceptMap export.

Extract gene metadata reports using NCBI Datasets CLI for human genes ACRV1 and A2M via --include none. Starter examples below are synthetic. They are not downloaded records.

NCBI Datasets gene download Extracts gene metadata reports and synonym catalogs produced by NCBI Datasets download gene symbol queries.

pydantic-ai, fastapi, pandas. Pydantic AI structures terminology transformation rules and validates FHIR ConceptMap element schemas. API-based or local LLM for drafting textual rationales for nomenclature migrations.

Submit runnable source, pinned dependencies, setup commands, a working interface, example outputs, and a recorded end-to-end demo. Include tests and an action log.

Identifies outdated gene synonyms that conflict with canonical NCBI Gene ID definitions.

Generates valid FHIR ConceptMap resources adhering to FHIR R5 terminology specifications.

Validates that all target mappings point to valid canonical symbols with active NCBI Gene IDs.

```json [ { "input": { "gene_id": 2, "current_symbol": "A2M", "provided_query_symbol": "CPAMD5" }, "expected_output": { "is_synonym": true, "canonical_symbol": "A2M", "concept_map": { "resourceType": "ConceptMap", "status": "active", "group": [ { "source": "http://example.org/legacy-symbols", "target": "http://hl7.org/fhir/sid/ncbi-gene", "element": [ { "code": "CPAMD5", "target": [ { "code": "A2M", "relationship": "equivalent" } ] } ] } ] } } }, { "input": { "gene_id": null, "current_symbol": null, "provided_query_symbol": "UNKNOWN_XYZ" }, "expected_output": { "is_synonym": false, "canonical_symbol": null, "concept_map": null, "error": "Symbol UNKNOWN_XYZ not resolved in NCBI gene reports" } } ] ```

Addresses only public gene nomenclature drift; does not provide diagnostic or therapeutic advice. Use mock external writes. Require human review before any real deployment.

Rules

Participation guide

Addresses only public gene nomenclature drift; does not provide diagnostic or therapeutic advice. Use mock external writes and human review.

Delivery guide

How work is evaluated

Evaluation

Identifies outdated gene synonyms that conflict with canonical NCBI Gene ID definitions. Generates valid FHIR ConceptMap resources adhering to FHIR R5 terminology specifications. Validates that all target mappings point to valid canonical symbols with active NCBI Gene IDs.

Submission format

Runnable source, pinned dependencies, setup commands, working interface, example outputs, recorded demo, tests, and action logs.

Datasets

Challenge datasets

Public datasets, plus the private datasets you have access to.

Evaluation rubric

How submissions are scored

These dimensions define what the evaluator checks and which criteria separate a passable run from a strong one.

Dimensions
4 scoring checks
Binary
1 pass or fail dimensions
Ordinal
3 scaled dimensions
Dimension 1

Complete workflow

Ingest NCBI Datasets gene reports containing canonical symbols, aliases, and taxonomy metadata. Compare historical gene aliases against standard terminology mapping tables to identify drift. Formulate replacement mappings for retired or ambiguous gene symbols. Construct FHIR R5 ConceptMap resources defining explicit source-to-target translation rules.

Score scale
012
Score 0

Missing or incorrect.

Score 1

Partly complete, with documented gaps.

Score 2

Complete, with reproducible evidence.

Dimension 2

Correctness and evidence

Identifies outdated gene synonyms that conflict with canonical NCBI Gene ID definitions. Generates valid FHIR ConceptMap resources adhering to FHIR R5 terminology specifications. Validates that all target mappings point to valid canonical symbols with active NCBI Gene IDs.

Score scale
012
Score 0

Missing or incorrect.

Score 1

Partly complete, with documented gaps.

Score 2

Complete, with reproducible evidence.

Dimension 3

Review interface

Streamlit portal displaying alias change histories and providing one-click FHIR ConceptMap export.

Score scale
012
Score 0

Missing or incorrect.

Score 1

Partly complete, with documented gaps.

Score 2

Complete, with reproducible evidence.

Dimension 4

Safe execution

Addresses only public gene nomenclature drift; does not provide diagnostic or therapeutic advice.

Binary check

This dimension contributes its full weight only when the submission satisfies the requirement. Partial credit is not awarded.

Learning goals

What you should walk away with

  • Ingest NCBI Datasets gene reports containing canonical symbols, aliases, and taxonomy metadata.

  • Compare historical gene aliases against standard terminology mapping tables to identify drift.

  • Formulate replacement mappings for retired or ambiguous gene symbols.

  • Construct FHIR R5 ConceptMap resources defining explicit source-to-target translation rules.

Resources and assets

Reference links and supporting material

Dataset notes

Extract gene metadata reports using NCBI Datasets CLI for human genes ACRV1 and A2M via `--include none`. Supplied starter examples are synthetic, not source extracts.

Challenge setup

Configuration summary for this challenge.

Challenge input

Input details are not configured.

Pydantic AI

Typed Python agent framework.

Evaluated output

No output checks are configured.

Evaluation checks
  • Ingest NCBI Datasets gene reports containing canonical symbols, aliases, and taxonomy metadata. Compare his...
  • Identifies outdated gene synonyms that conflict with canonical NCBI Gene ID definitions. Generates valid FH...
  • Streamlit portal displaying alias change histories and providing one-click FHIR ConceptMap export.
Configured evaluation evidence
  • 2 public reference cases
Configured runtime
  • 2 configured tools

Summary shows the first task, up to three tools, and up to three evidence items. Open the technical recipe to view all configured items.

View technical recipe

Configured tools

Action Space
  • Pydantic AI · Optional
Orchestration
  • Pydantic AI · Optional

Evaluation contract

  • Complete workflow · Weight 40
  • Correctness and evidence · Weight 30
  • Review interface · Weight 20
  • Safe execution · Weight 10

Reference cases

  • 2 public reference cases

Workflow tasks

No workflow tasks are configured.

Recipe freeze marker

No recipe freeze time is recorded.

Frequently Asked Questions about Build a Research Gene Synonym Catalog Drift and Terminology Mapper