GRIDCONVERT: Difference between revisions

Revision as of 12:52, 16 September 2011

Basic Information

Name of Program

GRIDCONVERT

Version-Date

September 2011

Description-Date

September 2011

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

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.

Output-Files

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, location_grid.dat and profil05.bin).

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

@@ Line 2: / Line 2: @@
 |name_de=GRIDCONVERT
 |name=GRIDCONVERT
-|version=July 2011
+|version=September 2011
-|version_descr=July 2011
+|version_descr=September 2011
 |catchwords=
 conversion of computational grids<br />
@@ Line 26: / Line 26: @@
 ::* [[UNTRIM_GRID.DAT|untrim_grid.dat]],
 ::* [[UTRSUB_GRID.DAT|utrsub_grid.dat]],
-::* [[PLTSUB_GRID.UPI|pltsub_grid.upi]], and
+::* [[PLTSUB_GRID.UPI|pltsub_grid.upi]],
-::* [[LOCATION_GRID.DAT|location_grid.dat]].
+::* [[LOCATION_GRID.DAT|location_grid.dat]], and
+::* [[PROFIL05.BIN|profil05.bin]].
 |outputfiles=
@@ Line 36: / Line 37: @@
 ::* [[UTRSUB_GRID.DAT|utrsub_grid.dat]],
 ::* [[PLTSUB_GRID.UPI|pltsub_grid.upi]], and
-::* [[CF-NETCDF.NC|cf-netcdf.nc]] (actual only [[GITTER05.DAT and GITTER05.BIN|gitter05.dat/bin]], [[UNTRIM_GRID.DAT|untrim_grid.dat]], [[UTRSUB_GRID.DAT|utrsub_grid.dat]] and [[LOCATION_GRID.DAT|location_grid.dat]]).
+::* [[CF-NETCDF.NC|cf-netcdf.nc]] (actual only [[GITTER05.DAT and GITTER05.BIN|gitter05.dat/bin]], [[UNTRIM_GRID.DAT|untrim_grid.dat]], [[UTRSUB_GRID.DAT|utrsub_grid.dat]],  [[LOCATION_GRID.DAT|location_grid.dat]] and [[PROFIL05.BIN|profil05.bin]]).
-|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.<br />
+|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.
 <P>
-''Notice'': You can add some optional information blocks to the input file. This is the way to put additional meta data, e.g. of the CF-convention, into the CF-NetCDF file.<br />
+''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|profil05.bin]] put the meta data in an ASCII-file with the same name and the extension '.dat'.<br />
 See example file:<br />
 ''$PROGHOME/examples/gridconvert/data/loc/lg.allCFinfo.dat'' or<br />
 ''$PROGHOME/examples/lib/h_grid/h_grid_test_g05_plus_CF_Info_input.dat'' or<br />
 ''$PROGHOME/examples/lib/h_grid/h_grid_test_utr_plus_CF_Info_input.dat'' or<br />
-''$PROGHOME/examples/lib/h_grid/h_grid_test_sub_plus_CF_Info_input.dat''
+''$PROGHOME/examples/lib/h_grid/h_grid_test_sub_plus_CF_Info_input.dat'' or<br />
+''$PROGHOME/examples/lib/p_grid/profil05.CF_Test.dat''.
 |preprocessor=[[Mathematical_Model_DELFT3D|DELFT3D]], [[JANET]], [[TELEMAC-2D]], [[UNTRIM]]