Functions Parser GenericParser NetCDFParser

NetCDFParser

Der NetCDFParser dient zum Import von NetCDF‑Dateien mit eindimensionalen Zeitreihen.
Er unterstützt konfigurierbare Variablenlisten, Zeitfilter, optionale Zeitüberschreibung sowie Bereichsfilter für Daten‑ und Dimensionsvariablen.

---

Funktionen

• Record‑basierter Import
  Für jeden Zeitindex (Record) wird ein vollständiger Datensatz erzeugt.

• Vollständiges Preloading der Datenvariablen
  Beschleunigt den Import und reduziert I/O‑Zugriffe.

• Unterstützung von 1D‑Zeitreihen
  Beispiele:

  • time + Messwert
  • time + statische Metadaten
  • time + lat/lon (falls 1D)

• Bereichsfilter (min/max) für Datenvariablen
  .min und .max bestimmen automatisch die passenden Indexbereiche.

• Bereichsfilter für Dimensionsvariablen (eingeschränkt)
  Funktioniert, wenn Dimension und Variable denselben Namen tragen.

• Overwrite‑Time
  Zeitstempel können über die Konfiguration überschrieben werden.

• Warnungen bei ignorierten Parametern
  Einmalige Hinweise bei:

  • Ranges für Variablen ohne Record‑Dimension
  • Ranges ohne .min oder .max
  • Ranges für mehrdimensionale Variablen
  • Ranges für Variablen, die nicht importiert werden

---

Import‑Konfiguration

Parameter	Bedeutung	Standard	Optional
netcdf.sourceColumns	Liste der zu importierenden Variablen	–	nein
netcdf.targetColumns	Zielspaltennamen (Mapping)	= sourceColumns	ja
netcdf.section..min	Mindestwert für Datenvariable	–	ja
netcdf.section..max	Maximalwert für Datenvariable	–	ja
netcdf.section..min	Mindestwert für Dimensionsvariable (nur 1D)	–	ja
netcdf.section..max	Maximalwert für Dimensionsvariable (nur 1D)	–	ja
netcdf.overwrite.time	Zeitstempel überschreiben	–	ja
netcdf.startIndex	Startindex für den Import	0	ja
netcdf.maxRecords	Maximale Anzahl zu importierender Records	alle	ja

---

Beispiel‑Konfiguration

{
  "importer": "FilesImporter",
  "parser": "NetCDFParser",
  "sourcedir": "/files",
  "server": "http://localhost:8080",
  "smartdata": "SmartDataTest",
  "storage": "smartmonitoring",
  "collection": "importtable",

  "netcdf.section.lon.min": 5.866944,
  "netcdf.section.lon.max": 15.041667,
  "netcdf.section.lat.min": 47.271667,
  "netcdf.section.lat.max": 55.058611,

  "netcdf.sourceColumns": "LAI",
  "netcdf.overwrite.time": "2023-04-30T00:00:00",

  "geo.transform": true,
  "geo.latAttr": "lat",
  "geo.lonAttr": "lon",
  "geo.dbattr": "pos"
}