NCPLOT.DAT: Unterschied zwischen den Versionen

Version vom 21. Februar 2014, 12:47 Uhr

Basisinformationen

Datei-Typ

ncplot.dat

Datei-Form

FORMATTED

Version

Februar 2014

Beschreibung

Februar 2014

Bedeutung der Datei

enthält allgemeine Eingabedaten für das Programm NCPLOT

Datei-Inhalt

Eingabesteuerdaten

Block Program_Parameters: Allgemeine Steuerdaten

Key "Language" : Spracheinstellung für Beschriftungen und Texte:

DE = Deutsch,
EN = Englisch.

Key "Max_Read_Storage" : max. Lesespeicher (in Byte) für Analysen
Key "Min_Water_Depth" : minimale Wasserbedeckung in [m].

Hinweis: Das Aussparen der Darstellung bei zu geringer Wasserbedeckung ist nur möglich, wenn die darzustellende Variable auf bestimmte Weise auf eine Variable mit der zugehörige Gesamtwassertiefe verweist.
Die CF-NetCDF-Ausgabe der UnTRIM-Programme erfüllt diese Voraussetzung.
Die Seite NCPLOT: Min_Water_Depth illustriert die Wirkung dieses Steuerparameters.

Block Normalization_Transformation: Normalisierungstransformation (NTN)
Definition eines Bildausschnitts und Beschreibung des Zusammenhangs zwischen Welt- und Bild-Koordinaten. Die Koordinaten der Zeichenfläche, dem sogenannten NDC-Raum, reichen von [0.0,0.0] bis [1.0,1.0]. Für eine unverzerrte Darstellung des Gebietes muss der Darstellungs-Massstab in X-Richtung mit dem in Y-Richtung übereinstimmen (dWC/dNDC=const). Verzerrte Darstellungen sind aber auch möglich.
Neben der Positionierung von Kartenfenstern werden die NTNs auch für die Anordnung von Legenden und Textfenstern verwendet. Legenden können horizontal oder vertikal aufgetragen werden.

Key "Name" : eindeutiger Name der Normalisierungstransformation.
Key "EPSG" : EPSG-Code der "Window_Coordinates".
Key "EPSG_Window" : EPSG-Code der Koordinaten wie sie intern verwendet werden sollen.
Key "Left_Lower_Window_Coordinates" : Welt-Koordinaten (WC gemäß EPSG) der linken unteren Ecke des Projektionsfensters.
Key "Right_Upper_Window_Coordinates" : Welt-Koordinaten (WC gemäß EPSG) der rechten oberen Ecke des Projektionsfensters.
Key "Left_Lower_NDC_Coordinates" : Bild-Koordinaten (NDC innerhalb [0.0,1.0]) der linken unteren Ecke des Projektionsfensters.
Key "Right_Upper_NDC_Coordinates" : Bild-Koordinaten (NDC innerhalb [0.0,1.0]) der rechten oberen Ecke des Projektionsfensters.

Block Poly_Marker_Representation: Darstellung von Poly-Markern
Beschreibung einer Sorte von Marker-Symbolen.
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.

Key "Name" : eindeutiger Name der Poly-Marker Repräsentation.
Key "Poly_Marker_Type" : Typ-ID der Poly-Marker.

1 = .
2 = +
3 = *
4 = o
5 = x

Key "Poly_Marker_Size" : Größenfaktor der Poly-Marker.
Key "Poly_Marker_Color_Name" : Name der Farbe für die Poly-Marker.
(optional) Key "Poly_Marker_Coli" : Farbindex der Poly-Marker.

Block Fill_Area_Representation: Fill-Area Repräsentation
Beschreibung einer Art von Flächenfüllung.
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.

Key "Name" : eindeutiger Name der Fill-Area Repräsentation.
Key "Fill_Area_Interior_Style" : Art der Flächen-Füllung.

0 = HOLLOW (nur Umrandung zeichnen)
1 = SOLID (flächenhaft füllen)
2 = PATTERN (Musterfüllung - derzeit nicht unterstützt)
3 = HATCH (Schraffur - derzeit nicht unterstützt)

Key "Fill_Area_Color_Name " : Name der Farbe für die Flächen-Füllung.
(optional) Key "Fill_Area_Style" : Stil-Index der Flächen-Füllung.
(optional) Key "Fill_Area_Coli" : Farbindex der Flächen-Füllung.

