Actions

Difference between pages "NCPLOT: Example figures" and "NCPLOT.DAT"

From BAWiki

(Difference between pages)
imported>Spohr Susanne
(Created page with 'de:Beispiel-Grafiken: NCPLOT The sample pictures should give an impression of the capability of the program NCPLOT. =Examples= ===Visualisation of "node" data=== {| bor…')
 
imported>Spohr Susanne
(Metadata Infobox, BLOCK Textbox)
 
Line 1: Line 1:
[[de:Beispiel-Grafiken: NCPLOT]]
+
{{FileDescription
The sample pictures should give an impression of the capability of the program [[NCPLOT]].
+
|name_de=NCPLOT.DAT
 +
|filetype=ncplot.dat
 +
|version=December 2015
 +
|version_descr=December 2015
 +
|significance=contains general steering data for the program [[NCPLOT]].
 +
|filecontents=
 +
'''steering data'''
  
=Examples=
+
* Block '''Program_Parameters''': general steering data
 +
:* Key '''"Language" : Language preference''' for labels and texts:
 +
::*'''DE''' = German,
 +
::*'''EN''' = English.
 +
:* Key '''"Max_Read_Storage" : max. read only memory''' (in bytes) for analysis
 +
:* Key '''"Min_Water_Depth" : minimum water coverage''' in [m].
 +
::Hint: The excluding of data from the presentation in case of low water coverage is only possible, if the variable to be displayed points in a certain way to a variable associated with the total water depth.<br />The CF-NetCDF output of UnTRIM programs fulfills this requirement.<br />The page [[NCPLOT: Min_Water_Depth]] illustrates the effect of this control parameter.
 +
:* (optional) Key '''"Infobox_NTN_Name" :''' name of the normalization transformation for the '''Metadata Infobox'''.
  
===Visualisation of "node" data===
+
* Block '''Normalization_Transformation''': normalization transformation  (NTN)<br /> Definition of an image section and description of the link between the world and image coordinates. The coordinates of the drawing area, the so-called NDC space, range from [0.0,0.0] to [1.0,1.0]. For an undistorted view of the area the representation scale in the X direction must match the scale in Y-direction (DWC / DNDC = const). Distorted representations are also possible.<br /> In addition to the positioning of the map windows NTNs be used for legends and text windows. Legends can be arranged either horizontally or vertically.<br />
{| border="1"
+
:* Key '''"Name" : unique name''' of this normalization transformation.
! width="50%" | Node data visualized by marker symbols
+
:* Key '''"EPSG" : EPSG code''' of the data coordinates in the file.
! width="50%" | Node data with text symbolization
+
:* Key '''"EPSG_Window" : EPSG code''' of the plot projection.
|-
+
:* Key '''"Left_Lower_Window_Coordinates" : World coordinates (according to EPSG)''' the lower left corner of the projection window.
|[[File:NcplotBspNodeMarker.png|center|500px|Node data visualized by marker symbols]]
+
:* Key '''"Right_Upper_Window_Coordinates" : World coordinates (according to EPSG)''' the upper right corner of the projection window.
|[[File:NcplotBspNodeText.png|center|500px|Node data with markers plus text with data value]]
+
:* Key '''"Left_Lower_NDC_Coordinates" : Picture coordinates (NDC within [0.0,1.0])''' the lower left corner of the projection window.
|}
+
:* Key '''"Right_Upper_NDC_Coordinates" : Picture coordinates (NDC within [0.0,1.0])''' the upper right corner of the projection window.
<br />
 
  
===Visualisation of "edge" data===
+
* Block '''Poly_Marker_Representation''': Poly-Marker Representation<br />Description of one type of marker symbols.<br />Control file can contain multiple blocks of this type.
{| border="1"
 
! width="50%"  | Edge data visualized by marker symbols
 
! width="50%"  | Edge data with line symbolization
 
|-
 
|[[File:NcplotBspEdgePoint.png|center|500px|Edge data visualized by markers at the middle of the edge]]
 
|[[File:NcplotBspEdgeLine.png|center|500px|Edge data visualized by markers at the middle of the edge and line symbolization]]
 
|}
 
<br />
 
  
===Visualisation of "face" data===
+
* Block '''Fill_Area_Representation''': Fill-Area Representation<br />Description of one type of fill area symbolization.<br />Control file can contain multiple blocks of this type.
{| border="1"
 
! width="50%"  | Face data visualized by marker symbols
 
! width="50%"  | Face data with fill area symbolization
 
|-
 
|[[File:NcplotBspFacePoint.png|center|500px|Face data visualized by markers at the polygon center]]
 
|[[File:NcplotBspFaceArea.png|center|500px|Face data visualized by fill area symbolization]]
 
|}
 
<br />
 
  
===Show the calculation grid===
+
* Block '''Poly_Line_Representation''': Poly-Line Representation<br />Description of one type of line symbolization.<br />Control file can contain multiple blocks of this type.
{| border="1"
 
! width="50%"  | Water level without grid
 
! width="50%"  | Water level with overlaid grid
 
|-
 
|[[File:NcplotBspGrid_0.png|center|500px|Synoptic water level without grid]]
 
|[[File:NcplotBspGrid_1.png|center|500px|Water level with overlaid calculation grid]]
 
|}
 
<br />
 
  
===Data with subgrid information ===
+
* Block '''Text_Representation''': Text Representation<br />Description of one type of text symbolization.<br />Control file can contain multiple blocks of this type.
{| border="1"
 
! width="50%"  | Topography with details on a subgrid
 
! width="50%"  | Water level on subgrid topography
 
|-
 
|[[File:NcplotBspSubgridTopo.png|center|500px|Topography with details on a subgrid]]
 
|[[File:NcplotBspSubgridWstd.png|center|500px|Water level underlaid with subgrid topography]]
 
|}
 
<br />
 
  
===Multiple maps in one picture===
+
* Block '''Vector_Representation''': Vector Representation<br />Description of one type of vector symbolization.<br />Control file can contain multiple blocks of this type.<br />Hint: More info at "[[NCPLOT: Types of vector symbols]]".
{| border="1"
 
! width="50%"  | Comparison of water level and salinity
 
! width="50%"  | Collection of suitable color ramps
 
|-
 
|[[File:NcplotBspTwo_Maps.png|center|500px|Comparison of water level and salinity]]
 
|[[File:NcplotBspBestPals.png|center|500px|Collection of particularly suitable color ramps]]
 
|}
 
<br />
 
  
----
+
* Block '''Textbox''': Free Text<br />Description of one free text field.<br />Control file can contain multiple blocks of this type.
back to [[NCPLOT]]
+
 
 +
* Block '''Dataset''': Data set<br />Description of a data set to be displayed.<br />Control file can contain multiple blocks of this type.
 +
:* Key '''"Name" : unique name''' of this data set.
 +
:* Key '''"File" : name of the CF-NetCDF file''' (*.nc) with the data to be displayed.
 +
:* Key '''"Variable" : Description of the data''' whose values are to be displayed.
 +
::* Parameter '''1''' = name of the variable (in file of type *.nc)
 +
::* (optional) Parameter '''2''' = role of the variable as part of a vector
 +
:::* X-component = Variable is the X component of a vector
 +
:::* Y-component = Variable is the Y component of a vector
 +
:::* normal_component = Variable is the normal component of a vector
 +
::Hint: The command "ncdump -h <filename>.nc" shows the header of the CF-NetCDF file. The names of the offered variables and their dimensions can be found in the metadata.
 +
:* Key '''"Start" : start address''' for the data to be displayed.
 +
:* Key '''"Step" : number of steps''' for the data to be displayed.
 +
:* Key '''"Stride" : increment''' for the data to be displayed.
 +
::Hints:<br />For each dimension of the variable a start, step and stride value must be specified.<br />The page [[NCPLOT: Define DataSet]] gives instructions for addressing the desired data.
 +
 
 +
* Block '''Layer''': <br />Description of the content of a layer.<br />Control file can contain multiple blocks of this type.
 +
:* Key '''"Name" : unique name''' of this layer.
 +
:* Key '''"Layer_Dataset_Name" : name of the dataset''' to be displayed. Or a valid connexion (OPERATOR string) made out of known data sets, e. g. '''[DSet2-DSet1]/[DSet1+DSet2]''', '''ABS[DSet1]''' or '''SQR[DSet1]'''.
 +
:* Key '''"Layer_Normalization_Transformation_Name" : name of the normalization transformation''' for this layer.
 +
:* Key '''"Layer_Type" : type of data view''' of this layer.
 +
::Hint: Currently only "XY_data" = horizontal view implemented.
 +
:* Key '''"Layer_Primitive_Name" : graphic primitive''' to visualize the data in the layer.
 +
::* Parameter '''1''' = Symbolization of the layer
 +
:::*'''GPM''' = as poly marker
 +
:::*'''GPL''' = as poly line
 +
:::*'''GFA''' = as fill area
 +
:::*'''GTX''' = as text
 +
:::*'''VEC''' = as vector
 +
::* (optional) Parameter '''2''' = Type of the vector<br />... optional parameter, only at VEC visualization permitted.<br />...allows, for example, the interpolation of the total vector from the normal component a vectorial quantity.
 +
:::*'''total'''  = total vector
 +
:::*'''normal''' = normal vector
 +
::Hint: The primitive must fit to the underlying geometry of the data!<br />"node" data: GPM, GTX, VEC<br />"edge" data: GPM, GPL, GTX, VEC<br />"face" data: GPM, GPL, GFA, GTX, VEC
 +
:* Key '''"Layer_Primitive_Representation_Name" : name of the representation''' of the primitive.
 +
:* Key '''"Layer_Bounds_Name" : name of the interval definition''' for this layer (from the file [[BOUNDS.CFG.DAT|bounds.cfg.dat]]).
 +
::Hint: The number of intervals in the interval definition and the number of colors of the associated color legend must match.
 +
:* Key '''"Layer_Palette_Name" : name of the color legend''' for this layer (corresponds to the attribute ''Name'' in the file ''palette.dat''. More detailed information about palettes on file description page [[PALETTES.CFG.DAT|palettes.cfg.dat]]).
 +
:* Key '''"Layer_Invert_Palette" : invertation of the color ramp'''.
 +
:* Key '''"Layer_Legend_NTN_Name" : image area for the color legend''' of this layer.
 +
:* Key '''"Layer_Framing" : type of framing''' for this layer.
 +
::Hint: More info at "[[NCPLOT: Framing|Options of the layer framing]]".
 +
:* Key '''"Layer_Description_NTN_Name" : image area for the data description''' (e.g. Indication of the time).
 +
:* (optional) Key '''"Layer_Display_Units" : Physical unit''' in which the data should be converted for the graphical presentation.
 +
::Hints:<br />The original unit of the data and the target unit must be known in the configuration file '''''phydef.cfg.si.dat'''''. In addition, the SI-base (dimension) of the units must be identical.
 +
:* (optional) Key '''"Layer_Display_Name" : Name of physical quantity''', will be used instead of the original name given in the input data set. Without this line the name in PHYDEF is used, if the variable owns the attribute '''''name_id'''''.
 +
:* (optional) Key '''"Layer_Vector_Legend_NTN_Name" : image area for the vector legend''' in case of arrows with length_type proportional.
 +
:* (optional) Key '''"Layer_Vector_Thinout_Raster" : dimensions of the grid''' used to thin out the display of vector arrows.
 +
:* (optional) Key '''"Layer_NOBS_Filter"''' : filter for displayed data based on ''ancillary variable'' with type ''number of observations'':
 +
:** parameter 1: filter type:
 +
:*** '''EQ''' = display data only for a fixed number of observations;
 +
:*** '''LE''' = display data for a certain number of observations or less;
 +
:*** '''LE''' = display data for a certain number of observations or more.
 +
:** parameter 2: filter value:
 +
:*** '''0''' = maximum number of observations;
 +
:*** '''N''' = specified number of observations;
 +
:*** '''-M''' = maximum number of observations minus M.
 +
===General Remarks===
 +
# While reading this steering data file the '''dictionary file''' '''''ncplot_dico.dat''''' will be automatically accessed in directory '''''$PROGHOME/dic/''''' to support input.
 +
# If no such file exists in the working directory, NCPLOT accesses the following configuration files from the directory '''''$PROGHOME/cfg/''''':
 +
#* '''''colors.cfg.dat''''': File with definitions of colors.
 +
#* '''''palettes.cfg.dat''''': File with references to files with color palette definitions.
 +
#* '''''bounds.cfg.dat''''': File with interval definitions for legends.<br />Hint: The bounds file should be better stored within a project in the working directory.
 +
# The following '''standard configuration files''' from the directory  '''''$PROGHOME/cfg/''''' are required:
 +
#* '''gkssystem.rechnername.dat''': GKS parameter file.
 +
#* '''phydef.cfg.si.dat''': Configuration file for units and their relation to the SI system.
 +
 
 +
|nutzerprogramme=[[NCPLOT]]
 +
|language=Fortran90
 +
|fileform=FORMATTED
 +
|fileaccess=SEQUENTIAL
 +
|fileextension=.dat
 +
|writemodules= ---
 +
|readmodules=$PROGHOME/fortran/prg/ncplot/*/mod_m_ncplot_steer.f90
 +
|contact_original=[mailto:guenther.lang@baw.de G. Lang]
 +
|contact_maintenance=[mailto:guenther.lang@baw.de G. Lang], [mailto:susanne.spohr@baw.de S. Spohr]
 +
|examplefile=$PROGHOME/examples/ncplot/ncplot.dat
 +
}}

Revision as of 10:15, 18 December 2015

Basic Information

File-Type

ncplot.dat

Version

December 2015

Description-Date

December 2015

Significance of the File

contains general steering data for the program NCPLOT.

File-Contents (in Catchwords)

steering data

  • Block Program_Parameters: general steering data
  • Key "Language" : Language preference for labels and texts:
  • DE = German,
  • EN = English.
  • Key "Max_Read_Storage" : max. read only memory (in bytes) for analysis
  • Key "Min_Water_Depth" : minimum water coverage in [m].
Hint: The excluding of data from the presentation in case of low water coverage is only possible, if the variable to be displayed points in a certain way to a variable associated with the total water depth.
The CF-NetCDF output of UnTRIM programs fulfills this requirement.
The page NCPLOT: Min_Water_Depth illustrates the effect of this control parameter.
  • (optional) Key "Infobox_NTN_Name" : name of the normalization transformation for the Metadata Infobox.
  • Block Normalization_Transformation: normalization transformation (NTN)
    Definition of an image section and description of the link between the world and image coordinates. The coordinates of the drawing area, the so-called NDC space, range from [0.0,0.0] to [1.0,1.0]. For an undistorted view of the area the representation scale in the X direction must match the scale in Y-direction (DWC / DNDC = const). Distorted representations are also possible.
    In addition to the positioning of the map windows NTNs be used for legends and text windows. Legends can be arranged either horizontally or vertically.
  • Key "Name" : unique name of this normalization transformation.
  • Key "EPSG" : EPSG code of the data coordinates in the file.
  • Key "EPSG_Window" : EPSG code of the plot projection.
  • Key "Left_Lower_Window_Coordinates" : World coordinates (according to EPSG) the lower left corner of the projection window.
  • Key "Right_Upper_Window_Coordinates" : World coordinates (according to EPSG) the upper right corner of the projection window.
  • Key "Left_Lower_NDC_Coordinates" : Picture coordinates (NDC within [0.0,1.0]) the lower left corner of the projection window.
  • Key "Right_Upper_NDC_Coordinates" : Picture coordinates (NDC within [0.0,1.0]) the upper right corner of the projection window.
  • Block Poly_Marker_Representation: Poly-Marker Representation
    Description of one type of marker symbols.
    Control file can contain multiple blocks of this type.
  • Block Fill_Area_Representation: Fill-Area Representation
    Description of one type of fill area symbolization.
    Control file can contain multiple blocks of this type.
  • Block Poly_Line_Representation: Poly-Line Representation
    Description of one type of line symbolization.
    Control file can contain multiple blocks of this type.
  • Block Text_Representation: Text Representation
    Description of one type of text symbolization.
    Control file can contain multiple blocks of this type.
  • Block Vector_Representation: Vector Representation
    Description of one type of vector symbolization.
    Control file can contain multiple blocks of this type.
    Hint: More info at "NCPLOT: Types of vector symbols".
  • Block Textbox: Free Text
    Description of one free text field.
    Control file can contain multiple blocks of this type.
  • Block Dataset: Data set
    Description of a data set to be displayed.
    Control file can contain multiple blocks of this type.
  • Key "Name" : unique name of this data set.
  • Key "File" : name of the CF-NetCDF file (*.nc) with the data to be displayed.
  • Key "Variable" : Description of the data whose values are to be displayed.
  • Parameter 1 = name of the variable (in file of type *.nc)
  • (optional) Parameter 2 = role of the variable as part of a vector
  • X-component = Variable is the X component of a vector
  • Y-component = Variable is the Y component of a vector
  • normal_component = Variable is the normal component of a vector
Hint: The command "ncdump -h <filename>.nc" shows the header of the CF-NetCDF file. The names of the offered variables and their dimensions can be found in the metadata.
  • Key "Start" : start address for the data to be displayed.
  • Key "Step" : number of steps for the data to be displayed.
  • Key "Stride" : increment for the data to be displayed.
Hints:
For each dimension of the variable a start, step and stride value must be specified.
The page NCPLOT: Define DataSet gives instructions for addressing the desired data.
  • Block Layer:
    Description of the content of a layer.
    Control file can contain multiple blocks of this type.
  • Key "Name" : unique name of this layer.
  • Key "Layer_Dataset_Name" : name of the dataset to be displayed. Or a valid connexion (OPERATOR string) made out of known data sets, e. g. [DSet2-DSet1]/[DSet1+DSet2], ABS[DSet1] or SQR[DSet1].
  • Key "Layer_Normalization_Transformation_Name" : name of the normalization transformation for this layer.
  • Key "Layer_Type" : type of data view of this layer.
Hint: Currently only "XY_data" = horizontal view implemented.
  • Key "Layer_Primitive_Name" : graphic primitive to visualize the data in the layer.
  • Parameter 1 = Symbolization of the layer
  • GPM = as poly marker
  • GPL = as poly line
  • GFA = as fill area
  • GTX = as text
  • VEC = as vector
  • (optional) Parameter 2 = Type of the vector
    ... optional parameter, only at VEC visualization permitted.
    ...allows, for example, the interpolation of the total vector from the normal component a vectorial quantity.
  • total = total vector
  • normal = normal vector
Hint: The primitive must fit to the underlying geometry of the data!
"node" data: GPM, GTX, VEC
"edge" data: GPM, GPL, GTX, VEC
"face" data: GPM, GPL, GFA, GTX, VEC
  • Key "Layer_Primitive_Representation_Name" : name of the representation of the primitive.
  • Key "Layer_Bounds_Name" : name of the interval definition for this layer (from the file bounds.cfg.dat).
Hint: The number of intervals in the interval definition and the number of colors of the associated color legend must match.
  • Key "Layer_Palette_Name" : name of the color legend for this layer (corresponds to the attribute Name in the file palette.dat. More detailed information about palettes on file description page palettes.cfg.dat).
  • Key "Layer_Invert_Palette" : invertation of the color ramp.
  • Key "Layer_Legend_NTN_Name" : image area for the color legend of this layer.
  • Key "Layer_Framing" : type of framing for this layer.
Hint: More info at "Options of the layer framing".
  • Key "Layer_Description_NTN_Name" : image area for the data description (e.g. Indication of the time).
  • (optional) Key "Layer_Display_Units" : Physical unit in which the data should be converted for the graphical presentation.
Hints:
The original unit of the data and the target unit must be known in the configuration file phydef.cfg.si.dat. In addition, the SI-base (dimension) of the units must be identical.
  • (optional) Key "Layer_Display_Name" : Name of physical quantity, will be used instead of the original name given in the input data set. Without this line the name in PHYDEF is used, if the variable owns the attribute name_id.
  • (optional) Key "Layer_Vector_Legend_NTN_Name" : image area for the vector legend in case of arrows with length_type proportional.
  • (optional) Key "Layer_Vector_Thinout_Raster" : dimensions of the grid used to thin out the display of vector arrows.
  • (optional) Key "Layer_NOBS_Filter" : filter for displayed data based on ancillary variable with type number of observations:
    • parameter 1: filter type:
      • EQ = display data only for a fixed number of observations;
      • LE = display data for a certain number of observations or less;
      • LE = display data for a certain number of observations or more.
    • parameter 2: filter value:
      • 0 = maximum number of observations;
      • N = specified number of observations;
      • -M = maximum number of observations minus M.

General Remarks

  1. While reading this steering data file the dictionary file ncplot_dico.dat will be automatically accessed in directory $PROGHOME/dic/ to support input.
  2. If no such file exists in the working directory, NCPLOT accesses the following configuration files from the directory $PROGHOME/cfg/:
    • colors.cfg.dat: File with definitions of colors.
    • palettes.cfg.dat: File with references to files with color palette definitions.
    • bounds.cfg.dat: File with interval definitions for legends.
      Hint: The bounds file should be better stored within a project in the working directory.
  3. The following standard configuration files from the directory $PROGHOME/cfg/ are required:
    • gkssystem.rechnername.dat: GKS parameter file.
    • phydef.cfg.si.dat: Configuration file for units and their relation to the SI system.

Programs using this Type of File

NCPLOT

Additional Information

Language

Fortran90

File-Form

FORMATTED

File-Access

SEQUENTIAL

File-Extension

.dat

WRITE-Subroutine(s)/Module(s)

---

READ-Subroutine(s)/Module(s)

$PROGHOME/fortran/prg/ncplot/*/mod_m_ncplot_steer.f90

Original Version

G. Lang

Maintenance

G. Lang, S. Spohr

Example-File

$PROGHOME/examples/ncplot/ncplot.dat


back to: File Descriptions


Overview