NCPLOT: Difference between revisions

Latest revision as of 10:50, 6 September 2022

Basic Information

Name of Program

NCPLOT

Version-Date

March 2022

Description-Date

September 2022

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
Vertical section along profile (3D data)
Time depth diagram (3D data)
Hovmöller diagram: Temporal development along profile.

Line Charts:

time series
profile view
depth profile

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

general input data (file type ncplot.dat)
result files (file type CF-NETCDF.NC)
file with interval definitions for color legends (file type bounds.cfg.dat)
Hint: (Recommended) Local configuration file or file from the directory $PROGHOME/cfg/.
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.
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

graphic files (format: CGM or SVG)
(optional) informative printer file of program execution (file type ncplot.sdr)
(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 or SVG 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

BOE2NC, DATACONVERT, GRIDCONVERT, NCAGGREGATE, NCANALYSE, NCCUTOUT, NCDELTA, NCDVAR, NCMERGE, 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

Working group POS

Documentation/Literature

template files available in $PROGHOME/examples/ncplot

back to Program Descriptions

Overview

@@ Line 2: / Line 2: @@
 |name_de=NCPLOT
 |name=NCPLOT
-|version=September 2013
+|version=March 2022
-|version_descr=September 2013
+|version_descr=September 2022
 |catchwords=graphical postprocessor<br />
-graphical presentation of CF NetCDF data (2D/3D)<br />
+graphical presentation of CF NetCDF data (unknown attributes are ignored)<br />
 finite element models<br />
 finite difference models<br />
@@ Line 12: / Line 12: @@
 conversion or transformation (extensive - intensive) of physical units <br />
 calculation of new quantities (for display) from one or several input data sets<br />
+(optional) filter based on water depth<br />
+(optional) filter based on number of observations<br />
-|shortdescription=The graphical postprocessor NCPLOT can be used for a scaled graphical presentation
+ 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/]).''
-of CF NetCDF data. Different scalar quantities can be visualized in the horizontal plane. The
-data can be defined on nodes, edges or faces. The program works on 2D-data, 3D-data and on data with
+|shortdescription=
-details scaled on a subgrid.<br />
+The graphical postprocessor NCPLOT can be used for a graphical presentation
-The presentation of vector quantities is currently not implemented.
+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,
+D-data and on data with details scaled on a subgrid.<br />
 [[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 />
-The visualisation of a data set is described in a so-called 'layer'.
+[[NCPLOT: Area Charts|Area Charts]]:
-The assignment of colors to values of a data set and the form of representation of the underlying
+* Map, or top view illustration
-geometry are set in one layer block of the steering file.
+* Vertical section along profile (3D data)
-Color legends used by a layer can be displayed on the scene and can be arranged horizontally or
+* Time depth diagram (3D data)
-vertically. Another layer dependent, optional image element is a text field
+* Hovmöller diagram: Temporal development along profile.
-for the data label (e.g. Indication of the time).
+<br />
+[[NCPLOT: Line Charts|Line Charts]]:<br />
+* time series
+* profile view
+* depth profile
+<br />
+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.
+<br />
-Different layers can be plotted in a map lying upon each other.
+Picture series:<br />
-Each map can be framed.
+Both line and area chart definitions can request the creation of picture series.
-The type of frame can be a simple black edging or a complex frame with coordinates.
+A picture can contain static and dynamic image components.
-The offered coordinate frames are optimized for values belonging to Gauss Krüger projection.
+Dynamic components means parts of the image that vary over a picture series.
-Different maps can be arranged in one picture.
+<br />
-NCPLOT creates vector graphics in CGM format.
+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=
@@ Line 53: / Line 81: @@
 |outputfiles=
-# '''plot metafiles''' (CGM format)
+# '''graphic files''' (format: CGM or SVG)
 # (optional) informative '''printer file''' of program execution (file type ncplot.sdr)
 # (optional) '''trace''' of program execution (file type ncplot.trc)
 |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 or SVG 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]], [[NCANALYSE]], [[UNTRIM2007]], [[UNTRIM2]]
+|preprocessor=[[BOE2NC]], [[DATACONVERT]], [[GRIDCONVERT]], [[NCAGGREGATE]], [[NCANALYSE]], [[NCCUTOUT]], [[NCDELTA]], [[NCDVAR]], [[NCMERGE]], [[UNK]], [[UNTRIM2007]], [[UNTRIM2]]
 |postprocessor=---
 |language=Fortran95
 |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=G. Lang, S. Spohr
-|contact_maintenance=[mailto:guenther.lang@baw.de G. Lang], [mailto:jens.juerges@baw.de J. Jürges]
+|contact_maintenance=[mailto:pos.proghome@baw.de Working group POS]
 |documentation=
 template files available in '''$PROGHOME/examples/ncplot'''
 }}