NCPLOT.DAT

Basisinformationen

Datei-Typ

ncplot.dat

Datei-Form

FORMATTED

Version

August 2016

Beschreibung

August 2016

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.

• (optional) Key "Infobox_NTN_Name" : Normalisierungstransformation für die Metadaten-Infobox.

Über die Zuordnung dieser NTN werden der Grafik Informationen zur Ploterstellung mitgegeben. Dazu gehören auch Angaben zu den zugrundeliegenden Datendateien sowie Hinweise auf ggf. bei der Darstellung eingesetzte Datenfilterung.

• 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); optional kann hierfür auch der Key "Autoscale" genutzt werden. 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 (zur grafischen Darstellung) 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.
• (optional) Key "Autoscale" : automatische Angleichung (.true.) des Masstabs in x- und y-Richtung. Default ist .false. (keine Angleichung).

• 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 Textbox: Möglichkeit einen freien Text anzugeben
  Beschreibung eines Textes, bzw. Textfeldes.
  Steuerdatei kann mehrere Blöcke diesen Typs enthalten.

• Key "Name" : eindeutiger Name der Textbox.
• Key "NTN_Name" : Bildbereich für die Textbox, d.h. Namen der zuständigen Normalisierungstransformation.
• (optional) Key "Text_Line" : eine Zeile des Textfeldes. Angabe mehrere Zeilen möglich.
• (optional) Key "Color_Name" : die Farbe des Textfeldes.
• (optional) Key "Draw_Frame" : Umrandung des Textfeldes zeichnen oder nicht.
• (optional) Key "Fixed_Width" : Zeichenweise mit konstanter Breite schreiben oder nicht.
• (optional) Key "Horizontal_Char_Space" : Horizontaler Zeichen-Abstandsfaktor beim zeichenweisen Schreiben.
• (optional) Key "Vertical_Line_Space" : Vertikaler Zeilen-Abstandsfaktor.
• (optional) Key "Font_Size" : Schriftgröße kann ggf. vorgegeben werden.
• (optional) Key "Font_Size_Factor" : Faktor zum Manipulieren der berechneten Schriftgröße.

• 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], ABS[DSet], SQR[DSet] oder G18[DSet].
• 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 zulässig
  ... erlaubt bspw. die Interpolation des Gesamtvektors aus der Normalkomponente einer vektoriellen Größe.

• 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. Ohne diese Zeile wird bei vorhandenem Attribut name_id die PHYDEF-Bezeichnung eingesetzt.
• (optional) Key "Layer_Vector_Legend_NTN_Name" : Name der NTN für die Längen-Legende zu einem Proportionalpfeil.
• (optional) Key "Layer_Vector_Thinout_Raster" : Abmessungen des Rasters für das Ausdünnen der Anzeige von Pfeilen bei vektoriellen Größen.
• (optional) Key "Layer_NOBS_Filter" : Filterung der Darstellung der Ergebnisse mit Hilfe einer ancillary variable des Typs number of observations (Anzahl-Filter):
  • Parameter 1: Typ des Filters:
    • EQ = stelle die Daten nur für eine bestimmte Anzahl von Eingangsdaten dar;
    • LE = stelle die Daten nur für weniger oder gleich einer bestimmten Anzahl von Eingangsdaten dar;
    • LE = stelle die Daten nur für mehr oder gleich einer bestimmten Anzahl von Eingangsdaten dar.
  • Parameter 2: Wert des Filters:
    • 0 = maximale Anzahl der Ereignisse in den Eingangsdaten;
    • N = eine bestimmte Anzahl von Ereignissen in den Eingangsdaten;
    • -M = maximale Anzahl der Ereignisse in den Eingangsdaten minus M.

Anmerkungen

1. Beim Lesen der Daten wird automatisch auch auf die Dictionary-Datei ncplot_dico.dat in dem Verzeichnis $PROGHOME/dic/ zugegriffen.
2. 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.
3. 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