Glossar
MUDAB-Fachbegriffe, so wie die CLI sie bereitstellt. Die Bezeichnungen in den Daten sind deutsch; übernehmen Sie sie unverändert.
| Begriff | In der CLI | Bedeutung |
|---|---|---|
| MUDAB | – | Meeresumweltdatenbank: qualitätsgesicherte Daten des Meeresmonitorings der Küstenländer und Forschungseinrichtungen, bereitgestellt von der Bundesanstalt für Gewässerkunde (BfG) und veröffentlicht vom Umweltbundesamt (UBA). |
| Messstation | stations |
Ein physischer Messort, an dem Proben genommen werden. Felder: STATNAME_ST (Name), STATIONTYPE_ST (Typ), COMPT_DS (Kompartiment), NAME_PS (zugehörige Projektstation). |
| Projektstation | project-stations |
Das Monitoringprojekt bzw. -programm, zu dem eine Station gehört. Felder: NAME_PS, REGION (Nordsee/Ostsee), INSTITUT (z. B. BSH). |
| Parameter | parameters |
Eine Messgröße – ein Schadstoff, ein Nährstoff oder eine biologische/physikalische Kenngröße. Felder: PARAMETER (Kürzel), PARAM_NAME (Name), PARAMETERGRUPPE/PARAMGROUP_NAME (Gruppe), COMPT_DS. |
Kompartiment (COMPT_DS) |
compartments |
Das Umweltmedium, zu dem ein Wert gehört. Bekannte Codes: CW = Wasser, CS = Sediment, CF = Biota, BL = Biologie; die Bibliothek exportiert sie mit Bezeichnungen und parameters()-Endpunkten als COMPARTMENT_CODES. Nicht abschließend – z. B. kommt auch MM vor. |
| Messwert | measurements |
Ein einzelner Wert an einer Station: STATNAME_ST, PARAMCODE_PM, DATE_STM (YYYYMMDD), TIME_STM (HHMM), VALUE_MS (der Wert, eine Zahl). Die größte Tabelle (ca. 187.000 Zeilen, ca. 42 MB am 15.09.2026). |
| HELCOM PLC | plc-* |
Die Pollution Load Compilation der HELCOM – die regelmäßige Bewertung der über Gewässer eingetragenen Nährstoff- und Schadstoff-Frachten in die Ostsee. Die Daten hier decken deutsche Ostsee-Einzugsgebiete ab (LAND_CD MV/SH) und enthalten überwachte Flussfrachten, kommunale Punktquellen, Abflüsse und Frachten aus nicht überwachten Gebieten (siehe MON_TYPE). |
| PLC-Station | plc-stations |
Ein Messpunkt für Frachten: STATION_NAME, STATION_CODE, LAND_CD (Bundesland oder UNMON/XX), ST_LAT/ST_LON, MON_TYPE: MON_RIVER_LOAD (überwachter Fluss), MUNCP_FL_LD (kommunale Kläranlage), STAT_FL_CONC (Abflusspegel) oder UNMONITORED (Pseudostation für nicht überwachte Gebiete, Koordinaten 0/0). |
| PLC-Messwert | plc-measurements |
Ein jährlicher Fracht- oder Abflusswert: NAME (Parameter, z. B. Ptot, FLOW), VALUE (eine Zahl, manchmal null), VAL_UNIT, PERIOD_NAME (Jahr), MON_TYPE, LAND_CD, Koordinaten. |
Bereich (from/count) |
--from/--count/--all |
Die einzige Paginierung bzw. Auswahl, die der Server berücksichtigt. Der Server braucht from, sobald ein Bereich gesendet wird (ein Bereich nur mit count ergibt HTTP 500), deshalb wird ein fehlendes from als 0 gesendet. Standardwert für count ist 100 (DEFAULT_PAGE_SIZE), in CLI und Bibliothek gleichermaßen: Ein Listenaufruf ohne Bereich erhält from 0 und count 100, nur --all (Bibliothek: { all: true }) lädt die ganze Tabelle. from + count darf 2147483647 (2³¹−1) nicht überschreiten – ein größeres Bereichsende lehnt der Server mit HTTP 403 ab, deshalb weisen CLI und Client es vorher zurück. |
| Filter / OrderBy | (nicht verfügbar) | In der OpenAPI-Spezifikation vorhanden, aber vom Live-Server ignoriert – siehe DEVELOPING.md. Filtern und sortieren Sie clientseitig (z. B. mit jq). |
| Log-Eintrag (log record) | stderr, --log-format |
Jede Diagnosezeile, die die CLI nach stderr schreibt: ein Zeitstempel, eine Stufe (ERROR, WARN, INFO) und ein Thema mudab.<Bereich>, als Text (im Stil von log4j) oder mit --log-format jsonl als ein JSON-Objekt pro Zeile. Die Bereiche: cli (Bedienfehler, Meldungen von commander, unerwartete Fehler), api (die Antworten der API: ein Fehlerstatus, eine Fehlerliste mit Status 200, eine fehlerhafte Antwort – ungültiges JSON, die falsche Form, ein leerer Inhalt, mehr Zeilen als angefragt –, der Hinweis zu einer Weiterleitung), http (die Verbindung, der Hinweis zur Größengrenze, die Klartext-Warnung und je Wiederholung eine WARN-Zeile vor dem Warten) und output (ein Schreibfehler auf stdout). Ein Eintrag ist immer eine Zeile; Steuerzeichen darin werden maskiert. |
Einen Wert lesen
- Die Einheiten unterscheiden sich je Parameter. Bei PLC-Messwerten steht die Einheit in
VAL_UNIT; bei Stationsmesswerten sind Einheit und Methode inPARAMETERID_PMcodiert. VALUE_MS(Station) undVALUE(PLC) sind Zahlen. Eine Umwandlung ist nicht nötig;VALUEkannnullsein, entfernen Sienull-Werte daher vor Berechnungen.- Datumsangaben sind Strings ohne Trennzeichen –
DATE_STM=YYYYMMDD,TIME_STM=HHMM.