WSV
PEGELONLINE PEGELONLINE Webservices PEGELONLINE

Dokumentation Online-Visualisierung Ganglinien

nach oben

Überblick

Mit Online-Visualisierung Ganglinien können grafische Anzeigen aktueller gewässerkundlicher Zeitreihen (z.B. Wasserstandsdaten einer Messstelle der letzten drei Tage) dynamisch bezogen werden und in eine externe Webseite integriert werden.

Die Anwendung wird unter der Basis-URL
https://www.pegelonline.wsv.de/charts/OnlineVisualisierungGanglinie?
zur Verfügung gestellt. Nach dem Fragezeichen werden Parameter angegeben, die die Darstellung beeinflussen. Dabei ist der Parameter pegelnummer von mindestens einem Pegel zwingend erforderlich (es sind maximal vier Pegel möglich):
https://www.pegelonline.wsv.de/charts/OnlineVisualisierungGanglinie?pegelnummer=23700200

Eine Liste mit Pegelnummern steht hier zur Verfügung.

Weitere Parameter können mit einem & aneinander gehängt werden. (z.B. &imgBreite=400 oder &imgBreite=400&imgHoehe=180). Beispiele finden Sie weiter unten.
nach oben

URL-Parameter

NameWertumfangDefaultBeschreibung
pegelnummer   - Nummer eines darzustellenden Pegels in einer Einzelgrafik. Der Parameter kann wiederholt, bis zu vier mal, in einer Url auftreten. Darüber hinaus werden Pegelnummern ignoriert. Existiert eine solche Pegelnummer nicht in PEGELONLINE, so wird diese Nummer ebenfalls ignoriert.
imgBreite   400 Breite für alle Einzelgrafiken in Pixeln
imgHoehe   300 Höhe für alle Einzelgrafiken in Pixeln
schriftAchse   11 Schriftgröße der Achsenbeschriftung in Pixeln und der in den Grafiken angezeigten Pegelparametern
schriftPegelname   12 Schriftgröße der sich unterhalb der Grafik befindenden Beschriftung der Ganglinie (Pegelname, Gewässer usw.) in Pixeln
schriftLetzterWert   12 Schriftgröße der Anzeige des letzten Wertes in Pixeln
schriftUeberschrift   20 Schriftgröße der Überschrift
anordnung „block“ oder „untereinander“ „block“ Blockweise Darstellung, also 4-Felder-Darstellung oder untereinander.
pegelparameter   keine Pegelparameter Kommaseparierte Liste:
   Beispiel: pegelparameter=HSW,GLW
Die angegebenen Pegelparameter werden unterhalb der Gangliniengrafik angezeigt und, wenn innerhalb des Wertumfangs, dann auch in der Grafik als Linie mit Beschriftung. Die Reihenfolge der Pegelparameter aus der URL wird in der Beschriftung beibehalten.
dauer   72 Darzustellender Zeitraum, in Stunden, ab dem Zeitpunkt des Abrufs der Seite.
Beispiel: dauer=120 und aktueller Zeitpunkt 6.2.2007 11:30 bedeutet Darstellung von 1.2.2007 11:30 bis 6.2.2007 11:30, wobei Werte immer ungefähr einige Stunden vorher dem Zeitpunkt des Abrufs der Seite enden.
imgLinien   2 Linienbreite in Pixeln
parameter   „Wasserstand Rohdaten“ Name des Parameters, Groß- und Kleinschreibung spielt keine Rolle.
anzeigeUeberschrift „true“ oder „false“ „true“ Ein- oder Ausblenden des Logos und der Überschrift
textOben     optionaler Text, der unterhalb der Überschrift noch zusätzlich eingeblendet wird, nur dann wenn die Überschrift mit anzeigeUeberschrift angezeigt wird
textUnten   Default ist 1) Text, der unterhalb der Grafiken eingeblendet wird
minWerteumfang   Defaultmäßig wird auf den Werteumfang der Daten in Ganglinie skaliert. Werteumfang der y-Achse, der bei der Autoskalierung der Achse mindestens eingehalten wird. Gehen die Werte der Ganglinie über diesen Mindestumfang hinaus, so wird automatisch auf den größeren Ganglinienumfang skaliert.
Wird dieser Parameter nicht angegeben, dann erfolgt die vertikale Skalierung ausschließlich basierend auf den Werten in der Ganglinie.
anzeigeKilometer „true“ oder „false“ „false“ Dieser Parameter aktiviert die Anzeige des Kilometers an der Wasserstraße unterhalb der Gangliniendarstellung.
gesetzlicheZeit „true“ oder „false“ „true“ Hierüber wird bestimmt ob die Ganglinie in gesetzlicher Zeit dargestellt wird („true“), oder, ob die Ganglinie auch in der Sommerzeit in Mitteleuropäischer Winterzeit (MEZ) angezeigt wird („false“).

1)Die Messwerte sind ungeprüft und werden von den zuständigen Wasser- und Schifffahrtsämtern zur Verfügung gestellt.

