pipeline_miami/config/comparability.yaml

# Comparability regimes for Miami-Dade outcomes (decision M.5 in
# docs/cities/miami/00_overview.md). Same schema as pipeline_philly/config,
# plus `events`: years that are dropped (`excluded`) or kept-but-flagged
# (`flagged`) WITHOUT starting a new regime window. Only `boundaries` break
# the persistence window (review 2026-09-16, M9: the earlier file listed the
# pandemic years as boundaries, so 2018-19 and 2021-22 — both FSA — could
# never share a window).

regimes:

  fl_assessment:
    name: "Florida statewide assessments (FCAT 2.0 → FSA → FAST / B.E.S.T.)"
    boundaries:
      - year: "2014-15"
        note: "FSA replaces FCAT 2.0 — new standards, scale and cut scores"
      - year: "2022-23"
        note: "FAST progress monitoring (PM3) and B.E.S.T. EOCs replace FSA; FLDOE calls 2022-23 an informational baseline"
    events:
      - year: "2019-20"
        handling: excluded
        note: "No spring 2020 administration (COVID); the year is absent, not zero"
      - year: "2020-21"
        handling: flagged
        note: "Spring 2021 administered with opt-in participation; fitted and shown with a flag"
    excluded_years: ["2019-20"]          # no administration
    flagged_years: ["2020-21"]           # opt-in participation
    posture: |
      Status (percent level 3+) is within-regime comparable only. Residual-z
      within regime; cross-regime trends display raw values with a break marker.

  school_grades:
    name: "Florida school grades (A–F)"
    boundaries:
      - year: "2014-15"
        note: "Grading formula redesigned with FSA"
      - year: "2022-23"
        note: "Informational baseline year under FAST"
      - year: "2025-26"
        note: "Grading scale change (GradingScalesOverview26.pdf)"
    events:
      - year: "2019-20"
        handling: excluded
        note: "No grades issued"
      - year: "2020-21"
        handling: excluded
        note: "Grades opt-in for schools"
    excluded_years: ["2019-20", "2020-21"]
    flagged_years: []
    posture: |
      Letter grades are reported as published; component percentages are
      compared within regime only.

  graduation:
    name: "Federal uniform 4-year cohort graduation rate"
    boundaries: []
    events: []
    excluded_years: []
    flagged_years: []
    posture: |
      Definition stable 2014-15 → 2024-25 (standard diplomas; GEDs excluded).
      Year label = the year the cohort graduated; cohort entered grade 9 three years earlier.

  chronic_absenteeism:
    name: "Chronic absenteeism"
    boundaries:
      - year: "2017-18"
        note: "'Absent 10% or more' series begins; 'absent 21+ days' continues from 2010-11"
    events:
      - year: "2019-20"
        handling: excluded
        note: "Spring 2020 school closures — attendance counts unstable"
      - year: "2020-21"
        handling: excluded
        note: "Remote / hybrid year; excluded from cross-year trends"
    excluded_years: ["2019-20", "2020-21"]
    flagged_years: []
    posture: |
      Canonical metric is the 10% definition (decision M.4); 2019-20 and
      2020-21 are excluded from trend statements; the 2016-17 21+ file is
      flagged inaccurate by FLDOE.

  enrollment:
    name: "October membership (Survey 2)"
    boundaries: []
    events:
      - year: "2020-21"
        handling: flagged
        note: "Pandemic year; first-day and October counts diverged more than usual"
    excluded_years: []
    flagged_years: ["2020-21"]
    posture: |
      Headcount on the Survey 2 date; comparable across years. Never mixed
      with Survey 5 annual enrollment, Survey 3 FTE, or COFTE.