389 lines
9.0 KiB
Markdown
389 lines
9.0 KiB
Markdown
[FILE: docs/TAXONOMY.md]
|
|
|
|
# Skyfeed Weather Alert Taxonomy Canada
|
|
Version v0.1.0-dev1
|
|
Scope Environment Canada MSC Alerts for Skyfeed and Telefact
|
|
|
|
Skyfeed is a Canada-focused weather engine.
|
|
This taxonomy defines all alert types Skyfeed aims to support, based on
|
|
|
|
Environment Canada Meteorological Service of Canada
|
|
Canadian severe weather and marine alerts
|
|
Air quality and wildfire smoke products
|
|
|
|
The goal is to mirror every alert type that can realistically be issued for Canada, so that
|
|
Nothing important is missed
|
|
Alerts can be formatted and colour-coded cleanly
|
|
The taxonomy can be localised to en-CA, fr-CA, and iu-CA Inuktitut
|
|
|
|
Note This file is taxonomy only.
|
|
Implementation details will live in internalweatheralerts.go and related files.
|
|
|
|
------------------------------------------------------------
|
|
1. Alert Levels and Concepts
|
|
------------------------------------------------------------
|
|
|
|
Skyfeed recognises these conceptual alert levels
|
|
|
|
Warning
|
|
Watch
|
|
Advisory
|
|
Statement
|
|
Information or Special Weather
|
|
|
|
Severity handling
|
|
1 Warnings
|
|
2 Watches
|
|
3 Advisories
|
|
4 Statements and informational products
|
|
|
|
------------------------------------------------------------
|
|
2. Core Severe Weather Warnings
|
|
------------------------------------------------------------
|
|
|
|
Tornado Warning
|
|
Severe Thunderstorm Warning
|
|
Snow Squall Warning
|
|
Squall Warning
|
|
Winter Storm Warning
|
|
Blizzard Warning
|
|
Snowfall Warning
|
|
Rainfall Warning
|
|
Freezing Rain Warning
|
|
Flash Freeze Warning
|
|
Wind Warning
|
|
Extreme Cold Warning
|
|
Heat Warning
|
|
Arctic Outflow Warning
|
|
Storm Surge Warning
|
|
Tropical Storm Warning
|
|
Hurricane Warning
|
|
Storm Warning Marine
|
|
Gale Warning Marine
|
|
Freezing Spray Warning Marine
|
|
High Water Level Warning
|
|
|
|
------------------------------------------------------------
|
|
3. Watches
|
|
------------------------------------------------------------
|
|
|
|
Tornado Watch
|
|
Severe Thunderstorm Watch
|
|
Snow Squall Watch
|
|
Special Weather Watch
|
|
Heat Watch
|
|
Cold Watch
|
|
Wind Watch
|
|
Hurricane Watch
|
|
Tropical Storm Watch
|
|
Storm Surge Watch
|
|
|
|
------------------------------------------------------------
|
|
4. Advisories
|
|
------------------------------------------------------------
|
|
|
|
Fog Advisory
|
|
Freezing Drizzle Advisory
|
|
Freezing Fog Advisory
|
|
Special Weather Advisory
|
|
Rainfall Advisory
|
|
Snowfall Advisory
|
|
Wind Advisory
|
|
Blowing Snow Advisory
|
|
Marine Fog Advisory
|
|
Freezing Spray Advisory
|
|
|
|
------------------------------------------------------------
|
|
5. Statements and Information Products
|
|
------------------------------------------------------------
|
|
|
|
Weather Statement
|
|
Special Weather Statement
|
|
Air Quality Statement
|
|
Smoke Statement
|
|
Dust Statement
|
|
Temperature Statement
|
|
Tropical Cyclone Information Statement
|
|
Outlook or Long Range Statement
|
|
|
|
------------------------------------------------------------
|
|
6. Air Quality and Wildfire Related Alerts
|
|
------------------------------------------------------------
|
|
|
|
Air Quality Advisory
|
|
Air Quality Statement
|
|
Wildfire Smoke Advisory
|
|
Wildfire Smoke Statement
|
|
Smoke Advisory
|
|
Dust and Smoke Statement
|
|
|
|
------------------------------------------------------------
|
|
7. Marine and Coastal Alerts
|
|
------------------------------------------------------------
|
|
|
|
Gale Warning
|
|
Storm Warning
|
|
Hurricane Force Wind Warning
|
|
Strong Wind Warning
|
|
Freezing Spray Warning
|
|
Squall Warning
|
|
Blizzard Warning Marine
|
|
High Water Level Warning
|
|
Storm Surge Warning
|
|
Wave or Surf Warning
|
|
|
|
------------------------------------------------------------
|
|
8. Arctic and Northern-Specific Alerts
|
|
------------------------------------------------------------
|
|
|
|
Arctic Outflow Warning
|
|
Extreme Cold Warning
|
|
Wind Chill Warning
|
|
Blowing Snow Advisory
|
|
Blizzard Warning
|
|
Freezing Spray Warning
|
|
|
|
------------------------------------------------------------
|
|
9. Rare but Possible Phenomena in Canada
|
|
------------------------------------------------------------
|
|
|
|
Funnel Cloud Advisory
|
|
Waterspout Warning
|
|
Tropical Cyclone Information Statement
|
|
Thunderstorm Outlook or Convective Outlook
|
|
|
|
------------------------------------------------------------
|
|
10. Out of Scope For Now
|
|
------------------------------------------------------------
|
|
|
|
Volcano Warning
|
|
Ashfall Warning
|
|
Lahar Warning
|
|
Lava Flow Warning
|
|
Tsunami Warning or Advisory
|
|
Radiation or Nuclear Incident Warning
|
|
Sandstorm or Haboob Alert
|
|
|
|
If such an event appears in CAP data, Skyfeed will classify it under Other Alert.
|
|
|
|
------------------------------------------------------------
|
|
11. Internal Skyfeed Alert Codes Planned
|
|
------------------------------------------------------------
|
|
|
|
Skyfeed will define internal alert keys, for example
|
|
|
|
tornado_warning
|
|
severe_thunderstorm_warning
|
|
snow_squall_warning
|
|
heat_warning
|
|
fog_advisory
|
|
air_quality_statement
|
|
arctic_outflow_warning
|
|
hurricane_watch
|
|
wildfire_smoke_advisory
|
|
|
|
Each code will map to
|
|
English label
|
|
French label
|
|
Inuktitut label
|
|
Severity
|
|
Colour theme
|
|
Optional long description
|
|
|
|
------------------------------------------------------------
|
|
12. Language and Localisation Notes
|
|
------------------------------------------------------------
|
|
|
|
Supported languages
|
|
en-CA / Canadian English
|
|
fr-CA / Canadian French
|
|
iu-CA / Inuktitut
|
|
|
|
------------------------------------------------------------
|
|
13. Future Work
|
|
------------------------------------------------------------
|
|
|
|
CAP to Skyfeed mapping layer
|
|
Colour and icon system
|
|
Alert grouping rules
|
|
Multi-language rendering
|
|
Per-page prioritisation for Telefact
|
|
|
|
END OF FILE
|
|
|
|
|
|
[FILE: docs/TAXONOMY_WEATHER.md]
|
|
|
|
# Skyfeed Weather Condition Taxonomy
|
|
Version v0.1.0-dev1
|
|
Scope Normalised condition codes for Canada for Skyfeed and Telefact
|
|
|
|
This document defines all base weather conditions, grouped logically, and provides stable internal keys for Skyfeed.
|
|
Translations will be handled separately.
|
|
|
|
------------------------------------------------------------
|
|
1. Skyfeed Condition Structure
|
|
------------------------------------------------------------
|
|
|
|
Each condition has
|
|
A unique internal key
|
|
A short description
|
|
A category
|
|
A suggested icon
|
|
A colour theme mapping
|
|
|
|
Categories are
|
|
Sky conditions
|
|
Precipitation
|
|
Visibility
|
|
Wind
|
|
Arctic or cold-specific
|
|
Thunderstorm and convection
|
|
Smoke and air quality
|
|
Marine
|
|
|
|
------------------------------------------------------------
|
|
2. Sky Conditions
|
|
------------------------------------------------------------
|
|
|
|
clear
|
|
mainly_clear
|
|
partly_cloudy
|
|
mostly_cloudy
|
|
cloudy
|
|
overcast
|
|
sunny_breaks
|
|
cloudy_with_sunny_breaks
|
|
|
|
------------------------------------------------------------
|
|
3. Precipitation Types
|
|
------------------------------------------------------------
|
|
|
|
drizzle
|
|
light_drizzle
|
|
freezing_drizzle
|
|
rain
|
|
light_rain
|
|
heavy_rain
|
|
freezing_rain
|
|
rain_showers
|
|
snow
|
|
light_snow
|
|
heavy_snow
|
|
ice_pellets
|
|
sleet
|
|
mixed_precipitation
|
|
snow_showers
|
|
rain_and_snow
|
|
hail
|
|
graupel
|
|
|
|
------------------------------------------------------------
|
|
4. Visibility and Obscuration
|
|
------------------------------------------------------------
|
|
|
|
fog
|
|
freezing_fog
|
|
mist
|
|
haze
|
|
smoke
|
|
blowing_snow
|
|
drifting_snow
|
|
dust
|
|
sand
|
|
ice_crystals
|
|
|
|
------------------------------------------------------------
|
|
5. Wind and Motion
|
|
------------------------------------------------------------
|
|
|
|
wind_light
|
|
wind_moderate
|
|
wind_strong
|
|
wind_gale
|
|
wind_storm
|
|
wind_hurricane_force
|
|
gusty_winds
|
|
|
|
------------------------------------------------------------
|
|
6. Thunderstorm and Convective Weather
|
|
------------------------------------------------------------
|
|
|
|
thunderstorm
|
|
strong_thunderstorm
|
|
severe_thunderstorm
|
|
thundershowers
|
|
lightning_only
|
|
|
|
------------------------------------------------------------
|
|
7. Arctic and Northern Conditions
|
|
------------------------------------------------------------
|
|
|
|
extreme_cold
|
|
wind_chill
|
|
arctic_outflow
|
|
ice_fog
|
|
polar_low
|
|
freezing_spray
|
|
sea_ice
|
|
blizzard_conditions
|
|
|
|
------------------------------------------------------------
|
|
8. Marine Weather Conditions
|
|
------------------------------------------------------------
|
|
|
|
marine_fog
|
|
marine_freezing_spray
|
|
rough_seas
|
|
high_waves
|
|
storm_surge_conditions
|
|
water_spout
|
|
|
|
------------------------------------------------------------
|
|
9. Special and Rare Conditions
|
|
------------------------------------------------------------
|
|
|
|
funnel_cloud
|
|
volcanic_ash
|
|
ash_in_air
|
|
dust_storm
|
|
smoke_storm
|
|
|
|
------------------------------------------------------------
|
|
10. Normalisation Table Notes
|
|
------------------------------------------------------------
|
|
|
|
Environment Canada condition strings must be mapped into the above keys.
|
|
Examples
|
|
|
|
Mainly Sunny maps to mainly_clear
|
|
A Few Clouds maps to partly_cloudy
|
|
Periods of Rain maps to rain
|
|
Risk of Freezing Rain maps to freezing_rain
|
|
Snow at times heavy maps to heavy_snow
|
|
Ice Crystals maps to ice_crystals
|
|
Local Smoke maps to smoke
|
|
Haze maps to haze
|
|
Mist maps to mist
|
|
Thunderstorms maps to thunderstorm unless severity tag present
|
|
|
|
A complete mapping list will be implemented in internalweathernormalize.go.
|
|
|
|
------------------------------------------------------------
|
|
11. Colour Theme Notes
|
|
------------------------------------------------------------
|
|
|
|
clear primary sky blue and secondary gold
|
|
cloudy light grey to blue-grey
|
|
rain slate blue
|
|
snow white to light grey
|
|
fog mid grey
|
|
smoke brown-grey
|
|
thunderstorm violet purple accents
|
|
arctic cold pale blue and white
|
|
marine deep blue
|
|
|
|
These themes apply to the Skyfeed logo.
|
|
|
|
END OF FILE
|