Versions Compared

Old Version 4

changes.mady.by.user Orshi Egressy-Molnár

Saved on

compared with

New Version Current

changes.mady.by.user André Speelmans

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

This 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 

Imports XML data that follows the xmlns="http://dms.ec.gc.ca/schema/point-observation/2.1"  shema.

Files can be found in this directory: http://dd.meteo.gc.ca/observations/xml/

Table of Contents

Overview:

 . 

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 to degrees. For location ID climate station number is used.

Example:

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
languagexml
linenumberstrue
<?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
languagexml
linenumberstrue
collapsetrue
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>xsi:schemaLocation="http://www.wldelft.nl/fews http://fews.wldelft.nl/schemas/version1.0/timeSeriesImportRun.xsd">
   <import>
      <general>
   <set>
      <importType>CanadaMeteo</importType>
         <general><serverUrl>http://dd.meteo.gc.ca/observations/xml</serverUrl>
         <user>dummy_username</user>
         <author build="build.4083" name="MSC-DMS-PG-WXO-Summary" version="3.1"/>
                  <dataset name="mscobservation/atmospheric/surface_weather/wxo_dd_today_summary-1.0-ascii/"/<password>dummy_password</password>
		 <!-- Time period has to be configured for the importer to work -->
         <relativeViewPeriod unit="hour" start="-5" end="0"      <phase name="product-wxo_xml-1.0/startOverrulable="true" endOverrulable="true"/>
      </general>
      <properties>
       <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"/>
            <!--Optional configuration field. Value is a comma separated string of the region folder to be included.-->
        <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>
   <!--If it is not configured, data will be fetched from all folders for the specified time. Case sensitive.-->
         <!--Possible choices: AB,  <identification-elements>
          BC, MB, NB, NL, NS, NT, NU, ON, PE, QC, SK, YT-->
        <element name="province" uom<string key="unitlessRegionDirectory" value="SKAB, BC"/>
         <!--Optional configuration field. Value is a comma separated string of <element name="creation_date_utc" uom="unitless" value="2018-10-12T23:50:00.000Z"/>
the time folders to be included.-->
         <!--If it is not configured, data will be fetched from all folders <element name="observation_date_utc" uom="unitless" value="2018-10-12T23:45:00.000Z"/for the specified time.-->
         <!--Possible choices: "hourly", "today", "yesterday"-->
     <element name="license" uom="unitless    <string key="TimeDirectory" value="http://dd.weatheroffice.ec.gc.ca/doc/LICENCE_GENERAL.txthourly, today"/>
      </properties>
      <timeSeriesSet>
      <element name="language" uom="unitless" value="FR"/> <moduleInstanceId>CanadaMeteo</moduleInstanceId>
         <valueType>scalar</valueType>
         </identification-elements><parameterId>mean_sea_level</parameterId>
            </set><locationId>3025481</locationId>
         </om:metadata><timeSeriesType>external historical</timeSeriesType>
         <om:samplingTime><timeStep unit="nonequidistant"/>
            <gml:TimeInstant><readWriteMode>add originals</readWriteMode>
               <gml:timePosition>2018-10-12T23:00:00.000Z</gml:timePosition></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's climate_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>.
  • 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
languagexml
linenumberstrue
collapsetrue
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>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/>
<om:metadata>
            <set>
        </gml:Point>
       <general>
        </gml:location>
          <author build="build.4083"  </gml:FeatureCollection>name="MSC-DMS-PG-WXO-Summary" version="3.1"/>
         </om:featureOfInterest>
           <om:result><dataset name="mscobservation/atmospheric/surface_weather/wxo_dd_today_summary-1.0-ascii/"/>
            <elements>
               <element<phase name="hot_spot_location_canada" uom="unitless" value="Rolling Hills"product-wxo_xml-1.0/"/>
                  <qualifier<id name="hot_spot_temperature_canada" uom="Celsius" value="20.0xlink:href="/data/msc/observation/atmospheric/surface_weather/wxo_dd_today_summary-1.0-ascii/product-wxo_xml-1.0/20181012234500000/sk/intermediate/fr"/>
                  <qualifier<parent name="province" uom="AB" value="unitless"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>general>
               <element name="cold_spot_location_canada" uom="unitless" value="Eureka">
                  <qualifier name="cold_spot_temperature_canada" uom="Celsius" value="-21.8"/><identification-elements>
                  <qualifier<element name="province" uom="NUunitless" value="unitlessSK"/>
               </element>
               <element name="hotcreation_spotdate_location_provinceutc" uom="unitless" value="Maple Creek"2018-10-12T23:50:00.000Z"/>
                  <qualifier<element name="hotobservation_spotdate_temperature_provinceutc" uom="Celsiusunitless" value="18.42018-10-12T23:45:00.000Z"/>
               </element>
               <element name="cold_spot_location_provincelicense" uom="unitless" value="Broadview"http://dd.weatheroffice.ec.gc.ca/doc/LICENCE_GENERAL.txt"/>
                  <qualifier<element name="cold_spot_temperature_provincelanguage" uom="Celsiusunitless" value="-8.9FR"/>
               </element>
            </elements>
         </om:result>
identification-elements>
         </om:Observation>
   </om:member>set>
   <om:member>
      <om</om:Observation>metadata>
         <om:metadata>samplingTime>
            <set><gml:TimeInstant>
               <general><gml:timePosition>2018-10-12T23:00:00.000Z</gml:timePosition>
            </gml:TimeInstant>
      <author build="build.4083" name="MSC-DMS-PG-WXO-Summary" version="3.1"/>   </om:samplingTime>
         <om:resultTime>
         <dataset name="mscobservation/atmospheric/surface_weather/wxo_dd_today_summary-1.0-ascii/"/>
   <gml:TimeInstant>
               <gml:timePosition>2018-10-12T23:00:00.000Z</gml:timePosition>
           <phase name="product-wxo_xml-1.0/"/> </gml:TimeInstant>
         </om:resultTime>
         <id<om:procedure xlink:href="/data/msc/observation/atmospheric/surface_weather/wxo_dd_today_summary-1.0-ascii/product-wxo_xml-1.0/20181012234500000/sk/intermediate/fr"/>
 /fr"/>
         <om:observedProperty gml:remoteSchema="/schema/point-observation/2.0.xsd"/>
         <om:featureOfInterest>
            <gml:FeatureCollection>
               <gml:location>
                 <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:Point>
                     <<gml:pos/general>>
               <identification-elements>   </gml:Point>
               </gml:location>
   <element name="station_name" uom="unitless" value="Aéroport d'Assiniboia"/>
            </gml:FeatureCollection>
         </om:featureOfInterest>
      <element name="latitude" uom="degree" value="49.729192"/> <om:result>
            <elements>
               <element name="longitudehot_spot_location_canada" uom="degreeunitless" value="-105.946114"/Rolling Hills">
                  <element<qualifier name="transporthot_spot_temperature_canada_id" uom="unitlessCelsius" value="WJI20.0"/>
                  <element<qualifier name="observation_date_utcprovince" uom="unitlessAB" value="2018-10-12T23:45:00.000Z"/>
unitless"/>
               </element>
               <element name="observationcold_datespot_locallocation_timecanada" uom="unitless" value="2018-10-12T17:45:00.000 CST"/Eureka">
                  <element<qualifier name="climatecold_spot_stationtemperature_numbercanada" uom="unitlessCelsius" value="4020286-21.8"/>
                  <element<qualifier name="wmo_station_numberprovince" uom="unitlessNU" value="71487unitless"/>
               </identification-elements>element>
            </set>
         </om:metadata><element name="hot_spot_location_province" uom="unitless" value="Maple Creek">
         <om:samplingTime>
         <qualifier name="hot_spot_temperature_province"  <gml:TimeInstant>uom="Celsius" value="18.4"/>
               <gml:timePosition>2018-10-12T23:00:00.000Z</gml:timePosition></element>
            </gml:TimeInstant>
   <element name="cold_spot_location_province"      </om:samplingTime>uom="unitless" value="Broadview">
         <om:resultTime>
         <qualifier name="cold_spot_temperature_province"  <gml:TimeInstant>uom="Celsius" value="-8.9"/>
               <gml:timePosition>2018-10-12T23:00:00.000Z</gml:timePosition></element>
            </gml:TimeInstant>elements>
         </om:resultTime>result>
         <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:Observation>
   </om:member>
   <om:member>
   <om:observedProperty gml:remoteSchema="/schema/point-observation/2.0.xsd"/>   <om:Observation>
         <om:featureOfInterest>metadata>
            <gml:FeatureCollection><set>
               <gml:location><general>
                   <gml:Point>
  <author build="build.4083" name="MSC-DMS-PG-WXO-Summary" version="3.1"/>
                   <gml:pos>49.729192 -105.946114</gml:pos><dataset name="mscobservation/atmospheric/surface_weather/wxo_dd_today_summary-1.0-ascii/"/>
                  </gml:Point><phase name="product-wxo_xml-1.0/"/>
               </gml:location>
            </gml:FeatureCollection>
