ZEITRIO: Difference between revisions

Revision as of 13:08, 17 November 2016

Basic Information

Name of Program

ZEITRIO

Version-Date

November 2016

Description-Date

November 2016

Catchwords

preprocessor
time series

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 or ASCII columns afterwards.

Input-Files

data file(s) with time series of type boewrt.dat.
data file(s) with time series of type solwrt.dat.
data file(s) with time series of type 6dph.dat.
data file(s) with time series of type trbnk.dat.
data file(s) with time series of type aander.dat.
data file(s) with time series of type dwdwin.dat.
data file(s) with time series of type WSA Bremen.
data file(s) with time series of type peg.dat.
data file(s) with time series of type pegel.his.
data file(s) with time series of type extab.dat (Excel table with separators Blanks, Tabs, comma, semicolon).
data file(s) with time series of type WSA Emden.
data file(s) with time series of type column oriented MATLAB matrix.
data file(s) with time series of type ZRX.
data file(s) with time series of type WOCE gauge data.
data file(s) with time series of type knoerg.bin.
data file(s) with time series of type CSV of the BfG "Pegel-Online" Service.
data file(s) with time series of type CSV provided by ftp://ftp-cdc.dwd.de/pub/CDC/ .
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.

data file with time series of type boewrt.dat (output modes 1 and 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)
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).
printer protocol file (zeitrio.sdr).
(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. 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

@@ Line 2: / Line 2: @@
 |name_de=ZEITRIO
 |name=ZEITRIO
-|version=October 2014
+|version=November 2016
-|version_descr=October 2014
+|version_descr=November 2016
 |catchwords=preprocessor<br />
 time series
 |shortdescription=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 or ASCII columns afterwards.
 |inputfiles=
-# data files with time series of type [[BOEWRT.DAT|boewrt.dat]].
+# data file(s) with time series of type [[BOEWRT.DAT|boewrt.dat]].
-# data files with time series of type [[SOLWRT.DAT|solwrt.dat]].
+# data file(s) with time series of type [[SOLWRT.DAT|solwrt.dat]].
-# data files with time series of type 6dph.dat.
+# data file(s) with time series of type 6dph.dat.
-# data files with time series of type trbnk.dat.
+# data file(s) with time series of type trbnk.dat.
-# data files with time series of type aander.dat.
+# data file(s) with time series of type aander.dat.
-# data files with time series of type dwdwin.dat.
+# data file(s) with time series of type dwdwin.dat.
-# data files with time series of type WSA Bremen.
+# data file(s) with time series of type WSA Bremen.
-# data files with time series of type peg.dat.
+# data file(s) with time series of type peg.dat.
-# data files with time series of type pegel.his.
+# data file(s) with time series of type pegel.his.
-# data files with time series of type extab.dat (Excel table with separators Blanks, Tabs, comma, semicolon).
+# data file(s) with time series of type extab.dat (Excel table with separators Blanks, Tabs, comma, semicolon).
-# data files with time series of type WSA Emden.
+# data file(s) with time series of type WSA Emden.
-# data files with time series of type column oriented MATLAB matrix.
+# data file(s) with time series of type column oriented MATLAB matrix.
-# data files with time series of type ZRX.
+# data file(s) with time series of type ZRX.
-# data files with time series of type WOCE gauge data.
+# data file(s) with time series of type WOCE gauge data.
-# data files with time series of type [[KNOERG.BIN|knoerg.bin]].
+# data file(s) with time series of type [[KNOERG.BIN|knoerg.bin]].
-# data files with time series of type CSV of the BfG "Pegel-Online" Service.
+# data file(s) with time series of type CSV of the BfG "Pegel-Online" Service.
-# data files with time series of type CSV provided by ftp://ftp-cdc.dwd.de/pub/CDC/ .
+# data file(s) with time series of type CSV provided by ftp://ftp-cdc.dwd.de/pub/CDC/ .
 # optional input data of type [[ZEITRIO.DAT|zeitrio.dat]]. This file defines time intervals in case that the output ([[BOEWRT.DAT|boewrt.dat]] only) should be devided into several seperate files of a certain length.
 |outputfiles=
 The number of output file types was limited to really useful standard formats.
-# data files with time series of type [[BOEWRT.DAT|boewrt.dat]] (output modes 1 and 2)..
+# data file with time series of type [[BOEWRT.DAT|boewrt.dat]] (output modes 1 and 2)..
-# data files with time series as ASCII-columns and a separate header file (a format which can be used with MATLAB, SCILAB or Mathematica)
+# data file with time series as ASCII-columns and a separate header file (a format which can be used with MATLAB, SCILAB or Mathematica)
-# data files with time series of type CSV with an one line header of type (Zeitpunkt; property 1; property 2; ....) for [http://www.deltares.nl/en/software/479962/delft-fews Delft-FEWS] (output mode 4).
+# data file with time series of type CSV with an one line header of type (Zeitpunkt; property 1; property 2; ....) for [http://www.deltares.nl/en/software/479962/delft-fews Delft-FEWS] (output mode 4).
 # printer protocol file (zeitrio.sdr).
 # (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 is read. Please note, that only one time series at one knot can be read and proccessed at the same time. The time series are wrote to a file using the format defined by the user. If writing [[BOEWRT.DAT|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. 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.
+|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|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. 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.
 |preprocessor=[[FFT]], [[GVIEW2D]], [[TSCALC]], [http://www.mathworks.co.uk/products/matlab/index.html?s_tid=gn_loc_drop MATLAB], [http://www.scilab.org/ SCILAB], [[TRIM-2D]], [[TRIM-3D]]
 |postprocessor=[[BOERND]], [[DATACONVERT]], [[EXCELENZ]], [[FFT]], [[FRQWF]], [[GVIEW2D]], [[ROSE]], [[TIDKEN]], [[TSCALC]], [[UTRRND]], [http://www.mathworks.co.uk/products/matlab/index.html?s_tid=gn_loc_drop MATLAB], [http://www.scilab.org/ SCILAB], [http://www.deltares.nl/en/software/479962/delft-fews Delft-FEWS]