Block Poly_Line_Representation: Poly-Line Repräsentation
Beschreibung einer Form der Linien-Darstellung.
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.

Key "Name" : eindeutiger Name der Poly-Line Repräsentation.
Key "Poly_Line_Type" : Typ der Poly-Linien.

1 = --------- durchgezogene Linie
2 = - - - - - gestrichelte Linie
3 = ......... punktierte Linie
4 = -.-.-.-.- strich-punktierte Linie

Key "Poly_Line_Width" : Breitenfaktor der Poly-Linien.
Key "Poly_Line_Color_Name" : Name der Farbe für die Linien.
(optional) Key "Poly_Line_Coli" : Farbindex der Poly-Linien.

Block Text_Representation: Text Repräsentation
Beschreibung einer Art der Text-Darstellung.
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.

Key "Name" : eindeutiger Name der Text Repräsentation.
Key "Text_Character_Height" : Zeichenhöhe der Texte.
Key "Text_X_Character_Up_Vector" : X-Komponente des Character-Up-Vektors.
Key "Text_Y_Character_Up_Vector" : Y-Komponente des Character-Up-Vektors.

Hinweis: Über den Character-Up-Vektor kann die Orientierung der Basislinie der Schrift sowie deren Schrägstellung beeinflusst werden.

Key "Text_Color_Name" : Name der Farbe für die Texte.
(optional) Key "Text_Path" : Laufrichtung der Schrift.
(optional) Key "Text_Horizontal_Alignment" : horizontale Textausrichung der Schrift.
(optional) Key "Text_Vertical_Alignment" : vertikale Textausrichtung der Schrift.
(optional) Key "Text_Font" : Zeichensatz.
(optional) Key "Text_Precision" : Qualität des Zeichensatzes.
(optional) Key "Text_Character_Expansion_Factor" : Laufweite eines Zeichens (Standard = 1.0).
(optional) Key "Text_Character_Spacing" : zusätzlicher Leerraum zwischen Zeichen (Standard = 0.0).
(optional) Key "Text_Coli" : Farbindex für die Texte.

Block Vector_Representation: Vektor Repräsentation
Beschreibung einer Form der Vektor-Darstellung.
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.

Key "Name" : eindeutiger Name der Vektor Repräsentation.
Key "Vector_Length_Type" : Längen-Abhängigkeit des Pfeils vom Vektorbetrag.

constant = Alle Pfeile sind gleich groß
proportional = Größe des Pfeils ist abhängig von Vektorbetrag

Key "Vector_Symbol_Scale_Infos" : Informationen zur Skalierung des Vektor-Symbols.

Parameter 1 = Vektorbetrag, unterhalb dessen keine Symbolisierung mehr erfolgt
Parameter 2 = Länge des Symbols (in WC, analog Text_Character_Height)
(optional) Parameter 3 = Vektorbetrag, der mit der in Parameter 2 angegebenen Symbollänge visualisiert wird (nur bei Proportionalpfeilen nötig)

Key "Vector_Symbol_Style" : Typ des Vektor-Symbols.

only_a_line = nur eine Linie
simple_arrowL = ein einfacher Pfeil nur aus Linienzügen
simple_arrowF = ein einfacher Pfeil mit gefüllter Pfeilspitze
triangle = ein Dreieck
arrow_deluxe = ein Luxus-Pfeil, der auch OUTLINE und HOLLOW ermöglicht

Hinweis: Weitere Info unter "NCPLOT: Vektor-Symbole".

Key "Vector_Poly_Line_Representation" : Name der Poly-Line Repräsentation, die ggf. beim Zeichnen des Pfeils zum Einsatz kommt.
Key "Vector_Fill_Area_Representation" : Name der Fill-Area Repräsentation, die ggf. beim Zeichnen des Pfeils zum Einsatz kommt.
(optional) Key "Vector_Anchor_Point" : Rotations-, bzw. Ankerpunkt des Vektors.

start = Pfeil dreht um seinen Anfangspunkt
center = Pfeil dreht um seine Mitte (ist Default)
end = Pfeil dreht um seine Spitze

(optional) Key "Vector_Head_Angle" : Winkel für die Pfeilspitze in Grad (Default:40.0).
(optional) Key "Vector_Symbol_Proportions" : Proportionen des Vektor-Symbols.

