Person-Centered Outcomes
0.2.0 - ci-build United States of America flag

Person-Centered Outcomes, published by HL7 International / Patient Care. This guide is not an authorized publication; it is the continuous build for version 0.2.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/mtnlotus/pco-ig/ and changes regularly. See the Directory of published versions

Library: GoalIdentificationMeasure

Official URL: http://hl7.org/fhir/us/pco/Library/GoalIdentificationMeasure Version: 0.2.0
Draft as of 2024-12-13 Computable Name: GoalIdentificationMeasure
Id: GoalIdentificationMeasure
Version: 0.2.0
Url: GoalIdentificationMeasure
Status: draft
Type:

system: http://terminology.hl7.org/CodeSystem/library-type

code: logic-library

Date: 2024-12-13 23:10:31+0000
Publisher: HL7 International / Patient Care
Jurisdiction: US
Related Artifacts:

Dependencies
Parameters:
NameTypeMinMaxIn/Out
Measurement PeriodPeriod01In
Follow-Up IntervalRange01In
PatientPatient01Out
Initial PopulationPatient0*Out
DenominatorPatient0*Out
Denominator ExclusionsResource01Out
Denominator ExceptionsResource01Out
NumeratorPatient0*Out
Data Requirements:
TypeProfileMSCode Filter
Patient http://hl7.org/fhir/StructureDefinition/Patient
Goal http://hl7.org/fhir/StructureDefinition/Goal ;;;;
Observation http://hl7.org/fhir/StructureDefinition/Observation ; code filter:
path: code
value set: http://hl7.org/fhir/us/pco/ValueSet/goal-attainment-scaling-score
Observation http://hl7.org/fhir/StructureDefinition/Observation ; code filter:
path: code
value set: http://hl7.org/fhir/us/pco/ValueSet/prom-target-measures
CarePlan http://hl7.org/fhir/StructureDefinition/CarePlan ;
Content: text/cql
library GoalIdentificationMeasure version '0.1.0'

using FHIR version '4.0.1'

include FHIRHelpers version '4.4.000' called FHIRHelpers
include PCOCommon version '0.1.0' called PC
include GoalAttainmentLogic version '0.1.0' called PCOLogic

parameter "Measurement Period" Interval<DateTime>
    default Interval[@2024-01-01T00:00:00.000Z, @2024-12-31T23:59:59.999Z]

parameter "Follow-Up Interval" Interval<System.Quantity>
  default Interval[2 weeks, 26 weeks]

context Patient

/*
Goal Identification: % of individuals 18 years of age and older with a complex care need 
who had a PCO goal identified resulting in completion of goal attainment scaling (GAS) 
or a Patient-Reported Outcome Measure (PROM) and development of an action plan.
*/

/*
@description: Includes individuals 18 years of age and older.
*/
define "Initial Population": {
  Patient person
    where AgeInYearsAt(start of "Measurement Period") >= 18
}

/*
@description: Initial Population individuals with a complex care need.
@comment: TODO - How do we determine "complex care need?"
*/
define "Denominator":
  "Initial Population"

define "Denominator Exclusions":
  null

define "Denominator Exceptions":
  null

/* 
... has a PCO goal identified resulting in completion of goal attainment scaling (GAS)
or a Patient-Reported Outcome Measure (PROM) and development of an action plan.
*/
define "Numerator":
  "Denominator" person where
    exists PCOLogic."PCO Goals During Measurement Period"
      and exists PCOLogic."Baseline Scores Before Follow-Up Period"
Content: application/elm+xml
Encoded data (21600 characters)
Content: application/elm+json
Encoded data (38924 characters)