Skip to content

Commit

Permalink
updated gridmap file description
Browse files Browse the repository at this point in the history
  • Loading branch information
BrianOBlanton authored Nov 15, 2023
1 parent 6ab8153 commit c17f92d
Showing 1 changed file with 20 additions and 14 deletions.
34 changes: 20 additions & 14 deletions doc/source/gridmap.rst
Original file line number Diff line number Diff line change
@@ -1,25 +1,31 @@

####################################
The **grid_to_stationfile_maps.yml**
**grid_to_stationfile_maps.yml**
####################################

This yaml file contains pointers to files ADDA needs in order to retrieve specific NOAA/NOS station observations and corresponding ADCIRC grid nodes at which to compute the errors, and specify "control" points in open water and on land to constraint the resulting surface evaluation. For each ADCIRC grid, it specifies locations of 3 files:

* **NOAA_STATIONS** - csv file containing NOAA / NOS ids and ADCIRC grid nodes. The file can have lots of info in it, but must have stationid and Node as columns in the first line, and "units" second line. Other columns are ignored. E.g.,

serial_nr,stationid,stationname,state,vertical_datum,NOAA lon,NOAA lat,navd_to_msl [ft],navd_to_msl [m],Datum Source,lon,lat,bathy,Element,Node
-,-,-,-,-,deg,deg,ft,m,-,deg,deg,m MSL,-,-
1,8410140,Eastport Passamaquoddy Bay,ME,MSL,-66.982315,44.903300,0.2300,0.0701,NOAA gage,-66.982315,44.903300,36.7010,2034577,1034613
2,8413320,Bar Harbor,ME,MSL,-68.205000,44.391700,0.2760,0.0841,NOAA gage,-68.203000,44.393000,4.5782,2287004,1162475
...
.. code-block:: text
serial_nr,stationid,stationname,state,Element,Node
-,-,-,-,-,-
1,8410140,Eastport Passamaquoddy Bay,ME,2034577,1034613
2,8413320,Bar Harbor,ME,2287004,1162475
3,8418150,Portland,ME,2314208,1176249
4,8419317,Wells,ME,2327314,1182888
...
* **LANDCONTROL** - csv file containing "land" lon/lat locations and surface values to force the surface toward:

lon,lat,val
-60,50,0.
-80,55,0.
-100,50,0.
-110,30,0.
.. code-block:: text
lon,lat,val
-60,50,0.
-80,55,0.
-100,50,0.
-110,30,0.
* **WATERCONTROL** - csv file containing open-water lon/lat locations and surface values, same format as the LANDCONTROL file

Expand All @@ -38,10 +44,10 @@ The ADDA repo and **grid_to_stationfile_maps.yml** contain files for the HSOFS a
WATERCONTROL: "PATHTO/adda_for_floodwater/gridmap/ec95d_water_control_list.dat"
Gridnames in the grid_to_stationfile_maps.yml file must be in **ALL_CAPS**, and must match (modulo the case) the grid name as defined in the grid's config json file, as in (e.g., PATHTO/ecflow_configs/ec95d/config.json)
Gridnames in the grid_to_stationfile_maps.yml file must be in **ALL_CAPS**, and must match (modulo the case) the grid name as defined in the grid's config json file, as in (e.g., PATHTO/ecflow_configs/hsofs/config.json)

.. code-block:: yaml
name: ec95d
dt: 10
name: hsofs
dt: 2

0 comments on commit c17f92d

Please sign in to comment.