Dewpoint: Unterschied zwischen den Versionen

dewpoint
Zweck / Funktion
	Berechnung des Taupunkts
Allgemein
Typ	Hilfsmodul
Details
Dokumentation	EN / DE
Modulname	98_dewpoint.pm
Ersteller	Willi Herzig
	Wichtig: sofern vorhanden, gilt im Zweifel immer die (englische) Beschreibung in der commandref!

Version vom 5. Mai 2016, 19:59 Uhr

Das Modul dewpoint bietet Funktionen im Zusammenhang mit der Taupunktberechnung an. Die verfügbaren Funktionen, über einen Parameter bei der Definition gesteuert, sind

dewpoint (Taupunkt)
fan (erzeugt ein Event, das zur Lüftersteuerung verwendet werden kann)
alarm (erzeugt einen "Schimmel-Alarm", wenn eine Referenztemperatur unter den Taupunkt fällt)

Todo: Seite muss noch vervollständigt werden --Peter (Diskussion) 13:49, 14. Mär. 2016 (CET)

Voraussetzungen

Es muss ein Device geben, das die zur Berechnung erforderlichen Basisdaten Temperatur und Feuchte liefert. Die Namen der entsprechenden Readings können bei der Definition des dewpoint Device angegeben werden.

Anwendung

Define

Ein dewpoint Device (siehe auch commandref) wird definiert mit:

define <name> dewpoint <type> ...

Mögliche Werte und Bedeutung von

type

dewpoint - aus temp_name und hum_name wird der Taupunkt berechnet und als Reading mit dem Namen new_name an die durch devicename-regex spezifizierten Devices hinzugefügt
fan -
alarm -

Die vollständige Syntax für den Typ dewpoint:

define <name> dewpoint dewpoint <devicename-regex> [<temp_name> <hum_name> <new_name>]

wobei die Platzhalter folgende Bedeutung haben:

name: der Name des definierten dewpoint Device
devicename-regex: Spezifikation des Geräts / der Geräte, von denen temp_name und hum_name gelesen und new_name geschrieben werden soll
temp_name: Name des Readings, das den Temperaturwert enthält; wenn dieser Parameter nicht angegeben ist, wird temperature angenommen
hum_name: Name des Readings, das den Feuchtewert enthält; wenn dieser Parameter nicht angegeben ist, wird humidity angenommen
new_name: Name des Readings, das den berechneten Taupunkt aufnehmen soll; wenn dieser Parameter nicht angegeben ist, wird dewpoint angenommen

Statuszeile

Will man den Taupunkt nicht als einzelnes Reading dewpoint, sondern in Kurzform zusammen mit den anderen Werten in der Statuszeile anzeigen lassen, so muss man für temp_name und hum_name die Spezialwerte T und H angeben:

define dew_state dewpoint dewpoint .* T H D

Dies bewirkt, dass bei allen abgefragten Geräten die Werte T und H aus der Statuszeile ausgelesen werden und selbige dann wie folgt um den Taupunkt mit dem Buchstaben D erweitert wird:

T: 18.2 H: 55 D: 9.0

Attribute

absFeuchte: Beim Setzen dieses Attributs wird zusätzlich die absolute Luftfeuchtigkeit (in Gramm Wasser pro Kubikmeter Luft) berechnet und als Reading mit dem Namen absFeuchte ausgegeben. Hat man das Dewpoint-Device vorher so definiert, dass es den Taupunkt an den Status anhängt:

define dew_state dewpoint dewpoint .* T H D

dann braucht man nichts weiter zu tun, die absolute Feuchtigkeit wird ab sofort unter dem Buchstaben A an den Status angehängt:

T: 18.2 H: 55 D: 9.0 A: 8.5

Für den Taupunkt konnte man mit dem Parameter new_name einen eigenen Namen für das erzeugten Reading festlegen. Für die absolute Luftfeuchte ist dieser Parameter nicht vorhanden, das Reading hat immer den Standardnamen absFeuchte bzw. A in der Statuszeile.

Anwendungsbeispiele

Alternativen zu diesem Modul

Um den Taupunkt einfach berechnen zu können, kann neben dem Modul dewpoint auch das Folgende userReading gesetzt werden (der Code dazu wurde direkt aus dem Modul entnommen und ist so über das Webinterface einzugeben).

Das Userreading hat den Vorteil, nicht mit anderen Modulen in Konflikt zu geraten.

attr <Device> userReadings dew:temperature.* { 
 my $dp;
 my $temperature = ReadingsVal($name,"temperature",0);
 my $humidity = ReadingsVal($name,"humidity",0);
 my $A = 17.2694;
 my $B = ($temperature > 0) ? 237.3 : 265.5;
 my $es = 610.78 * exp( $A * $temperature / ($temperature + $B) );
 my $e = $humidity/ 100 * $es;
 if ($e == 0) { Log 1, "Error: dewpoint() e==0: temp=$temperature, hum=$humidity";
  return 0;
 } 
 my $e1 = $e / 610.78;
 my $f = log( $e1 ) / $A;
 my $f1 = 1 - $f;
 if ($f1 == 0) { 
  Log 1, "Error: dewpoint() (1-f)==0: temp=$temperature, hum=$humidity";
  return 0;
 }
 $dp = $B * $f / $f1 ;
 sprintf "%.2f", $dp;
}

(Das obige Beispiel wurde nach Umstellung auf "Source"-Formatierung noch nicht getestet. --Peter (Diskussion) 13:49, 14. Mär. 2016 (CET))

Links

Forendiskussion um Lüften oder nicht
Forendiskussion um Temperaturdifferenz

@@ Zeile 39: / Zeile 39: @@
 ;new_name
 :Name des Readings, das den berechneten Taupunkt aufnehmen soll; wenn dieser Parameter nicht angegeben ist, wird ''dewpoint'' angenommen
+==== Statuszeile ====
+Will man den Taupunkt nicht als einzelnes Reading ''dewpoint'', sondern in Kurzform zusammen mit den anderen Werten in der Statuszeile anzeigen lassen, so muss man für ''temp_name'' und ''hum_name'' die Spezialwerte ''T'' und ''H'' angeben:
+:<code>define dew_state dewpoint dewpoint .* T H D</code>
+Dies bewirkt, dass bei allen abgefragten Geräten die Werte ''T'' und ''H'' aus der Statuszeile ausgelesen werden und selbige dann wie folgt um den Taupunkt mit dem Buchstaben ''D'' erweitert wird:
+<pre>T: 18.2 H: 55 D: 9.0</pre>
 === Attribute ===
+;absFeuchte
+:Beim Setzen dieses Attributs wird zusätzlich die absolute Luftfeuchtigkeit (in Gramm Wasser pro Kubikmeter Luft) berechnet und als Reading mit dem Namen ''absFeuchte'' ausgegeben. Hat man das Dewpoint-Device vorher so definiert, dass es den Taupunkt an den Status anhängt:
+:<code>define dew_state dewpoint dewpoint .* T H D</code>
+:dann braucht man nichts weiter zu tun, die absolute Feuchtigkeit wird ab sofort unter dem Buchstaben ''A'' an den Status angehängt:
+:<pre>T: 18.2 H: 55 D: 9.0 A: 8.5</pre>
+:Für den Taupunkt konnte man mit dem Parameter ''new_name'' einen eigenen Namen für das erzeugten Reading festlegen. Für die absolute Luftfeuchte ist dieser Parameter nicht vorhanden, das Reading hat immer den Standardnamen ''absFeuchte'' bzw. ''A'' in der Statuszeile.
 == Anwendungsbeispiele ==