NCCUTOUT

Basisinformationen

Programm-Name

NCCUTOUT

Version

Juli 2022

Beschreibung

Januar 2022

Stichworte

Analyse
Postprocessor
synoptische Berechnungsergebnisse
Tidekennwerte
Tideunabhängige Kennwerte
Differenzen synoptischer Berechnungsergebnisse
Differenzen von Ergebnissen
CF NetCDF Format für 2D- und 3D-Daten
Verfahren für unstrukturierte orthogonale Gitternetze
Unterstützung von Simulationsergebnissen mit SubGrid
Unterstützung von DMQS-Metadaten und -Variablen
(Teil-) Automatisierte Qualitätssicherung (Wertebereich)
Ablage des Inhalts der ASCII-Eingabesteuerdateien in netcdf.nc (als Variable)
Ablage der MD5-Hash-Werte von Eingabedateien in netcdf.nc (als Variable)
optionale Verwendung der Message Passing Interface (MPI, MPI Forum)

Danksagung: This project took advantage of netCDF software developed by UCAR/Unidata (www.unidata.ucar.edu/software/netcdf/).

Kurzbeschreibung

Abb. 1: Aus dem Gesamtmodell des Projekts EasyGSH-DB herausgeschnittene Ergebnisse der Deutschen Bucht

Der Postprocessor NCCUTOUT kann die Größe von Ergebnisdateien reduzieren um Plattenplatz und Rechenzeit in den anschließenden Bearbeitungsschritten zu sparen. Er schneidet Daten aus UGRID-konformen NetCDF-Dateien vom Typ Area heraus. In der UGRID Metadaten-Terminologie bedeutet das, dass die Datei zumindest eine Mesh-Topology mit dem Attribut topology_dimension = 2 aufweisen muss. Das auszuschneidende Gebiet wird typischerweise über ein Polygon definiert. Die innerhalb des Polygons liegenden Elemente (Faces, Edges oder Nodes) werden in die Ausgabedatei geschrieben.

Abb. 2: Aus dem Modell des Jade-Weser-Ästuars an separaten Lokationen herausgeschnittene Ergebnisse, s. nordwestliche und südöstliche Ecke

Das auszuschneidende Gebiet kann aber auch von zwei oder mehr Polygonen, die nicht direkte Nachbarn sein müssen, definiert werden, s. Abb. 2. Obwohl die Ergebnisse wie getrennt auf einem Location Grid vorliegend aussehen, so teilen sie doch eine gemeinsame Mesh Topology.

User können mit dem Plattenplatz außerdem durch eine Auswahl der zu konvertierenden geophysikalischen Variablen pfleglich umgehen. Dies wird wahlweise durch eine Black- oder eine White-Liste gesteuert.

Eingabe-Dateien

1. allgemeine Eingabedaten (Dateityp nccutout.dat);
2. Eingabe-UGRID-CF-NetCDFs (Dateityp cf-netcdf.nc);
3. Schnittpolygone (file type ipds.dat);
4. für eine (teil-) automatisierte Qualitätssicherung (Dateityp bounds_verify.dat).

Ausgabe-Dateien

1. Ausgabe-UGRID-CF-NetCDFs (Dateityp cf-netcdf.nc);
2. (optional) Datei mit Informationen zum Programmablauf (Dateityp nccutout.sdr);
3. (optional) Datei mit Testausgaben (Dateityp nccutout.trc).

Methode

Abb.3: Um konsistente Gitter zu erhalten werden Faces jeweils mit all ihren Subfaces herausgeschnitten.

NCCUTOUT verarbeitet NetCDF-Dateien, deren Gitter auf dem Eltern-Kind-Prinzip basieren, bspw. einem Berechnungsgitter mit einer niedrigeren und einem SubGrid mit einer höheren Auflösung. Ob die Daten ausgeschnitten werden oder nicht hängt von der Lage ihrer geometrischen Elemente im gröbsten Gitter ab. Das zeigt sich in Abb. 3. In einem ersten Schritt werden die Faces des Berechnungsgitters und nachfolgend alle SubFaces innerhalb dieser Faces extrahiert. Diese Methode führt zu konsistenten Gittern und Eltern-Kind-Verbindungen.

Betrachtet man den Workflow im Postprocessing, so empfiehlt es sich NCCUTOUT direkt nach den numerischen Modellen wie UNTRIM2007 und UnTRIM2 laufen zu lassen, so dass das komplette Postprocessing von der Reduktion profitiert.

Ein Leitfaden zur Erfassung der DMQS-Metadaten steht hier.

Performance: Ein Großteil der in NCCUTOUT verbrauchten CPU-Zeit entfällt auf Basis-IO-Methoden. Weil das Schreiben in den untersuchten Testläufen deutlich langsamer als das Lesen ist, beschleunigen sowohl die Reduktion der Flächen als auch der geophysikalischen Variablen das Programm.

Vorlauf-Programme

NCANALYSE, NCCHUNKIE, NCDELTA, NCDVAR, NCMERGE, UNTRIM2007, UNTRIM2

Nachlauf-Programme

DAVIT, NCAGGREGATE, NCANALYSE, NCAUTO, NCCHUNKIE, NCDELTA, NCDVAR, NCMERGE, NCPLOT, NC2TABLE and MATLAB

Weitere Informationen

Programmiersprache

Fortran95

zusätzliche Software

---

Originalversion

P. Schade, G. Lang

Programmpflege

P. Schade

Dokumentation/Literatur

• Musterdateien:
  • allgemeine Musterdateien stehen in $PROGHOME/examples/nccutout
  • Testverzeichnis für hydro-dynamische UNTRIM2007-Ergebnisse: $PROGHOME/examples/nccutout/run/utr2007/elbe/nccut
  • Testverzeichnis für hydro-dynamische UNTRIM2-Ergebnisse: $PROGHOME/examples/nccutout/run/utr2009/easy/nccut
  • Testverzeichnis für NCANALYSE-Ergebnisse: $PROGHOME/examples/nccutout/run/ncana/easy/nccut

---

zurück zu Programmkennblätter

---

Strukturübersicht