FHIR © HL7.org  |  FHIRsmith 4.0.1  |  Server Home  |  XIG Home  |  XIG Stats  | 

FHIR IG analytics

Packagecqf.aphl.chronic-ds
Resource TypeMeasure
IdMeasure-SeenPatients.json
FHIR VersionR4
Sourcehttps://build.fhir.org/ig/cqframework/aphl-chronic-ig/Measure-SeenPatients.html
URLhttp://fhir.org/guides/cqf/aphl/chronic-ds/Measure/SeenPatients
Version0.1.0
Statusdraft
Date2025-09-25T07:40:03-06:00
NameSeenPatients
TitleSeen Patients
Realmuv
DescriptionSeen patients during the measurement period
PurposeThe Seen Patients cohort measure is defined to provide a baseline for chronic disease surveillance. For each individual in the cohort, supplemental data is collected aligning with the supplemental data defined for other chronic disease surveillance measure usages, allowing for analytics across and between specific measures.

Resources that use this resource

No resources found

Resources that this resource uses

No resources found

Narrative

Note: links and images are rebased to the (stated) source

Knowledge Artifact Metadata
Name (machine-readable) SeenPatients
Title (human-readable) Seen Patients
Status Draft
Experimental true
Description

Seen patients during the measurement period
Purpose

The Seen Patients cohort measure is defined to provide a baseline for chronic disease surveillance. For each individual in the cohort, supplemental data is collected aligning with the supplemental data defined for other chronic disease surveillance measure usages, allowing for analytics across and between specific measures.
Topic Health Quality Measure Document
Measure Steward Clinical Quality Framework
Steward Contact Details http://cqframework.org
Measure Metadata
Version Number 0.1.0
Measure Scoring cohort
Measure Type process
Guidance

Patients with an encounter that ends during the measurement period are considered in the cohort.
Population Basis boolean
Measure Population Criteria (ID: group-1)
Initial Population Description:

Seen patients

Logic Definition: Initial Population
Stratifier Code: Ethnicity
Description: Ethnicity (CDC Value Set)
Stratifier Code: Plan
Description: Payer
Stratifier Code: Race
Description: Race (CDC Value Set)
Stratifier Code: Sex [HL7.v3]
Description: Administrative sex
Stratifier Code: Age
Description: Age Group
Stratifier Code: Food insecurity risk [HVS]
Description: Food insecurity risk status
Supplemental Data Elements
Supplemental Data Element Usage Code: Supplemental Data
Description: Ethnicity (CDC Value Set)
Logic Definition: SDE Ethnicity
Supplemental Data Element Usage Code: Supplemental Data
Description: Payer
Logic Definition: SDE Payer
Supplemental Data Element Usage Code: Supplemental Data
Description: Race (CDC Value Set)
Logic Definition: SDE Race
Supplemental Data Element Usage Code: Supplemental Data
Description: Administrative sex
Logic Definition: SDE Sex
Supplemental Data Element Usage Code: Supplemental Data
Description: Age
Logic Definition: SDE Age
Supplemental Data Element Usage Code: Supplemental Data
Description: State of residence
Logic Definition: SDE State of Residence
Supplemental Data Element Usage Code: Supplemental Data
Description: Postal code of residence
Logic Definition: SDE Postal Code of Residence
Supplemental Data Element Usage Code: Supplemental Data
Description: Food insecurity risk status
Logic Definition: SDE Food Insecurity Risk Status
Measure Logic
Primary Library Seen Patients
Dependency Description: Library SDE
Resource: http://fhir.org/guides/cqf/aphl/chronic-ds/Library/SupplementalDataElementsFHIR4|2.0.000
Canonical URL: http://fhir.org/guides/cqf/aphl/chronic-ds/Library/SupplementalDataElementsFHIR4|2.0.000
Dependency Description: Library FHIRHelpers
Resource: http://fhir.org/guides/cqf/aphl/chronic-ds/Library/FHIRHelpers|4.1.000
Canonical URL: http://fhir.org/guides/cqf/aphl/chronic-ds/Library/FHIRHelpers|4.1.000
Dependency Description: Library SurveillanceDataElements
Resource: http://fhir.org/guides/cqf/aphl/chronic-ds/Library/SurveillanceDataElementsFHIR4|1.0.000
Canonical URL: http://fhir.org/guides/cqf/aphl/chronic-ds/Library/SurveillanceDataElementsFHIR4|1.0.000
Dependency Description: Library Common
Resource: http://fhir.org/guides/cqf/aphl/chronic-ds/Library/MATGlobalCommonFunctionsFHIR4|6.0.000
Canonical URL: http://fhir.org/guides/cqf/aphl/chronic-ds/Library/MATGlobalCommonFunctionsFHIR4|6.0.000
Dependency Description: Code system LOINC
Resource: http://loinc.org
Canonical URL: http://loinc.org
Dependency Description: Value set Payer
Resource: Payer
Canonical URL: http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.114222.4.11.3591
Direct Reference Code Display: Food insecurity risk [HVS]
Code: 88124-3
System: http://loinc.org
Parameter Name: Measurement Period
Use: In
Min Cardinality: 0
Max Cardinality: 1
Type: Period
Parameter Name: SDE Sex
Use: Out
Min Cardinality: 0
Max Cardinality: 1
Type: Coding
Parameter Name: SDE Postal Code of Residence
Use: Out
Min Cardinality: 0
Max Cardinality: 1
Type: string
Parameter Name: SDE Payer
Use: Out
Min Cardinality: 0
Max Cardinality: *
Type: Resource
Parameter Name: SDE State of Residence
Use: Out
Min Cardinality: 0
Max Cardinality: 1
Type: string
Parameter Name: SDE Food Insecurity Risk Status
Use: Out
Min Cardinality: 0
Max Cardinality: 1
Type: CodeableConcept
Parameter Name: Initial Population
Use: Out
Min Cardinality: 0
Max Cardinality: 1
Type: boolean
Parameter Name: SDE Ethnicity
Use: Out
Min Cardinality: 0
Max Cardinality: *
Type: Coding
Parameter Name: SDE Age
Use: Out
Min Cardinality: 0
Max Cardinality: 1
Type: integer
Parameter Name: SDE Race
Use: Out
Min Cardinality: 0
Max Cardinality: *
Type: Coding
Measure Logic Data Requirements
Data Requirement Type: Patient
Profile(s): Patient
Must Support Elements: use, type, url, extension, value
Data Requirement Type: Coverage
Profile(s): Coverage
Must Support Elements: type, period
Code Filter(s):
Path: type
ValueSet: Payer
Data Requirement Type: Observation
Profile(s): Observation
Must Support Elements: code
Code Filter(s):
Path: code
Code:
Data Requirement Type: Encounter
Profile(s): Encounter
Must Support Elements: period
Measure Logic Definitions
Logic Definition Library Name: SupplementalDataElementsFHIR4 
define "SDE Sex":
  case
      when Patient.gender = 'male' then Code { code: 'M', system: 'http://hl7.org/fhir/v3/AdministrativeGender', display: 'Male' }
      when Patient.gender = 'female' then Code { code: 'F', system: 'http://hl7.org/fhir/v3/AdministrativeGender', display: 'Female' }
      else null
    end
Logic Definition Library Name: SeenPatients 
define "SDE Sex":
  SDE."SDE Sex"
Logic Definition Library Name: SurveillanceDataElementsFHIR4 
// Jurisdiction of residence (jurisdiction of the patient)
define "Most recent physical home address":
  First(
    Patient.address A
      where A.use = 'home'
        and A.type = 'physical'
      sort by end of period desc
  )
Logic Definition Library Name: SurveillanceDataElementsFHIR4 
define "Postal Code of Residence":
  "Most recent physical home address".postalCode
Logic Definition Library Name: SeenPatients 
define "SDE Postal Code of Residence":
  SurveillanceDataElements."Postal Code of Residence"
Logic Definition Library Name: SupplementalDataElementsFHIR4 
define "SDE Payer":
  [Coverage: type in "Payer"] Payer
        return {
          code: Payer.type,
          period: Payer.period
        }
Logic Definition Library Name: SeenPatients 
define "SDE Payer":
  SDE."SDE Payer"
Logic Definition Library Name: SurveillanceDataElementsFHIR4 
define "State of Residence":
  "Most recent physical home address".state
Logic Definition Library Name: SeenPatients 
define "SDE State of Residence":
  SurveillanceDataElements."State of Residence"
Logic Definition Library Name: SurveillanceDataElementsFHIR4 
// Jurisdiction of care (jurisdiction of the most recent encounter)
// TODO:
//define "Most recent address of care":

// NOTE: Included in eICR
// Occupational Data for Health - Past or Present Job
// http://hl7.org/fhir/us/odh/StructureDefinition-odh-PastOrPresentJob.html
// Observation: LOINC#11341-5, valueCodeableConcept in https://phinvads.cdc.gov/vads/ViewValueSet.action?oid=2.16.840.1.114222.4.11.7186

// Social Determinants of Health (SDOH)
// http://build.fhir.org/ig/HL7/fhir-sdoh-clinicalcare/StructureDefinition-SDOHCC-ObservationScreeningResponse.html
// Food insecurity risk: http://build.fhir.org/ig/HL7/fhir-sdoh-clinicalcare/Observation-SDOHCC-ObservationResponseHungerVitalSignQuestion3Example.html
// Observation: LOINC#88124-3, valueCodeableConcept in https://loinc.org/LL2510-7/ (At risk, No risk)
define "Food Insecurity Risk Status":
  First(
    [Observation: "Food insecurity risk [HVS]"] O
      sort by issued desc
  ).value as CodeableConcept
Logic Definition Library Name: SeenPatients 
define "SDE Food Insecurity Risk Status":
  SurveillanceDataElements."Food Insecurity Risk Status"
Logic Definition Library Name: SeenPatients 
define "Initial Population":
  exists (
    [Encounter] E
      where E.period ends during "Measurement Period"
  )
