{{ProgramDescription
|name_de=DAVIT
|name=DAVIT
|version=2.23
|version_descr=March 2020
|catchwords=model results 
visualisation 
data exploration 
data analysis 
UGRID CF NetCDF 
DMQS metadata
Acknowledgment: ''This project took advantage of netCDF software developed by UCAR/Unidata ([http://www.unidata.ucar.edu/software/netcdf/ www.unidata.ucar.edu/software/netcdf/]).''
|shortdescription=Davit is an interactive tool for visualisation and exploration of results of hydronumerical models. Analysis of grids and results is possible as well. 2D and 3D data can be displayed. 
A sophisticated GUI enables intuitive use of Davit, see picture.
[[File:Davit_gui.png]]
It has been developed by [http://www.smileconsult.de/ smile consult GmbH], Hannover (Germany).
|inputfiles=
# ASCII format for point data, at the BAW [[GEOM.DAT|geom.dat]] (.xyz, .dat)
# AVS/Express UCD format (.inp)
# Basement result (.bmc)
# Bathymetric Attribute Grid Format (.bag)
# [[DIRZ.BIN|BDF]], Little Endian (.bin, .bdf)
# Bottom Friction Model (.gen)
# Current3DErg format (.bin)
# DFlowFM NetCDF (.nc)
# ESRI ASCII grid format (.asc, .dat, .grd, .txt)
# ESRI shape file (.shp)
# HydroAs2D results (.2dm)
# [[INSEL.DAT|insel.dat]] for structures (.dat)
# Janet binary format (.bin, .jbf)
# Keyhole Markup Language Format (.kml)
# Marina Randwerte Datei (.baw)
# Microstation (.dgn)
# NetCDF-Raster-Format (Postprocessing) (.nc) '''(since Sep. 2019)'''
# [[TECPLOT|Tecplot]] ASCII format (.plt)
# [[SELAFIN|TELEMAC mesh or results]](.bin, .sel, .res)
# [[GITTER05.DAT and GITTER05.BIN|TICAD ASCII file]] (.dat)
# TICAD syserg.bin (.bin)
# UGRID [[NetCDF|NetCDF]] format for bathymetries (.nc)
# UGRID [[NetCDF|NetCDF]] format post-processing (.nc)
# [[UNTRIM_GRID.DAT|UnTRIM_Grid_VC]] ASCII format (.dat, .grd)
# UnTRIM result, Big_Endian (.dat, .grd)
# UnTRIM result, Little_Endian (.dat, .grd)
# XDMF-/HDF5-Format (.xmf) '''(since Sep. 2019)'''
|outputfiles=
# ASCII format for point data, at the BAW [[GEOM.DAT|geom.dat]] (.xyz, .dat)
# Bathymetric Attribute Grid Format (.bag)
# BSquat Format (.xml)
# ESRI shape file (.shp)
# [[INSEL.DAT|insel.dat]] for structures (.dat)
# Janet binary format (.bin, .jbf)
# Keyhole Markup Language Format (.kml)
# [[SELAFIN|TELEMAC mesh or results]](.bin, .sel, .res)
# [[GITTER05.DAT and GITTER05.BIN|TICAD ASCII file]] (.dat)
# UGRID [[NetCDF|NetCDF]] format for bathymetries (.nc)
# [[UNTRIM_GRID.DAT|UnTRIM_Grid_VC]] ASCII format (.dat, .grd)
# XDMF-/HDF5-Format (.xmf) '''(since Sep. 2019)'''
# DMQS metadata in XML format
# DMQS metadata as PDF
# skripts for editing and moving DMQS files
# DMQS log file dmqs_generation.log
|methodology=
The functionality is based on a set of Java libraries, which are also used in the grid generator [[JANET|Janet]] and the digital terrain modeling tool Gismo. 
The output of DMQS metadata can be activated in DAVIT's screenshot menue. In active mode a DMQS XML describing the PNG and a DMQS XML describing the underlying NetCDF file is generated. How to generate the DMQS files can be found in these
[http://wiki.baw.de/de/index.php/Metadaten_von_Modellergebnissen_im_K%C3%BCstenwasserbau guidelines] (at present in German).
|preprocessor=[[DATACONVERT]], [[GRIDCONVERT]], [[NCAGGREGATE]], [[NCANALYSE]], [[NCCUTOUT]], [[NCDELTA]], [[NCDVAR]], [[UNK]], [[UNTRIM2007]], [[UNTRIM2]]
|postprocessor=[[GRIDCONVERT]], ParaView
|language=Java
|add_software=Java Runtime Environment
===Executables===
On Linux-Workstations start DAVIT in the command line window:
* davit [mmm]; mmm standing for the allocated memory in MegaByte.
On Windows PCs:
* open the command line window, e.g. via Total Commander -> commands -> command line window
* include %PROGHOME%\bin\win into your PATH variable
* davit_gei [mmm] for importing BDF files; mmm standing for the allocated memory in MegaByte. Maximum for Windows is 1150 MB.
* davit [mmm] for importing non-BDF files; mmm standing for the allocated memory in MegaByte. Maximum depends on the used hardware.
|contact_original=[http://www.smileconsult.de/ smile consult GmbH]
|contact_maintenance=[mailto:peter.schade@baw.de P. Schade], forwarding feedback to smile consult.
|documentation=The release notes are stored on BAW's file system in $PROGHOME\java\janet''k_mm_nn''\docs\ with k, mm and nn representing the version numbers. 
A function reference can be found under %PROGHOME%\java\janet2_15_10\docs\function_reference\funktionsreferenz.pdf. 
}}

NetCDF synoptic data for multiple profiles

2020-02-21T09:58:20Z

Ak3pscha: Link auf PDF erneuert

[[de:NetCDF Synoptische Daten auf Profilen]]

=Short Description=

Synoptic data for several profiles with different number of locations along each profile.

=Further Descriptions=
* [[NetCDF multiple profiles]]: coordinates and coordinate transformation for multiple profiles.
* [[NetCDF time coordinate]]: coordinate variable ''time''.
* [[NetCDF vertical coordinate]]: time and location dependent vertical coordinate.

=Version ''Discrete Sampling Geometry'' '''trajectoryProfile'''=

Data for multiple locations along one or several profiles (trajectories) are stored in a netCDF file in accordance with the concept of a ''Discrete Sampling Geometry'' with '''featureType=trajectoryProfile'''. An example (output from NCDUMP) for geometry as well as data is shown in [[Media:P_synop_ncdump_2D.pdf|P_synop_ncdump_2D.pdf]].

This type of data is essentially identical with [[netCDF synoptic data at multiple locations]]. All relevant differences, which are the same for all geophysical variables, are explained for variable water level.

float Mesh0_node_Wasserstand_2d(nMesh0_data_time, nMesh0_trajectory, nMaxMesh0_trajectory_nodes) ;
: :long_name = "Wasserstand [ node ]" ;
: :units = "m" ;
: :name_id = 3 ;
: :_FillValue = 1.e+31f ;
: :ancillary_variables = "Mesh0_node_Gesamtwassertiefe_2d" ;
: :cell_measures = "area: Mesh0_node_Wasserflaeche_2d" ;
: :cell_methods = "nMesh0_data_time: point area: mean" ;
: :comment = "ancillary variables may be used for visualization and data analysis as threshold and plot subgrid mask" ;
: :coordinates = "Mesh0_node_lon Mesh0_node_lat Mesh0_node_x Mesh0_node_y Mesh0_trajectory_long_name Mesh0_trajectory_node_distance" ;
: :grid_mapping = "Mesh0_crs" ;
: :standard_name = "sea_surface_height" ;

The following essential differences with respect to data defined for multiple locations exist:
# There are two instead of one (horizontal) dimensions: ''nMesh0_trajectory'' corresponds to the number of trajectories and ''nMaxMesh0_trajectory_nodes'' reflects the (maximum) number of locations for a trajectory. Using the two independent dimensions allows easy access to data along a single trajectory.
# Auxiliary coordinate variable '''Mesh0_trajectory_node_distance''' is available. With this coordinate variable it is easy to display data along a trajectory in dependence on coordinate profile-meter.

----
back to [[NetCDF]]
----
[[Overview]]

NetCDF synoptic data at multiple locations

2020-02-21T09:53:23Z

Ak3pscha: Link auf PDF erneuert

[[de:NetCDF Synoptische Daten an Einzelpositionen]]

=Short Description=

Synoptic data for multiple locations are described. A few examples for typical variables are shown.

=Additional Descriptions=

* [[NetCDF multiple locations]]: coordinates as well as coordinate transformation for multiple locations.
* [[NetCDF time coordinate]]: coordinate variable ''time''.
* [[NetCDF vertical coordinate]]: time and space dependent vertical coordinate variable.

=Version ''Discrete Sampling Geometry'' '''timeSeriesProfile'''=

Data for several individual locations are stored in a netCDF file in accordance with the concept of a ''Discrete Sampling Geometry'' with '''featureType=timeSeriesProfile'''. An example (output from NCDUMP) for geometry as well as data is shown in [[Media:L_synop_ncdump_2D.pdf|L_synop_ncdump_2D.pdf]].

==Data without Z-Dependence==

Water level typically depends on time and location. But it is independent from the z-coordinate. Water level is therefore a good example for a geophysical variable without z-dependence.

float '''Mesh0_node_Wasserstand_2d'''(nMesh0_data_time, nMesh0_node) ;
: :long_name = "Wasserstand [ node ]" ;
: :units = "m" ;
: :name_id = 3 ;
: :_FillValue = 1.e+31f ;
: :ancillary_variables = "Mesh0_node_Gesamtwassertiefe_2d" ;
: :cell_measures = "area: Mesh0_node_Wasserflaeche_2d" ;
: :cell_methods = "nMesh0_data_time: point nMesh0_node: mean" ;
: :comment = "ancillary variables may be used ..." ;
: :coordinates = "Mesh0_node_lon Mesh0_node_lat Mesh0_node_x Mesh0_node_y Mesh0_node_long_name" ;
: :grid_mapping = "Mesh0_crs" ;
: :standard_name = "sea_surface_height" ;

Remarks:
# Invalid data may be present (see ''_FillValue'').
# Auxiliary variable (see ''ancillary_variables'') '''Mesh0_node_Gesamtwassertiefe_2d''' may be used during processing (data analysis and visualization) to neglect data for locations with very shallow water.
# Water level is synoptic and (in our case) an area mean value (see ''cell_methods'').
# Variable '''Mesh0_node_Wasserflaeche_2d''' contains the relevant area for area mean values.
# Label coordinate variable '''Mesh0_node_long_name''' can be used for selection of locations (see ''coordinates'').

==Data with Z-Dependence==

Salinity typically depends on time, location and depth. In our case the z-coordinate reflects the center of water mass for the respective volume. Salinity is therefore a good example for a geophysical variable with z-dependence.

float Mesh0_node_Salzgehalt_2d(nMesh0_data_time, nMesh0_layer_2d, nMesh0_node) ;
: :long_name = "Salzgehalt [ node ]" ;
: :units = "1e-3" ;
: :name_id = 5 ;
: :_FillValue = 1.e+31f ;
: :ancillary_variables = "Mesh0_node_Gesamtwassertiefe_2d" ;
: :cell_measures = "volume: Mesh0_node_Wasservolumen_2d area: Mesh0_node_Wasserflaeche_2d" ;
: :cell_methods = "nMesh0_data_time: point nMesh0_layer_2d: mean nMesh0_node: mean" ;
: :comment = "ancillary variables may be used ..." ;
: :coordinates = "Mesh0_node_lon Mesh0_node_lat Mesh0_node_x Mesh0_node_y Mesh0_node_z_node_2d Mesh0_node_long_name" ;
: :grid_mapping = "Mesh0_crs" ;
: :standard_name = "sea_water_salinity" ;

Remarks:
# Invalid data may be present (see ''_FillValue'').
# Auxiliary variable (see ''ancillary_variables'') '''Mesh0_node_Gesamtwassertiefe_2d''' may be used during processing (data analysis and visualization) to neglect data for locations with very shallow water.
# Salinity is synoptic and (in our case) an volume mean value (see ''cell_methods'').
# Variable '''Mesh0_node_Wasservolumen_2d''' contains the relevant volume for volume mean values.
# With additional help of '''Mesh0_node_Wasserflaeche_2d''' exact values for salt mass per area can be derived.
# Label coordinate variable '''Mesh0_node_long_name''' can be used for selection of locations (see ''coordinates'').

==Data for several Fractions==

Suspended sediment concentration typically depends on time, location and depth. Also different sediment fractions ''nMesh0_suspension_classes'' can be available. In our case the z-coordinate reflects the center of water mass for the respective volume. Suspended sediment concentration is therefore a good example for a geophysical variable with dependence on a label coordinate variable for one or more fractions.

float Mesh0_node_Schwebstoffgehalt_2d(nMesh0_data_time, nMesh0_suspension_classes, nMesh0_layer_2d, nMesh0_node) ;
: :long_name = "Schwebstoffgehalt [ node ]" ;
: :units = "kg m-3" ;
: :name_id = 7 ;
: :_FillValue = 1.e+31f ;
: :ancillary_variables = "Mesh0_node_Gesamtwassertiefe_2d" ;
: :cell_measures = "volume: Mesh0_node_Wasservolumen_2d area: Mesh0_node_Wasserflaeche_2d" ;
: :cell_methods = "nMesh0_data_time: point nMesh0_suspension_classes: point nMesh0_layer_2d: mean nMesh0_node: mean" ;
: :comment = "ancillary variables may be used ..." ;
: :coordinates = "Mesh0_node_lon Mesh0_node_lat Mesh0_node_x Mesh0_node_y Mesh0_node_z_node_2d Mesh0_node_long_name Mesh0_Schwebstoffklassen_2d" ;
: :grid_mapping = "Mesh0_crs" ;
: :standard_name = "concentration_of_suspended_matter_in_sea_water" ;

Remarks:
# Invalid data may be present (see ''_FillValue'').
# Auxiliary variable (see ''ancillary_variables'') '''Mesh0_node_Gesamtwassertiefe_2d''' may be used during processing (data analysis and visualization) to neglect data for locations with very shallow water.
# Suspended sediment concentration is synoptic and (in our case) an volume mean value (see ''cell_methods'').
# Variable '''Mesh0_node_Wasservolumen_2d''' contains the relevant volume for volume mean values.
# With additional help of '''Mesh0_node_Wasserflaeche_2d''' exact values for suspended sediment mass per area can be derived.
# Label coordinate variable '''Mesh0_node_long_name''' can be used for selection of locations (see ''coordinates'').
# Label coordinate variable '''Mesh0_Schwebstoffklassen_2d''' can be used for selection of fractions (see ''coordinates'').

----
back to [[NetCDF]]
----
[[Overview]]