TALSIM Docs - Benutzerbeiträge [de]

Hauptseite

2022-09-16T20:10:57Z

HubertLohr:

<languages/>
<translate>

[[Datei:TalsimStart2.png|zentriert]]


<hr/>
Talsim-NG ist ein hybrides hydrologisch/hydraulisches Flussgebietsmodell. Es ist konzipiert, um von Hochwasser bis Dürreperioden alle hydrologischen Fragestellungen abzubilden. Die Software ist modular und skalierbar aufgebaut, d.h. ein wasserwirtschaftliches System kann passend zur Aufgabenstellung konfiguriert werden. Dabei ist die räumliche Auflösung frei wählbar und unbegrenzt. Die Simulation Zeitschritt kann zwischen einer Minute bis einem Monat frei gesetzt werden. Talsim-NG wurde eingesetzt für kleine Einzugsgebiete < 10 km² bis zu Flussgebieten > 3,000,000 km² (z.B. gesamtes Nileinzugsgebiet). <br><br>


Die wesentlichen Bausteine von Talsim-NG sind: <br>
- Niederschlag-Abfluss Simulation, inklusive Schneesimulation / - Flood routing und hydraulische Modellierung von Bauwerken / - Komplexer Atmosphären-Vegetation-Boden Baustein / - Frei konfigurierbares Regeln und Steuern sowie Speicherbewirtschaftung / - Konzeptionelles Grundwassermodel / - Nested modelling (hochaufgelöste Modelle integriert in großen aber groben Modellen) / - Feuchtgebietsmodellierung / - Pflanzenwasserbedarfsberechung und Bewässserung / - Wassertemperatur und Wasserqualität / - Zeitreihenverwaltung / - Projekt und Szenarienverwaltung / - Client-Server Architektur.


Dieses Wiki enthält die offizielle Dokumentation von Talsim-NG.


<div class="info">Dieses Wiki wird ständig gepflegt und erweitert.</div>


__TOC__

==Einführung== 


*[[Media:TalsimNG brochure en.pdf|Talsim-NG Broschüre (PDF, Englisch)]]
*[[Special:MyLanguage/Einsatzmöglichkeiten von Talsim-NG|Einsatzmöglichkeiten von Talsim-NG]]
*[[Media:TalsimIntroductoryExample.pdf|Einführungstutorial (PDF, Englisch)]]
*[[Media:OperationRulesInTalsimNG.pdf|Betriebsregeln in Talsim-NG (PDF, Englisch)]]
*[[Media:TalsimNGTimeSteps.pdf|Ablauf der Zeitschrittberechnung (PDF, Englisch)]]
*[[Special:MyLanguage/Video Tutorials|Video Tutorials]]

==Theoretische Grundlagen== 


Im folgenden Kapitel finden sich ausführliche Informationen zu den theoretischen Grundlagen von Talsim:
*[[Special:MyLanguage/Flussgebietsmodell|Flussgebietsmodell]]
*[[Special:MyLanguage/Modellkonzept|Modellkonzept]]
*[[Special:MyLanguage/Beschreibung der Systemelemente|Beschreibung der Systemelemente]]
*[[Special:MyLanguage/Begriffsdefinitionen|Begriffsdefinitionen]]

==Modellerstellung und Anwendung== 


Die wichtigesten Schritte zur Erstellung und Anwendung eines Talsim-NG Flussgebietmodells werden in den folgenden Kapiteln erläutert
*[[Special:MyLanguage/Arbeitsschritte zur Modellerstellung|Arbeitsschritte zur Modellerstellung]]
*[[Special:MyLanguage/Simulation|Simulation]]
*[[Special:MyLanguage/Parameterschätzung und Kalibrierung|Parameterschätzung und Kalibrierung]]
*[[Special:MyLanguage/Optimierung von Betriebsplänen|Optimierung von Betriebsplänen]]
*[[Special:MyLanguage/Arbeiten mit dem TaskSrv|Arbeiten mit dem TaskSrv]]
*[[Special:MyLanguage/Arbeiten mit dem SydroTaskMgr|Arbeiten mit dem SydroTaskMgr]]
*[[Special:MyLanguage/Arbeiten mit dem SydroCmd tool|Arbeiten mit dem SydroCmd tool]]
*[[Special:MyLanguage/Operationeller Einsatz von Talsim-NG|Operationeller Einsatz von Talsim-NG]]

==Grafische Benutzeroberfläche== 


*[[Special:MyLanguage/Anmeldung und Startfenster|Anmeldung und Startfenster]]
*[[Special:MyLanguage/Talsim-NG Hauptfenster|Talsim-NG Hauptfenster]]
*[[Special:MyLanguage/Systemverwaltung|Systemverwaltung]]
*[[Special:MyLanguage/Zeitreihenverwaltung|Zeitreihenverwaltung]]
*[[Special:MyLanguage/Einzelfenster von Modellkomponenten|Einzelfenster von Modellkomponenten]]
*[[Special:MyLanguage/Zustandsgruppenfenster|Zustandsgruppenfenster]]
*[[Special:MyLanguage/Fenster Zielfunktionen|Fenster Zielfunktionen]]
*[[Special:MyLanguage/Fenster Hochwasserwellenstatistik|Fenster Hochwasserwellenstatistik]]
*[[Special:MyLanguage/Fenster Kurzfristprognose|Fenster Kurzfristprognose]]

==Programmstruktur== 


*[[Special:MyLanguage/Konzept Server/Client|Konzept Server/Client]]
** [[Special:MyLanguage/Server-API|Server-API]]
*[[Special:MyLanguage/Softwarekomponenten|Softwarekomponenten]]
*[[Special:MyLanguage/Verzeichnisstruktur|Verzeichnisstruktur]]
*[[Special:MyLanguage/Datenbankstruktur|Datenbankstruktur]]
*[[Special:MyLanguage/Erstellen eines Customers|Erstellen eines Customers]]
*[[Special:MyLanguage/Anlegen eines Benutzers|Anlegen eines Benutzers]]
*[[Schnittstellen: Import/Export|Schnittstellen: Import/Export]]
*[[Special:MyLanguage/Skriptsprachen|Skriptsprachen]]

==Anhang== 


*[[Special:MyLanguage/Talsim-NG Dateiformate|Talsim-NG Dateiformate]]
*[[Special:MyLanguage/Installation der Software|Installation der Software]]
*[[Special:MyLanguage/Einstellung der Regions- und Sprachoptionen|Einstellung der Regions- und Sprachoptionen]]
*[[Special:MyLanguage/Fehlermeldungen|Fehlermeldungen]]
*[[Special:MyLanguage/Beispiele zu Betriebsregeln|Beispiele zu Betriebsregeln]]
*[[Special:MyLanguage/Hochwassermerkmalsimulation|Hochwassermerkmalsimulation]]
*[[Special:MyLanguage/Schnittstellen zu externen Programmen|Schnittstellen zu externen Programmen]]
**[[Special:MyLanguage/FEWS|FEWS]]
**[[Special:MyLanguage/BlueM.Wave|BlueM.Wave]]
**[[Special:MyLanguage/BlueM.Opt|BlueM.Opt]]
</translate>

Hauptseite/en

2022-09-16T20:09:43Z

HubertLohr:

<languages/>
[[Datei:TalsimStart2.png|center]]

<hr/>
Talsim-NG is a hybrid hydrologic/hydraulic river basin model. It is designed to capture all hydrological situations from flood to drought. The software concept is modular and scalable, meaning that a water resources system can be tailored according to the actual needs. Talsim-NG does not imply any limits for the spatial resolution of hydrological systems. The temporal resolution as simulation time step can vary from one minute to one month. Talsim-NG was applied for watersheds < 10 km² up to river basins > 3,000,000 km² (e.g. entire Nile system).

The main features of Talsim-NG are: <br>
- Precipitation-Runoff modelling, including snow simulation / - Flood routing and hydraulic simulation of weirs, diversions, pipes / - Complex atmosphere-vegetation-soil module / - unlimited configuration of operation rules, reservoir operation / - conceptual groundwater model / - Nested modelling (high spatial resolution models are embedded in coarser model environments) / - Wetland modelling / - Crop water requirements and irrigation / - Watertemperature and water quality / - Time series manager / - Project and Scenario manager / - Client-Server Architecture.

This Wiki contains the official documentation of Talsim-NG.

<div class="info">This Wiki is constantly being maintained and expanded. Individual sections are still under construction.</div>

__TOC__

==Introduction==

*[[Media:TalsimNG brochure en.pdf|Talsim-NG brochure (PDF)]]
*[[Special:MyLanguage/Einsatzmöglichkeiten von Talsim-NG|Possible applications of Talsim-NG]]
*[[Media:TalsimIntroductoryExample.pdf|Introductory tutorial (PDF)]]
*[[Media:OperationRulesInTalsimNG.pdf|Operation Rules in Talsim NG (PDF)]]
*[[Media:TalsimNGTimeSteps.pdf|Understanding the Calculation of Time Steps (PDF)]]
*[[Special:MyLanguage/Video Tutorials|Video tutorials]]

==Theoretical basics==

The following chapter contains detailed information about the theoretical basics of Talsim:
*[[Special:MyLanguage/Flussgebietsmodell|River basin model]]
*[[Special:MyLanguage/Modellkonzept|Model concept]]
*[[Special:MyLanguage/Beschreibung der Systemelemente|Description of the system elements]]
*[[Special:MyLanguage/Begriffsdefinitionen|Definitions of terms]]

==Model setup and usage==

The most important steps to setup and use a Talsim-NG river basin model are explained in the following chapters:
*[[Special:MyLanguage/Arbeitsschritte zur Modellerstellung|Steps for setting up a model]]
*[[Special:MyLanguage/Simulation|Simulation]]
*[[Special:MyLanguage/Parameterschätzung und Kalibrierung|Parameter estimation and calibration]]
*[[Special:MyLanguage/Optimierung von Betriebsplänen|Optimization of operating plans]]
*[[Special:MyLanguage/Arbeiten mit dem TaskSrv|Working with TaskSrv]]
*[[Special:MyLanguage/Arbeiten mit dem SydroTaskMgr|Working with SydroTaskMgr]]
*[[Special:MyLanguage/Arbeiten mit dem SydroCmd tool|Working with SydroCmd]]
*[[Special:MyLanguage/Operationeller Einsatz von Talsim-NG|Operational use of Talsim-NG]]

==Graphical user interface==

*[[Special:MyLanguage/Anmeldung und Startfenster|Login and start window]]
*[[Special:MyLanguage/Talsim-NG Hauptfenster|Talsim-NG main window]]
*[[Special:MyLanguage/Projekt Verwaltung|Project manager]]
*[[Special:MyLanguage/Zeitreihenverwaltung|Time series management]]
*[[Special:MyLanguage/Einzelfenster von Modellkomponenten|Individual model component windows]]
*[[Special:MyLanguage/Zustandsgruppenfenster|Control clusters]]
*[[Special:MyLanguage/Zielfunktionen|Objective functions]]
*[[Special:MyLanguage/Hochwasserwellenstatistik|Flood wave statistics]]
*[[Special:MyLanguage/Kurzfristprognose|Short-term forecasts]]

==Software architecture==

*[[Special:MyLanguage/Konzept Server/Client|Server/client concept]]
** [[Special:MyLanguage/Server-API|Server API]]
*[[Special:MyLanguage/Softwarekomponenten|Software components]]
*[[Special:MyLanguage/Verzeichnisstruktur|Directory structure]]
*[[Special:MyLanguage/Datenbankstruktur|Database structure]]
*[[Special:MyLanguage/Erstellen eines Customers|Creating a customer]]
*[[Special:MyLanguage/Anlegen eines Benutzers|Creating a user]]
*[[Schnittstellen: Import/Export|Interfaces: import/export]]
*[[Special:MyLanguage/Skriptsprachen|Scripting languages]]

==Miscellaneous==

<div class="mw-translate-fuzzy">
*[[Special:MyLanguage/Talsim-NG Dateiformate|Talsim-NG file formats]]
*[[Special:MyLanguage/Installation der Software|Software installation]]
*[[Special:MyLanguage/Einstellung der Regions- und Sprachoptionen|Region and language settings]]
*[[Special:MyLanguage/Fehlermeldungen|Error messages]]
*[[Special:MyLanguage/Beispiele zu Betriebsregeln|Examples of operating rules]]
*[[Special:MyLanguage/Hochwassermerkmalsimulation|Simulation of flood characteristics]]
*[[Special:MyLanguage/Schnittstellen zu externen Programmen|Interfaces to external programs]]
**[[Special:MyLanguage/FEWS|FEWS]]
**[[Special:MyLanguage/BlueM.Wave|BlueM.Wave]]
**[[Special:MyLanguage/BlueM.Opt|BlueM.Opt]]
</div>

Translations:Hauptseite/19/en

2022-09-16T20:09:35Z

HubertLohr:

<hr/>
Talsim-NG is a hybrid hydrologic/hydraulic river basin model. It is designed to capture all hydrological situations from flood to drought. The software concept is modular and scalable, meaning that a water resources system can be tailored according to the actual needs. Talsim-NG does not imply any limits for the spatial resolution of hydrological systems. The temporal resolution as simulation time step can vary from one minute to one month. Talsim-NG was applied for watersheds < 10 km² up to river basins > 3,000,000 km² (e.g. entire Nile system).

Hauptseite/en

2022-09-16T19:13:20Z

HubertLohr:

<languages/>
[[Datei:TalsimStart2.png|center]]

<hr/>
Talsim-NG is a hybrid hydrologic/hydraulic river basin model. it is designed to capture all hydrological situations from flood to drought. The software concept is modulare and scalable, meaning that a water resources system can be tailored according to the actual needs. The spatial resolution has no limits. The temporal resolution as simulation time step can vary from one minute to one month. Talsim-NG was applied for watersheds < 10 km² up to river basins > 3,000,000 km² (e.g. entire Nile system).

The main features of Talsim-NG are: <br>
- Precipitation-Runoff modelling, including snow simulation / - Flood routing and hydraulic simulation of weirs, diversions, pipes / - Complex atmosphere-vegetation-soil module / - unlimited configuration of operation rules, reservoir operation / - conceptual groundwater model / - Nested modelling (high spatial resolution models are embedded in coarser model environments) / - Wetland modelling / - Crop water requirements and irrigation / - Watertemperature and water quality / - Time series manager / - Project and Scenario manager / - Client-Server Architecture.

This Wiki contains the official documentation of Talsim-NG.

<div class="info">This Wiki is constantly being maintained and expanded. Individual sections are still under construction.</div>

__TOC__

==Introduction==

*[[Media:TalsimNG brochure en.pdf|Talsim-NG brochure (PDF)]]
*[[Special:MyLanguage/Einsatzmöglichkeiten von Talsim-NG|Possible applications of Talsim-NG]]
*[[Media:TalsimIntroductoryExample.pdf|Introductory tutorial (PDF)]]
*[[Media:OperationRulesInTalsimNG.pdf|Operation Rules in Talsim NG (PDF)]]
*[[Media:TalsimNGTimeSteps.pdf|Understanding the Calculation of Time Steps (PDF)]]
*[[Special:MyLanguage/Video Tutorials|Video tutorials]]

==Theoretical basics==

The following chapter contains detailed information about the theoretical basics of Talsim:
*[[Special:MyLanguage/Flussgebietsmodell|River basin model]]
*[[Special:MyLanguage/Modellkonzept|Model concept]]
*[[Special:MyLanguage/Beschreibung der Systemelemente|Description of the system elements]]
*[[Special:MyLanguage/Begriffsdefinitionen|Definitions of terms]]

==Model setup and usage==

The most important steps to setup and use a Talsim-NG river basin model are explained in the following chapters:
*[[Special:MyLanguage/Arbeitsschritte zur Modellerstellung|Steps for setting up a model]]
*[[Special:MyLanguage/Simulation|Simulation]]
*[[Special:MyLanguage/Parameterschätzung und Kalibrierung|Parameter estimation and calibration]]
*[[Special:MyLanguage/Optimierung von Betriebsplänen|Optimization of operating plans]]
*[[Special:MyLanguage/Arbeiten mit dem TaskSrv|Working with TaskSrv]]
*[[Special:MyLanguage/Arbeiten mit dem SydroTaskMgr|Working with SydroTaskMgr]]
*[[Special:MyLanguage/Arbeiten mit dem SydroCmd tool|Working with SydroCmd]]
*[[Special:MyLanguage/Operationeller Einsatz von Talsim-NG|Operational use of Talsim-NG]]

==Graphical user interface==

*[[Special:MyLanguage/Anmeldung und Startfenster|Login and start window]]
*[[Special:MyLanguage/Talsim-NG Hauptfenster|Talsim-NG main window]]
*[[Special:MyLanguage/Projekt Verwaltung|Project manager]]
*[[Special:MyLanguage/Zeitreihenverwaltung|Time series management]]
*[[Special:MyLanguage/Einzelfenster von Modellkomponenten|Individual model component windows]]
*[[Special:MyLanguage/Zustandsgruppenfenster|Control clusters]]
*[[Special:MyLanguage/Zielfunktionen|Objective functions]]
*[[Special:MyLanguage/Hochwasserwellenstatistik|Flood wave statistics]]
*[[Special:MyLanguage/Kurzfristprognose|Short-term forecasts]]

==Software architecture==

*[[Special:MyLanguage/Konzept Server/Client|Server/client concept]]
** [[Special:MyLanguage/Server-API|Server API]]
*[[Special:MyLanguage/Softwarekomponenten|Software components]]
*[[Special:MyLanguage/Verzeichnisstruktur|Directory structure]]
*[[Special:MyLanguage/Datenbankstruktur|Database structure]]
*[[Special:MyLanguage/Erstellen eines Customers|Creating a customer]]
*[[Special:MyLanguage/Anlegen eines Benutzers|Creating a user]]
*[[Schnittstellen: Import/Export|Interfaces: import/export]]
*[[Special:MyLanguage/Skriptsprachen|Scripting languages]]

==Miscellaneous==

<div class="mw-translate-fuzzy">
*[[Special:MyLanguage/Talsim-NG Dateiformate|Talsim-NG file formats]]
*[[Special:MyLanguage/Installation der Software|Software installation]]
*[[Special:MyLanguage/Einstellung der Regions- und Sprachoptionen|Region and language settings]]
*[[Special:MyLanguage/Fehlermeldungen|Error messages]]
*[[Special:MyLanguage/Beispiele zu Betriebsregeln|Examples of operating rules]]
*[[Special:MyLanguage/Hochwassermerkmalsimulation|Simulation of flood characteristics]]
*[[Special:MyLanguage/Schnittstellen zu externen Programmen|Interfaces to external programs]]
**[[Special:MyLanguage/FEWS|FEWS]]
**[[Special:MyLanguage/BlueM.Wave|BlueM.Wave]]
**[[Special:MyLanguage/BlueM.Opt|BlueM.Opt]]
</div>

Translations:Hauptseite/20/en

2022-09-16T19:13:11Z

HubertLohr:

The main features of Talsim-NG are: <br>
- Precipitation-Runoff modelling, including snow simulation / - Flood routing and hydraulic simulation of weirs, diversions, pipes / - Complex atmosphere-vegetation-soil module / - unlimited configuration of operation rules, reservoir operation / - conceptual groundwater model / - Nested modelling (high spatial resolution models are embedded in coarser model environments) / - Wetland modelling / - Crop water requirements and irrigation / - Watertemperature and water quality / - Time series manager / - Project and Scenario manager / - Client-Server Architecture.

Hauptseite/en

2022-09-16T19:06:47Z

HubertLohr:

<languages/>
[[Datei:TalsimStart2.png|center]]

<hr/>
Talsim-NG is a hybrid hydrologic/hydraulic river basin model. it is designed to capture all hydrological situations from flood to drought. The software concept is modulare and scalable, meaning that a water resources system can be tailored according to the actual needs. The spatial resolution has no limits. The temporal resolution as simulation time step can vary from one minute to one month. Talsim-NG was applied for watersheds < 10 km² up to river basins > 3,000,000 km² (e.g. entire Nile system).

Talsim-NG is based on an open, generic model architecture. With the available components, the user is able to simulate any water management system and management strategies.

This Wiki contains the official documentation of Talsim-NG.

<div class="info">This Wiki is constantly being maintained and expanded. Individual sections are still under construction.</div>

__TOC__

==Introduction==

*[[Media:TalsimNG brochure en.pdf|Talsim-NG brochure (PDF)]]
*[[Special:MyLanguage/Einsatzmöglichkeiten von Talsim-NG|Possible applications of Talsim-NG]]
*[[Media:TalsimIntroductoryExample.pdf|Introductory tutorial (PDF)]]
*[[Media:OperationRulesInTalsimNG.pdf|Operation Rules in Talsim NG (PDF)]]
*[[Media:TalsimNGTimeSteps.pdf|Understanding the Calculation of Time Steps (PDF)]]
*[[Special:MyLanguage/Video Tutorials|Video tutorials]]

==Theoretical basics==

The following chapter contains detailed information about the theoretical basics of Talsim:
*[[Special:MyLanguage/Flussgebietsmodell|River basin model]]
*[[Special:MyLanguage/Modellkonzept|Model concept]]
*[[Special:MyLanguage/Beschreibung der Systemelemente|Description of the system elements]]
*[[Special:MyLanguage/Begriffsdefinitionen|Definitions of terms]]

==Model setup and usage==

The most important steps to setup and use a Talsim-NG river basin model are explained in the following chapters:
*[[Special:MyLanguage/Arbeitsschritte zur Modellerstellung|Steps for setting up a model]]
*[[Special:MyLanguage/Simulation|Simulation]]
*[[Special:MyLanguage/Parameterschätzung und Kalibrierung|Parameter estimation and calibration]]
*[[Special:MyLanguage/Optimierung von Betriebsplänen|Optimization of operating plans]]
*[[Special:MyLanguage/Arbeiten mit dem TaskSrv|Working with TaskSrv]]
*[[Special:MyLanguage/Arbeiten mit dem SydroTaskMgr|Working with SydroTaskMgr]]
*[[Special:MyLanguage/Arbeiten mit dem SydroCmd tool|Working with SydroCmd]]
*[[Special:MyLanguage/Operationeller Einsatz von Talsim-NG|Operational use of Talsim-NG]]

==Graphical user interface==

*[[Special:MyLanguage/Anmeldung und Startfenster|Login and start window]]
*[[Special:MyLanguage/Talsim-NG Hauptfenster|Talsim-NG main window]]
*[[Special:MyLanguage/Projekt Verwaltung|Project manager]]
*[[Special:MyLanguage/Zeitreihenverwaltung|Time series management]]
*[[Special:MyLanguage/Einzelfenster von Modellkomponenten|Individual model component windows]]
*[[Special:MyLanguage/Zustandsgruppenfenster|Control clusters]]
*[[Special:MyLanguage/Zielfunktionen|Objective functions]]
*[[Special:MyLanguage/Hochwasserwellenstatistik|Flood wave statistics]]
*[[Special:MyLanguage/Kurzfristprognose|Short-term forecasts]]

==Software architecture==

*[[Special:MyLanguage/Konzept Server/Client|Server/client concept]]
** [[Special:MyLanguage/Server-API|Server API]]
*[[Special:MyLanguage/Softwarekomponenten|Software components]]
*[[Special:MyLanguage/Verzeichnisstruktur|Directory structure]]
*[[Special:MyLanguage/Datenbankstruktur|Database structure]]
*[[Special:MyLanguage/Erstellen eines Customers|Creating a customer]]
*[[Special:MyLanguage/Anlegen eines Benutzers|Creating a user]]
*[[Schnittstellen: Import/Export|Interfaces: import/export]]
*[[Special:MyLanguage/Skriptsprachen|Scripting languages]]

==Miscellaneous==

<div class="mw-translate-fuzzy">
*[[Special:MyLanguage/Talsim-NG Dateiformate|Talsim-NG file formats]]
*[[Special:MyLanguage/Installation der Software|Software installation]]
*[[Special:MyLanguage/Einstellung der Regions- und Sprachoptionen|Region and language settings]]
*[[Special:MyLanguage/Fehlermeldungen|Error messages]]
*[[Special:MyLanguage/Beispiele zu Betriebsregeln|Examples of operating rules]]
*[[Special:MyLanguage/Hochwassermerkmalsimulation|Simulation of flood characteristics]]
*[[Special:MyLanguage/Schnittstellen zu externen Programmen|Interfaces to external programs]]
**[[Special:MyLanguage/FEWS|FEWS]]
**[[Special:MyLanguage/BlueM.Wave|BlueM.Wave]]
**[[Special:MyLanguage/BlueM.Opt|BlueM.Opt]]
</div>

Translations:Hauptseite/18/en

2022-09-16T19:05:14Z

HubertLohr:

[[Datei:TalsimStart2.png|center]]

Hauptseite/en

2022-09-16T19:04:03Z

HubertLohr:

<languages/>
[[Datei:TALSIM-NG splashscreen.jpg|center]]

<hr/>
Talsim-NG is a hybrid hydrologic/hydraulic river basin model. it is designed to capture all hydrological situations from flood to drought. The software concept is modulare and scalable, meaning that a water resources system can be tailored according to the actual needs. The spatial resolution has no limits. The temporal resolution as simulation time step can vary from one minute to one month. Talsim-NG was applied for watersheds < 10 km² up to river basins > 3,000,000 km² (e.g. entire Nile system).

Talsim-NG is based on an open, generic model architecture. With the available components, the user is able to simulate any water management system and management strategies.

This Wiki contains the official documentation of Talsim-NG.

<div class="info">This Wiki is constantly being maintained and expanded. Individual sections are still under construction.</div>

__TOC__

==Introduction==

*[[Media:TalsimNG brochure en.pdf|Talsim-NG brochure (PDF)]]
*[[Special:MyLanguage/Einsatzmöglichkeiten von Talsim-NG|Possible applications of Talsim-NG]]
*[[Media:TalsimIntroductoryExample.pdf|Introductory tutorial (PDF)]]
*[[Media:OperationRulesInTalsimNG.pdf|Operation Rules in Talsim NG (PDF)]]
*[[Media:TalsimNGTimeSteps.pdf|Understanding the Calculation of Time Steps (PDF)]]
*[[Special:MyLanguage/Video Tutorials|Video tutorials]]

==Theoretical basics==

The following chapter contains detailed information about the theoretical basics of Talsim:
*[[Special:MyLanguage/Flussgebietsmodell|River basin model]]
*[[Special:MyLanguage/Modellkonzept|Model concept]]
*[[Special:MyLanguage/Beschreibung der Systemelemente|Description of the system elements]]
*[[Special:MyLanguage/Begriffsdefinitionen|Definitions of terms]]

==Model setup and usage==

The most important steps to setup and use a Talsim-NG river basin model are explained in the following chapters:
*[[Special:MyLanguage/Arbeitsschritte zur Modellerstellung|Steps for setting up a model]]
*[[Special:MyLanguage/Simulation|Simulation]]
*[[Special:MyLanguage/Parameterschätzung und Kalibrierung|Parameter estimation and calibration]]
*[[Special:MyLanguage/Optimierung von Betriebsplänen|Optimization of operating plans]]
*[[Special:MyLanguage/Arbeiten mit dem TaskSrv|Working with TaskSrv]]
*[[Special:MyLanguage/Arbeiten mit dem SydroTaskMgr|Working with SydroTaskMgr]]
*[[Special:MyLanguage/Arbeiten mit dem SydroCmd tool|Working with SydroCmd]]
*[[Special:MyLanguage/Operationeller Einsatz von Talsim-NG|Operational use of Talsim-NG]]

==Graphical user interface==

*[[Special:MyLanguage/Anmeldung und Startfenster|Login and start window]]
*[[Special:MyLanguage/Talsim-NG Hauptfenster|Talsim-NG main window]]
*[[Special:MyLanguage/Projekt Verwaltung|Project manager]]
*[[Special:MyLanguage/Zeitreihenverwaltung|Time series management]]
*[[Special:MyLanguage/Einzelfenster von Modellkomponenten|Individual model component windows]]
*[[Special:MyLanguage/Zustandsgruppenfenster|Control clusters]]
*[[Special:MyLanguage/Zielfunktionen|Objective functions]]
*[[Special:MyLanguage/Hochwasserwellenstatistik|Flood wave statistics]]
*[[Special:MyLanguage/Kurzfristprognose|Short-term forecasts]]

==Software architecture==

*[[Special:MyLanguage/Konzept Server/Client|Server/client concept]]
** [[Special:MyLanguage/Server-API|Server API]]
*[[Special:MyLanguage/Softwarekomponenten|Software components]]
*[[Special:MyLanguage/Verzeichnisstruktur|Directory structure]]
*[[Special:MyLanguage/Datenbankstruktur|Database structure]]
*[[Special:MyLanguage/Erstellen eines Customers|Creating a customer]]
*[[Special:MyLanguage/Anlegen eines Benutzers|Creating a user]]
*[[Schnittstellen: Import/Export|Interfaces: import/export]]
*[[Special:MyLanguage/Skriptsprachen|Scripting languages]]

==Miscellaneous==

<div class="mw-translate-fuzzy">
*[[Special:MyLanguage/Talsim-NG Dateiformate|Talsim-NG file formats]]
*[[Special:MyLanguage/Installation der Software|Software installation]]
*[[Special:MyLanguage/Einstellung der Regions- und Sprachoptionen|Region and language settings]]
*[[Special:MyLanguage/Fehlermeldungen|Error messages]]
*[[Special:MyLanguage/Beispiele zu Betriebsregeln|Examples of operating rules]]
*[[Special:MyLanguage/Hochwassermerkmalsimulation|Simulation of flood characteristics]]
*[[Special:MyLanguage/Schnittstellen zu externen Programmen|Interfaces to external programs]]
**[[Special:MyLanguage/FEWS|FEWS]]
**[[Special:MyLanguage/BlueM.Wave|BlueM.Wave]]
**[[Special:MyLanguage/BlueM.Opt|BlueM.Opt]]
</div>

Translations:Hauptseite/19/en

2022-09-16T19:03:41Z

HubertLohr:

<hr/>
Talsim-NG is a hybrid hydrologic/hydraulic river basin model. it is designed to capture all hydrological situations from flood to drought. The software concept is modulare and scalable, meaning that a water resources system can be tailored according to the actual needs. The spatial resolution has no limits. The temporal resolution as simulation time step can vary from one minute to one month. Talsim-NG was applied for watersheds < 10 km² up to river basins > 3,000,000 km² (e.g. entire Nile system).

Hauptseite

2022-09-16T18:57:48Z

HubertLohr:

<languages/>
<translate>

[[Datei:TalsimStart2.png|zentriert]]


<hr/>
Talsim-NG ist ein hybrides hydrologisch/hydraulisches Flussgebietsmodell. Es ist konzipiert, um von Hochwasser bis Dürreperioden alle hydrologischen Fragestellungen abzubilden. Die Software ist modular und skalierbar aufgebaut, d.h. ein wasserwirtschaftliches System kann passend zurr Aufgabenstellung konfiguriert werden. Dabei ist räumliche Auflösung frei wählbar und unbegrenzt. Die zeitliche Auflösung einer Simulation kann zwischen einer Minute bis einem Monat frei gesetzt werden. Talsim-NG wurde eingesetzt für Gebiete > 10 km² bis zu Flussgebieten > 3,000,000 km² (z.B. gesamtes Nileinzugsgebiet). <br><br>


Die wesentlichen Bausteine von Talsim-NG sind: <br>
- Niederschlag-Abfluss Simulation, inklusive Schneesimulation / - Flood routing und hydraulische Modellierung von Bauwerken / - Komplexer Atmosphären-Vegetation-Boden Baustein / - Frei konfigurierbares Regeln und Steuern sowie Speicherbewirtschaftung / - Konzeptionelles Grundwassermodel / - Nested modelling (hochaufgelöste Modelle integriert in großen aber groben Modellen) / - Feuchtgebietsmodellierung / - Pflanzenwasserbedarfsberechung und Bewässserung / - Wassertemperatur und Wasserqualität / - Zeitreihenverwaltung / - Projekt und Szenarienverwaltung / - Client-Server Architektur.


Dieses Wiki enthält die offizielle Dokumentation von Talsim-NG.


<div class="info">Dieses Wiki wird ständig gepflegt und erweitert.</div>


__TOC__

==Einführung== 


*[[Media:TalsimNG brochure en.pdf|Talsim-NG Broschüre (PDF, Englisch)]]
*[[Special:MyLanguage/Einsatzmöglichkeiten von Talsim-NG|Einsatzmöglichkeiten von Talsim-NG]]
*[[Media:TalsimIntroductoryExample.pdf|Einführungstutorial (PDF, Englisch)]]
*[[Media:OperationRulesInTalsimNG.pdf|Betriebsregeln in Talsim-NG (PDF, Englisch)]]
*[[Media:TalsimNGTimeSteps.pdf|Ablauf der Zeitschrittberechnung (PDF, Englisch)]]
*[[Special:MyLanguage/Video Tutorials|Video Tutorials]]

==Theoretische Grundlagen== 


Im folgenden Kapitel finden sich ausführliche Informationen zu den theoretischen Grundlagen von Talsim:
*[[Special:MyLanguage/Flussgebietsmodell|Flussgebietsmodell]]
*[[Special:MyLanguage/Modellkonzept|Modellkonzept]]
*[[Special:MyLanguage/Beschreibung der Systemelemente|Beschreibung der Systemelemente]]
*[[Special:MyLanguage/Begriffsdefinitionen|Begriffsdefinitionen]]

==Modellerstellung und Anwendung== 


Die wichtigesten Schritte zur Erstellung und Anwendung eines Talsim-NG Flussgebietmodells werden in den folgenden Kapiteln erläutert
*[[Special:MyLanguage/Arbeitsschritte zur Modellerstellung|Arbeitsschritte zur Modellerstellung]]
*[[Special:MyLanguage/Simulation|Simulation]]
*[[Special:MyLanguage/Parameterschätzung und Kalibrierung|Parameterschätzung und Kalibrierung]]
*[[Special:MyLanguage/Optimierung von Betriebsplänen|Optimierung von Betriebsplänen]]
*[[Special:MyLanguage/Arbeiten mit dem TaskSrv|Arbeiten mit dem TaskSrv]]
*[[Special:MyLanguage/Arbeiten mit dem SydroTaskMgr|Arbeiten mit dem SydroTaskMgr]]
*[[Special:MyLanguage/Arbeiten mit dem SydroCmd tool|Arbeiten mit dem SydroCmd tool]]
*[[Special:MyLanguage/Operationeller Einsatz von Talsim-NG|Operationeller Einsatz von Talsim-NG]]

==Grafische Benutzeroberfläche== 


*[[Special:MyLanguage/Anmeldung und Startfenster|Anmeldung und Startfenster]]
*[[Special:MyLanguage/Talsim-NG Hauptfenster|Talsim-NG Hauptfenster]]
*[[Special:MyLanguage/Systemverwaltung|Systemverwaltung]]
*[[Special:MyLanguage/Zeitreihenverwaltung|Zeitreihenverwaltung]]
*[[Special:MyLanguage/Einzelfenster von Modellkomponenten|Einzelfenster von Modellkomponenten]]
*[[Special:MyLanguage/Zustandsgruppenfenster|Zustandsgruppenfenster]]
*[[Special:MyLanguage/Fenster Zielfunktionen|Fenster Zielfunktionen]]
*[[Special:MyLanguage/Fenster Hochwasserwellenstatistik|Fenster Hochwasserwellenstatistik]]
*[[Special:MyLanguage/Fenster Kurzfristprognose|Fenster Kurzfristprognose]]

==Programmstruktur== 


*[[Special:MyLanguage/Konzept Server/Client|Konzept Server/Client]]
** [[Special:MyLanguage/Server-API|Server-API]]
*[[Special:MyLanguage/Softwarekomponenten|Softwarekomponenten]]
*[[Special:MyLanguage/Verzeichnisstruktur|Verzeichnisstruktur]]
*[[Special:MyLanguage/Datenbankstruktur|Datenbankstruktur]]
*[[Special:MyLanguage/Erstellen eines Customers|Erstellen eines Customers]]
*[[Special:MyLanguage/Anlegen eines Benutzers|Anlegen eines Benutzers]]
*[[Schnittstellen: Import/Export|Schnittstellen: Import/Export]]
*[[Special:MyLanguage/Skriptsprachen|Skriptsprachen]]

==Anhang== 


*[[Special:MyLanguage/Talsim-NG Dateiformate|Talsim-NG Dateiformate]]
*[[Special:MyLanguage/Installation der Software|Installation der Software]]
*[[Special:MyLanguage/Einstellung der Regions- und Sprachoptionen|Einstellung der Regions- und Sprachoptionen]]
*[[Special:MyLanguage/Fehlermeldungen|Fehlermeldungen]]
*[[Special:MyLanguage/Beispiele zu Betriebsregeln|Beispiele zu Betriebsregeln]]
*[[Special:MyLanguage/Hochwassermerkmalsimulation|Hochwassermerkmalsimulation]]
*[[Special:MyLanguage/Schnittstellen zu externen Programmen|Schnittstellen zu externen Programmen]]
**[[Special:MyLanguage/FEWS|FEWS]]
**[[Special:MyLanguage/BlueM.Wave|BlueM.Wave]]
**[[Special:MyLanguage/BlueM.Opt|BlueM.Opt]]
</translate>

Hauptseite

2022-09-16T18:38:14Z

HubertLohr:

<languages/>
<translate>

[[Datei:TALSIM-NG splashscreen.jpg|zentriert]][[Datei:TalsimNG_Applications.png|zentriert]]


<hr/>
Talsim-NG ist ein hybrides hydrologisch/hydraulisches Flussgebietsmodell. Es ist konzipiert, um von Hochwasser bis Dürreperioden alle hydrologischen Fragestellungen abzubilden. Die Software ist modular und skalierbar aufgebaut, d.h. ein wasserwirtschaftliches System kann passend zurr Aufgabenstellung konfiguriert werden. Dabei ist räumliche Auflösung frei wählbar und unbegrenzt. Die zeitliche Auflösung einer Simulation kann zwischen einer Minute bis einem Monat frei gesetzt werden. Talsim-NG wurde eingesetzt für Gebiete > 10 km² bis zu Flussgebieten > 3,000,000 km² (z.B. gesamtes Nileinzugsgebiet). <br><br>


Die wesentlichen Bausteine von Talsim-NG sind: <br>
- Niederschlag-Abfluss Simulation, inklusive Schneesimulation / - Flood routing und hydraulische Modellierung von Bauwerken / - Komplexer Atmosphären-Vegetation-Boden Baustein / - Frei konfigurierbares Regeln und Steuern sowie Speicherbewirtschaftung / - Konzeptionelles Grundwassermodel / - Nested modelling (hochaufgelöste Modelle integriert in großen aber groben Modellen) / - Feuchtgebietsmodellierung / - Pflanzenwasserbedarfsberechung und Bewässserung / - Wassertemperatur und Wasserqualität / - Zeitreihenverwaltung / - Projekt und Szenarienverwaltung / - Client-Server Architektur.


Dieses Wiki enthält die offizielle Dokumentation von Talsim-NG.


<div class="info">Dieses Wiki wird ständig gepflegt und erweitert.</div>


__TOC__

==Einführung== 


*[[Media:TalsimNG brochure en.pdf|Talsim-NG Broschüre (PDF, Englisch)]]
*[[Special:MyLanguage/Einsatzmöglichkeiten von Talsim-NG|Einsatzmöglichkeiten von Talsim-NG]]
*[[Media:TalsimIntroductoryExample.pdf|Einführungstutorial (PDF, Englisch)]]
*[[Media:OperationRulesInTalsimNG.pdf|Betriebsregeln in Talsim-NG (PDF, Englisch)]]
*[[Media:TalsimNGTimeSteps.pdf|Ablauf der Zeitschrittberechnung (PDF, Englisch)]]
*[[Special:MyLanguage/Video Tutorials|Video Tutorials]]

==Theoretische Grundlagen== 


Im folgenden Kapitel finden sich ausführliche Informationen zu den theoretischen Grundlagen von Talsim:
*[[Special:MyLanguage/Flussgebietsmodell|Flussgebietsmodell]]
*[[Special:MyLanguage/Modellkonzept|Modellkonzept]]
*[[Special:MyLanguage/Beschreibung der Systemelemente|Beschreibung der Systemelemente]]
*[[Special:MyLanguage/Begriffsdefinitionen|Begriffsdefinitionen]]

==Modellerstellung und Anwendung== 


Die wichtigesten Schritte zur Erstellung und Anwendung eines Talsim-NG Flussgebietmodells werden in den folgenden Kapiteln erläutert
*[[Special:MyLanguage/Arbeitsschritte zur Modellerstellung|Arbeitsschritte zur Modellerstellung]]
*[[Special:MyLanguage/Simulation|Simulation]]
*[[Special:MyLanguage/Parameterschätzung und Kalibrierung|Parameterschätzung und Kalibrierung]]
*[[Special:MyLanguage/Optimierung von Betriebsplänen|Optimierung von Betriebsplänen]]
*[[Special:MyLanguage/Arbeiten mit dem TaskSrv|Arbeiten mit dem TaskSrv]]
*[[Special:MyLanguage/Arbeiten mit dem SydroTaskMgr|Arbeiten mit dem SydroTaskMgr]]
*[[Special:MyLanguage/Arbeiten mit dem SydroCmd tool|Arbeiten mit dem SydroCmd tool]]
*[[Special:MyLanguage/Operationeller Einsatz von Talsim-NG|Operationeller Einsatz von Talsim-NG]]

==Grafische Benutzeroberfläche== 


*[[Special:MyLanguage/Anmeldung und Startfenster|Anmeldung und Startfenster]]
*[[Special:MyLanguage/Talsim-NG Hauptfenster|Talsim-NG Hauptfenster]]
*[[Special:MyLanguage/Systemverwaltung|Systemverwaltung]]
*[[Special:MyLanguage/Zeitreihenverwaltung|Zeitreihenverwaltung]]
*[[Special:MyLanguage/Einzelfenster von Modellkomponenten|Einzelfenster von Modellkomponenten]]
*[[Special:MyLanguage/Zustandsgruppenfenster|Zustandsgruppenfenster]]
*[[Special:MyLanguage/Fenster Zielfunktionen|Fenster Zielfunktionen]]
*[[Special:MyLanguage/Fenster Hochwasserwellenstatistik|Fenster Hochwasserwellenstatistik]]
*[[Special:MyLanguage/Fenster Kurzfristprognose|Fenster Kurzfristprognose]]

==Programmstruktur== 


*[[Special:MyLanguage/Konzept Server/Client|Konzept Server/Client]]
** [[Special:MyLanguage/Server-API|Server-API]]
*[[Special:MyLanguage/Softwarekomponenten|Softwarekomponenten]]
*[[Special:MyLanguage/Verzeichnisstruktur|Verzeichnisstruktur]]
*[[Special:MyLanguage/Datenbankstruktur|Datenbankstruktur]]
*[[Special:MyLanguage/Erstellen eines Customers|Erstellen eines Customers]]
*[[Special:MyLanguage/Anlegen eines Benutzers|Anlegen eines Benutzers]]
*[[Schnittstellen: Import/Export|Schnittstellen: Import/Export]]
*[[Special:MyLanguage/Skriptsprachen|Skriptsprachen]]

==Anhang== 


*[[Special:MyLanguage/Talsim-NG Dateiformate|Talsim-NG Dateiformate]]
*[[Special:MyLanguage/Installation der Software|Installation der Software]]
*[[Special:MyLanguage/Einstellung der Regions- und Sprachoptionen|Einstellung der Regions- und Sprachoptionen]]
*[[Special:MyLanguage/Fehlermeldungen|Fehlermeldungen]]
*[[Special:MyLanguage/Beispiele zu Betriebsregeln|Beispiele zu Betriebsregeln]]
*[[Special:MyLanguage/Hochwassermerkmalsimulation|Hochwassermerkmalsimulation]]
*[[Special:MyLanguage/Schnittstellen zu externen Programmen|Schnittstellen zu externen Programmen]]
**[[Special:MyLanguage/FEWS|FEWS]]
**[[Special:MyLanguage/BlueM.Wave|BlueM.Wave]]
**[[Special:MyLanguage/BlueM.Opt|BlueM.Opt]]
</translate>

Hauptseite

2022-09-16T18:30:53Z

HubertLohr:

<languages/>
<translate>

[[Datei:TALSIM-NG splashscreen.jpg|zentriert]]


<hr/>
Talsim-NG ist ein hybrides hydrologisch/hydraulisches Flussgebietsmodell. Es ist konzipiert, um von Hochwasser bis Dürreperioden alle hydrologischen Fragestellungen abzubilden. Die Software ist modular und skalierbar aufgebaut, d.h. ein wasserwirtschaftliches System kann passend zurr Aufgabenstellung konfiguriert werden. Dabei ist räumliche Auflösung frei wählbar und unbegrenzt. Die zeitliche Auflösung einer Simulation kann zwischen einer Minute bis einem Monat frei gesetzt werden. Talsim-NG wurde eingesetzt für Gebiete > 10 km² bis zu Flussgebieten > 3,000,000 km² (z.B. gesamtes Nileinzugsgebiet). <br><br>


Die wesentlichen Bausteine von Talsim-NG sind: <br>
- Niederschlag-Abfluss Simulation, inklusive Schneesimulation / - Flood routing und hydraulische Modellierung von Bauwerken / - Komplexer Atmosphären-Vegetation-Boden Baustein / - Frei konfigurierbares Regeln und Steuern sowie Speicherbewirtschaftung / - Konzeptionelles Grundwassermodel / - Nested modelling (hochaufgelöste Modelle integriert in großen aber groben Modellen) / - Feuchtgebietsmodellierung / - Pflanzenwasserbedarfsberechung und Bewässserung / - Wassertemperatur und Wasserqualität / - Zeitreihenverwaltung / - Projekt und Szenarienverwaltung / - Client-Server Architektur.


Dieses Wiki enthält die offizielle Dokumentation von Talsim-NG.


<div class="info">Dieses Wiki wird ständig gepflegt und erweitert.</div>


__TOC__

==Einführung== 


*[[Media:TalsimNG brochure en.pdf|Talsim-NG Broschüre (PDF, Englisch)]]
*[[Special:MyLanguage/Einsatzmöglichkeiten von Talsim-NG|Einsatzmöglichkeiten von Talsim-NG]]
*[[Media:TalsimIntroductoryExample.pdf|Einführungstutorial (PDF, Englisch)]]
*[[Media:OperationRulesInTalsimNG.pdf|Betriebsregeln in Talsim-NG (PDF, Englisch)]]
*[[Media:TalsimNGTimeSteps.pdf|Ablauf der Zeitschrittberechnung (PDF, Englisch)]]
*[[Special:MyLanguage/Video Tutorials|Video Tutorials]]

==Theoretische Grundlagen== 


Im folgenden Kapitel finden sich ausführliche Informationen zu den theoretischen Grundlagen von Talsim:
*[[Special:MyLanguage/Flussgebietsmodell|Flussgebietsmodell]]
*[[Special:MyLanguage/Modellkonzept|Modellkonzept]]
*[[Special:MyLanguage/Beschreibung der Systemelemente|Beschreibung der Systemelemente]]
*[[Special:MyLanguage/Begriffsdefinitionen|Begriffsdefinitionen]]

==Modellerstellung und Anwendung== 


Die wichtigesten Schritte zur Erstellung und Anwendung eines Talsim-NG Flussgebietmodells werden in den folgenden Kapiteln erläutert
*[[Special:MyLanguage/Arbeitsschritte zur Modellerstellung|Arbeitsschritte zur Modellerstellung]]
*[[Special:MyLanguage/Simulation|Simulation]]
*[[Special:MyLanguage/Parameterschätzung und Kalibrierung|Parameterschätzung und Kalibrierung]]
*[[Special:MyLanguage/Optimierung von Betriebsplänen|Optimierung von Betriebsplänen]]
*[[Special:MyLanguage/Arbeiten mit dem TaskSrv|Arbeiten mit dem TaskSrv]]
*[[Special:MyLanguage/Arbeiten mit dem SydroTaskMgr|Arbeiten mit dem SydroTaskMgr]]
*[[Special:MyLanguage/Arbeiten mit dem SydroCmd tool|Arbeiten mit dem SydroCmd tool]]
*[[Special:MyLanguage/Operationeller Einsatz von Talsim-NG|Operationeller Einsatz von Talsim-NG]]

==Grafische Benutzeroberfläche== 


*[[Special:MyLanguage/Anmeldung und Startfenster|Anmeldung und Startfenster]]
*[[Special:MyLanguage/Talsim-NG Hauptfenster|Talsim-NG Hauptfenster]]
*[[Special:MyLanguage/Systemverwaltung|Systemverwaltung]]
*[[Special:MyLanguage/Zeitreihenverwaltung|Zeitreihenverwaltung]]
*[[Special:MyLanguage/Einzelfenster von Modellkomponenten|Einzelfenster von Modellkomponenten]]
*[[Special:MyLanguage/Zustandsgruppenfenster|Zustandsgruppenfenster]]
*[[Special:MyLanguage/Fenster Zielfunktionen|Fenster Zielfunktionen]]
*[[Special:MyLanguage/Fenster Hochwasserwellenstatistik|Fenster Hochwasserwellenstatistik]]
*[[Special:MyLanguage/Fenster Kurzfristprognose|Fenster Kurzfristprognose]]

==Programmstruktur== 


*[[Special:MyLanguage/Konzept Server/Client|Konzept Server/Client]]
** [[Special:MyLanguage/Server-API|Server-API]]
*[[Special:MyLanguage/Softwarekomponenten|Softwarekomponenten]]
*[[Special:MyLanguage/Verzeichnisstruktur|Verzeichnisstruktur]]
*[[Special:MyLanguage/Datenbankstruktur|Datenbankstruktur]]
*[[Special:MyLanguage/Erstellen eines Customers|Erstellen eines Customers]]
*[[Special:MyLanguage/Anlegen eines Benutzers|Anlegen eines Benutzers]]
*[[Schnittstellen: Import/Export|Schnittstellen: Import/Export]]
*[[Special:MyLanguage/Skriptsprachen|Skriptsprachen]]

==Anhang== 


*[[Special:MyLanguage/Talsim-NG Dateiformate|Talsim-NG Dateiformate]]
*[[Special:MyLanguage/Installation der Software|Installation der Software]]
*[[Special:MyLanguage/Einstellung der Regions- und Sprachoptionen|Einstellung der Regions- und Sprachoptionen]]
*[[Special:MyLanguage/Fehlermeldungen|Fehlermeldungen]]
*[[Special:MyLanguage/Beispiele zu Betriebsregeln|Beispiele zu Betriebsregeln]]
*[[Special:MyLanguage/Hochwassermerkmalsimulation|Hochwassermerkmalsimulation]]
*[[Special:MyLanguage/Schnittstellen zu externen Programmen|Schnittstellen zu externen Programmen]]
**[[Special:MyLanguage/FEWS|FEWS]]
**[[Special:MyLanguage/BlueM.Wave|BlueM.Wave]]
**[[Special:MyLanguage/BlueM.Opt|BlueM.Opt]]
</translate>

Hauptseite

2022-09-16T18:30:24Z

HubertLohr:

<languages/>
<translate>

[[Datei:TALSIM-NG splashscreen.jpg|zentriert]]


<hr/>
Talsim-NG ist ein hybrides hydrologisch/hydraulisches Flussgebietsmodell. Es ist konzipiert, um von Hochwasser bis Dürreperioden alle hydrologischen Fragestellungen abzubilden. Die Software ist modular und skalierbar aufgebaut, d.h. ein wasserwirtschaftliches System kann passend zurr Aufgabenstellung konfiguriert werden. Dabei ist räumliche Auflösung frei wählbar und unbegrenzt. Die zeitliche Auflösung einer Simulation kann zwischen einer Minute bis einem Monat frei gesetzt werden. Talsim-NG wurde eingesetzt für Gebiete > 10 km² bis zu Flussgebieten > 3,000,000 km² (z.B. gesamtes Nileinzugsgebiet). <br><br>


Die wesentlichen Bausteine von Talsim-NG sind: <br>
- Niederschlag-Abfluss Simulation, inklusive Schneesimulation / - Flood routing und hydraulische Modellierung von Bauwerken / - Komplexer Atmosphären-Vegetation-Boden Baustein / - Frei konfigurierbares Regeln und Steuern sowie Speicherbewirtschaftung / - Konzeptionelles Grundwassermodel / - Nested modelling (hochaufgelöste Modelle integriert in großen aber groben Modellen) / - Feuchtgebietsmodellierung / - Pflanzenwasserbedarfsberechung und Bewässserung / - Wassertemperatur und Wasserqualität / - Zeitreihenverwaltung / - Projekt und Szenarienverwaltung / - Client-Server Architektur.


Dieses Wiki enthält die offizielle Dokumentation von Talsim-NG.


<div class="info">Dieses Wiki wird ständig gepflegt und erweitert. Einzelne Abschnitte befinden sich noch im Aufbau.</div>


__TOC__

==Einführung== 


*[[Media:TalsimNG brochure en.pdf|Talsim-NG Broschüre (PDF, Englisch)]]
*[[Special:MyLanguage/Einsatzmöglichkeiten von Talsim-NG|Einsatzmöglichkeiten von Talsim-NG]]
*[[Media:TalsimIntroductoryExample.pdf|Einführungstutorial (PDF, Englisch)]]
*[[Media:OperationRulesInTalsimNG.pdf|Betriebsregeln in Talsim-NG (PDF, Englisch)]]
*[[Media:TalsimNGTimeSteps.pdf|Ablauf der Zeitschrittberechnung (PDF, Englisch)]]
*[[Special:MyLanguage/Video Tutorials|Video Tutorials]]

==Theoretische Grundlagen== 


Im folgenden Kapitel finden sich ausführliche Informationen zu den theoretischen Grundlagen von Talsim:
*[[Special:MyLanguage/Flussgebietsmodell|Flussgebietsmodell]]
*[[Special:MyLanguage/Modellkonzept|Modellkonzept]]
*[[Special:MyLanguage/Beschreibung der Systemelemente|Beschreibung der Systemelemente]]
*[[Special:MyLanguage/Begriffsdefinitionen|Begriffsdefinitionen]]

==Modellerstellung und Anwendung== 


Die wichtigesten Schritte zur Erstellung und Anwendung eines Talsim-NG Flussgebietmodells werden in den folgenden Kapiteln erläutert
*[[Special:MyLanguage/Arbeitsschritte zur Modellerstellung|Arbeitsschritte zur Modellerstellung]]
*[[Special:MyLanguage/Simulation|Simulation]]
*[[Special:MyLanguage/Parameterschätzung und Kalibrierung|Parameterschätzung und Kalibrierung]]
*[[Special:MyLanguage/Optimierung von Betriebsplänen|Optimierung von Betriebsplänen]]
*[[Special:MyLanguage/Arbeiten mit dem TaskSrv|Arbeiten mit dem TaskSrv]]
*[[Special:MyLanguage/Arbeiten mit dem SydroTaskMgr|Arbeiten mit dem SydroTaskMgr]]
*[[Special:MyLanguage/Arbeiten mit dem SydroCmd tool|Arbeiten mit dem SydroCmd tool]]
*[[Special:MyLanguage/Operationeller Einsatz von Talsim-NG|Operationeller Einsatz von Talsim-NG]]

==Grafische Benutzeroberfläche== 


*[[Special:MyLanguage/Anmeldung und Startfenster|Anmeldung und Startfenster]]
*[[Special:MyLanguage/Talsim-NG Hauptfenster|Talsim-NG Hauptfenster]]
*[[Special:MyLanguage/Systemverwaltung|Systemverwaltung]]
*[[Special:MyLanguage/Zeitreihenverwaltung|Zeitreihenverwaltung]]
*[[Special:MyLanguage/Einzelfenster von Modellkomponenten|Einzelfenster von Modellkomponenten]]
*[[Special:MyLanguage/Zustandsgruppenfenster|Zustandsgruppenfenster]]
*[[Special:MyLanguage/Fenster Zielfunktionen|Fenster Zielfunktionen]]
*[[Special:MyLanguage/Fenster Hochwasserwellenstatistik|Fenster Hochwasserwellenstatistik]]
*[[Special:MyLanguage/Fenster Kurzfristprognose|Fenster Kurzfristprognose]]

==Programmstruktur== 


*[[Special:MyLanguage/Konzept Server/Client|Konzept Server/Client]]
** [[Special:MyLanguage/Server-API|Server-API]]
*[[Special:MyLanguage/Softwarekomponenten|Softwarekomponenten]]
*[[Special:MyLanguage/Verzeichnisstruktur|Verzeichnisstruktur]]
*[[Special:MyLanguage/Datenbankstruktur|Datenbankstruktur]]
*[[Special:MyLanguage/Erstellen eines Customers|Erstellen eines Customers]]
*[[Special:MyLanguage/Anlegen eines Benutzers|Anlegen eines Benutzers]]
*[[Schnittstellen: Import/Export|Schnittstellen: Import/Export]]
*[[Special:MyLanguage/Skriptsprachen|Skriptsprachen]]

==Anhang== 


*[[Special:MyLanguage/Talsim-NG Dateiformate|Talsim-NG Dateiformate]]
*[[Special:MyLanguage/Installation der Software|Installation der Software]]
*[[Special:MyLanguage/Einstellung der Regions- und Sprachoptionen|Einstellung der Regions- und Sprachoptionen]]
*[[Special:MyLanguage/Fehlermeldungen|Fehlermeldungen]]
*[[Special:MyLanguage/Beispiele zu Betriebsregeln|Beispiele zu Betriebsregeln]]
*[[Special:MyLanguage/Hochwassermerkmalsimulation|Hochwassermerkmalsimulation]]
*[[Special:MyLanguage/Schnittstellen zu externen Programmen|Schnittstellen zu externen Programmen]]
**[[Special:MyLanguage/FEWS|FEWS]]
**[[Special:MyLanguage/BlueM.Wave|BlueM.Wave]]
**[[Special:MyLanguage/BlueM.Opt|BlueM.Opt]]
</translate>

Hauptseite

2022-09-16T18:26:49Z

HubertLohr:

<languages/>
<translate>

[[Datei:TALSIM-NG splashscreen.jpg|zentriert]]


<hr/>
Talsim-NG ist ein hybrides hydrologisch/hydraulisches Flussgebietsmodell. Es ist konzipiert, um von Hochwasser bis Dürreperioden alle hydrologischen Fragestellungen abzubilden. Die Software ist modular und skalierbar aufgebaut, d.h. ein wasserwirtschaftliches System kann passend zurr Aufgabenstellung konfiguriert werden. Dabei ist räumliche Auflösung frei wählbar und unbegrenzt. Die zeitliche Auflösung einer Simulation kann zwischen einer Minute bis einem Monat frei gesetzt werden. Talsim-NG wurde eingesetzt für Gebiete > 10 km² bis zu Flussgebieten > 3,000,000 km² (z.B. gesamtes Nileinzugsgebiet). <br>


Die wesentlichen Bausteine von Talsim-NG sind: <br>
- Niederschlag-Abfluss Simulation, inklusive Schneesimulation / - Flood routing und hydraulische Modellierung von Bauwerken / - Komplexer Atmosphären-Vegetation-Boden Baustein / - Frei konfigurierbares Regeln und Steuern sowie Speicherbewirtschaftung / - Konzeptionelles Grundwassermodel / - Nested modelling (hochaufgelöste Modelle integriert in großen aber groben Modellen) / - Feuchtgebietsmodellierung / - Pflanzenwasserbedarfsberechung und Bewässserung / - Wassertemperatur und Wasserqualität / - Zeitreihenverwaltung / - Projekt und Szenarienverwaltung / - Client-Server Architektur.


Dieses Wiki enthält die offizielle Dokumentation von Talsim-NG.


<div class="info">Dieses Wiki wird ständig gepflegt und erweitert. Einzelne Abschnitte befinden sich noch im Aufbau.</div>


__TOC__

==Einführung== 


*[[Media:TalsimNG brochure en.pdf|Talsim-NG Broschüre (PDF, Englisch)]]
*[[Special:MyLanguage/Einsatzmöglichkeiten von Talsim-NG|Einsatzmöglichkeiten von Talsim-NG]]
*[[Media:TalsimIntroductoryExample.pdf|Einführungstutorial (PDF, Englisch)]]
*[[Media:OperationRulesInTalsimNG.pdf|Betriebsregeln in Talsim-NG (PDF, Englisch)]]
*[[Media:TalsimNGTimeSteps.pdf|Ablauf der Zeitschrittberechnung (PDF, Englisch)]]
*[[Special:MyLanguage/Video Tutorials|Video Tutorials]]

==Theoretische Grundlagen== 


Im folgenden Kapitel finden sich ausführliche Informationen zu den theoretischen Grundlagen von Talsim:
*[[Special:MyLanguage/Flussgebietsmodell|Flussgebietsmodell]]
*[[Special:MyLanguage/Modellkonzept|Modellkonzept]]
*[[Special:MyLanguage/Beschreibung der Systemelemente|Beschreibung der Systemelemente]]
*[[Special:MyLanguage/Begriffsdefinitionen|Begriffsdefinitionen]]

==Modellerstellung und Anwendung== 


Die wichtigesten Schritte zur Erstellung und Anwendung eines Talsim-NG Flussgebietmodells werden in den folgenden Kapiteln erläutert
*[[Special:MyLanguage/Arbeitsschritte zur Modellerstellung|Arbeitsschritte zur Modellerstellung]]
*[[Special:MyLanguage/Simulation|Simulation]]
*[[Special:MyLanguage/Parameterschätzung und Kalibrierung|Parameterschätzung und Kalibrierung]]
*[[Special:MyLanguage/Optimierung von Betriebsplänen|Optimierung von Betriebsplänen]]
*[[Special:MyLanguage/Arbeiten mit dem TaskSrv|Arbeiten mit dem TaskSrv]]
*[[Special:MyLanguage/Arbeiten mit dem SydroTaskMgr|Arbeiten mit dem SydroTaskMgr]]
*[[Special:MyLanguage/Arbeiten mit dem SydroCmd tool|Arbeiten mit dem SydroCmd tool]]
*[[Special:MyLanguage/Operationeller Einsatz von Talsim-NG|Operationeller Einsatz von Talsim-NG]]

==Grafische Benutzeroberfläche== 


*[[Special:MyLanguage/Anmeldung und Startfenster|Anmeldung und Startfenster]]
*[[Special:MyLanguage/Talsim-NG Hauptfenster|Talsim-NG Hauptfenster]]
*[[Special:MyLanguage/Systemverwaltung|Systemverwaltung]]
*[[Special:MyLanguage/Zeitreihenverwaltung|Zeitreihenverwaltung]]
*[[Special:MyLanguage/Einzelfenster von Modellkomponenten|Einzelfenster von Modellkomponenten]]
*[[Special:MyLanguage/Zustandsgruppenfenster|Zustandsgruppenfenster]]
*[[Special:MyLanguage/Fenster Zielfunktionen|Fenster Zielfunktionen]]
*[[Special:MyLanguage/Fenster Hochwasserwellenstatistik|Fenster Hochwasserwellenstatistik]]
*[[Special:MyLanguage/Fenster Kurzfristprognose|Fenster Kurzfristprognose]]

==Programmstruktur== 


*[[Special:MyLanguage/Konzept Server/Client|Konzept Server/Client]]
** [[Special:MyLanguage/Server-API|Server-API]]
*[[Special:MyLanguage/Softwarekomponenten|Softwarekomponenten]]
*[[Special:MyLanguage/Verzeichnisstruktur|Verzeichnisstruktur]]
*[[Special:MyLanguage/Datenbankstruktur|Datenbankstruktur]]
*[[Special:MyLanguage/Erstellen eines Customers|Erstellen eines Customers]]
*[[Special:MyLanguage/Anlegen eines Benutzers|Anlegen eines Benutzers]]
*[[Schnittstellen: Import/Export|Schnittstellen: Import/Export]]
*[[Special:MyLanguage/Skriptsprachen|Skriptsprachen]]

==Anhang== 


*[[Special:MyLanguage/Talsim-NG Dateiformate|Talsim-NG Dateiformate]]
*[[Special:MyLanguage/Installation der Software|Installation der Software]]
*[[Special:MyLanguage/Einstellung der Regions- und Sprachoptionen|Einstellung der Regions- und Sprachoptionen]]
*[[Special:MyLanguage/Fehlermeldungen|Fehlermeldungen]]
*[[Special:MyLanguage/Beispiele zu Betriebsregeln|Beispiele zu Betriebsregeln]]
*[[Special:MyLanguage/Hochwassermerkmalsimulation|Hochwassermerkmalsimulation]]
*[[Special:MyLanguage/Schnittstellen zu externen Programmen|Schnittstellen zu externen Programmen]]
**[[Special:MyLanguage/FEWS|FEWS]]
**[[Special:MyLanguage/BlueM.Wave|BlueM.Wave]]
**[[Special:MyLanguage/BlueM.Opt|BlueM.Opt]]
</translate>

Hauptseite

2022-09-16T18:22:54Z

HubertLohr:

<languages/>
<translate>

[[Datei:TALSIM-NG splashscreen.jpg|zentriert]]


<hr/>
Talsim-NG ist ein hybrides hydrologisch/hydraulisches Flussgebietsmodell. Es ist konzipiert, um von Hochwasser bis Dürreperioden alle hydrologischen Fragestellungen abzubilden. Die Software ist modular und skalierbar aufgebaut, d.h. ein wasserwirtschaftliches System kann passend zurr Aufgabenstellung konfiguriert werden. Dabei ist räumliche Auflösung frei wählbar und unbegrenzt. Die zeitliche Auflösung einer Simulation kann zwischen einer Minute bis einem Monat frei gesetzt werden. Talsim-NG wurde eingesetzt für Gebiete > 10 km² bis zu Flussgebieten > 3,000,000 km² (z.B. gesamtes Nileinzugsgebiet).


Die wesentlichen Bausteine von Talsim-NG sind: <br>
- Niederschlag-Abfluss Simulation, inklusive Schneesimulation / - Flood routing und hydraulische Modellierung von Bauwerken / - Komplexer Atmosphären-Vegetation-Boden Baustein / - Frei konfigurierbares Regeln und Steuern sowie Speicherbewirtschaftung / - Konzeptionelles Grundwassermodel / - Nested modelling (hochaufgelöste Modelle integriert in großen aber groben Modellen) / - Feuchtgebietsmodellierung / - Pflanzenwasserbedarfsberechung und Bewässserung / - Wassertemperatur und Wasserqualität / - Zeitreihenverwaltung / - Projekt und Szenarienverwaltung / - Client-Server Architektur.


Dieses Wiki enthält die offizielle Dokumentation von Talsim-NG.


<div class="info">Dieses Wiki wird ständig gepflegt und erweitert. Einzelne Abschnitte befinden sich noch im Aufbau.</div>


__TOC__

==Einführung== 


*[[Media:TalsimNG brochure en.pdf|Talsim-NG Broschüre (PDF, Englisch)]]
*[[Special:MyLanguage/Einsatzmöglichkeiten von Talsim-NG|Einsatzmöglichkeiten von Talsim-NG]]
*[[Media:TalsimIntroductoryExample.pdf|Einführungstutorial (PDF, Englisch)]]
*[[Media:OperationRulesInTalsimNG.pdf|Betriebsregeln in Talsim-NG (PDF, Englisch)]]
*[[Media:TalsimNGTimeSteps.pdf|Ablauf der Zeitschrittberechnung (PDF, Englisch)]]
*[[Special:MyLanguage/Video Tutorials|Video Tutorials]]

==Theoretische Grundlagen== 


Im folgenden Kapitel finden sich ausführliche Informationen zu den theoretischen Grundlagen von Talsim:
*[[Special:MyLanguage/Flussgebietsmodell|Flussgebietsmodell]]
*[[Special:MyLanguage/Modellkonzept|Modellkonzept]]
*[[Special:MyLanguage/Beschreibung der Systemelemente|Beschreibung der Systemelemente]]
*[[Special:MyLanguage/Begriffsdefinitionen|Begriffsdefinitionen]]

==Modellerstellung und Anwendung== 


Die wichtigesten Schritte zur Erstellung und Anwendung eines Talsim-NG Flussgebietmodells werden in den folgenden Kapiteln erläutert
*[[Special:MyLanguage/Arbeitsschritte zur Modellerstellung|Arbeitsschritte zur Modellerstellung]]
*[[Special:MyLanguage/Simulation|Simulation]]
*[[Special:MyLanguage/Parameterschätzung und Kalibrierung|Parameterschätzung und Kalibrierung]]
*[[Special:MyLanguage/Optimierung von Betriebsplänen|Optimierung von Betriebsplänen]]
*[[Special:MyLanguage/Arbeiten mit dem TaskSrv|Arbeiten mit dem TaskSrv]]
*[[Special:MyLanguage/Arbeiten mit dem SydroTaskMgr|Arbeiten mit dem SydroTaskMgr]]
*[[Special:MyLanguage/Arbeiten mit dem SydroCmd tool|Arbeiten mit dem SydroCmd tool]]
*[[Special:MyLanguage/Operationeller Einsatz von Talsim-NG|Operationeller Einsatz von Talsim-NG]]

==Grafische Benutzeroberfläche== 


*[[Special:MyLanguage/Anmeldung und Startfenster|Anmeldung und Startfenster]]
*[[Special:MyLanguage/Talsim-NG Hauptfenster|Talsim-NG Hauptfenster]]
*[[Special:MyLanguage/Systemverwaltung|Systemverwaltung]]
*[[Special:MyLanguage/Zeitreihenverwaltung|Zeitreihenverwaltung]]
*[[Special:MyLanguage/Einzelfenster von Modellkomponenten|Einzelfenster von Modellkomponenten]]
*[[Special:MyLanguage/Zustandsgruppenfenster|Zustandsgruppenfenster]]
*[[Special:MyLanguage/Fenster Zielfunktionen|Fenster Zielfunktionen]]
*[[Special:MyLanguage/Fenster Hochwasserwellenstatistik|Fenster Hochwasserwellenstatistik]]
*[[Special:MyLanguage/Fenster Kurzfristprognose|Fenster Kurzfristprognose]]

==Programmstruktur== 


*[[Special:MyLanguage/Konzept Server/Client|Konzept Server/Client]]
** [[Special:MyLanguage/Server-API|Server-API]]
*[[Special:MyLanguage/Softwarekomponenten|Softwarekomponenten]]
*[[Special:MyLanguage/Verzeichnisstruktur|Verzeichnisstruktur]]
*[[Special:MyLanguage/Datenbankstruktur|Datenbankstruktur]]
*[[Special:MyLanguage/Erstellen eines Customers|Erstellen eines Customers]]
*[[Special:MyLanguage/Anlegen eines Benutzers|Anlegen eines Benutzers]]
*[[Schnittstellen: Import/Export|Schnittstellen: Import/Export]]
*[[Special:MyLanguage/Skriptsprachen|Skriptsprachen]]

==Anhang== 


*[[Special:MyLanguage/Talsim-NG Dateiformate|Talsim-NG Dateiformate]]
*[[Special:MyLanguage/Installation der Software|Installation der Software]]
*[[Special:MyLanguage/Einstellung der Regions- und Sprachoptionen|Einstellung der Regions- und Sprachoptionen]]
*[[Special:MyLanguage/Fehlermeldungen|Fehlermeldungen]]
*[[Special:MyLanguage/Beispiele zu Betriebsregeln|Beispiele zu Betriebsregeln]]
*[[Special:MyLanguage/Hochwassermerkmalsimulation|Hochwassermerkmalsimulation]]
*[[Special:MyLanguage/Schnittstellen zu externen Programmen|Schnittstellen zu externen Programmen]]
**[[Special:MyLanguage/FEWS|FEWS]]
**[[Special:MyLanguage/BlueM.Wave|BlueM.Wave]]
**[[Special:MyLanguage/BlueM.Opt|BlueM.Opt]]
</translate>

Hauptseite

2022-09-16T18:19:03Z

HubertLohr:

<languages/>
<translate>

[[Datei:TALSIM-NG splashscreen.jpg|zentriert]]


<hr/>
Talsim-NG ist ein hybrides hydrologisch/hydraulisches Flussgebietsmodell. Es ist konzipiert, um von Hochwasser bis Dürreperioden alle hydrologischen Fragestellungen abzubilden. Die Software ist modular und skalierbar aufgebaut, d.h. ein wasserwirtschaftliches System kann passend zurr Aufgabenstellung konfiguriert werden. Dabei ist räumliche Auflösung frei wählbar und unbegrenzt. Die zeitliche Auflösung einer Simulation kann zwischen einer Minute bis einem Monat frei gesetzt werden. Talsim-NG wurde eingesetzt für Gebiete > 10 km² bis zu Flussgebieten > 3,000,000 km² (z.B. gesamtes Nileinzugsgebiet). Die wesentlichen Bausteine von Talsim-NG sind: <br>
- Niederschlag-Abfluss Simulation, inklusive Schneesimulation / - Flood routing und hydraulische Modellierung von Bauwerken / - Komplexer Atmosphären-Vegetation-Boden Baustein / - Frei konfigurierbares Regeln und Steuern sowie Speicherbewirtschaftung / - Konzeptionelles Grundwassermodel / - Nested modelling (hochaufgelöste Modelle integriert in großen aber groben Modellen) / - Feuchtgebietsmodellierung / - Pflanzenwasserbedarfsberechung und Bewässserung / - Wassertemperatur und Wasserqualität / - Zeitreihenverwaltung / - Projekt und Szenarienverwaltung / - Client-Server Architektur.


Talsim-NG basiert auf einer offenen generischen Modellarchitektur. Der Anwender wird mit den zur Verfügung stehenden Komponenten in die Lage versetzt, beliebige wasserwirtschaftliche Systeme und Bewirtschaftungsstrategien nachbilden zu können.


Dieses Wiki enthält die offizielle Dokumentation von Talsim-NG.


<div class="info">Dieses Wiki wird ständig gepflegt und erweitert. Einzelne Abschnitte befinden sich noch im Aufbau.</div>


__TOC__

==Einführung== 


*[[Media:TalsimNG brochure en.pdf|Talsim-NG Broschüre (PDF, Englisch)]]
*[[Special:MyLanguage/Einsatzmöglichkeiten von Talsim-NG|Einsatzmöglichkeiten von Talsim-NG]]
*[[Media:TalsimIntroductoryExample.pdf|Einführungstutorial (PDF, Englisch)]]
*[[Media:OperationRulesInTalsimNG.pdf|Betriebsregeln in Talsim-NG (PDF, Englisch)]]
*[[Media:TalsimNGTimeSteps.pdf|Ablauf der Zeitschrittberechnung (PDF, Englisch)]]
*[[Special:MyLanguage/Video Tutorials|Video Tutorials]]

==Theoretische Grundlagen== 


Im folgenden Kapitel finden sich ausführliche Informationen zu den theoretischen Grundlagen von Talsim:
*[[Special:MyLanguage/Flussgebietsmodell|Flussgebietsmodell]]
*[[Special:MyLanguage/Modellkonzept|Modellkonzept]]
*[[Special:MyLanguage/Beschreibung der Systemelemente|Beschreibung der Systemelemente]]
*[[Special:MyLanguage/Begriffsdefinitionen|Begriffsdefinitionen]]

==Modellerstellung und Anwendung== 


Die wichtigesten Schritte zur Erstellung und Anwendung eines Talsim-NG Flussgebietmodells werden in den folgenden Kapiteln erläutert
*[[Special:MyLanguage/Arbeitsschritte zur Modellerstellung|Arbeitsschritte zur Modellerstellung]]
*[[Special:MyLanguage/Simulation|Simulation]]
*[[Special:MyLanguage/Parameterschätzung und Kalibrierung|Parameterschätzung und Kalibrierung]]
*[[Special:MyLanguage/Optimierung von Betriebsplänen|Optimierung von Betriebsplänen]]
*[[Special:MyLanguage/Arbeiten mit dem TaskSrv|Arbeiten mit dem TaskSrv]]
*[[Special:MyLanguage/Arbeiten mit dem SydroTaskMgr|Arbeiten mit dem SydroTaskMgr]]
*[[Special:MyLanguage/Arbeiten mit dem SydroCmd tool|Arbeiten mit dem SydroCmd tool]]
*[[Special:MyLanguage/Operationeller Einsatz von Talsim-NG|Operationeller Einsatz von Talsim-NG]]

==Grafische Benutzeroberfläche== 


*[[Special:MyLanguage/Anmeldung und Startfenster|Anmeldung und Startfenster]]
*[[Special:MyLanguage/Talsim-NG Hauptfenster|Talsim-NG Hauptfenster]]
*[[Special:MyLanguage/Systemverwaltung|Systemverwaltung]]
*[[Special:MyLanguage/Zeitreihenverwaltung|Zeitreihenverwaltung]]
*[[Special:MyLanguage/Einzelfenster von Modellkomponenten|Einzelfenster von Modellkomponenten]]
*[[Special:MyLanguage/Zustandsgruppenfenster|Zustandsgruppenfenster]]
*[[Special:MyLanguage/Fenster Zielfunktionen|Fenster Zielfunktionen]]
*[[Special:MyLanguage/Fenster Hochwasserwellenstatistik|Fenster Hochwasserwellenstatistik]]
*[[Special:MyLanguage/Fenster Kurzfristprognose|Fenster Kurzfristprognose]]

==Programmstruktur== 


*[[Special:MyLanguage/Konzept Server/Client|Konzept Server/Client]]
** [[Special:MyLanguage/Server-API|Server-API]]
*[[Special:MyLanguage/Softwarekomponenten|Softwarekomponenten]]
*[[Special:MyLanguage/Verzeichnisstruktur|Verzeichnisstruktur]]
*[[Special:MyLanguage/Datenbankstruktur|Datenbankstruktur]]
*[[Special:MyLanguage/Erstellen eines Customers|Erstellen eines Customers]]
*[[Special:MyLanguage/Anlegen eines Benutzers|Anlegen eines Benutzers]]
*[[Schnittstellen: Import/Export|Schnittstellen: Import/Export]]
*[[Special:MyLanguage/Skriptsprachen|Skriptsprachen]]

==Anhang== 


*[[Special:MyLanguage/Talsim-NG Dateiformate|Talsim-NG Dateiformate]]
*[[Special:MyLanguage/Installation der Software|Installation der Software]]
*[[Special:MyLanguage/Einstellung der Regions- und Sprachoptionen|Einstellung der Regions- und Sprachoptionen]]
*[[Special:MyLanguage/Fehlermeldungen|Fehlermeldungen]]
*[[Special:MyLanguage/Beispiele zu Betriebsregeln|Beispiele zu Betriebsregeln]]
*[[Special:MyLanguage/Hochwassermerkmalsimulation|Hochwassermerkmalsimulation]]
*[[Special:MyLanguage/Schnittstellen zu externen Programmen|Schnittstellen zu externen Programmen]]
**[[Special:MyLanguage/FEWS|FEWS]]
**[[Special:MyLanguage/BlueM.Wave|BlueM.Wave]]
**[[Special:MyLanguage/BlueM.Opt|BlueM.Opt]]
</translate>

Hauptseite

2022-09-16T18:18:29Z

HubertLohr:

<languages/>
<translate>

[[Datei:TALSIM-NG splashscreen.jpg|zentriert]]


<hr/>
Talsim-NG ist ein hybrides hydrologisch/hydraulisches Flussgebietsmodell. Es ist konzipiert, um von Hochwasser bis Dürreperioden alle hydrologischen Fragestellungen abzubilden. Die Software ist modular und skalierbar aufgebaut, d.h. ein wasserwirtschaftliches System kann passend zurr Aufgabenstellung konfiguriert werden. Dabei ist räumliche Auflösung frei wählbar und unbegrenzt. Die zeitliche Auflösung einer Simulation kann zwischen einer Minute bis einem Monat frei gesetzt werden. Talsim-NG wurde eingesetzt für Gebiete > 10 km² bis zu Flussgebieten > 3,000,000 km² (z.B. gesamtes Nileinzugsgebiet). Die wesentlichen Bausteine von Talsim-NG sind: <br>
- Niederschlag-Abfluss Simulation, inklusive Schneesimulation / - Flood routing und hydraulische Modellierung von Bauwerken / - Komplexer Atmosphären-Vegetation-Boden Baustein / - Frei konfigurierbares Regeln und Steuern sowie Speicherbewirtschaftung / - Konzeptionelles Grundwassermodel / - Nested modelling (hochaufgelöste Modelle integriert in großen aber groben Modellen) / - Feuchtgebietsmodellierung / - Pflanzenwasserbedarfberechung und Bewässserung / - Wassertemperatur und Wasserqualität / - Zeitreihenverwaltung / - Projekt und Szenarienverwaltung / - Client-Server Architektur.


Talsim-NG basiert auf einer offenen generischen Modellarchitektur. Der Anwender wird mit den zur Verfügung stehenden Komponenten in die Lage versetzt, beliebige wasserwirtschaftliche Systeme und Bewirtschaftungsstrategien nachbilden zu können.


Dieses Wiki enthält die offizielle Dokumentation von Talsim-NG.


<div class="info">Dieses Wiki wird ständig gepflegt und erweitert. Einzelne Abschnitte befinden sich noch im Aufbau.</div>


__TOC__

==Einführung== 


*[[Media:TalsimNG brochure en.pdf|Talsim-NG Broschüre (PDF, Englisch)]]
*[[Special:MyLanguage/Einsatzmöglichkeiten von Talsim-NG|Einsatzmöglichkeiten von Talsim-NG]]
*[[Media:TalsimIntroductoryExample.pdf|Einführungstutorial (PDF, Englisch)]]
*[[Media:OperationRulesInTalsimNG.pdf|Betriebsregeln in Talsim-NG (PDF, Englisch)]]
*[[Media:TalsimNGTimeSteps.pdf|Ablauf der Zeitschrittberechnung (PDF, Englisch)]]
*[[Special:MyLanguage/Video Tutorials|Video Tutorials]]

==Theoretische Grundlagen== 


Im folgenden Kapitel finden sich ausführliche Informationen zu den theoretischen Grundlagen von Talsim:
*[[Special:MyLanguage/Flussgebietsmodell|Flussgebietsmodell]]
*[[Special:MyLanguage/Modellkonzept|Modellkonzept]]
*[[Special:MyLanguage/Beschreibung der Systemelemente|Beschreibung der Systemelemente]]
*[[Special:MyLanguage/Begriffsdefinitionen|Begriffsdefinitionen]]

==Modellerstellung und Anwendung== 


Die wichtigesten Schritte zur Erstellung und Anwendung eines Talsim-NG Flussgebietmodells werden in den folgenden Kapiteln erläutert
*[[Special:MyLanguage/Arbeitsschritte zur Modellerstellung|Arbeitsschritte zur Modellerstellung]]
*[[Special:MyLanguage/Simulation|Simulation]]
*[[Special:MyLanguage/Parameterschätzung und Kalibrierung|Parameterschätzung und Kalibrierung]]
*[[Special:MyLanguage/Optimierung von Betriebsplänen|Optimierung von Betriebsplänen]]
*[[Special:MyLanguage/Arbeiten mit dem TaskSrv|Arbeiten mit dem TaskSrv]]
*[[Special:MyLanguage/Arbeiten mit dem SydroTaskMgr|Arbeiten mit dem SydroTaskMgr]]
*[[Special:MyLanguage/Arbeiten mit dem SydroCmd tool|Arbeiten mit dem SydroCmd tool]]
*[[Special:MyLanguage/Operationeller Einsatz von Talsim-NG|Operationeller Einsatz von Talsim-NG]]

==Grafische Benutzeroberfläche== 


*[[Special:MyLanguage/Anmeldung und Startfenster|Anmeldung und Startfenster]]
*[[Special:MyLanguage/Talsim-NG Hauptfenster|Talsim-NG Hauptfenster]]
*[[Special:MyLanguage/Systemverwaltung|Systemverwaltung]]
*[[Special:MyLanguage/Zeitreihenverwaltung|Zeitreihenverwaltung]]
*[[Special:MyLanguage/Einzelfenster von Modellkomponenten|Einzelfenster von Modellkomponenten]]
*[[Special:MyLanguage/Zustandsgruppenfenster|Zustandsgruppenfenster]]
*[[Special:MyLanguage/Fenster Zielfunktionen|Fenster Zielfunktionen]]
*[[Special:MyLanguage/Fenster Hochwasserwellenstatistik|Fenster Hochwasserwellenstatistik]]
*[[Special:MyLanguage/Fenster Kurzfristprognose|Fenster Kurzfristprognose]]

==Programmstruktur== 


*[[Special:MyLanguage/Konzept Server/Client|Konzept Server/Client]]
** [[Special:MyLanguage/Server-API|Server-API]]
*[[Special:MyLanguage/Softwarekomponenten|Softwarekomponenten]]
*[[Special:MyLanguage/Verzeichnisstruktur|Verzeichnisstruktur]]
*[[Special:MyLanguage/Datenbankstruktur|Datenbankstruktur]]
*[[Special:MyLanguage/Erstellen eines Customers|Erstellen eines Customers]]
*[[Special:MyLanguage/Anlegen eines Benutzers|Anlegen eines Benutzers]]
*[[Schnittstellen: Import/Export|Schnittstellen: Import/Export]]
*[[Special:MyLanguage/Skriptsprachen|Skriptsprachen]]

==Anhang== 


*[[Special:MyLanguage/Talsim-NG Dateiformate|Talsim-NG Dateiformate]]
*[[Special:MyLanguage/Installation der Software|Installation der Software]]
*[[Special:MyLanguage/Einstellung der Regions- und Sprachoptionen|Einstellung der Regions- und Sprachoptionen]]
*[[Special:MyLanguage/Fehlermeldungen|Fehlermeldungen]]
*[[Special:MyLanguage/Beispiele zu Betriebsregeln|Beispiele zu Betriebsregeln]]
*[[Special:MyLanguage/Hochwassermerkmalsimulation|Hochwassermerkmalsimulation]]
*[[Special:MyLanguage/Schnittstellen zu externen Programmen|Schnittstellen zu externen Programmen]]
**[[Special:MyLanguage/FEWS|FEWS]]
**[[Special:MyLanguage/BlueM.Wave|BlueM.Wave]]
**[[Special:MyLanguage/BlueM.Opt|BlueM.Opt]]
</translate>

Hauptseite

2022-09-16T18:16:07Z

HubertLohr:

<languages/>
<translate>

[[Datei:TALSIM-NG splashscreen.jpg|zentriert]]


<hr/>
Talsim-NG ist ein hybrides hydrologisch/hydraulisches Flussgebietsmodell. Es ist konzipiert, um von Hochwasser bis Dürreperioden alle hydrologischen Fragestellungen abzubilden. Die Software ist modular und skalierbar aufgebaut, d.h. ein wasserwirtschaftliches System kann passend zurr Aufgabenstellung konfiguriert werden. Dabei ist räumliche Auflösung frei wählbar und unbegrenzt. Die zeitliche Auflösung einer Simulation kann zwischen einer Minute bis einem Monat frei gesetzt werden. Talsim-NG wurde eingesetzt für Gebiete > 10 km² bis zu Flussgebieten > 3,000,000 km² (z.B. gesamtes Nileinzugsgebiet). Die wesentlichen Bausteine von Talsim-NG sind: <br>
- Niederschlag-Abfluss Simulation, inklusive Schneesimulation<br>
- Flood routing und hydraulische Modellierung von Bauwerken<br>
- Komplexer Atmosphären-Vegetation-Boden Baustein<br>
- Frei konfigurierbares Regeln und Steuern sowie Speicherbewirtschaftung<br>
- Konzeptionelles Grundwassermodel<br>
- Nested modelling (hochaufgelöste Modelle integriert in großen aber groben Modellen)<br>
- Feuchtgebietsmodel<br>
- Pflanzenwasserbedarfberechung und Bewässserung<br>
- Wassertemperatur und Wasserqualität<br>
- Zeitreihenverwaltung<br>
- Projekt und Szenarienverwaltung<br>
- Client-Server Architektur<br>


Talsim-NG basiert auf einer offenen generischen Modellarchitektur. Der Anwender wird mit den zur Verfügung stehenden Komponenten in die Lage versetzt, beliebige wasserwirtschaftliche Systeme und Bewirtschaftungsstrategien nachbilden zu können.


Dieses Wiki enthält die offizielle Dokumentation von Talsim-NG.


<div class="info">Dieses Wiki wird ständig gepflegt und erweitert. Einzelne Abschnitte befinden sich noch im Aufbau.</div>


__TOC__

==Einführung== 


*[[Media:TalsimNG brochure en.pdf|Talsim-NG Broschüre (PDF, Englisch)]]
*[[Special:MyLanguage/Einsatzmöglichkeiten von Talsim-NG|Einsatzmöglichkeiten von Talsim-NG]]
*[[Media:TalsimIntroductoryExample.pdf|Einführungstutorial (PDF, Englisch)]]
*[[Media:OperationRulesInTalsimNG.pdf|Betriebsregeln in Talsim-NG (PDF, Englisch)]]
*[[Media:TalsimNGTimeSteps.pdf|Ablauf der Zeitschrittberechnung (PDF, Englisch)]]
*[[Special:MyLanguage/Video Tutorials|Video Tutorials]]

==Theoretische Grundlagen== 


Im folgenden Kapitel finden sich ausführliche Informationen zu den theoretischen Grundlagen von Talsim:
*[[Special:MyLanguage/Flussgebietsmodell|Flussgebietsmodell]]
*[[Special:MyLanguage/Modellkonzept|Modellkonzept]]
*[[Special:MyLanguage/Beschreibung der Systemelemente|Beschreibung der Systemelemente]]
*[[Special:MyLanguage/Begriffsdefinitionen|Begriffsdefinitionen]]

==Modellerstellung und Anwendung== 


Die wichtigesten Schritte zur Erstellung und Anwendung eines Talsim-NG Flussgebietmodells werden in den folgenden Kapiteln erläutert
*[[Special:MyLanguage/Arbeitsschritte zur Modellerstellung|Arbeitsschritte zur Modellerstellung]]
*[[Special:MyLanguage/Simulation|Simulation]]
*[[Special:MyLanguage/Parameterschätzung und Kalibrierung|Parameterschätzung und Kalibrierung]]
*[[Special:MyLanguage/Optimierung von Betriebsplänen|Optimierung von Betriebsplänen]]
*[[Special:MyLanguage/Arbeiten mit dem TaskSrv|Arbeiten mit dem TaskSrv]]
*[[Special:MyLanguage/Arbeiten mit dem SydroTaskMgr|Arbeiten mit dem SydroTaskMgr]]
*[[Special:MyLanguage/Arbeiten mit dem SydroCmd tool|Arbeiten mit dem SydroCmd tool]]
*[[Special:MyLanguage/Operationeller Einsatz von Talsim-NG|Operationeller Einsatz von Talsim-NG]]

==Grafische Benutzeroberfläche== 


*[[Special:MyLanguage/Anmeldung und Startfenster|Anmeldung und Startfenster]]
*[[Special:MyLanguage/Talsim-NG Hauptfenster|Talsim-NG Hauptfenster]]
*[[Special:MyLanguage/Systemverwaltung|Systemverwaltung]]
*[[Special:MyLanguage/Zeitreihenverwaltung|Zeitreihenverwaltung]]
*[[Special:MyLanguage/Einzelfenster von Modellkomponenten|Einzelfenster von Modellkomponenten]]
*[[Special:MyLanguage/Zustandsgruppenfenster|Zustandsgruppenfenster]]
*[[Special:MyLanguage/Fenster Zielfunktionen|Fenster Zielfunktionen]]
*[[Special:MyLanguage/Fenster Hochwasserwellenstatistik|Fenster Hochwasserwellenstatistik]]
*[[Special:MyLanguage/Fenster Kurzfristprognose|Fenster Kurzfristprognose]]

==Programmstruktur== 


*[[Special:MyLanguage/Konzept Server/Client|Konzept Server/Client]]
** [[Special:MyLanguage/Server-API|Server-API]]
*[[Special:MyLanguage/Softwarekomponenten|Softwarekomponenten]]
*[[Special:MyLanguage/Verzeichnisstruktur|Verzeichnisstruktur]]
*[[Special:MyLanguage/Datenbankstruktur|Datenbankstruktur]]
*[[Special:MyLanguage/Erstellen eines Customers|Erstellen eines Customers]]
*[[Special:MyLanguage/Anlegen eines Benutzers|Anlegen eines Benutzers]]
*[[Schnittstellen: Import/Export|Schnittstellen: Import/Export]]
*[[Special:MyLanguage/Skriptsprachen|Skriptsprachen]]

==Anhang== 


*[[Special:MyLanguage/Talsim-NG Dateiformate|Talsim-NG Dateiformate]]
*[[Special:MyLanguage/Installation der Software|Installation der Software]]
*[[Special:MyLanguage/Einstellung der Regions- und Sprachoptionen|Einstellung der Regions- und Sprachoptionen]]
*[[Special:MyLanguage/Fehlermeldungen|Fehlermeldungen]]
*[[Special:MyLanguage/Beispiele zu Betriebsregeln|Beispiele zu Betriebsregeln]]
*[[Special:MyLanguage/Hochwassermerkmalsimulation|Hochwassermerkmalsimulation]]
*[[Special:MyLanguage/Schnittstellen zu externen Programmen|Schnittstellen zu externen Programmen]]
**[[Special:MyLanguage/FEWS|FEWS]]
**[[Special:MyLanguage/BlueM.Wave|BlueM.Wave]]
**[[Special:MyLanguage/BlueM.Opt|BlueM.Opt]]
</translate>

Hauptseite

2022-09-16T18:14:59Z

HubertLohr:

<languages/>
<translate>

[[Datei:TALSIM-NG splashscreen.jpg|zentriert]]


<hr/>
Talsim-NG ist ein hybrides hydrologisch/hydraulisches Flussgebietsmodell. Es ist konzipiert, um von Hochwasser bis Dürreperioden alle hydrologischen Fragestellungen abzubilden. Die Software ist modular und skalierbar aufgebaut, d.h. ein wasserwirtschaftliches System kann entsprechend der Aufgabenstellung aufgebaut werden. Dabei ist räumliche Auflösung frei wählbar und unbegrenzt. Die zeitliche Auflösung einer Simulation kann zwischen einer Minute bis einem Monat frei gesetzt werden. Talsim-NG wurde eingesetzt für Gebiete > 10 km² bis zu Flussgebieten > 3,000,000 km² (z.B. gesamtes Nileinzugsgebiet). Die wesentlichen Bausteine von Talsim-NG sind: <br>
- Niederschlag-Abfluss Simulation, inklusive Schneesimulation<br>
- Flood routing und hydraulische Modellierung von Bauwerken<br>
- Komplexer Atmosphären-Vegetation-Boden Baustein<br>
- Frei konfigurierbares Regeln und Steuern sowie Speicherbewirtschaftung<br>
- Konzeptionelles Grundwassermodel<br>
- Nested modelling (hochaufgelöste Modelle integriert in großen aber groben Modellen)<br>
- Feuchtgebietsmodel<br>
- Pflanzenwasserbedarfberechung und Bewässserung<br>
- Wassertemperatur und Wasserqualität<br>
- Zeitreihenverwaltung<br>
- Projekt und Szenarienverwaltung<br>
- Client-Server Architektur<br>


Talsim-NG basiert auf einer offenen generischen Modellarchitektur. Der Anwender wird mit den zur Verfügung stehenden Komponenten in die Lage versetzt, beliebige wasserwirtschaftliche Systeme und Bewirtschaftungsstrategien nachbilden zu können.


Dieses Wiki enthält die offizielle Dokumentation von Talsim-NG.


<div class="info">Dieses Wiki wird ständig gepflegt und erweitert. Einzelne Abschnitte befinden sich noch im Aufbau.</div>


__TOC__

==Einführung== 


*[[Media:TalsimNG brochure en.pdf|Talsim-NG Broschüre (PDF, Englisch)]]
*[[Special:MyLanguage/Einsatzmöglichkeiten von Talsim-NG|Einsatzmöglichkeiten von Talsim-NG]]
*[[Media:TalsimIntroductoryExample.pdf|Einführungstutorial (PDF, Englisch)]]
*[[Media:OperationRulesInTalsimNG.pdf|Betriebsregeln in Talsim-NG (PDF, Englisch)]]
*[[Media:TalsimNGTimeSteps.pdf|Ablauf der Zeitschrittberechnung (PDF, Englisch)]]
*[[Special:MyLanguage/Video Tutorials|Video Tutorials]]

==Theoretische Grundlagen== 


Im folgenden Kapitel finden sich ausführliche Informationen zu den theoretischen Grundlagen von Talsim:
*[[Special:MyLanguage/Flussgebietsmodell|Flussgebietsmodell]]
*[[Special:MyLanguage/Modellkonzept|Modellkonzept]]
*[[Special:MyLanguage/Beschreibung der Systemelemente|Beschreibung der Systemelemente]]
*[[Special:MyLanguage/Begriffsdefinitionen|Begriffsdefinitionen]]

==Modellerstellung und Anwendung== 


Die wichtigesten Schritte zur Erstellung und Anwendung eines Talsim-NG Flussgebietmodells werden in den folgenden Kapiteln erläutert
*[[Special:MyLanguage/Arbeitsschritte zur Modellerstellung|Arbeitsschritte zur Modellerstellung]]
*[[Special:MyLanguage/Simulation|Simulation]]
*[[Special:MyLanguage/Parameterschätzung und Kalibrierung|Parameterschätzung und Kalibrierung]]
*[[Special:MyLanguage/Optimierung von Betriebsplänen|Optimierung von Betriebsplänen]]
*[[Special:MyLanguage/Arbeiten mit dem TaskSrv|Arbeiten mit dem TaskSrv]]
*[[Special:MyLanguage/Arbeiten mit dem SydroTaskMgr|Arbeiten mit dem SydroTaskMgr]]
*[[Special:MyLanguage/Arbeiten mit dem SydroCmd tool|Arbeiten mit dem SydroCmd tool]]
*[[Special:MyLanguage/Operationeller Einsatz von Talsim-NG|Operationeller Einsatz von Talsim-NG]]

==Grafische Benutzeroberfläche== 


*[[Special:MyLanguage/Anmeldung und Startfenster|Anmeldung und Startfenster]]
*[[Special:MyLanguage/Talsim-NG Hauptfenster|Talsim-NG Hauptfenster]]
*[[Special:MyLanguage/Systemverwaltung|Systemverwaltung]]
*[[Special:MyLanguage/Zeitreihenverwaltung|Zeitreihenverwaltung]]
*[[Special:MyLanguage/Einzelfenster von Modellkomponenten|Einzelfenster von Modellkomponenten]]
*[[Special:MyLanguage/Zustandsgruppenfenster|Zustandsgruppenfenster]]
*[[Special:MyLanguage/Fenster Zielfunktionen|Fenster Zielfunktionen]]
*[[Special:MyLanguage/Fenster Hochwasserwellenstatistik|Fenster Hochwasserwellenstatistik]]
*[[Special:MyLanguage/Fenster Kurzfristprognose|Fenster Kurzfristprognose]]

==Programmstruktur== 


*[[Special:MyLanguage/Konzept Server/Client|Konzept Server/Client]]
** [[Special:MyLanguage/Server-API|Server-API]]
*[[Special:MyLanguage/Softwarekomponenten|Softwarekomponenten]]
*[[Special:MyLanguage/Verzeichnisstruktur|Verzeichnisstruktur]]
*[[Special:MyLanguage/Datenbankstruktur|Datenbankstruktur]]
*[[Special:MyLanguage/Erstellen eines Customers|Erstellen eines Customers]]
*[[Special:MyLanguage/Anlegen eines Benutzers|Anlegen eines Benutzers]]
*[[Schnittstellen: Import/Export|Schnittstellen: Import/Export]]
*[[Special:MyLanguage/Skriptsprachen|Skriptsprachen]]

==Anhang== 


*[[Special:MyLanguage/Talsim-NG Dateiformate|Talsim-NG Dateiformate]]
*[[Special:MyLanguage/Installation der Software|Installation der Software]]
*[[Special:MyLanguage/Einstellung der Regions- und Sprachoptionen|Einstellung der Regions- und Sprachoptionen]]
*[[Special:MyLanguage/Fehlermeldungen|Fehlermeldungen]]
*[[Special:MyLanguage/Beispiele zu Betriebsregeln|Beispiele zu Betriebsregeln]]
*[[Special:MyLanguage/Hochwassermerkmalsimulation|Hochwassermerkmalsimulation]]
*[[Special:MyLanguage/Schnittstellen zu externen Programmen|Schnittstellen zu externen Programmen]]
**[[Special:MyLanguage/FEWS|FEWS]]
**[[Special:MyLanguage/BlueM.Wave|BlueM.Wave]]
**[[Special:MyLanguage/BlueM.Opt|BlueM.Opt]]
</translate>

Hauptseite

2022-09-16T17:20:08Z

HubertLohr:

<languages/>
<translate>

[[Datei:TALSIM-NG splashscreen.jpg|zentriert]]


<hr/>
Talsim-NG ist ein hybrides hydrologisch/hydraulisches Flussgebietsmodell.


Talsim-NG basiert auf einer offenen generischen Modellarchitektur. Der Anwender wird mit den zur Verfügung stehenden Komponenten in die Lage versetzt, beliebige wasserwirtschaftliche Systeme und Bewirtschaftungsstrategien nachbilden zu können.


Dieses Wiki enthält die offizielle Dokumentation von Talsim-NG.


<div class="info">Dieses Wiki wird ständig gepflegt und erweitert. Einzelne Abschnitte befinden sich noch im Aufbau.</div>


__TOC__

==Einführung== 


*[[Media:TalsimNG brochure en.pdf|Talsim-NG Broschüre (PDF, Englisch)]]
*[[Special:MyLanguage/Einsatzmöglichkeiten von Talsim-NG|Einsatzmöglichkeiten von Talsim-NG]]
*[[Media:TalsimIntroductoryExample.pdf|Einführungstutorial (PDF, Englisch)]]
*[[Media:OperationRulesInTalsimNG.pdf|Betriebsregeln in Talsim-NG (PDF, Englisch)]]
*[[Media:TalsimNGTimeSteps.pdf|Ablauf der Zeitschrittberechnung (PDF, Englisch)]]
*[[Special:MyLanguage/Video Tutorials|Video Tutorials]]

==Theoretische Grundlagen== 


Im folgenden Kapitel finden sich ausführliche Informationen zu den theoretischen Grundlagen von Talsim:
*[[Special:MyLanguage/Flussgebietsmodell|Flussgebietsmodell]]
*[[Special:MyLanguage/Modellkonzept|Modellkonzept]]
*[[Special:MyLanguage/Beschreibung der Systemelemente|Beschreibung der Systemelemente]]
*[[Special:MyLanguage/Begriffsdefinitionen|Begriffsdefinitionen]]

==Modellerstellung und Anwendung== 


Die wichtigesten Schritte zur Erstellung und Anwendung eines Talsim-NG Flussgebietmodells werden in den folgenden Kapiteln erläutert
*[[Special:MyLanguage/Arbeitsschritte zur Modellerstellung|Arbeitsschritte zur Modellerstellung]]
*[[Special:MyLanguage/Simulation|Simulation]]
*[[Special:MyLanguage/Parameterschätzung und Kalibrierung|Parameterschätzung und Kalibrierung]]
*[[Special:MyLanguage/Optimierung von Betriebsplänen|Optimierung von Betriebsplänen]]
*[[Special:MyLanguage/Arbeiten mit dem TaskSrv|Arbeiten mit dem TaskSrv]]
*[[Special:MyLanguage/Arbeiten mit dem SydroTaskMgr|Arbeiten mit dem SydroTaskMgr]]
*[[Special:MyLanguage/Arbeiten mit dem SydroCmd tool|Arbeiten mit dem SydroCmd tool]]
*[[Special:MyLanguage/Operationeller Einsatz von Talsim-NG|Operationeller Einsatz von Talsim-NG]]

==Grafische Benutzeroberfläche== 


*[[Special:MyLanguage/Anmeldung und Startfenster|Anmeldung und Startfenster]]
*[[Special:MyLanguage/Talsim-NG Hauptfenster|Talsim-NG Hauptfenster]]
*[[Special:MyLanguage/Systemverwaltung|Systemverwaltung]]
*[[Special:MyLanguage/Zeitreihenverwaltung|Zeitreihenverwaltung]]
*[[Special:MyLanguage/Einzelfenster von Modellkomponenten|Einzelfenster von Modellkomponenten]]
*[[Special:MyLanguage/Zustandsgruppenfenster|Zustandsgruppenfenster]]
*[[Special:MyLanguage/Fenster Zielfunktionen|Fenster Zielfunktionen]]
*[[Special:MyLanguage/Fenster Hochwasserwellenstatistik|Fenster Hochwasserwellenstatistik]]
*[[Special:MyLanguage/Fenster Kurzfristprognose|Fenster Kurzfristprognose]]

==Programmstruktur== 


*[[Special:MyLanguage/Konzept Server/Client|Konzept Server/Client]]
** [[Special:MyLanguage/Server-API|Server-API]]
*[[Special:MyLanguage/Softwarekomponenten|Softwarekomponenten]]
*[[Special:MyLanguage/Verzeichnisstruktur|Verzeichnisstruktur]]
*[[Special:MyLanguage/Datenbankstruktur|Datenbankstruktur]]
*[[Special:MyLanguage/Erstellen eines Customers|Erstellen eines Customers]]
*[[Special:MyLanguage/Anlegen eines Benutzers|Anlegen eines Benutzers]]
*[[Schnittstellen: Import/Export|Schnittstellen: Import/Export]]
*[[Special:MyLanguage/Skriptsprachen|Skriptsprachen]]

==Anhang== 


*[[Special:MyLanguage/Talsim-NG Dateiformate|Talsim-NG Dateiformate]]
*[[Special:MyLanguage/Installation der Software|Installation der Software]]
*[[Special:MyLanguage/Einstellung der Regions- und Sprachoptionen|Einstellung der Regions- und Sprachoptionen]]
*[[Special:MyLanguage/Fehlermeldungen|Fehlermeldungen]]
*[[Special:MyLanguage/Beispiele zu Betriebsregeln|Beispiele zu Betriebsregeln]]
*[[Special:MyLanguage/Hochwassermerkmalsimulation|Hochwassermerkmalsimulation]]
*[[Special:MyLanguage/Schnittstellen zu externen Programmen|Schnittstellen zu externen Programmen]]
**[[Special:MyLanguage/FEWS|FEWS]]
**[[Special:MyLanguage/BlueM.Wave|BlueM.Wave]]
**[[Special:MyLanguage/BlueM.Opt|BlueM.Opt]]
</translate>

Hauptseite/en

2022-09-15T18:24:14Z

HubertLohr:

<languages/>
[[Datei:TALSIM-NG splashscreen.jpg|center]]

<hr/>
Talsim-NG is a river basin model, which was developed to efficiently support authorities, associations, companies and engineering offices working in the water industry with the planning of water management measures and the operation of water resources facilities.

Talsim-NG is based on an open, generic model architecture. With the available components, the user is able to simulate any water management system and management strategies.

This Wiki contains the official documentation of Talsim-NG.

<div class="info">This Wiki is constantly being maintained and expanded. Individual sections are still under construction.</div>

__TOC__

==Introduction==

*[[Media:TalsimNG brochure en.pdf|Talsim-NG brochure (PDF)]]
*[[Special:MyLanguage/Einsatzmöglichkeiten von Talsim-NG|Possible applications of Talsim-NG]]
*[[Media:TalsimIntroductoryExample.pdf|Introductory tutorial (PDF)]]
*[[Media:OperationRulesInTalsimNG.pdf|Operation Rules in Talsim NG (PDF)]]
*[[Media:TalsimNGTimeSteps.pdf|Understanding the Calculation of Time Steps (PDF)]]
*[[Special:MyLanguage/Video Tutorials|Video tutorials]]

==Theoretical basics==

The following chapter contains detailed information about the theoretical basics of Talsim:
*[[Special:MyLanguage/Flussgebietsmodell|River basin model]]
*[[Special:MyLanguage/Modellkonzept|Model concept]]
*[[Special:MyLanguage/Beschreibung der Systemelemente|Description of the system elements]]
*[[Special:MyLanguage/Begriffsdefinitionen|Definitions of terms]]

==Model setup and usage==

The most important steps to setup and use a Talsim-NG river basin model are explained in the following chapters:
*[[Special:MyLanguage/Arbeitsschritte zur Modellerstellung|Steps for setting up a model]]
*[[Special:MyLanguage/Simulation|Simulation]]
*[[Special:MyLanguage/Parameterschätzung und Kalibrierung|Parameter estimation and calibration]]
*[[Special:MyLanguage/Optimierung von Betriebsplänen|Optimization of operating plans]]
*[[Special:MyLanguage/Arbeiten mit dem TaskSrv|Working with TaskSrv]]
*[[Special:MyLanguage/Arbeiten mit dem SydroTaskMgr|Working with SydroTaskMgr]]
*[[Special:MyLanguage/Arbeiten mit dem SydroCmd tool|Working with SydroCmd]]
*[[Special:MyLanguage/Operationeller Einsatz von Talsim-NG|Operational use of Talsim-NG]]

==Graphical user interface==

*[[Special:MyLanguage/Anmeldung und Startfenster|Login and start window]]
*[[Special:MyLanguage/Talsim-NG Hauptfenster|Talsim-NG main window]]
*[[Special:MyLanguage/Projekt Verwaltung|Project manager]]
*[[Special:MyLanguage/Zeitreihenverwaltung|Time series management]]
*[[Special:MyLanguage/Einzelfenster von Modellkomponenten|Individual model component windows]]
*[[Special:MyLanguage/Zustandsgruppenfenster|Control clusters]]
*[[Special:MyLanguage/Zielfunktionen|Objective functions]]
*[[Special:MyLanguage/Hochwasserwellenstatistik|Flood wave statistics]]
*[[Special:MyLanguage/Kurzfristprognose|Short-term forecasts]]

==Software architecture==

*[[Special:MyLanguage/Konzept Server/Client|Server/client concept]]
** [[Special:MyLanguage/Server-API|Server API]]
*[[Special:MyLanguage/Softwarekomponenten|Software components]]
*[[Special:MyLanguage/Verzeichnisstruktur|Directory structure]]
*[[Special:MyLanguage/Datenbankstruktur|Database structure]]
*[[Special:MyLanguage/Erstellen eines Customers|Creating a customer]]
*[[Special:MyLanguage/Anlegen eines Benutzers|Creating a user]]
*[[Schnittstellen: Import/Export|Interfaces: import/export]]
*[[Special:MyLanguage/Skriptsprachen|Scripting languages]]

==Miscellaneous==

<div class="mw-translate-fuzzy">
*[[Special:MyLanguage/Talsim-NG Dateiformate|Talsim-NG file formats]]
*[[Special:MyLanguage/Installation der Software|Software installation]]
*[[Special:MyLanguage/Einstellung der Regions- und Sprachoptionen|Region and language settings]]
*[[Special:MyLanguage/Fehlermeldungen|Error messages]]
*[[Special:MyLanguage/Beispiele zu Betriebsregeln|Examples of operating rules]]
*[[Special:MyLanguage/Hochwassermerkmalsimulation|Simulation of flood characteristics]]
*[[Special:MyLanguage/Schnittstellen zu externen Programmen|Interfaces to external programs]]
**[[Special:MyLanguage/FEWS|FEWS]]
**[[Special:MyLanguage/BlueM.Wave|BlueM.Wave]]
**[[Special:MyLanguage/BlueM.Opt|BlueM.Opt]]
</div>

Translations:Hauptseite/37/en

2022-09-15T18:22:17Z

HubertLohr:

*[[Special:MyLanguage/Anmeldung und Startfenster|Login and start window]]
*[[Special:MyLanguage/Talsim-NG Hauptfenster|Talsim-NG main window]]
*[[Special:MyLanguage/Projekt Verwaltung|Project manager]]
*[[Special:MyLanguage/Zeitreihenverwaltung|Time series management]]
*[[Special:MyLanguage/Einzelfenster von Modellkomponenten|Individual model component windows]]
*[[Special:MyLanguage/Zustandsgruppenfenster|Control clusters]]
*[[Special:MyLanguage/Zielfunktionen|Objective functions]]
*[[Special:MyLanguage/Hochwasserwellenstatistik|Flood wave statistics]]
*[[Special:MyLanguage/Kurzfristprognose|Short-term forecasts]]

Translations:Hauptseite/37/en

2022-09-15T18:21:48Z

HubertLohr:

*[[Special:MyLanguage/Anmeldung und Startfenster|Login and start window]]
*[[Special:MyLanguage/Talsim-NG Hauptfenster|Talsim-NG main window]]
*[[Special:MyLanguage/Projekt Verwaltung|Project manager]]
*[[Special:MyLanguage/Zeitreihenverwaltung|Time series management]]
*[[Special:MyLanguage/Einzelfenster von Modellkomponenten|Individual model component windows]]
*[[Special:MyLanguage/Zustandsgruppenfenster|Control clusters]]
*[[Special:MyLanguage/Fenster Zielfunktionen|Objective functions]]
*[[Special:MyLanguage/Fenster Hochwasserwellenstatistik|Flood wave statistics]]
*[[Special:MyLanguage/Fenster Kurzfristprognose|Short-term forecasts]]

Translations:Hauptseite/37/en

2022-09-15T18:21:19Z

HubertLohr:

*[[Special:MyLanguage/Anmeldung und Startfenster|Login and start window]]
*[[Special:MyLanguage/Talsim-NG Hauptfenster||Talsim-NG main window]]
*[[Special:MyLanguage/Projekt Verwaltung|Project manager]]
*[[Special:MyLanguage/Zeitreihenverwaltung|Time series management]]
*[[Special:MyLanguage/Einzelfenster von Modellkomponenten|Individual model component windows]]
*[[Special:MyLanguage/Zustandsgruppenfenster|Control clusters]]
*[[Special:MyLanguage/Fenster Zielfunktionen|Objective functions]]
*[[Special:MyLanguage/Fenster Hochwasserwellenstatistik|Flood wave statistics]]
*[[Special:MyLanguage/Fenster Kurzfristprognose|Short-term forecasts]]

KAL-Datei

2022-09-14T15:58:56Z

HubertLohr:

<languages/>
<translate>


{{ASCII-Datensatz}}


__TOC__
Die KAL-Datei dient zur Angabe von globalen Kalibrierungsfaktoren.

==Beispiel== 


<pre>
#SYDROTAL-INI
#START
[EZG]
EFL_AggregationAll=N
EZG_LnzDeltaProz=0.0
KF_Toleranz_mmh=0.0
EFL_AeMinProz=0.0
[EZGKALIB]
RetKonFakUrb=1
RetKonFakNat=1
RetKonFakInt=4
RetKonFakInt2=1
RetKonFakBas=6
RetKonFakBas2=2
NKasInt=3
NKasInt2=3
NKasBas=3
GWShare=0.9
[BF]
BF_CALC_OPTION=0
BF_CALC_STAU=0
BF_CALC_POTINF=0
[BFKALIB]
MaxInf=0.1
Schicht1kfExx=1.0
Schicht1kfEXXJGG=0
0.6 0.7 0.8 0.9 1.0 2.0 3.0 3.0 2.0 1.5 0.8 0.7
Schicht2kfExx=1.0
Schicht2kfEXXJGG=0
0.6 0.7 0.8 0.9 1.0 2.0 3.0 3.0 2.0 1.5 0.8 0.7
Schicht3kfExx=1.0
Schicht3kfEXXJGG=0
0.6 0.7 0.8 0.9 1.0 2.0 3.0 3.0 2.0 1.5 0.8 0.7
Schicht1kfInt=1.0
Schicht1kfINTJGG=0
0.6 0.7 0.8 0.9 1.0 2.0 3.0 3.0 2.0 1.5 0.8 0.7
Schicht2kfInt=1.0
Schicht2kfINTJGG=0
0.6 0.7 0.8 0.9 1.0 2.0 3.0 3.0 2.0 1.5 0.8 0.7
BF0=1.0
WP=1.0
NFK=1.0
LK=1.0
GPVThresholdReduction=1.0
[TRS]
MAXNKM=6
[SNOW]
T_GRZ_SCHNEE=0
T_GRZ_ABBAU=-1
T_SMELT=1.8
R_SMELT=4.2
DENSITY_GRZ=40
DENSITY_NEW=11
[PRECIP]
DVWK_DELTA=0.2
[RESULT]
TSTOUT=0
BFOUT=0
EFLOUT=0
TRSKNLOUT=0
HYAOUT=0
TALOUT=0
BFFKTOUT=0
SPEIOUT=0
SNOWOUT=0
ELEMOUT=0
KTROUT=0
SIMSTEPMSG=0
</pre>

==Erläuterungen== 

===<code>[EZG]</code>=== 


* <code>EFL_AggregationAll</code>: Aggregation über alle EFLs (<code>J/N</code>). Default: <code>N</code>
* <code> EZG_LnzDeltaProz</code>: erlaubte Abweichung von Lnz-Parametern in Prozent zur EFL Aggregation. Default: <code>0.0</code>
* <code>KF_Toleranz_mmh</code>: kF-Wert Toleranz für Aggregation von EFLs. Default: <code>0.0</code>
* <code>EFL_AeMinProz</code>: Grenzwert des Flächenanteils für die Aggregation von EFLs. Default: <code>0.0</code>

===<code>[EZGKALIB]</code>=== 

Parameter für die Retention in Einzugsgebieten


* <code>RetKonFakUrb</code>: Faktor für die Retentionskonstanten der versiegelten Flächen <code>K(VG)</code>
* <code>RetKonFakNat</code>: Faktor für die Retentionskonstanten des natürlichen Oberflächenabflusses <code>K1</code> und <code>K2</code>
* <code>RetKonFakInt</code>: Faktor für die Retentionskonstanten des Interflows <code>KInt</code>
* <code>RetKonFakInt2</code>: Faktor für die Retentionskonstanten des tiefen Interflows <code>KInt2</code>
* <code>RetKonFakBas</code>: Faktor für die Retentionskonstanten des Basisabflusses <code>KBas</code>
* <code>RetKonFakBas2</code>: Faktor für die Retentionskonstanten des tiefen Basisabflusses <code>KBas2</code>
* <code>NKasInt</code>: Anzahl Kaskaden für den Interflow
* <code>NKasInt2</code>: Anzahl Kaskaden für den tiefen Interflow
* <code>NKasBas</code>: Anzahl Kaskaden für den Basisabfluss
* <code>GWShare</code>: Faktor für die Aufteilung zwischen Basisabfluss und tiefem Grundwasser

===<code>[BF]</code>=== 


Experimentelle Optionen, die vom Standard abweichen und man nur ausnahmsweise ändern sollte.
* <code>BF_CALC_OPTION</code>:
Es gibt 4 Optionen: <br>
0 = (default) komplexen, nicht-linearen Baustein für alle Schichten verwenden <br>
1 = Mix, nicht-linearen Baustein für Infiltrationsschicht, andere Schichten vereinfacht <br>
2 = wenn kein Niederschlag fällt wird vereinfacht berechnet, sonst immer komplex <br>
3 = wenn kein Niederschlag fällt alle Schichten vereinfacht rechnen, sonst wie Option 1 <br>
4 = immer alle Schichten vereinfacht <br>
Vereinfacht bedeutet eine simple Wasserbilanzrechnung je Schicht.
* <code>BF_CALC_STAU</code>:
Es gibt 2 Optionen: <br>
0 = (default) Rückstaueffekt wird an Bodenschichtgrenze oben geprüft, d.h. eigener kf-Wert begrenzt Infiltration in die Schicht. Ausnahme: erste Schicht oben. <br>
1 = Rückstaueffekt wird an Bodenschichtgrenze unten festgelegt, eigener kf-Wert begrenzt nicht die Infiltration in die Schicht <br>
* <code>BF_CALC_POTINF</code>:
Berechnung der Infiltration in die oberste Schicht mit 2 Optionen: <br>
0 = (default) wenn Niederschlag > kf-Wert der obersten Schicht erfolgt potentielle Infiltrationsberechnung <br>
1 = potentielle Infiltrationsberechnung erfolgt immer <br>

===<code>[BFKALIB]</code>=== 


kf-Werte:
* <code>MaxInf</code>: Faktor für die maximale Infiltration maxInf
* <code>Schicht1kfExx</code>: Faktor für den kf-Wert für die Exfiltration aus Simulationsschicht 1
* <code>Schicht1kfEXXJGG</code>: Monatsfaktoren für den kf-Wert für die Exfiltration aus Simulationsschicht 1 (wenn > 0, werden die Monatsfaktoren für Jan-Dez aus der Folgezeile verwendet)
* <code>Schicht2kfExx</code>: Faktor für den kf-Wert für die Exfiltration aus Simulationsschicht 2
* <code>Schicht2kfEXXJGG</code>: Monatsfaktoren für den kf-Wert für die Exfiltration aus Simulationsschicht 2 (wenn > 0, werden die Monatsfaktoren für Jan-Dez aus der Folgezeile verwendet)
* <code>Schicht3kfExx</code>: Faktor für den kf-Wert für die Exfiltration aus Simulationsschicht 3
* <code>Schicht3kfEXXJGG</code>: Monatsfaktoren für den kf-Wert für die Exfiltration aus Simulationsschicht 3 (wenn > 0, werden die Monatsfaktoren für Jan-Dez aus der Folgezeile verwendet)
* <code>Schicht1kfInt</code>: Faktor für den kf-Wert für den Interflow aus Simulationsschicht 1
* <code>Schicht1kfINTJGG</code>: Monatsfaktoren für den kf-Wert für den Interflow aus Simulationsschicht 1 (wenn > 0, werden die Monatsfaktoren für Jan-Dez aus der Folgezeile verwendet)
* <code>Schicht2kfInt</code>: Faktor für den kf-Wert für den Interflow aus Simulationsschicht 2
* <code>Schicht1kfINTJGG</code>: Monatsfaktoren für den kf-Wert für den Interflow aus Simulationsschicht 2 (wenn > 0, werden die Monatsfaktoren für Jan-Dez aus der Folgezeile verwendet)
Bodenparameter:
* <code>BF0</code>: Faktor für BF0 (Anfangsbodenfeuchte). Default: <code>1.0</code>
* <code>WP</code>: Faktor für Welkepunkt. Default: <code>1.0</code>
* <code>NFK</code>: Faktor für nutzbare Feldkapazität (FK - WP). Default: <code>1.0</code>
* <code>LK</code>: Faktor für Luftkapazität (GPV - FK). Default: <code>1.0</code><br/>Aus den Faktoren <code>WP</code>, <code>NFK</code> und <code>LK</code> werden für alle Bodenschichten die Werte für Welkepunkt, Feldkapazität und Gesamtporenvolumen neu berechnet, dabei gelten jedoch folgende Grenzen:
** Min. Welkepunkt = 10 mm/m
** Max. Gesamtporenvolumen = 1000 mm/m
** Max. Feldkapazität = 0,95 * Gesamtporenvolumen
** Max. Welkepunkt = 0,95 * Feldkapazität
Bodentyp:
* <code>BodenTypAenderung</code>: Änderung des Bodentyps (Sand/Schluff/Ton). Default: <code>0</code><br/>Mit diesem Parameter lassen sich alle Bodentypen einheitlich um eine oder mehrere Stufen hoch- oder runtersetzen. Erlaubte Werte sind <code>-2</code> bis <code>2</code>.
Weitere Parameter:
* <code>GPVThresholdReduction</code>: Faktor für den Schwellwert der Bodenfeuchte, ab dem der Zufluss in den Boden aus einem oberhalb liegenden Einzusgebiet gedrosselt wird. Die Drosselung fängt mit 0% an bei WP und steigt linear auf 100% bei <code>GPV * Faktor</code>. Nur relevant, wenn <code>SoilInterconnected</code> in der [[Special:MyLanguage/ALL-Datei|ALL-Datei]] aktiviert ist. (''Ab Version 3.1.1.8'')

===<code>[TRS]</code>=== 


* <code>MAXNKM</code>: (Erklärung eingeben), 6 = <span style="color:red">???</span>

===<code>[SNOW]</code>=== 


* <code>T_GRZ_SCHNEE</code>: Grenztemperatur für Schneebildung [°C], default: 0
* <code>T_GRZ_ABBAU</code>: Grenztemperatur für Schneeabbau [°C], default: -1
* <code>T_SMELT</code>: Temperaturabhängige Schmelzrate [mm/(°C*d)], default: 1.8
* <code>R_SMELT</code>: Strahlungs u. Bodenwärme abhängige Schmelzrate [mm/d], default: 4.2
* <code>DENSITY_GRZ</code>: Grenzdichte Schnee [kg/m³], default: 40
* <code>DENSITY_NEW</code>: Neuschneedichte [kg/m³], default: 11

===<code>[PRECIP]</code>=== 


* <code>DVWK_DELTA</code>: (Erklärung eingeben), 0.2 = <span style="color:red">???</span>

===<code>[RESULT]</code>=== 

Debug-Ausgaben


* <code>TSTOUT</code>:
* <code>BFOUT</code>: Wenn <code>1</code>, wird im Verzeichnis der talsim.exe ein Datei <code>TSTBF.TMP</code> mit detaillierter Debug-Ausgabe der Bodenfeuchteberechnung ausgegeben.
* <code>EFLOUT</code>:
* <code>TRSKNLOUT</code>:
* <code>HYAOUT</code>:
* <code>TALOUT</code>:
* <code>BFFKTOUT</code>:
* <code>SPEIOUT</code>:
* <code>SNOWOUT</code>:
* <code>ELEMOUT</code>:
* <code>KTROUT</code>:
* <code>SIMSTEPMSG</code>:

</translate>

KAL-Datei

2022-09-14T15:57:51Z

HubertLohr:

<languages/>
<translate>


{{ASCII-Datensatz}}


__TOC__
Die KAL-Datei dient zur Angabe von globalen Kalibrierungsfaktoren.

==Beispiel== 


<pre>
#SYDROTAL-INI
#START
[EZG]
EFL_AggregationAll=N
EZG_LnzDeltaProz=0.0
KF_Toleranz_mmh=0.0
EFL_AeMinProz=0.0
[EZGKALIB]
RetKonFakUrb=1
RetKonFakNat=1
RetKonFakInt=4
RetKonFakInt2=1
RetKonFakBas=6
RetKonFakBas2=2
NKasInt=3
NKasInt2=3
NKasBas=3
GWShare=0.9
[BF]
BF_CALC_OPTION=0
BF_CALC_STAU=0
BF_CALC_POTINF=0
[BFKALIB]
MaxInf=0.1
Schicht1kfExx=1.0
Schicht1kfEXXJGG=0
0.6 0.7 0.8 0.9 1.0 2.0 3.0 3.0 2.0 1.5 0.8 0.7
Schicht2kfExx=1.0
Schicht2kfEXXJGG=0
0.6 0.7 0.8 0.9 1.0 2.0 3.0 3.0 2.0 1.5 0.8 0.7
Schicht3kfExx=1.0
Schicht3kfEXXJGG=0
0.6 0.7 0.8 0.9 1.0 2.0 3.0 3.0 2.0 1.5 0.8 0.7
Schicht1kfInt=1.0
Schicht1kfINTJGG=0
0.6 0.7 0.8 0.9 1.0 2.0 3.0 3.0 2.0 1.5 0.8 0.7
Schicht2kfInt=1.0
Schicht2kfINTJGG=0
0.6 0.7 0.8 0.9 1.0 2.0 3.0 3.0 2.0 1.5 0.8 0.7
BF0=1.0
WP=1.0
NFK=1.0
LK=1.0
GPVThresholdReduction=1.0
[TRS]
MAXNKM=6
[SNOW]
T_GRZ_SCHNEE=0
T_GRZ_ABBAU=-1
T_SMELT=1.8
R_SMELT=4.2
DENSITY_GRZ=40
DENSITY_NEW=11
[PRECIP]
DVWK_DELTA=0.2
[RESULT]
TSTOUT=0
BFOUT=0
EFLOUT=0
TRSKNLOUT=0
HYAOUT=0
TALOUT=0
BFFKTOUT=0
SPEIOUT=0
SNOWOUT=0
ELEMOUT=0
KTROUT=0
SIMSTEPMSG=0
</pre>

==Erläuterungen== 

===<code>[EZG]</code>=== 


* <code>EFL_AggregationAll</code>: Aggregation über alle EFLs (<code>J/N</code>). Default: <code>N</code>
* <code> EZG_LnzDeltaProz</code>: erlaubte Abweichung von Lnz-Parametern in Prozent zur EFL Aggregation. Default: <code>0.0</code>
* <code>KF_Toleranz_mmh</code>: kF-Wert Toleranz für Aggregation von EFLs. Default: <code>0.0</code>
* <code>EFL_AeMinProz</code>: Grenzwert des Flächenanteils für die Aggregation von EFLs. Default: <code>0.0</code>

===<code>[EZGKALIB]</code>=== 

Parameter für die Retention in Einzugsgebieten


* <code>RetKonFakUrb</code>: Faktor für die Retentionskonstanten der versiegelten Flächen <code>K(VG)</code>
* <code>RetKonFakNat</code>: Faktor für die Retentionskonstanten des natürlichen Oberflächenabflusses <code>K1</code> und <code>K2</code>
* <code>RetKonFakInt</code>: Faktor für die Retentionskonstanten des Interflows <code>KInt</code>
* <code>RetKonFakInt2</code>: Faktor für die Retentionskonstanten des tiefen Interflows <code>KInt2</code>
* <code>RetKonFakBas</code>: Faktor für die Retentionskonstanten des Basisabflusses <code>KBas</code>
* <code>RetKonFakBas2</code>: Faktor für die Retentionskonstanten des tiefen Basisabflusses <code>KBas2</code>
* <code>NKasInt</code>: Anzahl Kaskaden für den Interflow
* <code>NKasInt2</code>: Anzahl Kaskaden für den tiefen Interflow
* <code>NKasBas</code>: Anzahl Kaskaden für den Basisabfluss
* <code>GWShare</code>: Faktor für die Aufteilung zwischen Basisabfluss und tiefem Grundwasser

===<code>[BF]</code>=== 


Experimentelle Optionen, die deutlich vom Standard abweichen und man nur in Ausnahmen anwenden sollte.
* <code>BF_CALC_OPTION</code>:
Es gibt 4 Optionen: <br>
0 = (default) komplexen, nicht-linearen Baustein für alle Schichten verwenden <br>
1 = Mix, nicht-linearen Baustein für Infiltrationsschicht, andere Schichten evtl. vereinfacht <br>
2 = wenn kein Niederschlag fällt wird vereinfacht berechnet, sonst immer komplex <br>
3 = wenn kein Niederschlag fällt alle Schichten vereinfacht rechnen, sonst wie Option 1 <br>
4 = immer alle Schichten vereinfacht <br>
Vereinfacht bedeutet eine simple Wasserbilanzrechnung je Schicht.
* <code>BF_CALC_STAU</code>:
Es gibt 2 Optionen: <br>
0 = (default) Rückstaueffekt wird an Bodenschichtgrenze oben geprüft, d.h. eigener kf-Wert begrenzt Infiltration in die Schicht. Ausnahme: erste Schicht oben. <br>
1 = Rückstaueffekt wird an Bodenschichtgrenze unten festgelegt, eigener kf-Wert begrenzt nicht die Infiltration in die Schicht <br>
* <code>BF_CALC_POTINF</code>:
Berechnung der Infiltration in die oberste Schicht mit 2 Optionen: <br>
0 = (default) wenn Niederschlag > kf-Wert der obersten Schicht erfolgt potentielle Infiltrationsberechnung <br>
1 = potentielle Infiltrationsberechnung erfolgt immer <br>

===<code>[BFKALIB]</code>=== 


kf-Werte:
* <code>MaxInf</code>: Faktor für die maximale Infiltration maxInf
* <code>Schicht1kfExx</code>: Faktor für den kf-Wert für die Exfiltration aus Simulationsschicht 1
* <code>Schicht1kfEXXJGG</code>: Monatsfaktoren für den kf-Wert für die Exfiltration aus Simulationsschicht 1 (wenn > 0, werden die Monatsfaktoren für Jan-Dez aus der Folgezeile verwendet)
* <code>Schicht2kfExx</code>: Faktor für den kf-Wert für die Exfiltration aus Simulationsschicht 2
* <code>Schicht2kfEXXJGG</code>: Monatsfaktoren für den kf-Wert für die Exfiltration aus Simulationsschicht 2 (wenn > 0, werden die Monatsfaktoren für Jan-Dez aus der Folgezeile verwendet)
* <code>Schicht3kfExx</code>: Faktor für den kf-Wert für die Exfiltration aus Simulationsschicht 3
* <code>Schicht3kfEXXJGG</code>: Monatsfaktoren für den kf-Wert für die Exfiltration aus Simulationsschicht 3 (wenn > 0, werden die Monatsfaktoren für Jan-Dez aus der Folgezeile verwendet)
* <code>Schicht1kfInt</code>: Faktor für den kf-Wert für den Interflow aus Simulationsschicht 1
* <code>Schicht1kfINTJGG</code>: Monatsfaktoren für den kf-Wert für den Interflow aus Simulationsschicht 1 (wenn > 0, werden die Monatsfaktoren für Jan-Dez aus der Folgezeile verwendet)
* <code>Schicht2kfInt</code>: Faktor für den kf-Wert für den Interflow aus Simulationsschicht 2
* <code>Schicht1kfINTJGG</code>: Monatsfaktoren für den kf-Wert für den Interflow aus Simulationsschicht 2 (wenn > 0, werden die Monatsfaktoren für Jan-Dez aus der Folgezeile verwendet)
Bodenparameter:
* <code>BF0</code>: Faktor für BF0 (Anfangsbodenfeuchte). Default: <code>1.0</code>
* <code>WP</code>: Faktor für Welkepunkt. Default: <code>1.0</code>
* <code>NFK</code>: Faktor für nutzbare Feldkapazität (FK - WP). Default: <code>1.0</code>
* <code>LK</code>: Faktor für Luftkapazität (GPV - FK). Default: <code>1.0</code><br/>Aus den Faktoren <code>WP</code>, <code>NFK</code> und <code>LK</code> werden für alle Bodenschichten die Werte für Welkepunkt, Feldkapazität und Gesamtporenvolumen neu berechnet, dabei gelten jedoch folgende Grenzen:
** Min. Welkepunkt = 10 mm/m
** Max. Gesamtporenvolumen = 1000 mm/m
** Max. Feldkapazität = 0,95 * Gesamtporenvolumen
** Max. Welkepunkt = 0,95 * Feldkapazität
Bodentyp:
* <code>BodenTypAenderung</code>: Änderung des Bodentyps (Sand/Schluff/Ton). Default: <code>0</code><br/>Mit diesem Parameter lassen sich alle Bodentypen einheitlich um eine oder mehrere Stufen hoch- oder runtersetzen. Erlaubte Werte sind <code>-2</code> bis <code>2</code>.
Weitere Parameter:
* <code>GPVThresholdReduction</code>: Faktor für den Schwellwert der Bodenfeuchte, ab dem der Zufluss in den Boden aus einem oberhalb liegenden Einzusgebiet gedrosselt wird. Die Drosselung fängt mit 0% an bei WP und steigt linear auf 100% bei <code>GPV * Faktor</code>. Nur relevant, wenn <code>SoilInterconnected</code> in der [[Special:MyLanguage/ALL-Datei|ALL-Datei]] aktiviert ist. (''Ab Version 3.1.1.8'')

===<code>[TRS]</code>=== 


* <code>MAXNKM</code>: (Erklärung eingeben), 6 = <span style="color:red">???</span>

===<code>[SNOW]</code>=== 


* <code>T_GRZ_SCHNEE</code>: Grenztemperatur für Schneebildung [°C], default: 0
* <code>T_GRZ_ABBAU</code>: Grenztemperatur für Schneeabbau [°C], default: -1
* <code>T_SMELT</code>: Temperaturabhängige Schmelzrate [mm/(°C*d)], default: 1.8
* <code>R_SMELT</code>: Strahlungs u. Bodenwärme abhängige Schmelzrate [mm/d], default: 4.2
* <code>DENSITY_GRZ</code>: Grenzdichte Schnee [kg/m³], default: 40
* <code>DENSITY_NEW</code>: Neuschneedichte [kg/m³], default: 11

===<code>[PRECIP]</code>=== 


* <code>DVWK_DELTA</code>: (Erklärung eingeben), 0.2 = <span style="color:red">???</span>

===<code>[RESULT]</code>=== 

Debug-Ausgaben


* <code>TSTOUT</code>:
* <code>BFOUT</code>: Wenn <code>1</code>, wird im Verzeichnis der talsim.exe ein Datei <code>TSTBF.TMP</code> mit detaillierter Debug-Ausgabe der Bodenfeuchteberechnung ausgegeben.
* <code>EFLOUT</code>:
* <code>TRSKNLOUT</code>:
* <code>HYAOUT</code>:
* <code>TALOUT</code>:
* <code>BFFKTOUT</code>:
* <code>SPEIOUT</code>:
* <code>SNOWOUT</code>:
* <code>ELEMOUT</code>:
* <code>KTROUT</code>:
* <code>SIMSTEPMSG</code>:

</translate>

KAL-Datei

2022-09-14T15:55:00Z

HubertLohr:

<languages/>
<translate>


{{ASCII-Datensatz}}


__TOC__
Die KAL-Datei dient zur Angabe von globalen Kalibrierungsfaktoren.

==Beispiel== 


<pre>
#SYDROTAL-INI
#START
[EZG]
EFL_AggregationAll=N
EZG_LnzDeltaProz=0.0
KF_Toleranz_mmh=0.0
EFL_AeMinProz=0.0
[EZGKALIB]
RetKonFakUrb=1
RetKonFakNat=1
RetKonFakInt=4
RetKonFakInt2=1
RetKonFakBas=6
RetKonFakBas2=2
NKasInt=3
NKasInt2=3
NKasBas=3
GWShare=0.9
[BF]
BF_CALC_OPTION=0
BF_CALC_STAU=0
BF_CALC_POTINF=0
[BFKALIB]
MaxInf=0.1
Schicht1kfExx=1.0
Schicht1kfEXXJGG=0
0.6 0.7 0.8 0.9 1.0 2.0 3.0 3.0 2.0 1.5 0.8 0.7
Schicht2kfExx=1.0
Schicht2kfEXXJGG=0
0.6 0.7 0.8 0.9 1.0 2.0 3.0 3.0 2.0 1.5 0.8 0.7
Schicht3kfExx=1.0
Schicht3kfEXXJGG=0
0.6 0.7 0.8 0.9 1.0 2.0 3.0 3.0 2.0 1.5 0.8 0.7
Schicht1kfInt=1.0
Schicht1kfINTJGG=0
0.6 0.7 0.8 0.9 1.0 2.0 3.0 3.0 2.0 1.5 0.8 0.7
Schicht2kfInt=1.0
Schicht2kfINTJGG=0
0.6 0.7 0.8 0.9 1.0 2.0 3.0 3.0 2.0 1.5 0.8 0.7
BF0=1.0
WP=1.0
NFK=1.0
LK=1.0
GPVThresholdReduction=1.0
[TRS]
MAXNKM=6
[SNOW]
T_GRZ_SCHNEE=0
T_GRZ_ABBAU=-1
T_SMELT=1.8
R_SMELT=4.2
DENSITY_GRZ=40
DENSITY_NEW=11
[PRECIP]
DVWK_DELTA=0.2
[RESULT]
TSTOUT=0
BFOUT=0
EFLOUT=0
TRSKNLOUT=0
HYAOUT=0
TALOUT=0
BFFKTOUT=0
SPEIOUT=0
SNOWOUT=0
ELEMOUT=0
KTROUT=0
SIMSTEPMSG=0
</pre>

==Erläuterungen== 

===<code>[EZG]</code>=== 


* <code>EFL_AggregationAll</code>: Aggregation über alle EFLs (<code>J/N</code>). Default: <code>N</code>
* <code> EZG_LnzDeltaProz</code>: erlaubte Abweichung von Lnz-Parametern in Prozent zur EFL Aggregation. Default: <code>0.0</code>
* <code>KF_Toleranz_mmh</code>: kF-Wert Toleranz für Aggregation von EFLs. Default: <code>0.0</code>
* <code>EFL_AeMinProz</code>: Grenzwert des Flächenanteils für die Aggregation von EFLs. Default: <code>0.0</code>

===<code>[EZGKALIB]</code>=== 

Parameter für die Retention in Einzugsgebieten


* <code>RetKonFakUrb</code>: Faktor für die Retentionskonstanten der versiegelten Flächen <code>K(VG)</code>
* <code>RetKonFakNat</code>: Faktor für die Retentionskonstanten des natürlichen Oberflächenabflusses <code>K1</code> und <code>K2</code>
* <code>RetKonFakInt</code>: Faktor für die Retentionskonstanten des Interflows <code>KInt</code>
* <code>RetKonFakInt2</code>: Faktor für die Retentionskonstanten des tiefen Interflows <code>KInt2</code>
* <code>RetKonFakBas</code>: Faktor für die Retentionskonstanten des Basisabflusses <code>KBas</code>
* <code>RetKonFakBas2</code>: Faktor für die Retentionskonstanten des tiefen Basisabflusses <code>KBas2</code>
* <code>NKasInt</code>: Anzahl Kaskaden für den Interflow
* <code>NKasInt2</code>: Anzahl Kaskaden für den tiefen Interflow
* <code>NKasBas</code>: Anzahl Kaskaden für den Basisabfluss
* <code>GWShare</code>: Faktor für die Aufteilung zwischen Basisabfluss und tiefem Grundwasser

===<code>[BF]</code>=== 


Experimentelle Optionen, die deutlich vom Standard abweichen und man nur in Ausnahmen anwenden sollte.
* <code>BF_CALC_OPTION</code>:
Es gibt 4 Optionen:
0 = (default) komplexen, nicht-linearen Baustein für alle Schichten verwenden
1 = Mix, nicht-linearen Baustein für Infiltrationsschicht, andere Schichten evtl. vereinfacht
2 = wenn kein Niederschlag fällt wird vereinfacht berechnet, sonst immer komplex
3 = wenn kein Niederschlag fällt alle Schichten vereinfacht rechnen, sonst wie Option 1
4 = immer alle Schichten vereinfacht
Vereinfacht bedeutet eine simple Wasserbilanzrechnung je Schicht.
* <code>BF_CALC_STAU</code>:
Es gibt 2 Optionen:
0 = (default) Rückstaueffekt wird an Bodenschichtgrenze oben geprüft, d.h. eigener kf-Wert begrenzt Infiltration in die Schicht. Ausnahme: erste Schicht oben.
1 = Rückstaueffekt wird an Bodenschichtgrenze unten festgelegt, eigener kf-Wert begrenzt nicht die Infiltration in die Schicht
* <code>BF_CALC_POTINF</code>:
Berechnung der Infiltration in die oberste Schicht mit 2 Optionen:
0 = (default) wenn Niederschlag > kf-Wert der obersten Schicht erfolgt potentielle Infiltrationsberechnung
1 = potentielle Infiltrationsberechnung erfolgt immer

===<code>[BFKALIB]</code>=== 


kf-Werte:
* <code>MaxInf</code>: Faktor für die maximale Infiltration maxInf
* <code>Schicht1kfExx</code>: Faktor für den kf-Wert für die Exfiltration aus Simulationsschicht 1
* <code>Schicht1kfEXXJGG</code>: Monatsfaktoren für den kf-Wert für die Exfiltration aus Simulationsschicht 1 (wenn > 0, werden die Monatsfaktoren für Jan-Dez aus der Folgezeile verwendet)
* <code>Schicht2kfExx</code>: Faktor für den kf-Wert für die Exfiltration aus Simulationsschicht 2
* <code>Schicht2kfEXXJGG</code>: Monatsfaktoren für den kf-Wert für die Exfiltration aus Simulationsschicht 2 (wenn > 0, werden die Monatsfaktoren für Jan-Dez aus der Folgezeile verwendet)
* <code>Schicht3kfExx</code>: Faktor für den kf-Wert für die Exfiltration aus Simulationsschicht 3
* <code>Schicht3kfEXXJGG</code>: Monatsfaktoren für den kf-Wert für die Exfiltration aus Simulationsschicht 3 (wenn > 0, werden die Monatsfaktoren für Jan-Dez aus der Folgezeile verwendet)
* <code>Schicht1kfInt</code>: Faktor für den kf-Wert für den Interflow aus Simulationsschicht 1
* <code>Schicht1kfINTJGG</code>: Monatsfaktoren für den kf-Wert für den Interflow aus Simulationsschicht 1 (wenn > 0, werden die Monatsfaktoren für Jan-Dez aus der Folgezeile verwendet)
* <code>Schicht2kfInt</code>: Faktor für den kf-Wert für den Interflow aus Simulationsschicht 2
* <code>Schicht1kfINTJGG</code>: Monatsfaktoren für den kf-Wert für den Interflow aus Simulationsschicht 2 (wenn > 0, werden die Monatsfaktoren für Jan-Dez aus der Folgezeile verwendet)
Bodenparameter:
* <code>BF0</code>: Faktor für BF0 (Anfangsbodenfeuchte). Default: <code>1.0</code>
* <code>WP</code>: Faktor für Welkepunkt. Default: <code>1.0</code>
* <code>NFK</code>: Faktor für nutzbare Feldkapazität (FK - WP). Default: <code>1.0</code>
* <code>LK</code>: Faktor für Luftkapazität (GPV - FK). Default: <code>1.0</code><br/>Aus den Faktoren <code>WP</code>, <code>NFK</code> und <code>LK</code> werden für alle Bodenschichten die Werte für Welkepunkt, Feldkapazität und Gesamtporenvolumen neu berechnet, dabei gelten jedoch folgende Grenzen:
** Min. Welkepunkt = 10 mm/m
** Max. Gesamtporenvolumen = 1000 mm/m
** Max. Feldkapazität = 0,95 * Gesamtporenvolumen
** Max. Welkepunkt = 0,95 * Feldkapazität
Bodentyp:
* <code>BodenTypAenderung</code>: Änderung des Bodentyps (Sand/Schluff/Ton). Default: <code>0</code><br/>Mit diesem Parameter lassen sich alle Bodentypen einheitlich um eine oder mehrere Stufen hoch- oder runtersetzen. Erlaubte Werte sind <code>-2</code> bis <code>2</code>.
Weitere Parameter:
* <code>GPVThresholdReduction</code>: Faktor für den Schwellwert der Bodenfeuchte, ab dem der Zufluss in den Boden aus einem oberhalb liegenden Einzusgebiet gedrosselt wird. Die Drosselung fängt mit 0% an bei WP und steigt linear auf 100% bei <code>GPV * Faktor</code>. Nur relevant, wenn <code>SoilInterconnected</code> in der [[Special:MyLanguage/ALL-Datei|ALL-Datei]] aktiviert ist. (''Ab Version 3.1.1.8'')

===<code>[TRS]</code>=== 


* <code>MAXNKM</code>: (Erklärung eingeben), 6 = <span style="color:red">???</span>

===<code>[SNOW]</code>=== 


* <code>T_GRZ_SCHNEE</code>: Grenztemperatur für Schneebildung [°C], default: 0
* <code>T_GRZ_ABBAU</code>: Grenztemperatur für Schneeabbau [°C], default: -1
* <code>T_SMELT</code>: Temperaturabhängige Schmelzrate [mm/(°C*d)], default: 1.8
* <code>R_SMELT</code>: Strahlungs u. Bodenwärme abhängige Schmelzrate [mm/d], default: 4.2
* <code>DENSITY_GRZ</code>: Grenzdichte Schnee [kg/m³], default: 40
* <code>DENSITY_NEW</code>: Neuschneedichte [kg/m³], default: 11

===<code>[PRECIP]</code>=== 


* <code>DVWK_DELTA</code>: (Erklärung eingeben), 0.2 = <span style="color:red">???</span>

===<code>[RESULT]</code>=== 

Debug-Ausgaben


* <code>TSTOUT</code>:
* <code>BFOUT</code>: Wenn <code>1</code>, wird im Verzeichnis der talsim.exe ein Datei <code>TSTBF.TMP</code> mit detaillierter Debug-Ausgabe der Bodenfeuchteberechnung ausgegeben.
* <code>EFLOUT</code>:
* <code>TRSKNLOUT</code>:
* <code>HYAOUT</code>:
* <code>TALOUT</code>:
* <code>BFFKTOUT</code>:
* <code>SPEIOUT</code>:
* <code>SNOWOUT</code>:
* <code>ELEMOUT</code>:
* <code>KTROUT</code>:
* <code>SIMSTEPMSG</code>:

</translate>

KAL-Datei

2022-09-14T15:17:06Z

HubertLohr:

<languages/>
<translate>


{{ASCII-Datensatz}}


__TOC__
Die KAL-Datei dient zur Angabe von globalen Kalibrierungsfaktoren.

==Beispiel== 


<pre>
#SYDROTAL-INI
#START
[EZG]
EFL_AggregationAll=N
EZG_LnzDeltaProz=0.0
KF_Toleranz_mmh=0.0
EFL_AeMinProz=0.0
[EZGKALIB]
RetKonFakUrb=1
RetKonFakNat=1
RetKonFakInt=4
RetKonFakInt2=1
RetKonFakBas=6
RetKonFakBas2=2
NKasInt=3
NKasInt2=3
NKasBas=3
GWShare=0.9
[BF]
BF_CALC_OPTION=0
BF_CALC_STAU=0
BF_CALC_POTINF=0
[BFKALIB]
MaxInf=0.1
Schicht1kfExx=1.0
Schicht1kfEXXJGG=0
0.6 0.7 0.8 0.9 1.0 2.0 3.0 3.0 2.0 1.5 0.8 0.7
Schicht2kfExx=1.0
Schicht2kfEXXJGG=0
0.6 0.7 0.8 0.9 1.0 2.0 3.0 3.0 2.0 1.5 0.8 0.7
Schicht3kfExx=1.0
Schicht3kfEXXJGG=0
0.6 0.7 0.8 0.9 1.0 2.0 3.0 3.0 2.0 1.5 0.8 0.7
Schicht1kfInt=1.0
Schicht1kfINTJGG=0
0.6 0.7 0.8 0.9 1.0 2.0 3.0 3.0 2.0 1.5 0.8 0.7
Schicht2kfInt=1.0
Schicht2kfINTJGG=0
0.6 0.7 0.8 0.9 1.0 2.0 3.0 3.0 2.0 1.5 0.8 0.7
BF0=1.0
WP=1.0
NFK=1.0
LK=1.0
GPVThresholdReduction=1.0
[TRS]
MAXNKM=6
[SNOW]
T_GRZ_SCHNEE=0
T_GRZ_ABBAU=-1
T_SMELT=1.8
R_SMELT=4.2
DENSITY_GRZ=40
DENSITY_NEW=11
[PRECIP]
DVWK_DELTA=0.2
[RESULT]
TSTOUT=0
BFOUT=0
EFLOUT=0
TRSKNLOUT=0
HYAOUT=0
TALOUT=0
BFFKTOUT=0
SPEIOUT=0
SNOWOUT=0
ELEMOUT=0
KTROUT=0
SIMSTEPMSG=0
</pre>

==Erläuterungen== 

===<code>[EZG]</code>=== 


* <code>EFL_AggregationAll</code>: Aggregation über alle EFLs (<code>J/N</code>). Default: <code>N</code>
* <code> EZG_LnzDeltaProz</code>: erlaubte Abweichung von Lnz-Parametern in Prozent zur EFL Aggregation. Default: <code>0.0</code>
* <code>KF_Toleranz_mmh</code>: kF-Wert Toleranz für Aggregation von EFLs. Default: <code>0.0</code>
* <code>EFL_AeMinProz</code>: Grenzwert des Flächenanteils für die Aggregation von EFLs. Default: <code>0.0</code>

===<code>[EZGKALIB]</code>=== 

Parameter für die Retention in Einzugsgebieten


* <code>RetKonFakUrb</code>: Faktor für die Retentionskonstanten der versiegelten Flächen <code>K(VG)</code>
* <code>RetKonFakNat</code>: Faktor für die Retentionskonstanten des natürlichen Oberflächenabflusses <code>K1</code> und <code>K2</code>
* <code>RetKonFakInt</code>: Faktor für die Retentionskonstanten des Interflows <code>KInt</code>
* <code>RetKonFakInt2</code>: Faktor für die Retentionskonstanten des tiefen Interflows <code>KInt2</code>
* <code>RetKonFakBas</code>: Faktor für die Retentionskonstanten des Basisabflusses <code>KBas</code>
* <code>RetKonFakBas2</code>: Faktor für die Retentionskonstanten des tiefen Basisabflusses <code>KBas2</code>
* <code>NKasInt</code>: Anzahl Kaskaden für den Interflow
* <code>NKasInt2</code>: Anzahl Kaskaden für den tiefen Interflow
* <code>NKasBas</code>: Anzahl Kaskaden für den Basisabfluss
* <code>GWShare</code>: Faktor für die Aufteilung zwischen Basisabfluss und tiefem Grundwasser

===<code>[BF]</code>=== 


* <code>BF_CALC_OPTION</code>: (Erklärung eingeben), 0 = <span style="color:red">???</span>
* <code>BF_CALC_STAU</code>: (Erklärung eingeben), 0 = <span style="color:red">???</span>
* <code>BF_CALC_POTINF</code>: (Erklärung eingeben), 0 = <span style="color:red">???</span>

===<code>[BFKALIB]</code>=== 


kf-Werte:
* <code>MaxInf</code>: Faktor für die maximale Infiltration maxInf
* <code>Schicht1kfExx</code>: Faktor für den kf-Wert für die Exfiltration aus Simulationsschicht 1
* <code>Schicht1kfEXXJGG</code>: Monatsfaktoren für den kf-Wert für die Exfiltration aus Simulationsschicht 1 (wenn > 0, werden die Monatsfaktoren für Jan-Dez aus der Folgezeile verwendet)
* <code>Schicht2kfExx</code>: Faktor für den kf-Wert für die Exfiltration aus Simulationsschicht 2
* <code>Schicht2kfEXXJGG</code>: Monatsfaktoren für den kf-Wert für die Exfiltration aus Simulationsschicht 2 (wenn > 0, werden die Monatsfaktoren für Jan-Dez aus der Folgezeile verwendet)
* <code>Schicht3kfExx</code>: Faktor für den kf-Wert für die Exfiltration aus Simulationsschicht 3
* <code>Schicht3kfEXXJGG</code>: Monatsfaktoren für den kf-Wert für die Exfiltration aus Simulationsschicht 3 (wenn > 0, werden die Monatsfaktoren für Jan-Dez aus der Folgezeile verwendet)
* <code>Schicht1kfInt</code>: Faktor für den kf-Wert für den Interflow aus Simulationsschicht 1
* <code>Schicht1kfINTJGG</code>: Monatsfaktoren für den kf-Wert für den Interflow aus Simulationsschicht 1 (wenn > 0, werden die Monatsfaktoren für Jan-Dez aus der Folgezeile verwendet)
* <code>Schicht2kfInt</code>: Faktor für den kf-Wert für den Interflow aus Simulationsschicht 2
* <code>Schicht1kfINTJGG</code>: Monatsfaktoren für den kf-Wert für den Interflow aus Simulationsschicht 2 (wenn > 0, werden die Monatsfaktoren für Jan-Dez aus der Folgezeile verwendet)
Bodenparameter:
* <code>BF0</code>: Faktor für BF0 (Anfangsbodenfeuchte). Default: <code>1.0</code>
* <code>WP</code>: Faktor für Welkepunkt. Default: <code>1.0</code>
* <code>NFK</code>: Faktor für nutzbare Feldkapazität (FK - WP). Default: <code>1.0</code>
* <code>LK</code>: Faktor für Luftkapazität (GPV - FK). Default: <code>1.0</code><br/>Aus den Faktoren <code>WP</code>, <code>NFK</code> und <code>LK</code> werden für alle Bodenschichten die Werte für Welkepunkt, Feldkapazität und Gesamtporenvolumen neu berechnet, dabei gelten jedoch folgende Grenzen:
** Min. Welkepunkt = 10 mm/m
** Max. Gesamtporenvolumen = 1000 mm/m
** Max. Feldkapazität = 0,95 * Gesamtporenvolumen
** Max. Welkepunkt = 0,95 * Feldkapazität
Bodentyp:
* <code>BodenTypAenderung</code>: Änderung des Bodentyps (Sand/Schluff/Ton). Default: <code>0</code><br/>Mit diesem Parameter lassen sich alle Bodentypen einheitlich um eine oder mehrere Stufen hoch- oder runtersetzen. Erlaubte Werte sind <code>-2</code> bis <code>2</code>.
Weitere Parameter:
* <code>GPVThresholdReduction</code>: Faktor für den Schwellwert der Bodenfeuchte, ab dem der Zufluss in den Boden aus einem oberhalb liegenden Einzusgebiet gedrosselt wird. Die Drosselung fängt mit 0% an bei WP und steigt linear auf 100% bei <code>GPV * Faktor</code>. Nur relevant, wenn <code>SoilInterconnected</code> in der [[Special:MyLanguage/ALL-Datei|ALL-Datei]] aktiviert ist. (''Ab Version 3.1.1.8'')

===<code>[TRS]</code>=== 


* <code>MAXNKM</code>: (Erklärung eingeben), 6 = <span style="color:red">???</span>

===<code>[SNOW]</code>=== 


* <code>T_GRZ_SCHNEE</code>: Grenztemperatur für Schneebildung [°C], default: 0
* <code>T_GRZ_ABBAU</code>: Grenztemperatur für Schneeabbau [°C], default: -1
* <code>T_SMELT</code>: Temperaturabhängige Schmelzrate [mm/(°C*d)], default: 1.8
* <code>R_SMELT</code>: Strahlungs u. Bodenwärme abhängige Schmelzrate [mm/d], default: 4.2
* <code>DENSITY_GRZ</code>: Grenzdichte Schnee [kg/m³], default: 40
* <code>DENSITY_NEW</code>: Neuschneedichte [kg/m³], default: 11

===<code>[PRECIP]</code>=== 


* <code>DVWK_DELTA</code>: (Erklärung eingeben), 0.2 = <span style="color:red">???</span>

===<code>[RESULT]</code>=== 

Debug-Ausgaben


* <code>TSTOUT</code>:
* <code>BFOUT</code>: Wenn <code>1</code>, wird im Verzeichnis der talsim.exe ein Datei <code>TSTBF.TMP</code> mit detaillierter Debug-Ausgabe der Bodenfeuchteberechnung ausgegeben.
* <code>EFLOUT</code>:
* <code>TRSKNLOUT</code>:
* <code>HYAOUT</code>:
* <code>TALOUT</code>:
* <code>BFFKTOUT</code>:
* <code>SPEIOUT</code>:
* <code>SNOWOUT</code>:
* <code>ELEMOUT</code>:
* <code>KTROUT</code>:
* <code>SIMSTEPMSG</code>:

</translate>

KAL-Datei

2022-09-14T15:16:21Z

HubertLohr:

<languages/>
<translate>


{{ASCII-Datensatz}}


__TOC__
Die KAL-Datei dient zur Angabe von globalen Kalibrierungsfaktoren.

==Beispiel== 


<pre>
#SYDROTAL-INI
#START
[EZG]
EFL_AggregationAll=N
EZG_LnzDeltaProz=0.0
KF_Toleranz_mmh=0.0
EFL_AeMinProz=0.0
[EZGKALIB]
RetKonFakUrb=1
RetKonFakNat=1
RetKonFakInt=4
RetKonFakInt2=1
RetKonFakBas=6
RetKonFakBas2=2
NKasInt=3
NKasInt2=3
NKasBas=3
GWShare=0.9
[BF]
BF_CALC_OPTION=0
BF_CALC_STAU=0
BF_CALC_POTINF=0
[BFKALIB]
MaxInf=0.1
Schicht1kfExx=1.0
Schicht1kfEXXJGG=0
0.6 0.7 0.8 0.9 1.0 2.0 3.0 3.0 2.0 1.5 0.8 0.7
Schicht2kfExx=1.0
Schicht2kfEXXJGG=0
0.6 0.7 0.8 0.9 1.0 2.0 3.0 3.0 2.0 1.5 0.8 0.7
Schicht3kfExx=1.0
Schicht3kfEXXJGG=0
0.6 0.7 0.8 0.9 1.0 2.0 3.0 3.0 2.0 1.5 0.8 0.7
Schicht1kfInt=1.0
Schicht1kfINTJGG=0
0.6 0.7 0.8 0.9 1.0 2.0 3.0 3.0 2.0 1.5 0.8 0.7
Schicht2kfInt=1.0
Schicht2kfINTJGG=0
0.6 0.7 0.8 0.9 1.0 2.0 3.0 3.0 2.0 1.5 0.8 0.7
BF0=1.0
WP=1.0
NFK=1.0
LK=1.0
GPVThresholdReduction=1.0
[TRS]
MAXNKM=6
[SNOW]
T_GRZ_SCHNEE=0
T_GRZ_ABBAU=-1
T_SMELT=1.8
R_SMELT=4.2
DENSITY_GRZ=40
DENSITY_NEW=11
[PRECIP]
DVWK_DELTA=0.2
[RESULT]
TSTOUT=0
BFOUT=0
EFLOUT=0
TRSKNLOUT=0
HYAOUT=0
TALOUT=0
BFFKTOUT=0
SPEIOUT=0
SNOWOUT=0
ELEMOUT=0
KTROUT=0
SIMSTEPMSG=0
</pre>

==Erläuterungen== 

===<code>[EZG]</code>=== 


* <code>EFL_AggregationAll</code>: Aggregation über alle EFLs (<code>J/N</code>). Default: <code>N</code>
* <code> EZG_LnzDeltaProz</code>: erlaubte Abweichung von Lnz-Parametern in Prozent zur EFL Aggregation. Default: <code>0.0</code>
* <code>KF_Toleranz_mmh</code>: kF-Wert Toleranz für Aggregation von EFLs. Default: <code>0.0</code>
* <code>EFL_AeMinProz</code>: Grenzwert des Flächenanteils für die Aggregation von EFLs. Default: <code>0.0</code>

===<code>[EZGKALIB]</code>=== 

Parameter für die Retention in Einzugsgebieten


* <code>RetKonFakUrb</code>: Faktor für die Retentionskonstanten der versiegelten Flächen <code>K(VG)</code>
* <code>RetKonFakNat</code>: Faktor für die Retentionskonstanten des natürlichen Oberflächenabflusses <code>K1</code> und <code>K2</code>
* <code>RetKonFakInt</code>: Faktor für die Retentionskonstanten des Interflows <code>KInt</code>
* <code>RetKonFakInt2</code>: Faktor für die Retentionskonstanten des tiefen Interflows <code>KInt2</code>
* <code>RetKonFakBas</code>: Faktor für die Retentionskonstanten des Basisabflusses <code>KBas</code>
* <code>RetKonFakBas2</code>: Faktor für die Retentionskonstanten des tiefen Basisabflusses <code>KBas2</code>
* <code>NKasInt</code>: Anzahl Kaskaden für den Interflow
* <code>NKasInt2</code>: Anzahl Kaskaden für den tiefen Interflow
* <code>NKasBas</code>: Anzahl Kaskaden für den Basisabfluss

===<code>[BF]</code>=== 


* <code>BF_CALC_OPTION</code>: (Erklärung eingeben), 0 = <span style="color:red">???</span>
* <code>BF_CALC_STAU</code>: (Erklärung eingeben), 0 = <span style="color:red">???</span>
* <code>BF_CALC_POTINF</code>: (Erklärung eingeben), 0 = <span style="color:red">???</span>

===<code>[BFKALIB]</code>=== 


kf-Werte:
* <code>MaxInf</code>: Faktor für die maximale Infiltration maxInf
* <code>Schicht1kfExx</code>: Faktor für den kf-Wert für die Exfiltration aus Simulationsschicht 1
* <code>Schicht1kfEXXJGG</code>: Monatsfaktoren für den kf-Wert für die Exfiltration aus Simulationsschicht 1 (wenn > 0, werden die Monatsfaktoren für Jan-Dez aus der Folgezeile verwendet)
* <code>Schicht2kfExx</code>: Faktor für den kf-Wert für die Exfiltration aus Simulationsschicht 2
* <code>Schicht2kfEXXJGG</code>: Monatsfaktoren für den kf-Wert für die Exfiltration aus Simulationsschicht 2 (wenn > 0, werden die Monatsfaktoren für Jan-Dez aus der Folgezeile verwendet)
* <code>Schicht3kfExx</code>: Faktor für den kf-Wert für die Exfiltration aus Simulationsschicht 3
* <code>Schicht3kfEXXJGG</code>: Monatsfaktoren für den kf-Wert für die Exfiltration aus Simulationsschicht 3 (wenn > 0, werden die Monatsfaktoren für Jan-Dez aus der Folgezeile verwendet)
* <code>Schicht1kfInt</code>: Faktor für den kf-Wert für den Interflow aus Simulationsschicht 1
* <code>Schicht1kfINTJGG</code>: Monatsfaktoren für den kf-Wert für den Interflow aus Simulationsschicht 1 (wenn > 0, werden die Monatsfaktoren für Jan-Dez aus der Folgezeile verwendet)
* <code>Schicht2kfInt</code>: Faktor für den kf-Wert für den Interflow aus Simulationsschicht 2
* <code>Schicht1kfINTJGG</code>: Monatsfaktoren für den kf-Wert für den Interflow aus Simulationsschicht 2 (wenn > 0, werden die Monatsfaktoren für Jan-Dez aus der Folgezeile verwendet)
Bodenparameter:
* <code>BF0</code>: Faktor für BF0 (Anfangsbodenfeuchte). Default: <code>1.0</code>
* <code>WP</code>: Faktor für Welkepunkt. Default: <code>1.0</code>
* <code>NFK</code>: Faktor für nutzbare Feldkapazität (FK - WP). Default: <code>1.0</code>
* <code>LK</code>: Faktor für Luftkapazität (GPV - FK). Default: <code>1.0</code><br/>Aus den Faktoren <code>WP</code>, <code>NFK</code> und <code>LK</code> werden für alle Bodenschichten die Werte für Welkepunkt, Feldkapazität und Gesamtporenvolumen neu berechnet, dabei gelten jedoch folgende Grenzen:
** Min. Welkepunkt = 10 mm/m
** Max. Gesamtporenvolumen = 1000 mm/m
** Max. Feldkapazität = 0,95 * Gesamtporenvolumen
** Max. Welkepunkt = 0,95 * Feldkapazität
Bodentyp:
* <code>BodenTypAenderung</code>: Änderung des Bodentyps (Sand/Schluff/Ton). Default: <code>0</code><br/>Mit diesem Parameter lassen sich alle Bodentypen einheitlich um eine oder mehrere Stufen hoch- oder runtersetzen. Erlaubte Werte sind <code>-2</code> bis <code>2</code>.
Weitere Parameter:
* <code>GPVThresholdReduction</code>: Faktor für den Schwellwert der Bodenfeuchte, ab dem der Zufluss in den Boden aus einem oberhalb liegenden Einzusgebiet gedrosselt wird. Die Drosselung fängt mit 0% an bei WP und steigt linear auf 100% bei <code>GPV * Faktor</code>. Nur relevant, wenn <code>SoilInterconnected</code> in der [[Special:MyLanguage/ALL-Datei|ALL-Datei]] aktiviert ist. (''Ab Version 3.1.1.8'')

===<code>[TRS]</code>=== 


* <code>MAXNKM</code>: (Erklärung eingeben), 6 = <span style="color:red">???</span>

===<code>[SNOW]</code>=== 


* <code>T_GRZ_SCHNEE</code>: Grenztemperatur für Schneebildung [°C], default: 0
* <code>T_GRZ_ABBAU</code>: Grenztemperatur für Schneeabbau [°C], default: -1
* <code>T_SMELT</code>: Temperaturabhängige Schmelzrate [mm/(°C*d)], default: 1.8
* <code>R_SMELT</code>: Strahlungs u. Bodenwärme abhängige Schmelzrate [mm/d], default: 4.2
* <code>DENSITY_GRZ</code>: Grenzdichte Schnee [kg/m³], default: 40
* <code>DENSITY_NEW</code>: Neuschneedichte [kg/m³], default: 11

===<code>[PRECIP]</code>=== 


* <code>DVWK_DELTA</code>: (Erklärung eingeben), 0.2 = <span style="color:red">???</span>

===<code>[RESULT]</code>=== 

Debug-Ausgaben


* <code>TSTOUT</code>:
* <code>BFOUT</code>: Wenn <code>1</code>, wird im Verzeichnis der talsim.exe ein Datei <code>TSTBF.TMP</code> mit detaillierter Debug-Ausgabe der Bodenfeuchteberechnung ausgegeben.
* <code>EFLOUT</code>:
* <code>TRSKNLOUT</code>:
* <code>HYAOUT</code>:
* <code>TALOUT</code>:
* <code>BFFKTOUT</code>:
* <code>SPEIOUT</code>:
* <code>SNOWOUT</code>:
* <code>ELEMOUT</code>:
* <code>KTROUT</code>:
* <code>SIMSTEPMSG</code>:

</translate>

SydroCmd Befehle

2021-03-20T10:16:00Z

HubertLohr:

<languages/>
<translate>


{{Navigation|vorher=SydroCmd-Verzeichnisstruktur und Dateien|hoch=Arbeiten mit dem SydroCmd tool|nachher=Operationeller Einsatz von Talsim-NG}}

==Extract== 


Extracts strings from each line within an ASCII file.


{| class=wikitable
!Argument !! Description
|-
|Key || <code>-extract</code>
|-
|1 || sourcefile
|-
|2 || <code>-string</code>: search for a string
<code>-pos</code>: select a position<br/>
<code>-split</code>: split a string
|-
|3 || either string or position as a number
|-
|4 || <code>-endstring</code>, <code>–endlen</code> or <code>-array</code>
|-
|5 || either a string or the word <code>blank</code> or a position as an integer, depending on the previous argument. With <code>-split</code> a comma-separated list of indices is required indicating which items should be saved.
|-
|6 || targetfile
|}


'''Example 1''': extracts a string from each line within d:\temp\abc.txt which follows directly after "val=" and ends at the next blank.


<pre>
SydroCmd -extract d:\temp\abc.txt -string val= -endstring blank d:\temp\extract.txt
</pre>


'''Example 2''': extracts a string from each line within d:\temp\abc.txt starting from position 15 with a length of 25 characters.


<pre>
SydroCmd -extract d:\temp\abc.txt -pos 15 -endlen 25 d:\temp\extract.txt
</pre>

==Download== 


Downloads a file with a valid URL to the local machine.


{| class=wikitable
! Argument !! Description
|-
|Key || <code>-download</code> or <code>-downloadwget</code> (the latter causes [https://www.gnu.org/software/wget/ wget] to be used for downloading)
|-
|1||URL (possibly with placeholders like <code>{0}</code>)
|-
|2||Arguments separated by a comma filling the placeholders in the URL
|-
|3 || targetfile
|}


'''Example:''' Downloads a file from the NOAA data archive. Variables are the year, month, day.


<pre>
SydroCmd -download http://nomads.ncdc.noaa.gov/modeldata/cfsv2_forecast_mm_9mon/{0}/{0}{1}/{0}{1}{2}/{0}{1}{2}00/flxf.01.{0}{1}{2}00.{3}{4}.avrg.grib.grb2 2016,12,02,2016,12 D:\temp\tmp.grb2
</pre>

==Replace== 


Replaces all strings with a new string within a file. Is able to handle current date information.


{| class=wikitable
! Argument !! Description
|-
|Key || <code>-replace</code>
|-
|1||sourcefile
|-
|2||search string or <code>DATE</code>
|-
|3||replace string or a date in the format <code>yyyyMMddHHmm</code> or <code>Now</code>
|-
|4||targetfile (if not given, then sourcefile will be overwritten)
|}

===Date replacement=== 


If the search string is the keyword <code>DATE</code>, dynamic date replacement takes place:
* The replace string must then be a date in the format <code>yyyyMMddHHmm</code> or <code>Now</code>.
* In the sourcefile, the placeholder to be replaced must be given as follows: <code>{DATE|ValidFormatstring|ValidNumber,DateInterval}</code>, where
** ValidFormatstring: a date format string consisting of e.g. yyyy, MM, dd, HH, mm (see [https://docs.microsoft.com/en-us/dotnet/standard/base-types/custom-date-and-time-format-strings here] for more options)
** ValidNumber: 0, +2, -5 or any other integer (adds/subtracts the number of years, months, days, hours, minutes as given with the number)
** DateIntervall= y, M, d, h, m (is used to add the ValidNumber to the date)
:Example: <code>{DATE|dd|+1,d}</code> with a replace date of 30/12/2017 results in <code>31</code> (given date + 1 day, expressed as date (<code>dd</code>)).

===Examples=== 


'''Example 1''': simple replacement of "hello" with "goodbye". The sourcefile will be overwritten.
<pre>
SydroCmd –replace d:\temp\abc.txt hello goodbye
</pre>


'''Example 2''': with date information


In this example the first argument is the keyword <code>DATE</code> indicating that date information is used. If this string is found it will be replaced by the date given in the next argument (here 5/12/2016 00:00). In the file abc.txt the variable to be replaced must be given as follows: <code>{DATE|yyyy|+1,y}</code>. This means the result will be <code>2017</code>, one year added to 2016.


<pre>
SydroCmd –replace d:\temp\abc.txt DATE 201612050000 d:\temp\abcnew.txt
</pre>


'''Example 2''': with date information using <code>Now</code>


In this example the first argument is the keyword <code>DATE</code> indicating that date information is used. If this string is found it will be replaced by the date given in the next argument (here the keyword <code>Now</code>). In the file abc.txt the variable to be replaced must be given as follows: <code>{DATE|yyyyMMdd|+1,M}</code>. This means the result will be the current date plus one month.


<pre>
SydroCmd –replace d:\temp\abc.txt DATE Now d:\temp\abcnew.txt
</pre>

==Zip== 


Compress files to a zip file.


{| class=wikitable
! Argument !! Description
|-
|Key || <code>-zip</code>
|-
|1||source directory
|-
|2||zip filename
|-
|3 || <code>-pattern</code> or <code>–list</code>
|-
|4||the pattern or a comma-separated list
|}


'''Example 1''': Compresses all files in directory d:\temp\ with the extension *.txt to the file myfile.zip
<pre>
SydroCmd –zip d:\temp\ myfile.zip –pattern *.txt
</pre>


'''Example 2''': Compresses a list of files in directory d:\temp\ with the extension *.txt to the file myzipfile.zip


<pre>
SydroCmd -zip d:\temp\ myzipfile.zip -list d:\mylist\file1.txt "d:\many files\newfile.doc"
</pre>

==UnZip== 


Unzips files from a zip file.
{| class=wikitable
! Argument !! Description
|-
|Key || <code>-unzip</code>
|-
|1||source directory
|-
|2||source zip filename
|-
|3 || <code>-pattern</code> or <code>-list</code>
|-
|4||the pattern or a comma-separated list
|}


'''Example 1''': Unzips all files in directory d:\temp\ and zipfile myfile.zip with the pattern *.txt to d:\


<pre>
SydroCmd -unzip d:\ d:\temp\myfile.zip -pattern *.txt
</pre>


'''Example 2''': Unzips a selection of files from d:\temp\ and myzipfile to d:\


<pre>
SydroCmd -unzip d:\ d:\temp\myzipfile.zip -list d:\mylist\file1.txt "d:\any directory\newfile.doc"
</pre>


'''Example 3''': Unzips all files in the zipfile from d:\temp\ and myzipfile to d:\


<pre>
SydroCmd -unzip d:\ d:\temp\myzipfile.zip –pattern *.*
</pre>

==TimeSeries - GET== 


Retrieves a SydroTimeSeries object from the TalsimNGServer via REST interface.


{| class=wikitable border=1 cellspacing=0 cellpadding=0
!Argument!!Description
|-
|Key || timeseries
|-
|1 || <code>-get</code>
|-
|2||Customer name, e.g. <code>Test</code> or <code>KS_Gerstungen</code>
|-
|3||User, e.g. <code>Felix</code>
|-
|4||Id of the time series, e.g. <code>406420</code>
|-
|5||Startdate in <code>yyyy-MM-dd HH:mm</code> format or <code>0</code> for all entries from the beginning
|-
|6||Enddate in <code>yyyy-MM-dd HH:mm</code> format or <code>0</code> for all entries up to the end
|-
|7||Flag to specifiy which data are to be retrieved, e.g. <code>0</code>, <code>1</code>, etc.
|-
|8||Protocol, usually <code>http</code>
|-
|9||IP address, e.g. <code>localhost</code> or <code>10.0.0.5</code>
|-
|10||Port. The default port is <code>8092</code>
|-
|11||Filename. The destination file of the time series, e.g. <code>d:\temp\timeseries.short.txt</code>. '''No blank (space) is allowed in the path and name.'''
|}


'''Example 1''': The file timeseries.short.txt should be fetched from customer KS_Gerstungen. The time series has the Id 406420, the whole time series is desired. Only entries with the flag 0 are wanted. The server is located at 10.0.0.30. The result will be written to d:\temp\timeseries.long.txt.


<pre>
SydroCmd.exe -timeseries -get KS_Gerstungen,hubert,406420,0,0,1,http,10.0.0.30,8092,d:\temp\timeseries.long.txt
</pre>


'''Example 2''': The timeseries with the Id 9998 is needed from customer TestApi.


<pre>
SydroCmd -timeseries -get TestApi,hubert,9998,0,0,-1,http,localhost,8092,d:\temp\timeseries.short.txt
</pre>

==TimeSeries - POST== 


Uploads a SydroTimeSeries object to the TalsimNGServer via REST interface. All settings like Flag, SaveMetadata etc. are given in the SydroTimeSeries object itself.


{| class=wikitable border=1 cellspacing=0 cellpadding=0
!Argument!!Description
|-
|Key || timeseries
|-
|1 || <code>-post</code>
|-
|2||Customer, e.g. <code>Test</code> or <code>KS_Gerstungen</code>
|-
|3||User, e.g. <code>Felix</code>
|-
|4||Id of the time series, e.g. <code>406420</code>
|-
|8||Protocol, usually <code>http</code>
|-
|9||IP address, e.g. <code>localhost</code> or <code>10.0.0.5</code>
|-
|10||Port. The default port is <code>8092</code>
|-
|11||Source filename. The path to the time series file, e.g. <code>d:\temp\timeseries.short.txt</code>. '''No blank (space) is allowed in the path and name.'''
|}


'''Example 1''': The file timeseries.short.txt should be uploaded to customer TestAPI. The time series has the Id 9999 and the file is located at d:\temp\timeseries.short.txt.


<pre>
SydroCmd.exe -timeseries -post TestApi,hubert,9999,http,localhost,8092,d:\temp\timeseries.short.txt
</pre>

==REST Service== 


Calls a REST Service URL to obtain its response.


{| class=wikitable border=1 cellspacing=0 cellpadding=0
!Argument!!Description
|-
|Key || REST
|-
|1 || <code>-rest</code>
|-
|2||Timeout in milliseconds, e.g. <code>10000</code>
|-
|3||Number of requests if a timed out occurs, e.g. <code>2</code>
|-
|4||SaveTo, file where the response will be saved to, e.g. <code>d:\temp\response.txt</code>
|-
|8||Rest URL <code>http://geoglows.ecmwf.int/api/HistoricSimulation/?reach_id=7042350&return_format=csv</code>
|-
|}


'''Example 1''': The GeoGLOWS REST Service is called to retrieve the historic simulation time series for reach_id = 7042350.


<pre>
SydroCmd.exe -rest 10000 2 d:\temp\geoglows.csv "http://geoglows.ecmwf.int/api/HistoricSimulation/?reach_id=7042350&return_format=csv"
</pre>
</translate>

SydroCmd Befehle

2021-03-20T10:13:50Z

HubertLohr:

<languages/>
<translate>


{{Navigation|vorher=SydroCmd-Verzeichnisstruktur und Dateien|hoch=Arbeiten mit dem SydroCmd tool|nachher=Operationeller Einsatz von Talsim-NG}}

==Extract== 


Extracts strings from each line within an ASCII file.


{| class=wikitable
!Argument !! Description
|-
|Key || <code>-extract</code>
|-
|1 || sourcefile
|-
|2 || <code>-string</code>: search for a string
<code>-pos</code>: select a position<br/>
<code>-split</code>: split a string
|-
|3 || either string or position as a number
|-
|4 || <code>-endstring</code>, <code>–endlen</code> or <code>-array</code>
|-
|5 || either a string or the word <code>blank</code> or a position as an integer, depending on the previous argument. With <code>-split</code> a comma-separated list of indices is required indicating which items should be saved.
|-
|6 || targetfile
|}


'''Example 1''': extracts a string from each line within d:\temp\abc.txt which follows directly after "val=" and ends at the next blank.


<pre>
SydroCmd -extract d:\temp\abc.txt -string val= -endstring blank d:\temp\extract.txt
</pre>


'''Example 2''': extracts a string from each line within d:\temp\abc.txt starting from position 15 with a length of 25 characters.


<pre>
SydroCmd -extract d:\temp\abc.txt -pos 15 -endlen 25 d:\temp\extract.txt
</pre>

==Download== 


Downloads a file with a valid URL to the local machine.


{| class=wikitable
! Argument !! Description
|-
|Key || <code>-download</code> or <code>-downloadwget</code> (the latter causes [https://www.gnu.org/software/wget/ wget] to be used for downloading)
|-
|1||URL (possibly with placeholders like <code>{0}</code>)
|-
|2||Arguments separated by a comma filling the placeholders in the URL
|-
|3 || targetfile
|}


'''Example:''' Downloads a file from the NOAA data archive. Variables are the year, month, day.


<pre>
SydroCmd -download http://nomads.ncdc.noaa.gov/modeldata/cfsv2_forecast_mm_9mon/{0}/{0}{1}/{0}{1}{2}/{0}{1}{2}00/flxf.01.{0}{1}{2}00.{3}{4}.avrg.grib.grb2 2016,12,02,2016,12 D:\temp\tmp.grb2
</pre>

==Replace== 


Replaces all strings with a new string within a file. Is able to handle current date information.


{| class=wikitable
! Argument !! Description
|-
|Key || <code>-replace</code>
|-
|1||sourcefile
|-
|2||search string or <code>DATE</code>
|-
|3||replace string or a date in the format <code>yyyyMMddHHmm</code> or <code>Now</code>
|-
|4||targetfile (if not given, then sourcefile will be overwritten)
|}

===Date replacement=== 


If the search string is the keyword <code>DATE</code>, dynamic date replacement takes place:
* The replace string must then be a date in the format <code>yyyyMMddHHmm</code> or <code>Now</code>.
* In the sourcefile, the placeholder to be replaced must be given as follows: <code>{DATE|ValidFormatstring|ValidNumber,DateInterval}</code>, where
** ValidFormatstring: a date format string consisting of e.g. yyyy, MM, dd, HH, mm (see [https://docs.microsoft.com/en-us/dotnet/standard/base-types/custom-date-and-time-format-strings here] for more options)
** ValidNumber: 0, +2, -5 or any other integer (adds/subtracts the number of years, months, days, hours, minutes as given with the number)
** DateIntervall= y, M, d, h, m (is used to add the ValidNumber to the date)
:Example: <code>{DATE|dd|+1,d}</code> with a replace date of 30/12/2017 results in <code>31</code> (given date + 1 day, expressed as date (<code>dd</code>)).

===Examples=== 


'''Example 1''': simple replacement of "hello" with "goodbye". The sourcefile will be overwritten.
<pre>
SydroCmd –replace d:\temp\abc.txt hello goodbye
</pre>


'''Example 2''': with date information


In this example the first argument is the keyword <code>DATE</code> indicating that date information is used. If this string is found it will be replaced by the date given in the next argument (here 5/12/2016 00:00). In the file abc.txt the variable to be replaced must be given as follows: <code>{DATE|yyyy|+1,y}</code>. This means the result will be <code>2017</code>, one year added to 2016.


<pre>
SydroCmd –replace d:\temp\abc.txt DATE 201612050000 d:\temp\abcnew.txt
</pre>


'''Example 2''': with date information using <code>Now</code>


In this example the first argument is the keyword <code>DATE</code> indicating that date information is used. If this string is found it will be replaced by the date given in the next argument (here the keyword <code>Now</code>). In the file abc.txt the variable to be replaced must be given as follows: <code>{DATE|yyyyMMdd|+1,M}</code>. This means the result will be the current date plus one month.


<pre>
SydroCmd –replace d:\temp\abc.txt DATE Now d:\temp\abcnew.txt
</pre>

==Zip== 


Compress files to a zip file.


{| class=wikitable
! Argument !! Description
|-
|Key || <code>-zip</code>
|-
|1||source directory
|-
|2||zip filename
|-
|3 || <code>-pattern</code> or <code>–list</code>
|-
|4||the pattern or a comma-separated list
|}


'''Example 1''': Compresses all files in directory d:\temp\ with the extension *.txt to the file myfile.zip
<pre>
SydroCmd –zip d:\temp\ myfile.zip –pattern *.txt
</pre>


'''Example 2''': Compresses a list of files in directory d:\temp\ with the extension *.txt to the file myzipfile.zip


<pre>
SydroCmd -zip d:\temp\ myzipfile.zip -list d:\mylist\file1.txt "d:\many files\newfile.doc"
</pre>

==UnZip== 


Unzips files from a zip file.
{| class=wikitable
! Argument !! Description
|-
|Key || <code>-unzip</code>
|-
|1||source directory
|-
|2||source zip filename
|-
|3 || <code>-pattern</code> or <code>-list</code>
|-
|4||the pattern or a comma-separated list
|}


'''Example 1''': Unzips all files in directory d:\temp\ and zipfile myfile.zip with the pattern *.txt to d:\


<pre>
SydroCmd -unzip d:\ d:\temp\myfile.zip -pattern *.txt
</pre>


'''Example 2''': Unzips a selection of files from d:\temp\ and myzipfile to d:\


<pre>
SydroCmd -unzip d:\ d:\temp\myzipfile.zip -list d:\mylist\file1.txt "d:\any directory\newfile.doc"
</pre>


'''Example 3''': Unzips all files in the zipfile from d:\temp\ and myzipfile to d:\


<pre>
SydroCmd -unzip d:\ d:\temp\myzipfile.zip –pattern *.*
</pre>

==TimeSeries - GET== 


Retrieves a SydroTimeSeries object from the TalsimNGServer via REST interface.


{| class=wikitable border=1 cellspacing=0 cellpadding=0
!Argument!!Description
|-
|Key || timeseries
|-
|1 || <code>-get</code>
|-
|2||Customer name, e.g. <code>Test</code> or <code>KS_Gerstungen</code>
|-
|3||User, e.g. <code>Felix</code>
|-
|4||Id of the time series, e.g. <code>406420</code>
|-
|5||Startdate in <code>yyyy-MM-dd HH:mm</code> format or <code>0</code> for all entries from the beginning
|-
|6||Enddate in <code>yyyy-MM-dd HH:mm</code> format or <code>0</code> for all entries up to the end
|-
|7||Flag to specifiy which data are to be retrieved, e.g. <code>0</code>, <code>1</code>, etc.
|-
|8||Protocol, usually <code>http</code>
|-
|9||IP address, e.g. <code>localhost</code> or <code>10.0.0.5</code>
|-
|10||Port. The default port is <code>8092</code>
|-
|11||Filename. The destination file of the time series, e.g. <code>d:\temp\timeseries.short.txt</code>. '''No blank (space) is allowed in the path and name.'''
|}


'''Example 1''': The file timeseries.short.txt should be fetched from customer KS_Gerstungen. The time series has the Id 406420, the whole time series is desired. Only entries with the flag 0 are wanted. The server is located at 10.0.0.30. The result will be written to d:\temp\timeseries.long.txt.


<pre>
SydroCmd.exe -timeseries -get KS_Gerstungen,hubert,406420,0,0,1,http,10.0.0.30,8092,d:\temp\timeseries.long.txt
</pre>


'''Example 2''': The timeseries with the Id 9998 is needed from customer TestApi.


<pre>
SydroCmd -timeseries -get TestApi,hubert,9998,0,0,-1,http,localhost,8092,d:\temp\timeseries.short.txt
</pre>

==TimeSeries - POST== 


Uploads a SydroTimeSeries object to the TalsimNGServer via REST interface. All settings like Flag, SaveMetadata etc. are given in the SydroTimeSeries object itself.


{| class=wikitable border=1 cellspacing=0 cellpadding=0
!Argument!!Description
|-
|Key || timeseries
|-
|1 || <code>-post</code>
|-
|2||Customer, e.g. <code>Test</code> or <code>KS_Gerstungen</code>
|-
|3||User, e.g. <code>Felix</code>
|-
|4||Id of the time series, e.g. <code>406420</code>
|-
|8||Protocol, usually <code>http</code>
|-
|9||IP address, e.g. <code>localhost</code> or <code>10.0.0.5</code>
|-
|10||Port. The default port is <code>8092</code>
|-
|11||Source filename. The path to the time series file, e.g. <code>d:\temp\timeseries.short.txt</code>. '''No blank (space) is allowed in the path and name.'''
|}


'''Example 1''': The file timeseries.short.txt should be uploaded to customer TestAPI. The time series has the Id 9999 and the file is located at d:\temp\timeseries.short.txt.


<pre>
SydroCmd.exe -timeseries -post TestApi,hubert,9999,http,localhost,8092,d:\temp\timeseries.short.txt
</pre>

==REST Service== 


Calls a REST Service URL to obtain its response.


{| class=wikitable border=1 cellspacing=0 cellpadding=0
!Argument!!Description
|-
|Key || REST
|-
|1 || <code>-rest</code>
|-
|2||Timeout in milliseconds, e.g. <code>10000</code>
|-
|3||Number of requests if timed out, e.g. <code>2</code>
|-
|4||SaveTo, file where the response will be saved to, e.g. <code>d:\temp\response.txt</code>
|-
|8||Rest URL <code>http://geoglows.ecmwf.int/api/HistoricSimulation/?reach_id=7042350&return_format=csv</code>
|-
|}


'''Example 1''': The GeoGLOWS REST Service is called to retrieve the historic simulation time series for reach_id = 7042350.


<pre>
SydroCmd.exe -rest 10000 2 d:\temp\geoglows.csv "http://geoglows.ecmwf.int/api/HistoricSimulation/?reach_id=7042350&return_format=csv"
</pre>
</translate>

Server-API

2019-10-25T14:16:24Z

HubertLohr: /* HttpZreSrv (spezielle Services) */

<div class="achtung">Die Server-API befindet sich noch in der Entwicklungsphase, Änderungen sind zu erwarten</div>

Die Serverkomponente von Talsim-NG ([[TalsimNGSrv]]) bietet eine REST (HTTP) Schnittstelle (API), über die Daten abgerufen und an den Server übermittelt werden können. Daten werden über diese Schnittstelle im XML oder JSON Format ausgetauscht. Im Folgenden wird diese Schnittstelle dokumentiert:
__TOC__
<div class="info">In den unten angegebenen Beispielen wird als Server-Adresse <code>talsim.de</code> verwendet, dies ist mit der Adresse oder IP des tatsächlich verwendeten Talsim-Servers zu ersetzen.</div>
==HttpDataSrv==
Der HttpDataSrv Service dient zur Abfrage von Daten mit Bezug zum System, Systemvarianten, Listen zu Zeitreihen-Ordnern oder Zeitreihen. Der HttpDataSrv ist standardmäßig über den Port 8090 ansprechbar und bietet die folgenden Schnittstellen:
===requestClients===
Generelle Abfrage aller Kunden.

===requestCustomers===
Generelle Abfrage aller Kunden. Identisch zu <code>requestClients</code>

Beispiel: <code><nowiki>http://talsim.de:8090/TalsimNGServer/HttpDataSrv/requestCustomers/|</nowiki></code>
===requestZreDirectories===
Abfrage von Zeitreihen-Ordnern. Es werden Zeitreihen-Ordner mit ihren Zeitreihen zurückgegeben. Parameter sind <code>customer</code> und mit Komma getrennt ein "|".

Beispiel: <code><nowiki>http://talsim.de:8090/TalsimNGServer/HttpDataSrv/requestZreDirectories/Nile,|</nowiki></code>
===ZreDirectories===
Abfrage von Zeitreihen-Ordnern. Es werden nur Zeitreihen-Ordner zurückgegeben. Parameter sind <code>customer</code> und mit Komma getrennt ein "|".

Beispiel: <code><nowiki>http://talsim.de:8090/TalsimNGServer/HttpDataSrv/ZreDirectories/Nile,|</nowiki></code>

===requestZreFiles===
Abfrage von vorhandenen Zeitreihen. Parameter sind <code>customer</code>, <code>user</code> sowie die ID des Zeitreihen-Ordners. Ist die ID des Zeitreihen-Ordners 0, werden alle Zeitreihen zurückgegeben.

Beispiel: <code><nowiki>http://talsim.de:8090/TalsimNGServer/HttpDataSrv/requestZreFiles/Nile,hubert,16</nowiki></code>
===requestSystemAndSysVar===
Abfrage von Systemen und Systemvarianten

Beispiel: <code><nowiki>http://talsim.de:8090/TalsimNGServer/HttpDataSrv/requestSystemAndSysVar/WFP_SSD,hubert,1</nowiki></code>
==HttpZreSrv==
HttpZreSrv ist der zentrale Service zur Interaktion mit Zeitreihen. Der HttpZreSrv ist standardmäßig über den Port 8092 ansprechbar. Es gibt folgende Schnittstellen, um auf Zeitreihen und deren Metadaten zuzugreifen:

===SydroTimeSeries===
Abfrage einer Zeitreihe

Als Parameter sind zu übergeben <code>Customer</code>, <code>User</code>, <code>Id</code> der Zeitreihe, Weitere Parameter sind aktuell noch ein SQL Statement <code>SQLCriteria</code> oder alternativ drei Parameter als <code>Startdate</code>, <code>Enddate</code> und <code>AttributeFlag</code>. Das SQL Statement ist momentan nur zum Testen aktiviert und wird wenn alle anderen Endpoints gesetzt sind wieder eingestellt.
Wenn Startdate und Enddate mit <code>0</code> angegeben werden, wird die gesamte Zeitreihe gelesen. Um nur einen Teil der Zeitreihe zu bekommen, können Anfang und/oder Ende mit Datumsformat <code>yyyy-MM-dd HH:mm</code> (z.B. <code>2010-08-15 08:00</code>) angegeben werden.

Beispiel 1: <code><nowiki>http://talsim.de:8092/TalsimNGServer/HttpZreSrv/SydroTimeSeries/TestAPI,MusterUser,9999,attribFlag=0</nowiki></code>

===SydroTimeSeries/combine===
Kombinieren von zwei Zeitreihen. Dies ist zum Beispiel sinnvoll, um eine Messzeitreihe mit Vorhersagedaten zu kombinieren.

Als Parameter sind zu übergeben <code>customer</code>, <code>user</code>, <code>id1</code>, <code>id2</code>,<code>startdate1</code>, <code>endstartdate</code>, <code>enddate2</code>, <code>flag1</code>,<code>flag2</code>. <code>Id1</code> bezieht sich auf die erste Zeitreihe und <code>Id2</code> auf die Reihe, welche angehängt wird. <code>Startdate1</code> definiert wo die erste Zeitreihe anfangen soll, <code>endstartdate</code> wo diese aufhöhrt und die zweite beginnen soll und <code>enddate2</code> das Enddatum der zweiten Reihe. Ist <code>enddate2</code> 0 oder leer wird bis zum Ende der zweiten Zeitreihe gelesen.

Beispiel 1: <code><nowiki>http://talsim.de:8092/TalsimNGServer/HttpZreSrv/SydroTimeSeries/combine/TestAPI,MusterUser,9999,8888,2019-02-01 00:00,2019-10-01 00:00, 0,0</nowiki></code>

===SydroTimeSeries===
Erstellen einer neuen Zeitreihen oder Überschreiben einer bestehenden Zeitreihe

Wird ein POST Aufruf mit dem SydroTimeSeries Objekt gestartet, kann eine Zeitreihe neu erstellt oder eine bestehende überschrieben werden. Soll eine bestehende Zeitreihe überschrieben oder ergänzt werden, muss das Attribute <code>ID</code> gesetzt sein. Soll eine neue Zeitreihen angelegt werden, muss <code>ID</code> gleich 0 sein. Das Objekt SydroTimeSeries besitzt folgende Struktur:

<pre>
<SydroTimeSeries>
<Attribute> (short)
<Customer> (string)
<DateValuePairSeparator> (string) shows how Date/Value Pairs in TimeSeriesString can be split
<ErrorValue> (double) Indicator what is an error value, will be replaced by NaN.
<HasError> (boolean) shows if an error occured during processing the request
<Id> (Integer) ID of time series. If ID=0 when POST is performed a new time series will be created and the new ID will be returned
<Length> (integer) Number or records in the TimeSeriesString
<Lat> (double) Latitude coordinate
<Lon> (double) Longitude coordinate
<Name> (string) Short name of the time series
<Path> (string) Path to the time series on the server
<ResultMsg> (string) Plain text describing errors if any or return a success message
<SaveMetadata> (boolean) Indicates whether or not metadata should be updated when posting time series values <Separator> (string) indicates how date/values can be split
<StationId> (integer) ID of the station
<TimeSeriesHeader> (string) Indicates how one time series entry must be interpreted, e.g. "Date,Value,Flag" if one entry has date/value/flag attributes.
<TimeSeriesString> (string) This is the time series as text, where date/values are separated by the attribute <Separator> and entries are separated by <DateValuePairSeparator>
Example: <TimeSeriesString>2001-01-01 00:00:00,3.106106,0#2001-01-02 00:00:00,4.209204,0#2001-01-03 00:00:00,0.1453788,#2002-01-02 00:00:00,0,0</TimeSeriesString>
<TsClass> (short) Represents the time series class with -1= unknown, 0=Default, 1=Flagged, 2=Forecast
<Unit> (string) gives the unit string, e.g. mm or m3/s
<User>Name of the user requesting or posting the time series or the owner of the time series.
</SydroTimeSeries>
</pre>

===SydroTimeSeries/process===
Eine zweite Art eine Zeitreihe zu erstellen bzw. hochzuladen, ist durch <code>process</code> gegeben.

In diesem Fall sind aber mehrere Interaktionen mit dem Server erforderlich, die nur per Software sinnvoll sind. Parameter sind <code>customer</code>, <code>user</code>, <code>id</code>, <code>SydroTimeSeriesFile</code>. Der Parameter <code>SydroTimeSeriesFile</code> ist eine Datei mit dem Inhalt eines SydroTimeSeries Objektes, welches vor dem Aufruf per Streaming in Kommunikation mit dem Server auf den Server hochgeladen werden muss. Dies erfordert das <code>TalsimNGZreClient</code> Modul, welches in eine Software integriert werden muss. Das Werkzeug <code>SydroCmd</code> besitzt die Fähigkeit, Dateien hochzuladen und ist deshalb für den operationellen Einsatz mit dem TalsimNGServer geeignet. Nach dem Aufruf sorgt der Server für die Verarbeitung der Datei und liefert eine Meldung zurück, dass der Prozess gestartet wurde. Es gibt keine Erfolgsmeldung, da der Server diesen Prozess asynchron in einem Thread verarbeitet.

Beispiel 1: <code><nowiki>http://talsim.de:8092/TalsimNGServer/HttpZreSrv/SydroTimeSeries/process/TestAPI,MusterUser,9999,..serververzeichnis/file.sydrots</nowiki></code>

===SydroTimeSeries/delete===
Löschen einer Zeitreihe.

Als Parameter sind zu übergeben <code>Customer</code>, <code>User</code>, <code>Id</code>. Es gibt kein Undo zu diesem Vorgang.

===SydroTimeSeries/deleteRecords===
Löschen von Einträgen in einer Zeitreihe.

Als Parameter sind zu übergeben <code>Customer</code>, <code>User</code>, <code>Id</code>, <code>Startdate</code>, <code>Enddate</code> und <code>AttributeFlag</code>. Gelöscht werden die Einträge, die zwischen <code>Startdate</code> und <code>Enddate</code> liegen und den <code>AttributeFlag</code> besitzen.

===SydroTimeSeries/attributes===
Abfrage oder Setzen von Metadaten zu einer Zeitreihe

Werden als Parameter <code>Customer</code>, <code>User</code>, <code>Id</code> übergeben, erhält man als Antwort einen String im Format FeldName=Wert getrennt durch "#" Zeichen, der alle Metadaten der Zeitreihe zeigt. Wird zusätzlich ein weiterer Parameter <code>KeyValuePairs</code> übergeben, so setzt man Metadaten. Der String KeyValuePairs muss im Format Feldname=Wert getrennt durch "#" angegeben sein. Die gegebenen Eigenschaften werden gespeichert, vorausgesetzt es handelt sich nicht um geschützte Felder.

Alternativ kann auch mittels POST ein SydroTimeSeriesAttributes Objekt gesendet werden, welches die zu schreibenden Eigenschaften beinhaltet.

===SydroTimeSeries/attributes/fieldnames===
Dieser Aufruf gibt alle Feldnamen der Metadaten getrennt durch Komma zurück.

===SydroTimeSeries/fieldnames===
Dieser Aufruf gibt alle Feldnamen der Zeitreihentabelle getrennt durch Komma zurück.

===SydroTimeSeries/flags===
Mit diesem Aufruf erhält man alle in der Zeitreihe verwendeten Flags. Erforderliche Parameter sind <code>Customer</code>, <code>User</code>, <code>Id</code>

===SydroTimeSeries/class===
Mit diesem Aufruf erhält man die Klasse einerZeitreihe, also -1= unknown, 0=Default, 1=Flagged, 2=Forecast. Erforderliche Parameter sind <code>Customer</code>, <code>User</code>, <code>Id</code>

==HttpZreSrv (spezielle Services)==
Zusätzlich zu den oben erwähnten REST Schnittstellen gibt es noch drei Sonderschnittstellen.

1. Abfrage des Arbeitsverzeichnisses des <code>users</code> (wichtig für das Hochladen von Dateien)

2. Synchronisierung eines <code>customers</code> (Abgleich aller Metadaten zwischen Master-Datenbank und allen Zeitreihen)

3. Konvertierung von Sydro Binar Dateien in Sydro SQLite Dateien für einen <code>customer</code> (normalerweise einmaliger Vorgang bei der Umstellung auf SQLite)

Die Synchronisierung wird der Server regelmässig zu bestimmten Uhrzeiten selbständig vornehmen. Da diese Schnittstellen nicht zur normalen Benutzung vorgesehen sondern Bestandteil der Sydro Serivices im Operationellen Betrieb sind, erfolgt keine weitere Beschreibung des Aufrufs.

===Reports===
Abfrage eines Berichts zur Synchronisierung bzw. Konvertierung.

Sowohl zur Synchronisierung als auch zur Konvertierung werden Berichte vom Server erstellt, die man abrufen kann. Parameter sind <code>Customer</code>, <code>User</code>, <code>date</code>, <code>TypeOfReport</code>. <code>date</code> kann angegeben werden, um einen Bericht für einen bestimmten Tag zu erhalten. ist <code>date</code> 0 oder leer wird der aktuellste Bericht zurückgegeben. <code>TypeOfReport</code> ist entweder <code>SynchronizeLog</code> oder <code>ConvertLog</code>.

==HttpZreSrv (alte Schnittstelle)==
Alte Schnittstellen.

Der Service besitzt weitere Schnittstellen, die aus Gründen der Kompatibilität bestehen bleiben und zum Austausch von Sydro Binär Dateien dienen, teilweise aber bereits das neue SydroTimeSeries Objekt verwenden.

===requestSydroTimeSeries===
Abfrage einer Zeitreihe (neues SydroTimeSeries Objekt)

Als Parameter sind zu übergeben <code>Customer</code>, <code>User</code>, <code>Id</code> der Zeitreihe, <code>Startdate</code>, <code>Enddate</code> und <code>Separator</code> (Trennzeichen für den CSV-Inhalt).

===requestSydroTimeSeries===
Abfrage einer Zeitreihe

Als Parameter sind zu übergeben <code>Customer</code>, <code>User</code>, <code>Id</code> der Zeitreihe, <code>Startdate</code>, <code>Enddate</code> und <code>Separator</code> (Trennzeichen für den CSV-Inhalt)

Wenn Startdate und Enddate mit <code>0</code> angegeben werden, wird die gesamte Zeitreihe gelesen. Um nur einen Teil der Zeitreihe zu bekommen, können Anfang und/oder Ende mit Datumsformat <code>dd.MM.yyyy HH:mm</code> (z.B. <code>01.01.2010 00:00</code>) oder <code>yyyyMMddHHmm</code> (z.B. <code>201001010000</code>) angegeben werden.

Beispiel: <code><nowiki>http://talsim.de:8092/TalsimNGServer/HttpZreSrv/requestSydroTimeSeries/CSV/UNDP_Kura,Kura,318,0,0,comma</nowiki></code>

===postTimeSeriesValues===
Setzen von Zeitreihenwerten (POST)

Beispiel: <code><nowiki>http://10.0.0.5:8092/TalsimNGServer/HttpZreSrv/postTimeSeriesValues</nowiki></code><br/>
Post data (raw text):
<source lang="xml" gutter="false">
<SydroTimeSeries>
<Client>UNDP_Kura</Client>
<Id>318</Id>
<Length>427</Length>
<Name>GE.Iori</Name>
<ResultMsg></ResultMsg>
<StationId>21</StationId>
<TimeSeriesString>
1975-01-01 00:00:00,0.09
1975-02-01 00:00:00,0.1
1975-03-01 00:00:00,0.3
1975-04-01 00:00:00,0.99
1975-05-01 00:00:00,1.19
1975-06-01 00:00:00,0.58
1975-07-01 00:00:00,0.22
1975-08-01 00:00:00,0.11
1975-09-01 00:00:00,0.09
1975-10-01 00:00:00,0.1
</TimeSeriesString>
</SydroTimeSeries>
</source>

===requestSydroZreBin===
Beispiel: <code><nowiki>http://talsim.de:8092/TalsimNGServer/HttpZreSrv/requestSydroZreBin/WFP_SSD,hubert,724,201001010000,201201010000,0</nowiki></code>

===refreshSydroZreBin===
Beispiel: <code><nowiki>http://localhost:8092/TalsimNGServer/HttpZreSrv/refreshSydroZreBin/All/WFP_SSD,hubert</nowiki></code>

Server-API

2019-10-25T14:15:47Z

HubertLohr: /* HttpZreSrv (spezielle Services) */

<div class="achtung">Die Server-API befindet sich noch in der Entwicklungsphase, Änderungen sind zu erwarten</div>

Die Serverkomponente von Talsim-NG ([[TalsimNGSrv]]) bietet eine REST (HTTP) Schnittstelle (API), über die Daten abgerufen und an den Server übermittelt werden können. Daten werden über diese Schnittstelle im XML oder JSON Format ausgetauscht. Im Folgenden wird diese Schnittstelle dokumentiert:
__TOC__
<div class="info">In den unten angegebenen Beispielen wird als Server-Adresse <code>talsim.de</code> verwendet, dies ist mit der Adresse oder IP des tatsächlich verwendeten Talsim-Servers zu ersetzen.</div>
==HttpDataSrv==
Der HttpDataSrv Service dient zur Abfrage von Daten mit Bezug zum System, Systemvarianten, Listen zu Zeitreihen-Ordnern oder Zeitreihen. Der HttpDataSrv ist standardmäßig über den Port 8090 ansprechbar und bietet die folgenden Schnittstellen:
===requestClients===
Generelle Abfrage aller Kunden.

===requestCustomers===
Generelle Abfrage aller Kunden. Identisch zu <code>requestClients</code>

Beispiel: <code><nowiki>http://talsim.de:8090/TalsimNGServer/HttpDataSrv/requestCustomers/|</nowiki></code>
===requestZreDirectories===
Abfrage von Zeitreihen-Ordnern. Es werden Zeitreihen-Ordner mit ihren Zeitreihen zurückgegeben. Parameter sind <code>customer</code> und mit Komma getrennt ein "|".

Beispiel: <code><nowiki>http://talsim.de:8090/TalsimNGServer/HttpDataSrv/requestZreDirectories/Nile,|</nowiki></code>
===ZreDirectories===
Abfrage von Zeitreihen-Ordnern. Es werden nur Zeitreihen-Ordner zurückgegeben. Parameter sind <code>customer</code> und mit Komma getrennt ein "|".

Beispiel: <code><nowiki>http://talsim.de:8090/TalsimNGServer/HttpDataSrv/ZreDirectories/Nile,|</nowiki></code>

===requestZreFiles===
Abfrage von vorhandenen Zeitreihen. Parameter sind <code>customer</code>, <code>user</code> sowie die ID des Zeitreihen-Ordners. Ist die ID des Zeitreihen-Ordners 0, werden alle Zeitreihen zurückgegeben.

Beispiel: <code><nowiki>http://talsim.de:8090/TalsimNGServer/HttpDataSrv/requestZreFiles/Nile,hubert,16</nowiki></code>
===requestSystemAndSysVar===
Abfrage von Systemen und Systemvarianten

Beispiel: <code><nowiki>http://talsim.de:8090/TalsimNGServer/HttpDataSrv/requestSystemAndSysVar/WFP_SSD,hubert,1</nowiki></code>
==HttpZreSrv==
HttpZreSrv ist der zentrale Service zur Interaktion mit Zeitreihen. Der HttpZreSrv ist standardmäßig über den Port 8092 ansprechbar. Es gibt folgende Schnittstellen, um auf Zeitreihen und deren Metadaten zuzugreifen:

===SydroTimeSeries===
Abfrage einer Zeitreihe

Als Parameter sind zu übergeben <code>Customer</code>, <code>User</code>, <code>Id</code> der Zeitreihe, Weitere Parameter sind aktuell noch ein SQL Statement <code>SQLCriteria</code> oder alternativ drei Parameter als <code>Startdate</code>, <code>Enddate</code> und <code>AttributeFlag</code>. Das SQL Statement ist momentan nur zum Testen aktiviert und wird wenn alle anderen Endpoints gesetzt sind wieder eingestellt.
Wenn Startdate und Enddate mit <code>0</code> angegeben werden, wird die gesamte Zeitreihe gelesen. Um nur einen Teil der Zeitreihe zu bekommen, können Anfang und/oder Ende mit Datumsformat <code>yyyy-MM-dd HH:mm</code> (z.B. <code>2010-08-15 08:00</code>) angegeben werden.

Beispiel 1: <code><nowiki>http://talsim.de:8092/TalsimNGServer/HttpZreSrv/SydroTimeSeries/TestAPI,MusterUser,9999,attribFlag=0</nowiki></code>

===SydroTimeSeries/combine===
Kombinieren von zwei Zeitreihen. Dies ist zum Beispiel sinnvoll, um eine Messzeitreihe mit Vorhersagedaten zu kombinieren.

Als Parameter sind zu übergeben <code>customer</code>, <code>user</code>, <code>id1</code>, <code>id2</code>,<code>startdate1</code>, <code>endstartdate</code>, <code>enddate2</code>, <code>flag1</code>,<code>flag2</code>. <code>Id1</code> bezieht sich auf die erste Zeitreihe und <code>Id2</code> auf die Reihe, welche angehängt wird. <code>Startdate1</code> definiert wo die erste Zeitreihe anfangen soll, <code>endstartdate</code> wo diese aufhöhrt und die zweite beginnen soll und <code>enddate2</code> das Enddatum der zweiten Reihe. Ist <code>enddate2</code> 0 oder leer wird bis zum Ende der zweiten Zeitreihe gelesen.

Beispiel 1: <code><nowiki>http://talsim.de:8092/TalsimNGServer/HttpZreSrv/SydroTimeSeries/combine/TestAPI,MusterUser,9999,8888,2019-02-01 00:00,2019-10-01 00:00, 0,0</nowiki></code>

===SydroTimeSeries===
Erstellen einer neuen Zeitreihen oder Überschreiben einer bestehenden Zeitreihe

Wird ein POST Aufruf mit dem SydroTimeSeries Objekt gestartet, kann eine Zeitreihe neu erstellt oder eine bestehende überschrieben werden. Soll eine bestehende Zeitreihe überschrieben oder ergänzt werden, muss das Attribute <code>ID</code> gesetzt sein. Soll eine neue Zeitreihen angelegt werden, muss <code>ID</code> gleich 0 sein. Das Objekt SydroTimeSeries besitzt folgende Struktur:

<pre>
<SydroTimeSeries>
<Attribute> (short)
<Customer> (string)
<DateValuePairSeparator> (string) shows how Date/Value Pairs in TimeSeriesString can be split
<ErrorValue> (double) Indicator what is an error value, will be replaced by NaN.
<HasError> (boolean) shows if an error occured during processing the request
<Id> (Integer) ID of time series. If ID=0 when POST is performed a new time series will be created and the new ID will be returned
<Length> (integer) Number or records in the TimeSeriesString
<Lat> (double) Latitude coordinate
<Lon> (double) Longitude coordinate
<Name> (string) Short name of the time series
<Path> (string) Path to the time series on the server
<ResultMsg> (string) Plain text describing errors if any or return a success message
<SaveMetadata> (boolean) Indicates whether or not metadata should be updated when posting time series values <Separator> (string) indicates how date/values can be split
<StationId> (integer) ID of the station
<TimeSeriesHeader> (string) Indicates how one time series entry must be interpreted, e.g. "Date,Value,Flag" if one entry has date/value/flag attributes.
<TimeSeriesString> (string) This is the time series as text, where date/values are separated by the attribute <Separator> and entries are separated by <DateValuePairSeparator>
Example: <TimeSeriesString>2001-01-01 00:00:00,3.106106,0#2001-01-02 00:00:00,4.209204,0#2001-01-03 00:00:00,0.1453788,#2002-01-02 00:00:00,0,0</TimeSeriesString>
<TsClass> (short) Represents the time series class with -1= unknown, 0=Default, 1=Flagged, 2=Forecast
<Unit> (string) gives the unit string, e.g. mm or m3/s
<User>Name of the user requesting or posting the time series or the owner of the time series.
</SydroTimeSeries>
</pre>

===SydroTimeSeries/process===
Eine zweite Art eine Zeitreihe zu erstellen bzw. hochzuladen, ist durch <code>process</code> gegeben.

In diesem Fall sind aber mehrere Interaktionen mit dem Server erforderlich, die nur per Software sinnvoll sind. Parameter sind <code>customer</code>, <code>user</code>, <code>id</code>, <code>SydroTimeSeriesFile</code>. Der Parameter <code>SydroTimeSeriesFile</code> ist eine Datei mit dem Inhalt eines SydroTimeSeries Objektes, welches vor dem Aufruf per Streaming in Kommunikation mit dem Server auf den Server hochgeladen werden muss. Dies erfordert das <code>TalsimNGZreClient</code> Modul, welches in eine Software integriert werden muss. Das Werkzeug <code>SydroCmd</code> besitzt die Fähigkeit, Dateien hochzuladen und ist deshalb für den operationellen Einsatz mit dem TalsimNGServer geeignet. Nach dem Aufruf sorgt der Server für die Verarbeitung der Datei und liefert eine Meldung zurück, dass der Prozess gestartet wurde. Es gibt keine Erfolgsmeldung, da der Server diesen Prozess asynchron in einem Thread verarbeitet.

Beispiel 1: <code><nowiki>http://talsim.de:8092/TalsimNGServer/HttpZreSrv/SydroTimeSeries/process/TestAPI,MusterUser,9999,..serververzeichnis/file.sydrots</nowiki></code>

===SydroTimeSeries/delete===
Löschen einer Zeitreihe.

Als Parameter sind zu übergeben <code>Customer</code>, <code>User</code>, <code>Id</code>. Es gibt kein Undo zu diesem Vorgang.

===SydroTimeSeries/deleteRecords===
Löschen von Einträgen in einer Zeitreihe.

Als Parameter sind zu übergeben <code>Customer</code>, <code>User</code>, <code>Id</code>, <code>Startdate</code>, <code>Enddate</code> und <code>AttributeFlag</code>. Gelöscht werden die Einträge, die zwischen <code>Startdate</code> und <code>Enddate</code> liegen und den <code>AttributeFlag</code> besitzen.

===SydroTimeSeries/attributes===
Abfrage oder Setzen von Metadaten zu einer Zeitreihe

Werden als Parameter <code>Customer</code>, <code>User</code>, <code>Id</code> übergeben, erhält man als Antwort einen String im Format FeldName=Wert getrennt durch "#" Zeichen, der alle Metadaten der Zeitreihe zeigt. Wird zusätzlich ein weiterer Parameter <code>KeyValuePairs</code> übergeben, so setzt man Metadaten. Der String KeyValuePairs muss im Format Feldname=Wert getrennt durch "#" angegeben sein. Die gegebenen Eigenschaften werden gespeichert, vorausgesetzt es handelt sich nicht um geschützte Felder.

Alternativ kann auch mittels POST ein SydroTimeSeriesAttributes Objekt gesendet werden, welches die zu schreibenden Eigenschaften beinhaltet.

===SydroTimeSeries/attributes/fieldnames===
Dieser Aufruf gibt alle Feldnamen der Metadaten getrennt durch Komma zurück.

===SydroTimeSeries/fieldnames===
Dieser Aufruf gibt alle Feldnamen der Zeitreihentabelle getrennt durch Komma zurück.

===SydroTimeSeries/flags===
Mit diesem Aufruf erhält man alle in der Zeitreihe verwendeten Flags. Erforderliche Parameter sind <code>Customer</code>, <code>User</code>, <code>Id</code>

===SydroTimeSeries/class===
Mit diesem Aufruf erhält man die Klasse einerZeitreihe, also -1= unknown, 0=Default, 1=Flagged, 2=Forecast. Erforderliche Parameter sind <code>Customer</code>, <code>User</code>, <code>Id</code>

==HttpZreSrv (spezielle Services)==
Zusätzlich zu den oben erwähnten REST Schnittstellen gibt es noch drei Sonderschnittstellen.

1. Abfrage des Arbeitsverzeichnisses des <code>users</code> (wichtig für das Hochladen von Dateien)

2. Synchronisierung eines <code>customers</code> (Abgleich aller Metadaten zwischen Master-Datenbank und allen Zeitreihen)

3. Konvertierung von Sydro Binar Dateien in Sydro SQLite Dateien für einen <code>customer</code> (normalerweise einmaliger Vorgang bei der Umstellung auf SQLite)

Die Synchronisierung wird der Server regelmässig zu bestimmten Uhrzeiten selbständig vornehmen. Da diese Schnittstellen nicht zur normalen Benutzung vorgesehen sind, sondern Bestandteil der Sydro Serivices im Operationellen Betrieb sind, erfolgt keine weitere Beschreibung des Aufrufs.

===Reports===
Abfrage eines Berichts zur Synchronisierung bzw. Konvertierung.

Sowohl zur Synchronisierung als auch zur Konvertierung werden Berichte vom Server erstellt, die man abrufen kann. Parameter sind <code>Customer</code>, <code>User</code>, <code>date</code>, <code>TypeOfReport</code>. <code>date</code> kann angegeben werden, um einen Bericht für einen bestimmten Tag zu erhalten. ist <code>date</code> 0 oder leer wird der aktuellste Bericht zurückgegeben. <code>TypeOfReport</code> ist entweder <code>SynchronizeLog</code> oder <code>ConvertLog</code>.

==HttpZreSrv (alte Schnittstelle)==
Alte Schnittstellen.

Der Service besitzt weitere Schnittstellen, die aus Gründen der Kompatibilität bestehen bleiben und zum Austausch von Sydro Binär Dateien dienen, teilweise aber bereits das neue SydroTimeSeries Objekt verwenden.

===requestSydroTimeSeries===
Abfrage einer Zeitreihe (neues SydroTimeSeries Objekt)

Als Parameter sind zu übergeben <code>Customer</code>, <code>User</code>, <code>Id</code> der Zeitreihe, <code>Startdate</code>, <code>Enddate</code> und <code>Separator</code> (Trennzeichen für den CSV-Inhalt).

===requestSydroTimeSeries===
Abfrage einer Zeitreihe

Als Parameter sind zu übergeben <code>Customer</code>, <code>User</code>, <code>Id</code> der Zeitreihe, <code>Startdate</code>, <code>Enddate</code> und <code>Separator</code> (Trennzeichen für den CSV-Inhalt)

Wenn Startdate und Enddate mit <code>0</code> angegeben werden, wird die gesamte Zeitreihe gelesen. Um nur einen Teil der Zeitreihe zu bekommen, können Anfang und/oder Ende mit Datumsformat <code>dd.MM.yyyy HH:mm</code> (z.B. <code>01.01.2010 00:00</code>) oder <code>yyyyMMddHHmm</code> (z.B. <code>201001010000</code>) angegeben werden.

Beispiel: <code><nowiki>http://talsim.de:8092/TalsimNGServer/HttpZreSrv/requestSydroTimeSeries/CSV/UNDP_Kura,Kura,318,0,0,comma</nowiki></code>

===postTimeSeriesValues===
Setzen von Zeitreihenwerten (POST)

Beispiel: <code><nowiki>http://10.0.0.5:8092/TalsimNGServer/HttpZreSrv/postTimeSeriesValues</nowiki></code><br/>
Post data (raw text):
<source lang="xml" gutter="false">
<SydroTimeSeries>
<Client>UNDP_Kura</Client>
<Id>318</Id>
<Length>427</Length>
<Name>GE.Iori</Name>
<ResultMsg></ResultMsg>
<StationId>21</StationId>
<TimeSeriesString>
1975-01-01 00:00:00,0.09
1975-02-01 00:00:00,0.1
1975-03-01 00:00:00,0.3
1975-04-01 00:00:00,0.99
1975-05-01 00:00:00,1.19
1975-06-01 00:00:00,0.58
1975-07-01 00:00:00,0.22
1975-08-01 00:00:00,0.11
1975-09-01 00:00:00,0.09
1975-10-01 00:00:00,0.1
</TimeSeriesString>
</SydroTimeSeries>
</source>

===requestSydroZreBin===
Beispiel: <code><nowiki>http://talsim.de:8092/TalsimNGServer/HttpZreSrv/requestSydroZreBin/WFP_SSD,hubert,724,201001010000,201201010000,0</nowiki></code>

===refreshSydroZreBin===
Beispiel: <code><nowiki>http://localhost:8092/TalsimNGServer/HttpZreSrv/refreshSydroZreBin/All/WFP_SSD,hubert</nowiki></code>

Server-API

2019-10-25T14:14:34Z

HubertLohr:

<div class="achtung">Die Server-API befindet sich noch in der Entwicklungsphase, Änderungen sind zu erwarten</div>

Die Serverkomponente von Talsim-NG ([[TalsimNGSrv]]) bietet eine REST (HTTP) Schnittstelle (API), über die Daten abgerufen und an den Server übermittelt werden können. Daten werden über diese Schnittstelle im XML oder JSON Format ausgetauscht. Im Folgenden wird diese Schnittstelle dokumentiert:
__TOC__
<div class="info">In den unten angegebenen Beispielen wird als Server-Adresse <code>talsim.de</code> verwendet, dies ist mit der Adresse oder IP des tatsächlich verwendeten Talsim-Servers zu ersetzen.</div>
==HttpDataSrv==
Der HttpDataSrv Service dient zur Abfrage von Daten mit Bezug zum System, Systemvarianten, Listen zu Zeitreihen-Ordnern oder Zeitreihen. Der HttpDataSrv ist standardmäßig über den Port 8090 ansprechbar und bietet die folgenden Schnittstellen:
===requestClients===
Generelle Abfrage aller Kunden.

===requestCustomers===
Generelle Abfrage aller Kunden. Identisch zu <code>requestClients</code>

Beispiel: <code><nowiki>http://talsim.de:8090/TalsimNGServer/HttpDataSrv/requestCustomers/|</nowiki></code>
===requestZreDirectories===
Abfrage von Zeitreihen-Ordnern. Es werden Zeitreihen-Ordner mit ihren Zeitreihen zurückgegeben. Parameter sind <code>customer</code> und mit Komma getrennt ein "|".

Beispiel: <code><nowiki>http://talsim.de:8090/TalsimNGServer/HttpDataSrv/requestZreDirectories/Nile,|</nowiki></code>
===ZreDirectories===
Abfrage von Zeitreihen-Ordnern. Es werden nur Zeitreihen-Ordner zurückgegeben. Parameter sind <code>customer</code> und mit Komma getrennt ein "|".

Beispiel: <code><nowiki>http://talsim.de:8090/TalsimNGServer/HttpDataSrv/ZreDirectories/Nile,|</nowiki></code>

===requestZreFiles===
Abfrage von vorhandenen Zeitreihen. Parameter sind <code>customer</code>, <code>user</code> sowie die ID des Zeitreihen-Ordners. Ist die ID des Zeitreihen-Ordners 0, werden alle Zeitreihen zurückgegeben.

Beispiel: <code><nowiki>http://talsim.de:8090/TalsimNGServer/HttpDataSrv/requestZreFiles/Nile,hubert,16</nowiki></code>
===requestSystemAndSysVar===
Abfrage von Systemen und Systemvarianten

Beispiel: <code><nowiki>http://talsim.de:8090/TalsimNGServer/HttpDataSrv/requestSystemAndSysVar/WFP_SSD,hubert,1</nowiki></code>
==HttpZreSrv==
HttpZreSrv ist der zentrale Service zur Interaktion mit Zeitreihen. Der HttpZreSrv ist standardmäßig über den Port 8092 ansprechbar. Es gibt folgende Schnittstellen, um auf Zeitreihen und deren Metadaten zuzugreifen:

===SydroTimeSeries===
Abfrage einer Zeitreihe

Als Parameter sind zu übergeben <code>Customer</code>, <code>User</code>, <code>Id</code> der Zeitreihe, Weitere Parameter sind aktuell noch ein SQL Statement <code>SQLCriteria</code> oder alternativ drei Parameter als <code>Startdate</code>, <code>Enddate</code> und <code>AttributeFlag</code>. Das SQL Statement ist momentan nur zum Testen aktiviert und wird wenn alle anderen Endpoints gesetzt sind wieder eingestellt.
Wenn Startdate und Enddate mit <code>0</code> angegeben werden, wird die gesamte Zeitreihe gelesen. Um nur einen Teil der Zeitreihe zu bekommen, können Anfang und/oder Ende mit Datumsformat <code>yyyy-MM-dd HH:mm</code> (z.B. <code>2010-08-15 08:00</code>) angegeben werden.

Beispiel 1: <code><nowiki>http://talsim.de:8092/TalsimNGServer/HttpZreSrv/SydroTimeSeries/TestAPI,MusterUser,9999,attribFlag=0</nowiki></code>

===SydroTimeSeries/combine===
Kombinieren von zwei Zeitreihen. Dies ist zum Beispiel sinnvoll, um eine Messzeitreihe mit Vorhersagedaten zu kombinieren.

Als Parameter sind zu übergeben <code>customer</code>, <code>user</code>, <code>id1</code>, <code>id2</code>,<code>startdate1</code>, <code>endstartdate</code>, <code>enddate2</code>, <code>flag1</code>,<code>flag2</code>. <code>Id1</code> bezieht sich auf die erste Zeitreihe und <code>Id2</code> auf die Reihe, welche angehängt wird. <code>Startdate1</code> definiert wo die erste Zeitreihe anfangen soll, <code>endstartdate</code> wo diese aufhöhrt und die zweite beginnen soll und <code>enddate2</code> das Enddatum der zweiten Reihe. Ist <code>enddate2</code> 0 oder leer wird bis zum Ende der zweiten Zeitreihe gelesen.

Beispiel 1: <code><nowiki>http://talsim.de:8092/TalsimNGServer/HttpZreSrv/SydroTimeSeries/combine/TestAPI,MusterUser,9999,8888,2019-02-01 00:00,2019-10-01 00:00, 0,0</nowiki></code>

===SydroTimeSeries===
Erstellen einer neuen Zeitreihen oder Überschreiben einer bestehenden Zeitreihe

Wird ein POST Aufruf mit dem SydroTimeSeries Objekt gestartet, kann eine Zeitreihe neu erstellt oder eine bestehende überschrieben werden. Soll eine bestehende Zeitreihe überschrieben oder ergänzt werden, muss das Attribute <code>ID</code> gesetzt sein. Soll eine neue Zeitreihen angelegt werden, muss <code>ID</code> gleich 0 sein. Das Objekt SydroTimeSeries besitzt folgende Struktur:

<pre>
<SydroTimeSeries>
<Attribute> (short)
<Customer> (string)
<DateValuePairSeparator> (string) shows how Date/Value Pairs in TimeSeriesString can be split
<ErrorValue> (double) Indicator what is an error value, will be replaced by NaN.
<HasError> (boolean) shows if an error occured during processing the request
<Id> (Integer) ID of time series. If ID=0 when POST is performed a new time series will be created and the new ID will be returned
<Length> (integer) Number or records in the TimeSeriesString
<Lat> (double) Latitude coordinate
<Lon> (double) Longitude coordinate
<Name> (string) Short name of the time series
<Path> (string) Path to the time series on the server
<ResultMsg> (string) Plain text describing errors if any or return a success message
<SaveMetadata> (boolean) Indicates whether or not metadata should be updated when posting time series values <Separator> (string) indicates how date/values can be split
<StationId> (integer) ID of the station
<TimeSeriesHeader> (string) Indicates how one time series entry must be interpreted, e.g. "Date,Value,Flag" if one entry has date/value/flag attributes.
<TimeSeriesString> (string) This is the time series as text, where date/values are separated by the attribute <Separator> and entries are separated by <DateValuePairSeparator>
Example: <TimeSeriesString>2001-01-01 00:00:00,3.106106,0#2001-01-02 00:00:00,4.209204,0#2001-01-03 00:00:00,0.1453788,#2002-01-02 00:00:00,0,0</TimeSeriesString>
<TsClass> (short) Represents the time series class with -1= unknown, 0=Default, 1=Flagged, 2=Forecast
<Unit> (string) gives the unit string, e.g. mm or m3/s
<User>Name of the user requesting or posting the time series or the owner of the time series.
</SydroTimeSeries>
</pre>

===SydroTimeSeries/process===
Eine zweite Art eine Zeitreihe zu erstellen bzw. hochzuladen, ist durch <code>process</code> gegeben.

In diesem Fall sind aber mehrere Interaktionen mit dem Server erforderlich, die nur per Software sinnvoll sind. Parameter sind <code>customer</code>, <code>user</code>, <code>id</code>, <code>SydroTimeSeriesFile</code>. Der Parameter <code>SydroTimeSeriesFile</code> ist eine Datei mit dem Inhalt eines SydroTimeSeries Objektes, welches vor dem Aufruf per Streaming in Kommunikation mit dem Server auf den Server hochgeladen werden muss. Dies erfordert das <code>TalsimNGZreClient</code> Modul, welches in eine Software integriert werden muss. Das Werkzeug <code>SydroCmd</code> besitzt die Fähigkeit, Dateien hochzuladen und ist deshalb für den operationellen Einsatz mit dem TalsimNGServer geeignet. Nach dem Aufruf sorgt der Server für die Verarbeitung der Datei und liefert eine Meldung zurück, dass der Prozess gestartet wurde. Es gibt keine Erfolgsmeldung, da der Server diesen Prozess asynchron in einem Thread verarbeitet.

Beispiel 1: <code><nowiki>http://talsim.de:8092/TalsimNGServer/HttpZreSrv/SydroTimeSeries/process/TestAPI,MusterUser,9999,..serververzeichnis/file.sydrots</nowiki></code>

===SydroTimeSeries/delete===
Löschen einer Zeitreihe.

Als Parameter sind zu übergeben <code>Customer</code>, <code>User</code>, <code>Id</code>. Es gibt kein Undo zu diesem Vorgang.

===SydroTimeSeries/deleteRecords===
Löschen von Einträgen in einer Zeitreihe.

Als Parameter sind zu übergeben <code>Customer</code>, <code>User</code>, <code>Id</code>, <code>Startdate</code>, <code>Enddate</code> und <code>AttributeFlag</code>. Gelöscht werden die Einträge, die zwischen <code>Startdate</code> und <code>Enddate</code> liegen und den <code>AttributeFlag</code> besitzen.

===SydroTimeSeries/attributes===
Abfrage oder Setzen von Metadaten zu einer Zeitreihe

Werden als Parameter <code>Customer</code>, <code>User</code>, <code>Id</code> übergeben, erhält man als Antwort einen String im Format FeldName=Wert getrennt durch "#" Zeichen, der alle Metadaten der Zeitreihe zeigt. Wird zusätzlich ein weiterer Parameter <code>KeyValuePairs</code> übergeben, so setzt man Metadaten. Der String KeyValuePairs muss im Format Feldname=Wert getrennt durch "#" angegeben sein. Die gegebenen Eigenschaften werden gespeichert, vorausgesetzt es handelt sich nicht um geschützte Felder.

Alternativ kann auch mittels POST ein SydroTimeSeriesAttributes Objekt gesendet werden, welches die zu schreibenden Eigenschaften beinhaltet.

===SydroTimeSeries/attributes/fieldnames===
Dieser Aufruf gibt alle Feldnamen der Metadaten getrennt durch Komma zurück.

===SydroTimeSeries/fieldnames===
Dieser Aufruf gibt alle Feldnamen der Zeitreihentabelle getrennt durch Komma zurück.

===SydroTimeSeries/flags===
Mit diesem Aufruf erhält man alle in der Zeitreihe verwendeten Flags. Erforderliche Parameter sind <code>Customer</code>, <code>User</code>, <code>Id</code>

===SydroTimeSeries/class===
Mit diesem Aufruf erhält man die Klasse einerZeitreihe, also -1= unknown, 0=Default, 1=Flagged, 2=Forecast. Erforderliche Parameter sind <code>Customer</code>, <code>User</code>, <code>Id</code>

==HttpZreSrv (spezielle Services)==
Zusätzlich zu den oben erwähnten REST Schnittstellen gibt es noch drei Sonderschnittstellen.

1. Abfrage des Arbeitsverzeichnisses des <code>users</code> (wichtig für das Hochladen von Dateien)
2. Synchronisierung eines <code>customers</code> (Abgleich aller Metadaten zwischen Master-Datenbank und allen Zeitreihen)
3. Konvertierung von Sydro Binar Dateien in Sydro SQLite Dateien für einen <code>customer</code> (normalerweise einmaliger Vorgang bei der Umstellung auf SQLite)

Die Synchronisierung wird der Server regelmässig zu bestimmten Uhrzeiten selbständig vornehmen. Da diese Schnittstellen nicht zur normalen Benutzung vorgesehen sind, sondern Bestandteil der Sydro Serivices im Operationellen Betrieb sind, erfolgt keine weitere Beschreibung des Aufrufs.

===Reports===
Abfrage eines Berichts zur Synchronisierung bzw. Konvertierung.

Sowohl zur Synchronisierung als auch zur Konvertierung werden Berichte vom Server erstellt, die man abrufen kann. Parameter sind <code>Customer</code>, <code>User</code>, <code>date</code>, <code>TypeOfReport</code>. <code>date</code> kann angegeben werden, um einen Bericht für einen bestimmten Tag zu erhalten. ist <code>date</code> 0 oder leer wird der aktuellste Bericht zurückgegeben. <code>TypeOfReport</code> ist entweder <code>SynchronizeLog</code> oder <code>ConvertLog</code>.

==HttpZreSrv (alte Schnittstelle)==
Alte Schnittstellen.

Der Service besitzt weitere Schnittstellen, die aus Gründen der Kompatibilität bestehen bleiben und zum Austausch von Sydro Binär Dateien dienen, teilweise aber bereits das neue SydroTimeSeries Objekt verwenden.

===requestSydroTimeSeries===
Abfrage einer Zeitreihe (neues SydroTimeSeries Objekt)

Als Parameter sind zu übergeben <code>Customer</code>, <code>User</code>, <code>Id</code> der Zeitreihe, <code>Startdate</code>, <code>Enddate</code> und <code>Separator</code> (Trennzeichen für den CSV-Inhalt).

===requestSydroTimeSeries===
Abfrage einer Zeitreihe

Als Parameter sind zu übergeben <code>Customer</code>, <code>User</code>, <code>Id</code> der Zeitreihe, <code>Startdate</code>, <code>Enddate</code> und <code>Separator</code> (Trennzeichen für den CSV-Inhalt)

Wenn Startdate und Enddate mit <code>0</code> angegeben werden, wird die gesamte Zeitreihe gelesen. Um nur einen Teil der Zeitreihe zu bekommen, können Anfang und/oder Ende mit Datumsformat <code>dd.MM.yyyy HH:mm</code> (z.B. <code>01.01.2010 00:00</code>) oder <code>yyyyMMddHHmm</code> (z.B. <code>201001010000</code>) angegeben werden.

Beispiel: <code><nowiki>http://talsim.de:8092/TalsimNGServer/HttpZreSrv/requestSydroTimeSeries/CSV/UNDP_Kura,Kura,318,0,0,comma</nowiki></code>

===postTimeSeriesValues===
Setzen von Zeitreihenwerten (POST)

Beispiel: <code><nowiki>http://10.0.0.5:8092/TalsimNGServer/HttpZreSrv/postTimeSeriesValues</nowiki></code><br/>
Post data (raw text):
<source lang="xml" gutter="false">
<SydroTimeSeries>
<Client>UNDP_Kura</Client>
<Id>318</Id>
<Length>427</Length>
<Name>GE.Iori</Name>
<ResultMsg></ResultMsg>
<StationId>21</StationId>
<TimeSeriesString>
1975-01-01 00:00:00,0.09
1975-02-01 00:00:00,0.1
1975-03-01 00:00:00,0.3
1975-04-01 00:00:00,0.99
1975-05-01 00:00:00,1.19
1975-06-01 00:00:00,0.58
1975-07-01 00:00:00,0.22
1975-08-01 00:00:00,0.11
1975-09-01 00:00:00,0.09
1975-10-01 00:00:00,0.1
</TimeSeriesString>
</SydroTimeSeries>
</source>

===requestSydroZreBin===
Beispiel: <code><nowiki>http://talsim.de:8092/TalsimNGServer/HttpZreSrv/requestSydroZreBin/WFP_SSD,hubert,724,201001010000,201201010000,0</nowiki></code>

===refreshSydroZreBin===
Beispiel: <code><nowiki>http://localhost:8092/TalsimNGServer/HttpZreSrv/refreshSydroZreBin/All/WFP_SSD,hubert</nowiki></code>

Server-API

2019-10-25T14:11:15Z

HubertLohr:

<div class="achtung">Die Server-API befindet sich noch in der Entwicklungsphase, Änderungen sind zu erwarten</div>

Die Serverkomponente von Talsim-NG ([[TalsimNGSrv]]) bietet eine REST (HTTP) Schnittstelle (API), über die Daten abgerufen und an den Server übermittelt werden können. Daten werden über diese Schnittstelle im XML oder JSON Format ausgetauscht. Im Folgenden wird diese Schnittstelle dokumentiert:
__TOC__
<div class="info">In den unten angegebenen Beispielen wird als Server-Adresse <code>talsim.de</code> verwendet, dies ist mit der Adresse oder IP des tatsächlich verwendeten Talsim-Servers zu ersetzen.</div>
==HttpDataSrv==
Der HttpDataSrv Service dient zur Abfrage von Daten mit Bezug zum System, Systemvarianten, Listen zu Zeitreihen-Ordnern oder Zeitreihen. Der HttpDataSrv ist standardmäßig über den Port 8090 ansprechbar und bietet die folgenden Schnittstellen:
===requestClients===
Generelle Abfrage aller Kunden.

===requestCustomers===
Generelle Abfrage aller Kunden. Identisch zu <code>requestClients</code>

Beispiel: <code><nowiki>http://talsim.de:8090/TalsimNGServer/HttpDataSrv/requestCustomers/|</nowiki></code>
===requestZreDirectories===
Abfrage von Zeitreihen-Ordnern. Es werden Zeitreihen-Ordner mit ihren Zeitreihen zurückgegeben. Parameter sind <code>customer</code> und mit Komma getrennt ein "|".

Beispiel: <code><nowiki>http://talsim.de:8090/TalsimNGServer/HttpDataSrv/requestZreDirectories/Nile,|</nowiki></code>
===ZreDirectories===
Abfrage von Zeitreihen-Ordnern. Es werden nur Zeitreihen-Ordner zurückgegeben. Parameter sind <code>customer</code> und mit Komma getrennt ein "|".

Beispiel: <code><nowiki>http://talsim.de:8090/TalsimNGServer/HttpDataSrv/ZreDirectories/Nile,|</nowiki></code>

===requestZreFiles===
Abfrage von vorhandenen Zeitreihen. Parameter sind <code>customer</code>, <code>user</code> sowie die ID des Zeitreihen-Ordners. Ist die ID des Zeitreihen-Ordners 0, werden alle Zeitreihen zurückgegeben.

Beispiel: <code><nowiki>http://talsim.de:8090/TalsimNGServer/HttpDataSrv/requestZreFiles/Nile,hubert,16</nowiki></code>
===requestSystemAndSysVar===
Abfrage von Systemen und Systemvarianten

Beispiel: <code><nowiki>http://talsim.de:8090/TalsimNGServer/HttpDataSrv/requestSystemAndSysVar/WFP_SSD,hubert,1</nowiki></code>
==HttpZreSrv==
HttpZreSrv ist der zentrale Service zur Interaktion mit Zeitreihen. Der HttpZreSrv ist standardmäßig über den Port 8092 ansprechbar. Es gibt folgende Schnittstellen, um auf Zeitreihen und deren Metadaten zuzugreifen:

===SydroTimeSeries===
Abfrage einer Zeitreihe

Als Parameter sind zu übergeben <code>Customer</code>, <code>User</code>, <code>Id</code> der Zeitreihe, Weitere Parameter sind aktuell noch ein SQL Statement <code>SQLCriteria</code> oder alternativ drei Parameter als <code>Startdate</code>, <code>Enddate</code> und <code>AttributeFlag</code>. Das SQL Statement ist momentan nur zum Testen aktiviert und wird wenn alle anderen Endpoints gesetzt sind wieder eingestellt.
Wenn Startdate und Enddate mit <code>0</code> angegeben werden, wird die gesamte Zeitreihe gelesen. Um nur einen Teil der Zeitreihe zu bekommen, können Anfang und/oder Ende mit Datumsformat <code>yyyy-MM-dd HH:mm</code> (z.B. <code>2010-08-15 08:00</code>) angegeben werden.

Beispiel 1: <code><nowiki>http://talsim.de:8092/TalsimNGServer/HttpZreSrv/SydroTimeSeries/TestAPI,MusterUser,9999,attribFlag=0</nowiki></code>

===SydroTimeSeries/combine===
Kombinieren von zwei Zeitreihen. Dies ist zum Beispiel sinnvoll, um eine Messzeitreihe mit Vorhersagedaten zu kombinieren.

Als Parameter sind zu übergeben <code>customer</code>, <code>user</code>, <code>id1</code>, <code>id2</code>,<code>startdate1</code>, <code>endstartdate</code>, <code>enddate2</code>, <code>flag1</code>,<code>flag2</code>. <code>Id1</code> bezieht sich auf die erste Zeitreihe und <code>Id2</code> auf die Reihe, welche angehängt wird. <code>Startdate1</code> definiert wo die erste Zeitreihe anfangen soll, <code>endstartdate</code> wo diese aufhöhrt und die zweite beginnen soll und <code>enddate2</code> das Enddatum der zweiten Reihe. Ist <code>enddate2</code> 0 oder leer wird bis zum Ende der zweiten Zeitreihe gelesen.

Beispiel 1: <code><nowiki>http://talsim.de:8092/TalsimNGServer/HttpZreSrv/SydroTimeSeries/combine/TestAPI,MusterUser,9999,8888,2019-02-01 00:00,2019-10-01 00:00, 0,0</nowiki></code>

===SydroTimeSeries===
Erstellen einer neuen Zeitreihen oder Überschreiben einer bestehenden Zeitreihe

Wird ein POST Aufruf mit dem SydroTimeSeries Objekt gestartet, kann eine Zeitreihe neu erstellt oder eine bestehende überschrieben werden. Soll eine bestehende Zeitreihe überschrieben oder ergänzt werden, muss das Attribute <code>ID</code> gesetzt sein. Soll eine neue Zeitreihen angelegt werden, muss <code>ID</code> gleich 0 sein. Das Objekt SydroTimeSeries besitzt folgende Struktur:

<pre>
<SydroTimeSeries>
<Attribute> (short)
<Customer> (string)
<DateValuePairSeparator> (string) shows how Date/Value Pairs in TimeSeriesString can be split
<ErrorValue> (double) Indicator what is an error value, will be replaced by NaN.
<HasError> (boolean) shows if an error occured during processing the request
<Id> (Integer) ID of time series. If ID=0 when POST is performed a new time series will be created and the new ID will be returned
<Length> (integer) Number or records in the TimeSeriesString
<Lat> (double) Latitude coordinate
<Lon> (double) Longitude coordinate
<Name> (string) Short name of the time series
<Path> (string) Path to the time series on the server
<ResultMsg> (string) Plain text describing errors if any or return a success message
<SaveMetadata> (boolean) Indicates whether or not metadata should be updated when posting time series values <Separator> (string) indicates how date/values can be split
<StationId> (integer) ID of the station
<TimeSeriesHeader> (string) Indicates how one time series entry must be interpreted, e.g. "Date,Value,Flag" if one entry has date/value/flag attributes.
<TimeSeriesString> (string) This is the time series as text, where date/values are separated by the attribute <Separator> and entries are separated by <DateValuePairSeparator>
Example: <TimeSeriesString>2001-01-01 00:00:00,3.106106,0#2001-01-02 00:00:00,4.209204,0#2001-01-03 00:00:00,0.1453788,#2002-01-02 00:00:00,0,0</TimeSeriesString>
<TsClass> (short) Represents the time series class with -1= unknown, 0=Default, 1=Flagged, 2=Forecast
<Unit> (string) gives the unit string, e.g. mm or m3/s
<User>Name of the user requesting or posting the time series or the owner of the time series.
</SydroTimeSeries>
</pre>

===SydroTimeSeries/process===
Eine zweite Art eine Zeitreihe zu erstellen bzw. hochzuladen, ist durch <code>process</code> gegeben.

In diesem Fall sind aber mehrere Interaktionen mit dem Server erforderlich, die nur per Software sinnvoll sind. Parameter sind <code>customer</code>, <code>user</code>, <code>id</code>, <code>SydroTimeSeriesFile</code>. Der Parameter <code>SydroTimeSeriesFile</code> ist eine Datei mit dem Inhalt eines SydroTimeSeries Objektes, welches vor dem Aufruf per Streaming in Kommunikation mit dem Server auf den Server hochgeladen werden muss. Dies erfordert das <code>TalsimNGZreClient</code> Modul, welches in eine Software integriert werden muss. Das Werkzeug <code>SydroCmd</code> besitzt die Fähigkeit, Dateien hochzuladen und ist deshalb für den operationellen Einsatz mit dem TalsimNGServer geeignet. Nach dem Aufruf sorgt der Server für die Verarbeitung der Datei und liefert eine Meldung zurück, dass der Prozess gestartet wurde. Es gibt keine Erfolgsmeldung, da der Server diesen Prozess asynchron in einem Thread verarbeitet.

Beispiel 1: <code><nowiki>http://talsim.de:8092/TalsimNGServer/HttpZreSrv/SydroTimeSeries/process/TestAPI,MusterUser,9999,..serververzeichnis/file.sydrots</nowiki></code>

===SydroTimeSeries/delete===
Löschen einer Zeitreihe.

Als Parameter sind zu übergeben <code>Customer</code>, <code>User</code>, <code>Id</code>. Es gibt kein Undo zu diesem Vorgang.

===SydroTimeSeries/deleteRecords===
Löschen von Einträgen in einer Zeitreihe.

Als Parameter sind zu übergeben <code>Customer</code>, <code>User</code>, <code>Id</code>, <code>Startdate</code>, <code>Enddate</code> und <code>AttributeFlag</code>. Gelöscht werden die Einträge, die zwischen <code>Startdate</code> und <code>Enddate</code> liegen und den <code>AttributeFlag</code> besitzen.

===SydroTimeSeries/attributes===
Abfrage oder Setzen von Metadaten zu einer Zeitreihe

Werden als Parameter <code>Customer</code>, <code>User</code>, <code>Id</code> übergeben, erhält man als Antwort einen String im Format FeldName=Wert getrennt durch "#" Zeichen, der alle Metadaten der Zeitreihe zeigt. Wird zusätzlich ein weiterer Parameter <code>KeyValuePairs</code> übergeben, so setzt man Metadaten. Der String KeyValuePairs muss im Format Feldname=Wert getrennt durch "#" angegeben sein. Die gegebenen Eigenschaften werden gespeichert, vorausgesetzt es handelt sich nicht um geschützte Felder.

Alternativ kann auch mittels POST ein SydroTimeSeriesAttributes Objekt gesendet werden, welches die zu schreibenden Eigenschaften beinhaltet.

===SydroTimeSeries/attributes/fieldnames===
Dieser Aufruf gibt alle Feldnamen der Metadaten getrennt durch Komma zurück.

===SydroTimeSeries/fieldnames===
Dieser Aufruf gibt alle Feldnamen der Zeitreihentabelle getrennt durch Komma zurück.

===SydroTimeSeries/flags===
Mit diesem Aufruf erhält man alle in der Zeitreihe verwendeten Flags. Erforderliche Parameter sind <code>Customer</code>, <code>User</code>, <code>Id</code>

===SydroTimeSeries/class===
Mit diesem Aufruf erhält man die Klasse einerZeitreihe, also -1= unknown, 0=Default, 1=Flagged, 2=Forecast. Erforderliche Parameter sind <code>Customer</code>, <code>User</code>, <code>Id</code>

==HttpZreSrv (spezielle Services)==
Zusätzlich zu den oben erwähnten REST Schnittstellen gibt es noch drei Sonderschnittstellen.

1. Abfrage des Arbeitsverzeichnisses des <code>users</code> (wichtig für das Hochladen von Dateien)
2. Synchronisierung eines <code>customers</code> (Abgleich aller Metadaten zwischen Master-Datenbank und allen Zeitreihen)
3. Konvertierung von Sydro Binar Dateien in Sydro SQLite Dateien für einen <code>customer</code> (normalerweise einmaliger Vorgang bei der Umstellung auf SQLite)

Die Synchronisierung wird der Server regelmässig zu bestimmten Uhrzeiten selbständig vornehmen. Da diese Schnittstellen nicht zur normalen Benutzung vorgesehen sind, sondern Bestandteil der Sydro Serivices im Operationellen Betrieb sind, erfolgt keine weitere Beschreibung des Aufrufs.

===Reports===
Abfrage eines Berichts zur Synchronisierung bzw. Konvertierung.

Sowohl zur Synchronisierung als auch zur Konvertierung werden Berichte vom Server erstellt, die man abrufen kann. Parameter sind <code>Customer</code>, <code>User</code>, <code>date</code>, <code>TypeOfReport</code>. <code>date</code> kann angegeben werden, um einen Bericht für einen bestimmten Tag zu erhalten. ist <code>date</code> 0 oder leer wird der aktuellste Bericht zurückgegeben. <code>TypeOfReport</code> ist entweder <code>SynchronizeLog</code> oder <code>ConvertLog</code>.

===requestSydroTimeSeries===
Abfrage einer Zeitreihe

Als Parameter sind zu übergeben <code>Customer</code>, <code>User</code>, <code>Id</code> der Zeitreihe, <code>Startdate</code>, <code>Enddate</code> und <code>Separator</code> (Trennzeichen für den CSV-Inhalt)

===requestSydroTimeSeries===
Abfrage einer Zeitreihe

Als Parameter sind zu übergeben <code>Customer</code>, <code>User</code>, <code>Id</code> der Zeitreihe, <code>Startdate</code>, <code>Enddate</code> und <code>Separator</code> (Trennzeichen für den CSV-Inhalt)

Wenn Startdate und Enddate mit <code>0</code> angegeben werden, wird die gesamte Zeitreihe gelesen. Um nur einen Teil der Zeitreihe zu bekommen, können Anfang und/oder Ende mit Datumsformat <code>dd.MM.yyyy HH:mm</code> (z.B. <code>01.01.2010 00:00</code>) oder <code>yyyyMMddHHmm</code> (z.B. <code>201001010000</code>) angegeben werden.

Beispiel: <code><nowiki>http://talsim.de:8092/TalsimNGServer/HttpZreSrv/requestSydroTimeSeries/CSV/UNDP_Kura,Kura,318,0,0,comma</nowiki></code>
===postTimeSeriesValues===
Setzen von Zeitreihenwerten (POST)

Beispiel: <code><nowiki>http://10.0.0.5:8092/TalsimNGServer/HttpZreSrv/postTimeSeriesValues</nowiki></code><br/>
Post data (raw text):
<source lang="xml" gutter="false">
<SydroTimeSeries>
<Client>UNDP_Kura</Client>
<Id>318</Id>
<Length>427</Length>
<Name>GE.Iori</Name>
<ResultMsg></ResultMsg>
<StationId>21</StationId>
<TimeSeriesString>
1975-01-01 00:00:00,0.09
1975-02-01 00:00:00,0.1
1975-03-01 00:00:00,0.3
1975-04-01 00:00:00,0.99
1975-05-01 00:00:00,1.19
1975-06-01 00:00:00,0.58
1975-07-01 00:00:00,0.22
1975-08-01 00:00:00,0.11
1975-09-01 00:00:00,0.09
1975-10-01 00:00:00,0.1
</TimeSeriesString>
</SydroTimeSeries>
</source>

===requestSydroZreBin===
Beispiel: <code><nowiki>http://talsim.de:8092/TalsimNGServer/HttpZreSrv/requestSydroZreBin/WFP_SSD,hubert,724,201001010000,201201010000,0</nowiki></code>

===refreshSydroZreBin===
Beispiel: <code><nowiki>http://localhost:8092/TalsimNGServer/HttpZreSrv/refreshSydroZreBin/All/WFP_SSD,hubert</nowiki></code>

Server-API

2019-10-25T13:55:38Z

HubertLohr:

<div class="achtung">Die Server-API befindet sich noch in der Entwicklungsphase, Änderungen sind zu erwarten</div>

Die Serverkomponente von Talsim-NG ([[TalsimNGSrv]]) bietet eine REST (HTTP) Schnittstelle (API), über die Daten abgerufen und an den Server übermittelt werden können. Daten werden über diese Schnittstelle im XML oder JSON Format ausgetauscht. Im Folgenden wird diese Schnittstelle dokumentiert:
__TOC__
<div class="info">In den unten angegebenen Beispielen wird als Server-Adresse <code>talsim.de</code> verwendet, dies ist mit der Adresse oder IP des tatsächlich verwendeten Talsim-Servers zu ersetzen.</div>
==HttpDataSrv==
Der HttpDataSrv Service dient zur Abfrage von Daten mit Bezug zum System, Systemvarianten, Listen zu Zeitreihen-Ordnern oder Zeitreihen. Der HttpDataSrv ist standardmäßig über den Port 8090 ansprechbar und bietet die folgenden Schnittstellen:
===requestClients===
Generelle Abfrage aller Kunden.

===requestCustomers===
Generelle Abfrage aller Kunden. Identisch zu <code>requestClients</code>

Beispiel: <code><nowiki>http://talsim.de:8090/TalsimNGServer/HttpDataSrv/requestCustomers/|</nowiki></code>
===requestZreDirectories===
Abfrage von Zeitreihen-Ordnern. Es werden Zeitreihen-Ordner mit ihren Zeitreihen zurückgegeben. Parameter sind <code>customer</code> und mit Komma getrennt ein "|".

Beispiel: <code><nowiki>http://talsim.de:8090/TalsimNGServer/HttpDataSrv/requestZreDirectories/Nile,|</nowiki></code>
===ZreDirectories===
Abfrage von Zeitreihen-Ordnern. Es werden nur Zeitreihen-Ordner zurückgegeben. Parameter sind <code>customer</code> und mit Komma getrennt ein "|".

Beispiel: <code><nowiki>http://talsim.de:8090/TalsimNGServer/HttpDataSrv/ZreDirectories/Nile,|</nowiki></code>

===requestZreFiles===
Abfrage von vorhandenen Zeitreihen. Parameter sind <code>customer</code>, <code>user</code> sowie die ID des Zeitreihen-Ordners. Ist die ID des Zeitreihen-Ordners 0, werden alle Zeitreihen zurückgegeben.

Beispiel: <code><nowiki>http://talsim.de:8090/TalsimNGServer/HttpDataSrv/requestZreFiles/Nile,hubert,16</nowiki></code>
===requestSystemAndSysVar===
Abfrage von Systemen und Systemvarianten

Beispiel: <code><nowiki>http://talsim.de:8090/TalsimNGServer/HttpDataSrv/requestSystemAndSysVar/WFP_SSD,hubert,1</nowiki></code>
==HttpZreSrv==
HttpZreSrv ist der zentrale Service zur Interaktion mit Zeitreihen. Der HttpZreSrv ist standardmäßig über den Port 8092 ansprechbar. Es gibt folgende Schnittstellen, um auf Zeitreihen und deren Metadaten zuzugreifen:

===SydroTimeSeries===
Abfrage einer Zeitreihe

Als Parameter sind zu übergeben <code>Customer</code>, <code>User</code>, <code>Id</code> der Zeitreihe, Weitere Parameter sind aktuell noch ein SQL Statement <code>SQLCriteria</code> oder alternativ drei Parameter als <code>Startdate</code>, <code>Enddate</code> und <code>AttributeFlag</code>. Das SQL Statement ist momentan nur zum Testen aktiviert und wird wenn alle anderen Endpoints gesetzt sind wieder eingestellt.
Wenn Startdate und Enddate mit <code>0</code> angegeben werden, wird die gesamte Zeitreihe gelesen. Um nur einen Teil der Zeitreihe zu bekommen, können Anfang und/oder Ende mit Datumsformat <code>yyyy-MM-dd HH:mm</code> (z.B. <code>2010-08-15 08:00</code>) angegeben werden.

Beispiel 1: <code><nowiki>http://talsim.de:8092/TalsimNGServer/HttpZreSrv/SydroTimeSeries/TestAPI,MusterUser,9999,attribFlag=0</nowiki></code>

===SydroTimeSeries/combine===
Kombinieren von zwei Zeitreihen. Dies ist zum Beispiel sinnvoll, um eine Messzeitreihe mit Vorhersagedaten zu kombinieren.

Als Parameter sind zu übergeben <code>customer</code>, <code>user</code>, <code>id1</code>, <code>id2</code>,<code>startdate1</code>, <code>endstartdate</code>, <code>enddate2</code>, <code>flag1</code>,<code>flag2</code>. <code>Id1</code> bezieht sich auf die erste Zeitreihe und <code>Id2</code> auf die Reihe, welche angehängt wird. <code>Startdate1</code> definiert wo die erste Zeitreihe anfangen soll, <code>endstartdate</code> wo diese aufhöhrt und die zweite beginnen soll und <code>enddate2</code> das Enddatum der zweiten Reihe. Ist <code>enddate2</code> 0 oder leer wird bis zum Ende der zweiten Zeitreihe gelesen.

Beispiel 1: <code><nowiki>http://talsim.de:8092/TalsimNGServer/HttpZreSrv/SydroTimeSeries/combine/TestAPI,MusterUser,9999,8888,2019-02-01 00:00,2019-10-01 00:00, 0,0</nowiki></code>

===SydroTimeSeries===
Erstellen einer neuen Zeitreihen oder Überschreiben einer bestehenden Zeitreihe

Wird ein POST Aufruf mit dem SydroTimeSeries Objekt gestartet, kann eine Zeitreihe neu erstellt oder eine bestehende überschrieben werden. Soll eine bestehende Zeitreihe überschrieben oder ergänzt werden, muss das Attribute <code>ID</code> gesetzt sein. Soll eine neue Zeitreihen angelegt werden, muss <code>ID</code> gleich 0 sein. Das Objekt SydroTimeSeries besitzt folgende Struktur:

<pre>
<SydroTimeSeries>
<Attribute> (short)
<Customer> (string)
<DateValuePairSeparator> (string) shows how Date/Value Pairs in TimeSeriesString can be split
<ErrorValue> (double) Indicator what is an error value, will be replaced by NaN.
<HasError> (boolean) shows if an error occured during processing the request
<Id> (Integer) ID of time series. If ID=0 when POST is performed a new time series will be created and the new ID will be returned
<Length> (integer) Number or records in the TimeSeriesString
<Lat> (double) Latitude coordinate
<Lon> (double) Longitude coordinate
<Name> (string) Short name of the time series
<Path> (string) Path to the time series on the server
<ResultMsg> (string) Plain text describing errors if any or return a success message
<SaveMetadata> (boolean) Indicates whether or not metadata should be updated when posting time series values <Separator> (string) indicates how date/values can be split
<StationId> (integer) ID of the station
<TimeSeriesHeader> (string) Indicates how one time series entry must be interpreted, e.g. "Date,Value,Flag" if one entry has date/value/flag attributes.
<TimeSeriesString> (string) This is the time series as text, where date/values are separated by the attribute <Separator> and entries are separated by <DateValuePairSeparator>
Example: <TimeSeriesString>2001-01-01 00:00:00,3.106106,0#2001-01-02 00:00:00,4.209204,0#2001-01-03 00:00:00,0.1453788,#2002-01-02 00:00:00,0,0</TimeSeriesString>
<TsClass> (short) Represents the time series class with -1= unknown, 0=Default, 1=Flagged, 2=Forecast
<Unit> (string) gives the unit string, e.g. mm or m3/s
<User>Name of the user requesting or posting the time series or the owner of the time series.
</SydroTimeSeries>
</pre>

===SydroTimeSeries/process===
Eine zweite Art eine Zeitreihe zu erstellen bzw. hochzuladen, ist durch <code>process</code> gegeben.

In diesem Fall sind aber mehrere Interaktionen mit dem Server erforderlich, die nur per Software sinnvoll sind. Parameter sind <code>customer</code>, <code>user</code>, <code>id</code>, <code>SydroTimeSeriesFile</code>. Der Parameter <code>SydroTimeSeriesFile</code> ist eine Datei mit dem Inhalt eines SydroTimeSeries Objektes, welches vor dem Aufruf per Streaming in Kommunikation mit dem Server auf den Server hochgeladen werden muss. Dies erfordert das <code>TalsimNGZreClient</code> Modul, welches in eine Software integriert werden muss. Das Werkzeug <code>SydroCmd</code> besitzt die Fähigkeit, Dateien hochzuladen und ist deshalb für den operationellen Einsatz mit dem TalsimNGServer geeignet. Nach dem Aufruf sorgt der Server für die Verarbeitung der Datei und liefert eine Meldung zurück, dass der Prozess gestartet wurde. Es gibt keine Erfolgsmeldung, da der Server diesen Prozess asynchron in einem Thread verarbeitet.

Beispiel 1: <code><nowiki>http://talsim.de:8092/TalsimNGServer/HttpZreSrv/SydroTimeSeries/process/TestAPI,MusterUser,9999,..serververzeichnis/file.sydrots</nowiki></code>

===SydroTimeSeries/delete===
Löschen einer Zeitreihe.

Als Parameter sind zu übergeben <code>Customer</code>, <code>User</code>, <code>Id</code>. Es gibt kein Undo zu diesem Vorgang.

===SydroTimeSeries/deleteRecords===
Löschen von Einträgen in einer Zeitreihe.

Als Parameter sind zu übergeben <code>Customer</code>, <code>User</code>, <code>Id</code>, <code>Startdate</code>, <code>Enddate</code> und <code>AttributeFlag</code>. Gelöscht werden die Einträge, die zwischen <code>Startdate</code> und <code>Enddate</code> liegen und den <code>AttributeFlag</code> besitzen.

===SydroTimeSeries/attributes===
Abfrage oder Setzen von Metadaten zu einer Zeitreihe

Werden als Parameter <code>Customer</code>, <code>User</code>, <code>Id</code> übergeben, erhält man als Antwort einen String im Format FeldName=Wert getrennt durch "#" Zeichen, der alle Metadaten der Zeitreihe zeigt. Wird zusätzlich ein weiterer Parameter <code>KeyValuePairs</code> übergeben, so setzt man Metadaten. Der String KeyValuePairs muss im Format Feldname=Wert getrennt durch "#" angegeben sein. Die gegebenen Eigenschaften werden gespeichert, vorausgesetzt es handelt sich nicht um geschützte Felder.

Alternativ kann auch mittels POST ein SydroTimeSeriesAttributes Objekt gesendet werden, welches die zu schreibenden Eigenschaften beinhaltet.

===SydroTimeSeries/attributes/fieldnames===
Dieser Aufruf gibt alle Feldnamen der Metadaten getrennt durch Komma zurück.

===SydroTimeSeries/fieldnames===
Dieser Aufruf gibt alle Feldnamen der Zeitreihentabelle getrennt durch Komma zurück.

===SydroTimeSeries/flags===
Mit diesem Aufruf erhält man alle in der Zeitreihe verwendeten Flags. Erforderliche Parameter sind <code>Customer</code>, <code>User</code>, <code>Id</code>

===SydroTimeSeries/class===
Mit diesem Aufruf erhält man die Klasse einerZeitreihe, also -1= unknown, 0=Default, 1=Flagged, 2=Forecast. Erforderliche Parameter sind <code>Customer</code>, <code>User</code>, <code>Id</code>

===requestSydroTimeSeries===
Abfrage einer Zeitreihe

Als Parameter sind zu übergeben <code>Customer</code>, <code>User</code>, <code>Id</code> der Zeitreihe, <code>Startdate</code>, <code>Enddate</code> und <code>Separator</code> (Trennzeichen für den CSV-Inhalt)

===requestSydroTimeSeries===
Abfrage einer Zeitreihe

Als Parameter sind zu übergeben <code>Customer</code>, <code>User</code>, <code>Id</code> der Zeitreihe, <code>Startdate</code>, <code>Enddate</code> und <code>Separator</code> (Trennzeichen für den CSV-Inhalt)

Wenn Startdate und Enddate mit <code>0</code> angegeben werden, wird die gesamte Zeitreihe gelesen. Um nur einen Teil der Zeitreihe zu bekommen, können Anfang und/oder Ende mit Datumsformat <code>dd.MM.yyyy HH:mm</code> (z.B. <code>01.01.2010 00:00</code>) oder <code>yyyyMMddHHmm</code> (z.B. <code>201001010000</code>) angegeben werden.

Beispiel: <code><nowiki>http://talsim.de:8092/TalsimNGServer/HttpZreSrv/requestSydroTimeSeries/CSV/UNDP_Kura,Kura,318,0,0,comma</nowiki></code>
===postTimeSeriesValues===
Setzen von Zeitreihenwerten (POST)

Beispiel: <code><nowiki>http://10.0.0.5:8092/TalsimNGServer/HttpZreSrv/postTimeSeriesValues</nowiki></code><br/>
Post data (raw text):
<source lang="xml" gutter="false">
<SydroTimeSeries>
<Client>UNDP_Kura</Client>
<Id>318</Id>
<Length>427</Length>
<Name>GE.Iori</Name>
<ResultMsg></ResultMsg>
<StationId>21</StationId>
<TimeSeriesString>
1975-01-01 00:00:00,0.09
1975-02-01 00:00:00,0.1
1975-03-01 00:00:00,0.3
1975-04-01 00:00:00,0.99
1975-05-01 00:00:00,1.19
1975-06-01 00:00:00,0.58
1975-07-01 00:00:00,0.22
1975-08-01 00:00:00,0.11
1975-09-01 00:00:00,0.09
1975-10-01 00:00:00,0.1
</TimeSeriesString>
</SydroTimeSeries>
</source>

===requestSydroZreBin===
Beispiel: <code><nowiki>http://talsim.de:8092/TalsimNGServer/HttpZreSrv/requestSydroZreBin/WFP_SSD,hubert,724,201001010000,201201010000,0</nowiki></code>

===refreshSydroZreBin===
Beispiel: <code><nowiki>http://localhost:8092/TalsimNGServer/HttpZreSrv/refreshSydroZreBin/All/WFP_SSD,hubert</nowiki></code>

Server-API

2019-10-25T13:52:24Z

HubertLohr: /* SydroTimeSeries/delete */

<div class="achtung">Die Server-API befindet sich noch in der Entwicklungsphase, Änderungen sind zu erwarten</div>

Die Serverkomponente von Talsim-NG ([[TalsimNGSrv]]) bietet eine REST (HTTP) Schnittstelle (API), über die Daten abgerufen und an den Server übermittelt werden können. Daten werden über diese Schnittstelle im XML oder JSON Format ausgetauscht. Im Folgenden wird diese Schnittstelle dokumentiert:
__TOC__
<div class="info">In den unten angegebenen Beispielen wird als Server-Adresse <code>talsim.de</code> verwendet, dies ist mit der Adresse oder IP des tatsächlich verwendeten Talsim-Servers zu ersetzen.</div>
==HttpDataSrv==
Der HttpDataSrv Service dient zur Abfrage von Daten mit Bezug zum System, Systemvarianten, Listen zu Zeitreihen-Ordnern oder Zeitreihen. Der HttpDataSrv ist standardmäßig über den Port 8090 ansprechbar und bietet die folgenden Schnittstellen:
===requestClients===
Generelle Abfrage aller Kunden.

===requestCustomers===
Generelle Abfrage aller Kunden. Identisch zu <code>requestClients</code>

Beispiel: <code><nowiki>http://talsim.de:8090/TalsimNGServer/HttpDataSrv/requestCustomers/|</nowiki></code>
===requestZreDirectories===
Abfrage von Zeitreihen-Ordnern. Es werden Zeitreihen-Ordner mit ihren Zeitreihen zurückgegeben. Parameter sind <code>customer</code> und mit Komma getrennt ein "|".

Beispiel: <code><nowiki>http://talsim.de:8090/TalsimNGServer/HttpDataSrv/requestZreDirectories/Nile,|</nowiki></code>
===ZreDirectories===
Abfrage von Zeitreihen-Ordnern. Es werden nur Zeitreihen-Ordner zurückgegeben. Parameter sind <code>customer</code> und mit Komma getrennt ein "|".

Beispiel: <code><nowiki>http://talsim.de:8090/TalsimNGServer/HttpDataSrv/ZreDirectories/Nile,|</nowiki></code>

===requestZreFiles===
Abfrage von vorhandenen Zeitreihen. Parameter sind <code>customer</code>, <code>user</code> sowie die ID des Zeitreihen-Ordners. Ist die ID des Zeitreihen-Ordners 0, werden alle Zeitreihen zurückgegeben.

Beispiel: <code><nowiki>http://talsim.de:8090/TalsimNGServer/HttpDataSrv/requestZreFiles/Nile,hubert,16</nowiki></code>
===requestSystemAndSysVar===
Abfrage von Systemen und Systemvarianten

Beispiel: <code><nowiki>http://talsim.de:8090/TalsimNGServer/HttpDataSrv/requestSystemAndSysVar/WFP_SSD,hubert,1</nowiki></code>
==HttpZreSrv==
HttpZreSrv ist der zentrale Service zur Interaktion mit Zeitreihen. Der HttpZreSrv ist standardmäßig über den Port 8092 ansprechbar. Es gibt folgende Schnittstellen, um auf Zeitreihen und deren Metadaten zuzugreifen:

===SydroTimeSeries===
Abfrage einer Zeitreihe

Als Parameter sind zu übergeben <code>Customer</code>, <code>User</code>, <code>Id</code> der Zeitreihe, Weitere Parameter sind aktuell noch ein SQL Statement <code>SQLCriteria</code> oder alternativ drei Parameter als <code>Startdate</code>, <code>Enddate</code> und <code>AttributeFlag</code>. Das SQL Statement ist momentan nur zum Testen aktiviert und wird wenn alle anderen Endpoints gesetzt sind wieder eingestellt.
Wenn Startdate und Enddate mit <code>0</code> angegeben werden, wird die gesamte Zeitreihe gelesen. Um nur einen Teil der Zeitreihe zu bekommen, können Anfang und/oder Ende mit Datumsformat <code>yyyy-MM-dd HH:mm</code> (z.B. <code>2010-08-15 08:00</code>) angegeben werden.

Beispiel 1: <code><nowiki>http://talsim.de:8092/TalsimNGServer/HttpZreSrv/SydroTimeSeries/TestAPI,MusterUser,9999,attribFlag=0</nowiki></code>

===SydroTimeSeries/combine===
Kombinieren von zwei Zeitreihen. Dies ist zum Beispiel sinnvoll, um eine Messzeitreihe mit Vorhersagedaten zu kombinieren.

Als Parameter sind zu übergeben <code>customer</code>, <code>user</code>, <code>id1</code>, <code>id2</code>,<code>startdate1</code>, <code>endstartdate</code>, <code>enddate2</code>, <code>flag1</code>,<code>flag2</code>. <code>Id1</code> bezieht sich auf die erste Zeitreihe und <code>Id2</code> auf die Reihe, welche angehängt wird. <code>Startdate1</code> definiert wo die erste Zeitreihe anfangen soll, <code>endstartdate</code> wo diese aufhöhrt und die zweite beginnen soll und <code>enddate2</code> das Enddatum der zweiten Reihe. Ist <code>enddate2</code> 0 oder leer wird bis zum Ende der zweiten Zeitreihe gelesen.

Beispiel 1: <code><nowiki>http://talsim.de:8092/TalsimNGServer/HttpZreSrv/SydroTimeSeries/combine/TestAPI,MusterUser,9999,8888,2019-02-01 00:00,2019-10-01 00:00, 0,0</nowiki></code>

===SydroTimeSeries===
Erstellen einer neuen Zeitreihen oder Überschreiben einer bestehenden Zeitreihe

Wird ein POST Aufruf mit dem SydroTimeSeries Objekt gestartet, kann eine Zeitreihe neu erstellt oder eine bestehende überschrieben werden. Soll eine bestehende Zeitreihe überschrieben oder ergänzt werden, muss das Attribute <code>ID</code> gesetzt sein. Soll eine neue Zeitreihen angelegt werden, muss <code>ID</code> gleich 0 sein. Das Objekt SydroTimeSeries besitzt folgende Struktur:

<pre>
<SydroTimeSeries>
<Attribute> (short)
<Customer> (string)
<DateValuePairSeparator> (string) shows how Date/Value Pairs in TimeSeriesString can be split
<ErrorValue> (double) Indicator what is an error value, will be replaced by NaN.
<HasError> (boolean) shows if an error occured during processing the request
<Id> (Integer) ID of time series. If ID=0 when POST is performed a new time series will be created and the new ID will be returned
<Length> (integer) Number or records in the TimeSeriesString
<Lat> (double) Latitude coordinate
<Lon> (double) Longitude coordinate
<Name> (string) Short name of the time series
<Path> (string) Path to the time series on the server
<ResultMsg> (string) Plain text describing errors if any or return a success message
<SaveMetadata> (boolean) Indicates whether or not metadata should be updated when posting time series values <Separator> (string) indicates how date/values can be split
<StationId> (integer) ID of the station
<TimeSeriesHeader> (string) Indicates how one time series entry must be interpreted, e.g. "Date,Value,Flag" if one entry has date/value/flag attributes.
<TimeSeriesString> (string) This is the time series as text, where date/values are separated by the attribute <Separator> and entries are separated by <DateValuePairSeparator>
Example: <TimeSeriesString>2001-01-01 00:00:00,3.106106,0#2001-01-02 00:00:00,4.209204,0#2001-01-03 00:00:00,0.1453788,#2002-01-02 00:00:00,0,0</TimeSeriesString>
<TsClass> (short) Represents the time series class with -1= unknown, 0=Default, 1=Flagged, 2=Forecast
<Unit> (string) gives the unit string, e.g. mm or m3/s
<User>Name of the user requesting or posting the time series or the owner of the time series.
</SydroTimeSeries>
</pre>

===SydroTimeSeries/process===
Eine zweite Art eine Zeitreihe zu erstellen bzw. hochzuladen, ist durch <code>process</code> gegeben.

In diesem Fall sind aber mehrere Interaktionen mit dem Server erforderlich, die nur per Software sinnvoll sind. Parameter sind <code>customer</code>, <code>user</code>, <code>id</code>, <code>SydroTimeSeriesFile</code>. Der Parameter <code>SydroTimeSeriesFile</code> ist eine Datei mit dem Inhalt eines SydroTimeSeries Objektes, welches vor dem Aufruf per Streaming in Kommunikation mit dem Server auf den Server hochgeladen werden muss. Dies erfordert das <code>TalsimNGZreClient</code> Modul, welches in eine Software integriert werden muss. Das Werkzeug <code>SydroCmd</code> besitzt die Fähigkeit, Dateien hochzuladen und ist deshalb für den operationellen Einsatz mit dem TalsimNGServer geeignet. Nach dem Aufruf sorgt der Server für die Verarbeitung der Datei und liefert eine Meldung zurück, dass der Prozess gestartet wurde. Es gibt keine Erfolgsmeldung, da der Server diesen Prozess asynchron in einem Thread verarbeitet.

Beispiel 1: <code><nowiki>http://talsim.de:8092/TalsimNGServer/HttpZreSrv/SydroTimeSeries/process/TestAPI,MusterUser,9999,..serververzeichnis/file.sydrots</nowiki></code>

===SydroTimeSeries/delete===
Löschen einer Zeitreihe.

Als Parameter sind zu übergeben <code>Customer</code>, <code>User</code>, <code>Id</code>. Es gibt kein Undo zu diesem Vorgang.

===SydroTimeSeries/attributes===
Abfrage oder Setzen von Metadaten zu einer Zeitreihe

Werden als Parameter <code>Customer</code>, <code>User</code>, <code>Id</code> übergeben, erhält man als Antwort einen String im Format FeldName=Wert getrennt durch "#" Zeichen, der alle Metadaten der Zeitreihe zeigt. Wird zusätzlich ein weiterer Parameter <code>KeyValuePairs</code> übergeben, so setzt man Metadaten. Der String KeyValuePairs muss im Format Feldname=Wert getrennt durch "#" angegeben sein. Die gegebenen Eigenschaften werden gespeichert, vorausgesetzt es handelt sich nicht um geschützte Felder.

Alternativ kann auch mittels POST ein SydroTimeSeriesAttributes Objekt gesendet werden, welches die zu schreibenden Eigenschaften beinhaltet.

===SydroTimeSeries/attributes/fieldnames===
Dieser Aufruf gibt alle Feldnamen der Metadaten getrennt durch Komma zurück.

===SydroTimeSeries/fieldnames===
Dieser Aufruf gibt alle Feldnamen der Zeitreihentabelle getrennt durch Komma zurück.

===SydroTimeSeries/flags===
Mit diesem Aufruf erhält man alle in der Zeitreihe verwendeten Flags. Erforderliche Parameter sind <code>Customer</code>, <code>User</code>, <code>Id</code>

===SydroTimeSeries/class===
Mit diesem Aufruf erhält man die Klasse einerZeitreihe, also -1= unknown, 0=Default, 1=Flagged, 2=Forecast. Erforderliche Parameter sind <code>Customer</code>, <code>User</code>, <code>Id</code>

===requestSydroTimeSeries===
Abfrage einer Zeitreihe

Als Parameter sind zu übergeben <code>Customer</code>, <code>User</code>, <code>Id</code> der Zeitreihe, <code>Startdate</code>, <code>Enddate</code> und <code>Separator</code> (Trennzeichen für den CSV-Inhalt)

===requestSydroTimeSeries===
Abfrage einer Zeitreihe

Als Parameter sind zu übergeben <code>Customer</code>, <code>User</code>, <code>Id</code> der Zeitreihe, <code>Startdate</code>, <code>Enddate</code> und <code>Separator</code> (Trennzeichen für den CSV-Inhalt)

Wenn Startdate und Enddate mit <code>0</code> angegeben werden, wird die gesamte Zeitreihe gelesen. Um nur einen Teil der Zeitreihe zu bekommen, können Anfang und/oder Ende mit Datumsformat <code>dd.MM.yyyy HH:mm</code> (z.B. <code>01.01.2010 00:00</code>) oder <code>yyyyMMddHHmm</code> (z.B. <code>201001010000</code>) angegeben werden.

Beispiel: <code><nowiki>http://talsim.de:8092/TalsimNGServer/HttpZreSrv/requestSydroTimeSeries/CSV/UNDP_Kura,Kura,318,0,0,comma</nowiki></code>
===postTimeSeriesValues===
Setzen von Zeitreihenwerten (POST)

Beispiel: <code><nowiki>http://10.0.0.5:8092/TalsimNGServer/HttpZreSrv/postTimeSeriesValues</nowiki></code><br/>
Post data (raw text):
<source lang="xml" gutter="false">
<SydroTimeSeries>
<Client>UNDP_Kura</Client>
<Id>318</Id>
<Length>427</Length>
<Name>GE.Iori</Name>
<ResultMsg></ResultMsg>
<StationId>21</StationId>
<TimeSeriesString>
1975-01-01 00:00:00,0.09
1975-02-01 00:00:00,0.1
1975-03-01 00:00:00,0.3
1975-04-01 00:00:00,0.99
1975-05-01 00:00:00,1.19
1975-06-01 00:00:00,0.58
1975-07-01 00:00:00,0.22
1975-08-01 00:00:00,0.11
1975-09-01 00:00:00,0.09
1975-10-01 00:00:00,0.1
</TimeSeriesString>
</SydroTimeSeries>
</source>

===requestSydroZreBin===
Beispiel: <code><nowiki>http://talsim.de:8092/TalsimNGServer/HttpZreSrv/requestSydroZreBin/WFP_SSD,hubert,724,201001010000,201201010000,0</nowiki></code>

===refreshSydroZreBin===
Beispiel: <code><nowiki>http://localhost:8092/TalsimNGServer/HttpZreSrv/refreshSydroZreBin/All/WFP_SSD,hubert</nowiki></code>

Server-API

2019-10-25T13:51:28Z

HubertLohr: /* SydroTimeSeries/process */

<div class="achtung">Die Server-API befindet sich noch in der Entwicklungsphase, Änderungen sind zu erwarten</div>

Die Serverkomponente von Talsim-NG ([[TalsimNGSrv]]) bietet eine REST (HTTP) Schnittstelle (API), über die Daten abgerufen und an den Server übermittelt werden können. Daten werden über diese Schnittstelle im XML oder JSON Format ausgetauscht. Im Folgenden wird diese Schnittstelle dokumentiert:
__TOC__
<div class="info">In den unten angegebenen Beispielen wird als Server-Adresse <code>talsim.de</code> verwendet, dies ist mit der Adresse oder IP des tatsächlich verwendeten Talsim-Servers zu ersetzen.</div>
==HttpDataSrv==
Der HttpDataSrv Service dient zur Abfrage von Daten mit Bezug zum System, Systemvarianten, Listen zu Zeitreihen-Ordnern oder Zeitreihen. Der HttpDataSrv ist standardmäßig über den Port 8090 ansprechbar und bietet die folgenden Schnittstellen:
===requestClients===
Generelle Abfrage aller Kunden.

===requestCustomers===
Generelle Abfrage aller Kunden. Identisch zu <code>requestClients</code>

Beispiel: <code><nowiki>http://talsim.de:8090/TalsimNGServer/HttpDataSrv/requestCustomers/|</nowiki></code>
===requestZreDirectories===
Abfrage von Zeitreihen-Ordnern. Es werden Zeitreihen-Ordner mit ihren Zeitreihen zurückgegeben. Parameter sind <code>customer</code> und mit Komma getrennt ein "|".

Beispiel: <code><nowiki>http://talsim.de:8090/TalsimNGServer/HttpDataSrv/requestZreDirectories/Nile,|</nowiki></code>
===ZreDirectories===
Abfrage von Zeitreihen-Ordnern. Es werden nur Zeitreihen-Ordner zurückgegeben. Parameter sind <code>customer</code> und mit Komma getrennt ein "|".

Beispiel: <code><nowiki>http://talsim.de:8090/TalsimNGServer/HttpDataSrv/ZreDirectories/Nile,|</nowiki></code>

===requestZreFiles===
Abfrage von vorhandenen Zeitreihen. Parameter sind <code>customer</code>, <code>user</code> sowie die ID des Zeitreihen-Ordners. Ist die ID des Zeitreihen-Ordners 0, werden alle Zeitreihen zurückgegeben.

Beispiel: <code><nowiki>http://talsim.de:8090/TalsimNGServer/HttpDataSrv/requestZreFiles/Nile,hubert,16</nowiki></code>
===requestSystemAndSysVar===
Abfrage von Systemen und Systemvarianten

Beispiel: <code><nowiki>http://talsim.de:8090/TalsimNGServer/HttpDataSrv/requestSystemAndSysVar/WFP_SSD,hubert,1</nowiki></code>
==HttpZreSrv==
HttpZreSrv ist der zentrale Service zur Interaktion mit Zeitreihen. Der HttpZreSrv ist standardmäßig über den Port 8092 ansprechbar. Es gibt folgende Schnittstellen, um auf Zeitreihen und deren Metadaten zuzugreifen:

===SydroTimeSeries===
Abfrage einer Zeitreihe

Als Parameter sind zu übergeben <code>Customer</code>, <code>User</code>, <code>Id</code> der Zeitreihe, Weitere Parameter sind aktuell noch ein SQL Statement <code>SQLCriteria</code> oder alternativ drei Parameter als <code>Startdate</code>, <code>Enddate</code> und <code>AttributeFlag</code>. Das SQL Statement ist momentan nur zum Testen aktiviert und wird wenn alle anderen Endpoints gesetzt sind wieder eingestellt.
Wenn Startdate und Enddate mit <code>0</code> angegeben werden, wird die gesamte Zeitreihe gelesen. Um nur einen Teil der Zeitreihe zu bekommen, können Anfang und/oder Ende mit Datumsformat <code>yyyy-MM-dd HH:mm</code> (z.B. <code>2010-08-15 08:00</code>) angegeben werden.

Beispiel 1: <code><nowiki>http://talsim.de:8092/TalsimNGServer/HttpZreSrv/SydroTimeSeries/TestAPI,MusterUser,9999,attribFlag=0</nowiki></code>

===SydroTimeSeries/combine===
Kombinieren von zwei Zeitreihen. Dies ist zum Beispiel sinnvoll, um eine Messzeitreihe mit Vorhersagedaten zu kombinieren.

Als Parameter sind zu übergeben <code>customer</code>, <code>user</code>, <code>id1</code>, <code>id2</code>,<code>startdate1</code>, <code>endstartdate</code>, <code>enddate2</code>, <code>flag1</code>,<code>flag2</code>. <code>Id1</code> bezieht sich auf die erste Zeitreihe und <code>Id2</code> auf die Reihe, welche angehängt wird. <code>Startdate1</code> definiert wo die erste Zeitreihe anfangen soll, <code>endstartdate</code> wo diese aufhöhrt und die zweite beginnen soll und <code>enddate2</code> das Enddatum der zweiten Reihe. Ist <code>enddate2</code> 0 oder leer wird bis zum Ende der zweiten Zeitreihe gelesen.

Beispiel 1: <code><nowiki>http://talsim.de:8092/TalsimNGServer/HttpZreSrv/SydroTimeSeries/combine/TestAPI,MusterUser,9999,8888,2019-02-01 00:00,2019-10-01 00:00, 0,0</nowiki></code>

===SydroTimeSeries===
Erstellen einer neuen Zeitreihen oder Überschreiben einer bestehenden Zeitreihe

Wird ein POST Aufruf mit dem SydroTimeSeries Objekt gestartet, kann eine Zeitreihe neu erstellt oder eine bestehende überschrieben werden. Soll eine bestehende Zeitreihe überschrieben oder ergänzt werden, muss das Attribute <code>ID</code> gesetzt sein. Soll eine neue Zeitreihen angelegt werden, muss <code>ID</code> gleich 0 sein. Das Objekt SydroTimeSeries besitzt folgende Struktur:

<pre>
<SydroTimeSeries>
<Attribute> (short)
<Customer> (string)
<DateValuePairSeparator> (string) shows how Date/Value Pairs in TimeSeriesString can be split
<ErrorValue> (double) Indicator what is an error value, will be replaced by NaN.
<HasError> (boolean) shows if an error occured during processing the request
<Id> (Integer) ID of time series. If ID=0 when POST is performed a new time series will be created and the new ID will be returned
<Length> (integer) Number or records in the TimeSeriesString
<Lat> (double) Latitude coordinate
<Lon> (double) Longitude coordinate
<Name> (string) Short name of the time series
<Path> (string) Path to the time series on the server
<ResultMsg> (string) Plain text describing errors if any or return a success message
<SaveMetadata> (boolean) Indicates whether or not metadata should be updated when posting time series values <Separator> (string) indicates how date/values can be split
<StationId> (integer) ID of the station
<TimeSeriesHeader> (string) Indicates how one time series entry must be interpreted, e.g. "Date,Value,Flag" if one entry has date/value/flag attributes.
<TimeSeriesString> (string) This is the time series as text, where date/values are separated by the attribute <Separator> and entries are separated by <DateValuePairSeparator>
Example: <TimeSeriesString>2001-01-01 00:00:00,3.106106,0#2001-01-02 00:00:00,4.209204,0#2001-01-03 00:00:00,0.1453788,#2002-01-02 00:00:00,0,0</TimeSeriesString>
<TsClass> (short) Represents the time series class with -1= unknown, 0=Default, 1=Flagged, 2=Forecast
<Unit> (string) gives the unit string, e.g. mm or m3/s
<User>Name of the user requesting or posting the time series or the owner of the time series.
</SydroTimeSeries>
</pre>

===SydroTimeSeries/process===
Eine zweite Art eine Zeitreihe zu erstellen bzw. hochzuladen, ist durch <code>process</code> gegeben.

In diesem Fall sind aber mehrere Interaktionen mit dem Server erforderlich, die nur per Software sinnvoll sind. Parameter sind <code>customer</code>, <code>user</code>, <code>id</code>, <code>SydroTimeSeriesFile</code>. Der Parameter <code>SydroTimeSeriesFile</code> ist eine Datei mit dem Inhalt eines SydroTimeSeries Objektes, welches vor dem Aufruf per Streaming in Kommunikation mit dem Server auf den Server hochgeladen werden muss. Dies erfordert das <code>TalsimNGZreClient</code> Modul, welches in eine Software integriert werden muss. Das Werkzeug <code>SydroCmd</code> besitzt die Fähigkeit, Dateien hochzuladen und ist deshalb für den operationellen Einsatz mit dem TalsimNGServer geeignet. Nach dem Aufruf sorgt der Server für die Verarbeitung der Datei und liefert eine Meldung zurück, dass der Prozess gestartet wurde. Es gibt keine Erfolgsmeldung, da der Server diesen Prozess asynchron in einem Thread verarbeitet.

Beispiel 1: <code><nowiki>http://talsim.de:8092/TalsimNGServer/HttpZreSrv/SydroTimeSeries/process/TestAPI,MusterUser,9999,..serververzeichnis/file.sydrots</nowiki></code>

===SydroTimeSeries/delete===
Löschen einer Zeitreihe.

Als Parameter sind zu übergeben <code>Customer</code>, <code>User</code>, <code>Id</code>.

===SydroTimeSeries/attributes===
Abfrage oder Setzen von Metadaten zu einer Zeitreihe

Werden als Parameter <code>Customer</code>, <code>User</code>, <code>Id</code> übergeben, erhält man als Antwort einen String im Format FeldName=Wert getrennt durch "#" Zeichen, der alle Metadaten der Zeitreihe zeigt. Wird zusätzlich ein weiterer Parameter <code>KeyValuePairs</code> übergeben, so setzt man Metadaten. Der String KeyValuePairs muss im Format Feldname=Wert getrennt durch "#" angegeben sein. Die gegebenen Eigenschaften werden gespeichert, vorausgesetzt es handelt sich nicht um geschützte Felder.

Alternativ kann auch mittels POST ein SydroTimeSeriesAttributes Objekt gesendet werden, welches die zu schreibenden Eigenschaften beinhaltet.

===SydroTimeSeries/attributes/fieldnames===
Dieser Aufruf gibt alle Feldnamen der Metadaten getrennt durch Komma zurück.

===SydroTimeSeries/fieldnames===
Dieser Aufruf gibt alle Feldnamen der Zeitreihentabelle getrennt durch Komma zurück.

===SydroTimeSeries/flags===
Mit diesem Aufruf erhält man alle in der Zeitreihe verwendeten Flags. Erforderliche Parameter sind <code>Customer</code>, <code>User</code>, <code>Id</code>

===SydroTimeSeries/class===
Mit diesem Aufruf erhält man die Klasse einerZeitreihe, also -1= unknown, 0=Default, 1=Flagged, 2=Forecast. Erforderliche Parameter sind <code>Customer</code>, <code>User</code>, <code>Id</code>

===requestSydroTimeSeries===
Abfrage einer Zeitreihe

Als Parameter sind zu übergeben <code>Customer</code>, <code>User</code>, <code>Id</code> der Zeitreihe, <code>Startdate</code>, <code>Enddate</code> und <code>Separator</code> (Trennzeichen für den CSV-Inhalt)

===requestSydroTimeSeries===
Abfrage einer Zeitreihe

Als Parameter sind zu übergeben <code>Customer</code>, <code>User</code>, <code>Id</code> der Zeitreihe, <code>Startdate</code>, <code>Enddate</code> und <code>Separator</code> (Trennzeichen für den CSV-Inhalt)

Wenn Startdate und Enddate mit <code>0</code> angegeben werden, wird die gesamte Zeitreihe gelesen. Um nur einen Teil der Zeitreihe zu bekommen, können Anfang und/oder Ende mit Datumsformat <code>dd.MM.yyyy HH:mm</code> (z.B. <code>01.01.2010 00:00</code>) oder <code>yyyyMMddHHmm</code> (z.B. <code>201001010000</code>) angegeben werden.

Beispiel: <code><nowiki>http://talsim.de:8092/TalsimNGServer/HttpZreSrv/requestSydroTimeSeries/CSV/UNDP_Kura,Kura,318,0,0,comma</nowiki></code>
===postTimeSeriesValues===
Setzen von Zeitreihenwerten (POST)

Beispiel: <code><nowiki>http://10.0.0.5:8092/TalsimNGServer/HttpZreSrv/postTimeSeriesValues</nowiki></code><br/>
Post data (raw text):
<source lang="xml" gutter="false">
<SydroTimeSeries>
<Client>UNDP_Kura</Client>
<Id>318</Id>
<Length>427</Length>
<Name>GE.Iori</Name>
<ResultMsg></ResultMsg>
<StationId>21</StationId>
<TimeSeriesString>
1975-01-01 00:00:00,0.09
1975-02-01 00:00:00,0.1
1975-03-01 00:00:00,0.3
1975-04-01 00:00:00,0.99
1975-05-01 00:00:00,1.19
1975-06-01 00:00:00,0.58
1975-07-01 00:00:00,0.22
1975-08-01 00:00:00,0.11
1975-09-01 00:00:00,0.09
1975-10-01 00:00:00,0.1
</TimeSeriesString>
</SydroTimeSeries>
</source>

===requestSydroZreBin===
Beispiel: <code><nowiki>http://talsim.de:8092/TalsimNGServer/HttpZreSrv/requestSydroZreBin/WFP_SSD,hubert,724,201001010000,201201010000,0</nowiki></code>

===refreshSydroZreBin===
Beispiel: <code><nowiki>http://localhost:8092/TalsimNGServer/HttpZreSrv/refreshSydroZreBin/All/WFP_SSD,hubert</nowiki></code>

Server-API

2019-10-25T13:49:49Z

HubertLohr:

<div class="achtung">Die Server-API befindet sich noch in der Entwicklungsphase, Änderungen sind zu erwarten</div>

Die Serverkomponente von Talsim-NG ([[TalsimNGSrv]]) bietet eine REST (HTTP) Schnittstelle (API), über die Daten abgerufen und an den Server übermittelt werden können. Daten werden über diese Schnittstelle im XML oder JSON Format ausgetauscht. Im Folgenden wird diese Schnittstelle dokumentiert:
__TOC__
<div class="info">In den unten angegebenen Beispielen wird als Server-Adresse <code>talsim.de</code> verwendet, dies ist mit der Adresse oder IP des tatsächlich verwendeten Talsim-Servers zu ersetzen.</div>
==HttpDataSrv==
Der HttpDataSrv Service dient zur Abfrage von Daten mit Bezug zum System, Systemvarianten, Listen zu Zeitreihen-Ordnern oder Zeitreihen. Der HttpDataSrv ist standardmäßig über den Port 8090 ansprechbar und bietet die folgenden Schnittstellen:
===requestClients===
Generelle Abfrage aller Kunden.

===requestCustomers===
Generelle Abfrage aller Kunden. Identisch zu <code>requestClients</code>

Beispiel: <code><nowiki>http://talsim.de:8090/TalsimNGServer/HttpDataSrv/requestCustomers/|</nowiki></code>
===requestZreDirectories===
Abfrage von Zeitreihen-Ordnern. Es werden Zeitreihen-Ordner mit ihren Zeitreihen zurückgegeben. Parameter sind <code>customer</code> und mit Komma getrennt ein "|".

Beispiel: <code><nowiki>http://talsim.de:8090/TalsimNGServer/HttpDataSrv/requestZreDirectories/Nile,|</nowiki></code>
===ZreDirectories===
Abfrage von Zeitreihen-Ordnern. Es werden nur Zeitreihen-Ordner zurückgegeben. Parameter sind <code>customer</code> und mit Komma getrennt ein "|".

Beispiel: <code><nowiki>http://talsim.de:8090/TalsimNGServer/HttpDataSrv/ZreDirectories/Nile,|</nowiki></code>

===requestZreFiles===
Abfrage von vorhandenen Zeitreihen. Parameter sind <code>customer</code>, <code>user</code> sowie die ID des Zeitreihen-Ordners. Ist die ID des Zeitreihen-Ordners 0, werden alle Zeitreihen zurückgegeben.

Beispiel: <code><nowiki>http://talsim.de:8090/TalsimNGServer/HttpDataSrv/requestZreFiles/Nile,hubert,16</nowiki></code>
===requestSystemAndSysVar===
Abfrage von Systemen und Systemvarianten

Beispiel: <code><nowiki>http://talsim.de:8090/TalsimNGServer/HttpDataSrv/requestSystemAndSysVar/WFP_SSD,hubert,1</nowiki></code>
==HttpZreSrv==
HttpZreSrv ist der zentrale Service zur Interaktion mit Zeitreihen. Der HttpZreSrv ist standardmäßig über den Port 8092 ansprechbar. Es gibt folgende Schnittstellen, um auf Zeitreihen und deren Metadaten zuzugreifen:

===SydroTimeSeries===
Abfrage einer Zeitreihe

Als Parameter sind zu übergeben <code>Customer</code>, <code>User</code>, <code>Id</code> der Zeitreihe, Weitere Parameter sind aktuell noch ein SQL Statement <code>SQLCriteria</code> oder alternativ drei Parameter als <code>Startdate</code>, <code>Enddate</code> und <code>AttributeFlag</code>. Das SQL Statement ist momentan nur zum Testen aktiviert und wird wenn alle anderen Endpoints gesetzt sind wieder eingestellt.
Wenn Startdate und Enddate mit <code>0</code> angegeben werden, wird die gesamte Zeitreihe gelesen. Um nur einen Teil der Zeitreihe zu bekommen, können Anfang und/oder Ende mit Datumsformat <code>yyyy-MM-dd HH:mm</code> (z.B. <code>2010-08-15 08:00</code>) angegeben werden.

Beispiel 1: <code><nowiki>http://talsim.de:8092/TalsimNGServer/HttpZreSrv/SydroTimeSeries/TestAPI,MusterUser,9999,attribFlag=0</nowiki></code>

===SydroTimeSeries/combine===
Kombinieren von zwei Zeitreihen. Dies ist zum Beispiel sinnvoll, um eine Messzeitreihe mit Vorhersagedaten zu kombinieren.

Als Parameter sind zu übergeben <code>customer</code>, <code>user</code>, <code>id1</code>, <code>id2</code>,<code>startdate1</code>, <code>endstartdate</code>, <code>enddate2</code>, <code>flag1</code>,<code>flag2</code>. <code>Id1</code> bezieht sich auf die erste Zeitreihe und <code>Id2</code> auf die Reihe, welche angehängt wird. <code>Startdate1</code> definiert wo die erste Zeitreihe anfangen soll, <code>endstartdate</code> wo diese aufhöhrt und die zweite beginnen soll und <code>enddate2</code> das Enddatum der zweiten Reihe. Ist <code>enddate2</code> 0 oder leer wird bis zum Ende der zweiten Zeitreihe gelesen.

Beispiel 1: <code><nowiki>http://talsim.de:8092/TalsimNGServer/HttpZreSrv/SydroTimeSeries/combine/TestAPI,MusterUser,9999,8888,2019-02-01 00:00,2019-10-01 00:00, 0,0</nowiki></code>

===SydroTimeSeries===
Erstellen einer neuen Zeitreihen oder Überschreiben einer bestehenden Zeitreihe

Wird ein POST Aufruf mit dem SydroTimeSeries Objekt gestartet, kann eine Zeitreihe neu erstellt oder eine bestehende überschrieben werden. Soll eine bestehende Zeitreihe überschrieben oder ergänzt werden, muss das Attribute <code>ID</code> gesetzt sein. Soll eine neue Zeitreihen angelegt werden, muss <code>ID</code> gleich 0 sein. Das Objekt SydroTimeSeries besitzt folgende Struktur:

<pre>
<SydroTimeSeries>
<Attribute> (short)
<Customer> (string)
<DateValuePairSeparator> (string) shows how Date/Value Pairs in TimeSeriesString can be split
<ErrorValue> (double) Indicator what is an error value, will be replaced by NaN.
<HasError> (boolean) shows if an error occured during processing the request
<Id> (Integer) ID of time series. If ID=0 when POST is performed a new time series will be created and the new ID will be returned
<Length> (integer) Number or records in the TimeSeriesString
<Lat> (double) Latitude coordinate
<Lon> (double) Longitude coordinate
<Name> (string) Short name of the time series
<Path> (string) Path to the time series on the server
<ResultMsg> (string) Plain text describing errors if any or return a success message
<SaveMetadata> (boolean) Indicates whether or not metadata should be updated when posting time series values <Separator> (string) indicates how date/values can be split
<StationId> (integer) ID of the station
<TimeSeriesHeader> (string) Indicates how one time series entry must be interpreted, e.g. "Date,Value,Flag" if one entry has date/value/flag attributes.
<TimeSeriesString> (string) This is the time series as text, where date/values are separated by the attribute <Separator> and entries are separated by <DateValuePairSeparator>
Example: <TimeSeriesString>2001-01-01 00:00:00,3.106106,0#2001-01-02 00:00:00,4.209204,0#2001-01-03 00:00:00,0.1453788,#2002-01-02 00:00:00,0,0</TimeSeriesString>
<TsClass> (short) Represents the time series class with -1= unknown, 0=Default, 1=Flagged, 2=Forecast
<Unit> (string) gives the unit string, e.g. mm or m3/s
<User>Name of the user requesting or posting the time series or the owner of the time series.
</SydroTimeSeries>
</pre>

===SydroTimeSeries/process===
Eine zweite Art eine Zeitreihe zu erstellen bzw. hochzuladen, ist durch <code>process</code> gegeben.

In diesem Fall sind aber mehrere Interaktionen mit dem Server erforderlich, die nur per Software sinnvoll sind. Parameter sind <code>customer</code>, <code>user</code>, <code>id</code>, <code>SydroTimeSeriesFile</code>. Der Parameter <code>SydroTimeSeriesFile</code> ist eine Datei mit dem Inhalt eines SydroTimeSeries Objektes, welches vor dem Aufruf per Streaming in Kommunikation mit dem Server auf den Server hochgeladen werden muss. Dies erfordert das <code>TalsimNGZreClient</code> Modul, welches in eine Software integriert werden muss. Das Werkzeug <code>SydroCmd</code> besitzt die Fähigkeit, Dateien hochzuladen und ist deshalb für den operationellen Einsatz mit dem TalsimNGServer geeignet.

Beispiel 1: <code><nowiki>http://talsim.de:8092/TalsimNGServer/HttpZreSrv/SydroTimeSeries/process/TestAPI,MusterUser,9999,..serververzeichnis/file.sydrots</nowiki></code>

===SydroTimeSeries/delete===
Löschen einer Zeitreihe.

Als Parameter sind zu übergeben <code>Customer</code>, <code>User</code>, <code>Id</code>.

===SydroTimeSeries/attributes===
Abfrage oder Setzen von Metadaten zu einer Zeitreihe

Werden als Parameter <code>Customer</code>, <code>User</code>, <code>Id</code> übergeben, erhält man als Antwort einen String im Format FeldName=Wert getrennt durch "#" Zeichen, der alle Metadaten der Zeitreihe zeigt. Wird zusätzlich ein weiterer Parameter <code>KeyValuePairs</code> übergeben, so setzt man Metadaten. Der String KeyValuePairs muss im Format Feldname=Wert getrennt durch "#" angegeben sein. Die gegebenen Eigenschaften werden gespeichert, vorausgesetzt es handelt sich nicht um geschützte Felder.

Alternativ kann auch mittels POST ein SydroTimeSeriesAttributes Objekt gesendet werden, welches die zu schreibenden Eigenschaften beinhaltet.

===SydroTimeSeries/attributes/fieldnames===
Dieser Aufruf gibt alle Feldnamen der Metadaten getrennt durch Komma zurück.

===SydroTimeSeries/fieldnames===
Dieser Aufruf gibt alle Feldnamen der Zeitreihentabelle getrennt durch Komma zurück.

===SydroTimeSeries/flags===
Mit diesem Aufruf erhält man alle in der Zeitreihe verwendeten Flags. Erforderliche Parameter sind <code>Customer</code>, <code>User</code>, <code>Id</code>

===SydroTimeSeries/class===
Mit diesem Aufruf erhält man die Klasse einerZeitreihe, also -1= unknown, 0=Default, 1=Flagged, 2=Forecast. Erforderliche Parameter sind <code>Customer</code>, <code>User</code>, <code>Id</code>

===requestSydroTimeSeries===
Abfrage einer Zeitreihe

Als Parameter sind zu übergeben <code>Customer</code>, <code>User</code>, <code>Id</code> der Zeitreihe, <code>Startdate</code>, <code>Enddate</code> und <code>Separator</code> (Trennzeichen für den CSV-Inhalt)

===requestSydroTimeSeries===
Abfrage einer Zeitreihe

Als Parameter sind zu übergeben <code>Customer</code>, <code>User</code>, <code>Id</code> der Zeitreihe, <code>Startdate</code>, <code>Enddate</code> und <code>Separator</code> (Trennzeichen für den CSV-Inhalt)

Wenn Startdate und Enddate mit <code>0</code> angegeben werden, wird die gesamte Zeitreihe gelesen. Um nur einen Teil der Zeitreihe zu bekommen, können Anfang und/oder Ende mit Datumsformat <code>dd.MM.yyyy HH:mm</code> (z.B. <code>01.01.2010 00:00</code>) oder <code>yyyyMMddHHmm</code> (z.B. <code>201001010000</code>) angegeben werden.

Beispiel: <code><nowiki>http://talsim.de:8092/TalsimNGServer/HttpZreSrv/requestSydroTimeSeries/CSV/UNDP_Kura,Kura,318,0,0,comma</nowiki></code>
===postTimeSeriesValues===
Setzen von Zeitreihenwerten (POST)

Beispiel: <code><nowiki>http://10.0.0.5:8092/TalsimNGServer/HttpZreSrv/postTimeSeriesValues</nowiki></code><br/>
Post data (raw text):
<source lang="xml" gutter="false">
<SydroTimeSeries>
<Client>UNDP_Kura</Client>
<Id>318</Id>
<Length>427</Length>
<Name>GE.Iori</Name>
<ResultMsg></ResultMsg>
<StationId>21</StationId>
<TimeSeriesString>
1975-01-01 00:00:00,0.09
1975-02-01 00:00:00,0.1
1975-03-01 00:00:00,0.3
1975-04-01 00:00:00,0.99
1975-05-01 00:00:00,1.19
1975-06-01 00:00:00,0.58
1975-07-01 00:00:00,0.22
1975-08-01 00:00:00,0.11
1975-09-01 00:00:00,0.09
1975-10-01 00:00:00,0.1
</TimeSeriesString>
</SydroTimeSeries>
</source>

===requestSydroZreBin===
Beispiel: <code><nowiki>http://talsim.de:8092/TalsimNGServer/HttpZreSrv/requestSydroZreBin/WFP_SSD,hubert,724,201001010000,201201010000,0</nowiki></code>

===refreshSydroZreBin===
Beispiel: <code><nowiki>http://localhost:8092/TalsimNGServer/HttpZreSrv/refreshSydroZreBin/All/WFP_SSD,hubert</nowiki></code>

Server-API

2019-10-25T13:40:17Z

HubertLohr: /* SydroTimeSeries/combine */

<div class="achtung">Die Server-API befindet sich noch in der Entwicklungsphase, Änderungen sind zu erwarten</div>

Die Serverkomponente von Talsim-NG ([[TalsimNGSrv]]) bietet eine REST (HTTP) Schnittstelle (API), über die Daten abgerufen und an den Server übermittelt werden können. Daten werden über diese Schnittstelle im XML oder JSON Format ausgetauscht. Im Folgenden wird diese Schnittstelle dokumentiert:
__TOC__
<div class="info">In den unten angegebenen Beispielen wird als Server-Adresse <code>talsim.de</code> verwendet, dies ist mit der Adresse oder IP des tatsächlich verwendeten Talsim-Servers zu ersetzen.</div>
==HttpDataSrv==
Der HttpDataSrv Service dient zur Abfrage von Daten mit Bezug zum System, Systemvarianten, Listen zu Zeitreihen-Ordnern oder Zeitreihen. Der HttpDataSrv ist standardmäßig über den Port 8090 ansprechbar und bietet die folgenden Schnittstellen:
===requestClients===
Generelle Abfrage aller Kunden.

===requestCustomers===
Generelle Abfrage aller Kunden. Identisch zu <code>requestClients</code>

Beispiel: <code><nowiki>http://talsim.de:8090/TalsimNGServer/HttpDataSrv/requestCustomers/|</nowiki></code>
===requestZreDirectories===
Abfrage von Zeitreihen-Ordnern. Es werden Zeitreihen-Ordner mit ihren Zeitreihen zurückgegeben. Parameter sind <code>customer</code> und mit Komma getrennt ein "|".

Beispiel: <code><nowiki>http://talsim.de:8090/TalsimNGServer/HttpDataSrv/requestZreDirectories/Nile,|</nowiki></code>
===ZreDirectories===
Abfrage von Zeitreihen-Ordnern. Es werden nur Zeitreihen-Ordner zurückgegeben. Parameter sind <code>customer</code> und mit Komma getrennt ein "|".

Beispiel: <code><nowiki>http://talsim.de:8090/TalsimNGServer/HttpDataSrv/ZreDirectories/Nile,|</nowiki></code>

===requestZreFiles===
Abfrage von vorhandenen Zeitreihen. Parameter sind <code>customer</code>, <code>user</code> sowie die ID des Zeitreihen-Ordners. Ist die ID des Zeitreihen-Ordners 0, werden alle Zeitreihen zurückgegeben.

Beispiel: <code><nowiki>http://talsim.de:8090/TalsimNGServer/HttpDataSrv/requestZreFiles/Nile,hubert,16</nowiki></code>
===requestSystemAndSysVar===
Abfrage von Systemen und Systemvarianten

Beispiel: <code><nowiki>http://talsim.de:8090/TalsimNGServer/HttpDataSrv/requestSystemAndSysVar/WFP_SSD,hubert,1</nowiki></code>
==HttpZreSrv==
HttpZreSrv ist der zentrale Service zur Interaktion mit Zeitreihen. Der HttpZreSrv ist standardmäßig über den Port 8092 ansprechbar. Es gibt folgende Schnittstellen, um auf Zeitreihen und deren Metadaten zuzugreifen:

===SydroTimeSeries===
Abfrage einer Zeitreihe

Als Parameter sind zu übergeben <code>Customer</code>, <code>User</code>, <code>Id</code> der Zeitreihe, Weitere Parameter sind aktuell noch ein SQL Statement <code>SQLCriteria</code> oder alternativ drei Parameter als <code>Startdate</code>, <code>Enddate</code> und <code>AttributeFlag</code>. Das SQL Statement ist momentan nur zum Testen aktiviert und wird wenn alle anderen Endpoints gesetzt sind wieder eingestellt.
Wenn Startdate und Enddate mit <code>0</code> angegeben werden, wird die gesamte Zeitreihe gelesen. Um nur einen Teil der Zeitreihe zu bekommen, können Anfang und/oder Ende mit Datumsformat <code>yyyy-MM-dd HH:mm</code> (z.B. <code>2010-08-15 08:00</code>) angegeben werden.

Beispiel 1: <code><nowiki>http://talsim.de:8092/TalsimNGServer/HttpZreSrv/SydroTimeSeries/TestAPI,MusterUser,9999,attribFlag=0</nowiki></code>

===SydroTimeSeries/combine===
Kombinieren von zwei Zeitreihen. Dies ist zum Beispiel sinnvoll, um eine Messzeitreihe mit Vorhersagedaten zu kombinieren.

Als Parameter sind zu übergeben <code>customer</code>, <code>user</code>, <code>id1</code>, <code>id2</code>,<code>startdate1</code>, <code>endstartdate</code>, <code>enddate2</code>, <code>flag1</code>,<code>flag2</code>. <code>Id1</code> bezieht sich auf die erste Zeitreihe und <code>Id2</code> auf die Reihe, welche angehängt wird. <code>Startdate1</code> definiert wo die erste Zeitreihe anfangen soll, <code>endstartdate</code> wo diese aufhöhrt und die zweite beginnen soll und <code>enddate2</code> das Enddatum der zweiten Reihe. Ist <code>enddate2</code> 0 oder leer wird bis zum Ende der zweiten Zeitreihe gelesen.

Beispiel 1: <code><nowiki>http://talsim.de:8092/TalsimNGServer/HttpZreSrv/SydroTimeSeries/combine/TestAPI,MusterUser,9999,8888,2019-02-01 00:00,2019-10-01 00:00, 0,0</nowiki></code>

===SydroTimeSeries===
Erstellen einer neuen Zeitreihen oder Überschreiben einer bestehenden Zeitreihe

Wird ein POST Aufruf mit dem SydroTimeSeries Objekt gestartet, kann eine Zeitreihe neu erstellt oder eine bestehende überschrieben werden. Soll eine bestehende Zeitreihe überschrieben oder ergänzt werden, muss das Attribute <code>ID</code> gesetzt sein. Soll eine neue Zeitreihen angelegt werden, muss <code>ID</code> gleich 0 sein. Das Objekt SydroTimeSeries besitzt folgende Struktur:

<pre>
<SydroTimeSeries>
<Attribute> (short)
<Customer> (string)
<DateValuePairSeparator> (string) shows how Date/Value Pairs in TimeSeriesString can be split
<ErrorValue> (double) Indicator what is an error value, will be replaced by NaN.
<HasError> (boolean) shows if an error occured during processing the request
<Id> (Integer) ID of time series. If ID=0 when POST is performed a new time series will be created and the new ID will be returned
<Length> (integer) Number or records in the TimeSeriesString
<Lat> (double) Latitude coordinate
<Lon> (double) Longitude coordinate
<Name> (string) Short name of the time series
<Path> (string) Path to the time series on the server
<ResultMsg> (string) Plain text describing errors if any or return a success message
<SaveMetadata> (boolean) Indicates whether or not metadata should be updated when posting time series values <Separator> (string) indicates how date/values can be split
<StationId> (integer) ID of the station
<TimeSeriesHeader> (string) Indicates how one time series entry must be interpreted, e.g. "Date,Value,Flag" if one entry has date/value/flag attributes.
<TimeSeriesString> (string) This is the time series as text, where date/values are separated by the attribute <Separator> and entries are separated by <DateValuePairSeparator>
Example: <TimeSeriesString>2001-01-01 00:00:00,3.106106,0#2001-01-02 00:00:00,4.209204,0#2001-01-03 00:00:00,0.1453788,#2002-01-02 00:00:00,0,0</TimeSeriesString>
<TsClass> (short) Represents the time series class with -1= unknown, 0=Default, 1=Flagged, 2=Forecast
<Unit> (string) gives the unit string, e.g. mm or m3/s
<User>Name of the user requesting or posting the time series or the owner of the time series.
</SydroTimeSeries>
</pre>

===SydroTimeSeries/delete===
Löschen einer Zeitreihe.

Als Parameter sind zu übergeben <code>Customer</code>, <code>User</code>, <code>Id</code>.

===SydroTimeSeries/attributes===
Abfrage oder Setzen von Metadaten zu einer Zeitreihe

Werden als Parameter <code>Customer</code>, <code>User</code>, <code>Id</code> übergeben, erhält man als Antwort einen String im Format FeldName=Wert getrennt durch "#" Zeichen, der alle Metadaten der Zeitreihe zeigt. Wird zusätzlich ein weiterer Parameter <code>KeyValuePairs</code> übergeben, so setzt man Metadaten. Der String KeyValuePairs muss im Format Feldname=Wert getrennt durch "#" angegeben sein. Die gegebenen Eigenschaften werden gespeichert, vorausgesetzt es handelt sich nicht um geschützte Felder.

Alternativ kann auch mittels POST ein SydroTimeSeriesAttributes Objekt gesendet werden, welches die zu schreibenden Eigenschaften beinhaltet.

===SydroTimeSeries/attributes/fieldnames===
Dieser Aufruf gibt alle Feldnamen der Metadaten getrennt durch Komma zurück.

===SydroTimeSeries/fieldnames===
Dieser Aufruf gibt alle Feldnamen der Zeitreihentabelle getrennt durch Komma zurück.

===SydroTimeSeries/flags===
Mit diesem Aufruf erhält man alle in der Zeitreihe verwendeten Flags. Erforderliche Parameter sind <code>Customer</code>, <code>User</code>, <code>Id</code>

===SydroTimeSeries/class===
Mit diesem Aufruf erhält man die Klasse einerZeitreihe, also -1= unknown, 0=Default, 1=Flagged, 2=Forecast. Erforderliche Parameter sind <code>Customer</code>, <code>User</code>, <code>Id</code>

===requestSydroTimeSeries===
Abfrage einer Zeitreihe

Als Parameter sind zu übergeben <code>Customer</code>, <code>User</code>, <code>Id</code> der Zeitreihe, <code>Startdate</code>, <code>Enddate</code> und <code>Separator</code> (Trennzeichen für den CSV-Inhalt)

===requestSydroTimeSeries===
Abfrage einer Zeitreihe

Als Parameter sind zu übergeben <code>Customer</code>, <code>User</code>, <code>Id</code> der Zeitreihe, <code>Startdate</code>, <code>Enddate</code> und <code>Separator</code> (Trennzeichen für den CSV-Inhalt)

Wenn Startdate und Enddate mit <code>0</code> angegeben werden, wird die gesamte Zeitreihe gelesen. Um nur einen Teil der Zeitreihe zu bekommen, können Anfang und/oder Ende mit Datumsformat <code>dd.MM.yyyy HH:mm</code> (z.B. <code>01.01.2010 00:00</code>) oder <code>yyyyMMddHHmm</code> (z.B. <code>201001010000</code>) angegeben werden.

Beispiel: <code><nowiki>http://talsim.de:8092/TalsimNGServer/HttpZreSrv/requestSydroTimeSeries/CSV/UNDP_Kura,Kura,318,0,0,comma</nowiki></code>
===postTimeSeriesValues===
Setzen von Zeitreihenwerten (POST)

Beispiel: <code><nowiki>http://10.0.0.5:8092/TalsimNGServer/HttpZreSrv/postTimeSeriesValues</nowiki></code><br/>
Post data (raw text):
<source lang="xml" gutter="false">
<SydroTimeSeries>
<Client>UNDP_Kura</Client>
<Id>318</Id>
<Length>427</Length>
<Name>GE.Iori</Name>
<ResultMsg></ResultMsg>
<StationId>21</StationId>
<TimeSeriesString>
1975-01-01 00:00:00,0.09
1975-02-01 00:00:00,0.1
1975-03-01 00:00:00,0.3
1975-04-01 00:00:00,0.99
1975-05-01 00:00:00,1.19
1975-06-01 00:00:00,0.58
1975-07-01 00:00:00,0.22
1975-08-01 00:00:00,0.11
1975-09-01 00:00:00,0.09
1975-10-01 00:00:00,0.1
</TimeSeriesString>
</SydroTimeSeries>
</source>

===requestSydroZreBin===
Beispiel: <code><nowiki>http://talsim.de:8092/TalsimNGServer/HttpZreSrv/requestSydroZreBin/WFP_SSD,hubert,724,201001010000,201201010000,0</nowiki></code>

===refreshSydroZreBin===
Beispiel: <code><nowiki>http://localhost:8092/TalsimNGServer/HttpZreSrv/refreshSydroZreBin/All/WFP_SSD,hubert</nowiki></code>

Server-API

2019-10-25T13:38:17Z

HubertLohr:

<div class="achtung">Die Server-API befindet sich noch in der Entwicklungsphase, Änderungen sind zu erwarten</div>

Die Serverkomponente von Talsim-NG ([[TalsimNGSrv]]) bietet eine REST (HTTP) Schnittstelle (API), über die Daten abgerufen und an den Server übermittelt werden können. Daten werden über diese Schnittstelle im XML oder JSON Format ausgetauscht. Im Folgenden wird diese Schnittstelle dokumentiert:
__TOC__
<div class="info">In den unten angegebenen Beispielen wird als Server-Adresse <code>talsim.de</code> verwendet, dies ist mit der Adresse oder IP des tatsächlich verwendeten Talsim-Servers zu ersetzen.</div>
==HttpDataSrv==
Der HttpDataSrv Service dient zur Abfrage von Daten mit Bezug zum System, Systemvarianten, Listen zu Zeitreihen-Ordnern oder Zeitreihen. Der HttpDataSrv ist standardmäßig über den Port 8090 ansprechbar und bietet die folgenden Schnittstellen:
===requestClients===
Generelle Abfrage aller Kunden.

===requestCustomers===
Generelle Abfrage aller Kunden. Identisch zu <code>requestClients</code>

Beispiel: <code><nowiki>http://talsim.de:8090/TalsimNGServer/HttpDataSrv/requestCustomers/|</nowiki></code>
===requestZreDirectories===
Abfrage von Zeitreihen-Ordnern. Es werden Zeitreihen-Ordner mit ihren Zeitreihen zurückgegeben. Parameter sind <code>customer</code> und mit Komma getrennt ein "|".

Beispiel: <code><nowiki>http://talsim.de:8090/TalsimNGServer/HttpDataSrv/requestZreDirectories/Nile,|</nowiki></code>
===ZreDirectories===
Abfrage von Zeitreihen-Ordnern. Es werden nur Zeitreihen-Ordner zurückgegeben. Parameter sind <code>customer</code> und mit Komma getrennt ein "|".

Beispiel: <code><nowiki>http://talsim.de:8090/TalsimNGServer/HttpDataSrv/ZreDirectories/Nile,|</nowiki></code>

===requestZreFiles===
Abfrage von vorhandenen Zeitreihen. Parameter sind <code>customer</code>, <code>user</code> sowie die ID des Zeitreihen-Ordners. Ist die ID des Zeitreihen-Ordners 0, werden alle Zeitreihen zurückgegeben.

Beispiel: <code><nowiki>http://talsim.de:8090/TalsimNGServer/HttpDataSrv/requestZreFiles/Nile,hubert,16</nowiki></code>
===requestSystemAndSysVar===
Abfrage von Systemen und Systemvarianten

Beispiel: <code><nowiki>http://talsim.de:8090/TalsimNGServer/HttpDataSrv/requestSystemAndSysVar/WFP_SSD,hubert,1</nowiki></code>
==HttpZreSrv==
HttpZreSrv ist der zentrale Service zur Interaktion mit Zeitreihen. Der HttpZreSrv ist standardmäßig über den Port 8092 ansprechbar. Es gibt folgende Schnittstellen, um auf Zeitreihen und deren Metadaten zuzugreifen:

===SydroTimeSeries===
Abfrage einer Zeitreihe

Als Parameter sind zu übergeben <code>Customer</code>, <code>User</code>, <code>Id</code> der Zeitreihe, Weitere Parameter sind aktuell noch ein SQL Statement <code>SQLCriteria</code> oder alternativ drei Parameter als <code>Startdate</code>, <code>Enddate</code> und <code>AttributeFlag</code>. Das SQL Statement ist momentan nur zum Testen aktiviert und wird wenn alle anderen Endpoints gesetzt sind wieder eingestellt.
Wenn Startdate und Enddate mit <code>0</code> angegeben werden, wird die gesamte Zeitreihe gelesen. Um nur einen Teil der Zeitreihe zu bekommen, können Anfang und/oder Ende mit Datumsformat <code>yyyy-MM-dd HH:mm</code> (z.B. <code>2010-08-15 08:00</code>) angegeben werden.

Beispiel 1: <code><nowiki>http://talsim.de:8092/TalsimNGServer/HttpZreSrv/SydroTimeSeries/TestAPI,MusterUser,9999,attribFlag=0</nowiki></code>

===SydroTimeSeries/combine===
Kombinieren von zwei Zeitreihen. Dies ist zum Beispiel ein Szenario zum Verbinden einer Messzeitreihe mit Vorhersagedaten.

Als Parameter sind zu übergeben <code>customer</code>, <code>user</code>, <code>id1</code>, <code>id2</code>,<code>startdate1</code>, <code>endstartdate</code>, <code>enddate2</code>, <code>flag1</code>,<code>flag2</code>. <code>Id1</code> bezieht sich auf die erste Zeitreihe und <code>Id2</code> auf die welche angehängt wird. <code>Startdate1</code> definiert wo die erste Zeitreihe anfangen soll, <code>endstartdate</code> wo diese aufhöhrt und die zweite beginnen soll und <code>enddate2</code> das Enddatum der zweiten Reihe. Ist <code>enddate2</code> 0 oder leer wird bis zum Ende der zweiten Zeitreihe gelesen.

Beispiel 1: <code><nowiki>http://talsim.de:8092/TalsimNGServer/HttpZreSrv/SydroTimeSeries/combine/TestAPI,MusterUser,9999,8888,2019-02-01 00:00,2019-10-01 00:00, 0,0</nowiki></code>

===SydroTimeSeries===
Erstellen einer neuen Zeitreihen oder Überschreiben einer bestehenden Zeitreihe

Wird ein POST Aufruf mit dem SydroTimeSeries Objekt gestartet, kann eine Zeitreihe neu erstellt oder eine bestehende überschrieben werden. Soll eine bestehende Zeitreihe überschrieben oder ergänzt werden, muss das Attribute <code>ID</code> gesetzt sein. Soll eine neue Zeitreihen angelegt werden, muss <code>ID</code> gleich 0 sein. Das Objekt SydroTimeSeries besitzt folgende Struktur:

<pre>
<SydroTimeSeries>
<Attribute> (short)
<Customer> (string)
<DateValuePairSeparator> (string) shows how Date/Value Pairs in TimeSeriesString can be split
<ErrorValue> (double) Indicator what is an error value, will be replaced by NaN.
<HasError> (boolean) shows if an error occured during processing the request
<Id> (Integer) ID of time series. If ID=0 when POST is performed a new time series will be created and the new ID will be returned
<Length> (integer) Number or records in the TimeSeriesString
<Lat> (double) Latitude coordinate
<Lon> (double) Longitude coordinate
<Name> (string) Short name of the time series
<Path> (string) Path to the time series on the server
<ResultMsg> (string) Plain text describing errors if any or return a success message
<SaveMetadata> (boolean) Indicates whether or not metadata should be updated when posting time series values <Separator> (string) indicates how date/values can be split
<StationId> (integer) ID of the station
<TimeSeriesHeader> (string) Indicates how one time series entry must be interpreted, e.g. "Date,Value,Flag" if one entry has date/value/flag attributes.
<TimeSeriesString> (string) This is the time series as text, where date/values are separated by the attribute <Separator> and entries are separated by <DateValuePairSeparator>
Example: <TimeSeriesString>2001-01-01 00:00:00,3.106106,0#2001-01-02 00:00:00,4.209204,0#2001-01-03 00:00:00,0.1453788,#2002-01-02 00:00:00,0,0</TimeSeriesString>
<TsClass> (short) Represents the time series class with -1= unknown, 0=Default, 1=Flagged, 2=Forecast
<Unit> (string) gives the unit string, e.g. mm or m3/s
<User>Name of the user requesting or posting the time series or the owner of the time series.
</SydroTimeSeries>
</pre>

===SydroTimeSeries/delete===
Löschen einer Zeitreihe.

Als Parameter sind zu übergeben <code>Customer</code>, <code>User</code>, <code>Id</code>.

===SydroTimeSeries/attributes===
Abfrage oder Setzen von Metadaten zu einer Zeitreihe

Werden als Parameter <code>Customer</code>, <code>User</code>, <code>Id</code> übergeben, erhält man als Antwort einen String im Format FeldName=Wert getrennt durch "#" Zeichen, der alle Metadaten der Zeitreihe zeigt. Wird zusätzlich ein weiterer Parameter <code>KeyValuePairs</code> übergeben, so setzt man Metadaten. Der String KeyValuePairs muss im Format Feldname=Wert getrennt durch "#" angegeben sein. Die gegebenen Eigenschaften werden gespeichert, vorausgesetzt es handelt sich nicht um geschützte Felder.

Alternativ kann auch mittels POST ein SydroTimeSeriesAttributes Objekt gesendet werden, welches die zu schreibenden Eigenschaften beinhaltet.

===SydroTimeSeries/attributes/fieldnames===
Dieser Aufruf gibt alle Feldnamen der Metadaten getrennt durch Komma zurück.

===SydroTimeSeries/fieldnames===
Dieser Aufruf gibt alle Feldnamen der Zeitreihentabelle getrennt durch Komma zurück.

===SydroTimeSeries/flags===
Mit diesem Aufruf erhält man alle in der Zeitreihe verwendeten Flags. Erforderliche Parameter sind <code>Customer</code>, <code>User</code>, <code>Id</code>

===SydroTimeSeries/class===
Mit diesem Aufruf erhält man die Klasse einerZeitreihe, also -1= unknown, 0=Default, 1=Flagged, 2=Forecast. Erforderliche Parameter sind <code>Customer</code>, <code>User</code>, <code>Id</code>

===requestSydroTimeSeries===
Abfrage einer Zeitreihe

Als Parameter sind zu übergeben <code>Customer</code>, <code>User</code>, <code>Id</code> der Zeitreihe, <code>Startdate</code>, <code>Enddate</code> und <code>Separator</code> (Trennzeichen für den CSV-Inhalt)

===requestSydroTimeSeries===
Abfrage einer Zeitreihe

Als Parameter sind zu übergeben <code>Customer</code>, <code>User</code>, <code>Id</code> der Zeitreihe, <code>Startdate</code>, <code>Enddate</code> und <code>Separator</code> (Trennzeichen für den CSV-Inhalt)

Wenn Startdate und Enddate mit <code>0</code> angegeben werden, wird die gesamte Zeitreihe gelesen. Um nur einen Teil der Zeitreihe zu bekommen, können Anfang und/oder Ende mit Datumsformat <code>dd.MM.yyyy HH:mm</code> (z.B. <code>01.01.2010 00:00</code>) oder <code>yyyyMMddHHmm</code> (z.B. <code>201001010000</code>) angegeben werden.

Beispiel: <code><nowiki>http://talsim.de:8092/TalsimNGServer/HttpZreSrv/requestSydroTimeSeries/CSV/UNDP_Kura,Kura,318,0,0,comma</nowiki></code>
===postTimeSeriesValues===
Setzen von Zeitreihenwerten (POST)

Beispiel: <code><nowiki>http://10.0.0.5:8092/TalsimNGServer/HttpZreSrv/postTimeSeriesValues</nowiki></code><br/>
Post data (raw text):
<source lang="xml" gutter="false">
<SydroTimeSeries>
<Client>UNDP_Kura</Client>
<Id>318</Id>
<Length>427</Length>
<Name>GE.Iori</Name>
<ResultMsg></ResultMsg>
<StationId>21</StationId>
<TimeSeriesString>
1975-01-01 00:00:00,0.09
1975-02-01 00:00:00,0.1
1975-03-01 00:00:00,0.3
1975-04-01 00:00:00,0.99
1975-05-01 00:00:00,1.19
1975-06-01 00:00:00,0.58
1975-07-01 00:00:00,0.22
1975-08-01 00:00:00,0.11
1975-09-01 00:00:00,0.09
1975-10-01 00:00:00,0.1
</TimeSeriesString>
</SydroTimeSeries>
</source>

===requestSydroZreBin===
Beispiel: <code><nowiki>http://talsim.de:8092/TalsimNGServer/HttpZreSrv/requestSydroZreBin/WFP_SSD,hubert,724,201001010000,201201010000,0</nowiki></code>

===refreshSydroZreBin===
Beispiel: <code><nowiki>http://localhost:8092/TalsimNGServer/HttpZreSrv/refreshSydroZreBin/All/WFP_SSD,hubert</nowiki></code>

Server-API

2019-10-25T13:35:39Z

HubertLohr:

<div class="achtung">Die Server-API befindet sich noch in der Entwicklungsphase, Änderungen sind zu erwarten</div>

Die Serverkomponente von Talsim-NG ([[TalsimNGSrv]]) bietet eine REST (HTTP) Schnittstelle (API), über die Daten abgerufen und an den Server übermittelt werden können. Daten werden über diese Schnittstelle im XML oder JSON Format ausgetauscht. Im Folgenden wird diese Schnittstelle dokumentiert:
__TOC__
<div class="info">In den unten angegebenen Beispielen wird als Server-Adresse <code>talsim.de</code> verwendet, dies ist mit der Adresse oder IP des tatsächlich verwendeten Talsim-Servers zu ersetzen.</div>
==HttpDataSrv==
Der HttpDataSrv Service dient zur Abfrage von Daten mit Bezug zum System, Systemvarianten, Listen zu Zeitreihen-Ordnern oder Zeitreihen. Der HttpDataSrv ist standardmäßig über den Port 8090 ansprechbar und bietet die folgenden Schnittstellen:
===requestClients===
Generelle Abfrage aller Kunden.

===requestCustomers===
Generelle Abfrage aller Kunden. Identisch zu <code>requestClients</code>

Beispiel: <code><nowiki>http://talsim.de:8090/TalsimNGServer/HttpDataSrv/requestCustomers/|</nowiki></code>
===requestZreDirectories===
Abfrage von Zeitreihen-Ordnern. Es werden Zeitreihen-Ordner mit ihren Zeitreihen zurückgegeben. Parameter sind <code>customer</code> und mit Komma getrennt ein "|".

Beispiel: <code><nowiki>http://talsim.de:8090/TalsimNGServer/HttpDataSrv/requestZreDirectories/Nile,|</nowiki></code>
===ZreDirectories===
Abfrage von Zeitreihen-Ordnern. Es werden nur Zeitreihen-Ordner zurückgegeben. Parameter sind <code>customer</code> und mit Komma getrennt ein "|".

Beispiel: <code><nowiki>http://talsim.de:8090/TalsimNGServer/HttpDataSrv/ZreDirectories/Nile,|</nowiki></code>

===requestZreFiles===
Abfrage von vorhandenen Zeitreihen. Parameter sind <code>customer</code>, <code>user</code> sowie die ID des Zeitreihen-Ordners. Ist die ID des Zeitreihen-Ordners 0, werden alle Zeitreihen zurückgegeben.

Beispiel: <code><nowiki>http://talsim.de:8090/TalsimNGServer/HttpDataSrv/requestZreFiles/Nile,hubert,16</nowiki></code>
===requestSystemAndSysVar===
Abfrage von Systemen und Systemvarianten

Beispiel: <code><nowiki>http://talsim.de:8090/TalsimNGServer/HttpDataSrv/requestSystemAndSysVar/WFP_SSD,hubert,1</nowiki></code>
==HttpZreSrv==
HttpZreSrv ist der zentrale Service zur Interaktion mit Zeitreihen. Der HttpZreSrv ist standardmäßig über den Port 8092 ansprechbar. Es gibt folgende Schnittstellen, um auf Zeitreihen und deren Metadaten zuzugreifen:

===SydroTimeSeries/combine===
Kombinieren von zwei Zeitreihen. Dies ist zum Beispiel ein Szenario zum Verbinden einer Messzeitreihe mit Vorhersagedaten.

Als Parameter sind zu übergeben <code>customer</code>, <code>user</code>, <code>id1</code>, <code>id2</code>,<code>startdate1</code>, <code>endstartdate</code>, <code>enddate2</code>, <code>flag1</code>,<code>flag2</code>. <code>Id1</code> bezieht sich auf die erste Zeitreihe und <code>Id2</code> auf die welche angehängt wird. <code>Startdate1</code> definiert wo die erste Zeitreihe anfangen soll, <code>endstartdate</code> wo diese aufhöhrt und die zweite beginnen soll und <code>enddate2</code> das Enddatum der zweiten Reihe. Ist <code>enddate2</code> 0 oder leer wird bis zum Ende der zweiten Zeitreihe gelesen.
Wenn Startdate und Enddate mit <code>0</code> angegeben werden, wird die gesamte Zeitreihe gelesen. Um nur einen Teil der Zeitreihe zu bekommen, können Anfang und/oder Ende mit Datumsformat <code>yyyy-MM-dd HH:mm</code> (z.B. <code>2010-08-15 08:00</code>) angegeben werden.

Beispiel 1: <code><nowiki>http://talsim.de:8092/TalsimNGServer/HttpZreSrv/SydroTimeSeries/TestAPI,MusterUser,9999,attribFlag=0</nowiki></code>

Beispiel 2: <code><nowiki>http://talsim.de:8092/TalsimNGServer/HttpZreSrv/SydroTimeSeries/TestAPI,MusterUser,9999,2001-05-15 00:00,2001-10-15 00:00,-1</nowiki></code>

===SydroTimeSeries===
Abfrage einer Zeitreihe

Als Parameter sind zu übergeben <code>Customer</code>, <code>User</code>, <code>Id</code> der Zeitreihe, Weitere Parameter sind aktuell noch ein SQL Statement <code>SQLCriteria</code> oder alternativ drei Parameter als <code>Startdate</code>, <code>Enddate</code> und <code>AttributeFlag</code>. Das SQL Statement ist momentan nur zum Testen aktiviert und wird wenn alle anderen Endpoints gesetzt sind wieder eingestellt.
Wenn Startdate und Enddate mit <code>0</code> angegeben werden, wird die gesamte Zeitreihe gelesen. Um nur einen Teil der Zeitreihe zu bekommen, können Anfang und/oder Ende mit Datumsformat <code>yyyy-MM-dd HH:mm</code> (z.B. <code>2010-08-15 08:00</code>) angegeben werden.

Beispiel 1: <code><nowiki>http://talsim.de:8092/TalsimNGServer/HttpZreSrv/SydroTimeSeries/TestAPI,MusterUser,9999,attribFlag=0</nowiki></code>

===SydroTimeSeries===
Erstellen einer neuen Zeitreihen oder Überschreiben einer bestehenden Zeitreihe

Wird ein POST Aufruf mit dem SydroTimeSeries Objekt gestartet, kann eine Zeitreihe neu erstellt oder eine bestehende überschrieben werden. Soll eine bestehende Zeitreihe überschrieben oder ergänzt werden, muss das Attribute <code>ID</code> gesetzt sein. Soll eine neue Zeitreihen angelegt werden, muss <code>ID</code> gleich 0 sein. Das Objekt SydroTimeSeries besitzt folgende Struktur:

<pre>
<SydroTimeSeries>
<Attribute> (short)
<Customer> (string)
<DateValuePairSeparator> (string) shows how Date/Value Pairs in TimeSeriesString can be split
<ErrorValue> (double) Indicator what is an error value, will be replaced by NaN.
<HasError> (boolean) shows if an error occured during processing the request
<Id> (Integer) ID of time series. If ID=0 when POST is performed a new time series will be created and the new ID will be returned
<Length> (integer) Number or records in the TimeSeriesString
<Lat> (double) Latitude coordinate
<Lon> (double) Longitude coordinate
<Name> (string) Short name of the time series
<Path> (string) Path to the time series on the server
<ResultMsg> (string) Plain text describing errors if any or return a success message
<SaveMetadata> (boolean) Indicates whether or not metadata should be updated when posting time series values <Separator> (string) indicates how date/values can be split
<StationId> (integer) ID of the station
<TimeSeriesHeader> (string) Indicates how one time series entry must be interpreted, e.g. "Date,Value,Flag" if one entry has date/value/flag attributes.
<TimeSeriesString> (string) This is the time series as text, where date/values are separated by the attribute <Separator> and entries are separated by <DateValuePairSeparator>
Example: <TimeSeriesString>2001-01-01 00:00:00,3.106106,0#2001-01-02 00:00:00,4.209204,0#2001-01-03 00:00:00,0.1453788,#2002-01-02 00:00:00,0,0</TimeSeriesString>
<TsClass> (short) Represents the time series class with -1= unknown, 0=Default, 1=Flagged, 2=Forecast
<Unit> (string) gives the unit string, e.g. mm or m3/s
<User>Name of the user requesting or posting the time series or the owner of the time series.
</SydroTimeSeries>
</pre>

===SydroTimeSeries/delete===
Löschen einer Zeitreihe.

Als Parameter sind zu übergeben <code>Customer</code>, <code>User</code>, <code>Id</code>.

===SydroTimeSeries/attributes===
Abfrage oder Setzen von Metadaten zu einer Zeitreihe

Werden als Parameter <code>Customer</code>, <code>User</code>, <code>Id</code> übergeben, erhält man als Antwort einen String im Format FeldName=Wert getrennt durch "#" Zeichen, der alle Metadaten der Zeitreihe zeigt. Wird zusätzlich ein weiterer Parameter <code>KeyValuePairs</code> übergeben, so setzt man Metadaten. Der String KeyValuePairs muss im Format Feldname=Wert getrennt durch "#" angegeben sein. Die gegebenen Eigenschaften werden gespeichert, vorausgesetzt es handelt sich nicht um geschützte Felder.

Alternativ kann auch mittels POST ein SydroTimeSeriesAttributes Objekt gesendet werden, welches die zu schreibenden Eigenschaften beinhaltet.

===SydroTimeSeries/attributes/fieldnames===
Dieser Aufruf gibt alle Feldnamen der Metadaten getrennt durch Komma zurück.

===SydroTimeSeries/fieldnames===
Dieser Aufruf gibt alle Feldnamen der Zeitreihentabelle getrennt durch Komma zurück.

===SydroTimeSeries/flags===
Mit diesem Aufruf erhält man alle in der Zeitreihe verwendeten Flags. Erforderliche Parameter sind <code>Customer</code>, <code>User</code>, <code>Id</code>

===SydroTimeSeries/class===
Mit diesem Aufruf erhält man die Klasse einerZeitreihe, also -1= unknown, 0=Default, 1=Flagged, 2=Forecast. Erforderliche Parameter sind <code>Customer</code>, <code>User</code>, <code>Id</code>

===requestSydroTimeSeries===
Abfrage einer Zeitreihe

Als Parameter sind zu übergeben <code>Customer</code>, <code>User</code>, <code>Id</code> der Zeitreihe, <code>Startdate</code>, <code>Enddate</code> und <code>Separator</code> (Trennzeichen für den CSV-Inhalt)

===requestSydroTimeSeries===
Abfrage einer Zeitreihe

Als Parameter sind zu übergeben <code>Customer</code>, <code>User</code>, <code>Id</code> der Zeitreihe, <code>Startdate</code>, <code>Enddate</code> und <code>Separator</code> (Trennzeichen für den CSV-Inhalt)

Wenn Startdate und Enddate mit <code>0</code> angegeben werden, wird die gesamte Zeitreihe gelesen. Um nur einen Teil der Zeitreihe zu bekommen, können Anfang und/oder Ende mit Datumsformat <code>dd.MM.yyyy HH:mm</code> (z.B. <code>01.01.2010 00:00</code>) oder <code>yyyyMMddHHmm</code> (z.B. <code>201001010000</code>) angegeben werden.

Beispiel: <code><nowiki>http://talsim.de:8092/TalsimNGServer/HttpZreSrv/requestSydroTimeSeries/CSV/UNDP_Kura,Kura,318,0,0,comma</nowiki></code>
===postTimeSeriesValues===
Setzen von Zeitreihenwerten (POST)

Beispiel: <code><nowiki>http://10.0.0.5:8092/TalsimNGServer/HttpZreSrv/postTimeSeriesValues</nowiki></code><br/>
Post data (raw text):
<source lang="xml" gutter="false">
<SydroTimeSeries>
<Client>UNDP_Kura</Client>
<Id>318</Id>
<Length>427</Length>
<Name>GE.Iori</Name>
<ResultMsg></ResultMsg>
<StationId>21</StationId>
<TimeSeriesString>
1975-01-01 00:00:00,0.09
1975-02-01 00:00:00,0.1
1975-03-01 00:00:00,0.3
1975-04-01 00:00:00,0.99
1975-05-01 00:00:00,1.19
1975-06-01 00:00:00,0.58
1975-07-01 00:00:00,0.22
1975-08-01 00:00:00,0.11
1975-09-01 00:00:00,0.09
1975-10-01 00:00:00,0.1
</TimeSeriesString>
</SydroTimeSeries>
</source>

===requestSydroZreBin===
Beispiel: <code><nowiki>http://talsim.de:8092/TalsimNGServer/HttpZreSrv/requestSydroZreBin/WFP_SSD,hubert,724,201001010000,201201010000,0</nowiki></code>

===refreshSydroZreBin===
Beispiel: <code><nowiki>http://localhost:8092/TalsimNGServer/HttpZreSrv/refreshSydroZreBin/All/WFP_SSD,hubert</nowiki></code>

Server-API

2019-10-17T11:58:53Z

HubertLohr:

Server-API

2019-10-17T11:58:14Z

HubertLohr:

Server-API

2019-10-17T11:57:00Z

HubertLohr:

Server-API

2019-10-17T11:56:23Z

HubertLohr:

Server-API

2019-10-17T11:55:26Z

HubertLohr:

Server-API

2019-10-17T11:51:33Z

HubertLohr:

Server-API

2019-10-16T11:33:09Z

HubertLohr:

Server-API

2019-10-16T11:31:28Z

HubertLohr: