The Cicada Vaccine Forecasting Engine and Guide
0.1.0 - ci-build

The Cicada Vaccine Forecasting Engine and Guide - Local Development build (v0.1.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

: Cicada Forecast Reason Code System - TTL Representation

Draft as of 2026-09-07

Raw ttl | Download


@prefix fhir: <http://hl7.org/fhir/> .
@prefix owl: <http://www.w3.org/2002/07/owl#> .
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
@prefix xsd: <http://www.w3.org/2001/XMLSchema#> .

# - resource -------------------------------------------------------------------

<http://hl7.org/fhir/CodeSystem/forecast-reason> a fhir:CodeSystem ;
  fhir:nodeRole fhir:treeRoot ;
  fhir:Resource.id [ fhir:value "forecast-reason"] ;
  fhir:DomainResource.text [
     fhir:Narrative.status [ fhir:value "generated" ] ;
     fhir:Narrative.div "<div xmlns=\"http://www.w3.org/1999/xhtml\"><p class=\"res-header-id\"><b>Generated Narrative: CodeSystem forecast-reason</b></p><a name=\"forecast-reason\"> </a><a name=\"hcforecast-reason\"> </a><p>This case-sensitive code system <code>http://fhirfli.dev/fhir/ig/cicada/CodeSystem/forecast-reason</code> defines the following codes:</p><table class=\"codes\"><tr><td style=\"white-space:nowrap\"><b>Code</b></td><td><b>Display</b></td><td><b>Definition</b></td></tr><tr><td style=\"white-space:nowrap\">series-complete<a name=\"forecast-reason-series-complete\"> </a></td><td>Patient series is complete</td><td>Every target dose in the series is satisfied. Maps to ImmDS #complete.</td></tr><tr><td style=\"white-space:nowrap\">not-recommended-history<a name=\"forecast-reason-not-recommended-history\"> </a></td><td>Not recommended at this time due to past immunization history</td><td>Maps to ImmDS #notRecommended.</td></tr><tr><td style=\"white-space:nowrap\">exceeded-maximum-age<a name=\"forecast-reason-exceeded-maximum-age\"> </a></td><td>Patient has exceeded the maximum age</td><td>Maps to ImmDS #maximumAge.</td></tr><tr><td style=\"white-space:nowrap\">past-seasonal-end<a name=\"forecast-reason-past-seasonal-end\"> </a></td><td>Past seasonal recommendation end date</td><td>Maps to ImmDS #seasonalPast.</td></tr><tr><td style=\"white-space:nowrap\">complete-for-the-season<a name=\"forecast-reason-complete-for-the-season\"> </a></td><td>Patient is complete for the season</td><td>The series is complete for the current season and a further dose falls in a later one. Maps to ImmDS #seasonalComplete. A deliberate deviation from CDSi, which has no such reason: ACIP defines influenza and RSV recommendations by season, and without this a patient who has had this year's dose is indistinguishable from one who never needs another.</td></tr><tr><td style=\"white-space:nowrap\">evidence-of-immunity<a name=\"forecast-reason-evidence-of-immunity\"> </a></td><td>Patient has evidence of immunity</td><td>No ImmDS concept.</td></tr><tr><td style=\"white-space:nowrap\">contraindication<a name=\"forecast-reason-contraindication\"> </a></td><td>Patient has a contraindication</td><td>No ImmDS concept.</td></tr><tr><td style=\"white-space:nowrap\">cannot-finish-before-maximum-age<a name=\"forecast-reason-cannot-finish-before-maximum-age\"> </a></td><td>Patient is unable to finish the series prior to the maximum age</td><td>No ImmDS concept.</td></tr><tr><td style=\"white-space:nowrap\">below-minimum-age-to-start<a name=\"forecast-reason-below-minimum-age-to-start\"> </a></td><td>Patient has not reached the minimum age to start</td><td>No ImmDS concept.</td></tr><tr><td style=\"white-space:nowrap\">shared-clinical-decision-making<a name=\"forecast-reason-shared-clinical-decision-making\"> </a></td><td>Recommended by shared clinical decision-making</td><td>ACIP recommends this series by shared clinical decision-making rather than routinely, so it is not a care gap. Read from CDC's own marking in the series name, and for HPV from the 27-45 year band CDC states in its guidance. No CDSi or ImmDS concept; ICE calls it CLINICAL_PATIENT_DISCRETION.</td></tr></table></div>"
  ] ;
  fhir:CodeSystem.url [ fhir:value "http://fhirfli.dev/fhir/ig/cicada/CodeSystem/forecast-reason"] ;
  fhir:CodeSystem.version [ fhir:value "0.1.0"] ;
  fhir:CodeSystem.name [ fhir:value "CicadaForecastReasonCS"] ;
  fhir:CodeSystem.title [ fhir:value "Cicada Forecast Reason Code System"] ;
  fhir:CodeSystem.status [ fhir:value "draft"] ;
  fhir:CodeSystem.experimental [ fhir:value "false"^^xsd:boolean] ;
  fhir:CodeSystem.date [ fhir:value "2026-09-07T19:51:55-04:00"^^xsd:dateTime] ;
  fhir:CodeSystem.publisher [ fhir:value "FHIR-FLI"] ;
  fhir:CodeSystem.contact [
     fhir:index 0 ;
     fhir:ContactDetail.name [ fhir:value "FHIR-FLI" ] ;
     fhir:ContactDetail.telecom [
       fhir:index 0 ;
       fhir:ContactPoint.system [ fhir:value "url" ] ;
       fhir:ContactPoint.value [ fhir:value "http://fhirfli.dev" ]
     ]
  ] ;
  fhir:CodeSystem.description [ fhir:value "Why the engine forecast what it did. The ImmDS ForecastReason code system covers four of these; the rest have no ImmDS concept, and the ImmDS binding on ImmunizationRecommendation.recommendation.forecastReason is example strength, so they travel as a second coding rather than being dropped."] ;
  fhir:CodeSystem.caseSensitive [ fhir:value "true"^^xsd:boolean] ;
  fhir:CodeSystem.content [ fhir:value "complete"] ;
  fhir:CodeSystem.count [ fhir:value "10"^^xsd:nonNegativeInteger] ;
  fhir:CodeSystem.concept [
     fhir:index 0 ;
     fhir:CodeSystem.concept.code [ fhir:value "series-complete" ] ;
     fhir:CodeSystem.concept.display [ fhir:value "Patient series is complete" ] ;
     fhir:CodeSystem.concept.definition [ fhir:value "Every target dose in the series is satisfied. Maps to ImmDS #complete." ]
  ], [
     fhir:index 1 ;
     fhir:CodeSystem.concept.code [ fhir:value "not-recommended-history" ] ;
     fhir:CodeSystem.concept.display [ fhir:value "Not recommended at this time due to past immunization history" ] ;
     fhir:CodeSystem.concept.definition [ fhir:value "Maps to ImmDS #notRecommended." ]
  ], [
     fhir:index 2 ;
     fhir:CodeSystem.concept.code [ fhir:value "exceeded-maximum-age" ] ;
     fhir:CodeSystem.concept.display [ fhir:value "Patient has exceeded the maximum age" ] ;
     fhir:CodeSystem.concept.definition [ fhir:value "Maps to ImmDS #maximumAge." ]
  ], [
     fhir:index 3 ;
     fhir:CodeSystem.concept.code [ fhir:value "past-seasonal-end" ] ;
     fhir:CodeSystem.concept.display [ fhir:value "Past seasonal recommendation end date" ] ;
     fhir:CodeSystem.concept.definition [ fhir:value "Maps to ImmDS #seasonalPast." ]
  ], [
     fhir:index 4 ;
     fhir:CodeSystem.concept.code [ fhir:value "complete-for-the-season" ] ;
     fhir:CodeSystem.concept.display [ fhir:value "Patient is complete for the season" ] ;
     fhir:CodeSystem.concept.definition [ fhir:value "The series is complete for the current season and a further dose falls in a later one. Maps to ImmDS #seasonalComplete. A deliberate deviation from CDSi, which has no such reason: ACIP defines influenza and RSV recommendations by season, and without this a patient who has had this year's dose is indistinguishable from one who never needs another." ]
  ], [
     fhir:index 5 ;
     fhir:CodeSystem.concept.code [ fhir:value "evidence-of-immunity" ] ;
     fhir:CodeSystem.concept.display [ fhir:value "Patient has evidence of immunity" ] ;
     fhir:CodeSystem.concept.definition [ fhir:value "No ImmDS concept." ]
  ], [
     fhir:index 6 ;
     fhir:CodeSystem.concept.code [ fhir:value "contraindication" ] ;
     fhir:CodeSystem.concept.display [ fhir:value "Patient has a contraindication" ] ;
     fhir:CodeSystem.concept.definition [ fhir:value "No ImmDS concept." ]
  ], [
     fhir:index 7 ;
     fhir:CodeSystem.concept.code [ fhir:value "cannot-finish-before-maximum-age" ] ;
     fhir:CodeSystem.concept.display [ fhir:value "Patient is unable to finish the series prior to the maximum age" ] ;
     fhir:CodeSystem.concept.definition [ fhir:value "No ImmDS concept." ]
  ], [
     fhir:index 8 ;
     fhir:CodeSystem.concept.code [ fhir:value "below-minimum-age-to-start" ] ;
     fhir:CodeSystem.concept.display [ fhir:value "Patient has not reached the minimum age to start" ] ;
     fhir:CodeSystem.concept.definition [ fhir:value "No ImmDS concept." ]
  ], [
     fhir:index 9 ;
     fhir:CodeSystem.concept.code [ fhir:value "shared-clinical-decision-making" ] ;
     fhir:CodeSystem.concept.display [ fhir:value "Recommended by shared clinical decision-making" ] ;
     fhir:CodeSystem.concept.definition [ fhir:value "ACIP recommends this series by shared clinical decision-making rather than routinely, so it is not a care gap. Read from CDC's own marking in the series name, and for HPV from the 27-45 year band CDC states in its guidance. No CDSi or ImmDS concept; ICE calls it CLINICAL_PATIENT_DISCRETION." ]
  ] .

# - ontology header ------------------------------------------------------------

<http://hl7.org/fhir/CodeSystem/forecast-reason.ttl> a owl:Ontology ;
  owl:imports fhir:fhir.ttl ;
  owl:versionIRI <http://build.fhir.org/CodeSystem/forecast-reason.ttl> .