Difference between revisions of "Templates/de"
(Updating to match new version of source page) |
|||
| Line 31: | Line 31: | ||
Einige Stationen unterstützen zusätzliche Temperatur/Feuchte-Sensoren. Meteobridge zählt diese als "th1temp", "th1hum", "th1dew", etc auf. Der Reiter "Live-Daten" zeigt neben den aktuellen Daten auch die Sensornummern dieser Zusatzsensoren. Wenn man über eine mit Bodenfeuchte- udn Blattfeuchte-Sensoren ausgestattete Davis Vantage verfügt, werden diese Sensoren ebenfalls als Temperatur/Feuchte-Sensoren geführt, allerdings ohne Berechnung eines Taupunktes. Die Bodenfeuchte-Sensoren weden als "th10temp", "th10hum", ..., "th13temp", "th13hum" und die Blattfeuchte-Sensoren als "th15temp", "th15hum", ..., "th18temp", "th18hum" geführt. Die "hum"-Werte repräsenstieren in diesem Fall nicht die relative Luftfeuchte, sondern Werte in "cbar" und "wet". Meteobridge erfindet für diese Spezialsensoren keine neuen Selektoren. Der generische Selektor "hum" dient dazu, auch die Werte in "cbar" und "wet" dieser Sensoren abzufragen. | Einige Stationen unterstützen zusätzliche Temperatur/Feuchte-Sensoren. Meteobridge zählt diese als "th1temp", "th1hum", "th1dew", etc auf. Der Reiter "Live-Daten" zeigt neben den aktuellen Daten auch die Sensornummern dieser Zusatzsensoren. Wenn man über eine mit Bodenfeuchte- udn Blattfeuchte-Sensoren ausgestattete Davis Vantage verfügt, werden diese Sensoren ebenfalls als Temperatur/Feuchte-Sensoren geführt, allerdings ohne Berechnung eines Taupunktes. Die Bodenfeuchte-Sensoren weden als "th10temp", "th10hum", ..., "th13temp", "th13hum" und die Blattfeuchte-Sensoren als "th15temp", "th15hum", ..., "th18temp", "th18hum" geführt. Die "hum"-Werte repräsenstieren in diesem Fall nicht die relative Luftfeuchte, sondern Werte in "cbar" und "wet". Meteobridge erfindet für diese Spezialsensoren keine neuen Selektoren. Der generische Selektor "hum" dient dazu, auch die Werte in "cbar" und "wet" dieser Sensoren abzufragen. | ||
| − | == | + | ==Selectors== |
| − | + | Sensors are followed by a selector (syntactically separated by a dash) that specifies what period in time should be used for evaluation. Valid selectors are: | |
| − | * '''act''': | + | * '''act''': most recent data |
| − | * '''hmin''': | + | * '''hmin''': minimum value of this hour |
| − | * '''hmax''': | + | * '''hmax''': maximum value of this hour |
| − | * '''dmin''': | + | * '''dmin''': minimum value of today |
| − | * '''dmax''': | + | * '''dmax''': maximum value of today |
| − | * '''ydmin''': | + | * '''ydmin''': minimum value of yesterday |
| − | * '''ydmax''': | + | * '''ydmax''': maximum value of yesterday |
| − | * '''mmin''': | + | * '''mmin''': minimum value of this month |
| − | * '''mmax''': | + | * '''mmax''': maximum value of this month |
| − | * '''ymin''': | + | * '''ymin''': minimum value of this year |
| − | * '''ymax''': | + | * '''ymax''': maximum value of this year |
| − | * '''amin''': | + | * '''amin''': minimum value of all time |
| − | * '''amax''': | + | * '''amax''': maximum value of all time |
| − | + | Sensors that deliver cumulated data like "rain0total" and "sol0evo" should be used with the following selectors only: | |
| − | * '''hoursum''', '''daysum | + | * '''hoursum''', '''daysum or sumday''', '''monthsum''', '''yearsum''', '''allsum''', '''ydaysum''': selects summerized delta values from today, this month, this year, all time or yesterday. Example: "rain0total-sumday" is todays rain fall. |
Wenn man an den Zeitstempeln der Min/Max-Werte interessiert ist, könnten diese Selektoren ineressant sein: | Wenn man an den Zeitstempeln der Min/Max-Werte interessiert ist, könnten diese Selektoren ineressant sein: | ||
| Line 63: | Line 63: | ||
* '''amaxtime''': Zeitstempel des Maximums des gesamten Aufzeichnungszeitraumes | * '''amaxtime''': Zeitstempel des Maximums des gesamten Aufzeichnungszeitraumes | ||
* '''starttime''': Zeitstempel des ersten aufgezeichneten Datensatzes | * '''starttime''': Zeitstempel des ersten aufgezeichneten Datensatzes | ||
| − | Die Zeitstempel sind im Format "JJJJMMTThhmmss". das Jahr "JJJJ" wird mit 4 Stellen, alle anderen Angabe (Monat "MM", Tag "TT", Stunde "hh", minute "mm", Sekunde "ss") werden mit 2 Stellen berichtet. Führende Nullen werden nicht unterdrückt. | + | Die Zeitstempel sind im Format "JJJJMMTThhmmss". das Jahr "JJJJ" wird mit 4 Stellen, alle anderen Angabe (Monat "MM", Tag "TT", Stunde "hh", minute "mm", Sekunde "ss") werden mit 2 Stellen berichtet. Führende Nullen werden nicht unterdrückt. |
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 werden. Die Rückschau reicht wegen der begrenzten Speicherausstattung der Meteobridge nur bis zu 60 Minuten in die Vergangenheit. | 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 werden. Die Rückschau reicht wegen der begrenzten Speicherausstattung der Meteobridge nur bis zu 60 Minuten in die Vergangenheit. | ||
| Line 111: | Line 111: | ||
* '''buildnum''': build number as integer (example: 1673) | * '''buildnum''': build number as integer (example: 1673) | ||
* '''platform''': string that specifies hw platform (example: "TL-MR3020") | * '''platform''': string that specifies hw platform (example: "TL-MR3020") | ||
| + | * '''station''': string that specifies selected weather station (expample: "WMR-200") | ||
* '''language''': language used on Meteobridge's web interface (example: "English") | * '''language''': language used on Meteobridge's web interface (example: "English") | ||
* '''timezone''': defined timezone (example: "Europe/Berlin") | * '''timezone''': defined timezone (example: "Europe/Berlin") | ||
* '''latitude''': latitude as float (example: 53.875120) | * '''latitude''': latitude as float (example: 53.875120) | ||
* '''longitude''': longitude as float (example: 9.885357) | * '''longitude''': longitude as float (example: 9.885357) | ||
| + | * '''uptime''': uptime of Meteobridge in seconds | ||
| + | * '''lastdata''': seconds passed since last piece of data received from weather station, returns -1 if no data received. Does not distinguish between useful and useless garbage data | ||
| + | * '''lastgooddata''': seconds passed since last piece of meaningfull sensor data recorded, returns -1 if no sensor data recorded so far | ||
* '''lunarage''': days passes since new moon as integer (example: 28) | * '''lunarage''': days passes since new moon as integer (example: 28) | ||
* '''lunarpercent''': lunarphase given as percentage from 0% (new moon) to 100% (full moon) | * '''lunarpercent''': lunarphase given as percentage from 0% (new moon) to 100% (full moon) | ||
| Line 167: | Line 171: | ||
==Ersatzzeichenkette== | ==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. | 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. | ||
| + | |||
| + | ==Numerical Expressions== | ||
| + | A numerical expression that Meteobridge should evaluate needs to be enclosed by <font face="Courier"><span style="background-color:lightgrey;">{*</span></font face> and <font face="Courier"><span style="background-color:lightgrey;">*}</span></font face>. The enclosed expression can also include template variables. This allows to do various computations with numerical data. Resulting value is returned with two decimals. You can define how many digits the return value should have by stating the number of decimals betwenn the * and } when closing the numerical expression. For example, <font face="Courier"><span style="background-color:lightgrey;">*0}</span></font face> does set number of decimals to 0, which will return a rounded integer value. | ||
| + | |||
| + | The following operators can be used within numerical expressions: | ||
| + | {| style="background:none" border="1" cellpadding="5" cellspacing="0" | ||
| + | |+ align="bottom"|''operators in increasing precedence (from top to bottom)'' | ||
| + | ! Operator / Function | ||
| + | ! Description | ||
| + | |- | ||
| + | |'''&&''', '''||''', '''&''', '''|''' | ||
| + | |logical "and", "or" operators working on value range: 1=true, 0=false | ||
| + | |- | ||
| + | |'''==''', '''=''', '''!=''', '''<>''', '''>''', '''>=''', '''<''', '''<=''' | ||
| + | |comparison operations working on value range: 1=true, 0=false | ||
| + | |- | ||
| + | |'''+''', '''-''' | ||
| + | |arithmetic operators "plus" and "minus" | ||
| + | |- | ||
| + | |'''*''', '''/''', '''%''' | ||
| + | |arithmetic operators "multiply", "divide" and "modulus" (which rounds the operands to integers first) | ||
| + | |- | ||
| + | |'''^''' | ||
| + | |arithmetic operator "power" | ||
| + | |- | ||
| + | |'''sqrt()''', '''log()''', '''exp()''', '''sin()''', '''asin()''', '''cos()''', '''acos()''', '''tan()''', '''atan()''', '''atan2()''', '''abs()''', '''fabs()''', '''floor()''', '''ceil()''', '''round()''' | ||
| + | |arithmetic functions: square root, logarithm, logarithmic exponent, sinus, arcus sinus, cosinus, arcus cosinus, tangens, arcus tangens, arcus tangens2, absolute, floting point absolut, lower integer, upper integer, rounded integer | ||
| + | |} | ||
==Beispiele== | ==Beispiele== | ||
Revision as of 18:07, 24 April 2015
<languages />
Meteobridge stellt einen sehr flexiblen Ersetzungsmechanismus zur Verfügung, mit dem definierte Variable durch konkrete Sensorwerte ersetzt werden. Dies ermöglich Meteobridge in beliebige Zeichenketten 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.
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
- th0heatindex: Hitzeindex 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
- sol0evo: Evapotranspiration in mm (nur für Davis Vantage verfügbar)
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.
Einige Stationen unterstützen zusätzliche Temperatur/Feuchte-Sensoren. Meteobridge zählt diese als "th1temp", "th1hum", "th1dew", etc auf. Der Reiter "Live-Daten" zeigt neben den aktuellen Daten auch die Sensornummern dieser Zusatzsensoren. Wenn man über eine mit Bodenfeuchte- udn Blattfeuchte-Sensoren ausgestattete Davis Vantage verfügt, werden diese Sensoren ebenfalls als Temperatur/Feuchte-Sensoren geführt, allerdings ohne Berechnung eines Taupunktes. Die Bodenfeuchte-Sensoren weden als "th10temp", "th10hum", ..., "th13temp", "th13hum" und die Blattfeuchte-Sensoren als "th15temp", "th15hum", ..., "th18temp", "th18hum" geführt. Die "hum"-Werte repräsenstieren in diesem Fall nicht die relative Luftfeuchte, sondern Werte in "cbar" und "wet". Meteobridge erfindet für diese Spezialsensoren keine neuen Selektoren. Der generische Selektor "hum" dient dazu, auch die Werte in "cbar" und "wet" dieser Sensoren abzufragen.
Selectors
Sensors are followed by a selector (syntactically separated by a dash) that specifies what period in time should be used for evaluation. Valid selectors are:
- act: most recent data
- hmin: minimum value of this hour
- hmax: maximum value of this hour
- dmin: minimum value of today
- dmax: maximum value of today
- ydmin: minimum value of yesterday
- ydmax: maximum value of yesterday
- mmin: minimum value of this month
- mmax: maximum value of this month
- ymin: minimum value of this year
- ymax: maximum value of this year
- amin: minimum value of all time
- amax: maximum value of all time
Sensors that deliver cumulated data like "rain0total" and "sol0evo" should be used with the following selectors only:
- hoursum, daysum or sumday, monthsum, yearsum, allsum, ydaysum: selects summerized delta values from today, this month, this year, all time or yesterday. Example: "rain0total-sumday" is todays rain fall.
Wenn man an den Zeitstempeln der Min/Max-Werte interessiert ist, könnten diese Selektoren ineressant sein:
- hmintime: Zeitstempel des Minimums der aktuellen Stunde
- hmaxtime: Zeitstempel des Maximums der aktuellen Stunde
- dmintime: Zeitstempel des Minimums von Heute
- dmaxtime: Zeitstempel des Maximums von Heute
- ydmintime: Zeitstempel des Minimums von Gestern
- ydmaxtime: Zeitstempel des Maximums von Gestern
- mmintime: Zeitstempel des Minimums dieses Monats
- mmaxtime: Zeitstempel des Maximums dieses Monats
- ymintime: Zeitstempel des Minimums dieses Jahres
- ymaxtime: Zeitstempel des Maximums dieses Jahres
- amintime: Zeitstempel des Minimums des gesamten Aufzeichnungszeitraumes
- amaxtime: Zeitstempel des Maximums des gesamten Aufzeichnungszeitraumes
- starttime: Zeitstempel des ersten aufgezeichneten Datensatzes
Die Zeitstempel sind im Format "JJJJMMTThhmmss". das Jahr "JJJJ" wird mit 4 Stellen, alle anderen Angabe (Monat "MM", Tag "TT", Stunde "hh", minute "mm", Sekunde "ss") werden mit 2 Stellen berichtet. Führende Nullen werden nicht unterdrückt.
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 werden. Die Rückschau reicht wegen der begrenzten Speicherausstattung der Meteobridge nur bis zu 60 Minuten in die Vergangenheit.
- val2, val5, val10, val15, val30, val60: selektiert den Sensorwert vor 2, 5, 10, 15, 30 oder 60 Minuten
- 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
Sensoren wie "rain0total" und "sol0evo", die kumulierte Werte liefern, können wegen der geringeren Abtastdichte (1 Wert pro Minute) bis zu 24 Stunden in die Vergangenheit ausgewertet werden:
- sum2, sum5, sum10, sum15, sum30, sum60, sum1h, sum3h, sum6h, sum12h, sum24h: selektiert zusammengerechnete Deltawerte der letzten 2, 5, 10, 15, 30, 60 Minuten oder 1, 3, 6, 12 24 Stunden, welches zum Berechnen der gefallenen Regenmenge im definierten Zeitraum erforderlich ist. Beispiel: "rain0total-sum60" ergibt die gefallene Regenmenge in mm der letzten 60 Minuten.
Konverter
Die 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.
- ft wandelt eine Höhe von Metern in Fuß (feet) um.
- endir wandelt die Windrichtung in einen von 16 Englischen Richtungstexten um.
- dedir wandelt die Windrichtung in einen von 16 Deutschen Richtungstexten um.
Wird eine unbekannte Konvertierung gewählt, findet keine Umrechnung statt un es erfolgt keine Fehlermeldung.
Wenn Variable einen Zeitstempel liefern, kann dieser von lokaler Zeit (Voreinstellung) auf Weltzeit (UTC) umgerechnet weden:
- utc gibt den Zeitstempel nicht in lokaler Zeit (Voreinstellung) sondern in Weltzeit aus.
Vorhersage-Variable
Wenn Meteobridge mit einer Davis Vantage verbunden ist, stehen die Vorhersagen der Vantage in Meteobridge als Variable zur Verfügung. Alle Vorhersagevariable tragen als Sensornamen "forecast" gefolgt von einem der folgenden Selektoren:
- rule: berichtet die Vorhersagenummer. Wenn keine Vantage angschlossen ist oder keine Vorhersage verfügbar ist, ist diese Zahl negativ.
- text: Vorhersagetext in Englisch
- textde: Vorhersagetext in Deutsch (UTF-8-kofiert)
- textdeiso: Vorhersagetext in Deutsch (ISO-8859-kodiert)
- textdehtml: Vorhersagetext in Deutsch (HTML-kodiert)
- textit: Vorhersagetext in Italienisch
- textnl: Vorhersagetext in Holländisch
- textest: Vorhersagetext in Estonisch
- texthr: Vorhersagetext in Ungarisch
- textcz: Vorhersagetext in Tschechisch
System Variables
Meteobridge provides some additional variables that tell details not directly related to weather conditions. Sensor name is "mbsystem", defined selectors are:
- mac: Meteobridge MAC hardware address (example: "40:01:FE:23:12:A8")
- swversion: Meteobridge version string (example: "1.1")
- buildnum: build number as integer (example: 1673)
- platform: string that specifies hw platform (example: "TL-MR3020")
- station: string that specifies selected weather station (expample: "WMR-200")
- language: language used on Meteobridge's web interface (example: "English")
- timezone: defined timezone (example: "Europe/Berlin")
- latitude: latitude as float (example: 53.875120)
- longitude: longitude as float (example: 9.885357)
- uptime: uptime of Meteobridge in seconds
- lastdata: seconds passed since last piece of data received from weather station, returns -1 if no data received. Does not distinguish between useful and useless garbage data
- lastgooddata: seconds passed since last piece of meaningfull sensor data recorded, returns -1 if no sensor data recorded so far
- lunarage: days passes since new moon as integer (example: 28)
- lunarpercent: lunarphase given as percentage from 0% (new moon) to 100% (full moon)
- lunarsegment: lunarphase segment as integer (0 = new moon, 1-3 = growing moon: quarter, half, three quarters, 4 = full moon, 5-7 = shrinking moon: three quarter, half, quarter)
- daylength: length of day (example: "11:28")
- civildaylength: alternative method for daylength computation (example: "12:38")
- nauticaldaylength: alternative method for daylength computation (example: "14:00")
- sunrise: time of sunrise in local time. Can be converterd to UTC by applying "=utc" to the variable (example: "06:47", resp. "05:47")
- sunset. time of sunset in local time. Can be converterd to UTC by applying "=utc" to the variable (example: "18:15", resp. "17:15")
- civilsunrise, civilsunset, nauticalsunrise, nauticalsunset: alternative computations for sunset and sunrise.
- daynightflag: returns "D" when there is daylight, otherwise "N".
- isday: returns "1" when there is daylight, otherwise "0".
- isnight: returns "0" when there is daylight, otherwise "1".
- moonrise: time of moonrise in local time. Can be converterd to UTC by applying "=utc" to the variable. Please notice that not every day has a moonrise time, therefore, variable can be non-existent on certain days (example: "05:46", resp. "04:46")
- moonset: time of moonset in local time. Can be converterd to UTC by applying "=utc" to the variable. Please notice that not every day has a moonset time, therefore, variable can be non-existent on certain days (example: "17:00", resp. "16:00")
- graphA: returns URL of the user's Meteoplug chart "*instruments-black"
- graphB: returns URL of the user's Meteoplug chart "*instruments-black-imp"
- graphC: returns URL of the user's Meteoplug chart "*iphone-black"
- graphD: returns URL of the user's Meteoplug chart "*iphone-black-imp"
- graphE: returns URL of the user's Meteoplug chart "*iphone-tw-2d"
- graphF: returns URL of the user's Meteoplug chart "*iphone-tw-2d-imp"
- graphG: returns URL of the user's Meteoplug chart "*iphone-pr-2d"
- graphH: returns URL of the user's Meteoplug chart "*iphone-pr-2d-imp"
Zeit/Datums-Variable
Die Ausgaben der aktuellen Zeit oder des aktuellen Datums entspricht nicht dem "Sensor-Selektor=Konverter" Schema, sondern ist wie folgt definiert.
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 in 24h-Notation, zweistellig (ggf mit führende Null)
- h: Stunde in 24h-Notation (ohne führende Null)
- HH: Stunde in 12h-Notation, zweistellig (ggf mit führende Null)
- H: Stunde in 12h-Notation (ohne führende Null)
- apm: ergibt "am" oder "pm" je nach Tageszeit
- APM: ergibt "AM" oder "PM" je nach Tageszeit
- 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.
Wenn die Variable einen Zeichenkette anstelle einer Zahl zurückliefert - wie beispielsweise bei Zeitstempeln -, dann hat die "Nachkommastellen"-Definition eine andere Form und Bedeutung. Die Angabe enthält dann zwei Positionszeichen, die die Start- und eine Endeposition des herausuzulösenden Sub-Strings bezeichnen. Die Positionszeichen sind Kleinbuchstaben. Der erste gibt die Startposition an. "a" steht für das erste Zeichen der Zeichenkette, "b" für das zweite, etc. Das zweite Positionszeichen hat dieselbe Form und gibt das letzte Zeichen der herauszulösdenden Zeichenkette an. Beispiel: Aus dem Zeitstempel "20130303121055" werde mit den Positionszeichen ".ad" die ersten vier Zeichen selektiert. Wenn man die zeit der tiefsten Außentempratur des heutigen Tages erhalten möchte, kann man das Template [th0temp-dmintime.ij:--]:[th0temp-dmintime.kl:--] verwenden. "ij" selektieren den Stundenwert an Position 9-10 und "kl" den Minutenwert an Position 11-12 des Zeitstempels.
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.
Numerical Expressions
A numerical expression that Meteobridge should evaluate needs to be enclosed by {* and *}. The enclosed expression can also include template variables. This allows to do various computations with numerical data. Resulting value is returned with two decimals. You can define how many digits the return value should have by stating the number of decimals betwenn the * and } when closing the numerical expression. For example, *0} does set number of decimals to 0, which will return a rounded integer value.
The following operators can be used within numerical expressions:
| Operator / Function | Description |
|---|---|
| &&, ||, &, | | logical "and", "or" operators working on value range: 1=true, 0=false |
| ==, =, !=, <>, >, >=, <, <= | comparison operations working on value range: 1=true, 0=false |
| +, - | arithmetic operators "plus" and "minus" |
| *, /, % | arithmetic operators "multiply", "divide" and "modulus" (which rounds the operands to integers first) |
| ^ | arithmetic operator "power" |
| sqrt(), log(), exp(), sin(), asin(), cos(), acos(), tan(), atan(), atan2(), abs(), fabs(), floor(), ceil(), round() | arithmetic functions: square root, logarithm, logarithmic exponent, sinus, arcus sinus, cosinus, arcus cosinus, tangens, arcus tangens, arcus tangens2, absolute, floting point absolut, lower integer, upper integer, rounded integer |
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.
