Close gaps found in a review of the documentation:
- Track data/metrics/ and data/metric_sources.json in git so the data
checker passes on a fresh clone (finding 23; decision logged)
- State the Alaska and Hawaii coverage gap in the README limitations and
extend finding 12
- File findings 24-26: the data-sources doc lacks gridMET and several
pipeline commands; wettest/driest month are computed twice; solar GHI
is written by the extreme-temperature apply step
- Add the stale "fallback values" note to filter 2's tasks
Tidy the document system:
- Add docs/reviews/README.md with the numbering rules and a finding index
- Rename koppen-mixed-display-plan.md to koppen-mixed-display.md and fix
its stale Puerto Rico and "stage 5" text
- Add the precipitation-month step to the README enrichment list
- Describe the Current method / Previous method pattern in plan section 5
- Add CLAUDE.md with the project guardrails and doc layout
Format filter-calculations.md so it renders on GitHub and in VS Code:
inline math uses $...$, ranges use en dashes, and implementation
references name functions instead of line numbers.
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