NCPLOT.DAT

Basisinformationen

Datei-Typ

ncplot.dat

Datei-Form

FORMATTED

Version

November 2013

Beschreibung

November 2013

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 = X-Komponente des Vektors
• Y-component = Y-Komponente des 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.

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

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

• 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

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