Generate HDG files for GEMSS
“hdg-from” is a simple command-line tool that generates HDG files for the Global Environment Modelling System for Subsurface waters (GEMSS).
For instance, if you have data produced by the Storm Water Management Model (SWMM), say in a text file my-data.txt in for instance, where the flow rates are in liters per second (LPS), as follows:
Table - Node 1 Total Inflow Days Hours (LPS) 0 00:15:00 0.18 0 00:30:00 2.30 0 00:45:00 2.06
You can use hdg-from to obtain the equivalent HDG file by entering.
$ hdg-from my-data.txt 3 observation(s) loaded from 'my-data.txt'. 'my-data.hdg' successfully generated.
In the generated file, named by default my-data.hdg, the flow values have been convert to cubic meters per day (CMD).
$GLLVHTTVDFile, V5.0 $Creation Date: 09/08/2017 08:52 $Waterbody Name: Node 1 $Created by: Unknown $Start Date: 01/01/2017 12:00 $End Date: 01/01/2017 12:45 $Number of Data Lines: 3 $X, Y, Station Height, Missing value,Profile Format, ExceFormat, Longitude, Latitude, Anemometer Height $Number of bins, Depth data type, TVD file type 62000,6957300,0,999999999,0,0,0,0,0 1,0,0 1 2,0,4,1.0,0,0.0,0.0,Flow Rate,Flow Rate $Year,Month,Day,Hour,Minute,Bin1,Flow Rate 2017,1,1,12,15,0,15.55 2017,1,1,12,30,0,198.72 2017,1,1,12,45,0,177.98
Below are the options that hdg-from accepts:
|-f <format>, --format <format>|
|The file format of the input file. So far only the SWMM format is available, but other may be supported in later versions.|
|-n <name>, --user-name <name>|
|The name of the user that creates the HDG file (see HDG Field Created By). Should be enclosed in double quotes if it contains space. By default, the user name is “Unknown”.|
|-o <file>, --output <file>|
|The HDG file to generate. By default, the generated file will have the same name as the given input file (only its extension will differ), as in the example above.|
|-s <date>, --start-date <date>|
|The date used as a starting point to convert simulated time into absolute time (see HDG Field State Date). Dates must adhere to the ISO 8601 standard such as 2017-01-01T12:00:00. By default, the date used is Jan. 1, 2017 at 12:00 AM.|
The flow rate unit that should be used in the HDG file. By default, HDG files use cubic meter per day (CMD), but the other options are:
|-w <name>, --water-body <name>|
|The name of the water body to set in the HDG file (see Field Waterbody Name). This will override the one read in the SWMM file, if any. Should be enclosed in double quotes if it contains spaces. By default, the name of the water body is read from the input file.|
|-h, --help||Show a similar description of the available options and exit.|
hdg-from is a simple Python 3.3+ application (also tested on Python 2.7) with no additional dependency. To install the latest stable release from the Pypi repository, the simplest way is to use pip as follows:
$ pip install hdgfrom
Alternatively, you may want to install the latest version under development. To this end, pip you can directly install the last commit on the Git repository, using:
$ pip install git+https://github.com/wudi312858/hdg-from