GVIEW2D

Basic Information

Name of Program

GVIEW2D

Version-Date

3.1

Description-Date

November 2003

Catchwords

visualization
time series
measurement data
model data

Short Description of Functionality

GVIEW2D gives a graphical representation of time-dependent physical quantities at a given position (so called geo position).

Measured time-dependent data (e.g. water level at a gauging station) as well as results from 2D and 3D model simulations (e.g. current velocity) as well as postprocessed analysis data (e.g. tide high water) can be displayed. Truely three-dimensional data may be displayed for different layers as lines or markers and for all layers in a color shaded way.

Result files of model simulations and postprocessed analysis data files are available often in the BDF data format (description in german only). GVIEW2D can process these result files if they are associated with grid data files of the formats gitter05.dat/bin, untrim_grid.dat, profil05.binor location_grid.dat

Using BDF data format (description in german only) result files it is recommended to use time-series dataset files instead of synoptic dataset files (but not necessarily, because both dataset types are supported). Time-series dataset files contain time-dependent data of one position in each record. Synoptic dataset files contain position-dependent data of one date in each record. So reading time series data from a time-series dataset file it is necessary to read just one record, but reading time series data from a synoptic dataset file it is necessary to read as much records as dates are available. It is highly recommended to use the program ZEITR to change the dataset type of a BDF data format file from synoptic datasets to time-series datasets.

New in version 3.1 (december 2002)

Color shaded visualization of time and depth dependant data (example)

• x axis is the time axis;
• y axis is the depth axis;
• physical data will be represented in different colors with respect to different values;
• colors can be pre-defined in a file of type lights.dat;
• colors can be changed interactively during program execution.
  

Improvements in version 3.1 (december 2002)

Axis and color scales automated

• for physical data not pre-defined in a file of type lights.dat the program computes appropriate axis or color
• values (no longer
• the program interrupts execution abnormaly);
• before the end of program execution there is a possibility to store all interactively changed axis and color adjustments to a
• (new) file of type lights.dat.

New in version 2.2 (october 2002)

Totals and difference formation of selected depth profiles

• was realized only for time series before version 2.2

New in version 2 (march 2002)

Visualization of depth profiles (example animation)

• reference axis is the depth axis instead of the time axis;
• depth axis is always the y axis in a chart;
• further on it is possible to put curves representing different physical quantities in one chart;
• depth profile charts can contain more than one x axis;
• depth profile data can be stored in a file (switch AsciiOut), file type is zprofil.dat;
• TimeJourney doesn't work with depth profile charts (no time dependancy!), the switch appears only, when time dependent charts are
• available;
• new selection menu: chart type selection (time series/ depth profile) after the selection of data file and physical quantity.
• Appears only if the selected quantity allows both chart types;
• new selection menu: time selection instead of depth layer selection (only for depth profile data);
• advanced chart selection menu: All allowed charts will be displayed;
• format changing of general input data file: for files of type BDF it is necessary to give a second file of the same type which
• contains the reference waterlevel.
  

New in version 1.9 (january 2002)

Data variant selection

• After selecting the physical quantity the user selects the data variant of this quantity, if there are more than one variant. For * example the quantity suspended load concentration can have some variants to discern between different grain sizes or settling
• velocities.
• If there are no data variants, the user can't select any variant. So in this case older log files can be used further on.

New in version 1.8 (january 2002)

Axis descriptions and datum formattings in english

• Visualization of axis descriptions and datum formattings are now realized in english in addition to german. You can set the
• language after starting the program. Wait for the question
• "Bitte waehlen Sie die Sprache fuer Beschriftungen"
• and answer this question by typing 2 (=english).

New in version 1.7 (december 2001)

Visualization of curve markers

• Optionally data curves can have some markers. Different markers are provided: Dots (.), plus signs (+), asterisks (*), circles
• and crosses (x).
• For data curve visualization you can choose between lines only, lines and markers or markers only.
• All marker attributes of all curves can be changed on-the-fly. Use the EditView button to do this.

New in version 1.6 (december 2001)

Advanced features in changing the data visualization

• Changing the legend character height ist now realized below the changing of curve attributes
• Below the changing of axis attributes there are four new buttons (label color, label line type, label line width and label
• character height). All these buttons will change the attributes of all labels associated with the selected axis.

New in version 1.5 (november 2001)

ASCII output of visualized curve data

• Data of visualized curves can be stored in ASCII files (filetype boewrt.dat). The AsciiOut button provides
• this functionality.

Example graphics for typical usecases

Visualize measured data

Visualization of the measured fresh water discharge at gauging station Versen (river Ems) for the year 2000

Check boundary data

Comparison of the input and output time series of the program UTRRND. In this case it is a water level comparison at a harbour inlet

Verify model data

Verification of Trim-2D model data in comparison with measured data. In this case it is a current velocity comparison (absolute value and direction) between measured data at a single position in the water column and at the equivalent model node (depth integrated model data!)

Visualize postprocessed analysis data

Visualization of analysis data, computed by the hydrodynamic model TELEMAC-2D and postprocessed with the program Tdklf. You can see the flood and ebb current bed load transport for a selected data node of the north sea model near the mouth of the estuary Elbe

Visualize depth profile data (version 2 or higher)

[[file:|Visualization of depth dependent current velocities. The animation of 25 time steps shows you the changing of a measured current velocity depth profile (ADCP workhorse data, converted with ADCP2BDF)]]

Visualization of time and depth dependant data (version 3 or higher)

Visualization of current velocity and salinity. The data at this position is time and depth dependant, so the data is visualized for different colors.