Logic Definition Library Name: SupplementalDataElementsFHIR4 
define "SDE Ethnicity":
  (flatten (
      Patient.extension Extension
        where Extension.url = 'http://hl7.org/fhir/us/core/StructureDefinition/us-core-ethnicity'
          return Extension.extension
    )) E
      where E.url = 'ombCategory'
        or E.url = 'detailed'
      return E.value as Coding
Logic Definition Library Name: SeenPatients 
define "SDE Ethnicity":
  SDE."SDE Ethnicity"
Logic Definition Library Name: SurveillanceDataElementsFHIR4 
// Age
define "Age":
  AgeInYearsAt(end of "Measurement Period")
Logic Definition Library Name: SeenPatients 
define "SDE Age":
  SurveillanceDataElements."Age"
Logic Definition Library Name: SupplementalDataElementsFHIR4 
define "SDE Race":
  (flatten (
      Patient.extension Extension
        where Extension.url = 'http://hl7.org/fhir/us/core/StructureDefinition/us-core-race'
          return Extension.extension
    )) E
      where E.url = 'ombCategory'
        or E.url = 'detailed'
      return E.value as Coding
Logic Definition Library Name: SeenPatients 
define "SDE Race":
  SDE."SDE Race"
Logic Definition Library Name: FHIRHelpers 
define function ToString(value AdministrativeGender): value.value
Logic Definition Library Name: FHIRHelpers 
define function ToString(value AddressUse): value.value
Logic Definition Library Name: FHIRHelpers 
define function ToString(value AddressType): value.value
Logic Definition Library Name: FHIRHelpers 
define function ToInterval(period FHIR.Period):
    if period is null then
        null
    else
        if period."start" is null then
            Interval(period."start".value, period."end".value]
        else
            Interval[period."start".value, period."end".value]
Logic Definition Library Name: FHIRHelpers 
define function ToString(value uri): value.value
Generated using version 0.4.6 of the sample-content-ig Liquid templates

Source1

