Page History

...

Specifically a Web Coverage Service (WCS) returns a netCDF file from a structured url query.This documentation contains:

1) Data Provider Documentation

2) Sample Configuration

3) Instructions for Creating a Subset Grid, and,

4) Known issues

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

. Since version 2022.02 it is possible to access data that require authentication with username and password

The data can be downloaded on the same grid as DataMart is not subsetting is requested. If subsetting is requested, than a different grid will be requested.

 Instructions for Creating a Subset Grid are provided at the near the end of this documentation.

1) Data Provider Documentation

This service is hosted by the Meteorological Service of This service is hosted by the Meteorological Service of Canada:

For an overview of the Web Coverage Service, refer to: https://eccc-msc.github.io/open-data/msc-geomet/web-services_en/#web-coverage-service-wcs

...

The two variables accessed are precipitation (PC.nwp) and temperature (TA.nwp).

TimeseriesImportRun (Deterministic Forecast)

TimeseriesImportRun (Deterministic Forecast)

<timeSeriesImportRun 

<timeSeriesImportRun 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/timeSeriesImportRun.xsd">
	<import>
		<general>
			<importType>CanadaMeteoWCS</importType>
			<serverUrl>https://geo.weather.gc.ca/geomet?SERVICE=WCS&amp;VERSION=2.0.1&amp;REQUEST=GetCoverage</serverUrl>
			<relativeViewPeriod unit="hour" start="3" end="240" startOverrulable="true" endOverrulable="true"/>
			<idMapId>IdImportCanadaWCS</idMapId>
		</general>
		<!--startTimeShift and above start of 3 needs as precipitation is an accumulative variable not available at the first forecast time-->
		<startTimeShift>
			<parameterId>PC.nwp</parameterId>
			<relativePeriod start="-3" end="0" unit="hour"/>
		</startTimeShift>
		<properties>
			<string key="subsettingCrs" value="EPSG:4326"></>string>
		</properties>
		<timeSeriesSet>
			<moduleInstanceId>ImportGDPS</moduleInstanceId>
			<valueType>grid</valueType>
			<parameterId>PC.nwp</parameterId>
			<locationId>GDPS</locationId>
			<timeSeriesType>external forecasting</timeSeriesType>
			<timeStep unit="hour" multiplier="3"/>
			<readWriteMode>add originals</readWriteMode>
		</timeSeriesSet>
		<externUnit 	<string key="interpolation" value="value"></string>
			<string key="outputCrs" value="value"></string>
			<string key="rangeSubset" value="value"></string>
			<bool key="useSubset" value="true"></bool>
			<int key="delayInHours" value="24"></int>
		</properties>
		<timeSeriesSet>
			<moduleInstanceId>ImportGDPS</moduleInstanceId>
			<valueType>grid</valueType>
			<parameterId>PC.nwp</parameterId>
			<locationId>GDPS</locationId>
			<timeSeriesType>external forecasting</timeSeriesType>
			<timeStep unit="hour" multiplier="3"/>
			<readWriteMode>add originals</readWriteMode>
		</timeSeriesSet>
		<externUnit parameterId="PC.nwp" unit="kg m-2" cumulativeSum="true"/>
	</import>
	<import>
		<general>
			<importType>CanadaMeteoWCS</importType>
			<serverUrl>https://geo.weather.gc.ca/geomet?SERVICE=WCS&amp;VERSION=2.0.1&amp;REQUEST=GetCoverage</serverUrl>
			<relativeViewPeriod unit="hour" start="0" end="240" startOverrulable="true" endOverrulable="true"/>
			<idMapId>IdImportCanadaWCS</idMapId>
		</general>
		<properties>
			<string key="subsettingCrs" value="EPSG:4326"/>
		</properties>
		<timeSeriesSet>
			<moduleInstanceId>ImportGDPS</moduleInstanceId>
			<valueType>grid</valueType>
			<parameterId>TA.nwp</parameterId>
			<locationId>GDPS</locationId>
			<timeSeriesType>external forecasting</timeSeriesType>
			<timeStep unit="hour" multiplier="3"/>
			<readWriteMode>add originals</readWriteMode>
		</timeSeriesSet>
		<externUnit parameterId="TA.nwp" unit="K"/>
	</import>
</timeSeriesImportRun>

...

Property  subsettingCrs is optional. If not configured, the "&SUBSETTINGCRS=EPSG" will not be added to the url. 

TimeseriesImportRun (Ensemble Forecast with 21 members)

Property useSubset is optional. Default value is true. If set to false, no subset will be added to the url. Values will be pulled from the configured grid.

Properties interpolation, outputCrs,rangeSubset are optional. If configured, INTERPOLATION=configuredValue, OUTPUTCRS=configuredValue, RANGESUBSET=configuredValue will be added to the url, respectively.

Property delayInHours is optional. If configured DIM_REFERENCE_TIME=date will be aded to the url, where date is T0-delayInHours.

TimeseriesImportRun (Ensemble Forecast with 21 members)

The configuration code below is for the The configuration code below is for the REPS Ensemble Forecast with 21 members. 

...

1) Define the bounding box coordinates (https://boundingbox.klokantech.com/, try Dublincore below Copy and Paste for clarity)
2) Fill in the url query below:
https://geo.weather.gc.ca/geomet?SERVICE=WCS&VERSION=2.0.1&REQUEST=GetCoverage&COVERAGEID=$VARIABLE_ID$&SUBSETTINGCRS=EPSG:4326&SUBSET=x($westlimit$,$eastlimit$)&SUBSET=y($southlimit$,$northlimit$)&FORMAT=image/netcdf
where:
             $VARIABLE_ID$ is from the WCS getCapabilities, or from the externalIDs in this document.
              $westlimit$, $eastlimit$, $southlimit$ $northlimit$ are an integer bounding box
3) Paste the query in a webbrowser to download a sample file.
4) In your FEWS application, use the functionaility from the F12 menu --> Clipboard --> Copy grib geometry from file.
5) Paste the grid definition in your grids.xml file

4) Known issues

Subsetting definitions are currently required (original grids cannot be pulled). 

> Copy grib geometry from file.
5) Paste the grid definition in your grids.xml file. Save and reload FEWS.

6) Run the workflow in DEBUG mode to get the url query generated by FEWS.

7) Use this FEWS generated URL query in a browser to download an additional NetCDF file, then repeat steps 4 and 5.

4) Known issues

No known outstanding issuesDelays are not configurable, meaning that on Stand Alone the T0 may need to be slightly earlier than the current time.