Parameter 1 = Verhältnis Kopflänge zu Gesamtlänge (Default:0.375)
Parameter 2 = Verhältnis Stielbreite zu Kopfbreite (Default:0.5)

Block Dataset: Datensatz
Beschreibung eines darzustellenden Datensatzes.
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.

Key "Name" : eindeutiger Name des Datensatzes.
Key "File" : Name der CF-NetCDF-Datei (*.nc) mit den darzustellenden Daten.
Key "Variable" : Beschreibung der Daten deren Werte visualisiert werden sollen.

Parameter 1 = Name der Variablen (in *.nc Datei)
(optional) Parameter 2 = Rolle der Variablen bei Vektor-Komponenten

X-component = Variable ist X-Komponente eines Vektors
Y-component = Variable ist Y-Komponente eines Vektors
normal_component = Variable ist Normalkomponente eines Vektors

Hinweis: Der Befehl "ncdump -h <filename>.nc" zeigt den Header der CF-NetCDF-Datei. Die Namen der angebotenen Variablen und deren Dimensionierung lassen sich den Metadaten entnehmen.

Key "Start" : Startadresse für die darzustellenden Daten.
Key "Step" : Anzahl der Schritte für die darzustellenden Daten.
Key "Stride" : Schrittweite für die darzustellenden Daten.

Hinweis: Für jede Dimension der Variablen muss ein Startindex, ein Step-Wert und eine Schrittweite angegeben werden. Die Seite NCPLOT: DataSet definieren gibt Tipps zum Adressieren der gewünschten Daten.

Block Layer:
Beschreibung des Inhalts eines Layers.
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.

Key "Name" : eindeutiger Name des Layers.
Key "Layer_Dataset_Name" : Name des Datensatzes, der dargestellt werden soll. Oder oder eine zulässige Verknüpfung (OPERATOR-String) aus bekannten Datensatz Namen, z. B. [DSet2-DSet1]/[DSet1+DSet2] oder ABS[DSet1].
Key "Layer_Normalization_Transformation_Name" : Name der Normalisierungstransformation für diesen Layer.
Key "Layer_Type" : Art der Darstellung des Layers.

Hinweis: Derzeit nur XY_data = horizontale Ebene, bzw. Draufsicht implementiert.

Key "Layer_Primitive_Name" : Grafik-Primitiv mit dem die Daten des Layers visualisiert werden.

Parameter 1 = Symbolisierung des Layers

GPM = als Poly-Marker
GPL = als Poly-Lines
GFA = als Fill-Areas
GTX = als Text
VEC = als Vektoren

(optional) Parameter 2 = Art des dargestellten Vektors
... optionaler Parameter, nur bei VEC-Visualisierung zulaessig
... erlaubt bspw. die Interpolation des Gesamtvektors aus der Normalkomponente einer vektoriellen Groesse.

total = Gesamtvektor
normal = Normalenvektor

Hinweis: Das Primitiv muss zu der zugrundeliegenden Geometrie der Daten passen!
"node"-daten: GPM, GTX, VEC
"edge"-daten: GPM, GPL, GTX, VEC
"face"-daten: GPM, GPL, GFA, GTX, VEC

Key "Layer_Primitive_Representation_Name" : Name der Repräsentation, die das Grafik-Primitiv des Layers umsetzt.
Key "Layer_Bounds_Name" : Name der Intervalldefinition für diesen Layer (aus Datei bounds.cfg.dat).

Hinweis: Die Anzahl der Intervalle der Intervalldefinition und die Anzahl der Farben der zugeordneten Palette müssen übereinstimmen.

Key "Layer_Palette_Name" : Name der Farblegende für diesen Layer (entspricht Attribut Name der Datei vom Typ palette.dat. Mehr Information dazu liefert Dateikennblatt palettes.cfg.dat).
Key "Layer_Invert_Palette" : Farbverlauf invertieren.
Key "Layer_Legend_NTN_Name" : Bildbereich für die Farb-Legende dieses Layers, d.h. Namen der zuständigen Normalisierungstransformation.
Key "Layer_Framing" : Art der Umrahmung des Layers.

Hinweis: Weitere Info unter "Optionen der Layer-Rahmung".