{
  "resourceType": "Measure",
  "id": "SeenPatients",
  "meta": {
    "profile": [
      "http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cohort-measure-cqfm",
      "http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/computable-measure-cqfm"
    ]
  },
  "text": {
    "status": "extensions",
    "div": "<!-- snip (see above) -->"
  },
  "contained": [
    {
      "resourceType": "Library",
      "id": "effective-data-requirements",
      "extension": [
        {
          "url": "http://hl7.org/fhir/StructureDefinition/cqf-directReferenceCode",
          "valueCoding": {
            "system": "http://loinc.org",
            "code": "88124-3",
            "display": "Food insecurity risk [HVS]"
          }
        },
        {
          "extension": [
            {
              "url": "libraryName",
              "valueString": "SupplementalDataElementsFHIR4"
            },
            {
              "url": "name",
              "valueString": "SDE Sex"
            },
            {
              "url": "statement",
              "valueString": "define \"SDE Sex\":\n  case\n      when Patient.gender = 'male' then Code { code: 'M', system: 'http://hl7.org/fhir/v3/AdministrativeGender', display: 'Male' }\n      when Patient.gender = 'female' then Code { code: 'F', system: 'http://hl7.org/fhir/v3/AdministrativeGender', display: 'Female' }\n      else null\n    end"
            },
            {
              "url": "displaySequence",
              "valueInteger": 0
            }
          ],
          "url": "http://hl7.org/fhir/StructureDefinition/cqf-logicDefinition"
        },
        {
          "extension": [
            {
              "url": "libraryName",
              "valueString": "SeenPatients"
            },
            {
              "url": "name",
              "valueString": "SDE Sex"
            },
            {
              "url": "statement",
              "valueString": "define \"SDE Sex\":\n  SDE.\"SDE Sex\""
            },
            {
              "url": "displaySequence",
              "valueInteger": 1
            }
          ],
          "url": "http://hl7.org/fhir/StructureDefinition/cqf-logicDefinition"
        },
        {
          "extension": [
            {
              "url": "libraryName",
              "valueString": "SurveillanceDataElementsFHIR4"
            },
            {
              "url": "name",
              "valueString": "Most recent physical home address"
            },
            {
              "url": "statement",
              "valueString": "// Jurisdiction of residence (jurisdiction of the patient)\ndefine \"Most recent physical home address\":\n  First(\n    Patient.address A\n      where A.use = 'home'\n        and A.type = 'physical'\n      sort by end of period desc\n  )"
            },
            {
              "url": "displaySequence",
              "valueInteger": 2
            }
          ],
          "url": "http://hl7.org/fhir/StructureDefinition/cqf-logicDefinition"
        },
        {
          "extension": [
            {
              "url": "libraryName",
              "valueString": "SurveillanceDataElementsFHIR4"
            },
            {
              "url": "name",
              "valueString": "Postal Code of Residence"
            },
            {
              "url": "statement",
              "valueString": "define \"Postal Code of Residence\":\n  \"Most recent physical home address\".postalCode"
            },
            {
              "url": "displaySequence",
              "valueInteger": 3
            }
          ],
          "url": "http://hl7.org/fhir/StructureDefinition/cqf-logicDefinition"
        },
        {
          "extension": [
            {
              "url": "libraryName",
              "valueString": "SeenPatients"
            },
            {
              "url": "name",
              "valueString": "SDE Postal Code of Residence"
            },
            {
              "url": "statement",
              "valueString": "define \"SDE Postal Code of Residence\":\n  SurveillanceDataElements.\"Postal Code of Residence\""
            },
            {
              "url": "displaySequence",
              "valueInteger": 4
            }
          ],
          "url": "http://hl7.org/fhir/StructureDefinition/cqf-logicDefinition"
        },
        {
          "extension": [
            {
              "url": "libraryName",
              "valueString": "SupplementalDataElementsFHIR4"
            },
            {
              "url": "name",
              "valueString": "SDE Payer"
            },
            {
              "url": "statement",
              "valueString": "define \"SDE Payer\":\n  [Coverage: type in \"Payer\"] Payer\n        return {\n          code: Payer.type,\n          period: Payer.period\n        }"
            },
            {
              "url": "displaySequence",
              "valueInteger": 5
            }
          ],
          "url": "http://hl7.org/fhir/StructureDefinition/cqf-logicDefinition"
        },
        {
          "extension": [
            {
              "url": "libraryName",
              "valueString": "SeenPatients"
            },
            {
              "url": "name",
              "valueString": "SDE Payer"
            },
            {
              "url": "statement",
              "valueString": "define \"SDE Payer\":\n  SDE.\"SDE Payer\""
            },
            {
              "url": "displaySequence",
              "valueInteger": 6
            }
          ],
          "url": "http://hl7.org/fhir/StructureDefinition/cqf-logicDefinition"
        },
        {
          "extension": [
            {
              "url": "libraryName",
              "valueString": "SurveillanceDataElementsFHIR4"
            },
            {
              "url": "name",
              "valueString": "State of Residence"
            },
            {
              "url": "statement",
              "valueString": "define \"State of Residence\":\n  \"Most recent physical home address\".state"
            },
            {
              "url": "displaySequence",
              "valueInteger": 7
            }
          ],
          "url": "http://hl7.org/fhir/StructureDefinition/cqf-logicDefinition"
        },
        {
          "extension": [
            {
              "url": "libraryName",
              "valueString": "SeenPatients"
            },
            {
              "url": "name",
              "valueString": "SDE State of Residence"
            },
            {
              "url": "statement",
              "valueString": "define \"SDE State of Residence\":\n  SurveillanceDataElements.\"State of Residence\""
            },
            {
              "url": "displaySequence",
              "valueInteger": 8
            }
          ],
          "url": "http://hl7.org/fhir/StructureDefinition/cqf-logicDefinition"
        },
        {
          "extension": [
            {
              "url": "libraryName",
              "valueString": "SurveillanceDataElementsFHIR4"
            },
            {
              "url": "name",
              "valueString": "Food Insecurity Risk Status"
            },
            {
              "url": "statement",
              "valueString": "// Jurisdiction of care (jurisdiction of the most recent encounter)\n// TODO:\n//define \"Most recent address of care\":\n\n// NOTE: Included in eICR\n// Occupational Data for Health - Past or Present Job\n// http://hl7.org/fhir/us/odh/StructureDefinition-odh-PastOrPresentJob.html\n// Observation: LOINC#11341-5, valueCodeableConcept in https://phinvads.cdc.gov/vads/ViewValueSet.action?oid=2.16.840.1.114222.4.11.7186\n\n// Social Determinants of Health (SDOH)\n// http://build.fhir.org/ig/HL7/fhir-sdoh-clinicalcare/StructureDefinition-SDOHCC-ObservationScreeningResponse.html\n// Food insecurity risk: http://build.fhir.org/ig/HL7/fhir-sdoh-clinicalcare/Observation-SDOHCC-ObservationResponseHungerVitalSignQuestion3Example.html\n// Observation: LOINC#88124-3, valueCodeableConcept in https://loinc.org/LL2510-7/ (At risk, No risk)\ndefine \"Food Insecurity Risk Status\":\n  First(\n    [Observation: \"Food insecurity risk [HVS]\"] O\n      sort by issued desc\n  ).value as CodeableConcept"
            },
            {
              "url": "displaySequence",
              "valueInteger": 9
            }
          ],
          "url": "http://hl7.org/fhir/StructureDefinition/cqf-logicDefinition"
        },
        {
          "extension": [
            {
              "url": "libraryName",
              "valueString": "SeenPatients"
            },
            {
              "url": "name",
              "valueString": "SDE Food Insecurity Risk Status"
            },
            {
              "url": "statement",
              "valueString": "define \"SDE Food Insecurity Risk Status\":\n  SurveillanceDataElements.\"Food Insecurity Risk Status\""
            },
            {
              "url": "displaySequence",
              "valueInteger": 10
            }
          ],
          "url": "http://hl7.org/fhir/StructureDefinition/cqf-logicDefinition"
        },
        {
          "extension": [
            {
              "url": "libraryName",
              "valueString": "SeenPatients"
            },
            {
              "url": "name",
              "valueString": "Initial Population"
            },
            {
              "url": "statement",
              "valueString": "define \"Initial Population\":\n  exists (\n    [Encounter] E\n      where E.period ends during \"Measurement Period\"\n  )"
            },
            {
              "url": "displaySequence",
              "valueInteger": 11
            }
          ],
          "url": "http://hl7.org/fhir/StructureDefinition/cqf-logicDefinition"
        },
        {
          "extension": [
            {
              "url": "libraryName",
              "valueString": "SupplementalDataElementsFHIR4"
            },
            {
              "url": "name",
              "valueString": "SDE Ethnicity"
            },
            {
              "url": "statement",
              "valueString": "define \"SDE Ethnicity\":\n  (flatten (\n      Patient.extension Extension\n        where Extension.url = 'http://hl7.org/fhir/us/core/StructureDefinition/us-core-ethnicity'\n          return Extension.extension\n    )) E\n      where E.url = 'ombCategory'\n        or E.url = 'detailed'\n      return E.value as Coding"
            },
            {
              "url": "displaySequence",
              "valueInteger": 12
            }
          ],
          "url": "http://hl7.org/fhir/StructureDefinition/cqf-logicDefinition"
        },
        {
          "extension": [
            {
              "url": "libraryName",
              "valueString": "SeenPatients"
            },
            {
              "url": "name",
              "valueString": "SDE Ethnicity"
            },
            {
              "url": "statement",
              "valueString": "define \"SDE Ethnicity\":\n  SDE.\"SDE Ethnicity\""
            },
            {
              "url": "displaySequence",
              "valueInteger": 13
            }
          ],
          "url": "http://hl7.org/fhir/StructureDefinition/cqf-logicDefinition"
        },
        {
          "extension": [
            {
              "url": "libraryName",
              "valueString": "SurveillanceDataElementsFHIR4"
            },
            {
              "url": "name",
              "valueString": "Age"
            },
            {
              "url": "statement",
              "valueString": "// Age\ndefine \"Age\":\n  AgeInYearsAt(end of \"Measurement Period\")"
            },
            {
              "url": "displaySequence",
              "valueInteger": 14
            }
          ],
          "url": "http://hl7.org/fhir/StructureDefinition/cqf-logicDefinition"
        },
        {
          "extension": [
            {
              "url": "libraryName",
              "valueString": "SeenPatients"
            },
            {
              "url": "name",
              "valueString": "SDE Age"
            },
            {
              "url": "statement",
              "valueString": "define \"SDE Age\":\n  SurveillanceDataElements.\"Age\""
            },
            {
              "url": "displaySequence",
              "valueInteger": 15
            }
          ],
          "url": "http://hl7.org/fhir/StructureDefinition/cqf-logicDefinition"
        },
        {
          "extension": [
            {
              "url": "libraryName",
              "valueString": "SupplementalDataElementsFHIR4"
            },
            {
              "url": "name",
              "valueString": "SDE Race"
            },
            {
              "url": "statement",
              "valueString": "define \"SDE Race\":\n  (flatten (\n      Patient.extension Extension\n        where Extension.url = 'http://hl7.org/fhir/us/core/StructureDefinition/us-core-race'\n          return Extension.extension\n    )) E\n      where E.url = 'ombCategory'\n        or E.url = 'detailed'\n      return E.value as Coding"
            },
            {
              "url": "displaySequence",
              "valueInteger": 16
            }
          ],
          "url": "http://hl7.org/fhir/StructureDefinition/cqf-logicDefinition"
        },
        {
          "extension": [
            {
              "url": "libraryName",
              "valueString": "SeenPatients"
            },
            {
              "url": "name",
              "valueString": "SDE Race"
            },
            {
              "url": "statement",
              "valueString": "define \"SDE Race\":\n  SDE.\"SDE Race\""
            },
            {
              "url": "displaySequence",
              "valueInteger": 17
            }
          ],
          "url": "http://hl7.org/fhir/StructureDefinition/cqf-logicDefinition"
        },
        {
          "extension": [
            {
              "url": "libraryName",
              "valueString": "FHIRHelpers"
            },
            {
              "url": "name",
              "valueString": "ToString"
            },
            {
              "url": "statement",
              "valueString": "define function ToString(value AdministrativeGender): value.value"
            },
            {
              "url": "displaySequence",
              "valueInteger": 18
            }
          ],
          "url": "http://hl7.org/fhir/StructureDefinition/cqf-logicDefinition"
        },
        {
          "extension": [
            {
              "url": "libraryName",
              "valueString": "FHIRHelpers"
            },
            {
              "url": "name",
              "valueString": "ToString"
            },
            {
              "url": "statement",
              "valueString": "define function ToString(value AddressUse): value.value"
            },
            {
              "url": "displaySequence",
              "valueInteger": 19
            }
          ],
          "url": "http://hl7.org/fhir/StructureDefinition/cqf-logicDefinition"
        },
        {
          "extension": [
            {
              "url": "libraryName",
              "valueString": "FHIRHelpers"
            },
            {
              "url": "name",
              "valueString": "ToString"
            },
            {
              "url": "statement",
              "valueString": "define function ToString(value AddressType): value.value"
            },
            {
              "url": "displaySequence",
              "valueInteger": 20
            }
          ],
          "url": "http://hl7.org/fhir/StructureDefinition/cqf-logicDefinition"
        },
        {
          "extension": [
            {
              "url": "libraryName",
              "valueString": "FHIRHelpers"
            },
            {
              "url": "name",
              "valueString": "ToInterval"
            },
            {
              "url": "statement",
              "valueString": "define function ToInterval(period FHIR.Period):\n    if period is null then\n        null\n    else\n        if period.\"start\" is null then\n            Interval(period.\"start\".value, period.\"end\".value]\n        else\n            Interval[period.\"start\".value, period.\"end\".value]"
            },
            {
              "url": "displaySequence",
              "valueInteger": 21
            }
          ],
          "url": "http://hl7.org/fhir/StructureDefinition/cqf-logicDefinition"
        },
        {
          "extension": [
            {
              "url": "libraryName",
              "valueString": "FHIRHelpers"
            },
            {
              "url": "name",
              "valueString": "ToString"
            },
            {
              "url": "statement",
              "valueString": "define function ToString(value uri): value.value"
            },
            {
              "url": "displaySequence",
              "valueInteger": 22
            }
          ],
          "url": "http://hl7.org/fhir/StructureDefinition/cqf-logicDefinition"
        }
      ],
      "name": "EffectiveDataRequirements",
      "status": "active",
      "type": {
        "coding": [
          {
            "system": "http://terminology.hl7.org/CodeSystem/library-type",
            "code": "module-definition"
          }
        ]
      },
      "relatedArtifact": [
        {
          "type": "depends-on",
          "display": "Library SDE",
          "resource": "http://fhir.org/guides/cqf/aphl/chronic-ds/Library/SupplementalDataElementsFHIR4|2.0.000"
        },
        {
          "type": "depends-on",
          "display": "Library FHIRHelpers",
          "resource": "http://fhir.org/guides/cqf/aphl/chronic-ds/Library/FHIRHelpers|4.1.000"
        },
        {
          "type": "depends-on",
          "display": "Library SurveillanceDataElements",
          "resource": "http://fhir.org/guides/cqf/aphl/chronic-ds/Library/SurveillanceDataElementsFHIR4|1.0.000"
        },
        {
          "type": "depends-on",
          "display": "Library Common",
          "resource": "http://fhir.org/guides/cqf/aphl/chronic-ds/Library/MATGlobalCommonFunctionsFHIR4|6.0.000"
        },
        {
          "type": "depends-on",
          "display": "Code system LOINC",
          "resource": "http://loinc.org"
        },
        {
          "type": "depends-on",
          "display": "Value set Payer",
          "resource": "http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.114222.4.11.3591"
        }
      ],
      "parameter": [
        {
          "name": "Measurement Period",
          "use": "in",
          "min": 0,
          "max": "1",
          "type": "Period"
        },
        {
          "name": "SDE Sex",
          "use": "out",
          "min": 0,
          "max": "1",
          "type": "Coding"
        },
        {
          "name": "SDE Postal Code of Residence",
          "use": "out",
          "min": 0,
          "max": "1",
          "type": "string"
        },
        {
          "name": "SDE Payer",
          "use": "out",
          "min": 0,
          "max": "*",
          "type": "Resource"
        },
        {
          "name": "SDE State of Residence",
          "use": "out",
          "min": 0,
          "max": "1",
          "type": "string"
        },
        {
          "name": "SDE Food Insecurity Risk Status",
          "use": "out",
          "min": 0,
          "max": "1",
          "type": "CodeableConcept"
        },
        {
          "name": "Initial Population",
          "use": "out",
          "min": 0,
          "max": "1",
          "type": "boolean"
        },
        {
          "name": "SDE Ethnicity",
          "use": "out",
          "min": 0,
          "max": "*",
          "type": "Coding"
        },
        {
          "name": "SDE Age",
          "use": "out",
          "min": 0,
          "max": "1",
          "type": "integer"
        },
        {
          "name": "SDE Race",
          "use": "out",
          "min": 0,
          "max": "*",
          "type": "Coding"
        }
      ],
      "dataRequirement": [
        {
          "type": "Patient",
          "profile": [
            "http://hl7.org/fhir/StructureDefinition/Patient"
          ],
          "mustSupport": [
            "use",
            "type",
            "url",
            "extension",
            "value"
          ]
        },
        {
          "type": "Coverage",
          "profile": [
            "http://hl7.org/fhir/StructureDefinition/Coverage"
          ],
          "mustSupport": [
            "type",
            "period"
          ],
          "codeFilter": [
            {
              "path": "type",
              "valueSet": "http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.114222.4.11.3591"
            }
          ]
        },
        {
          "type": "Observation",
          "profile": [
            "http://hl7.org/fhir/StructureDefinition/Observation"
          ],
          "mustSupport": [
            "code"
          ],
          "codeFilter": [
            {
              "path": "code",
              "code": [
                {
                  "system": "http://loinc.org",
                  "code": "88124-3",
                  "display": "Food insecurity risk [HVS]"
                }
              ]
            }
          ]
        },
        {
          "type": "Encounter",
          "profile": [
            "http://hl7.org/fhir/StructureDefinition/Encounter"
          ],
          "mustSupport": [
            "period"
          ]
        }
      ]
    }
  ],
  "extension": [
    {
      "url": "http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-populationBasis",
      "valueCode": "boolean"
    },
    {
      "url": "http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-softwaresystem",
      "valueReference": {
        "reference": "Device/cqf-tooling"
      }
    },
    {
      "url": "http://hl7.org/fhir/uv/crmi/StructureDefinition/crmi-effectiveDataRequirements",
      "valueCanonical": "#effective-data-requirements"
    }
  ],
  "url": "http://fhir.org/guides/cqf/aphl/chronic-ds/Measure/SeenPatients",
  "version": "0.1.0",
  "name": "SeenPatients",
  "title": "Seen Patients",
  "status": "draft",
  "experimental": true,
  "date": "2025-09-25T07:40:03-06:00",
  "publisher": "Clinical Quality Framework",
  "contact": [
    {
      "telecom": [
        {
          "system": "url",
          "value": "http://cqframework.org"
        }
      ]
    }
  ],
  "description": "Seen patients during the measurement period",
  "jurisdiction": [
    {
      "coding": [
        {
          "system": "http://unstats.un.org/unsd/methods/m49/m49.htm",
          "code": "001"
        }
      ]
    }
  ],
  "purpose": "The Seen Patients cohort measure is defined to provide a baseline for chronic disease surveillance. For each individual in the cohort, supplemental data is collected aligning with the supplemental data defined for other chronic disease surveillance measure usages, allowing for analytics across and between specific measures.",
  "topic": [
    {
      "coding": [
        {
          "system": "http://loinc.org",
          "code": "57024-2",
          "display": "Health Quality Measure Document"
        }
      ]
    }
  ],
  "library": [
    "http://fhir.org/guides/cqf/aphl/chronic-ds/Library/SeenPatients"
  ],
  "scoring": {
    "coding": [
      {
        "system": "http://hl7.org/fhir/measure-scoring",
        "code": "cohort"
      }
    ]
  },
  "type": [
    {
      "coding": [
        {
          "system": "http://hl7.org/fhir/measure-type",
          "code": "process"
        }
      ]
    }
  ],
  "guidance": "Patients with an encounter that ends during the measurement period are considered in the cohort.",
  "group": [
    {
      "id": "group-1",
      "population": [
        {
          "code": {
            "coding": [
              {
                "system": "http://terminology.hl7.org/CodeSystem/measure-population",
                "code": "initial-population",
                "display": "Initial Population"
              }
            ]
          },
          "description": "Seen patients",
          "criteria": {
            "language": "text/cql",
            "expression": "Initial Population"
          }
        }
      ],
      "stratifier": [
        {
          "code": {
            "coding": [
              {
                "system": "http://loinc.org",
                "code": "54133-4",
                "display": "Ethnicity"
              }
            ],
            "text": "stratifier-ethnicity"
          },
          "description": "Ethnicity (CDC Value Set)",
          "criteria": {
            "language": "text/cql",
            "expression": "SDE Ethnicity"
          }
        },
        {
          "code": {
            "coding": [
              {
                "system": "http://terminology.hl7.org/CodeSystem/coverage-class",
                "code": "plan",
                "display": "Plan"
              }
            ],
            "text": "stratifier-payer"
          },
          "description": "Payer",
          "criteria": {
            "language": "text/cql",
            "expression": "SDE Payer"
          }
        },
        {
          "code": {
            "coding": [
              {
                "system": "http://loinc.org",
                "code": "32624-9",
                "display": "Race"
              }
            ],
            "text": "stratifier-race"
          },
          "description": "Race (CDC Value Set)",
          "criteria": {
            "language": "text/cql",
            "expression": "SDE Race"
          }
        },
        {
          "code": {
            "coding": [
              {
                "system": "http://loinc.org",
                "code": "72143-1",
                "display": "Sex [HL7.v3]"
              }
            ],
            "text": "stratifier-sex"
          },
          "description": "Administrative sex",
          "criteria": {
            "language": "text/cql",
            "expression": "SDE Sex"
          }
        },
        {
          "code": {
            "coding": [
              {
                "system": "http://loinc.org",
                "code": "30525-0",
                "display": "Age"
              }
            ],
            "text": "stratifier-age-group"
          },
          "description": "Age Group",
          "criteria": {
            "language": "text/cql",
            "expression": "SDE Age Group"
          }
        },
        {
          "code": {
            "coding": [
              {
                "system": "http://loinc.org",
                "code": "88124-3",
                "display": "Food insecurity risk [HVS]"
              }
            ],
            "text": "stratifier-food-insecurity-risk-status"
          },
          "description": "Food insecurity risk status",
          "criteria": {
            "language": "text/cql",
            "expression": "SDE Food Insecurity Risk Status"
          }
        }
      ]
    }
  ],
  "supplementalData": [
    {
      "code": {
        "coding": [
          {
            "system": "http://loinc.org",
            "code": "54133-4",
            "display": "Ethnicity"
          }
        ],
        "text": "sde-ethnicity"
      },
      "usage": [
        {
          "coding": [
            {
              "system": "http://terminology.hl7.org/CodeSystem/measure-data-usage",
              "code": "supplemental-data"
            }
          ]
        }
      ],
      "description": "Ethnicity (CDC Value Set)",
      "criteria": {
        "language": "text/cql",
        "expression": "SDE Ethnicity"
      }
    },
    {
      "code": {
        "coding": [
          {
            "system": "http://terminology.hl7.org/CodeSystem/coverage-class",
            "code": "plan",
            "display": "Plan"
          }
        ],
        "text": "sde-payer"
      },
      "usage": [
        {
          "coding": [
            {
              "system": "http://terminology.hl7.org/CodeSystem/measure-data-usage",
              "code": "supplemental-data"
            }
          ]
        }
      ],
      "description": "Payer",
      "criteria": {
        "language": "text/cql",
        "expression": "SDE Payer"
      }
    },
    {
      "code": {
        "coding": [
          {
            "system": "http://loinc.org",
            "code": "32624-9",
            "display": "Race"
          }
        ],
        "text": "sde-race"
      },
      "usage": [
        {
          "coding": [
            {
              "system": "http://terminology.hl7.org/CodeSystem/measure-data-usage",
              "code": "supplemental-data"
            }
          ]
        }
      ],
      "description": "Race (CDC Value Set)",
      "criteria": {
        "language": "text/cql",
        "expression": "SDE Race"
      }
    },
    {
      "code": {
        "coding": [
          {
            "system": "http://loinc.org",
            "code": "72143-1",
            "display": "Sex [HL7.v3]"
          }
        ],
        "text": "sde-sex"
      },
      "usage": [
        {
          "coding": [
            {
              "system": "http://terminology.hl7.org/CodeSystem/measure-data-usage",
              "code": "supplemental-data"
            }
          ]
        }
      ],
      "description": "Administrative sex",
      "criteria": {
        "language": "text/cql",
        "expression": "SDE Sex"
      }
    },
    {
      "code": {
        "coding": [
          {
            "system": "http://loinc.org",
            "code": "30525-0",
            "display": "Age"
          }
        ],
        "text": "sde-age"
      },
      "usage": [
        {
          "coding": [
            {
              "system": "http://terminology.hl7.org/CodeSystem/measure-data-usage",
              "code": "supplemental-data"
            }
          ]
        }
      ],
      "description": "Age",
      "criteria": {
        "language": "text/cql",
        "expression": "SDE Age"
      }
    },
    {
      "code": {
        "coding": [
          {
            "system": "http://loinc.org",
            "code": "52830-7",
            "display": "State, district or territory federal abbreviation"
          }
        ],
        "text": "sde-state-of-residence"
      },
      "usage": [
        {
          "coding": [
            {
              "system": "http://terminology.hl7.org/CodeSystem/measure-data-usage",
              "code": "supplemental-data"
            }
          ]
        }
      ],
      "description": "State of residence",
      "criteria": {
        "language": "text/cql",
        "expression": "SDE State of Residence"
      }
    },
    {
      "code": {
        "coding": [
          {
            "system": "http://loinc.org",
            "code": "45401-7",
            "display": "Postal code"
          }
        ],
        "text": "sde-postal-code-of-residence"
      },
      "usage": [
        {
          "coding": [
            {
              "system": "http://terminology.hl7.org/CodeSystem/measure-data-usage",
              "code": "supplemental-data"
            }
          ]
        }
      ],
      "description": "Postal code of residence",
      "criteria": {
        "language": "text/cql",
        "expression": "SDE Postal Code of Residence"
      }
    },
    {
      "code": {
        "coding": [
          {
            "system": "http://loinc.org",
            "code": "88124-3",
            "display": "Food insecurity risk [HVS]"
          }
        ],
        "text": "sde-food-insecurity-risk-status"
      },
      "usage": [
        {
          "coding": [
            {
              "system": "http://terminology.hl7.org/CodeSystem/measure-data-usage",
              "code": "supplemental-data"
            }
          ]
        }
      ],
      "description": "Food insecurity risk status",
      "criteria": {
        "language": "text/cql",
        "expression": "SDE Food Insecurity Risk Status"
      }
    }
  ]
}