• Higher current velocities are plotted in red and lower current velocities are plotted in blue;
• Higher salinities are plotted in light pink and lower salinities are plotted in dark pink

Input-Files

1. (required) general input data (filetype gview2d.dat)

   Reading this file the program uses a file description file (filetype gview2d_dico.dat) stored in the directory $PROGHOME/dic/.

2. (required) layout information (filetype format.lay)
3. (required) colour table definitions file (filetype lights.dat).

   This file serves predefined axis value ranges for different physical quantities.

4. (required) colours file (file of type colors.dat)
5. (optional) list of predefined geo positions (filetype location.dat).

   Geo positions serves access to time series of preselected 2D nodes. This list is usefull only in the context of using time

   series data stored in the BDF data format (description in german only).

6. (optional) (measured) time series data (filetype boewrt.dat)
7. (optional) (computed) time series data of the hydrodynamic models Trim-2D and Trim-3D (filetype knoerg.bin)
8. (optional) (computed) time series data and time-dependent analysis data stored in files of the BDF data format (description in

   german only) (filetypes dirz.bin.R dirz.bin.I dirz.bin)

9. (optional) grid data for BDF data files (filetypes gitter05.dat/.bin, untrim_grid.dat, profil05.bin or location_grid.dat)
10. (optional) GKS-Logfile (filetype gkslog.dat)

    Notice: if within the working directory a file with the name gview2d_log.dat exists, the stored information about a former

    GVIEW2D application run is used to rerun the recorded one in precisely the same way.

For GVIEW2D 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

Output-Files

1. (required) graphical output to the screen
2. (optional) informative printer file (filetype gview2d.sdr)
3. (optional) plot metafile(s) (GKSM or CGM) and scale info file(s) (gview2d???.gksm.scale or gview2d???.cgm.scale) for later

   calculation of geo-referenced coordinates

4. (optional) trace of program execution (filetype gview2d.trc)
5. (optional) GKS-Logfile (filetype gkslog.dat)

   Notice: This file is used to record all interactive user input for a complete GVIEW2D application run. This file can be used at

   a later stage to rerun the whole session in exactly the same way.

6. (optional) visualized curve time series data (filetype boewrt.dat)
7. (optional) visualized curve depth profile data (filetype zprofil.dat)

Methodology

selection of time series data The user selects data step by step:

• Data file selection. All selectable data files are defined in the general input data file (filetype gview2d.dat)
• Physical quantities selection. The program offers only physical quantities contained in the selected data file.
• Chart type selection. Three types are realized: time series / depth profile / time depth visualization (2D)
• Data position selection. If the selected data file is of the [http://www.baw.de/proghome/abteilungen/wbk/Publikationen

/fkb/dirz/scn-bdf/scn-bdf1.htm BDF data format (description in german only)] type, then the selection of the data position is supported by graphical output (grid visualization) and the list of predefined geo positions can be used.

• Depth layer selection. This selection will be presented only if the time series data is depth dependent and if the selected
• chart is of type time series. Only allowed layers are selectable, but layers can contain datums with no data because of a water
• level lower than the selected layer (dry datums).
• Time selection. This selection will be presented only if the selected chart is of type depth profile.
• Chart selection. The user gets the possibility to put a new curve to an existing chart or to create a new chart (only for
• line curves).

Internal storage of time series data After the selection of the time series data the programs reads the data from file and stores it in an internal data structure. This internal data structure is optimized for visualization and contains the following components:

• List of all pictures. This list is necessary to display two pictures at the same time in a portrait orientated layout. Each
• picture knows all containing charts.
• List of all charts. Each chart knows all containing curves.
• List of all curves. Each curve knows all containing vectors and the associated x- and y-axis. At least three vectors belong
• to a curve: One vector for all x values, one vector for all y values and one vector for all dry/wet codings.
• List of all vectors. Each vector contains a data row. That is e.g. a row of dates, a row of physical quantity values or a
• row of dry/wet codings.
• List of all axes. Each axis knows all containing labels.
• List of all labels. Each label represents a mark on an axis.

Advantages made possible by the internal storage Because of the internal storage of time series data it is possible for the user to do the following:

• Additional time series data can be stored from file into the internal data structure bit by bit. So the user can let grow the
• graphic step by step.
• Graphical attributes (e.g. colours, linetypes, character heights, axis value ranges, ...) can be changed by the user on the fly.

Visual walking through time series GVIEW2D gives the user the possibility to travel through the sections of time series. A time window and a time increment will be defined and can be changed by the user. This functionality gives the user a chance of zooming and panning on the time axis in a fast and easy way. The user comes to this functionality by the main menu switch called TimeJourney.

Program(s) to run before this Program

ADCP2BDF, ADCP2PROFILE, DATACONVERT, DIDAMERGE, DIDAMINTQ, DIDAMINTZ, DIDARENAME, DIDASPLIT, ENERF, FFT, FRQWF, METDIDA, PGCALC, TDKLF, TDKSF, TDKVF, TDKWF, TELEMAC-2D, TIMESHIFT, TM2DIDA, TR2APP, TR2DIDA, TR3DIDA, TRIM-2D, TRIM-3D, UNTRIM, UNTRIM2007, UTRRND, VTDK, XTRLQ2, ZEITR, ZEITRIO

Program(s) to run after this Program

EDITOR, UNTRIM, UNTRIM2007

Additional Information

Language

Fortran90

Additional software

GKS (GTS-Gral)

Original Version

G. Lang, J. Jürges

Maintenance

J. Jürges

Documentation/Literature

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

---

back to Program Descriptions

---

Overview