[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