GINA result files: Difference between revisions
m (Froehlich moved page GBL-Format to GINA result files) |
(→GINA binary WEL format (*.GBL): update from https://github.com/bluemodel/BlueM.Wave/pull/212) |
||
| (One intermediate revision by the same user not shown) | |||
| Line 1: | Line 1: | ||
{{Wave_nav}} | {{Wave_nav}} | ||
'''[https://bgswasser.de/kompetenzen/software/gina/ GINA]''' is a model used for calculating hydrographs of discharge and pollution concentrations from sewage systems. It outputs result files in the following formats which can be read by Wave: | |||
The | == GINA CSV WEL format (<code>*.CSV</code>) == | ||
The GINA CSV WEL format is a CSV format with semicolon separator and additional header lines. | |||
Example: | |||
<pre> | |||
Gew.Typ.:;19 ;; | |||
Grundlast:; 1069.200; l/s; | |||
AEO:; 13.500; km2; | |||
AEOpnat:; 13.728; km2; | |||
T Datum Zeit ; Q_zu; Q_ab; tf; | |||
- ;l/s;l/s;min; | |||
01.01.2003 00:00 ; 1069.2; 1069.2; 10.90; | |||
01.01.2003 00:05 ; 1069.2; 1069.2; 10.90; | |||
01.01.2003 00:10 ; 1069.2; 1069.2; 10.90; | |||
01.01.2003 00:15 ; 1069.2; 1069.2; 10.90; | |||
01.01.2003 00:20 ; 1069.2; 1069.2; 10.90; | |||
01.01.2003 00:25 ; 1069.2; 1069.2; 10.90; | |||
01.01.2003 00:30 ; 1069.2; 1069.2; 10.90; | |||
</pre> | |||
The | == GINA binary WEL format (<code>*.GBL</code>) == | ||
The GBL format is a proprietary binary format used to store time series data. | |||
If the GBL file is produced as part of a pollutant scenario, it contains 21 data columns.<br/> | |||
If it is produced as part of a hydraulic scenario, it contains 3 data columns. | |||
=== File Structure === | |||
==== Header Record ==== | |||
The first 8 bytes contain a 64-bit floating-point value (double) with the value −999.0. | |||
The next 4 bytes contain a 32-bit floating-point value (single) with the value: | |||
* −1.0 for pollutant scenario files | |||
* −2.0 for hydraulic scenario files | |||
The remaining bytes in the header are zero-filled: | |||
* 80 bytes of 0.0 for pollutant scenario files | |||
* 8 bytes of 0.0 for hydraulic scenario files | |||
==== Data Records ==== | |||
Each record contains: | |||
Column 1: Timestamp (8 bytes, double) — number of hours since 01.01.1601 | |||
Remaining columns: Data values (single, 4 bytes each) | |||
* 21 columns for pollutant scenarios | |||
* 3 columns for hydraulic scenarios | |||
[[Category:BlueM.Wave]] | [[Category:BlueM.Wave]] | ||
[[Category:Timeseries formats]] | [[Category:Timeseries formats]] | ||
Latest revision as of 08:56, 9 October 2025
Wave | Download | Development
GINA is a model used for calculating hydrographs of discharge and pollution concentrations from sewage systems. It outputs result files in the following formats which can be read by Wave:
GINA CSV WEL format (*.CSV)
The GINA CSV WEL format is a CSV format with semicolon separator and additional header lines.
Example:
Gew.Typ.:;19 ;; Grundlast:; 1069.200; l/s; AEO:; 13.500; km2; AEOpnat:; 13.728; km2; T Datum Zeit ; Q_zu; Q_ab; tf; - ;l/s;l/s;min; 01.01.2003 00:00 ; 1069.2; 1069.2; 10.90; 01.01.2003 00:05 ; 1069.2; 1069.2; 10.90; 01.01.2003 00:10 ; 1069.2; 1069.2; 10.90; 01.01.2003 00:15 ; 1069.2; 1069.2; 10.90; 01.01.2003 00:20 ; 1069.2; 1069.2; 10.90; 01.01.2003 00:25 ; 1069.2; 1069.2; 10.90; 01.01.2003 00:30 ; 1069.2; 1069.2; 10.90;
GINA binary WEL format (*.GBL)
The GBL format is a proprietary binary format used to store time series data.
If the GBL file is produced as part of a pollutant scenario, it contains 21 data columns.
If it is produced as part of a hydraulic scenario, it contains 3 data columns.
File Structure
Header Record
The first 8 bytes contain a 64-bit floating-point value (double) with the value −999.0.
The next 4 bytes contain a 32-bit floating-point value (single) with the value:
- −1.0 for pollutant scenario files
- −2.0 for hydraulic scenario files
The remaining bytes in the header are zero-filled:
- 80 bytes of 0.0 for pollutant scenario files
- 8 bytes of 0.0 for hydraulic scenario files
Data Records
Each record contains:
Column 1: Timestamp (8 bytes, double) — number of hours since 01.01.1601
Remaining columns: Data values (single, 4 bytes each)
- 21 columns for pollutant scenarios
- 3 columns for hydraulic scenarios