Split the pipeline documentation by purpose so each fact has one home:
- docs/pipeline-plan.md keeps the plan, checklist, tracker, and guardrails
- docs/decisions.md holds open decisions and the dated decision log
- docs/reviews/ holds findings and tasks: one file per filter, plus
00-cross-filter.md for findings that span filters
- scripts/common/README.md holds the shared-helper rules (formerly Phase 2)
- filter-calculations.md now describes calculations only
Filed findings 12-22 from a consistency audit of the app, docs, and scripts.
Filter 1 (Köppen-Geiger): use "Köppen" with the umlaut in all prose, labels,
docstrings, help text, and checker messages (finding 21), and correct the
base build's "majority" docstring (finding 22).
Filter 2 (annual avg temperature): record the adopted definition in
filter-calculations.md §2: equally weighted 1991-2020 monthly normals, per
WMO-No. 1203 and NOAA's 2020 methodology; area-weighted county means; blank
unless all 12 months exist. Code changes for this filter are still pending.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Classify each county by area-weighted Köppen class shares: a county is
predominantly its top class when that class covers at least 50% of its
land and leads the runner-up by at least 5 percentage points; otherwise
it is Mixed (133 of 3,143 counties in the 50 states and DC).
- Add build_county_koppen_metric.py (writes data/metrics/koppen.csv) and
apply_koppen_metric_to_climate_data.py (writes koppenZone plus
koppenPrimaryClass/koppenSecondaryClass for Mixed counties).
- Move shared helpers into scripts/common/ (county loading, Köppen
legend, area-weighted raster shares); fix the 180th-meridian raster
window for Aleutians West.
- Add check_climate_data.py to validate the app CSV.
- Draw Mixed counties in app.js as diagonal stripes of their top two
classes, fixed to the ground and following the map at every zoom, with
a crossfade only when the stripe size changes. Filtering a class also
matches Mixed counties where it is primary or secondary.
- Document the rule, display, and pipeline plan in docs/ and update the
README and data-source notes.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
KnouandClaude Opus 5