Aktionen

NCPLOT.DAT: Unterschied zwischen den Versionen

Aus BAWiki

imported>Spohr Susanne
K (NCPLOT: DataSet definieren)
imported>Spohr Susanne
KKeine Bearbeitungszusammenfassung
Zeile 1: Zeile 1:
{{Dateikennblatt
{{FileDescription
|name_en=NCPLOT.DAT
|name_de=NCPLOT.DAT
|dateityp=ncplot.dat  
|filetype=ncplot.dat
|version=März 2013
|version=March 2013
|version_beschr=März 2013
|version_descr=March 2013
|bedeutung=enthält allgemeine Eingabedaten für das Programm [[NCPLOT]]
|significance=contains general steering data for the program [[NCPLOT]].
|dateiinhalt=
|filecontents=
'''Eingabesteuerdaten'''
'''steering data'''


* Block '''Program_Parameters''': Allgemeine Steuerdaten
* Block '''Program_Parameters''': general steering data
:* Key '''"Language" : Spracheinstellung''' für Beschriftungen und Texte:
:* Key '''"Language" : Language preference''' for labels and texts:
::*'''DE''' = Deutsch,
::*'''DE''' = German,
::*'''EN''' = Englisch.
::*'''EN''' = English.
:* Key '''"Max_Read_Storage" : max. Lesespeicher''' (in Byte) für Analysen
:* Key '''"Max_Read_Storage" : max. read only memory''' (in bytes) for analysis
:* Key '''"Min_Water_Depth" : minimale Wasserbedeckung''' in [m].
:* Key '''"Min_Water_Depth" : minimum water coverage''' 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.<br />Die CF-NetCDF-Ausgabe der UnTRIM-Programme erfüllt diese Voraussetzung.<br />Die Seite [[NCPLOT: Min_Water_Depth]] illustriert die Wirkung dieses Steuerparameters.
::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.<br />The CF-NetCDF output of UnTRIM programs fulfills this requirement.<br />The page [[NCPLOT: Min_Water_Depth]] illustrates the effect of this control parameter.


* Block '''Normalization_Transformation''': Normalisierungstransformation (NTN)<br />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.<br />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.<br />
* Block '''Normalization_Transformation''': normalization transformation (NTN)<br /> 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.<br /> 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.<br />
:* Key '''"Name" : eindeutiger Name''' der Normalisierungstransformation.
:* Key '''"Name" : unique name''' of this normalization transformation.
:* Key '''"Transformation_Number" : eindeutige Nummer''' der Normalisierungstransformation.
:* Key '''"Transformation_Number" : unique number''' of this normalization transformation.
:* Key '''"EPSG" : EPSG-Code''' der "Window_Coordinates".
:* Key '''"EPSG" : EPSG code''' of the data coordinates in the file.
:* Key '''"EPSG_Window" : EPSG-Code der Koordinaten''' wie sie intern verwendet werden sollen.
:* Key '''"EPSG_Window" : EPSG code''' of the plot projection.
:* Key '''"Left_Lower_Window_Coordinates" : Welt-Koordinaten (WC gemäß EPSG)''' der linken unteren Ecke des Projektionsfensters.
:* Key '''"Left_Lower_Window_Coordinates" : World coordinates (according to EPSG)''' the lower left corner of the projection window.
:* Key '''"Right_Upper_Window_Coordinates" : Welt-Koordinaten (WC gemäß EPSG)''' der rechten oberen Ecke des Projektionsfensters.
:* Key '''"Right_Upper_Window_Coordinates" : World coordinates (according to EPSG)''' the upper right corner of the projection window.
:* Key '''"Left_Lower_NDC_Coordinates" : Bild-Koordinaten (NDC innerhalb [0.0,1.0])''' der linken unteren Ecke des Projektionsfensters.
:* 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" : Bild-Koordinaten (NDC innerhalb [0.0,1.0])''' der rechten oberen Ecke des Projektionsfensters.
:* 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<br />Beschreibung einer Sorte von Marker-Symbolen.<br />Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Block '''Poly_Marker_Representation''': Darstellung von Poly-Markern<br />Description of one type of marker symbols.<br />Control file can contain multiple blocks of this type.
:* Key '''"Name" : eindeutiger Name''' der Poly-Marker Repräsentation.
:* Key '''"Poly_Marker_Index" : eindeutige Nummer''' 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_Coli" : Farbindex''' der Poly-Marker.
:* Key '''"Poly_Marker_Color_Name" : Name der Farbe''' für die Poly-Marker.


* Block '''Fill_Area_Representation''': Fill-Area Repräsentation<br />Beschreibung einer Art von Flächenfüllung.<br />Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Block '''Fill_Area_Representation''': Fill-Area Repräsentation<br />Description of one type of fill area symbolization.<br />Control file can contain multiple blocks of this type.
:* Key '''"Name" : eindeutiger Name''' der Fill-Area Repräsentation.
:* Key '''"Fill_Area_Index" : eindeutige Nummer''' 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_Style" : Stil-Index''' der Flächen-Füllung.
:* Key '''"Fill_Area_Coli" : Farbindex''' der Flächen-Füllung.
:* Key '''"Fill_Area_Color_Name " : Name der Farbe''' für die Flächen-Füllung.


* Block '''Poly_Line_Representation''': Poly-Line Repräsentation<br />Beschreibung einer Form der Linien-Darstellung.<br />Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Block '''Poly_Line_Representation''': Poly-Line Repräsentation<br />Description of one type of line symbolization.<br />Control file can contain multiple blocks of this type.
:* Key '''"Name" : eindeutiger Name''' der Poly-Line Repräsentation.
:* Key '''"Poly_Line_Index" : eindeutige Nummer''' 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_Coli" : Farbindex''' der Poly-Linien.
:* Key '''"Poly_Line_Color_Name" : Name der Farbe''' für die Linien.


* Block '''Text_Representation''': Text Repräsentation<br />Beschreibung einer Art der Text-Darstellung.<br />Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Block '''Text_Representation''': Text Repräsentation<br />Description of one type of text symbolization.<br />Control file can contain multiple blocks of this type.
:* Key '''"Name" : eindeutiger Name''' der Text Repräsentation.
:* Key '''"Text_Index" : eindeutige Nummer''' 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_Path" : Laufrichtung''' der Schrift.
:* Key '''"Text_Horizontal_Alignment" : horizontale Textausrichung''' der Schrift.
:* Key '''"Text_Vertical_Alignment" : vertikale Textausrichtung''' der Schrift.
:* Key '''"Text_Font" : Zeichensatz'''.
:* Key '''"Text_Precision" : Qualität des Zeichensatzes'''.
:* Key '''"Text_Character_Expansion_Factor" : Laufweite eines Zeichens''' (Standard = 1.0).
:* Key '''"Text_Character_Spacing" : zusätzlicher Leerraum zwischen Zeichen''' (Standard = 0.0).
:* Key '''"Text_Coli" : Farbindex''' für die Texte.
:* Key '''"Text_Color_Name" : Name der Farbe''' für die Texte.


* Block '''Dataset''': Datensatz<br />Beschreibung eines darzustellenden Datensatzes.<br />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" : Name der Variablen''' deren Werte visualisiert werden sollen.
::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''' der darzustellenden Daten.
:* Key '''"Step" : Anzahl der Schritte''' für alle Dimensionen.
:* Key '''"Stride" : Schrittweite''' für alle Dimensionen.
::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''': <br />Beschreibung des Inhalts eines Layers.<br />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.
:* 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
::Hinweis: Das Primitiv muss zu der zugrundeliegenden Geometrie der Daten passen!<br />"node"-daten: GPM, GTX<br />"edge"-daten: GPM, GPL, GTX<br />"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|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|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 "[[NCPLOT: Umrahmung|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.
===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.<br />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.
|nutzerprogramme=[[NCPLOT]]
|nutzerprogramme=[[NCPLOT]]
|programmiersprache=Fortran90
|language=Fortran90
|dateiform=FORMATTED
|fileform=FORMATTED
|dateizugriff=SEQUENTIAL
|fileaccess=SEQUENTIAL
|dateiendung=.dat
|fileextension=.dat
|schreibmodule=interaktive Erstellung, Editor
|writemodules= ---
|lesemodule=$PROGHOME/fortran/prg/ncplot/*/mod_m_ncplot_steer.f90
|readmodules=$PROGHOME/fortran/prg/ncplot/*/mod_m_ncplot_steer.f90
|kontakt_original=[mailto:guenther.lang@baw.de G. Lang]
|contact_original=[mailto:guenther.lang@baw.de G. Lang]
|kontakt_pflege=[mailto:guenther.lang@baw.de G. Lang], [mailto:susanne.spohr@baw.de S. Spohr]
|contact_maintenance=[mailto:guenther.lang@baw.de G. Lang], [mailto:susanne.spohr@baw.de S. Spohr]
|beispieldatei=$PROGHOME/examples/ncplot/ncplot.dat
|examplefile=$PROGHOME/examples/ncplot/ncplot.dat
}}
}}

Version vom 22. März 2013, 16:05 Uhr

Vorlage:FileDescription

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