Key "Layer_Description_NTN_Name" : Bildbereich für die Daten-Beschriftung (Angabe des Zeitpunktes) dieses Layers, d.h. Name der zuständigen Normalisierungstransformation.
(optional) Key "Layer_Display_Units" : Physikalische Einheit, in die die Daten für die grafische Darstellung konvertiert werden sollen.

Hinweis: Die Einheit in der die Daten vorliegen und die Ziel-Einheit müssen in der Standard-Konfigurationsdatei phydef.cfg.si.dat bekannt und dürfen sich bezüglich ihrer SI-Basis (Dimension) nur in den Dimensionen Länge (Exponent +3 +2 +1 -1 -2 -3) und Zeit (Exponent +1 -1) unterschieden.

(optional) Key "Layer_Display_Name" : Name der physikalischen Größe, wird an Stelle des in den Eingabedaten vorhandenen Namens verwendet.
(optional) Key "Layer_Vector_Legend_NTN_Name" : Name der NTN für die Längen-Legende zu einem Proportionalpfeil.

Anmerkungen

Beim Lesen der Daten wird automatisch auch auf die Dictionary-Datei ncplot_dico.dat in dem Verzeichnis $PROGHOME/dic/ zugegriffen.
Falls keine entsprechenden Dateien im Arbeitsverzeichnis vorliegen, greift NCPLOT auf folgende Konfigurationsdateien aus dem Verzeichnis $PROGHOME/cfg/ zu:
- colors.cfg.dat: Datei mit Definitionen von Farben.
- palettes.cfg.dat: Datei mit Verweisen auf Dateien mit Farbpaletten-Definitionen.
- bounds.cfg.dat: Datei mit Intervalldefinitionen für Legenden.
  Hinweis: Die Bounds-Datei sollte besser projektspezifisch im Arbeitsverzeichnis angelegt werden.
Des weiteren werden von dem Programm folgende Standard-Konfigurationsdateien aus dem Verzeichnis $PROGHOME/cfg/ benötigt:
- gkssystem.rechnername.dat: Datei mit GKS-Parametern.
- phydef.cfg.si.dat: Konfigurationsdatei für Einheiten und deren Bezug zum SI-System.

Programme, welche diesen Datei-Typ benutzen

NCPLOT

Beispiel-Datei

$PROGHOME/examples/ncplot/ncplot.dat

zurück zu: Dateikennblätter

Strukturübersicht

@@ Zeile 2: / Zeile 2: @@
 |name_en=NCPLOT.DAT
 |dateityp=ncplot.dat
-|version=Dezember 2013
+|version=Februar 2014
-|version_beschr=Dezember 2013
+|version_beschr=Februar 2014
 |bedeutung=enthält allgemeine Eingabedaten für das Programm [[NCPLOT]]
 |dateiinhalt=
@@ Zeile 124: / Zeile 124: @@
 ::Hinweis: Derzeit nur XY_data = horizontale Ebene, bzw. Draufsicht implementiert.
 :* Key '''"Layer_Primitive_Name" : Grafik-Primitiv''' mit dem die Daten des Layers visualisiert werden.
-::*'''GPM''' = als Poly-Marker
+::* Parameter '''1''' = Symbolisierung des Layers
-::*'''GPL''' = als Poly-Lines
+:::*'''GPM''' = als Poly-Marker
-::*'''GFA''' = als Fill-Areas
+:::*'''GPL''' = als Poly-Lines
-::*'''GTX''' = als Text
+:::*'''GFA''' = als Fill-Areas
-::*'''VEC''' = als Vektoren
+:::*'''GTX''' = als Text
+:::*'''VEC''' = als Vektoren
+::* (optional) Parameter '''2''' = Art des dargestellten Vektors<br />... optionaler Parameter, nur bei VEC-Visualisierung zulaessig<br />... erlaubt bspw. die Interpolation des Gesamtvektors aus der Normalkomponente einer vektoriellen Groesse.
+:::*'''total''' = Gesamtvektor
+:::*'''normal''' = Normalenvektor
 ::Hinweis: Das Primitiv muss zu der zugrundeliegenden Geometrie der Daten passen!<br />"node"-daten: GPM, GTX, VEC<br />"edge"-daten: GPM, GPL, GTX, VEC<br />"face"-daten: GPM, GPL, GFA, GTX, VEC
 :* Key '''"Layer_Primitive_Representation_Name" : Name der Repräsentation''', die das Grafik-Primitiv des Layers umsetzt.