BOEWRT.DAT: Difference between revisions
From BAWiki
imported>Juerges Jens mNo edit summary |
imported>Seiss Guntram (Description of processing of the CRS and "magic comments") |
||
Line 3: | Line 3: | ||
|filetype=boewrt.dat | |filetype=boewrt.dat | ||
|version=September 2001 | |version=September 2001 | ||
|version_descr= | |version_descr=April 2014 | ||
|significance=contains measured or calculated time-series data for the usage in | |significance=contains measured or calculated time-series data for the usage in various programs. | ||
===Remarks about the new version=== | ===Remarks about the new version=== | ||
The file format is rather flexible:<br />inside the lines of data each of the time formates used by BAW is allowed.<br />Use ";" to separate datetime and physical values!<br />The date time format with two digit year should not be used further.<br />When it is used, the century after $BAWCENTURY (inclusive) is assumed. You should specify $BAWCENTURY inside your environment (DEFAULT: 1900).<br />The time zone is used only, when the used begin or end date have a defined time zone.<br />For this case MEZ is assumed for the file, when the file contains no time zone! | The file format is rather flexible:<br />inside the lines of data each of the time formates used by BAW is allowed.<br />Use ";" to separate datetime and physical values!<br />The date time format with two digit year should not be used further.<br />When it is used, the century after $BAWCENTURY (inclusive) is assumed. You should specify $BAWCENTURY inside your environment (DEFAULT: 1900).<br />The time zone is used only, when the used begin or end date have a defined time zone.<br />For this case MEZ is assumed for the file, when the file contains no time zone!<br /> | ||
The reading procedure supports the coordinate reference System in the following manner:<br /> | |||
If the environment variable $BAWCRS is set to a valid value (EPSG code), the station coordinate will be transformed to that system during the reading process on the fly. If the file CRS is not valid, the coordinate is used "as is". The user should set $BAWCRS when using the programs listed below.<br /> | |||
Files of type boewrt.dat may contain three Special comments at the top, which contain Minimum and Maximum time step and the FORTRAN Format of the data records. These comments are used to accelerate the reading procedure, when data are in ascending order in time and the records are uniformly formatted. On failure of reading a file, these comments should be erased. Files manipulated by an Editor should never contain these comments! | |||
|filecontents= | |filecontents= | ||
# nodenumber and (optional) timezone and coordinate system | # nodenumber and (optional) timezone and coordinate reference System (CRS). This record has to be written FORMATTED with FORTRAN-Format "(I10,1X,A4,1X,A5)". Preferably you should use known abbreviations for the time zones ("CET", "CEST", "UTC"). For the coordinate reference system of the station coordinate the EPSG codes used by BAW (see at [[GEOTRANSFORMER]] for example) should be used. | ||
# name of the | # name of the Location (written with FORTRAN-Format "(A)"). | ||
# coordinates (x,y) of the | # coordinates (x,y,z) of the Station position (unformatted with separating blanks!) | ||
# number and type-codes for the physical quantities stored in the file | # number and type-codes for the physical quantities stored in the file (FORTRAN-Format "(I10,nI8)". | ||
# date, time and data for each time-step stored | # date, time and data for each time-step stored. Preferably the date and time should be separated from the physical values by a ";"-character. | ||
|nutzerprogramme= | |nutzerprogramme= | ||
[[EVENTFILTER]], [[EXCELENZ]], [[EXKNO]], [[FD2MET]], [[FRQWF]], [[GEOTRANSFORMER]], [[GVIEW2D]], [[HVIEW2D]], [[MESKOR]], [[ROSE]], [[TIDKEN]], [[TSCALC]], [[UNTRIM2007MONITOR]], [[UTRRND]], [[VVIEW2D]], [[XTRDATA]], [[ZEITRIO]] | [[EVENTFILTER]], [[EXCELENZ]], [[EXKNO]], [[FD2MET]], [[FRQWF]], [[GEOTRANSFORMER]], [[GVIEW2D]], [[HVIEW2D]], [[MESKOR]], [[ROSE]], [[TIDKEN]], [[TSCALC]], [[UNTRIM2007MONITOR]], [[UTRRND]], [[VVIEW2D]], [[XTRDATA]], [[ZEITRIO]] | ||
|language= | |language=Fortran95 | ||
|fileform=FORMATTED | |fileform=FORMATTED | ||
|fileaccess=SEQUENTIAL | |fileaccess=SEQUENTIAL |
Revision as of 13:37, 3 April 2014
Basic Information
File-Type
boewrt.dat
File-Form
FORMATTED
Version
September 2001
Description-Date
April 2014
Significance of the File
contains measured or calculated time-series data for the usage in various programs.
Remarks about the new version
The file format is rather flexible:
inside the lines of data each of the time formates used by BAW is allowed.
Use ";" to separate datetime and physical values!
The date time format with two digit year should not be used further.
When it is used, the century after $BAWCENTURY (inclusive) is assumed. You should specify $BAWCENTURY inside your environment (DEFAULT: 1900).
The time zone is used only, when the used begin or end date have a defined time zone.
For this case MEZ is assumed for the file, when the file contains no time zone!
The reading procedure supports the coordinate reference System in the following manner:
If the environment variable $BAWCRS is set to a valid value (EPSG code), the station coordinate will be transformed to that system during the reading process on the fly. If the file CRS is not valid, the coordinate is used "as is". The user should set $BAWCRS when using the programs listed below.
Files of type boewrt.dat may contain three Special comments at the top, which contain Minimum and Maximum time step and the FORTRAN Format of the data records. These comments are used to accelerate the reading procedure, when data are in ascending order in time and the records are uniformly formatted. On failure of reading a file, these comments should be erased. Files manipulated by an Editor should never contain these comments!
File-Contents (in Catchwords)
- nodenumber and (optional) timezone and coordinate reference System (CRS). This record has to be written FORMATTED with FORTRAN-Format "(I10,1X,A4,1X,A5)". Preferably you should use known abbreviations for the time zones ("CET", "CEST", "UTC"). For the coordinate reference system of the station coordinate the EPSG codes used by BAW (see at GEOTRANSFORMER for example) should be used.
- name of the Location (written with FORTRAN-Format "(A)").
- coordinates (x,y,z) of the Station position (unformatted with separating blanks!)
- number and type-codes for the physical quantities stored in the file (FORTRAN-Format "(I10,nI8)".
- date, time and data for each time-step stored. Preferably the date and time should be separated from the physical values by a ";"-character.
Programs using this Type of File
EVENTFILTER, EXCELENZ, EXKNO, FD2MET, FRQWF, GEOTRANSFORMER, GVIEW2D, HVIEW2D, MESKOR, ROSE, TIDKEN, TSCALC, UNTRIM2007MONITOR, UTRRND, VVIEW2D, XTRDATA, ZEITRIO
Example-File
$PROGHOME/examples/zeitrio/boewrt.new.dat
$PROGHOME/examples/zeitrio/boewrt.dat
back to: File Descriptions