GRIDCONVERT

Basic Information

Name of Program

GRIDCONVERT

Version-Date

April 2019

Description-Date

September 2022

Catchwords

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

Acknowledgment: This project took advantage of netCDF software developed by UCAR/Unidata (www.unidata.ucar.edu/software/netcdf/).

Short Description of Functionality

The program GRIDCONVERT 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 and
• conversion of constructions in insel.dat files.

In addition to that also the following functionality is available:

• compute some statistical data for a grid,
• find some differences between two grids, and
• compare initial bathymetry used with UNTRIM between cases one-grid simulation versus two-grid simulation.

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,
• profil05.bin and
• insel.dat (which does not contain a computational grid but structures as groynes or islands).

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,
• insel.dat and
• cf-netcdf.nc (actual only gitter05.dat/bin, insel.dat, 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 information concerning locations are converted by the software package called L_GRID. The software package P_GRID converts files with profile grid data.:
The software package IO_INSEL converts construction data of insel.dat files. GRIDCONVERT enables the user to select the construction types, e.g. "DAMM", which should be converted.

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 or
$PROGHOME/examples/gridconvert/data/ins/insel.all.dat

Program(s) to run before this Program

DAVIT, DELFT3D, JANET, TELEMAC-2D, UNTRIM

Program(s) to run after this Program

DATACONVERT, DAVIT, HVIEW2D, JANET, NCANALYSE, NCAUTO, NCCHUNKIE, NCPLOT, NC2TABLE, UNTRIM, UTRPRE and diverse NetCDF-Tools, e.g. NCPLOT, QUICKPLOT

Additional Information

Language

Fortran90

Additional software

-

Original Version

G. Lang

Maintenance

Working group PRE

Documentation/Literature

example files:
$PROGHOME/examples/gridconvert/,
$PROGHOME/examples/gridconvert/data/loc/,
$PROGHOME/examples/gridconvert/data/ins/ (insel.dat).

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