<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:featureOfInterest>
        <parent <om:result>
            <elements>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="air_temperature_today_high" uom="Celsius" value="11.9"/></general>
               <element name="air_temperature_today_low" uom="Celsius" value="-5.5"/>
<identification-elements>
                  <element name="windstation_gust_speedname" uom="km/hunitless" value="Aéroport d'Assiniboia"/>
                  <element name="wind_directionlatitude" uom="codedegree" value="WSW49.729192"/>
                  <element name="record_high_temperaturelongitude" uom="Celsiusdegree" value="17-105.4946114"/>
                  <qualifier<element name="recordtransport_highcanada_temperature_yearid" uom="unitless" value="2012WJI"/>
               </element>
               <element name="recordobservation_lowdate_temperatureutc" uom="Celsiusunitless" value="-9.2"2018-10-12T23:45:00.000Z"/>
                  <qualifier<element name="recordobservation_lowdate_temperaturelocal_yeartime" uom="unitless" value="20062018-10-12T17:45:00.000 CST"/>
               </element>
               <element name="recordclimate_rainstation_amountnumber" uom="mmunitless" value="6.84020286"/>
                  <qualifier<element name="recordwmo_rainstation_yearnumber" uom="unitless" value="199771487"/>
               </element>identification-elements>
            </set>
     <element name="record_snow_amount" uom="cm" value="0.0">  </om:metadata>
         <om:samplingTime>
         <qualifier name="record_snow_year" uom="unitless" value="1996"/> <gml:TimeInstant>
               </element><gml:timePosition>2018-10-12T23:00:00.000Z</gml:timePosition>
            </gml:TimeInstant>
     <element name="temperature_data_since_year" uom="unitless" value="1993"/>   </om:samplingTime>
         <om:resultTime>
        <element name="precipitation_data_since_year" uom="unitless" value="1993"/>
    <gml:TimeInstant>
             </elements>
  <gml:timePosition>2018-10-12T23:00:00.000Z</gml:timePosition>
            </omgml:result>TimeInstant>
      </om:Observation>
   </om:member>
<om:member>/om:resultTime>
   <om:Observation>
      <om:metadata>
procedure xlink:href="msc/observation/atmospheric/surface_weather/wxo_dd_today_summary-1.0-ascii/product-wxo_xml-1.0/20181012234500000/sk/intermediate/fr"/>
              <set><om:observedProperty gml:remoteSchema="/schema/point-observation/2.0.xsd"/>
            <general><om:featureOfInterest>
               <author build="build.4083" name="MSC-DMS-PG-WXO-Summary" version="3.1"/><gml:FeatureCollection>
               <dataset name="mscobservation/atmospheric/surface_weather/wxo_dd_hour_summary-1.0-ascii/"/><gml:location>
               <phase name="product-wxo_xml-1.0/"/>   <gml:Point>
               <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"/>      <gml:pos>49.729192 -105.946114</gml:pos>
               <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"/>   </gml:Point>
               </gml:location>
            </general>gml:FeatureCollection>
         </om:featureOfInterest>
   <identification-elements>
       <om:result>
        <element name="station_name" uom="unitless" value="Bedford Range"/> <elements>
               <element name="latitudeair_temperature_today_high" uom="degreeCelsius" value="4411.7458589"/>
               <element name="longitudeair_temperature_today_low" uom="degreeCelsius" value="-635.6616895"/>
               <element name="transportwind_canadagust_idspeed" uom="unitlesskm/h" value="ABR"/>
               <element name="observationwind_date_utcdirection" uom="unitlesscode" value="2018-09-21T01:30:00.000ZWSW"/>
               <element name="observationrecord_datehigh_local_timetemperature" uom="unitlessCelsius" value="2018-09-20T22:30:00.000 ADT"/>
