Actions

NCPLOT: Difference between revisions

From BAWiki

imported>Lang Guenther
(version date changed)
imported>Spohr Susanne
(restructuring due to line chart)
Line 2: Line 2:
|name_de=NCPLOT
|name_de=NCPLOT
|name=NCPLOT
|name=NCPLOT
|version=December 2017
|version=June 2018
|version_descr=February 2017
|version_descr=June 2018
|catchwords=graphical postprocessor<br />
|catchwords=graphical postprocessor<br />
graphical presentation of CF NetCDF data (unknown attributes are ignored)<br />
graphical presentation of CF NetCDF data (unknown attributes are ignored)<br />
Line 17: Line 17:
  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/]).''
  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=The graphical postprocessor NCPLOT can be used for a scaled graphical presentation
|shortdescription=
of CF NetCDF data. Different scalar quantities can be visualized in the horizontal plane. The
The graphical postprocessor NCPLOT can be used for a graphical presentation
data can be defined on nodes, edges or faces. The program works on 2D-data, 3D-data and on data with
of simulation and analysis results, which is stored in CF NetCDF data format.
details scaled on a subgrid.<br />
The data can be defined on nodes, edges or faces. The program works on 2D-data,
If the X- and the Y-component of a vector quantity exists, the visualization of the entire vector is possible.
3D-data and on data with details scaled on a subgrid.<br />
Normal components of a vector quantity saved on edges can be visualized as a normal vector of the edge
or as an interpolated total vector.<br />
The thin out of the display of vector arrows is possible.
[[File:NcplotBspFaceArea.png|thumb|250px|Picture 1: Salinity with underlaid topography.]]
[[File:NcplotBspFaceArea.png|thumb|250px|Picture 1: Salinity with underlaid topography.]]


NCPLOT is a pure plot program without any user interaction at runtime.
The sample pictures illustrate the capability of the program NCPLOT.<br />
The layout of the picture and the graphical presentation of the data has to be described
[[NCPLOT: Example figures|Example figures: NCPLOT]]
in the steering file.
 
Basically, NCPLOT distinguishes linear from areal chart types.
For area charts the symbolization of the data is depending on the data value
(color legend, proportional arrow).
For linear charts, the values of data series are plotted on an axis.
The symbolization of the data series is independent of the data value.
<br />
 
[[NCPLOT: Area Charts|Area Charts]]:
* Map, or top view illustration
 
[[NCPLOT: Line Charts|Line Charts]]:<br />
* time series


The visualisation of a data set is described in a so-called 'layer'.
NCPLOT allows you to illustrate different diagrams of different types in one picture.
The assignment of colors to values of a data set and the form of representation of the underlying
Line diagrams next to areal charts with static and possibly dynamic parts.
geometry are set in one layer block of the steering file.
<br />
Color legends used by a layer can be displayed on the scene and can be arranged horizontally or
vertically. Another layer dependent, optional image element is a text field
for the data label (e.g. Indication of the time). Also simple data operations can be executed (addition, subtraction, multiplication, division, absolute value, square root).


Different layers can be plotted in a map lying upon each other.
Each map can be framed.
The type of frame can be a simple black edging or a complex frame with coordinates.
The offered coordinate frames are optimized for values belonging to Gauss Krüger or to universal transverse mercator (UTM) projections.
Different maps can be arranged in one picture.


NCPLOT creates vector graphics in CGM format.
Picture series:<br />
Both line and area chart definitions can request the creation of picture series.
A picture can contain static and dynamic image components.
Dynamic components means parts of the image that vary over a picture series.
<br />


Just in case '''HDF error''' is detected during read of a data record, the program tries to reconstruct the wanted data set from adjacent (in time) records for the same variable. This type of repair works for time dependent variables only.
The following rule applies to the program:<br />
The first read dynamic definition determines the permitted length of the
picture series.
The program aborts, if a further dynamic diagram definition results a
different number of images.
<br />
Further tests are not carried out.
<br />


The sample pictures illustrate the capability of the program NCPLOT.<br />
Different series diagrams from dynamic diagram definitions of the same
[[NCPLOT: Example figures|Example figures: NCPLOT]]
length are processed by the program. The static picture elements are displayed
on every picture in the series.
<br />


|inputfiles=
|inputfiles=
Line 67: Line 82:


|methodology=
|methodology=
The data are presented by the program at their original positions (node, edge, face).
NCPLOT is a pure plot program without any user interaction at runtime.
A horizontal interpolation of the data is not yet possible.
The layout of the picture and the graphical presentation of the data has to be
Node data can be visualized by marker symbols or text.
described in the steering file.
Edge data can be visualized by line symbolization and face data can be presented by
<br />
using a fill area symbolization.
 
For edge and polygon data, there are also the possibilities of point-symbolization.
NCPLOT creates vector graphics in CGM format.
In this case the marker or the text is positioned at the middle of the edge or at the
<br />
polygon center.
 
The edges of polygons can be also visualized by lines symbolization.
For special data files it is possible to exclude data at places with low water
coverage from the display. The technic works only on original UnTRIM result files
in CF NetCDF format.
<br />


For special data files it is possible to exclude data at places with low water coverage
Just in case '''HDF error''' is detected during read of a data record,
from the display. The technic works only on original UnTRIM result files in CF NetCDF format.
the program tries to reconstruct the wanted data set from adjacent (in time)
records for the same variable.
This type of repair works for time dependent variables only.
<br />


