Present parser allows to download and import meteorological observations from Environment Canada's telemetry network. The parser is included in Delft-FEWS versions 2017.02 and higherThis CanadaMeteo data import is used for targeted access of Observation Summary Data Observations summary data in XML format.
The files that are downloaded and imported can be found at at http://dd.meteo.gc.ca/observations/xml/ . These files adhere to a schema: xmlns="http://dms.ec.gc.ca/schema/point-observation/2.1" An example of such an xml data file:
The parser is included in Delft-FEWS versions 2017.02 and higher.
This documentation contains:
1) Data Provider Documentation
2) Sample Configuration
This data import is available since Delft-FEWS 2018.02 and a patch more recent then January, 2020.
Please comment if anything further is needed or requires updating.
1) Data Provider Documentation
This service is hosted by the Meteorological Service of Canada:
For overview documentation https://eccc-msc.github.io/open-data/msc-data/obs_station/readme_obs_insitu_xmldatamart_en/
The license of the data provider (Environment and Climate Change Canada) can be found here https://dd.weather.gc.ca/doc/LICENCE_GENERAL.txt
2) Sample Configuration
Example of the Delft-FEWS import module
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
<?xml version="1.0" encoding="UTF-8"?>
<!-- edited with XMLSpy v2006 rel. 3 sp1 (http://www.altova.com) by Computer Services (WL | Delft Hydraulics) -->
<timeSeriesImportRun xmlns="http://www.wldelft.nl/fews | ||||||
Code Block | ||||||
| ||||||
om:ObservationCollection xmlns:om="http://www.opengis.net/om/1.0" xmlns="http://dms.ec.gc.ca/schema/point-observation/2.1" xmlns:gml="http://www.opengis.net/gml" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <om:member> <om:Observation> <om:metadata> <set> xsi:schemaLocation="http://www.wldelft.nl/fews http://fews.wldelft.nl/schemas/version1.0/timeSeriesImportRun.xsd"> <import> <general> <importType>CanadaMeteo</importType> <author build="build.4083" name="MSC-DMS-PG-WXO-Summary" version="3.1"/><serverUrl>http://dd.meteo.gc.ca/observations/xml</serverUrl> <user>user</user> <dataset name="mscobservation/atmospheric/surface_weather/wxo_dd_today_summary-1.0-ascii/"/> <phase name="product-wxo_xml-1.0/"/<password>password</password> <!-- Time period has to be configured for the importer to work --> <relativeViewPeriod unit="hour" start="-5" <id xlink:href="/data/msc/observation/atmospheric/surface_weather/wxo_dd_today_summary-1.0-ascii/product-wxo_xml-1.0/20181012234500000/sk/intermediate/frend="0" startOverrulable="true" endOverrulable="true"/> </general> <properties> <!--Optional <parent xlink:href="/data/msc/observation/atmospheric/surface_weather/wxo_dd_today_summary-1.0-ascii/product-wxo_xml-1.0/20181012234500000/sk/intermediate/fr"/> </general>configuration field. Value is a comma separated string of the region folder to be included.--> <!--If it is not configured, data <identification-elements> will be fetched from all folders for the specified time. Case sensitive.--> <!--Possible choices: <element name="province" uom="unitless" value="SK"/> AB, BC, MB, NB, NL, NS, NT, NU, ON, PE, QC, SK, YT--> <element<string namekey="creation_date_utcRegionDirectory" uomvalue="unitless" value="2018-10-12T23:50:00.000Z"AB, BC"/> <!--Optional configuration field. Value is a comma separated string of the time <element name="observation_date_utc" uom="unitless" value="2018-10-12T23:45:00.000Z"/folders to be included.--> <!--If it is not configured, data will be fetched from <element name="license" uom="unitless" value="http://dd.weatheroffice.ec.gc.ca/doc/LICENCE_GENERAL.txt"/all folders for the specified time.--> <!--Possible choices: "hourly", "today", "yesterday"--> <element<string namekey="languageTimeDirectory" uomvalue="unitless" value="FR"/>hourly, today"/> </properties> <timeSeriesSet> <<moduleInstanceId>CanadaMeteo</identification-elements>moduleInstanceId> <valueType>scalar</valueType> </set> <parameterId>mean_sea_level</parameterId> <<locationId>3025481</om:metadata>locationId> <om:samplingTime><timeSeriesType>external historical</timeSeriesType> <timeStep unit="nonequidistant"/> <gml:TimeInstant> <readWriteMode>add originals</readWriteMode> </timeSeriesSet> </import> </timeSeriesImportRun> |
Configuration Notes:
- The first set of data (member) contains information that is not specific to one location, it is not imported.
- Data concerning record temperatures, record rain, record snow, since when temperature and precipitation data is available, present weather and tendency characteristic are ignored. (Thus fields that do not contain data measured at sampling time).
- Measurements with no "value" are ignored.
- Wind direction is calculated from code (for example, NW for NorthWest) to degrees. For location ID climate station number is used.
- If, in the import module, a RegionDirectory is configured (for the purpose of importing data for, say, a single Province only), special attention should be paid to make sure that the locationSet that data is imported to, includes locations that are available in the directory specified.
- If data is not available for the chosen times, en empty time series set is returned.
- It is practical to configure either a short time period, or other restrictions to prevent running out of local memory.
Locations and id mapping
Two files used for Locations and IdMapping are linked here.
- Link: A list of Environment Canada locations from which data can be imported.
- Note that the 'external location IDs' are in the column "
# MSC
"; these correspond to the XML data file'sclimate_station_number.
- This means you will either need to set these as your Delft-FEWS locationID
- Alternatively, you need to import the MSC column as an attribute and use an id-mapping function to reference that, for example
<locationIdFunction internalLocationSet="EC_stations" externalLocationFunction="@climate_station_number@"/>
where, in the locationSets,climate_station_number
is an attributeID defined from the associated column in the .csv file that stores the locations:<attribute id="climate_station_number"><text>%# MSC%</text></attribute>
.
- Note that the 'external location IDs' are in the column "
- Link: IdMappingFile
Note that both files were valid at the time of upload to the WIKI. Any changes made by Environment Canada, to either the locations or the naming of parameters, will not be automatically reflected in these attachments.
These files adhere to a schema: xmlns="http://dms.ec.gc.ca/schema/point-observation/2.1" An example of such an xml data file:
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
om:ObservationCollection xmlns:om="http://www.opengis.net/om/1.0" xmlns="http://dms.ec.gc.ca/schema/point-observation/2.1" xmlns:gml="http://www.opengis.net/gml" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <om:member> <om:Observation> <om:metadata> <gml:timePosition>2018-10-12T23:00:00.000Z</gml:timePosition> </gml:TimeInstant> </om:samplingTime> <om:resultTime> <gml:TimeInstant> <gml:timePosition>2018-10-12T23:00:00.000Z</gml:timePosition> </gml:TimeInstant> </om:resultTime> <om:procedure xlink:href="msc/observation/atmospheric/surface_weather/wxo_dd_today_summary-1.0-ascii/product-wxo_xml-1.0/20181012234500000/sk/intermediate/fr"/> <om:observedProperty gml:remoteSchema="/schema/point-observation/2.0.xsd"/> <om:featureOfInterest> <gml:FeatureCollection> <gml:location> <gml:Point> <gml:pos/> </gml:Point> </gml:location> </gml:FeatureCollection> </om:featureOfInterest> <om:result> <elements> <element name="hot_spot_location_canada" uom="unitless" value="Rolling Hills"> <qualifier name="hot_spot_temperature_canada" uom="Celsius" value="20.0"/> <qualifier name="province" uom="AB" value="unitless"/> </element><set> <element name="cold_spot_location_canada" uom="unitless" value="Eureka"><general> <qualifier<author namebuild="cold_spot_temperature_canadabuild.4083" uomname="CelsiusMSC-DMS-PG-WXO-Summary" valueversion="-213.81"/> <qualifier<dataset name="province" uom="NU" value="unitless"/> mscobservation/atmospheric/surface_weather/wxo_dd_today_summary-1.0-ascii/"/> </element> <element <phase name="hot_spot_location_province" uom="unitless" value="Maple Creek"product-wxo_xml-1.0/"/> <qualifier<id name="hot_spot_temperature_province" uom="Celsius" value="18.4xlink:href="/data/msc/observation/atmospheric/surface_weather/wxo_dd_today_summary-1.0-ascii/product-wxo_xml-1.0/20181012234500000/sk/intermediate/fr"/> </element> <element name="cold_spot_location_province" uom="unitless" value="Broadview"> <parent xlink:href="/data/msc/observation/atmospheric/surface_weather/wxo_dd_today_summary-1.0-ascii/product-wxo_xml-1.0/20181012234500000/sk/intermediate/fr"/> </general> <qualifier name="cold_spot_temperature_province" uom="Celsius" value="-8.9"/> <identification-elements> </element> <element name="province" </elements>uom="unitless" value="SK"/> </om:result> </om:Observation> </om:member> <om:member> <om:Observation><element name="creation_date_utc" uom="unitless" value="2018-10-12T23:50:00.000Z"/> <om:metadata> <element name="observation_date_utc" <set>uom="unitless" value="2018-10-12T23:45:00.000Z"/> <general> <element <author build="build.4083" name="MSC-DMS-PG-WXO-Summary" version="3.1name="license" uom="unitless" value="http://dd.weatheroffice.ec.gc.ca/doc/LICENCE_GENERAL.txt"/> <dataset<element name="mscobservation/atmospheric/surface_weather/wxo_dd_today_summary-1.0-ascii/="language" uom="unitless" value="FR"/> </identification-elements> <phase name="product-wxo_xml-1.0/"/> </set> </om:metadata> <id xlink:href="/data/msc/observation/atmospheric/surface_weather/wxo_dd_today_summary-1.0-ascii/product-wxo_xml-1.0/20181012234500000/sk/intermediate/fr"/> <om:samplingTime> <gml:TimeInstant> <parent xlink:href="/data/msc/observation/atmospheric/surface_weather/wxo_dd_today_summary-1.0-ascii/product-wxo_xml-1.0/20181012234500000/sk/intermediate/fr"/> <gml:timePosition>2018-10-12T23:00:00.000Z</gml:timePosition> </general>gml:TimeInstant> </om:samplingTime> <identification-elements> <om:resultTime> <gml:TimeInstant> <element name="station_name" uom="unitless" value="Aéroport d'Assiniboia"/> <gml:timePosition>2018-10-12T23:00:00.000Z</gml:timePosition> <element name="latitude" uom="degree" value="49.729192"/> </gml:TimeInstant> </om:resultTime> <element name="longitude" uom="degree" value="-105.946114<om:procedure xlink:href="msc/observation/atmospheric/surface_weather/wxo_dd_today_summary-1.0-ascii/product-wxo_xml-1.0/20181012234500000/sk/intermediate/fr"/> <om:observedProperty gml:remoteSchema="/schema/point-observation/2.0.xsd"/> <om:featureOfInterest> <element name="transport_canada_id" uom="unitless" value="WJI"/> <gml:FeatureCollection> <gml:location> <element name="observation_date_utc" uom="unitless" value="2018-10-12T23:45:00.000Z"/> <gml:Point> <element name="observation_date_local_time" uom="unitless" value="2018-10-12T17:45:00.000 CST"/> <gml:pos/> </gml:Point> <element name="climate_station_number" uom="unitless" value="4020286"/> </gml:location> </gml:FeatureCollection> <element name="wmo_station_number" uom="unitless" value="71487"/> </om:featureOfInterest> </identification-elements><om:result> </set><elements> </om:metadata> <element name="hot_spot_location_canada" uom="unitless" <om:samplingTime>value="Rolling Hills"> <gml:TimeInstant> <gml:timePosition>2018-10-12T23:00:00.000Z</gml:timePosition><qualifier name="hot_spot_temperature_canada" uom="Celsius" value="20.0"/> </gml:TimeInstant> <qualifier name="province" </om:samplingTime>uom="AB" value="unitless"/> <om:resultTime> </element> <gml:TimeInstant> <gml:timePosition>2018-10-12T23:00:00.000Z</gml:timePosition><element name="cold_spot_location_canada" uom="unitless" value="Eureka"> </gml:TimeInstant> <qualifier name="cold_spot_temperature_canada" </om:resultTime>uom="Celsius" value="-21.8"/> <om:procedure xlink:href="msc/observation/atmospheric/surface_weather/wxo_dd_today_summary-1.0-ascii/product-wxo_xml-1.0/20181012234500000/sk/intermediate/fr"/> <qualifier name="province" <om:observedProperty gml:remoteSchema="/schema/point-observation/2.0.xsduom="NU" value="unitless"/> <om:featureOfInterest> </element> <gml:FeatureCollection> <element name="hot_spot_location_province" uom="unitless" value="Maple Creek"> <gml:location> <qualifier name="hot_spot_temperature_province" uom="Celsius" value="18.4"/> <gml:Point> </element> <gml:pos>49.729192 -105.946114</gml:pos> <element name="cold_spot_location_province" uom="unitless" value="Broadview"> <qualifier name="cold_spot_temperature_province" </gml:Point>uom="Celsius" value="-8.9"/> </gml:location>element> </gml:FeatureCollection>elements> </om:featureOfInterest>result> </om:Observation> <om</om:result>member> <om:member> <om:Observation> <elements> <om:metadata> <element name="air_temperature_today_high" uom="Celsius" value="11.9"/> <set> <element name="air_temperature_today_low" uom="Celsius" value="-5.5"/> <general> <element<author namebuild="wind_gust_speedbuild.4083" uomname="km/hMSC-DMS-PG-WXO-Summary" valueversion="3.1"/> <element <dataset name="wind_direction" uom="code" value="WSWmscobservation/atmospheric/surface_weather/wxo_dd_today_summary-1.0-ascii/"/> <element<phase name="record_high_temperature" uom="Celsius" value="17.4"product-wxo_xml-1.0/"/> <qualifier<id name="record_high_temperature_year" uom="unitless" value="2012"xlink:href="/data/msc/observation/atmospheric/surface_weather/wxo_dd_today_summary-1.0-ascii/product-wxo_xml-1.0/20181012234500000/sk/intermediate/fr"/> </element> <parent xlink:href="/data/msc/observation/atmospheric/surface_weather/wxo_dd_today_summary-1.0-ascii/product-wxo_xml-1.0/20181012234500000/sk/intermediate/fr"/> <element name="record_low_temperature" uom="Celsius" value="-9.2"> </general> <identification-elements> <qualifier <element name="record_low_temperature_yearstation_name" uom="unitless" value="2006Aéroport d'Assiniboia"/> </element> <element name="record_rain_amountlatitude" uom="mmdegree" value="649.8729192"/> <qualifier<element name="record_rain_yearlongitude" uom="unitlessdegree" value="1997-105.946114"/> </element> <element name="record_snow_amount<element name="transport_canada_id" uom="cmunitless" value="0.0WJI"/> <qualifier<element name="recordobservation_snowdate_yearutc" uom="unitless" value="19962018-10-12T23:45:00.000Z"/> </element> <element name="temperatureobservation_datadate_sincelocal_yeartime" uom="unitless" value="19932018-10-12T17:45:00.000 CST"/> <element name="precipitationclimate_datastation_since_yearnumber" uom="unitless" value="19934020286"/> </elements> <element name="wmo_station_number" </om:result>uom="unitless" value="71487"/> </om:Observation> </om:member> <om:member> <om:Observation> </identification-elements> <om:metadata> <set></set> </om:metadata> <general> <om:samplingTime> <author build="build.4083" name="MSC-DMS-PG-WXO-Summary" version="3.1"/> <gml:TimeInstant> <dataset name="mscobservation/atmospheric/surface_weather/wxo_dd_hour_summary-1.0-ascii/"/><gml:timePosition>2018-10-12T23:00:00.000Z</gml:timePosition> </gml:TimeInstant> <phase name="product-wxo_xml-1.0/"/> </om:samplingTime> <id xlink:href="/data/msc/observation/atmospheric/surface_weather/wxo_dd_hour_summary-1.0-ascii/product-wxo_xml-1.0/20180921014500000/ns/intermediate/en"/><om:resultTime> <parent<gml:TimeInstant> <gml:timePosition>2018-10-12T23:00:00.000Z</gml:timePosition> </gml:TimeInstant> </om:resultTime> <om:procedure xlink:href="/data/msc/observation/atmospheric/surface_weather/wxo_dd_hourtoday_summary-1.0-ascii/product-wxo_xml-1.0/2018092101450000020181012234500000/nssk/intermediate/enfr"/> <om:observedProperty gml:remoteSchema="/schema/point-observation/2.0.xsd"/> </general> <om:featureOfInterest> <identification-elements> <gml:FeatureCollection> <element name="station_name" uom="unitless" value="Bedford Range"/> <gml:location> <element name="latitude" uom="degree" value="44.745858"/> <gml:Point> <element name="longitude" uom="degree" value="-63.661689"/> <gml:pos>49.729192 -105.946114</gml:pos> <element name="transport_canada_id" uom="unitless" value="ABR"/> </gml:Point> <element name="observation_date_utc" uom="unitless" value="2018-09-21T01:30:00.000Z"/></gml:location> </gml:FeatureCollection> </om:featureOfInterest> <element name="observation_date_local_time" uom="unitless" value="2018-09-20T22:30:00.000 ADT"/> <om:result> <elements> <element name="climate_station_number <element name="air_temperature_today_high" uom="unitlessCelsius" value="820057411.9"/> <element name="wmoair_temperature_stationtoday_numberlow" uom="unitlessCelsius" value="71325-5.5"/> </identification-elements> <element name="wind_gust_speed" uom="km/h" value=""/> </set> </om:metadata> <om:samplingTime> <element name="wind_direction" uom="code" value="WSW"/> <gml:TimeInstant> <element name="record_high_temperature" <gml:timePosition>2018-09-21T01:00:00.000Z</gml:timePosition>uom="Celsius" value="17.4"> </gml:TimeInstant> </om:samplingTime> <om:resultTime><qualifier name="record_high_temperature_year" uom="unitless" value="2012"/> <gml:TimeInstant> </element> <gml:timePosition>2018-09-21T01:00:00.000Z</gml:timePosition> <element name="record_low_temperature" </gml:TimeInstant>uom="Celsius" value="-9.2"> </om:resultTime> <om:procedure xlink:href="msc/observation/atmospheric/surface_weather/wxo_dd_hour_summary-1.0-ascii/product-wxo_xml-1.0/20180921014500000/ns/intermediate/en<qualifier name="record_low_temperature_year" uom="unitless" value="2006"/> <om:observedProperty gml:remoteSchema="/schema/point-observation/2.0.xsd"/> </element> <om:featureOfInterest> <gml:FeatureCollection> <element name="record_rain_amount" uom="mm" value="6.8"> <gml:location> <qualifier name="record_rain_year" <gml:Point>uom="unitless" value="1997"/> </element> <gml:pos>44.745858 -63.661689</gml:pos> <element name="record_snow_amount" </gml:Point>uom="cm" value="0.0"> </gml:location> <qualifier name="record_snow_year" </gml:FeatureCollection>uom="unitless" value="1996"/> </om:featureOfInterest> <om:result> </element> <elements> <element name="present_weathertemperature_data_since_year" uom="codeunitless" value="Partly Cloudy1993"/> <element name="meanprecipitation_data_seasince_levelyear" uom="kPaunitless" value="102.61993"/> <element name="tendency_amount" uom="kPa" value="0.20"/> </elements> </om:result> <element name="tendency_characteristic" uom="code" value="rising"/></om:Observation> </om:member> <om:member> <om:Observation> <om:metadata> <element name="horizontal_visibility" uom="km" value="24.1"/> <set> <element name="air_temperature" uom="Celsius" value="10.7"/> <general> <element name="dew_point" uom="Celsius" value="8.7 <author build="build.4083" name="MSC-DMS-PG-WXO-Summary" version="3.1"/> <element <dataset name="relative_humidity" uom="percent" value="87"mscobservation/atmospheric/surface_weather/wxo_dd_hour_summary-1.0-ascii/"/> <element <phase name="wind_speed" uom="km/h" value="6"product-wxo_xml-1.0/"/> <element name="wind_direction" uom="code" value="NW <id xlink:href="/data/msc/observation/atmospheric/surface_weather/wxo_dd_hour_summary-1.0-ascii/product-wxo_xml-1.0/20180921014500000/ns/intermediate/en"/> <element name="wind_gust_speed" uom="km/h" value="15"/> <parent xlink:href="/data/msc/observation/atmospheric/surface_weather/wxo_dd_hour_summary-1.0-ascii/product-wxo_xml-1.0/20180921014500000/ns/intermediate/en"/> </general> <element name="total_cloud_cover" uom="code" value="5"/> <identification-elements> <element name="windstation_chillname" uom="unitless" value="Bedford Range"/> <element name="humidexlatitude" uom="unitlessdegree" value="44.745858"/> </elements> <element name="longitude" uom="degree" value="-63.661689"/> </om:result> </om:Observation> </om:member> </om:ObservationCollection> |
Some notes on the data that is taken from the xml files:
- The first set of data (member) contains information that is not specific to one location, it is not imported.
- Data concerning record temperatures, record rain, record snow, since when temperature and precipitation data is available, present weather and tendency characteristic are ignored. (Thus fields that do not contain data measured at sampling time).
- Measurements with no "value" are ignored.
- Wind direction is calculated from code (for example, NW for NorthWest) to degrees. For location ID climate station number is used.
Example of the Delft-FEWS import module
Code Block | ||||
---|---|---|---|---|
| ||||
<?xml version="1.0" encoding="UTF-8"?> <!-- edited with XMLSpy v2006 rel. 3 sp1 (http://www.altova.com) by Computer Services (WL | Delft Hydraulics) --> <timeSeriesImportRun xmlns="http://www.wldelft.nl/fews" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" <element name="transport_canada_id" uom="unitless" value="ABR"/> <element name="observation_date_utc" uom="unitless" value="2018-09-21T01:30:00.000Z"/> <element name="observation_date_local_time" uom="unitless" value="2018-09-20T22:30:00.000 ADT"/> <element name="climate_station_number" uom="unitless" value="8200574"/> <element name="wmo_station_number" uom="unitless" value="71325"/> </identification-elements> xsi:schemaLocation="http://www.wldelft.nl/fews http://fews.wldelft.nl/schemas/version1.0/timeSeriesImportRun.xsd"> </set> <import> <general></om:metadata> <importType>CanadaMeteo</importType><om:samplingTime> <serverUrl>http://dd.meteo.gc.ca/observations/xml</serverUrl><gml:TimeInstant> <user>user</user> <gml:timePosition>2018-09-21T01:00:00.000Z</gml:timePosition> <password>password</password> <!-- Time period has to be configured for the importer to work --> </gml:TimeInstant> </om:samplingTime> <om:resultTime> <gml:TimeInstant> <relativeViewPeriod unit="hour" start="-5" end="0" startOverrulable="true" endOverrulable="true"/> <gml:timePosition>2018-09-21T01:00:00.000Z</gml:timePosition> </general>gml:TimeInstant> <properties></om:resultTime> <!--Optional configuration field. Value is a comma separated string of the region folder to be included.--><om:procedure xlink:href="msc/observation/atmospheric/surface_weather/wxo_dd_hour_summary-1.0-ascii/product-wxo_xml-1.0/20180921014500000/ns/intermediate/en"/> <om:observedProperty gml:remoteSchema="/schema/point-observation/2.0.xsd"/> <om:featureOfInterest> <!--If it is not configured, data will be fetched from all folders for the specified time. Case sensitive.--> <gml:FeatureCollection> <gml:location> <!--Possible choices<gml:Point> AB, BC, MB, NB, NL, NS, NT, NU, ON, PE, QC, SK, YT--> <gml:pos>44.745858 -63.661689</gml:pos> <string key="RegionDirectory" value="AB, BC"/> <!--Optional configuration field. Value is a comma separated string of the time folders to be included.--> /gml:Point> </gml:location> </gml:FeatureCollection> <!--If it is not configured, data will be fetched from all folders for the specified time.-->/om:featureOfInterest> <om:result> <elements> <!--Possible choices: "hourly", "today", "yesterday"-- <element name="present_weather" uom="code" value="Partly Cloudy"/> <string key="TimeDirectory <element name="mean_sea_level" uom="kPa" value="hourly, today102.6"/> </properties> <element name="tendency_amount" <timeSeriesSet>uom="kPa" value="0.20"/> <moduleInstanceId>CanadaMeteo</moduleInstanceId> <element name="tendency_characteristic" uom="code" value="rising"/> <valueType>scalar</valueType> <element <parameterId>mean_sea_level</parameterId> name="horizontal_visibility" uom="km" value="24.1"/> <element name="air_temperature" <locationId>3025481</locationId>uom="Celsius" value="10.7"/> <timeSeriesType>external historical</timeSeriesType> <element name="dew_point" uom="Celsius" value="8.7"/> <timeStep unit="nonequidistant <element name="relative_humidity" uom="percent" value="87"/> <readWriteMode>add originals</readWriteMode> <element name="wind_speed" </timeSeriesSet>uom="km/h" value="6"/> </import> </timeSeriesImportRun> |
Some notes:
- If, in the import module, a RegionDirectory is configured (for the purpose of importing data for, say, a single Province only), special attention should be paid to make sure that the locationSet that data is imported to, includes locations that are available in the directory specified.
- If data is not available for the chosen times, en empty time series set is returned.
- It is practical to configure either a short time period, or other restrictions to prevent running out of local memory.
Locations and id mapping
Two files may facilitate your Delft-FEWS configuration:
- A list of Environment Canada locations from which data can be imported.
- Note that the 'external location IDs' are in the column "
# MSC
"; these correspond to the XML data file'sclimate_station_number.
- This means you will either need to set these as your Delft-FEWS locationID
- Alternatively, you need to import the MSC column as an attribute and use an id-mapping function to reference that, for example
<locationIdFunction internalLocationSet="EC_stations" externalLocationFunction="@climate_station_number@"/>
where, in the locationSets,climate_station_number
is an attributeID defined from the associated column in the .csv file that stores the locations:<attribute id="climate_station_number"><text>%# MSC%</text></attribute>
.
- Note that the 'external location IDs' are in the column "
- An id mapping file
...
<element name="wind_direction" uom="code" value="NW"/>
<element name="wind_gust_speed" uom="km/h" value="15"/>
<element name="total_cloud_cover" uom="code" value="5"/>
<element name="wind_chill" uom="unitless" value=""/>
<element name="humidex" uom="unitless" value=""/>
</elements>
</om:result>
</om:Observation>
</om:member>
</om:ObservationCollection> |