View Source

Imports high- and low-tide water level data linked to tide numbers from file in NETCDF-CF format

Overview

This import is available in DELFT-FEWS versions 2022.02 (RWS) and later

Water level time series data, which has been analyzed to determine high- and low-tide water levels and assigned standardized tide numbers (e.g. using the package HATYAN for the North Sea), can be stored in a specific NetCDF format, in which the high- and low-tide water levels are referenced by their tide number (a unique identifier given to each tidal cycle), rather than time, as the main dimension. Time information is still available, but is stored as a separate variable that is referenced per tide number and location.

The NETCDF-TIDAL_TIMESERIES option imports such data from NetCDF files which were written by the NETCDF-TIDAL_TIMESERIES Export

Some details:

The <properties> section of the configuration is used to specify (1) a list of all the variables to export, (2) the name of the time variable (different for high and low water levels), and (3) the name of the tide number variable. Note: This section may be simplified in the future, as some of this information is also available in the idMap.
It is possible to import an additional parameter referenced per tide number, such as the amount of surge present at each high/low water level.
It is possible to only import high water levels (or low water levels), by simply leaving those parts out of the configuration.
For this to work, you also need to configure the tideNumberParameterId in Parameters.xml

Configuring the import

An example of the NETCDF-TIDAL_TIMESERIES import configuration is provided below. This example imports both high and low water levels. You can simplify this by deleting the configuration that doesn't apply for you (e.g. parts related to low water).

<?xml version="1.0" encoding="UTF-8"?>
<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>NETCDF-TIDAL_TIMESERIES</importType>
			<folder>%IMPORT_FOLDER%/tide_levels</folder>
			<fileNamePatternFilter>HWLW_tidenumber_*.nc</fileNamePatternFilter>
			<deleteImportedFiles>false</deleteImportedFiles>
			<idMapId>IdImport_HWLW</idMapId>
			<unitConversionsId>ImportUnitConversions</unitConversionsId>
			<importTimeZone>
				<timeZoneOffset>+00:00</timeZoneOffset>
			</importTimeZone>
			<dataFeedId>HWLW</dataFeedId>
		</general>
		<properties>
            <string key="variables" value="waterlevel_LW,waterlevel_HW"/>
			<string key="waterlevel_LW" value="time_LW,LWno"/>
			<string key="waterlevel_HW" value="times_HW,HWno"/>
        </properties>
		<timeSeriesSet>
			<moduleInstanceId>Import_HWLW</moduleInstanceId>
			<valueType>scalar</valueType>
            <parameterId>WL.simulated</parameterId>
            <qualifierId>extreme_Low</qualifierId>
			<locationSetId>Locations_HWLW</locationSetId>
			<timeSeriesType>simulated forecasting</timeSeriesType>
			<timeStep unit="nonequidistant"/>
			<readWriteMode>add originals</readWriteMode>
		</timeSeriesSet>
		<timeSeriesSet>
			<moduleInstanceId>Import_HWLW</moduleInstanceId>
			<valueType>scalar</valueType>
			<parameterId>HWLW_nr</parameterId>
			<qualifierId>extreme_Low</qualifierId>
			<locationSetId>Locations_HWLW</locationSetId>
			<timeSeriesType>simulated forecasting</timeSeriesType>
			<timeStep unit="nonequidistant"/>
			<readWriteMode>add originals</readWriteMode>
		</timeSeriesSet>
		<timeSeriesSet>
			<moduleInstanceId>Import_HWLW</moduleInstanceId>
			<valueType>scalar</valueType>
            <parameterId>WL.simulated</parameterId>
            <qualifierId>extreme_Peak</qualifierId>
			<locationSetId>Locations_HWLW</locationSetId>
			<timeSeriesType>simulated forecasting</timeSeriesType>
			<timeStep unit="nonequidistant"/>
			<readWriteMode>add originals</readWriteMode>
		</timeSeriesSet>
		<timeSeriesSet>
			<moduleInstanceId>Import_HWLW</moduleInstanceId>
			<valueType>scalar</valueType>
			<parameterId>HWLW_nr</parameterId>
			<qualifierId>extreme_Peak</qualifierId>
			<locationSetId>Locations_HWLW</locationSetId>
			<timeSeriesType>simulated forecasting</timeSeriesType>
			<timeStep unit="nonequidistant"/>
			<readWriteMode>add originals</readWriteMode>
		</timeSeriesSet>
    </import>

Configuring the idMap

An example of the corresponding idMap is provided below.

<?xml version="1.0" encoding="UTF-8"?>
<idMap version="1.1" 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/idMap.xsd">
	<function externalLocationFunction="@NARWL_ID@" internalParameter="HWLW_nr" internalQualifier1="extreme_Low" externalParameterFunction="LWno" internalLocationSet="Locations_HWLW"/>
	<function externalLocationFunction="@NARWL_ID@" internalParameter="HWLW_nr" internalQualifier1="extreme_Peak" externalParameterFunction="HWno" internalLocationSet="Locations_HWLW"/>
	<function externalLocationFunction="@NARWL_ID@" internalParameter="WL.simulated" internalQualifier1="extreme_Low" externalParameterFunction="waterlevel_LW" internalLocationSet="Locations_HWLW"/>
	<function externalLocationFunction="@NARWL_ID@" internalParameter="WL.simulated" internalQualifier1="extreme_Peak" externalParameterFunction="waterlevel_HW" internalLocationSet="Locations_HWLW"/>
</idMap>