Difference between pages "Add-On Services/de" and "Templates/de"
From meteoplug
(Difference between pages)
(Created page with "Jedes Sensordatenpaket enthält immer die Felder "date" und "id". Die anderen Parameter sind sensorspezifisch. Die beudtung der Parameter ist wie folgt: * '''date''': UTC Zeit...") |
|||
| Line 1: | Line 1: | ||
__NOTOC__ | __NOTOC__ | ||
| − | <languages /><br /> | + | <languages /><br />Meteobridge stellt einen sehr flexiblen Ersetzungsmechanismus zur Verfügung, mit dem definierte Variable durch konkrete Sensorwerte ersetzt werden. Dies erlaubt in beliebigen Zeichenketten Meteobridge Variable "einzuschmuggeln", seien es E-Mail, HTML-Seiten, Alarmbedingungen, etc. |
| − | + | Die Variable werden in dem Moment, in dem die Zeichenkette an den Upload zum Zieldienst übergeben wird surch reale Werte ersetzte. Kann das Datenpaket nicht zugestellt werden, wird die Zustellung gegebenenfalls wiederholt, jedoch mit den bei der Erstbeauftragung eingesetzten Daten. | |
| − | + | ||
| − | + | ||
| − | + | Jede Variable beginnt und endet mit einer eckigen Klammer "[" und "]". Die Variable in diesen Klammern zeigt die folgende Struktur: <pre>Sensor-Selektor=Konverter.Dezimalstellen:Ersatzzeichenkette</pre> | |
| − | + | "Konverter", "Dezimalstellen" und "Ersatzzeichenkette" kann weggelassen werden, "Sensor" und "Selektor" müssen angegeben werden. | |
| − | + | Während "Sensor" festlegt, um welchen Sensor es sich handelt und welcher Sensorwert verwendten werden soll, gibt "Selektor" an, welche Zeitperiode ausgewertet werden soll. Mit "Konverter" kann optional eine Umrechnung in andere Maßeinheiten realisiert werden. Die "Dezimalstellen"-Angabe bestimmt die numerische Auflösung der Daten und die "Ersatzzeichenkette" bestimmt den Wert, der ausgegeben wird, wenn kein Sensorwert für den definierten Zeitraum vorliegt. | |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ==Sensoren== | |
| − | * ''' | + | Diese Sensoren sind in Meteobridge definiert: |
| − | * ''' | + | * '''th0temp''': Außentemperatur in Grad Celsius |
| − | * ''' | + | * '''th0hum''': Relative Außenluftfeuchte in Prozent |
| − | * ''' | + | * '''th0dew''': Außentaupunkttemperatur in Grad Celsius |
| − | * ''' | + | * '''thb0temp''': Innentemperatur in Grad Celsius |
| − | * ''' | + | * '''thb0hum''': Innenluftfeuchte in Prozent |
| − | * ''' | + | * '''thb0dew''': Innentaupunkttemperatur in Grad Celsius |
| − | * ''' | + | * '''thb0press''': Stationsluftdruck in hPa |
| − | * ''' | + | * '''thb0seapress''': auf Meeresspiegelhöhe berechneter Luftdruck in hPa |
| − | * ''' | + | * '''wind0wind''': ungemittelte Windgeschindigkeit in m/s |
| − | * ''' | + | * '''wind0avgwind''': gemittelte Windgeschindigkeit in m/s |
| − | * ''' | + | * '''wind0dir''': Windrichtung in Grad (0° ist Norden) |
| − | * ''' | + | * '''wind0chill''': Windchill-Temperatur in Grad Celsius |
| − | * ''' | + | * '''rain0rate''': Regenrate in mm/h |
| − | * ''' | + | * '''rain0total''': gefallene Regenmenge in mm |
| − | + | * '''uv0index''': UV-Index | |
| + | * '''sol0rad''': Solarstrahlung in W/m^2 | ||
| + | Wenn ein Sensor nicht existiert oder seine Daten älter als das maximal tolerierte Sensordatenalter sind, wird Meteohub keine Daten einsetzen und sofern definiert, stattdessen die Ersatzzeichenkette einsetzen. Falls keine Ersatzzeichenkette definiert ist, bleibt die Variable unersetzt als Zeichenkette stehen. | ||
| − | == | + | ==Selektor== |
| − | + | Den "Sensoren" folgt eine Selektorbezeichnung (durch ein "-" getrennt) mit der der auszuwertende Zeitraum oder Zeitpunkt angegeben wird. Die folgenden Selektoren sind definiert: | |
| + | * '''act''': aktuelle Daten | ||
| + | * '''hmin''': Minimum der aktuellen Stunde | ||
| + | * '''hmax''': Maximum der aktuellen Stunde | ||
| + | * '''dmin''': Minimum von Heute | ||
| + | * '''dmax''': Maximum von Heute | ||
| + | * '''ydmin''': Minimum von Gestern | ||
| + | * '''ydmax''': Maximum von Gestern | ||
| + | * '''mmin''': Minimum dieses Monats | ||
| + | * '''mmax''': Maximum dieses Monats | ||
| + | * '''ymin''': Minimum dieses Jahres | ||
| + | * '''ymax''': Maximum dieses Jahres | ||
| + | * '''amin''': Minimum des gesamten Aufzeichnungszeitraumes | ||
| + | * '''amax''': Maximum des gesamten Aufzeichnungszeitraumes | ||
| + | * '''daysum oder sumday''', '''ydaysum''', '''monthsum''', '''yearsum''', '''allsum''', '''ydaysum''': selektiert die Summe an Inkremente für Heute, Gestern, diesen Monat, dieses Jahr, gesamten Aufzeichnungszeitraum. Beispiel: "rain0total-sumday" ist die heutige Regenmenge. | ||
| − | + | Neben obigen Selektoren, die fest definierte Zeitfenster selektieren, kann mit den folgenden Selektoren eine Auswertung für einen relativen Zeitraum in die Vergangenheit durchgeführt serden. Die Rückschau reicht wegen der begrenzten Speicherausstattung der Meteobridge nur bis zu 60 Minuten in die Vergangenheit. | |
| − | + | * '''max2''', '''max5''', '''max10''', '''max15''', '''max30''', '''max60''': selektiert das Maximum der letzten 2, 5, 10, 15, 30 oder 60 Minuten | |
| − | + | * '''min2''', '''min5''', '''min10''', '''min15''', '''min30''', '''min60''': selektiert das Minimum der letzten 2, 5, 10, 15, 30 oder 60 Minuten | |
| − | + | * '''avg2''', '''avg5''', '''avg10''', '''avg15''', '''avg30''', '''avg60''': selektiert den Durchschnitt der letzten 2, 5, 10, 15, 30 oder 60 Minuten | |
| + | * '''sum2''', '''sum5''', '''sum10''', '''sum15''', '''sum30''', '''sum60''': selektiert zusammengerechnete Deltawerte der letzten 2, 5, 10, 15, 30 oder 60 Minuten, welches zum Berechnen der gefallenen Regenmenge im definierten Zeitraum erforderlich ist. Beispiel: "rain0total-sum60" ergebit die gefallene Regenmenge in mm der letzten 60 Minuten. | ||
| + | |||
| + | ==Konverter== | ||
| + | Dei Sensordaten werden als Voreinstellung in ISO Einheiten berichtet (°C, hPa, mm, m/s). Durch den Einsatz von Konvertern können die Einheiten auf non-ISO Einheiten umgerechnet werden. Definierte Konverter sind: | ||
| + | * '''F''' wandelt die Temperature von Celsius in Fahrenheit um. | ||
| + | * '''psi''' wandelt Luftdruck von hPa (entspricht auch mbar) in psi um. | ||
| + | * '''mmHg''' wandelt Luftdruck von hPa in Millimeter Quecksilbersäule um. | ||
| + | * '''inHg''' wandelt Luftdruck von hPa in Inch Quecksilbersäule um. | ||
| + | * '''kmh''' wandelt Windgeschwindigkeit von m/s in Kilometer pro Stunde um. | ||
| + | * '''mph''' wandelt Windgeschwindigkeit von m/s in Meilen pro Stunde um. | ||
| + | * '''kn''' wandelt Windgeschwindigkeit von m/s in Knoten um. | ||
| + | * '''bft''' wandelt Windgeschwindigkeit von m/s in die Beaufort-Skala um. | ||
| + | * '''in''' wandelt der Regenmenge von mm in Inch um. | ||
| + | Wird eine unbekannte Konvertierung gewählt, findet keine Umrechnung statt un es erfolgt keine Fehlermeldung. | ||
| + | |||
| + | ==Spezialvariable== | ||
| + | Es sind eine Reihe von Spezialvariable definiert, die nicht dem Schema "Sensor-Selektor=Konverter" entsprechen, sondern einer Sonderbedeutung haben. | ||
| + | |||
| + | Datum und Uhrzeit ist wie folgt definiert: | ||
| + | * '''YYYY''': Jahr, vierstellig | ||
| + | * '''YY''': Jahr, zweistellig | ||
| + | * '''MM''': Monat, zweistellig (ggf mit führender Null) | ||
| + | * '''M''': Monat (ohne führende Null) | ||
| + | * '''DD''': Tag, zweistellig (ggf mit führender Null) | ||
| + | * '''D''': Tag (ohne führende Null) | ||
| + | * '''hh''': Stunde, zweistellig (ggf mit führende Null) | ||
| + | * '''h''': Stunde (ohne führende Null) | ||
| + | * '''mm''': Minuten, zweistellig (ggf mit führender Null) | ||
| + | * '''m''': Minuten (ohne führende Null) | ||
| + | * '''ss''': Sekunden, zweistellig (ggf mit führender Null) | ||
| + | * '''s''': Sekunden (ohne führende NuLL) | ||
| + | Wenn ein großes "U" vorangestellt ist, wird mit Weltzeit gearbeitet (UTC), ansonsten mit lokaler Zeit. Beispiel: "[Uhh]:[Umm]:[Uss] UTC" wird zu einer Zeichenkette der Art "16:03:33 UTC" übersetzt | ||
| + | |||
| + | ==Nachkommastellen== | ||
| + | Sofern nicht anders definiert werden Zahlen mit einer Dezimalstelle berichtet. Durch Setzen des Wertes für die Nachkommastellen kann die Anzahl der bei der Ausgabe verwendten Dezimalstellen bestimmt werden. | ||
| + | |||
| + | ==Ersatzzeichenkette== | ||
| + | Wenn eine Variable nicht definiert ist oder keinen gültigen Wert liefern kann, wird die spezifizierte Ersatzzeichenkette ausgegeben, die auch leer sein kann. Fehlt die Angabe der Ersatzzeichenkette bleibt die Variabledefinition unverändert in der Zeichenkette stehen und wird nicht ersetzt. | ||
| + | |||
| + | ==Beispiele== | ||
| + | Anbei ein paar Beispiele, die helfen, den Ersetzungsmechanismus besser zu verstehen. | ||
| + | |||
| + | # Template <font face="Courier"><span style="background-color:lightgrey;">Outdoor temperature is [th0temp-act=F.1:--]°F</span></font face> wird umgewandelt in <font face="Courier"><span style="background-color:lightgrey;">Outdoor temperature is 3.4°F</span></font face>, wenn keine Außentemperatur vorliegt erscheint <font face="Courier"><span style="background-color:lightgrey;">Outdoor temperature is --°F</span></font face>. | ||
| + | # Template <font face="Courier"><span style="background-color:lightgrey;">Local time is [hh]:[mm]</span></font face> wird umgewandelt in <font face="Courier"><span style="background-color:lightgrey;">Local time is 09:27</span></font face>. | ||
| + | # Template <font face="Courier"><span style="background-color:lightgrey;">Max gust in last 10 minutes was: [wind0wind-max10.1:--]m/s, [wind0wind-max10=mph.1:--]mph, [wind0wind-max10=kn.0:--]kn</span></font face> wird umgewandelt in <font face="Courier"><span style="background-color:lightgrey;">Max gust in last 10 minutes was: 10.5m/s, 23.5mph, 20kn</span></font face>. | ||
Revision as of 00:47, 26 February 2013
Meteobridge stellt einen sehr flexiblen Ersetzungsmechanismus zur Verfügung, mit dem definierte Variable durch konkrete Sensorwerte ersetzt werden. Dies erlaubt in beliebigen Zeichenketten Meteobridge Variable "einzuschmuggeln", seien es E-Mail, HTML-Seiten, Alarmbedingungen, etc.
Die Variable werden in dem Moment, in dem die Zeichenkette an den Upload zum Zieldienst übergeben wird surch reale Werte ersetzte. Kann das Datenpaket nicht zugestellt werden, wird die Zustellung gegebenenfalls wiederholt, jedoch mit den bei der Erstbeauftragung eingesetzten Daten.
Jede Variable beginnt und endet mit einer eckigen Klammer "[" und "]". Die Variable in diesen Klammern zeigt die folgende Struktur:Sensor-Selektor=Konverter.Dezimalstellen:Ersatzzeichenkette
"Konverter", "Dezimalstellen" und "Ersatzzeichenkette" kann weggelassen werden, "Sensor" und "Selektor" müssen angegeben werden. Während "Sensor" festlegt, um welchen Sensor es sich handelt und welcher Sensorwert verwendten werden soll, gibt "Selektor" an, welche Zeitperiode ausgewertet werden soll. Mit "Konverter" kann optional eine Umrechnung in andere Maßeinheiten realisiert werden. Die "Dezimalstellen"-Angabe bestimmt die numerische Auflösung der Daten und die "Ersatzzeichenkette" bestimmt den Wert, der ausgegeben wird, wenn kein Sensorwert für den definierten Zeitraum vorliegt.
Sensoren
Diese Sensoren sind in Meteobridge definiert:
- th0temp: Außentemperatur in Grad Celsius
- th0hum: Relative Außenluftfeuchte in Prozent
- th0dew: Außentaupunkttemperatur in Grad Celsius
- thb0temp: Innentemperatur in Grad Celsius
- thb0hum: Innenluftfeuchte in Prozent
- thb0dew: Innentaupunkttemperatur in Grad Celsius
- thb0press: Stationsluftdruck in hPa
- thb0seapress: auf Meeresspiegelhöhe berechneter Luftdruck in hPa
- wind0wind: ungemittelte Windgeschindigkeit in m/s
- wind0avgwind: gemittelte Windgeschindigkeit in m/s
- wind0dir: Windrichtung in Grad (0° ist Norden)
- wind0chill: Windchill-Temperatur in Grad Celsius
- rain0rate: Regenrate in mm/h
- rain0total: gefallene Regenmenge in mm
- uv0index: UV-Index
- sol0rad: Solarstrahlung in W/m^2
Wenn ein Sensor nicht existiert oder seine Daten älter als das maximal tolerierte Sensordatenalter sind, wird Meteohub keine Daten einsetzen und sofern definiert, stattdessen die Ersatzzeichenkette einsetzen. Falls keine Ersatzzeichenkette definiert ist, bleibt die Variable unersetzt als Zeichenkette stehen.
Selektor
Den "Sensoren" folgt eine Selektorbezeichnung (durch ein "-" getrennt) mit der der auszuwertende Zeitraum oder Zeitpunkt angegeben wird. Die folgenden Selektoren sind definiert:
- act: aktuelle Daten
- hmin: Minimum der aktuellen Stunde
- hmax: Maximum der aktuellen Stunde
- dmin: Minimum von Heute
- dmax: Maximum von Heute
- ydmin: Minimum von Gestern
- ydmax: Maximum von Gestern
- mmin: Minimum dieses Monats
- mmax: Maximum dieses Monats
- ymin: Minimum dieses Jahres
- ymax: Maximum dieses Jahres
- amin: Minimum des gesamten Aufzeichnungszeitraumes
- amax: Maximum des gesamten Aufzeichnungszeitraumes
- daysum oder sumday, ydaysum, monthsum, yearsum, allsum, ydaysum: selektiert die Summe an Inkremente für Heute, Gestern, diesen Monat, dieses Jahr, gesamten Aufzeichnungszeitraum. Beispiel: "rain0total-sumday" ist die heutige Regenmenge.
Neben obigen Selektoren, die fest definierte Zeitfenster selektieren, kann mit den folgenden Selektoren eine Auswertung für einen relativen Zeitraum in die Vergangenheit durchgeführt serden. Die Rückschau reicht wegen der begrenzten Speicherausstattung der Meteobridge nur bis zu 60 Minuten in die Vergangenheit.
- max2, max5, max10, max15, max30, max60: selektiert das Maximum der letzten 2, 5, 10, 15, 30 oder 60 Minuten
- min2, min5, min10, min15, min30, min60: selektiert das Minimum der letzten 2, 5, 10, 15, 30 oder 60 Minuten
- avg2, avg5, avg10, avg15, avg30, avg60: selektiert den Durchschnitt der letzten 2, 5, 10, 15, 30 oder 60 Minuten
- sum2, sum5, sum10, sum15, sum30, sum60: selektiert zusammengerechnete Deltawerte der letzten 2, 5, 10, 15, 30 oder 60 Minuten, welches zum Berechnen der gefallenen Regenmenge im definierten Zeitraum erforderlich ist. Beispiel: "rain0total-sum60" ergebit die gefallene Regenmenge in mm der letzten 60 Minuten.
Konverter
Dei Sensordaten werden als Voreinstellung in ISO Einheiten berichtet (°C, hPa, mm, m/s). Durch den Einsatz von Konvertern können die Einheiten auf non-ISO Einheiten umgerechnet werden. Definierte Konverter sind:
- F wandelt die Temperature von Celsius in Fahrenheit um.
- psi wandelt Luftdruck von hPa (entspricht auch mbar) in psi um.
- mmHg wandelt Luftdruck von hPa in Millimeter Quecksilbersäule um.
- inHg wandelt Luftdruck von hPa in Inch Quecksilbersäule um.
- kmh wandelt Windgeschwindigkeit von m/s in Kilometer pro Stunde um.
- mph wandelt Windgeschwindigkeit von m/s in Meilen pro Stunde um.
- kn wandelt Windgeschwindigkeit von m/s in Knoten um.
- bft wandelt Windgeschwindigkeit von m/s in die Beaufort-Skala um.
- in wandelt der Regenmenge von mm in Inch um.
Wird eine unbekannte Konvertierung gewählt, findet keine Umrechnung statt un es erfolgt keine Fehlermeldung.
Spezialvariable
Es sind eine Reihe von Spezialvariable definiert, die nicht dem Schema "Sensor-Selektor=Konverter" entsprechen, sondern einer Sonderbedeutung haben.
Datum und Uhrzeit ist wie folgt definiert:
- YYYY: Jahr, vierstellig
- YY: Jahr, zweistellig
- MM: Monat, zweistellig (ggf mit führender Null)
- M: Monat (ohne führende Null)
- DD: Tag, zweistellig (ggf mit führender Null)
- D: Tag (ohne führende Null)
- hh: Stunde, zweistellig (ggf mit führende Null)
- h: Stunde (ohne führende Null)
- mm: Minuten, zweistellig (ggf mit führender Null)
- m: Minuten (ohne führende Null)
- ss: Sekunden, zweistellig (ggf mit führender Null)
- s: Sekunden (ohne führende NuLL)
Wenn ein großes "U" vorangestellt ist, wird mit Weltzeit gearbeitet (UTC), ansonsten mit lokaler Zeit. Beispiel: "[Uhh]:[Umm]:[Uss] UTC" wird zu einer Zeichenkette der Art "16:03:33 UTC" übersetzt
Nachkommastellen
Sofern nicht anders definiert werden Zahlen mit einer Dezimalstelle berichtet. Durch Setzen des Wertes für die Nachkommastellen kann die Anzahl der bei der Ausgabe verwendten Dezimalstellen bestimmt werden.
Ersatzzeichenkette
Wenn eine Variable nicht definiert ist oder keinen gültigen Wert liefern kann, wird die spezifizierte Ersatzzeichenkette ausgegeben, die auch leer sein kann. Fehlt die Angabe der Ersatzzeichenkette bleibt die Variabledefinition unverändert in der Zeichenkette stehen und wird nicht ersetzt.
Beispiele
Anbei ein paar Beispiele, die helfen, den Ersetzungsmechanismus besser zu verstehen.
- Template Outdoor temperature is [th0temp-act=F.1:--]°F wird umgewandelt in Outdoor temperature is 3.4°F, wenn keine Außentemperatur vorliegt erscheint Outdoor temperature is --°F.
- Template Local time is [hh]:[mm] wird umgewandelt in Local time is 09:27.
- Template Max gust in last 10 minutes was: [wind0wind-max10.1:--]m/s, [wind0wind-max10=mph.1:--]mph, [wind0wind-max10=kn.0:--]kn wird umgewandelt in Max gust in last 10 minutes was: 10.5m/s, 23.5mph, 20kn.
