Actions

VVIEW2D

From BAWiki

Basic Information

Name of Program

VVIEW2D

Version-Date

July 2012

Description-Date

July 2012

Catchwords

graphical postprocessor
finite element models
finite difference models
graphical presentation of data
vertical sections along profiles
universal direct access data format
coloured isosurface representation
isoline representation
vector arrow representation
vector circle representation
hatched isosurface representation
visualization of CFD-data for estuaries and coastal seas
time-varying (morpho-) dynamic bathymetry

Short Description of Functionality

The graphical postprocessor VVIEW2D can be used for a scaled graphical presentation of different scalar or vector quantities in 2D vertical sections. The data can be generated by means of different application programs. Either a single data set or a superposition of a scalar and a vector quantity can be plotted in several different ways. Beyound the generation of a pure graphical representation of the data some additional graphical elements (e.g. company logo, etc.) can be easily integrated into each figure. The vertical sections are defined over arbitrary longitudinal profiles described as polygon lines.

The following methods of graphical presentation of data are actually integrated into VVIEW2D. Here comes a short list together with some example figures:

Construction as well as appearance of the data presented can be easily modified using different switches from within the application program in an interactive way by the user (see switches of the program VVIEW2D).

Display of a physical vector quantity in a vertical section can be done in the following different ways:

  1. Display of the value of the vector quantity as a background coloured isosurface representation (or hatching representation alternatively) can be overlaid by
    1. vector arrows of constant length to demonstrate the orientation of the vector, which was projected into the vertical section, or alternatively
    2. as vector circles with constant diameter to demonstrate the orientation of the orthogonal component of the vector quantity in the vertical section. The orientation of the flow can be seen in this representation.
  2. Display of the value of the orthogonal or parallel component of the vector quantity as a background coloured isosurface representation (or hatching representation alternatively) can be done similar to above.
  3. Display of the amount of the (total) vector, or of the amount of its orthogonal or parallel components without superposition of vector arrows.
  4. Display of the component of a vector filed which is parallel to the vertical section as a vector arrow, whose length is proportional to the value of the projected component (Attention: the vertical component of the vector may be strongly superelevated). The arrow may be filled using a colour which corresponds to the value of the arrow.
  5. Display of the component of a vector field which is orthogonal to the vertical section as vector circles. The diameter of the circles is proportional to the value of the component. The direction of the flow is made visible by means of centered small circles in cases where the velocity is oriented towards the observer or by means of crossing diameter lines which are indicative for flow flowing from the observer into the vertical section.

Besides an automatic presentation by VVIEW2D each figure can be manipulated in an interactive way by the user (deletion, shift, enlargement, reduction, insertion, ... of graphical objects).

Input-Files

  1. general input data (filetype vview2d.dat)
  2. colours file (filetype colors.dat)
  3. all other input files are described in the before mentioned input data file.

Furthermore the following standard configuration files from the directory $PROGHOME/cfg/ are required:

  • GKS parameter file: gkssystem.computername.dat
  • definition of physical quantities and physical units: phydef.cfg.de/en.dat, phydef.cfg.rest.dat, phydef.cfg.si.dat, phydef-cf.cfg.dat
  • definition of hatching styles: hatch.cfg.dat
  • DE/EN fraction names: fracdef.cfg.dat'

Output-Files

  1. result files are described in the above mentioned input data file vview2d.dat.
  2. informative printer file (filetype vview2d.master.sdr)
  3. (optional) trace of program execution (filetype vview2d.trc)

Methodology

All data which shall be displayed using VVIEW2D must be stored in direct access files conforming to BAW-DHs universal direct access data format. The geometry is defined by an arbitrary number of segments which are interconnected to form one or more profiles. Above any profile node where data are defined an arbitrary number of layers of data points can be present which need not be equal spaced. During the first processing step the program generates a grid made out of triangles together with additional auxillary informations (grid of the vertical section). In a second step the data are interpolated onto the nodes of the generated mesh. The type of the projection ist taken into account for vector quantities (orthogonal or parallel component of the vector). After that, contour lines, vector arrows or vector circles etc., heaven and hell are added to the overall scene. In the final processing stage all the data which have been assigned to the scene are converted into one of the several possible graphical representations (see also the examples given above).

Program(s) to run before this Program

ADCP2PROFILE, DIDAMERGE, FRQWF, LZKMF, LZKSF, LZKVF, LZKWF, TELEMAC-2D, TDKLF, TDKSF, TDKVF, TDKWF, TIMESHIFT, TRIM-2D, TRIM-3D, UNTRIM, UNTRIM2, UNTRIM2007, VTDK, XTRLQ2

Program(s) to run after this Program

EDITOR

Additional Information

Language

Fortran90

Additional software

GKS (by GTS-Gral)

Original Version

G. Lang

Maintenance

J. Jürges, G. Lang

Documentation/Literature

Ion A. Angell und Gareth H. Griffith, 1989: Praktische Einführung in die Computer-Graphik mit zahlreichen Programmbeispielen, Hanser Verlag, 360 Seiten.

template files are available in $PROGHOME/examples/Vview2d/


back to Program Descriptions


Overview