GINA result files: Difference between revisions

From BlueM
Jump to navigation Jump to search
(added GINA CSV WEL)
(→‎GINA binary WEL format (*.GBL): update from https://github.com/bluemodel/BlueM.Wave/pull/212)
 
Line 24: Line 24:


== GINA binary WEL format (<code>*.GBL</code>) ==
== GINA binary WEL format (<code>*.GBL</code>) ==
The GINA binary wel (GBL) format is a proprietary binary format for timeseries. It consists of 21 fixed data columns.
The GBL format is a proprietary binary format used to store time series data.


The first column contains the timestamp as a 8 bytes double. The timestamp is defined as hours since 01.01.1601.
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.


The remaining columns are data columns stored as 4 bytes single.
=== 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.png 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