lib.env

Die Bibliothek lib.env dient vorwiegend der Unterstützung von Umrechnungen von Environment Daten.

In Logiken oder eval Statements werden die Funktionen einfach folgendermaßen aufgerufen: Ergebnis = env.<Funktion>

In Plugins können diese Funktionen in gleicher Weise genutzt werden. Dazu muss die Bibliothek vorher mit dem Statement import lib.env as env importiert werden.

Diese lib implementiert Funktionen zum Umgang mit Environment Daten in SmartHomeNG.

Hierzu gehören

• Umrechnungen der folgenden Maßeinheiten für Geschwindigkeiten:

  • mps - Miles Per Second

  • mph

  • km/h - Kilometer pro Stunde (kmh)

  • m/s - Meter je Sekunde (ms)

  • nm/h - Nautical Miles per Hour

  • kn - Knoten (1 nm pro Stunde)

  • bft - Beaufort

• Umrechnungen der folgenden Maßeinheiten für Längen / Entfernungenn:

  • meter - Meter

  • miles - Meilen

  • nm - Nautische Meilen

• Umrechnungen der folgenden Maßeinheiten für Temperaturen:

  • °F - Grad Fahrenheit

  • °C - Grad Celsius

• weitere Umrechnungen

  • Grad zu Himmelsrichtung

lib.env.kn_to_kmh(speed)

Umrechnung Knoten (nautische Meilen pro Stunde) in Kilometer pro Stunde

Parameter:

speed (float) – Geschwindigkeit in Knoten

Rückgabetyp:

float

Rückgabe:

Geschwindigkeit in km/h

lib.env.kmh_to_kn(speed)

Umrechnung Kilometer pro Stunde in Knoten (nautische Meilen pro Stunde)

Parameter:

speed (float) – Geschwindigkeit in km/h

Rückgabetyp:

float

Rückgabe:

Geschwindigkeit in Knoten

lib.env.ms_to_kmh(speed)

Umrechnung Meter pro Sekunde in Kilometer pro Stunde

Parameter:

speed (float) – Geschwindigkeit in m/s

Rückgabetyp:

float

Rückgabe:

Geschwindigkeit in km/h

lib.env.kmh_to_ms(speed)

Umrechnung Kilometer pro Stunde in Meter pro Sekunde

Parameter:

speed (float) – Geschwindigkeit in km/h

Rückgabetyp:

float

Rückgabe:

Geschwindigkeit in m/s

lib.env.mps_to_kmh(speed)

Umrechnung Miles per Second in Kilometer pro Stunde

Parameter:

speed (float) – Geschwindigkeit in mps

Rückgabetyp:

float

Rückgabe:

Geschwindigkeit in km/h

lib.env.kmh_to_mps(speed)

Umrechnung Kilometer pro Stunde in Miles per Second

Parameter:

speed (float) – Geschwindigkeit in km/h

Rückgabetyp:

float

Rückgabe:

Geschwindigkeit in mps

lib.env.mph_to_kmh(speed)

Umrechnung Miles per Hour in Kilometer pro Stunde

Parameter:

speed (float) – Geschwindigkeit in mph

Rückgabetyp:

float

Rückgabe:

Geschwindigkeit in km/h

lib.env.kmh_to_mph(speed)

Umrechnung Kilometer pro Stunde in Miles per Hour

Parameter:

speed (float) – Geschwindigkeit in km/h

Rückgabetyp:

float

Rückgabe:

Geschwindigkeit in mph

lib.env.ms_to_bft(speed)

Umrechnung Windgeschwindigkeit von Meter pro Sekunde in Beaufort

Beaufort gibt die Windgeschwindigkeit durch eine Zahl zwischen 0 und 12 an

Parameter:

speed (float) – Windgeschwindigkeit in m/s

Rückgabetyp:

int

Rückgabe:

Windgeschwindigkeit in bft

lib.env.kmh_to_bft(speed)

Umrechnung Windgeschwindigkeit von Kilometer pro Stunde in Beaufort

Beaufort gibt die Windgeschwindigkeit durch eine Zahl zwischen 0 und 12 an

Parameter:

speed (float) – Windgeschwindigkeit in km/h

Rückgabetyp:

int

Rückgabe:

Windgeschwindigkeit in bft

lib.env.bft_to_text(bft, language='de')

Umwandlung Windgeschwindigkeit in bft in beschreibenden Text

Parameter:

bft (int) – Wind speed in beaufort (bft)

Rückgabetyp:

str

Rückgabe:

Text Beschreibung der Windgeschwindigkeit

lib.env.miles_to_meter(distance)

Umterchnung Meilen zu Metern

Parameter:

distance – Strecke in Meilen

Rückgabe:

Strecke in Metern

lib.env.nauticalmiles_to_meter(distance)

Umterchnung nautische Meilen zu Metern

Parameter:

distance – Strecke in nautischen Meilen

Rückgabe:

Strecke in Metern

lib.env.meter_to_miles(distance)

Umterchnung Meter zu Meilen

Parameter:

distance – Strecke in Metern

Rückgabe:

Strecke in Meilen

lib.env.meter_to_nauticalmiles(distance)

Umterchnung Meter zu nautische Meilen

Parameter:

distance – Strecke in Metern

Rückgabe:

Strecke in nautischen Meilen

lib.env.f_to_c(grad)

Umrechnung von Grad Fahrenheit in Grad Celsius

Parameter:

grad (float) – Temperatur in °F

Rückgabetyp:

float

Rückgabe:

Temperatur in °C

lib.env.c_to_f(grad)

Umrechnung von Grad Celsius in Grad Fahrenheit

Parameter:

grad (float) – Temperatur in °C

Rückgabetyp:

float

Rückgabe:

Temperatur in °F

lib.env.degrees_to_direction_8(deg)

Umrechnung Gradzahl in Himmelsrichtung (Abkürzung)

Diese Funktion teilt die Himmelsrichtungen in 8 Sektoren

Parameter:

deg (float) – Kompass Gradzahl

Rückgabetyp:

str

Rückgabe:

Himmelsrichtung (Abkürzung)

lib.env.degrees_to_direction_16(deg)

Umrechnung Gradzahl in Himmelsrichtung (Abkürzung)

Diese Funktion teilt die Himmelsrichtungen in 16 Sektoren

Parameter:

deg (float) – Kompass Gradzahl

Rückgabetyp:

str

Rückgabe:

Himmelsrichtung (Abkürzung)

lib.env.location_name(lat, lon)

Lokationsname (Stadt, Stadtteil oder Ort) einer Lokation, die über Latitude und Longitude gewählt wird. Die Informationen werden von OpenWeatherMap abgerufen.

Parameter:

• lat (Union[float, str]) – Latitude

• lon (Union[float, str]) – Longitude

Rückgabetyp:

str

Rückgabe:

Lokationsname

lib.env.location_address(lat, lon)

Address-Information einer Lokation, die über Latitude und Longitude gewählt wird. Die Informationen werden von OpenWeatherMap abgerufen.

Parameter:

• lat (Union[float, str]) – Latitude

• lon (Union[float, str]) – Longitude

Rückgabetyp:

dict

Rückgabe:

Address Information