Actions

ZEITRIO

From BAWiki

Basic Information

Name of Program

ZEITRIO

Version-Date

April 2018

Description-Date

April 2018

Catchwords

preprocessor
time series
concatenation

Short Description of Functionality

The program ZEITRIO reads and writes data files, that contain time series in different formats. It is possible to read the file-types listed below. They can be wrote as boewrt.dat, as ASCII columns or CSV format afterwards. Concatenation of multible files is supported.

Input-Files

  1. data file(s) with time series of type boewrt.dat.
  2. data file(s) with time series of type solwrt.dat.
  3. data file(s) with time series of type 6dph.dat.
  4. data file(s) with time series of type trbnk.dat.
  5. data file(s) with time series of type aander.dat.
  6. data file(s) with time series of type dwdwin.dat.
  7. data file(s) with time series of type WSA Bremen.
  8. data file(s) with time series of type peg.dat.
  9. data file(s) with time series of type pegel.his.
  10. data file(s) with time series of type extab.dat (Excel table with separators Blanks, Tabs, comma, semicolon).
  11. data file(s) with time series of type WSA Emden.
  12. data file(s) with time series of type column oriented MATLAB matrix.
  13. data file(s) with time series of type ZRX.
  14. data file(s) with time series of type WOCE gauge data.
  15. data file(s) with time series of type knoerg.bin.
  16. data file(s) with time series of type CSV of the BfG "Pegel-Online" Service.
  17. data file(s) with time series of type CSV provided by ftp://ftp-cdc.dwd.de/pub/CDC/ .
  18. optional input data of type zeitrio.dat. This file defines time intervals in case that the output (boewrt.dat only) should be devided into several seperate files of a certain length.

Output-Files

The number of output file types was limited to really useful standard formats.

  1. data file with time series of type boewrt.dat (output modes 1 and 2)..
  2. data file with time series as ASCII-columns and a separate header file (a format which can be used with MATLAB, SCILAB or Mathematica)
  3. data file with time series of type CSV with an one line header of type (Zeitpunkt; property 1; property 2; ....) for Delft-FEWS (output mode 4).
  4. printer protocol file (zeitrio.sdr).
  5. (optional) terminal input protocol of type gkslog.dat.

Methodology

After defining a reference date, which is important when reading or writing a file with relative time information (e.g. solwrt.dat) a time series file is read. Please note, that only one time series at one knot can be read and proccessed at the same time. Optionally further time series files can be concatenated then. The file type can be swiched for each file to read. After reading process has finished, the time series wil be ordered chonologically and double as well as unvalid times are rejected.

The time series are wrote to a file using the format defined by the user. If writing boewrt.dat there is the additional possiblity to write defined time intervalls (e.g. days) into seperate files. The date of the day is part of the file name.

Optionally the time series will be interpolated to equidistant time steps. Larger time gaps can optionally filled with a dummy value (fill value, output mode 1) or eliminated (output mode 2) on output. The printer protocol file provides information about significant gaps in time axis. Interpolation of smaller gaps is be done alternatevly by spline or linear interpolation.

The output time period is determined by the interactive user input. If several input files are read during one cycle, the first start time and last end time determine the output period. If output mode 1 is choosen, eventually fill values are added during equidistant interpolation.

Time series of type MATLAB matrix, ZRX or "exctab.dat" can be filtered and recalculated with an offset and scaling for the data values. Absolute date and time will always be calculated by special operators with high accuracy.

An executable is available for LINUX as well as WINDOWS platforms.

Program(s) to run before this Program

FFT, GVIEW2D, TSCALC, MATLAB, SCILAB, TRIM-2D, TRIM-3D

Program(s) to run after this Program

BOERND, DATACONVERT, EXCELENZ, FFT, FRQWF, GVIEW2D, ROSE, TIDKEN, TSCALC, UTRRND, MATLAB, SCILAB, Delft-FEWS

Additional Information

Language

Fortran95

Additional software

NTv2 mesh files for coordinate transformation (see also GEOTRANSFORMER).

Original Version

J. Jürges

Maintenance

J. Jürges G. Seiß

Documentation/Literature

$PROGHOME/examples/zeitrio


back to Program Descriptions


Overview