Aktionen

NCPLOT.DAT

Aus BAWiki

Version vom 18. Dezember 2015, 09:56 Uhr von imported>Spohr Susanne (Metadaten-Infobox und BLOCK Textbox)

Basisinformationen

Datei-Typ

ncplot.dat

Datei-Form

FORMATTED

Version

Dezember 2015

Beschreibung

Dezember 2015

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). 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 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[DSet1] oder SQR[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 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

Abgerufen von „https://wiki.baw.de/de/index.php?title=NCPLOT.DAT&oldid=7589“