NCPLOT.DAT

Basic Information

File-Type

ncplot.dat

File-Form

FORMATTED

Version

March 2013

Description-Date

March 2013

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.

• 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 "Transformation_Number" : unique number 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: Darstellung von Poly-Markern
  Description of one type of marker symbols.
  Control file can contain multiple blocks of this type.

• Block Fill_Area_Representation: Fill-Area Repräsentation
  Description of one type of fill area symbolization.
  Control file can contain multiple blocks of this type.

• Block Poly_Line_Representation: Poly-Line Repräsentation
  Description of one type of line symbolization.
  Control file can contain multiple blocks of this type.

• Block Text_Representation: Text Repräsentation
  Description of one type of text symbolization.
  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" : name of the variable to be displayed.

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.

Programs using this Type of File

NCPLOT

Example-File

$PROGHOME/examples/ncplot/ncplot.dat

---

back to: File Descriptions

---

Overview