|preprocessor=[[DATACONVERT]], [[GRIDCONVERT]], [[NCAGGREGATE]], [[NCANALYSE]], [[NCDELTA]], [[UNK]], [[UNTRIM2007]], [[UNTRIM2]]
|preprocessor=[[DATACONVERT]], [[GRIDCONVERT]], [[NCAGGREGATE]], [[NCANALYSE]], [[NCDELTA]], [[UNK]], [[UNTRIM2007]], [[UNTRIM2]]
Line 84: Line 105:
|language=Fortran95
|language=Fortran95
|add_software=GKS (by GTS-Gral)  
|add_software=GKS (by GTS-Gral)  
|contact_original=[mailto:guenther.lang@baw.de G. Lang], [mailto:jens.juerges@baw.de J. Jürges]
|contact_original=[mailto:guenther.lang@baw.de G. Lang], [mailto:susanne.spohr@baw.de S. Spohr]
|contact_maintenance=[mailto:guenther.lang@baw.de G. Lang], [mailto:jens.juerges@baw.de J. Jürges]
|contact_maintenance=[mailto:guenther.lang@baw.de G. Lang], [mailto:susanne.spohr@baw.de S. Spohr]
|documentation=
|documentation=
template files available in '''$PROGHOME/examples/ncplot'''
template files available in '''$PROGHOME/examples/ncplot'''
}}
}}

Revision as of 14:16, 29 June 2018

Basic Information

Name of Program

NCPLOT

Version-Date

June 2018

Description-Date

June 2018

Catchwords

graphical postprocessor
graphical presentation of CF NetCDF data (unknown attributes are ignored)
finite element models
finite difference models
orthogonal unstructured grid model
orthogonal unstructured grid model with subgrid information
conversion or transformation (extensive - intensive) of physical units
calculation of new quantities (for display) from one or several input data sets
(optional) filter based on water depth
(optional) filter based on number of observations

Acknowledgment: This project took advantage of netCDF software developed by UCAR/Unidata (www.unidata.ucar.edu/software/netcdf/).

Short Description of Functionality

The graphical postprocessor NCPLOT can be used for a graphical presentation of simulation and analysis results, which is stored in CF NetCDF data format. The data can be defined on nodes, edges or faces. The program works on 2D-data, 3D-data and on data with details scaled on a subgrid.

Picture 1: Salinity with underlaid topography.

The sample pictures illustrate the capability of the program NCPLOT.
Example figures: NCPLOT

Basically, NCPLOT distinguishes linear from areal chart types. For area charts the symbolization of the data is depending on the data value (color legend, proportional arrow). For linear charts, the values of data series are plotted on an axis. The symbolization of the data series is independent of the data value.

Area Charts:

  • Map, or top view illustration

Line Charts:

  • time series

NCPLOT allows you to illustrate different diagrams of different types in one picture. Line diagrams next to areal charts with static and possibly dynamic parts.


Picture series:
Both line and area chart definitions can request the creation of picture series. A picture can contain static and dynamic image components. Dynamic components means parts of the image that vary over a picture series.

The following rule applies to the program:
The first read dynamic definition determines the permitted length of the picture series. The program aborts, if a further dynamic diagram definition results a different number of images.

Further tests are not carried out.

Different series diagrams from dynamic diagram definitions of the same length are processed by the program. The static picture elements are displayed on every picture in the series.

Input-Files

  1. general input data (file type ncplot.dat)
  2. result files (file type CF-NETCDF.NC)
  3. file with interval definitions for color legends (file type bounds.cfg.dat)
    Hint: (Recommended) Local configuration file or file from the directory $PROGHOME/cfg/.
  4. file with list of definitions of palettes (file type palettes.cfg.dat)
    Hint: (Recommended) Provided file from the directory $PROGHOME/cfg/ or local configuration file.
  5. file with definitions of colors (file type colors.cfg.dat)
    Hint: (Recommended) Provided file from the directory $PROGHOME/cfg/ or local configuration file.

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

  • GKS parameter file: gkssystem.computername.dat

Output-Files

  1. plot metafiles (CGM format)
  2. (optional) informative printer file of program execution (file type ncplot.sdr)
  3. (optional) trace of program execution (file type ncplot.trc)

Methodology

NCPLOT is a pure plot program without any user interaction at runtime. The layout of the picture and the graphical presentation of the data has to be described in the steering file.

NCPLOT creates vector graphics in CGM format.

For special data files it is possible to exclude data at places with low water coverage from the display. The technic works only on original UnTRIM result files in CF NetCDF format.

Just in case HDF error is detected during read of a data record, the program tries to reconstruct the wanted data set from adjacent (in time) records for the same variable. This type of repair works for time dependent variables only.

Program(s) to run before this Program

DATACONVERT, GRIDCONVERT, NCAGGREGATE, NCANALYSE, NCDELTA, UNK, UNTRIM2007, UNTRIM2

Program(s) to run after this Program

---

Additional Information

Language

Fortran95

Additional software

GKS (by GTS-Gral)

Original Version

G. Lang, S. Spohr

Maintenance

G. Lang, S. Spohr

Documentation/Literature

template files available in $PROGHOME/examples/ncplot

back to Program Descriptions

Overview

Retrieved from "http://wiki.baw.de/en/index.php?title=NCPLOT&oldid=3682"