CCV 2022 Aligned Profiles
The following profiles align with terminology and curation conventions from the ClinGen/CGC/VICC (CCV) 2022 Oncogenicity Interpretation Guidelines
These initial profiles were developed to support the following implementations and use cases:
Implementer |
Use Case |
|---|---|
VICC MetaKB |
Using VA-Spec models to structure oncogenicity classifications and evidence in its community-facing data exchange APIs. |
ClinVar Submission Utility |
Uses VA-Spec as input format for submission tools that send variant classifications and evidence from CIViC to the ClinVar database via its API. |
The number and coverage of these profiles will grow as these implementations expand their scope, and additional adopters bring new use cases to the spec.
Variant Oncogenicity Statement (CCV 2022)
Draft
May change significantly in future releases. See Maturity Model.
Computational Definition
A statement reporting a conclusion from a single study about whether a variant is associated with oncogenicity (positive or negative) - based on interpretation of the study’s results.
Information Model
Field |
Flags |
Type |
Limits |
Description |
|---|---|---|---|---|
id |
string |
0..1 |
The ‘logical’ identifier of the Entity in the system of record, e.g. a UUID. This ‘id’ is unique within a given system, but may or may not be globally unique outside the system. It is used within a system to reference an object from another. |
|
type |
string |
1..1 |
MUST be “Statement”. |
|
name |
string |
0..1 |
A primary name for the entity. |
|
description |
string |
0..1 |
A free-text description of the Entity. |
|
aliases |
⋮ | string |
0..m |
Alternative name(s) for the Entity. |
extensions |
⋮ | 0..m |
A list of extensions to the Entity, that allow for capture of information not directly supported by elements defined in the model. |
|
specifiedBy |
1..1 |
The method that specifies how the oncogenicity classification is ultimately assigned to the variant, based on assessment of evidence. |
||
contributions |
↓ | 0..m |
Specific actions taken by an Agent toward the creation, modification, validation, or deprecation of an Information Entity. |
|
reportedIn |
⋮ | 0..m |
A document in which the the Information Entity is reported. |
|
proposition |
1..1 |
A proposition about the oncogenicity of a variant, for which the study provides evidence. The validity of this proposition, and the level of confidence/evidence supporting it, may be assessed and reported by the Statement. |
||
direction |
string |
0..1 |
A term indicating whether the Statement supports, disputes, or remains neutral w.r.t. the validity of the Proposition it evaluates. |
|
strength |
0..1 |
The strength of support that an CCV 2022 Oncogenicity statement is determined to provide for or against the proposed oncogenicity of the assessed variant. Strength is evaluated relative to the direction indicated by the ‘direction’ attribute. The indicated enumeration constrains the nested MappableConcept.primaryCoding > Coding.code attribute when capturing evidence strength. Conditional requirement: if direction is either ‘supports’ or ‘disputes’, then this attribute is required. If it is ‘neutral’, then this attribute is not allowed. |
||
quality |
D | 0..1 |
A term used to report the quality of the assessment of a Proposition taking into consideration the reliability of the method, the contributor’s self-reporting of the rigor of the evaluation, and the overall robustness of the supporting or disputing evidence. This is useful when there is a consistent policy and authority that manages and a governing framework for evaluating the quality of evidence. Also known as trust rating, review status or ranking. |
|
score |
D | number |
0..1 |
A quantitative score that indicates the strength of a Proposition’s assessment in the direction indicated (i.e. how strongly supported or disputed the Proposition is believed to be). Depending on its implementation, a score may reflect how confident that agent is that the Proposition is true or false, or the strength of evidence they believe supports or disputes it. Instructions for how to interpret the meaning of a given score may be gleaned from the method or document referenced in ‘specifiedBy’ attribute. |
classification |
1..1 |
A single term or phrase summarizing the outcome of direction and strength assessments of a Statement’s Proposition, in terms of a classification of its subject. |
||
hasEvidence |
⋮ | 0..m |
An individual piece of information that was evaluated as evidence in assessing the validity of the Proposition put forth by the Statement. |
|
hasEvidenceLines |
⋮ | Variant Oncogenicity Evidence Line (CCV 2022) | iriReference |
0..m |
An evidence-based argument that supports or disputes the validity of the proposition that a Statement assesses or puts forth as true. The strength and direction of this argument (whether it supports or disputes the proposition, and how strongly) is based on an interpretation of one or more pieces of information as evidence (i.e. ‘Evidence Items). |
Composes: Statement
Artifacts
Variant Oncogenicity Evidence Line (CCV 2022)
Draft
May change significantly in future releases. See Maturity Model.
Computational Definition
An Evidence Line that describes how evidence for a variant was interpreted to determine if a specific CCV 2022 criterion code is met, and the strength that evidence this provides for or against the variant’s oncogenicity. An Evidence Line that describes how a specific type of information was interpreted as evidence for or against a variant’s oncogenicity. In the CCV Framework, evidence is assessed by determining if a specific criterion (e.g. ‘OM2’) with a default strength (e.g. ‘moderate’) is ‘met’ or ‘not met’, and in some cases adjusting the default strength based on the quality and abundance of evidence.
Information Model
Field |
Flags |
Type |
Limits |
Description |
|---|---|---|---|---|
id |
string |
0..1 |
The ‘logical’ identifier of the Entity in the system of record, e.g. a UUID. This ‘id’ is unique within a given system, but may or may not be globally unique outside the system. It is used within a system to reference an object from another. |
|
type |
string |
1..1 |
MUST be “EvidenceLine”. |
|
name |
string |
0..1 |
A primary name for the entity. |
|
description |
string |
0..1 |
A free-text description of the Entity. |
|
aliases |
⋮ | string |
0..m |
Alternative name(s) for the Entity. |
extensions |
⋮ | 0..m |
A list of extensions to the Entity, that allow for capture of information not directly supported by elements defined in the model. |
|
specifiedBy |
1..1 |
The guidelines or rubrics followed in interpreting evidence, to determine the strength and direction of support that it provides for or against a variant’s oncogenicity. While the CCV Criteria themselves provide minimal guidance, typically a more detailed, gene- or cancer- specific rubric is followed to determine if a given criterion was met, and how strongly. |
||
contributions |
↓ | 0..m |
Specific actions taken by an Agent toward the creation, modification, validation, or deprecation of an Information Entity. |
|
reportedIn |
⋮ | 0..m |
A document in which the the Information Entity is reported. |
|
targetProposition |
0..1 |
A Variant Oncogenicity Proposition against which a specific type of evidence was assessed, to determine the strength and direction of support this evidence provides for or against the proposition’s validity. |
||
hasEvidenceItems |
⋮ | 0..m |
An individual piece of information that was evaluated as evidence in building the argument represented by an Evidence Line. |
|
directionOfEvidenceProvided |
string |
1..1 |
The direction of support that the Evidence Line is determined to provide toward its target Proposition (supports, disputes, neutral) |
|
strengthOfEvidenceProvided |
0..1 |
The strength of support that an Evidence Line is determined to provide for or against the proposed oncogenicity of the assessed variant. Strength is evaluated relative to the direction indicated by the ‘direction’ attribute, and captured using a MappableConcept, whose nested ‘code’ field is bound to an enumerated set of values. Conditional requirement: if direction is either ‘supports’ or ‘disputes’, then this attribute is required. If it is ‘neutral’, then this attribute is not allowed. |
||
scoreOfEvidenceProvided |
number |
0..1 |
A quantitative score indicating the strength of support that an Evidence Line is determined to provide for or against its target Proposition, evaluated relative to the direction indicated by the directionOfEvidenceProvided value. |
|
evidenceOutcome |
0..1 |
The evidence outcome provides a single string that summarizes ‘direction’ and ‘strength’ assessments, along with the specific CCV criterion used in these assessments. Rules for constructing this string are as follows, and enforced by a regex constraint: (1) If a criterion is met and its default strength is not altered, the outcome is simply the criterion code (e.g. ‘OM2’ when the OM2 criteria is met with moderate strength); (2) If a criterion is met and its default strength is altered, the outcome is the criterion code plus the altered strength value (e.g. ‘OS2_moderate’ when OS2 is met with an adjusted moderate strength); (3) If a specific criterion was assessed but not met, the outcome is the criterion code plus ‘_not_met’ (e.g. ‘OS2_not_met’); (4) If the criteria associated with the ‘methodType’ were assessed, but none were met, the outcome is ‘no_criteria_met’. |
Additional Constraints
If property… |
has value… |
then property… |
must… |
|---|---|---|---|
directionOfEvidenceProvided |
one of: supports, disputes |
strengthOfEvidenceProvided |
be provided |
specifiedBy.methodType |
population_data_assessment |
evidenceOutcome.primaryCoding.code |
match the pattern ^(?:no_criteria_met|(SBVS1|SBS1|OP4)(_.+)?)$ |
specifiedBy.methodType |
functional_data_assessment |
evidenceOutcome.primaryCoding.code |
match the pattern ^(?:no_criteria_met|(OS2|SBS2)(_.+)?)$ |
specifiedBy.methodType |
primary_sequence_consequence_assessment |
evidenceOutcome.primaryCoding.code |
match the pattern ^(?:no_criteria_met|(OVS1|OM2|SBP2)(_.+)?)$ |
specifiedBy.methodType |
functional_domain_assessment |
evidenceOutcome.primaryCoding.code |
match the pattern ^(?:no_criteria_met|OM1(_.+)?)$ |
specifiedBy.methodType |
amino_acid_analogy_assessment |
evidenceOutcome.primaryCoding.code |
match the pattern ^(?:no_criteria_met|(OS1|OM4)(_.+)?)$ |
specifiedBy.methodType |
somatic_hotspot_assessment |
evidenceOutcome.primaryCoding.code |
match the pattern ^(?:no_criteria_met|(OS3|OM3|OP3)(_.+)?)$ |
specifiedBy.methodType |
in_silico_impact_assessment |
evidenceOutcome.primaryCoding.code |
match the pattern ^(?:no_criteria_met|(OP1|SBP1)(_.+)?)$ |
specifiedBy.methodType |
single_genetic_etiology_assessment |
evidenceOutcome.primaryCoding.code |
match the pattern ^(?:no_criteria_met|OP2(_.+)?)$ |
If evidenceOutcome.primaryCoding.code must match the pattern ^(?:no_criteria_met|(?:[A-Z]+[0-9]+)_not_met)$, then:
directionOfEvidenceProvided must be: neutral
Composes: Evidence Line
Used in: Variant Oncogenicity Statement (CCV 2022)
Artifacts