nach oben

Elemente der Gangliniendarstellung


GanglinieOnlinevisualisierung.gif

1 Gesamtbreite und Höhe des Bildes. Einstellbar über Url-Parameter imgBreite und imgHoehe
2 Automatische Skalierung der y-Achse nach Werteumfang der Ganglinie. Am oberen Rand der Achse wird noch Raum gelassen, so dass sich die Anzeige des aktuellen Wertes und die Ganglinie nicht überschneiden können
3 Die Datumsachse richtet sich in ihrem Werteumfang nach dem Parameter dauer. Je nach gewählter Dauer und Breite des Images über imgBreite werden die Labels dynamisch formatiert nach folgenden Formaten.
- 17.02 6 12 18 18.02
- 17.2 12 18.02
- 17.2 18.2
- 17.2 19.2 21.2
- 17.2 21.2 25.2
Es wird immer die Beschriftungsform mit den größten Detailangaben automatisch gewählt, so lange sich die Labels nicht überlappen.
Im obigen Beispiel ist die zweite Beschriftungsform gewählt.
Die Schriftgrößte ist über der Url-Parameter schriftAchse konfigurierbar.
4 Angezeigt wird Gewässer, Pegelname, Geber und Maßeinheit. Die Schriftgrößte ist über den Url-Parameter schriftPegelname konfigurierbar.
5 Alle über den Url-Parameter pegelparameter angegebenen Pegelparameterkürzel werden hier aufgeführt, unabhängig davon ob sie in den Ganglinienwerteumfang fallen. In der Darstellung untereinander werden die Pegelparameter in einer zweiten Zeile aufgelistet. Die Schriftgrößte ist über der Url-Parameter schriftPegelname konfigurierbar.
6 Jeder zweite Tag wird grau schattiert, um eine bessere Erkennbarkeit des Tageswechsels zu erzielen. Der aktuelle Tag bleibt dabei immer weiß.
7 Die Dicke der Ganglinie (im Beispiel 2 Pixel) einstellbar über den Url-Parameter imgLinien
8 Darstellung des aktuellen (zuletzt gemessenen) Wertes mit Zeitpunkt und Masseinheit. Schriftgröße lässt sich über den Url-Parameter schriftLetzterWert einstellen.

nach oben

Beispiele

Darstellung des Pegels Maxau (23700200) mit den Pegelparametern HSW,MNW,MHW,MW, einer Bildbreite von 450 Pixeln und einem Zeitraum von 300 Stunden:

https://www.pegelonline.wsv.de/charts/OnlineVisualisierungGanglinie?pegelnummer=23700200
&imgBreite=450&pegelparameter=HSW,MNW,MHW,MW&dauer=300


Zusätzlich zum Pegel Maxau wird hier der Pegel Mainz mit den selben Einstellungen angezeigt (Standardeinstellung ist "im Block", also nebeneinander):

https://www.pegelonline.wsv.de/charts/OnlineVisualisierungGanglinie?pegelnummer=23700200&pegelnummer=25100100
&imgBreite=450&pegelparameter=HSW,MNW,MHW,MW&dauer=300


Die selben Pegel mit gleichen Einstellungen wie im vorangegangenen Beispiel, nur diesmal werden die Pegel untereinander dargestellt anstatt in der Standardeinstellung "im Block":

https://www.pegelonline.wsv.de/charts/OnlineVisualisierungGanglinie?pegelnummer=23700200&pegelnummer=25100100
&imgBreite=450&pegelparameter=HSW,MNW,MHW,MW&dauer=300&anordnung=untereinander


Darstellung von maximal 4 Küstenpegeln, untereinander:

https://www.pegelonline.wsv.de/charts/OnlineVisualisierungGanglinie?pegelnummer=4970020&pegelnummer=9360010
&pegelnummer=9360010&pegelnummer=9420010
&imgLinien=2
&anordnung=untereinander
&dauer=48
&imgBreite=800&imgHoehe=150
&pegelparameter=HSW,NNW,HHW,MNW,MW,GLW,MHW,NSW,RNW,ZS_I,ZS_II,M_I,M_II,TuGLW
&schriftPegelname=12&schriftAchse=11
&anzeigeUeberschrift=false
&anzeigeDatenquelle=true
&schriftLetzterWert=15


Folgende Darstellung der Ganglinie ist eine Einbettung per HTML iframe. Der dazugehörige HTML Code steht weiter unten.


<iframe
	src="https://www.pegelonline.wsv.de/charts/OnlineVisualisierungGanglinie?pegelnummer=23700200&dauer=72&imgLinien=2&anordnung=untereinander&imgBreite=930&imgHoehe=250&schriftPegelname=12&schriftAchse=11&anzeigeUeberschrift=false&anzeigeDatenquelle=true&schriftLetzterWert=15"
	scrolling="no"
	marginheight="10"
	marginwidth="0"
	frameborder="0"
	width="945"
	height="300"
	style="">
</iframe>

nach oben