Class: Statement
An information entity expressing a declarative sentence that is either true or false.
URI: vacoreim:Statement
classDiagram
class Statement
InformationEntity <|-- Statement
Statement : conclusion
Statement --|> Coding : conclusion
Statement : confidenceDirection
Statement --|> Coding : confidenceDirection
Statement : confidenceLevel
Statement --|> Coding : confidenceLevel
Statement : confidenceScore
Statement --|> DataItem : confidenceScore
Statement : contributions
Statement --|> Contribution : contributions
Statement : dateAuthored
Statement : derivedFrom
Statement --|> InformationEntity : derivedFrom
Statement : description
Statement : evidenceDirection
Statement --|> Coding : evidenceDirection
Statement : evidenceLevel
Statement --|> Coding : evidenceLevel
Statement : evidenceScore
Statement --|> DataItem : evidenceScore
Statement : extensions
Statement --|> Extension : extensions
Statement : hasEvidence
Statement --|> InformationEntity : hasEvidence
Statement : hasEvidenceLines
Statement --|> EvidenceLine : hasEvidenceLines
Statement : hasEvidenceOfTypes
Statement --|> Coding : hasEvidenceOfTypes
Statement : id
Statement : identifiers
Statement : label
Statement : proposition
Statement --|> Proposition : proposition
Statement : recordMetadata
Statement --|> RecordMetadata : recordMetadata
Statement : reportedIn
Statement --|> Document : reportedIn
Statement : specifiedBy
Statement --|> Method : specifiedBy
Statement : statementText
Statement : subtype
Statement --|> Coding : subtype
Statement : type
Statement : urls
Statement : xrefs
Inheritance
- Element
- Entity
- InformationEntity
- Statement
- InformationEntity
- Entity
Slots
Name | Cardinality and Range | Description | Inheritance |
---|---|---|---|
subtype | 0..1 Coding |
A specific type of statement the Statement object represents (e.g. a 'Variant Pathogenicity Statement', or 'Therapeutic Response Evidence Level Statement') | direct |
statementText | 0..1 String |
A natural-language expression of what the Statement asserts to be true. | direct |
proposition | 0..1 Proposition |
A possible fact (Proposition) that the Statement is about. A Statement may say any or all of the following about its Proposition: (1) simply report its as being true; (2) describe the author's degree of confidence in the its truth; (3) report the author's assessment of the level and direction of evidence backing it. | direct |
confidenceDirection | 0..1 Coding |
A term indicating whether the confidenceLevel and/or confidenceScore values reflect confidence that the statement's proposition is true or false. | direct |
confidenceLevel | 0..1 Coding |
A term describing the asserting agent's level of confidence about the Statement's proposition (i.e. how confident they are that it is true or false). | direct |
confidenceScore | 0..1 DataItem |
A quantitative score the asserting agent's level of confidence about the Statement's proposition (i.e. how confident they are that it is true or false). | direct |
evidenceDirection | 0..1 Coding |
A term indicating the net direction of all evidence assessed against the Statement's proposition. | direct |
evidenceLevel | 0..1 Coding |
A term indicating the overall strength of support for or against the Statement's proposition, as provided by all evidence evaluated. | direct |
evidenceScore | 0..1 DataItem |
A quantitative score reflecting the overall strength of support for or against the Statement's proposition, as provided by all evidence evaluated. | direct |
conclusion | 0..1 Coding |
A term that describes a final conclusion about the subject of a Statement's proposition, based on what the proposition claims, and confidence and evidence level and direction assessments. | direct |
hasEvidence | 0..* InformationEntity |
A piece of information that represents or contributes to an argument for or against the validity of the Proposition put forth in a Statement. | direct |
hasEvidenceLines | 0..* EvidenceLine |
A discrete, independent argument relevant to the validity of the Proposition put forth in the Statement, which is based on the interpretation of one or more pieces of information as evidence. | direct |
hasEvidenceOfTypes | 0..* Coding |
A term describing a type of evidence used to assess the validity of Statement's proposition (e.g. 'sequence similarity evidence', 'in vitro assay evidence'). | direct |
contributions | 0..* Contribution |
A specific contribution made by some Agent to the creation, modification, or validation of the information represented in the Information Entity. | InformationEntity |
dateAuthored | 0..1 DateTime |
The date the information content expressed in this entity was generated. | InformationEntity |
specifiedBy | 0..* Method |
A particular plan specification that describes all or part of the process that led to creation of the reported information (e.g. a specific experimental protocol, analysis specification, cohort selection criteria, interpretation guideline, etc.). | InformationEntity |
derivedFrom | 0..* InformationEntity |
An information resource from which the Information Entity is derived, in whole or in part | InformationEntity |
reportedIn | 0..* Document |
A document in which the information content carried by the Information Entity is expressed | InformationEntity |
id | 1..1 Identifier |
The logical identifier of the entity in the system of record, e.g. a UUID. This 'id' is unique within a given system. The identified entity may have a different 'id' in a different system. | Entity |
identifiers | 0..* Identifier |
A business identifier or accession number for the entity, typically as provided by an external system or authority, that is globally unique and persists across implementing systems. | Entity |
label | 0..1 String |
A primary name for the Entity. | Entity |
urls | 0..* Url |
The URL/web address of a digital resource representing the entity, or providing information about it. | Entity |
xrefs | 0..* String |
Cross-references to database identifier(s) representing the same (or a closely related) entity or concept as the Entity. | Entity |
recordMetadata | 0..1 RecordMetadata |
A reusable structure that encapsulates provenance metadata about the present record/data object (as opposed to provenance information about the real world entity this record/data object represents). | Entity |
type | 1..1 Class |
The schema class that is instantiated by the data object. Must be the name of a class from the VA schema. | Element |
description | 0..1 String |
A free text description of the Element. | Element |
extensions | 0..* Extension |
A key-value data structure that allows definition of custom fields to capture information not directly supported by the VA specification. | Element |
Comments
- In the VA model, each assertion of knowledge about a variant is captured in a self-contained Statement object. Organization of variant knowledge into discrete Statement objects allows clear and precise tracking of the evidence and provenance that supports each.
The VA model allows Statemetns to simply put forth as true a specific proposition about the domain of discourse (e.g. that "BRCA2 c.8023A>G is pathogenic for Breast Cancer"), and/or describe the overall state of evidence and/or confidence surrounding a particular proposition (e.g. that "there is moderate evidence supporting the pathogenicity of BRCA2 c.8023A>G for Breast Cancer", or that "I have very high confidence in the truth of the proposition that BRCA2 c.8023A>G is pathogenic for Breast Cancer").
Aliases
- Assertion; Claim
Identifier and Mapping Information
Schema Source
- from schema: https://w3id.org/ga4gh-va-core-im
Mappings
Mapping Type | Mapped Value |
---|---|
self | vacoreim:Statement |
native | vacoreim:Statement |
LinkML Source
Direct
name: Statement
description: An information entity expressing a declarative sentence that is either
true or false.
title: Statement
comments:
- "In the VA model, each assertion of knowledge about a variant is captured in a self-contained\
\ Statement object. Organization of variant knowledge into discrete Statement objects\
\ allows clear and precise tracking of the evidence and provenance that supports\
\ each. \n\nThe VA model allows Statemetns to simply put forth as true a specific\
\ proposition about the domain of discourse (e.g. that \"BRCA2 c.8023A>G is pathogenic\
\ for Breast Cancer\"), and/or describe the overall state of evidence and/or confidence\
\ surrounding a particular proposition (e.g. that \"there is moderate evidence supporting\
\ the pathogenicity of BRCA2 c.8023A>G for Breast Cancer\", or that \"I have very\
\ high confidence in the truth of the proposition that BRCA2 c.8023A>G is pathogenic\
\ for Breast Cancer\")."
from_schema: https://w3id.org/ga4gh-va-core-im
aliases:
- Assertion; Claim
is_a: InformationEntity
slots:
- subtype
- statementText
- proposition
- confidenceDirection
- confidenceLevel
- confidenceScore
- evidenceDirection
- evidenceLevel
- evidenceScore
- conclusion
- hasEvidence
- hasEvidenceLines
- hasEvidenceOfTypes
slot_usage:
subtype:
name: subtype
description: A specific type of statement the Statement object represents (e.g.
a 'Variant Pathogenicity Statement', or 'Therapeutic Response Evidence Level
Statement')
multivalued: false
domain_of:
- DataItem
- DataSet
- Document
- Statement
- StudyResult
- EvidenceLine
- Method
- Activity
- Agent
- Proposition
range: Coding
required: false
statementText:
name: statementText
description: A natural-language expression of what the Statement asserts to be
true.
comments:
- This attribute captures what a Statement says as human readable free text. e.g.
that "BRCA2 c.8023A>G is pathogenic for Breast Cancer", or that "there is moderate
evidence supporting the pathogenicity of BRCA2 c.8023A>G for Breast Cancer".
This optional attribute can be used instead of, or as a complement to, more
structured representations of Statement semantics using the subject-predicate-object-qualifier
pattern.
multivalued: false
domain_of:
- Statement
range: string
required: false
proposition:
name: proposition
description: 'A possible fact (Proposition) that the Statement is about. A Statement
may say any or all of the following about its Proposition: (1) simply report
its as being true; (2) describe the author''s degree of confidence in the its
truth; (3) report the author''s assessment of the level and direction of evidence
backing it.'
comments:
- This attribute provides the option of encapsulating the structured semantics
of the possible fact asserted or evaluated by a Statement in a separate 'Proposition'
object.
multivalued: false
domain_of:
- Statement
range: Proposition
required: false
confidenceDirection:
name: confidenceDirection
description: A term indicating whether the confidenceLevel and/or confidenceScore
values reflect confidence that the statement's proposition is true or false.
comments:
- Statements can report the asserting agent's confidence level that the target
proposition is true, or false, using the confidenceDirection, confidenceLevel,
and confidenceScore attributes. e.g. if the propositionDirection is 'false'
and confidenceLevel is 'high', the agent has high confidence that the proposition
is false. (Recommended values = 'true', 'false', 'uncertain')
multivalued: false
domain_of:
- Statement
range: Coding
required: false
confidenceLevel:
name: confidenceLevel
description: A term describing the asserting agent's level of confidence about
the Statement's proposition (i.e. how confident they are that it is true or
false).
comments:
- A Statement's proposition may ultimately be assessed by the agent to be true,
false, or uncertain - as indicated by the confidenceDirection attribute. The
confidenceLevel indicate the agent's confidence in the direction indicated -
e.g. if the confidenceDirection is 'false' and confidenceLevel is 'high', the
agent is very confident that the proposition is false.
multivalued: false
domain_of:
- Statement
range: Coding
required: false
confidenceScore:
name: confidenceScore
description: A quantitative score the asserting agent's level of confidence about
the Statement's proposition (i.e. how confident they are that it is true or
false).
comments:
- A Statement's proposition may ultimately be assessed by the agent to be true,
false, or uncertain - as indicated by the confidenceDirection attribute. The
confidenceScore provides a quantitative indication of the agent's confidence
in the direction indicated - e.g. if the confidenceDirection is 'true' and confidenceScore
is 9.8 out of 10, the agent has high confidence that the proposition is true. A
numeric confidenceScore may be provided instead of, or in addition to, qualitative
confidenceLevel term - where it provides quantitative rigor to the assessment.
multivalued: false
domain_of:
- Statement
range: DataItem
required: false
evidenceDirection:
name: evidenceDirection
description: A term indicating the net direction of all evidence assessed against
the Statement's proposition.
comments:
- Statements can report that the evidence assessed generally supports its propostion
(if it favors its validity), disputes its proposition (if it argues against
its validity), or remains 'inconclusive' (if conficting or insufficient evidence
exists to assert one direction or the other). (Recommended values = 'supports',
'disputes', 'inconclusive'.)
multivalued: false
domain_of:
- Statement
range: Coding
required: false
evidenceLevel:
name: evidenceLevel
description: A term indicating the overall strength of support for or against
the Statement's proposition, as provided by all evidence evaluated.
comments:
- 'This attribute reports the asserting agent''s assessment of the overall strength
of all examined evidence for the Statement''s proposition, in the direction
reported by the evidenceDirection field. For example, {"level": "strong", "direction":
"supporting"} means that the collective evidnece ''strongly supports'' the Statement''s
Proposition, while {"level": "strong", "direction": "disputing"} means that
the collective evidence ''strongly disputes'' the Statement''s Proposition.
The overall strength of evidence supporting or disputing a proposition is the
predominant factor, but not the only factor, influencing the agent''s confidence
that the proposition is true or false.'
multivalued: false
domain_of:
- Statement
range: Coding
required: false
evidenceScore:
name: evidenceScore
description: A quantitative score reflecting the overall strength of support for
or against the Statement's proposition, as provided by all evidence evaluated.
comments:
- This attribute serves the same purpose as evidenceLevel, but allows for numeric
scores providing quantitative assessment of evidence strength. A numeric evidenceScore
may be provided instead of, or in addition to, qualitative evidenceLevel term
- where it provides quantitative rigor to the assessment.
multivalued: false
domain_of:
- Statement
range: DataItem
required: false
conclusion:
name: conclusion
description: A term that describes a final conclusion about the subject of a Statement's
proposition, based on what the proposition claims, and confidence and evidence
level and direction assessments.
comments:
- "This value typically represents a common term of art used in the domain of\
\ discourse - and can be provided to report of a statement's conclusion in user-friendly/familiar\
\ terms. \nFor example, in a Statement declaring there to be 'definitive' evidence\
\ 'supporting' the proposition that a variant causes a disease, the conclusion\
\ term might be 'pathogenic'. And for a Statement declaring there to be 'probable'\
\ evidence 'disputing' the proposition that a variant causes a disease, the\
\ conclusion term might be 'likely benign'."
multivalued: false
domain_of:
- Statement
range: Coding
required: false
hasEvidence:
name: hasEvidence
description: A piece of information that represents or contributes to an argument
for or against the validity of the Proposition put forth in a Statement.
comments:
- Evidence is any information that is interpreted in assessing the truth of the
proposition a Statement puts forth as true or false. A piece of information
only becomes evidence when it is interpreted in this way. Different types of
information entities can be used and cited as evidence, including direct observation
or measurement data, derived statistical calculations, data tables or figures
in a publication, conclusions/findings from a particular study, or prior assertions
of knowledge that themselves are based on their own set of evidence. This
is a shortcut relation that links a Statement directly to a piece of evidnece
supporting it, bypassing the EvidenceLine class - to be used data creators cannot
or do not wich to create an Evidence Line object.
multivalued: true
domain_of:
- Statement
range: InformationEntity
required: false
hasEvidenceLines:
name: hasEvidenceLines
description: A discrete, independent argument relevant to the validity of the
Proposition put forth in the Statement, which is based on the interpretation
of one or more pieces of information as evidence.
comments:
- Evidence Lines result from the interpretation of one or more pieces of information
to build an argument for or against a particular Proposition. These arguments
have direction (supporting / disputing) and strength (e.g. strong, moderate,
weak) relative to the Proposition they are evaluated against. For example, ExaC
allele counts and frequency calculations for the BRCA2 c.8023A>G variant in
different populations may be collectively assessed to provide an argument of
moderate strength in support of a Proposition that the variant is pathogenicity
for breast cancer.
multivalued: true
domain_of:
- Statement
range: EvidenceLine
required: false
hasEvidenceOfTypes:
name: hasEvidenceOfTypes
description: A term describing a type of evidence used to assess the validity
of Statement's proposition (e.g. 'sequence similarity evidence', 'in vitro assay
evidence').
comments:
- "This contrasts with separate attributes used to capture specific instances\
\ of evidence information, such as a particular data item, study result, or\
\ prior assertions, etc. \nThe VA-Spec recommends the use of terms from ontologies\
\ such as the Evidence and Conclusion Ontology (ECO) to describe specific types\
\ of evidence."
multivalued: true
domain_of:
- Statement
range: Coding
required: false
Induced
name: Statement
description: An information entity expressing a declarative sentence that is either
true or false.
title: Statement
comments:
- "In the VA model, each assertion of knowledge about a variant is captured in a self-contained\
\ Statement object. Organization of variant knowledge into discrete Statement objects\
\ allows clear and precise tracking of the evidence and provenance that supports\
\ each. \n\nThe VA model allows Statemetns to simply put forth as true a specific\
\ proposition about the domain of discourse (e.g. that \"BRCA2 c.8023A>G is pathogenic\
\ for Breast Cancer\"), and/or describe the overall state of evidence and/or confidence\
\ surrounding a particular proposition (e.g. that \"there is moderate evidence supporting\
\ the pathogenicity of BRCA2 c.8023A>G for Breast Cancer\", or that \"I have very\
\ high confidence in the truth of the proposition that BRCA2 c.8023A>G is pathogenic\
\ for Breast Cancer\")."
from_schema: https://w3id.org/ga4gh-va-core-im
aliases:
- Assertion; Claim
is_a: InformationEntity
slot_usage:
subtype:
name: subtype
description: A specific type of statement the Statement object represents (e.g.
a 'Variant Pathogenicity Statement', or 'Therapeutic Response Evidence Level
Statement')
multivalued: false
domain_of:
- DataItem
- DataSet
- Document
- Statement
- StudyResult
- EvidenceLine
- Method
- Activity
- Agent
- Proposition
range: Coding
required: false
statementText:
name: statementText
description: A natural-language expression of what the Statement asserts to be
true.
comments:
- This attribute captures what a Statement says as human readable free text. e.g.
that "BRCA2 c.8023A>G is pathogenic for Breast Cancer", or that "there is moderate
evidence supporting the pathogenicity of BRCA2 c.8023A>G for Breast Cancer".
This optional attribute can be used instead of, or as a complement to, more
structured representations of Statement semantics using the subject-predicate-object-qualifier
pattern.
multivalued: false
domain_of:
- Statement
range: string
required: false
proposition:
name: proposition
description: 'A possible fact (Proposition) that the Statement is about. A Statement
may say any or all of the following about its Proposition: (1) simply report
its as being true; (2) describe the author''s degree of confidence in the its
truth; (3) report the author''s assessment of the level and direction of evidence
backing it.'
comments:
- This attribute provides the option of encapsulating the structured semantics
of the possible fact asserted or evaluated by a Statement in a separate 'Proposition'
object.
multivalued: false
domain_of:
- Statement
range: Proposition
required: false
confidenceDirection:
name: confidenceDirection
description: A term indicating whether the confidenceLevel and/or confidenceScore
values reflect confidence that the statement's proposition is true or false.
comments:
- Statements can report the asserting agent's confidence level that the target
proposition is true, or false, using the confidenceDirection, confidenceLevel,
and confidenceScore attributes. e.g. if the propositionDirection is 'false'
and confidenceLevel is 'high', the agent has high confidence that the proposition
is false. (Recommended values = 'true', 'false', 'uncertain')
multivalued: false
domain_of:
- Statement
range: Coding
required: false
confidenceLevel:
name: confidenceLevel
description: A term describing the asserting agent's level of confidence about
the Statement's proposition (i.e. how confident they are that it is true or
false).
comments:
- A Statement's proposition may ultimately be assessed by the agent to be true,
false, or uncertain - as indicated by the confidenceDirection attribute. The
confidenceLevel indicate the agent's confidence in the direction indicated -
e.g. if the confidenceDirection is 'false' and confidenceLevel is 'high', the
agent is very confident that the proposition is false.
multivalued: false
domain_of:
- Statement
range: Coding
required: false
confidenceScore:
name: confidenceScore
description: A quantitative score the asserting agent's level of confidence about
the Statement's proposition (i.e. how confident they are that it is true or
false).
comments:
- A Statement's proposition may ultimately be assessed by the agent to be true,
false, or uncertain - as indicated by the confidenceDirection attribute. The
confidenceScore provides a quantitative indication of the agent's confidence
in the direction indicated - e.g. if the confidenceDirection is 'true' and confidenceScore
is 9.8 out of 10, the agent has high confidence that the proposition is true. A
numeric confidenceScore may be provided instead of, or in addition to, qualitative
confidenceLevel term - where it provides quantitative rigor to the assessment.
multivalued: false
domain_of:
- Statement
range: DataItem
required: false
evidenceDirection:
name: evidenceDirection
description: A term indicating the net direction of all evidence assessed against
the Statement's proposition.
comments:
- Statements can report that the evidence assessed generally supports its propostion
(if it favors its validity), disputes its proposition (if it argues against
its validity), or remains 'inconclusive' (if conficting or insufficient evidence
exists to assert one direction or the other). (Recommended values = 'supports',
'disputes', 'inconclusive'.)
multivalued: false
domain_of:
- Statement
range: Coding
required: false
evidenceLevel:
name: evidenceLevel
description: A term indicating the overall strength of support for or against
the Statement's proposition, as provided by all evidence evaluated.
comments:
- 'This attribute reports the asserting agent''s assessment of the overall strength
of all examined evidence for the Statement''s proposition, in the direction
reported by the evidenceDirection field. For example, {"level": "strong", "direction":
"supporting"} means that the collective evidnece ''strongly supports'' the Statement''s
Proposition, while {"level": "strong", "direction": "disputing"} means that
the collective evidence ''strongly disputes'' the Statement''s Proposition.
The overall strength of evidence supporting or disputing a proposition is the
predominant factor, but not the only factor, influencing the agent''s confidence
that the proposition is true or false.'
multivalued: false
domain_of:
- Statement
range: Coding
required: false
evidenceScore:
name: evidenceScore
description: A quantitative score reflecting the overall strength of support for
or against the Statement's proposition, as provided by all evidence evaluated.
comments:
- This attribute serves the same purpose as evidenceLevel, but allows for numeric
scores providing quantitative assessment of evidence strength. A numeric evidenceScore
may be provided instead of, or in addition to, qualitative evidenceLevel term
- where it provides quantitative rigor to the assessment.
multivalued: false
domain_of:
- Statement
range: DataItem
required: false
conclusion:
name: conclusion
description: A term that describes a final conclusion about the subject of a Statement's
proposition, based on what the proposition claims, and confidence and evidence
level and direction assessments.
comments:
- "This value typically represents a common term of art used in the domain of\
\ discourse - and can be provided to report of a statement's conclusion in user-friendly/familiar\
\ terms. \nFor example, in a Statement declaring there to be 'definitive' evidence\
\ 'supporting' the proposition that a variant causes a disease, the conclusion\
\ term might be 'pathogenic'. And for a Statement declaring there to be 'probable'\
\ evidence 'disputing' the proposition that a variant causes a disease, the\
\ conclusion term might be 'likely benign'."
multivalued: false
domain_of:
- Statement
range: Coding
required: false
hasEvidence:
name: hasEvidence
description: A piece of information that represents or contributes to an argument
for or against the validity of the Proposition put forth in a Statement.
comments:
- Evidence is any information that is interpreted in assessing the truth of the
proposition a Statement puts forth as true or false. A piece of information
only becomes evidence when it is interpreted in this way. Different types of
information entities can be used and cited as evidence, including direct observation
or measurement data, derived statistical calculations, data tables or figures
in a publication, conclusions/findings from a particular study, or prior assertions
of knowledge that themselves are based on their own set of evidence. This
is a shortcut relation that links a Statement directly to a piece of evidnece
supporting it, bypassing the EvidenceLine class - to be used data creators cannot
or do not wich to create an Evidence Line object.
multivalued: true
domain_of:
- Statement
range: InformationEntity
required: false
hasEvidenceLines:
name: hasEvidenceLines
description: A discrete, independent argument relevant to the validity of the
Proposition put forth in the Statement, which is based on the interpretation
of one or more pieces of information as evidence.
comments:
- Evidence Lines result from the interpretation of one or more pieces of information
to build an argument for or against a particular Proposition. These arguments
have direction (supporting / disputing) and strength (e.g. strong, moderate,
weak) relative to the Proposition they are evaluated against. For example, ExaC
allele counts and frequency calculations for the BRCA2 c.8023A>G variant in
different populations may be collectively assessed to provide an argument of
moderate strength in support of a Proposition that the variant is pathogenicity
for breast cancer.
multivalued: true
domain_of:
- Statement
range: EvidenceLine
required: false
hasEvidenceOfTypes:
name: hasEvidenceOfTypes
description: A term describing a type of evidence used to assess the validity
of Statement's proposition (e.g. 'sequence similarity evidence', 'in vitro assay
evidence').
comments:
- "This contrasts with separate attributes used to capture specific instances\
\ of evidence information, such as a particular data item, study result, or\
\ prior assertions, etc. \nThe VA-Spec recommends the use of terms from ontologies\
\ such as the Evidence and Conclusion Ontology (ECO) to describe specific types\
\ of evidence."
multivalued: true
domain_of:
- Statement
range: Coding
required: false
attributes:
subtype:
name: subtype
description: A specific type of statement the Statement object represents (e.g.
a 'Variant Pathogenicity Statement', or 'Therapeutic Response Evidence Level
Statement')
from_schema: https://w3id.org/ga4gh-va-core-im
rank: 1000
multivalued: false
alias: subtype
owner: Statement
domain_of:
- DataItem
- DataSet
- Document
- Statement
- StudyResult
- EvidenceLine
- Method
- Activity
- Agent
- Proposition
range: Coding
required: false
statementText:
name: statementText
description: A natural-language expression of what the Statement asserts to be
true.
comments:
- This attribute captures what a Statement says as human readable free text. e.g.
that "BRCA2 c.8023A>G is pathogenic for Breast Cancer", or that "there is moderate
evidence supporting the pathogenicity of BRCA2 c.8023A>G for Breast Cancer".
This optional attribute can be used instead of, or as a complement to, more
structured representations of Statement semantics using the subject-predicate-object-qualifier
pattern.
from_schema: https://w3id.org/ga4gh-va-core-im
rank: 1000
multivalued: false
alias: statementText
owner: Statement
domain_of:
- Statement
range: string
required: false
proposition:
name: proposition
description: 'A possible fact (Proposition) that the Statement is about. A Statement
may say any or all of the following about its Proposition: (1) simply report
its as being true; (2) describe the author''s degree of confidence in the its
truth; (3) report the author''s assessment of the level and direction of evidence
backing it.'
comments:
- This attribute provides the option of encapsulating the structured semantics
of the possible fact asserted or evaluated by a Statement in a separate 'Proposition'
object.
from_schema: https://w3id.org/ga4gh-va-core-im
rank: 1000
multivalued: false
alias: proposition
owner: Statement
domain_of:
- Statement
range: Proposition
required: false
confidenceDirection:
name: confidenceDirection
description: A term indicating whether the confidenceLevel and/or confidenceScore
values reflect confidence that the statement's proposition is true or false.
comments:
- Statements can report the asserting agent's confidence level that the target
proposition is true, or false, using the confidenceDirection, confidenceLevel,
and confidenceScore attributes. e.g. if the propositionDirection is 'false'
and confidenceLevel is 'high', the agent has high confidence that the proposition
is false. (Recommended values = 'true', 'false', 'uncertain')
from_schema: https://w3id.org/ga4gh-va-core-im
rank: 1000
multivalued: false
alias: confidenceDirection
owner: Statement
domain_of:
- Statement
range: Coding
required: false
confidenceLevel:
name: confidenceLevel
description: A term describing the asserting agent's level of confidence about
the Statement's proposition (i.e. how confident they are that it is true or
false).
comments:
- A Statement's proposition may ultimately be assessed by the agent to be true,
false, or uncertain - as indicated by the confidenceDirection attribute. The
confidenceLevel indicate the agent's confidence in the direction indicated -
e.g. if the confidenceDirection is 'false' and confidenceLevel is 'high', the
agent is very confident that the proposition is false.
from_schema: https://w3id.org/ga4gh-va-core-im
rank: 1000
multivalued: false
alias: confidenceLevel
owner: Statement
domain_of:
- Statement
range: Coding
required: false
confidenceScore:
name: confidenceScore
description: A quantitative score the asserting agent's level of confidence about
the Statement's proposition (i.e. how confident they are that it is true or
false).
comments:
- A Statement's proposition may ultimately be assessed by the agent to be true,
false, or uncertain - as indicated by the confidenceDirection attribute. The
confidenceScore provides a quantitative indication of the agent's confidence
in the direction indicated - e.g. if the confidenceDirection is 'true' and confidenceScore
is 9.8 out of 10, the agent has high confidence that the proposition is true. A
numeric confidenceScore may be provided instead of, or in addition to, qualitative
confidenceLevel term - where it provides quantitative rigor to the assessment.
from_schema: https://w3id.org/ga4gh-va-core-im
rank: 1000
multivalued: false
alias: confidenceScore
owner: Statement
domain_of:
- Statement
range: DataItem
required: false
evidenceDirection:
name: evidenceDirection
description: A term indicating the net direction of all evidence assessed against
the Statement's proposition.
comments:
- Statements can report that the evidence assessed generally supports its propostion
(if it favors its validity), disputes its proposition (if it argues against
its validity), or remains 'inconclusive' (if conficting or insufficient evidence
exists to assert one direction or the other). (Recommended values = 'supports',
'disputes', 'inconclusive'.)
from_schema: https://w3id.org/ga4gh-va-core-im
rank: 1000
multivalued: false
alias: evidenceDirection
owner: Statement
domain_of:
- Statement
range: Coding
required: false
evidenceLevel:
name: evidenceLevel
description: A term indicating the overall strength of support for or against
the Statement's proposition, as provided by all evidence evaluated.
comments:
- 'This attribute reports the asserting agent''s assessment of the overall strength
of all examined evidence for the Statement''s proposition, in the direction
reported by the evidenceDirection field. For example, {"level": "strong", "direction":
"supporting"} means that the collective evidnece ''strongly supports'' the Statement''s
Proposition, while {"level": "strong", "direction": "disputing"} means that
the collective evidence ''strongly disputes'' the Statement''s Proposition.
The overall strength of evidence supporting or disputing a proposition is the
predominant factor, but not the only factor, influencing the agent''s confidence
that the proposition is true or false.'
from_schema: https://w3id.org/ga4gh-va-core-im
rank: 1000
multivalued: false
alias: evidenceLevel
owner: Statement
domain_of:
- Statement
range: Coding
required: false
evidenceScore:
name: evidenceScore
description: A quantitative score reflecting the overall strength of support for
or against the Statement's proposition, as provided by all evidence evaluated.
comments:
- This attribute serves the same purpose as evidenceLevel, but allows for numeric
scores providing quantitative assessment of evidence strength. A numeric evidenceScore
may be provided instead of, or in addition to, qualitative evidenceLevel term
- where it provides quantitative rigor to the assessment.
from_schema: https://w3id.org/ga4gh-va-core-im
rank: 1000
multivalued: false
alias: evidenceScore
owner: Statement
domain_of:
- Statement
range: DataItem
required: false
conclusion:
name: conclusion
description: A term that describes a final conclusion about the subject of a Statement's
proposition, based on what the proposition claims, and confidence and evidence
level and direction assessments.
comments:
- "This value typically represents a common term of art used in the domain of\
\ discourse - and can be provided to report of a statement's conclusion in user-friendly/familiar\
\ terms. \nFor example, in a Statement declaring there to be 'definitive' evidence\
\ 'supporting' the proposition that a variant causes a disease, the conclusion\
\ term might be 'pathogenic'. And for a Statement declaring there to be 'probable'\
\ evidence 'disputing' the proposition that a variant causes a disease, the\
\ conclusion term might be 'likely benign'."
from_schema: https://w3id.org/ga4gh-va-core-im
rank: 1000
multivalued: false
alias: conclusion
owner: Statement
domain_of:
- Statement
range: Coding
required: false
hasEvidence:
name: hasEvidence
description: A piece of information that represents or contributes to an argument
for or against the validity of the Proposition put forth in a Statement.
comments:
- Evidence is any information that is interpreted in assessing the truth of the
proposition a Statement puts forth as true or false. A piece of information
only becomes evidence when it is interpreted in this way. Different types of
information entities can be used and cited as evidence, including direct observation
or measurement data, derived statistical calculations, data tables or figures
in a publication, conclusions/findings from a particular study, or prior assertions
of knowledge that themselves are based on their own set of evidence. This
is a shortcut relation that links a Statement directly to a piece of evidnece
supporting it, bypassing the EvidenceLine class - to be used data creators cannot
or do not wich to create an Evidence Line object.
from_schema: https://w3id.org/ga4gh-va-core-im
rank: 1000
multivalued: true
alias: hasEvidence
owner: Statement
domain_of:
- Statement
range: InformationEntity
required: false
hasEvidenceLines:
name: hasEvidenceLines
description: A discrete, independent argument relevant to the validity of the
Proposition put forth in the Statement, which is based on the interpretation
of one or more pieces of information as evidence.
comments:
- Evidence Lines result from the interpretation of one or more pieces of information
to build an argument for or against a particular Proposition. These arguments
have direction (supporting / disputing) and strength (e.g. strong, moderate,
weak) relative to the Proposition they are evaluated against. For example, ExaC
allele counts and frequency calculations for the BRCA2 c.8023A>G variant in
different populations may be collectively assessed to provide an argument of
moderate strength in support of a Proposition that the variant is pathogenicity
for breast cancer.
from_schema: https://w3id.org/ga4gh-va-core-im
rank: 1000
multivalued: true
alias: hasEvidenceLines
owner: Statement
domain_of:
- Statement
range: EvidenceLine
required: false
hasEvidenceOfTypes:
name: hasEvidenceOfTypes
description: A term describing a type of evidence used to assess the validity
of Statement's proposition (e.g. 'sequence similarity evidence', 'in vitro assay
evidence').
comments:
- "This contrasts with separate attributes used to capture specific instances\
\ of evidence information, such as a particular data item, study result, or\
\ prior assertions, etc. \nThe VA-Spec recommends the use of terms from ontologies\
\ such as the Evidence and Conclusion Ontology (ECO) to describe specific types\
\ of evidence."
from_schema: https://w3id.org/ga4gh-va-core-im
rank: 1000
multivalued: true
alias: hasEvidenceOfTypes
owner: Statement
domain_of:
- Statement
range: Coding
required: false
contributions:
name: contributions
description: A specific contribution made by some Agent to the creation, modification,
or validation of the information represented in the Information Entity.
comments:
- This attribute points to a Contribution object, which holds a structured description
of the actions taken by a particular agent in contributing to an Information
Entity.
from_schema: https://w3id.org/ga4gh-va-core-im
rank: 1000
multivalued: true
alias: contributions
owner: Statement
domain_of:
- InformationEntity
- RecordMetadata
range: Contribution
required: false
dateAuthored:
name: dateAuthored
description: The date the information content expressed in this entity was generated.
comments:
- We use the term 'authored' to refer to the generation of information in the
abstract - i.e. the information content expressed in a Statement, not a concrete
encoding of it in a specific language or format. The 'dateAuthored' attribute
captures when this abstract information content was first created. Information
about when a particular concrete encoding of this information was created (e.g.
as a VA-based json object) would live in a RecordMetadata object attached to
the Information Entity).
from_schema: https://w3id.org/ga4gh-va-core-im
rank: 1000
multivalued: false
alias: dateAuthored
owner: Statement
domain_of:
- InformationEntity
range: DateTime
required: false
specifiedBy:
name: specifiedBy
description: A particular plan specification that describes all or part of the
process that led to creation of the reported information (e.g. a specific experimental
protocol, analysis specification, cohort selection criteria, interpretation
guideline, etc.).
comments:
- 'This field captures specific instances of specifications / methods (vs the
''methodTypes'' attribute which captures types of methods applied).
In various domains and communities, such specifications may be called ''protocols'',
''guidelines'', ''methods'', ''rule sets'', etc.'
from_schema: https://w3id.org/ga4gh-va-core-im
rank: 1000
multivalued: true
alias: specifiedBy
owner: Statement
domain_of:
- InformationEntity
- Activity
range: Method
required: false
derivedFrom:
name: derivedFrom
description: An information resource from which the Information Entity is derived,
in whole or in part
from_schema: https://w3id.org/ga4gh-va-core-im
rank: 1000
multivalued: true
alias: derivedFrom
owner: Statement
domain_of:
- InformationEntity
- StudyResult
- RecordMetadata
range: InformationEntity
required: false
reportedIn:
name: reportedIn
description: A document in which the information content carried by the Information
Entity is expressed
comments:
- "This attribute is used specifically to reference documents/publications where\
\ the Information Entity is expressed or reported. For a Statement, this might\
\ be a publication where the authors express the statement in text. For a Data\
\ Item, this might be a publication with a table or figure that reports the\
\ value of the data. \nNote that the VA-Spec provide separate attributes for\
\ describing different types of 'references' from an Information Entity to a\
\ Document (e.g. hasEvidenceFromSource is used by a Statement to reference a\
\ Document that provided evidence for the knowldege the Statement expresses."
from_schema: https://w3id.org/ga4gh-va-core-im
rank: 1000
multivalued: true
alias: reportedIn
owner: Statement
domain_of:
- InformationEntity
range: Document
required: false
id:
name: id
description: The logical identifier of the entity in the system of record, e.g.
a UUID. This 'id' is unique within a given system. The identified entity may
have a different 'id' in a different system.
comments:
- FHIR naming conventions are followed here, where an 'id' field holds logical
identifiers which are unique only within a given system, and an 'identifier'
field holds business identifiers, which are globally unique and used to connect
entities and share content across systems.
from_schema: https://w3id.org/ga4gh-va-core-im
rank: 1000
multivalued: false
alias: id
owner: Statement
domain_of:
- Entity
range: Identifier
required: true
identifiers:
name: identifiers
description: A business identifier or accession number for the entity, typically
as provided by an external system or authority, that is globally unique and
persists across implementing systems.
comments:
- FHIR naming conventions are followed here, where an 'id' field holds logical
identifiers which are unique only within a given system, and an 'identifier'
field holds business identifiers, which are globally unique and used to connect
entities and share content across systems.
from_schema: https://w3id.org/ga4gh-va-core-im
rank: 1000
multivalued: true
alias: identifiers
owner: Statement
domain_of:
- Entity
range: Identifier
required: false
label:
name: label
description: A primary name for the Entity.
from_schema: https://w3id.org/ga4gh-va-core-im
rank: 1000
multivalued: false
alias: label
owner: Statement
domain_of:
- Entity
- Coding
range: string
required: false
urls:
name: urls
description: The URL/web address of a digital resource representing the entity,
or providing information about it.
comments:
- This attribute is meant to point directly to locations on the web where more
information about the Entity can be found.
from_schema: https://w3id.org/ga4gh-va-core-im
rank: 1000
multivalued: true
alias: urls
owner: Statement
domain_of:
- Entity
range: Url
required: false
xrefs:
name: xrefs
description: Cross-references to database identifier(s) representing the same
(or a closely related) entity or concept as the Entity.
comments:
- Preferred values for this field are CURIEs or URLs for database records - so
the system that provisioned the identifier is clear.
from_schema: https://w3id.org/ga4gh-va-core-im
rank: 1000
multivalued: true
alias: xrefs
owner: Statement
domain_of:
- Entity
range: string
required: false
recordMetadata:
name: recordMetadata
description: A reusable structure that encapsulates provenance metadata about
the present record/data object (as opposed to provenance information about
the real world entity this record/data object represents).
comments:
- Record-level metadata applies to a specific concrete encoding/serialization
of information (e.g as a record in a specific knowlegebase, or an online digital
resource). A RecordMetadata object can capture when, how, and by whom a specific
record was generated or modified; what upstream resources it was derived/retrieved
from; and record-level administrative information such as versioning and system
/ lifecycle status.
from_schema: https://w3id.org/ga4gh-va-core-im
rank: 1000
multivalued: false
alias: recordMetadata
owner: Statement
domain_of:
- Entity
range: RecordMetadata
required: false
type:
name: type
description: The schema class that is instantiated by the data object. Must be
the name of a class from the VA schema.
from_schema: https://w3id.org/ga4gh-va-core-im
rank: 1000
multivalued: false
alias: type
owner: Statement
domain_of:
- Element
range: Class
required: true
description:
name: description
description: A free text description of the Element.
from_schema: https://w3id.org/ga4gh-va-core-im
rank: 1000
multivalued: false
alias: description
owner: Statement
domain_of:
- Element
- Extension
range: string
required: false
extensions:
name: extensions
description: A key-value data structure that allows definition of custom fields
to capture information not directly supported by the VA specification.
comments:
- The VA-Spec provides implementers the ability to extend any model elements
with new attributes using this flexible Extension element.
from_schema: https://w3id.org/ga4gh-va-core-im
rank: 1000
multivalued: true
alias: extensions
owner: Statement
domain_of:
- Element
range: Extension
required: false