GRIDCONVERT

Basic Information

Name of Program

GRIDCONVERT

Version-Date

July 2012

Description-Date

July 2012

Catchwords

conversion of computational grids
read and write computational grids in different file formats

Short Description of Functionality

Program GRIRDCONVERT can be used to convert computational grids for different mathematical methods:

• between different file formats but identical structure of the computational grid,
• between different grid types and different file formats,
• refinement (factor 4) of an UNTRIM grid, as well as
• flattening of all sub grid scale bathymetry variations within all grid cells and along all edges.

Due to some specific properties of computational grids for mathematical methods the number of possible conversions remains naturally very limited. The grid will not be optimized automatically with respect to the specific requirements of the different mathematical models.

Input-Files

1. computational grid (input formats)

The following file formats are currently supported:

• delft3d.grd, delft3d.dep, delft3d.enc, delft3d.dry,
• delft3d.thd, delft3d.lwl, delft3d.ext as well as delft3d.bnd,
• gitter05.dat/bin,
• selafin,
• untrim_grid.dat,
• utrsub_grid.dat,
• pltsub_grid.upi,
• location_grid.dat, and
• profil05.bin.

1. (optional) global metadata

• nc_meta.dat.

In case file nc_meta.dat is present in the current working directory, this file will be read by the application. Otherwise the respective file from $PROGHOME/cfg will be read.

Output-Files

1. computational grid (output formats)

The following file formats are currently supported:

• gitter05.dat/bin,
• untrim_grid.dat,
• utrsub_grid.dat,
• pltsub_grid.upi, and
• cf-netcdf.nc (actual only gitter05.dat/bin, untrim_grid.dat, utrsub_grid.dat, pltsub_grid.upi, location_grid.dat and profil05.bin).

Remark: In case the files utrsub_grid.dat and pltsub_grid.upi are both present in the working directory, all data related to the so called plot subgrid will be transferred to the NetCDF file. If the latter file is missing, no data related to the plot subgrid will be stored in the NetCDF file.

Methodology

The computational grid informations are converted using various methods from the software package H_GRID as well as written to file in different formats. Files with informations concerning locations are converted by the software package called L_GRID. Software package P_GRID converts files with profile grid data.

Notice: You can add some optional information blocks to the input file (except: profil05.bin). This is the way to put additional meta data, e.g. of the CF-convention, into the CF-NetCDF file. To add CF informations to a file of type profil05.bin put the meta data in an ASCII-file with the same name and the extension '.dat'.
See example file:
$PROGHOME/examples/gridconvert/data/loc/lg.allCFinfo.dat or
$PROGHOME/examples/lib/h_grid/h_grid_test_g05_plus_CF_Info_input.dat or
$PROGHOME/examples/lib/h_grid/h_grid_test_utr_plus_CF_Info_input.dat or
$PROGHOME/examples/lib/h_grid/h_grid_test_sub_plus_CF_Info_input.dat or
$PROGHOME/examples/lib/p_grid/profil05.CF_Test.dat.

Program(s) to run before this Program

DELFT3D, JANET, TELEMAC-2D, UNTRIM

Program(s) to run after this Program

DATACONVERT, HVIEW2D, JANET, UNTRIM, UTRPRE

Additional Information

Language

Fortran90

Additional software

-

Original Version

G. Lang

Maintenance

G. Lang, S. Spohr,

Documentation/Literature

example files:
$PROGHOME/examples/gridconvert/
$PROGHOME/examples/gridconvert/data/loc/

Further informations:
All NetCDF conventions, which are relevant to store the typical BAW-specific data, are documented in the NetCDF-Pages of BAW-Wiki.

---

back to Program Descriptions

---

Overview