# Coastal Hazard Wheel (CHW) 3.0 - Machine-readable datasets

This package provides machine-readable versions of two core CHW 3.0 datasets:

- CHW 3.0 Logic table: chw_3_0_logic.csv
- CHW 3.0 Hazard management matrix: chw_3_0_hazard_management_matrix.csv

Dataset-specific documentation is provided in:
- README_chw_3_0_logic.md
- README_chw_3_0_management_matrix.md

## Files included

Core datasets:
- chw_3_0_logic.csv
- chw_3_0_hazard_management_matrix.csv

Lookup tables:
- dimensions_lookup_chw3_0.csv
- hazards_lookup_chw3_0.csv
- measures_lookup_chw3_0.csv

Documentation:
- README.md
- README_chw_3_0_logic.md
- README_chw_3_0_management_matrix.md

## How to join the datasets

Primary key (both datasets): chw_code

Join:
- chw_3_0_logic.csv (chw_code)
- chw_3_0_hazard_management_matrix.csv (chw_code)

Relationship: one-to-one (each CHW coastal type appears once in each dataset).

## Data conventions

File format:
- UTF-8 CSV
- comma delimiter
- header row included
- newline: LF (\n)

Identifiers:
- chw_code, hazard_id, measure_id are strings (lowercase snake_case)

CHW 3.0 Logic table:
- hazard level columns are integers in {1,2,3,4}
- dimension fields are strings
- "any" is a valid value meaning "dimension does not filter/constrain"; it is not missing data

Hazard management matrix:
- matrix values are integers in {0,1}
- 1 = relevant/applicable at screening level
- 0 = not generally relevant/applicable (0 is not missing data)

## Versioning and release date

Version: 3.0.0
Release date: 2026-02-21

## License and attribution

License: CC BY 4.0 (Creative Commons Attribution 4.0 International)

See dataset-specific README files for citation/attribution guidance.

## Canonical source

https://www.coastalhazardwheel.org/chw-dataset/