README NAEFS XML / SPENA XML (Le français suit) ---------------------------------------- ENVIRONMENT CANADA README file about North American ensemble forecast system (NAEFS) data in XML format available on the Meteorological Service of Canada's HTTP data server. For more information about the NAEFS ensemble system, please consult the following web site: http://www.weatheroffice.gc.ca/ensemble/naefs/index_e.html To read this file online, please go to: http://dd.weatheroffice.ec.gc.ca/ensemble/doc/naefs/README_naefs-spena_xml.txt Files are produced by Environment Canada: http://ec.gc.ca/ ------------------------------------------------------- Edition of 2010-10-27 ------------------------------------------------------- In this file: * About * License * Download * Directories and File Name * Variables List * Models List * File Content * Available Locations * Contact Us ###################### ### About ### ###################### This document explains how to decode the XML files containing the NAEFS ensemble forecast data available on the datamart under the directory: http://dd.weatheroffice.ec.gc.ca/ensemble/naefs/xml The overarching README file of the datamart itself can be found here: http://dd.weatheroffice.ec.gc.ca/about_dd_apropos.txt ############################################## ### License ### ############################################## For the terms of use and conditions of data created and owned by Environment Canada, see the general datamart license at: http://dd.weatheroffice.ec.gc.ca/doc/LICENCE_GENERAL.txt ############################################### ### Download ### ############################################### The NAEFS XML files are available at the following address: http://dd.weatheroffice.ec.gc.ca/ensemble/naefs/xml/ A history of 30 days of forecast is kept in this directory. ###################################################### ### Directories and File Name ### ###################################################### == Directory Structure == The files are grouped in a directory tree that is based on the date and the variable contained in the XML files. The directories have the following nomenclature: http://dd.weatheroffice.ec.gc.ca/ensemble/naefs/xml/AAAAMMJJ/ZZ/VARIABLE/TYPE where: * AAAAMMJJ: forecast integration date, year (YYYY), month (MM) and day (DD) * ZZ: forecast integration time in UTC. Can be '00' or '12' * VARIABLE: variable in the XML files in the directory. Refer to the 'Variable List' section below for a complete list. * TYPE : data type. Currently, only the direct model output ('raw') are available. Example: for the 12Z forecast on May 7th 2010, the raw data for the surface wind speed will be in this directory http://dd.weatheroffice.ec.gc.ca/ensemble/naefs/xml/20100507/12/WIND-SFC/raw/ == File name description == The file name follows this nomenclature: AAAAMMJJHH_GEPS-NAEFS-TYPE_LOCATION_PROVSTATE_COUNTRY_VAR_START-END.xml.bz2 where: * AAAA : forecast year, 4 digit; * MM : forecast month, 2 digit (January = 01); * JJ : forecast day, 2 digit; * HH : integration time, 2 digit (00 or 12 - representing UTC time); * GEPS-NAEFS: constant string indicating the GEM model (GEPS) for the EPSgrams in the scope of the NAEFS project. * TYPE: Can take the value 'RAW' for raw data model or 'BC' for bias corrected data (currently only RAW is available) * LOCATION : Location name for the given forecast. * PROVSTATE : Location province (Canada) or State (USA, Mexico). 2 characters code. For other countries, the code 'XX' is used. You can download the code correspondence list here: http://www.state.ia.us/tax/forms/84055.pdf * COUNTRY : Location country for the emitted forecast. CA=Canada, US=USA, MX=Mexico, etc. For a complete list, refer to the « Country list » section a the end of this file * VAR : Variables. See the following section for a complete list. * START : Interval start time (in hours after the forecast start time) for which the forecast is emitted. * END : Interval end time (in hours after the forecast start time) for which the forecast is emitted. Note: All time are in UTC. Example: 2010051000_GEPS-NAEFS-RAW_LONDON_ON_CA_MSLP_000-384.xml.bz2 This file contains models data for the date of May 10th 2010 at 00UTC(2010051000), in raw format (RAW) for the city of London (LONDON) in Ontario (ON), Canada (CA). The mean sea level pressure (MSLP) will be contained in this file for the first 384 hours of forecast (000-384). This is an XML files (xml) compressed using bzip algorithm (bz2). The complete URL would be: http://dd.weatheroffice.ec.gc.ca/ensemble/naefs/xml/20100507/00/MSLP/raw/2010050700_GEPS-NAEFS-RAW_LONDON_ON_CA_MSLP_000-384.xml.bz2 ##################################### ### Variable List ### ##################################### The XML files are produced for 10 variables: * Mean Sea level Pressure (MSLP) * Accumulated Precipitation at the Surface (APCP-SFC) * Total Cloud Cover (TCDC) * Wind Speed at 200 hPa (WIND-200HPA) * Geopotential Height at 500 hPa (HGT-500HPA) * Thicknesses 1000-500 (LAYER-1000-500HPA) * Surface Air Temperature (TMP-SFC) * Surface Relative Humidity (RELH-SFC) * Surface Wind Speed (WIND-SFC) * Surface Wind Direction (WDIR-SFC) You can find a list in XML format containing the information for all the variables. It contains the name of the associated directory and a description and the units in both French and English. The list can be found here: http://dd.weatheroffice.ec.gc.ca/ensemble/doc/naefs/elements.xml ################################################################# ### Models List ### ################################################################# A list in XML format with the French and English description of all the available members can be found here: http://dd.weatheroffice.ec.gc.ca/ensemble/doc/naefs/members.xml ###################################################### ### File Content ### ###################################################### The XML files have been compressed with the bzip2 algorithm. To decompress them, you can use the bunzip2 software (GNU/Linux, Mac OS X) or 7-zip (Windows). They are encoded in UTF-8 format. Each file is made of a header containing the information about the location, the date and time of the beginning and end of each forecast, the variable in the file, the unit used to represent it and the date and time of the file creation. Then follows the forecast blocks (). Each forecast section corresponds to a specific forecast hour. Each forecast contains a series of models (), containing the variable values for each model at this time (see the Models List in the last section). Note: Some models do not have a forecast at specific hours. The file content looks like:
XXXXXXXX XXXXXXXX ... XXXXXXXXXXX
XXX ... XXX XXX ... ... ###################################################### ### Available Locations ### ###################################################### The XML output of the NAEFS ensemble forecasts are interpolated from grid points of the forecast at the latitude-longitude coordinates from 540 locations: * 273 in Canada; * 137 in United States; * 74 in Mexico; * 56 in the tropics and Greenland. You can find locations list in XML format containing: * Location name; * State or province; * Country name; * Codes, when applicable: NAEFS, WMO, IATA, ICAO; * Longitude, latitude and altitude (note that altitude is not available for some locations) This list can be found at this address: http://dd.weatheroffice.ec.gc.ca/ensemble/doc/naefs/locations.xml The correspondence for the 2 letter codes between the Provinces or States can be found in this PDF document: http://www.state.ia.us/tax/forms/84055.pdf ################################################ ### Contact Us ### ################################################ If you use the data available on the datamart, please register to the datamart diffusion list so you would be advise of any change on the available data. You can register here: http://lists.cmc.ec.gc.ca/mailman/listinfo/dd_info To contact us, send an email to: dd_info@lists.ec.gc.ca ---------------------------------------- ENVIRONNEMENT CANADA Fichier README sur les données en format XML du système de prévisions d'ensemble Nord-Américain (SPENA) disponible sur le serveur de données HTTP du Service météorologique du Canada. Pour plus d'information sur les prévisions d'ensemble SPENA, consulter l'adresse suivante: http://www.weatheroffice.gc.ca/ensemble/naefs/index_f.html Pour consulter ce fichier en ligne, allez à: http://dd.weatheroffice.ec.gc.ca/ensemble/doc/naefs/README_naefs-spena_xml.txt Les fichiers sont produits et distribués par Environnement Canada: http://ec.gc.ca/ ------------------------------------------------------- Version du 2010-10-27 ------------------------------------------------------- Dans ce fichier * À propos * Licence * Téléchargement * Noms et répertoires des fichiers * Liste des variables * Liste des modèles * Contenu des fichiers * Emplacements disponibles * Pour nous joindre * Liste des pays ######################## ### À propos ### ######################## Ce document décrit comment décoder les fichiers XML pour les prévisions d'ensemble SPENA disponibles sur le serveur de données HTTP du SMC sous le répertoire: http://dd.weatheroffice.ec.gc.ca/ensemble/naefs/xml Le fichier README global pour le datamart peut être trouvé ici: http://dd.weatheroffice.ec.gc.ca/about_dd_apropos.txt ############################################## ### Licence ### ############################################## Pour les conditions d'utilisation de ces données créées par Environnement Canada, veuillez consulter les conditions générales d'utilisation des données du datamart: http://dd.weatheroffice.ec.gc.ca/doc/LICENCE_GENERAL.txt ############################################### ### Téléchargement ### ############################################### Les fichiers XML de SPENA se trouvent à l'adresse suivante: http://dd.weatheroffice.ec.gc.ca/ensemble/naefs/xml Un historique de 30 jours de prévisions est conservé dans ce répertoire. ################################################### ### Noms et répertoires des fichiers ### ################################################### == Structure des répertoires == La structure des répertoires est basée sur la date d'intégration et la variable contenu dans les fichiers XML. Ils suivent la nomenclature suivante: http://dd.weatheroffice.ec.gc.ca/ensemble/naefs/xml/AAAAMMJJ/ZZ/VARIABLE/TYPE où: * AAAAMMJJ: date du début d'intégration de la prévision * ZZ: heure UTC d'intégration de la prévision. Peut être '00' ou '12' * VARIABLE: élément du temps dans ce répertoire. Voir la section 'Liste des variables' plus bas pour la liste complète des variables. * TYPE : type de données. Pour l'instant, seules les sorties directes de modèles sont disponibles ('raw'). Exemple: pour la prévision à 12Z du 7 mai 2010, les données bruts (raw) pour la vitesse du vent à la surface de seront dans le répertoire: http://dd.weatheroffice.ec.gc.ca/ensemble/naefs/xml/20100507/12/WIND-SFC/raw == Descriptions des noms de fichiers == Le nom de fichier suit cette nomenclature: AAAAMMJJHH_GEPS-NAEFS-TYPE_EMPLACEMENT_PROVETAT_PAYS_VAR_DEB-FIN.xml.bz2 où: * AAAA : année de la prévision, 4 chiffres; * MM : mois de la prévision, 2 chiffres (janvier = 01); * JJ : jour de prévision, 2 chiffres; * HH : heure du début la prévision, 2 chiffres (00 ou 12 - représentant l'heure en UTC); * GEPS-NAEFS: un chaîne de caractères constantes qui indique le modèle GEM pour les EPSgramme (GEPS) dans le cadre du projets SPENA (en anglais, l'acronyme est NAEFS) * TYPE: Peut prendre la valeur 'RAW' (brute) pour les données brutes du modèle ou 'BC' pour les données débiaisées. (présentement seul RAW est disponible) * EMPLACEMENT : Nom de l'emplacement pour lequel la prévision est émise. * PROVETAT : Province (Canada) ou État (États-Unis, Mexique) de l'emplacement pour lequel la prévision est émise. Code de 2 lettres. Pour les autres pays le code 'XX' est utilisé. Vous pouvez télécharger la liste anglaise de correspondance des codes ici: http://www.state.ia.us/tax/forms/84055.pdf * PAYS : Pays de l'emplacement pour lequel la prévision est émise. CA=Canada, US=États-Unis, MX=Mexique, etc. Pour une liste complète des pays, voir la section « Liste des pays » à la fin de ce fichier. * VAR : Variables (voir section suivante pour la liste) * DEB : Début de l'intervalle (en heures après la date de prévision) pour lequel des prévisions sont émises. * FIN : Fin de l'intervalle (en heures après la date de prévision) pour lequel des prévisions sont émises. Note: Toutes les heures sont en UTC. Exemple: 2010051000_GEPS-NAEFS-RAW_LONDON_ON_CA_MSLP_000-384.xml.bz2 Ce fichier représente les données des modèles pour la date du 10 mai 2010 à 00UTC (2010051000), en format brut (RAW) pour la ville de London (LONDON) en Ontario (ON) au Canada (CA). On y retrouvera les valeurs pour la pression au niveau de la mer (MSLP) pour les 384 premières heures de prévisions (000-384). C'est un fichier XML (xml) compressé à l'aide de l'algorithme bzip2 (bz2). Exemple d'URL pour un fichier sur internet: http://dd.weatheroffice.ec.gc.ca/ensemble/naefs/xml/20100507/00/MSLP/raw/2010050700_GEPS-NAEFS-RAW_LONDON_ON_CA_MSLP_000-384.xml.bz2 ################################################################# ### Liste des variables ### ################################################################# Les fichiers XML sont produits pour 10 variables: * Pression moyenne au niveau de la mer (MSLP) * Accumulation totale de précipitation à la surface (APCP-SFC) * Couvert nuageux total (TCDC) * Vitesse du vent à 200 hpa (WIND-200HPA) * Hauteur géopotentielle à 500 hpa (HGT-500HPA) * Épaisseurs entre 1000-500 hpa (LAYER-1000-500HPA) * Température de l'air à la surface (TMP-SFC) * Humidité relative à la surface (RELH-SFC) * Vitesse du vent à la surface (WIND-SFC) * Direction du vent à la surface (WDIR-SFC) Vous trouverez une liste en format XML des variables qui contient le nom du répertoire associé, les descriptions et les unités, en français et anglais à cette adresse: http://dd.weatheroffice.ec.gc.ca/ensemble/doc/naefs/elements.xml ################################################################# ### Liste des modèles ### ################################################################# Une liste en format XML qui contient les descriptions française et anglaise des membres disponibles peut être trouvée ici: http://dd.weatheroffice.ec.gc.ca/ensemble/doc/naefs/members.xml ###################################################### ### Contenu des fichiers ### ###################################################### Les fichiers XML ont été compressés avec l'algorithme bzip2. Pour décompresser ces fichiers, vous pouvez utiliser le logiciel bunzip2 (GNU/Linux, Mac OS X) ou encore 7-zip (Windows). Les fichiers sont encodés en format UTF-8. Chaque fichier est composé d'une section d'en-tête (
) indiquant la localisation de l'emplacement, les dates et heures de début et fin des prévisions, la variable concernée, l'unité utilisé pour le représenter ainsi que la date et l'heure de création du fichier. Viennent ensuite plusieurs sections pour la prévision (). Chacune de ces sections correspond à une heure de prévision précise. Elles contiennent chacune une série d'étiquettes indiquant pour chaque modèle disponible la valeur de la variable pour ce modèle à cette heure de prévision (voir la liste des modèles dans la section précédente « Liste des modèles ». Note: Certains modèles n'ont pas de prévisions pour certaines heures. Le contenu des fichiers est sous la forme:
XXXXXXXX XXXXXXXX ... XXXXXXXXXXX
XXX ... XXX XXX ... ... ###################################################### ### Emplacements disponibles ### ###################################################### Les sorties XML des prévisions d'ensemble SPENA sont des interpolations de points de grille des prévisions aux coordonnées latitude-longitude de 540 emplacements: * 273 au Canada; * 137 aux États-Unis; * 74 au Mexique; * 56 dans les tropiques et au Groenland. Vous trouverez une liste en format XML des emplacements qui contient: * Le nom de l'emplacement; * La province ou l'État; * Le pays; * Les codes, lorsque qu'applicables: NAEFS, WMO, IATA, ICAO; * La longitude, la latitude et l'altitude (notez que l'altitude est manquante pour quelques emplacements) Cette liste se trouve dans le fichier suivant: http://dd.weatheroffice.ec.gc.ca/ensemble/doc/naefs/locations.xml La correspondance pour les codes de 2 lettres pour les provinces ou les États peut-être trouvée dans ce document PDF: http://www.state.ia.us/tax/forms/84055.pdf ############################################################### ### 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 averti 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 Une fois enregistré, vous pouvez nous contacter à cette adresse pour toute question ou commentaire: dd_info@lists.ec.gc.ca ############################################################### ### Country List / Liste des pays ### ############################################################### Canada (CA) United States / États-Unis (US) Mexico / Mexique (MX) Antigua and Barbuda / Antigua-et-Barbuda (AG) Bahamas (BS) Barbados / Barbade (BB) Belize (BZ) Bermuda / Bermudes (BM) Bolivia / Bolivie (BO) Brazil / Brésil (BR) Cayman Islands / Îles Caïmans (KY) Chile / Chili (CL) Colombia / Colombie (CO) Costa Rica (CR) Cuba (CU) Dominican Republic / République Dominicaine (DO) Ecuador / Équateur (EC) El Salvador (SV) French Guiana / Guyane française (GF) French Polynesia / Polynésie Française (PF) Greenland / Groenland (GL) Guadeloupe (GP) Guatemala (GT) Guyana (GY) Haiti / Haïti (HT) Honduras (HN) Jamaica / Jamaïque (JM) Martinique (MQ) Nicaragua (NI) Panama (PA) Peru / Pérou (PE) Saint Lucia / Sainte-Lucie (LC) St-Pierre et Miquelon (PM) Trinidad and Tobago / Trinidad-et-Tobago (TT) Turks and Caicos Islands / Turks et Caïcos (TC) US Virgin Islands / Îles Vierges des États-Unis (VI) Venezuela (VE)