Patient Generated Health Data Implementation Guide
0.1.0 - ci-build

Patient Generated Health Data Implementation Guide - Local Development build (v0.1.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

Resource Profile: RiskAssessment_Patient

Official URL: https://pghd.na.icar.cnr.it/StructureDefinition/riskassessment-patient Version: 0.1.0
Active as of 2026-03-19 Computable Name: RiskAssessment_Patient

Representation of the risk assessment profile derived from medical history data and clinical predictive models based on artificial intelligence

Usages:

  • This Profile is not used by any profiles in this Implementation Guide

You can also check for usages in the FHIR IG Statistics

Formal Views of Profile Content

Description of Profiles, Differentials, Snapshots and how the different presentations work.

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. RiskAssessment 0..* RiskAssessment Potential outcomes for a subject with likelihood
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... status SΣ 1..1 code Risk assessment status (e.g., preliminary, final)
Binding: ObservationStatus (required): The status of the risk assessment; e.g. preliminary, final, amended, etc.
... code SΣ 1..1 CodeableConcept Type of risk assessed (e.g., cardiovascular, metabolic, cancer)
... subject SΣ 1..1 Reference(PGHD_Patient) Reference to the patient being assessed
... performer Σ 0..1 Reference(Practitioner | PractitionerRole | Device) Operator or system that generated the assessment
... basis S 0..* Reference(Observation | Condition | FamilyMemberHistory) Clinical sources on which the assessment is based (e.g., Observation, Condition, FamilyMemberHistory)
... prediction SC 1..* BackboneElement Predictive results derived from the risk assessment
Constraints: ras-2
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... outcome 0..1 CodeableConcept Expected event or potential condition (e.g., heart attack, neoplasm)
Binding Description: (example): The condition or other outcome; e.g. death, remission, amputation, infection, etc.
.... probability[x] C 0..1 Estimated probability of the predicted event
Constraints: ras-1
..... probabilityDecimal decimal
..... probabilityRange Range
.... when[x] 0..1 Time window in which the event is predicted to occur
..... whenPeriod Period
..... whenRange Range
... mitigation 0..1 string Suggested actions to reduce or prevent the predicted risk

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
RiskAssessment.status Base required ObservationStatus 📍4.0.1 FHIR Std.
RiskAssessment.method Base example Not State Unknown
RiskAssessment.prediction.​outcome Base example Not State Unknown

Constraints

Id Grade Path(s) Description Expression
dom-2 error RiskAssessment If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error RiskAssessment If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4 error RiskAssessment If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5 error RiskAssessment If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice RiskAssessment A resource should have narrative for robust management text.`div`.exists()
ele-1 error **ALL** elements All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **ALL** extensions Must have either extensions or value[x], not both extension.exists() != value.exists()
ras-1 error RiskAssessment.prediction.probability[x] low and high must be percentages, if present (low.empty() or ((low.code = '%') and (low.system = %ucum))) and (high.empty() or ((high.code = '%') and (high.system = %ucum)))
ras-2 error RiskAssessment.prediction Must be <= 100 probability is decimal implies (probability as decimal) <= 100

This structure is derived from RiskAssessment

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. RiskAssessment 0..* RiskAssessment Potential outcomes for a subject with likelihood
... status S 1..1 code Risk assessment status (e.g., preliminary, final)
... method S 0..1 CodeableConcept Method or algorithm used (guideline, AI model, score)
... code S 1..1 CodeableConcept Type of risk assessed (e.g., cardiovascular, metabolic, cancer)
... performer 0..1 Reference(Practitioner | PractitionerRole | Device) Operator or system that generated the assessment
... basis S 0..* Reference(Observation | Condition | FamilyMemberHistory) Clinical sources on which the assessment is based (e.g., Observation, Condition, FamilyMemberHistory)
... prediction S 1..* BackboneElement Predictive results derived from the risk assessment
.... outcome 0..1 CodeableConcept Expected event or potential condition (e.g., heart attack, neoplasm)
.... probability[x] 0..1 decimal, Range Estimated probability of the predicted event
.... when[x] 0..1 Period, Range Time window in which the event is predicted to occur
... mitigation 0..1 string Suggested actions to reduce or prevent the predicted risk

doco Documentation for this format
NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. RiskAssessment 0..* RiskAssessment Potential outcomes for a subject with likelihood
... id Σ 0..1 id Logical id of this artifact
... meta Σ 0..1 Meta Metadata about the resource
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
... text 0..1 Narrative Text summary of the resource, for human interpretation
This profile does not constrain the narrative in regard to content, language, or traceability to data elements
... contained 0..* Resource Contained, inline Resources
... extension 0..* Extension Additional content defined by implementations
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... identifier Σ 0..* Identifier Unique identifier for the assessment
... basedOn 0..1 Reference(Resource) Request fulfilled by this assessment
... parent 0..1 Reference(Resource) Part of this occurrence
... status SΣ 1..1 code Risk assessment status (e.g., preliminary, final)
Binding: ObservationStatus (required): The status of the risk assessment; e.g. preliminary, final, amended, etc.
... method SΣ 0..1 CodeableConcept Method or algorithm used (guideline, AI model, score)
Binding Description: (example): The mechanism or algorithm used to make the assessment; e.g. TIMI, PRISM, Cardiff Type 2 diabetes, etc.
... code SΣ 1..1 CodeableConcept Type of risk assessed (e.g., cardiovascular, metabolic, cancer)
... subject SΣ 1..1 Reference(PGHD_Patient) Reference to the patient being assessed
... encounter Σ 0..1 Reference(Encounter) Where was assessment performed?
... occurrence[x] Σ 0..1 When was assessment made?
.... occurrenceDateTime dateTime
.... occurrencePeriod Period
... condition Σ 0..1 Reference(Condition) Condition assessed
... performer Σ 0..1 Reference(Practitioner | PractitionerRole | Device) Operator or system that generated the assessment
... reasonCode 0..* CodeableConcept Why the assessment was necessary?
... reasonReference 0..* Reference(Condition | Observation | DiagnosticReport | DocumentReference) Why the assessment was necessary?
... basis S 0..* Reference(Observation | Condition | FamilyMemberHistory) Clinical sources on which the assessment is based (e.g., Observation, Condition, FamilyMemberHistory)
... prediction SC 1..* BackboneElement Predictive results derived from the risk assessment
Constraints: ras-2
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... outcome 0..1 CodeableConcept Expected event or potential condition (e.g., heart attack, neoplasm)
Binding Description: (example): The condition or other outcome; e.g. death, remission, amputation, infection, etc.
.... probability[x] C 0..1 Estimated probability of the predicted event
Constraints: ras-1
..... probabilityDecimal decimal
..... probabilityRange Range
.... qualitativeRisk 0..1 CodeableConcept Likelihood of specified outcome as a qualitative value
Binding: RiskProbability (example): The likelihood of the occurrence of a specified outcome.
.... relativeRisk 0..1 decimal Relative likelihood
.... when[x] 0..1 Time window in which the event is predicted to occur
..... whenPeriod Period
..... whenRange Range
.... rationale 0..1 string Explanation of prediction
... mitigation 0..1 string Suggested actions to reduce or prevent the predicted risk
... note 0..* Annotation Comments on the risk assessment

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
RiskAssessment.language Base preferred Common Languages 📍4.0.1 FHIR Std.
RiskAssessment.status Base required ObservationStatus 📍4.0.1 FHIR Std.
RiskAssessment.method Base example Not State Unknown
RiskAssessment.prediction.​outcome Base example Not State Unknown
RiskAssessment.prediction.​qualitativeRisk Base example Risk Probability 📍4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
dom-2 error RiskAssessment If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error RiskAssessment If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4 error RiskAssessment If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5 error RiskAssessment If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice RiskAssessment A resource should have narrative for robust management text.`div`.exists()
ele-1 error **ALL** elements All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **ALL** extensions Must have either extensions or value[x], not both extension.exists() != value.exists()
ras-1 error RiskAssessment.prediction.probability[x] low and high must be percentages, if present (low.empty() or ((low.code = '%') and (low.system = %ucum))) and (high.empty() or ((high.code = '%') and (high.system = %ucum)))
ras-2 error RiskAssessment.prediction Must be <= 100 probability is decimal implies (probability as decimal) <= 100

This structure is derived from RiskAssessment

Summary

Mandatory: 2 elements
Must-Support: 6 elements

Structures

This structure refers to these other structures:

Key Elements View

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. RiskAssessment 0..* RiskAssessment Potential outcomes for a subject with likelihood
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... status SΣ 1..1 code Risk assessment status (e.g., preliminary, final)
Binding: ObservationStatus (required): The status of the risk assessment; e.g. preliminary, final, amended, etc.
... code SΣ 1..1 CodeableConcept Type of risk assessed (e.g., cardiovascular, metabolic, cancer)
... subject SΣ 1..1 Reference(PGHD_Patient) Reference to the patient being assessed
... performer Σ 0..1 Reference(Practitioner | PractitionerRole | Device) Operator or system that generated the assessment
... basis S 0..* Reference(Observation | Condition | FamilyMemberHistory) Clinical sources on which the assessment is based (e.g., Observation, Condition, FamilyMemberHistory)
... prediction SC 1..* BackboneElement Predictive results derived from the risk assessment
Constraints: ras-2
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... outcome 0..1 CodeableConcept Expected event or potential condition (e.g., heart attack, neoplasm)
Binding Description: (example): The condition or other outcome; e.g. death, remission, amputation, infection, etc.
.... probability[x] C 0..1 Estimated probability of the predicted event
Constraints: ras-1
..... probabilityDecimal decimal
..... probabilityRange Range
.... when[x] 0..1 Time window in which the event is predicted to occur
..... whenPeriod Period
..... whenRange Range
... mitigation 0..1 string Suggested actions to reduce or prevent the predicted risk

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
RiskAssessment.status Base required ObservationStatus 📍4.0.1 FHIR Std.
RiskAssessment.method Base example Not State Unknown
RiskAssessment.prediction.​outcome Base example Not State Unknown

Constraints

Id Grade Path(s) Description Expression
dom-2 error RiskAssessment If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error RiskAssessment If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4 error RiskAssessment If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5 error RiskAssessment If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice RiskAssessment A resource should have narrative for robust management text.`div`.exists()
ele-1 error **ALL** elements All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **ALL** extensions Must have either extensions or value[x], not both extension.exists() != value.exists()
ras-1 error RiskAssessment.prediction.probability[x] low and high must be percentages, if present (low.empty() or ((low.code = '%') and (low.system = %ucum))) and (high.empty() or ((high.code = '%') and (high.system = %ucum)))
ras-2 error RiskAssessment.prediction Must be <= 100 probability is decimal implies (probability as decimal) <= 100

Differential View

This structure is derived from RiskAssessment

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. RiskAssessment 0..* RiskAssessment Potential outcomes for a subject with likelihood
... status S 1..1 code Risk assessment status (e.g., preliminary, final)
... method S 0..1 CodeableConcept Method or algorithm used (guideline, AI model, score)
... code S 1..1 CodeableConcept Type of risk assessed (e.g., cardiovascular, metabolic, cancer)
... performer 0..1 Reference(Practitioner | PractitionerRole | Device) Operator or system that generated the assessment
... basis S 0..* Reference(Observation | Condition | FamilyMemberHistory) Clinical sources on which the assessment is based (e.g., Observation, Condition, FamilyMemberHistory)
... prediction S 1..* BackboneElement Predictive results derived from the risk assessment
.... outcome 0..1 CodeableConcept Expected event or potential condition (e.g., heart attack, neoplasm)
.... probability[x] 0..1 decimal, Range Estimated probability of the predicted event
.... when[x] 0..1 Period, Range Time window in which the event is predicted to occur
... mitigation 0..1 string Suggested actions to reduce or prevent the predicted risk

doco Documentation for this format

Snapshot View

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. RiskAssessment 0..* RiskAssessment Potential outcomes for a subject with likelihood
... id Σ 0..1 id Logical id of this artifact
... meta Σ 0..1 Meta Metadata about the resource
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
... text 0..1 Narrative Text summary of the resource, for human interpretation
This profile does not constrain the narrative in regard to content, language, or traceability to data elements
... contained 0..* Resource Contained, inline Resources
... extension 0..* Extension Additional content defined by implementations
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... identifier Σ 0..* Identifier Unique identifier for the assessment
... basedOn 0..1 Reference(Resource) Request fulfilled by this assessment
... parent 0..1 Reference(Resource) Part of this occurrence
... status SΣ 1..1 code Risk assessment status (e.g., preliminary, final)
Binding: ObservationStatus (required): The status of the risk assessment; e.g. preliminary, final, amended, etc.
... method SΣ 0..1 CodeableConcept Method or algorithm used (guideline, AI model, score)
Binding Description: (example): The mechanism or algorithm used to make the assessment; e.g. TIMI, PRISM, Cardiff Type 2 diabetes, etc.
... code SΣ 1..1 CodeableConcept Type of risk assessed (e.g., cardiovascular, metabolic, cancer)
... subject SΣ 1..1 Reference(PGHD_Patient) Reference to the patient being assessed
... encounter Σ 0..1 Reference(Encounter) Where was assessment performed?
... occurrence[x] Σ 0..1 When was assessment made?
.... occurrenceDateTime dateTime
.... occurrencePeriod Period
... condition Σ 0..1 Reference(Condition) Condition assessed
... performer Σ 0..1 Reference(Practitioner | PractitionerRole | Device) Operator or system that generated the assessment
... reasonCode 0..* CodeableConcept Why the assessment was necessary?
... reasonReference 0..* Reference(Condition | Observation | DiagnosticReport | DocumentReference) Why the assessment was necessary?
... basis S 0..* Reference(Observation | Condition | FamilyMemberHistory) Clinical sources on which the assessment is based (e.g., Observation, Condition, FamilyMemberHistory)
... prediction SC 1..* BackboneElement Predictive results derived from the risk assessment
Constraints: ras-2
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... outcome 0..1 CodeableConcept Expected event or potential condition (e.g., heart attack, neoplasm)
Binding Description: (example): The condition or other outcome; e.g. death, remission, amputation, infection, etc.
.... probability[x] C 0..1 Estimated probability of the predicted event
Constraints: ras-1
..... probabilityDecimal decimal
..... probabilityRange Range
.... qualitativeRisk 0..1 CodeableConcept Likelihood of specified outcome as a qualitative value
Binding: RiskProbability (example): The likelihood of the occurrence of a specified outcome.
.... relativeRisk 0..1 decimal Relative likelihood
.... when[x] 0..1 Time window in which the event is predicted to occur
..... whenPeriod Period
..... whenRange Range
.... rationale 0..1 string Explanation of prediction
... mitigation 0..1 string Suggested actions to reduce or prevent the predicted risk
... note 0..* Annotation Comments on the risk assessment

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
RiskAssessment.language Base preferred Common Languages 📍4.0.1 FHIR Std.
RiskAssessment.status Base required ObservationStatus 📍4.0.1 FHIR Std.
RiskAssessment.method Base example Not State Unknown
RiskAssessment.prediction.​outcome Base example Not State Unknown
RiskAssessment.prediction.​qualitativeRisk Base example Risk Probability 📍4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
dom-2 error RiskAssessment If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error RiskAssessment If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4 error RiskAssessment If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5 error RiskAssessment If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice RiskAssessment A resource should have narrative for robust management text.`div`.exists()
ele-1 error **ALL** elements All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **ALL** extensions Must have either extensions or value[x], not both extension.exists() != value.exists()
ras-1 error RiskAssessment.prediction.probability[x] low and high must be percentages, if present (low.empty() or ((low.code = '%') and (low.system = %ucum))) and (high.empty() or ((high.code = '%') and (high.system = %ucum)))
ras-2 error RiskAssessment.prediction Must be <= 100 probability is decimal implies (probability as decimal) <= 100

This structure is derived from RiskAssessment

Summary

Mandatory: 2 elements
Must-Support: 6 elements

Structures

This structure refers to these other structures:

 

Other representations of profile: CSV, Excel, Schematron