GA4GH Categorical Variation Representation Specification Logo
  • Introduction
    • Background and Problem Statement
    • Challenges to Unifying the Representation of Categorical Variants
    • Discussion
  • How Cat-VRS Works
    • Variant Matching and Knowledge Integration
    • Discussion
  • Quick Start
  • Getting Involved
  • Data Model
    • Categorical Variant
    • Constraint
    • Constraints
      • Adjacency Constraint
        • Definition and Information Model
        • Examples
        • Implementation Guidance
      • Copy Change Constraint
        • Definition and Information Model
        • Examples
        • Implementation Guidance
      • Copy Count Constraint
        • Definition and Information Model
        • Examples
        • Implementation Guidance
      • Defining Allele Constraint
        • Definition and Information Model
        • Examples
      • Defining Location Constraint
        • Definition and Information Model
        • Examples
        • Implementation Guidance
      • Feature Context Constraint
        • Definition and Information Model
        • Examples
        • Implementation Guidance
      • Function Constraint
        • Definition and Information Model
        • Examples
        • Implementation Guidance
    • Recipes
      • Canonical Allele
        • Definition and Information Model
        • Examples
        • Implementation Guidance
      • Categorical CNV
        • Definition and Information Model
        • Examples
        • Implementation Guidance
      • Function Variant
        • Definition and Information Model
        • Examples
        • Implementation Guidance
      • Gene Fusion
        • Definition and Information Model
        • Examples
        • Implementation Guidance
      • Protein Sequence Consequence
        • Definition and Information Model
        • Examples
        • Implementation Guidance
    • Imported Data Types & Classes
      • VRS
        • Adjacency
        • Allele
        • Copy Number Count
        • Copy Number Change
        • Expression
        • Locations and References
        • Range
        • Sequence Expression
        • Terminus
        • Variation
      • GKS Core
        • Coding
        • ConceptMapping
        • ConceptSet
        • Element
        • Entity
        • Extension
        • MappableConcept
        • code
        • iriReference
  • Implementation Guide
  • Examples
  • Releases
    • 1.0
      • 1.0.0
  • Appendices
    • GKS Maturity Model
      • Feature Maturity levels
        • Developing a Draft Product Feature
        • Advancing from Draft to Trial Use
        • Advancing from Trial Use to Normative
      • Product Versioning and Releases
        • Versioning examples
        • Releases
      • Decision-maker roles
        • Feature Developers
        • Product Implementers
        • Product Leads
        • Work Stream Leads
    • Design Decisions
      • Major Impact
        • Treatment of CatVars as ((Hyper)intensional) Set-Theoretic Objects
        • Adoption of a Constraint-Based Model Instead of a Fixed Top-Down Typology of Data Classes
      • Medium Impact
        • Constraints as an Array of implicitly ANDed elements
        • Including Recipes in the Cat-VRS Specification
        • Machine Readable Specifications
        • Separating CopyNumberConstraint into CopyCountConstraint and CopyChangeConstraint
        • Separating DefiningContextConstraint into DefiningAlelleConstraint and DefiningLocationConstraint
        • Utilization of semantic versioning and the GKS maturity model
        • Generalization of GeneContextConstriant into FeatureContextConstraint
      • Minor Impact
        • Distinction between Relations and Mappings
        • Inclusion of Members as non-exhaustive array of contextual variants
        • Name as a non-required field
        • Renaming “Profiles” to “Recipes” to represent standard categorical variants templates
        • Handling of Function Variants using Müller’s Morphs
        • Integration of Mappable Concepts for Variant Relations
        • Error handling is intentionally unspecified and delegated to implementation.
        • Text casing
    • Product Roadmap
      • Active
      • Planned
      • Complete
    • Treatment of CatVars as ((Hyper)intensional) Set-Theoretic Objects
      • Catvars as Sets
      • Catvars as Intensional Sets
      • Catvars as Hyperintensional Set Objects
GA4GH Categorical Variation Representation Specification
  • Examples
  • Edit on GitHub

Examples

Each example’s page details where the example was sourced from, how each property was populated, and includes both JSON and YAML versions of the example inline.

In addition, BRAF V600 (annotated) and TP53 Loss (annotated) have been written with inline comments in the YAML version of the example. They may be particularly helpful when initiating to this specification.

By Constraint

Constraint

Representative examples

Adjacency

?::ZNF384(ncbi:171017)
BCR(ncbi:613)::ABL1(ncbi:25)
FGFR2(hgnc:3689)::v
v::NTRK1(hgnc:8031)

Copy Change

GRCh38/hg38 7p22.1(chr7:5905831-6014161)x3
TP53 Loss

Copy Count

GRCh38 Xp22.31(chrX:6978350-7594949)x3
GRCh38/hg38 7p22.1(chr7:5905831-6014161)x3

Defining Allele

EGFR L858R
NC_000001.11:g.1699974C>G
NM_004958.4(MTOR):c.5992_5993del (p.Met1998fs)
NM_007294.4(BRCA1):c.5558dup (p.Tyr1853Ter)
PIK3CA p.R38H

Defining Location

BRAF V600
GRCh38 Xp22.31(chrX:6978350-7594949)x3
GRCh38/hg38 7p22.1(chr7:5905831-6014161)x3 (copy count)
GRCh38/hg38 7p22.1(chr7:5905831-6014161)x3 (copy change)
TP53 Loss

Feature Context

BRCA2 loss of function variants
NRAS functionally normal variants
PIK3CA p.R38H
TP53 Loss

Function

BRCA2 loss of function variants
NRAS functionally normal variants
PIK3CA p.R38H

None

t(2;15)(q23.1;q25.3)

Previous Next

© Copyright 2023-2026, GA4GH CatVRS Contributors..

Built with Sphinx using a theme provided by Read the Docs.