README Observations Summary in XML Format (Le français suit) ---------------------------------------- ENVIRONMENT AND CLIMATE CHANGE CANADA README file about the provincial and territory summary XML files available on the Meteorological Service of Canada's HTTP data server. To read this file online, please go to: http://dd.weather.ec.gc.ca/observations/doc/README_observations.txt Files are produced or distributed by Environment and Climate Change Canada: http://ec.gc.ca/ ------------------------------------------------------- Edition of 2017-07-18 ------------------------------------------------------- In this file: * About * License * Download * Datawire * Description ** Type of files ** Stations ** Data * Filename ** Directory ** File * External documentation * Contact Us ############################################## ### About ### ############################################## This document explains the Hourly, Current day and Yesterday XML observations files that are produced for each the Canadian provinces and territories. The overarching README file of the datamart itself can be found here: http://dd.weather.ec.gc.ca/about_dd_apropos.txt ############################################## ### License ### ############################################## For the terms of use and conditions of the provincial summary XML files created by Environment and Climate Change Canada, see the general datamart license at: http://dd.weather.ec.gc.ca/doc/LICENCE_GENERAL.txt ############################################### ### Download ### ############################################### The provincial summary XML files are available at the following address: http://dd.weather.ec.gc.ca/observations/xml/ A history of data (30 days) is kept in the directory. ############################################## ### Data Wire ### ############################################## To facilitate the retrieval of timely data on the Datamart, the Meteorological Service of Canada (MSC) has set up a data wire for announcing file availability on the Datamart. This data wire uses the 'Advanced Message Queuing Protocol' (AMQP) protocol. Not only does this enable the user to be notified of available products as they're published, but also to receive them automatically. The service may apply to a specific set of files (weather warnings, observations, model data, etc.) and thus may concern only those products of interest to the user. The documentation about this service can be found here: http://dd.weather.gc.ca/doc/README_AMQP.txt ################################################ ### Description ### ################################################ The provincial and territory summary pages provide the observations of all available stations for the selected province or territory. Data is made available through a number of sources and may not be QA/QC. The files are in XML format and follow an Environment and Climate Change Canada defined schema. Update frequency of XML files will be generated as follows: * Hourly - every 5 minutes * Today - every 5 minutes * Yesterday - twice per day at 06:30 UTC and 08:00 UTC There are 6 XML files for each province/territory as follows: * English and French for Hourly Provincial Summary * English and French for Today's Provincial Summary * English and French for Yesterday's Provincial Summary ------------------------------------------------------- Type of files ------------------------------------------------------- 1- Hourly summary The Hourly summary contains the most recent observations available. This file is regenerated at 8, 11, 14, 25, 35 and 50 minutes past each hour. The file is overwritten by every new version, until the last one created. The last one remaining on the server is the last created within the hour indicated in the file name, i.e. at 50 minutes. For every hour, a file is then kept for 30 days on the server. If current data is missing, use the previous hour's data temporarily. Hourly observation data will be set to blank if it hasn't been updated within 2 hours and 15 minutes. These observations have QA/QC applied to them. Any values that do not pass QA/QC will be suppressed. This includes values that are flagged as doubtful. Parameters contained in each file for the selected province or territory are: * This Hour's Hot and Cold spots for Canada * This Hour's Hot and Cold spots for the selected province/territory * The current hour observations for each station available. It contains: ** Present Condition (string) ** Mean sea level pressure (kPa) ** Value of pressure tendency (kPa) ** Pressure tendency (rising, falling, stable) ** Visibility (km) ** Air temperature (°C) ** Dew point (°C) ** Relative humidity (%) ** Wind speed (km/h) ** Wind direction (code) ** Gust speed (km/h) ** Cloud cover ** Wind chill ** Humidex 2- Today's summary Today's summary is generated at 8, 11, 14, 25, 35 and 50 minutes past each hour. The file is overwritten by every new version, until the last one created. The last one remaining on the server is the last created within the day indicated in the file name. For every day, a file is kept for 30 days on the server. Depending on the time of day, the data is obtained from either hourly data or synoptic data. If obtained from hourly data, QA/QC is applied. If obtained from synoptic data, QA/QC is not applied. For example, on March 9 at 14:40 UTC, the today's observations file would contain the observations for the day starting on March 9 at 06 UTC and ending on March 9 at 14:40 UTC. Today's component starts to accumulate the high/lows for each station at the start of the climate day (06Z each day). At 06Z each day the daily products high/lows are reset, then with each passing hour it accumulates the data, and generates the high and low from the start of the climate day. Some stations only report during day time, so they don't have any value before the first hour of observation. This file contains for the selected province or territory: * Today so far Hot and Cold spots for Canada * Today so far Hot and Cold spots for the selected province/territory * The observations and records for each station available: ** Maximum air temperature for today (°C) ** Minimum air temperature for today (°C) ** Wind direction of the peak wind (code) ** Peak gust speed so far in the day (km/h) ** Record value for maximum air temperature (°C) ** Year of the record value for maximum air temperature ** Record value for minimum air temperature (°C) ** Year of the record value for minimum air temperature ** Record value for rain precipitation (mm) ** Year of the record value for rain precipitation ** Record value for snow precipitation (cm) ** Year of the record value for snow precipitation ** Year from which this station acquired temperature data ** Year from which this station acquired precipitation data 3- Yesterday's summary Yesterday's summary is defined as the summary for the most recently completed climate day. A climate day goes from 06 UTC to 06 UTC. This product is based on the 06 UTC SYNO bulletins produced for each station. The data does not undergo QA/QC. Please refer to the climatological official data sets for that (see URL in 'External documentation' section below). Some stations have observations but do not have a SYNO bulletins. These stations will be included in the 'hourly' and 'today' products but not in 'yesterday'. Yesterday's summary is generated at 8, 11, 14, 25, 35 and 50 minutes past each hour. The file is overwritten by every new version, until the last one created. The last one remaining on the server is the last created within the day indicated in the file name. For every day, a file is kept for 30 days on the server. This file provides a list of all available stations for the selected province/territory displaying: * Yesterday's Hot and Cold spots for Canada * Yesterday's Hot and Cold spots for the selected province/territory * Yesterday's record values for highest and lowest temperature, rain and snow amount for each station available * Yesterday's values for highest and lowest temperature, peak wind, total precipitation, rain and snow amount for each station available ------------------------------------------------------- Stations ------------------------------------------------------- For each station, the following information is provided: * Station name * Latitude (decimal degree) * Longitude (decimal (degree) * Transport Canada identification number * Observations time in UTC and local time * Climate station number * WMO station number There are in excess of 500 observation stations in Canada. However this number is continually changing. Stations only appear if data is available for that station. ------------------------------------------------------- Note about the data ------------------------------------------------------- * To be displayed, any record for an element must have a period of at least 15 years in the Climate Site database, as stated on the Climate Site : http://www.climate.weatheroffice.gc.ca/Welcome_e.html * Station Metadata is provided in English or French * Any floating values that are below 0.05 are rounded to 0.0 * Any floating values that are 0.05 and above are rounded up to 0.1 * The creation date of the file is included in the header of each XML file * ISO 8601 standard is used for all time/date formats * All date/time are both in UTC and local time * Historical data (record data) has undergone QA/QC procedures Complete documentation of the Meteorological Point Observation Mark-up Language Schema Description V2 can be found at this address: http://dd.weather.gc.ca/observations/doc/Met-ML-SchemaDescriptionV2_e.pdf ############################################### ### Filename ### ############################################### The provincial and territorial summary XML files are grouped in a directory tree that is based on the province/territory and the summary type. 1- The directories have the following nomenclature: /observations/xml/PC/TYPE where: * PC is a 2 letter provincial or territorial code indicating the area covered by the observations. The code is one of the 13 following values: ** AB (Alberta) ** BC (British Columbia) ** MB (Manitoba) ** NB (New Brunswick) ** NL (Newfoundland and Labrador) ** NS (Nova Scotia) ** NT (Northwest Territories) ** NU (Nunavut) ** ON (Ontario) ** PE (Prince Edward Island) ** QC (Québec) ** SK (Saskatchewan) ** YT (Yukon) * TYPE: string indicating the summary type. Could be one of those 3 types: [hourly | today | yesterday]. See Description below for more information. 2- The file names have the following nomenclature: TYPE_PC_YYYYMMDD_L.xml where: * TYPE: string indicating the summary type. Could be one of those 3 types: [hourly | today | yesterday]. See Description below for more information. * PC: indicates the 2 letter provincial code in lower case. See section 1 above for the values. * YYYYMMDDHH: Observations date. HH is present only in 'hourly' product type. * L: 1 letter indicating the language of the file. Can be one of the values: ** f (French) ** e (English) Examples of file name: * hourly_ab_2010030517_e.xml * today_mb_20100306_e.xml * yesterday_qc_20100306_f.xml ############################################### ### External documentation ### ############################################### Documentation about Automated Weather Observation System (AWOS): http://www.msc-smc.ec.gc.ca/msb/manuals/awos/toc_e.html Complete documentation of the Meteorological Point Observation Mark-up Language Schema Description V2 can be found at this address: http://dd.weather.ec.gc.ca/observations/doc/MPO-ML- SchemaDescriptionV2_e.pdf OpenGIS: Observations and Measurements Standards http://www.opengeospatial.org/standards/om WeatherOffice FAQ: provides general weather and climate information http://www.weatheroffice.gc.ca/mainmenu/faq_e.html Historical climate data is available at: http://climate.weatheroffice.gc.ca/Welcome_e.html Synoptic and METAR bulletins can also be found on the MSC HTTP data server. See the documentation here: http://dd.weather.ec.gc.ca/bulletins/doc/README_bulletins.txt ############################################### ### Contact Us ### ############################################### If you use the data available on the datamart, you are invited to subscribe to the datamart's mailing list in order to be warned of any updates or changes regarding the data available. You can subscribe here: http://lists.cmc.ec.gc.ca/mailman/listinfo/dd_info Please use the following address to contact us for any comments or questions: ec.dps-client.ec@canada.ca ---------------------------------------- README Sommaire des observations en format XML ENVIRONNEMENT ET CHANGEMENT CLIMATIQUE CANADA Fichier README à propos des sommaires d'observations des provinces et des territoires en format XML disponible sur le serveur de données HTTP du Service météorologique du Canada. Pour lire ce fichier en ligne, veuillez aller à: http://dd.weather.ec.gc.ca/observations/doc/README_observations.txt Les fichiers sont produits ou distribués par Environnement et changement climatique Canada: http://ec.gc.ca/ ------------------------------------------------------- Version du 2017-07-18 ------------------------------------------------------- Dans ce fichier: * Résumé * Licence * Téléchargement * Fil de données * Description ** Type de fichiers ** Stations ** Données * Nom de fichier ** Répertoire ** Fichier * Documentation externe * Pour nous joindre ################### ### Résumé ### ################### Ce document explique ce que sont les fichiers des sommaires d'observations horaires, pour aujourd'hui et hier, pour les provinces et les territoires du Canada. Le fichier README global pour le datamart peut être trouvé ici: http://dd.weather.gc.ca/about_dd_apropos.txt ############################################## ### Licence ### ############################################## Pour les conditions d'utilisation pour les bulletins créés par Environnement et changement climatique Canada, veuillez consulter les conditions générales d'utilisation des données du datamart: http://dd.weather.gc.ca/doc/LICENCE_GENERAL.txt ############################################### ### Téléchargement ### ############################################### Les bulletins sont disponibles à cette adresse: http://dd.weather.gc.ca/observations/xml/ Un historique des données (30 jours) est conservé dans ce répertoire. ############################################## ### Fil de données ### ############################################## Afin de faciliter l'obtention en temps opportun des données du Datamart, le Service météorologique du Canada (SMC) a mis en place un fil de données annonçant les fichiers disponibles sur le Datamart. Ce fil de données utilise le protocole ''Advanced Message Queuing Protocol'' (AMQP). Il devient ainsi possible non seulement d'être avisé de la disponibilité des produits sur le Datamart lorsque ceux-ci sont publiés, mais aussi de les recevoir automatiquement. Le service peut s'appliquer à une série spécifique de fichiers (alertes météorologiques, observations, données de modèle, etc.) et ainsi viser seulement les produits d'intérêt pour l'usager. La documentation de ce service est disponible ici: http://dd.weather.gc.ca/doc/README_AMQP.txt ################################################ ### Description ### ################################################ Les fichiers des sommaires d'observations contiennent les observations de toutes les stations météorologiques du Canada disponibles, regroupées par province ou territoire. Les données sont obtenues de plusieurs manières et peuvent ne pas avoir subi de contrôle de qualité. Les fichiers sont dans le format XML et suivent un schéma défini par Environnement et changement climatique Canada. Il y a 6 types de fichiers pour chaque province ou territoire: * Sommaire horaire en anglais et en français; * Sommaire de la journée courante en anglais et en français; * Sommaire d'hier en anglais et en français. ------------------------------------------------------- Types de fichiers ------------------------------------------------------- 1- Sommaire horaire ('hourly') Le sommaire horaire contient les observations les plus récentes qui sont disponibles. Ce fichier est créé aux minutes 8, 11, 14, 25, 35 et 50, après l'heure. Le fichier du sommaire horaire est écrasé par une nouvelle version à chaque fois qu'un nouveau est créé pendant cette heure. Celui qui demeure sur le serveur a été le dernier créé dans l'heure inscrite dans le nom de fichier, soit celui à 50 minutes. Chaque fichier horaire est par la suite conservé pour 30 jours sur le serveur. Lorsque les données sont manquantes, les observations de la dernière heure sont utilisées. Les champs horaires sont laissés vides s'il n'y a eu aucune mise à jour durant 2 heures 15 minutes. Ces données d'observations font l'objet d'un contrôle de qualité. Toute valeur qui ne passe pas pas le contrôle de qualité est supprimée. Ceci inclus les valeurs qui sont catégorisées comme douteuses. Ce fichier contient pour la province ou le territoire: * L'endroit et la température la plus froide au Canada pour cette heure; * L'endroit et la température la plus chaude au Canada pour cette heure; * L'endroit et la température la plus froide dans la province ou le territoire pour cette heure; * L'endroit et la température la plus chaude dans la province pour le territoire pour cette heure; * Les observations et les records des stations disponibles dans cette province: ** Condition présente (expression) ** Pression au niveau de la mer (kPa) ** Valeur de la tendance de pression (kPa) ** Tendance de pression (à la hausse, à la baisse, ou stable) ** Visibilité (km) ** Température de l'air (°C) ** Point de rosée (°C) ** Humidité relative (%) ** Vitesse du vent (km/h) ** Direction du vent (code) ** Vitesse de rafale (km/h) ** Couverture nuageuse ** Refroidissement éolien ** Humidex 2- Sommaire pour aujourd'hui ('today') Le sommaire pour aujourd'hui est produit aux minutes 8, 11, 14, 25, 35 et 50 après chaque heure. Le fichier est écrasé par la nouvelle version jusqu'à ce que le dernier fichier soir créé. Le dernier demeurant sur le serveur est celui créé pendant le jour inscrit dans le nom de fichier. Pour chaque jour, le dernier fichier créé est conservé pour les 30 prochains jours. Selon la période de la journée, les données sont obtenues soit à partir des données horaires, soit à partir des données synoptiques. Si obtenu à partir des données horaires, un contrôle de qualité est appliqué. Si obtenu à partir des données synoptiques, aucun contrôle de qualité n'est appliqué. Par exemple, le 9 mars à 14:40 UTC, le fichier pour les observations d'aujourd'hui contiendrait les observations débutant le 9 mars à 06 UTC et terminant à 14:40 UTC. Le sommaire pour aujourd'hui commence à accumuler les max/min pour chaque station au début de la journée climatologique (06 UTC). Comme à 06Z de chaque jour un nouveau fichier est créé, les min/max de ce fichier sont réinitialisés et, pendant les heures suivantes, les données sont accumulées pour générer les min/max pour cette journée climatique. Comme certaines stations ne rapportent que pendant certaines heures de la journée, les valeurs pour ces stations sont parfois vides au début de la journée climatique. Ce fichier contient pour la province ou le territoire: * L'endroit et la température la plus froide au Canada jusqu'à maintenant pour ce jour climatique; * L'endroit et la température la plus chaude au Canada jusqu'à maintenant pour ce jour climatique; * L'endroit et la température la plus froide dans la province ou le territoire jusqu'à maintenant pour ce jour climatique; * L'endroit et la température la plus chaude dans la province ou le territoire le territoire jusqu'à maintenant pour ce jour climatique; * Les observations des stations disponibles dans cette province ou ce territoire. Les observations contiennent pour chaque station: ** Température de l'air maximale pour aujourd'hui (°C) ** Température de l'air minimale pour aujourd'hui (°C) ** Direction du vent (code) ** Vitesse de rafale (km/h) ** Température de l'air maximale record (°C) ** Année du record pour la température de l'air maximale ** Température de l'air minimale record (°C) ** Année du record pour la température de l'air minimale ** Précipitation record de pluie (mm) ** Année de la précipitation record de pluie ** Précipitation record de neige (cm) ** Année de la précipitation record de neige ** Année à partir de laquelle la station à des données de température ** Année à partir de laquelle la station à des données de précipitation 3- Sommaire pour hier ('yesterday') Les observations pour la journée d'hier sont définies comme celles faites pendant la dernière journée climatique complète, soit de 06 UTC à 06 UTC. Ce produit est basé sur les bulletins syoptiques à 06h UTC produits pour chaque station. Ces données ne subissent pas de contrôle de qualité. Veuillez alors consulter les jeux de données climatologiques officiels (voir l'URL dans la section "Documentation externe"). Certaines stations ont des observations mais n'ont pas de bulletins SYNO. Ces stations seront incluses dans les sommaires horaires ('hourly') et les sommaires pour la journée d'aujourd'hui ('today') mais pas dans ceux de la journée d'hier ('yesterday') Le sommaire de la journée d'hier est produit aux minutes 8, 11, 14, 25, 35 et 50 après chaque heure. Le fichier est écrasé par la nouvelle version jusqu'à ce que le dernier fichier soir créé. Le dernier demeurant sur le serveur est le dernier créé pendant le jour inscrit dans le nom de fichier. Pour chaque jour, le dernier fichier créé est conservé pour les 30 prochains jours. * L'endroit et la température la plus froide au Canada pour la journée climatique d'hier; * L'endroit et la température la plus chaude au Canada pour la journée climatique d'hier; * L'endroit et la température la plus froide dans la province ou le territoire pour la journée climatique d'hier; * L'endroit et la température la plus chaude dans la province ou dans le territoire pour la journée climatique d'hier; * Les observations des stations disponibles dans cette province ou ce territoire pour la journée climatique d'hier. Les observations contiennent pour chaque station: ** Température de l'air maximale (°C) ** Température de l'air minimale (°C) ** Direction du vent maximal (code) ** Vitesse de vent maximale (km/h) (certaines stations seulement) ** Température de l'air maximale record (°C) ** Année du record pour la température de l'air maximale ** Température de l'air minimale record (°C) ** Année du record pour la température de l'air minimale ** Précipitation record de pluie (mm) ** Année de la précipitation record de pluie ** Précipitation record de neige (cm) ** Année de la précipitation record de neige ** Année à partir de laquelle la station à des données de température ** Année à partir de laquelle la station à des données de précipitation ------------------------------------------------------- Stations ------------------------------------------------------- Pour chaque station, les informations suivantes sont inscrites: * Nom de la station * Latitude (degré décimal) * Longitude (degré décimal) * Numéro d'identification de Transport Canada * Les heures des observations sont en temps UTC et en heure locale * Numéro de station climatique * Numéro de station OMM Il y a plus de 500 stations d'observation au Canada. Cependant, ce nombre est en constante évolution. Les stations sont présentes dans les fichiers seulement si des données d'observations sont disponibles. ------------------------------------------------------- Notes sur les données ------------------------------------------------------- * Pour qu'un record soit affiché, il doit y avoir au moins 15 années de données dans la base de données des archives climatiques tel que mentionné sur leur site: http://www.climate.weatheroffice.gc.ca/Welcome_f.html * Les métadonnées des stations sont fournies en anglais ou en français. * Toute valeur inférieure à 0,05 est arrondie à 0,0 * Toute valeur entre 0,05 et 0,1 est arrondie à 0,1 * La date de création est inscrite dans l'en-tête de chaque fichier * Le standard ISO 8601 est utilisé pour toutes les dates et les heures * Toutes les dates et les heures sont données en heure UTC et locale * Les données historiques (les records) ont toutes subi un contrôle de qualité. ############################################## ### Noms de fichier ### ############################################## Les fichiers XML du sommaire des observations des provinces ou des territoires sont regroupés dans une structure de répertoires basée sur la province/territoire et le type de sommaire. 1- Les répertoires suivent cette nomenclature: /observations/xml/PC/TYPE où: * PC: code de 2 lettres pour la province ou le territoire couvert par ces observations. Ce code peut prendre une de ces 13 valeurs: ** AB (Alberta) ** BC (Colombie-Britannique) ** MB (Manitoba) ** NB (Nouveau-Brunswick) ** NL (Terre-Neuve-et-Labrador) ** NS (Nouvelle-Écosse) ** NT (Territoires du Nord-Ouest) ** NU (Nunavut) ** ON (Ontario) ** PE (Île-du-Prince-Édouard) ** QC (Québec) ** SK (Saskatchewan) ** YT (Yukon) * TYPE: chaîne de caractères indiquant le type de sommaire. Peut prendre l'une de ces 3 valeurs [hourly | today | yesterday]. Voir la section "Description" plus bas pour une description de chaque type. 2- Les noms de fichiers suivant cette nomenclature: TYPE_PC_YYYYMMDD_L.xml où: * TYPE: chaîne de caractères indiquant le type de sommaire. Peut prendre l'une de ces 3 valeurs [hourly | today | yesterday]. Voir la section "Description" plus bas pour une description de chaque type. * PC: code de 2 lettres pour la indiquant la province ou le territoire couvert par ces observations. Voir la section 1 pour les valeurs possibles. * YYYYMMDDHH: Date des observations. L'heure représentée par 'HH' n'est présente que dans le cas des fichiers horaires ('hourly'). * L: 1 lettre indiquant la langue du fichier. Peut-être une de ces valeurs: ** f (français) ** e (anglais) Exemples de nom de fichier: * hourly_ab_2010030517_e.xml * today_mb_20100306_e.xml * yesterday_qc_20100306_f.xml ############################################### ### Documentation externe ### ############################################### Documentation sur les systèmes d'observation météorologique automatisée (AWOS): http://www.msc-smc.ec.gc.ca/msb/manuals/awos/toc_f.html Documentation complète pour la description XML de point d'observation météorologique: http://dd.weather.gc.ca/observations/doc/Met-ML-SchemaDescriptionV2_f.pdf OpenGIS: Standards pour les observations et les mesures (anglais): http://www.opengeospatial.org/standards/om Foire aux questions du service météo d'Environnement et changement climatique Canada. Information diverse à propos de la météorologie et de la climatologie: http://www.weatheroffice.gc.ca/mainmenu/faq_f.html Les données climatiques historiques sont disponibles sur ce site: http://climate.weatheroffice.gc.ca/Welcome_f.html Les bulletins synoptiques et METAR peuvent aussi être trouvés sur le serveur HTTP de données du MSC. Voir la documentation ici: http://dd.weather.gc.ca/bulletins/doc/README_bulletins.txt ############################################## ### Pour nous joindre ### ############################################## Si vous utilisez les données disponibles sur le datamart, vous êtes invités à vous inscrire à la liste de diffusion du datamart afin d'être avertis de tout changement ou mise à jour sur les données disponibles. Vous pouvez vous inscrire ici http://lists.cmc.ec.gc.ca/mailman/listinfo/dd_info Veuillez utiliser l'adresse courriel suivante pour nous contacter afin de nous faire part de tous commentaires ou questions : ec.dps-client.ec@canada.ca