GVIEW2D
From BAWiki
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.bin or location_grid.dat
Using [http://www.baw.de/proghome/abteilungen/wbk/Publikationen/fkb/dirz/scn-bdf/scn-bdf1.htm
Input-Files
- (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/.
- (required) layout information (filetype format.lay)
- (required) colour table definitions file (filetype lights.dat).
- This file serves predefined axis value ranges for different physical quantities.
- (required) colours file (file of type colors.dat)
- (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).
- (optional) (measured) time series data (filetype boewrt.dat)
- (optional) (computed) time series data of the hydrodynamic models Trim-2D and Trim-3D (filetype knoerg.bin)
- (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)
- (optional) grid data for BDF data files (filetypes gitter05.dat/.bin, untrim_grid.dat, profil05.bin or location_grid.dat)
- (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
- (required) graphical output to the screen
- (optional) informative printer file (filetype gview2d.sdr)
- (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
- (optional) trace of program execution (filetype gview2d.trc)
- (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.
- (optional) visualized curve time series data (filetype boewrt.dat)
- (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
Additional Information
Language
Fortran90
Additional software
GKS (GTS-Gral)
Original Version
Maintenance
Documentation/Literature
template files are available in $PROGHOME/examples/gview2d/
back to Program Descriptions