17.4">
                  <element<qualifier name="climaterecord_high_stationtemperature_numberyear" uom="unitless" value="82005742012"/>
               </element>
               <element name="wmorecord_stationlow_numbertemperature" uom="unitlessCelsius" value="71325-9.2"/>
            </identification-elements>
      <qualifier name="record_low_temperature_year"  </set>
      </om:metadata>uom="unitless" value="2006"/>
      <om:samplingTime>
         <gml:TimeInstant>
            <gml:timePosition>2018-09-21T01:00:00.000Z</gml:timePosition>
</element>
          </gml:TimeInstant>
      </om:samplingTime>
  <element name="record_rain_amount" uom="mm" value="6.8">
    <om:resultTime>
         <gml:TimeInstant>
     <qualifier name="record_rain_year" uom="unitless" value="1997"/>
    <gml:timePosition>2018-09-21T01:00:00.000Z</gml:timePosition>
           </gml:TimeInstant>element>
      </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"/>
      <om:observedProperty gml:remoteSchema="/schema/point-observation/2.0.xsd<element name="record_snow_amount" uom="cm" value="0.0">
                  <qualifier name="record_snow_year" uom="unitless" value="1996"/>
      <om:featureOfInterest>
         <gml:FeatureCollection>
</element>
               <element name="temperature_data_since_year"  <gml:location>uom="unitless" value="1993"/>
               <gml:Point>
   <element name="precipitation_data_since_year" uom="unitless" value="1993"/>
               <gml:pos>44.745858 -63.661689</gml:pos></elements>
         </om:result>
      </gmlom:Point>Observation>
   </om:member>
<om:member>
         </gml:location><om:Observation>
      <om:metadata>
   </gml:FeatureCollection>
      </om:featureOfInterest><set>
      <om:result>
      <general>
   <elements>
            <element<author namebuild="present_weatherbuild.4083" uomname="codeMSC-DMS-PG-WXO-Summary" valueversion="Partly Cloudy3.1"/>
               <element<dataset name="mean_sea_level" uom="kPa" value="102.6mscobservation/atmospheric/surface_weather/wxo_dd_hour_summary-1.0-ascii/"/>
            <element   <phase name="tendency_amount" uom="kPa" value="0.20product-wxo_xml-1.0/"/>
               <element<id name="tendency_characteristic" uom="code" value="risingxlink: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="horizontal_visibility" uom="km" value="24.1 <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"/>
            <element name="air_temperature" uom="Celsius" value="10.7"/>
</general>
            <identification-elements>
               <element name="dewstation_pointname" uom="Celsiusunitless" value="8.7Bedford Range"/>
               <element name="relative_humiditylatitude" uom="percentdegree" value="8744.745858"/>
               <element name="wind_speedlongitude" uom="km/hdegree" value="6-63.661689"/>
               <element name="windtransport_canada_directionid" uom="codeunitless" value="NWABR"/>
               <element name="windobservation_gustdate_speedutc" uom="km/hunitless" value="152018-09-21T01:30:00.000Z"/>
               <element name="totalobservation_date_cloudlocal_covertime" uom="codeunitless" value="52018-09-20T22:30:00.000 ADT"/>
               <element name="windclimate_station_chillnumber" uom="unitless" value="8200574"/>
               <element name="humidexwmo_station_number" uom="unitless" value="71325"/>
            </identification-elements>
         </om:result>
set>
      </om:Observation>
</om:member>
</om:ObservationCollection> 

Configuration example:

Code Block
languagexml
<?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"
     metadata>
      <om:samplingTime>
         <gml:TimeInstant>
            <gml:timePosition>2018-09-21T01:00:00.000Z</gml:timePosition>
         </gml:TimeInstant>
      </om:samplingTime>
      <om:resultTime>
         <gml:TimeInstant>
           xsi:schemaLocation="http://www.wldelft.nl/fews http://fews.wldelft.nl/schemas/version1.0/timeSeriesImportRun.xsd">
   <import> <gml:timePosition>2018-09-21T01:00:00.000Z</gml:timePosition>
         </gml:TimeInstant>
      <general></om:resultTime>
         <importType>CanadaMeteo</importType><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"/>
         <serverUrl>http://dd.meteo.gc.ca/observations/xml</serverUrl><om:observedProperty gml:remoteSchema="/schema/point-observation/2.0.xsd"/>
         <user>user</user><om:featureOfInterest>
         <password>password</password>
		 <!-- Time period has to be configured for the importer to work --><gml:FeatureCollection>
            <gml:location>
         <relativeViewPeriod  unit="hour" start="-5" end="0" startOverrulable="true" endOverrulable="true"/>
 <gml:Point>
          </general>
        <properties><gml:pos>44.745858 -63.661689</gml:pos>
         <!--Optional configuration field. Value is a comma separated string of the region folder to be included.-->      </gml:Point>
            </gml:location>
         <!--If it is not configured, data will be fetched from all folders for the specified time. Case sensitive.-->
   /gml:FeatureCollection>
      </om:featureOfInterest>
      <om:result>
         <elements>
      <!--Possible choices: AB, BC, MB, NB, NL, NS, NT, NU, ON, PE, QC, SK, YT-->
<element name="present_weather" uom="code" value="Partly Cloudy"/>
             <string key="RegionDirectory<element name="mean_sea_level" uom="kPa" value="AB, BC102.6"/>
          <!--Optional configuration field. Value is a comma separated string of the time folders to be included.--  <element name="tendency_amount" uom="kPa" value="0.20"/>
            <element name="tendency_characteristic" uom="code" value="rising"/>
         <!--If it is not configured, data will be fetched from all folders for the specified time.-->
<element name="horizontal_visibility" uom="km" value="24.1"/>
           <!--Possible choices: "hourly", "today", "yesterday"-- <element name="air_temperature" uom="Celsius" value="10.7"/>
         <string key="TimeDirectory   <element name="dew_point" uom="Celsius" value="hourly, today8.7"/>
      </properties>
      <timeSeriesSet>
   <element name="relative_humidity" uom="percent" value="87"/>
      <moduleInstanceId>CanadaMeteo</moduleInstanceId>
      <element name="wind_speed"  <valueType>scalar</valueType>uom="km/h" value="6"/>
         <parameterId>mean_sea_level</parameterId>
   <element name="wind_direction"     <locationId>3025481</locationId>uom="code" value="NW"/>
         <timeSeriesType>external historical</timeSeriesType>
  <element name="wind_gust_speed"      <timeStep unit="nonequidistantuom="km/h" value="15"/>
         <readWriteMode>add originals</readWriteMode>
      </timeSeriesSet>
   </import>
</timeSeriesImportRun>

If region directory is configured, special attention should be payed to make sure that the wanted locations are found 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.

WorkFlow example:

Code Block
languagexml
linenumberstrue
<?xml version="1.0" encoding="UTF-8"?>
<workflow xmlns="http://www.wldelft.nl/fews" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.wldelft.nl/fews http://fews.wldelft.nl/schemas/version1.0/workflow.xsd" version="1.1">
   <activity>
 <element name="total_cloud_cover" uom="code" value="5"/>
            <element name="wind_chill" uom="unitless" value=""/>
            <element name="humidex" uom="unitless" value=""/>
         <runIndependent>true<</runIndependent>elements>
      <moduleInstanceId>CanadaMeteo<</moduleInstanceId>om:result>
   </activity>om:Observation>
</workflow>

 

 

The importer module should be registered in FEWS  Config/RegionConfigFiles/ModuleInstanceDescriptors.xml. Locations of the wanted time series should be registered in Config/RegionConfigFiles/Locations.xml.  Parameters (such as mean sea level) should be registered in  Config/RegionConfigFiles/Parameter.xml.

The workflow should be registered in Config\RegionConfigFiles\WorkflowDescriptors.xml.

...

om:member>
</om:ObservationCollection>