9.0 KiB
[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.
- 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
- 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
- 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
- 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
- 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
- Air Quality and Wildfire Related Alerts
Air Quality Advisory Air Quality Statement Wildfire Smoke Advisory Wildfire Smoke Statement Smoke Advisory Dust and Smoke Statement
- 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
- Arctic and Northern-Specific Alerts
Arctic Outflow Warning Extreme Cold Warning Wind Chill Warning Blowing Snow Advisory Blizzard Warning Freezing Spray Warning
- Rare but Possible Phenomena in Canada
Funnel Cloud Advisory Waterspout Warning Tropical Cyclone Information Statement Thunderstorm Outlook or Convective Outlook
- 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.
- 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
- Language and Localisation Notes
Supported languages en-CA / Canadian English fr-CA / Canadian French iu-CA / Inuktitut
- 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.
- 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
- Sky Conditions
clear mainly_clear partly_cloudy mostly_cloudy cloudy overcast sunny_breaks cloudy_with_sunny_breaks
- 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
- Visibility and Obscuration
fog freezing_fog mist haze smoke blowing_snow drifting_snow dust sand ice_crystals
- Wind and Motion
wind_light wind_moderate wind_strong wind_gale wind_storm wind_hurricane_force gusty_winds
- Thunderstorm and Convective Weather
thunderstorm strong_thunderstorm severe_thunderstorm thundershowers lightning_only
- Arctic and Northern Conditions
extreme_cold wind_chill arctic_outflow ice_fog polar_low freezing_spray sea_ice blizzard_conditions
- Marine Weather Conditions
marine_fog marine_freezing_spray rough_seas high_waves storm_surge_conditions water_spout
- Special and Rare Conditions
funnel_cloud volcanic_ash ash_in_air dust_storm smoke_storm
- 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.
- 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