FillMatrix User Manual

Copyright 2006 Instituto Superior Tcnico, Technical University of Lisbon

Lisbon, September de 2006 Version 1.0

MOHID User Meeting / Course

Index
1 INTRODUCTION ___________________________________________________________________ 1 1.1 1.2 1.3 TYPICAL USE ________________________________________________________________ 2 DATA INPUT REQUIREMENTS ____________________________________________________ 2 OUPUT _____________________________________________________________________ 3

2 INPUT FILE (FILLMATRIX.DAT) ____________________________________________________ 4 3 SAMPLE___________________________________________________________________________ 6

MOHID User Meeting / Course

1 Introduction
The FillMatrix application creates a grid data file or HDF5 file from data interpolated from XYZ or Time Series files. Running options for this application are specified by the user in an input file named FillMatrix.dat. This application considers georeferenced data in an interpolation process to obtain one or a time series of 2D fields usable in the MOHID framework. The interpolation process involves spatial interpolation, in the case of a time invariant 2D field, and spatial and time interpolation, in the case of a time series of 2D fields. The georeferenced data can be of two types: - time invariant: XYZ data, defined in a XYZ file or directly by the user in the input file; - time variant: time series data, defined in a time series file. The data location defined individually by the user in the input file is called a station. The output field is obtained for the desired property and can also be time invariant or time variant: - a time invariant field (grid data file) is obtained from spatial interpolation and time interpolation for a time instant specified by the user; - a time variant field (HDF5 file) is determined taking into account userdefined time window, a maximum time span and output times; the maximum 1

MOHID User Meeting / Course

time span is used in case of data lacking to control the process of interpolation: if a source of time variant data has data more distant in time from the desired output time than the maximum time span then this source is not considered in the interpolation. The interpolation in space can be accomplished using triangulation or inversedistance weighted method. In this second method the user can specify the inverse-distance weighting power and the maximum distance between the intended grid location and a data station for that station to be considered in the spatial interpolation. The interpolation in time is linear.

1.1 Typical use

Generate, from measurement networks data, initial or forcing data for MOHID Water models.

1.2 Data input requirements

A grid data file containing grid and mapping information for the intended output file. This is commonly a bathymetry file. One or more files containing data to use as the interpolation basis, which can consist in: - one XYZ file, if the intended output data field is not time variable; - one or more Time Series files, each representing a station, usable both in cases of time variable or non variable fields.

MOHID User Meeting / Course

Alternatively the use of data files can be ignored, being the data values for each station supplied by the user in the input file. The coordinate system must be the same in all files.

1.3 Ouput
A grid data or a HDF5 file, respectively in case a time invariant and a time variant field is generated.

MOHID User Meeting / Course

2 Input file (FillMatrix.dat)

Remarks: - output field can only be obtained for one property/parameter per FillMatrix application run; - although not required it is advisable that the attributed property/parameter name is consistent with the MOHID naming convention, so that the produced output file is readily used in other MOHID applications;

MOHID User Meeting / Course

- FillMatrix application assumes that the input georeferenced data is in the same coordinate system and property units requested for the output field; - in OUTPUT_TIME keyword (case VARIABLE_IN_TIME : 1) at least two values in seconds must be provided: the first value indicates the time in seconds after the start time when is made first output, the last value is the afterwards time step of the outputs; when more than two values are provided (maximum of 240 values) the values between the first and the last are considered the time, from the start time, of specific outputs, after which the time step value is considered for output: e.g. OUTPUT_TIME : 0 7200 21600 3600 means outputs at the start time, after 7200 seconds from start, after 21600 seconds from start and after every 3600 seconds; - the default value for the IWD_N keyword is considered by N.O.A.A. 1972,

National Weather Service River Forecast System forecast procedures, TM NWS

HYDRO-14, US Department of Commerce, Washington DC., adequate for interpolation of rainfall data.

MOHID User Meeting / Course

3 Sample