TapHome

Mathematische Funktionen

Mathematische Funktionen der TapHome-Skriptsprache — MIN, MAX, AVG (und STRICT-Varianten), ROUND, ABS, DEWPOINT, POWER, MOD, CEIL, FLOOR, RAND, RANDINT, SIGN, SQRT, LOG, LN.

MIN

Die MIN-Funktion gibt das Minimum der angegebenen numerischen Werte zurück. Sie akzeptiert 1 bis 100 Argumente oder eine einzelne Sammlung. NaN- und NULL-Werte werden ignoriert.

MIN( n1, n2, n3, …)
MIN( collection )

Beispiele:

MIN(40, 80)  		= 40
MIN(2, 2, 6) 		= 2
MIN(80, NAN)		= 80
MIN(NAN, NAN)		= NaN

VAR data := {10, 20, 30}; MIN(data) 	= 10
MIN({1, 2, 3})							= 1
MIN({1, NaN, 3})						= 1

VAR d1 := DATETIME(2014, 12, 8, 0, 0, 0, 0, DateTimeKind.Utc);
VAR d2 := DATETIME(2015, 12, 8, 0, 0, 0, 0, DateTimeKind.Utc);
MIN(d1, d2)			... Result is d1

MINSTRICT

Die MINSTRICT-Funktion gibt das Minimum der angegebenen numerischen Werte zurück. Sie akzeptiert 1 bis 100 Argumente oder eine einzelne Sammlung. Wenn irgendein Wert NaN oder NULL ist, gibt die Funktion NaN/NULL zurück.

MINSTRICT( n1, n2, n3, …)
MINSTRICT( collection )

Beispiele:

MINSTRICT(40, 80)  		= 40
MINSTRICT(2, 2, 6) 		= 2
MINSTRICT(80, NAN)		= NaN
MINSTRICT(NAN, NAN)		= NaN

VAR data := {10, 20, 30}; MINSTRICT(data) 	= 10
MINSTRICT({1, 2, 3})						= 1
MINSTRICT({1, NaN, 3})						= NaN

VAR d1 := DATETIME(2014, 12, 8, 0, 0, 0, 0, DateTimeKind.Utc);
VAR d2 := DATETIME(2015, 12, 8, 0, 0, 0, 0, DateTimeKind.Utc);
MINSTRICT(d1, NULL, d2)		... Result is NULL

MAX

Die MAX-Funktion gibt das Maximum der angegebenen numerischen Werte zurück. Sie akzeptiert 1 bis 100 Argumente oder eine einzelne Sammlung. NaN- und NULL-Werte werden ignoriert.

MAX( n1, n2, n3, …)
MAX( collection )

Beispiele:

MAX(40, 80)  			= 80
MAX(2, 2, 6) 			= 6
MAX(80, NAN)			= 80
MAX(NAN, NAN)			= NaN

VAR data := {10, 20, 30}; MAX(data) = 30
MAX({1, 2, 3})						= 3
MAX({1, NaN, 3})					= 3

VAR d1 := DATETIME(2014, 12, 8, 0, 0, 0, 0, DateTimeKind.Utc);
VAR d2 := DATETIME(2015, 12, 8, 0, 0, 0, 0, DateTimeKind.Utc);
MAX(d1, d2)				... Result is d2

MAXSTRICT

Die MAXSTRICT-Funktion gibt das Maximum der angegebenen numerischen Werte zurück. Sie akzeptiert 1 bis 100 Argumente oder eine einzelne Sammlung. Wenn irgendein Wert NaN oder NULL ist, gibt die Funktion NaN/NULL zurück.

MAXSTRICT( n1, n2, n3, …)
MAXSTRICT( collection )

Beispiele:

MAXSTRICT(40, 80)  			= 80
MAXSTRICT(2, 2, 6) 			= 6
MAXSTRICT(80, NAN)			= NaN
MAXSTRICT(NAN, NAN)			= NaN

VAR data := {10, 20, 30}; MAXSTRICT(data) 	= 30
MAXSTRICT({1, 2, 3})				= 3
MAXSTRICT({1, NaN, 3})				= NaN

VAR d1 := DATETIME(2014, 12, 8, 0, 0, 0, 0, DateTimeKind.Utc);
VAR d2 := DATETIME(2015, 12, 8, 0, 0, 0, 0, DateTimeKind.Utc);
MAXSTRICT(d1, NULL, d2)		... Result is NULL

AVG

Die AVG-Funktion berechnet den Durchschnitt (Mittelwert) der angegebenen numerischen Werte. Sie akzeptiert 1 bis 100 Argumente oder eine einzelne Sammlung. NaN-Werte werden ignoriert.

AVG( n1, n2, n3, …)
AVG( collection )

Beispiele:

AVG(40, 80)  		= 60
AVG(2, 2, 6) 		= 3.3333
AVG(80, NAN)		= 80
AVG(‘a’, ‘c’)		= ‘b’
AVG(NAN, NAN)		= NaN

VAR data := {10, 20, 30}; AVG(data) 	= 20
AVG({1, 2, 3})							= 2
AVG({1, NaN, 3})						= 2

AVGSTRICT

Die AVGSTRICT-Funktion berechnet den Durchschnitt (Mittelwert) der angegebenen numerischen Werte. Sie akzeptiert 1 bis 100 Argumente oder eine einzelne Sammlung. Wenn irgendein Wert keine Zahl ist, gibt die Funktion NaN zurück.

AVGSTRICT( n1, n2, n3, …)
AVGSTRICT( collection )

Beispiele:

AVGSTRICT(40, 80)  		= 60
AVGSTRICT(2, 2, 6) 		= 3.3333
AVGSTRICT(80, NAN)		= NaN
AVGSTRICT(NAN, NAN)		= NaN

VAR data := {10, 20, 30}; AVGSTRICT(data) 	= 20
AVGSTRICT({1, 2, 3})						= 2
AVGSTRICT({1, NaN, 3})						= NaN

ROUND

ROUND(value1)

Gibt den gerundeten Wert zurück.

Beispiel 1: ROUND(2.01)   (Ergebnis ist 2)
Beispiel 2: ROUND(2.49)   (Ergebnis ist 2)
Beispiel 3: ROUND(2.5)    (Ergebnis ist 3)
Beispiel 4: ROUND(2.99)   (Ergebnis ist 3)

ABS

Die ABS-Funktion gibt den absoluten Wert (d. h. Betrag) einer Zahl zurück.

ABS(number)

Beispiele:

ABS(100)  ...   100
ABS(-100)   ...   100

DEWPOINT

DEWPOINT(temperature, relativeHumidity)

Gibt den Taupunkt der aktuellen Temperatur und relativen Luftfeuchtigkeit zurück. Der Taupunkt wird gemäß dieser Gleichung berechnet.

Beispiel 1: DEWPOINT(20, 0.50) (Ergebnis ca. 9.26)
Beispiel 2: DEWPOINT(0, 1.00) (Ergebnis 0)

POWER

Die POWER-Funktion berechnet eine gegebene Zahl, potenziert mit einem vorgegebenen Exponenten.

POWER(number, power)

Beispiele:

  • POWER(2,3) … 2^3 = 8
  • POWER(10, -3) … 0,001
  • POWER(25, 0) … 1

MOD

Die MOD-Funktion gibt den Rest einer Division zweier Zahlen zurück.

MOD(number, divisor)

Argumente:

  • number – Die zu teilende Zahl.
  • divisor – Der Wert, durch den die Zahl geteilt wird.

Beispiele:

  • MOD(6, 4)  … 2
  • MOD(6, 2.5) … 1

CEIL

Die CEIL-Funktion rundet eine gegebene Zahl vom Betrag her auf das nächste Vielfache einer gegebenen Zahl auf.

CEIL(number, significance)

Argumente:

  • number – Die zu rundende Zahl.
  • significance (optional) – Das Vielfache, auf das die Zahl gerundet werden soll. Falls keine Signifikanz angegeben ist, gilt 1. (Sie sollte grundsätzlich das gleiche arithmetische Vorzeichen – positiv oder negativ – wie das Eingabeargument haben.)

Beispiele:

  • CEIL(22.25,0.1) … 22.3
  • CEIL(22.25,1) … 23
  • CEIL(22.25) … 23
  • CEIL(-22.25,-1) … -23
  • CEIL(-22.25,1) … -22
  • CEIL(-22.25) … -22
  • CEIL(-22.25,-5) … -25

FLOOR

Die FLOOR-Funktion rundet eine gegebene Zahl vom Betrag her auf das nächste Vielfache eines angegebenen Werts ab.

FLOOR(number, significance)

Argumente:

  • number – Die zu rundende Zahl.
  • significance (optional) – Das Vielfache, auf das die Zahl gerundet werden soll. Falls die Signifikanz nicht angegeben wird, gilt 1. (Sie sollte grundsätzlich das gleiche arithmetische Vorzeichen – positiv oder negativ – wie das Eingabeargument haben.)

Beispiele:

  • FLOOR(22.25,0.1)… 22.2
  • FLOOR(22.25,1) … 22
  • FLOOR(22.25) … 22
  • FLOOR(-22.25,-1) … -22
  • FLOOR(-22.25,1) … -23
  • FLOOR(-22.25) … -23
  • FLOOR(-22.25,-5) … -20

RAND

Die RAND-Funktion generiert eine Zufallszahl zwischen 0 und 1.

RAND()

Beispiele:

  • RAND()

RANDINT

Die RANDINT-Funktion erzeugt eine zufällige Ganzzahl zwischen zwei angegebenen Ganzzahlen.

RANDINT(bottom, top)

Beispiele:

  • RANDINT(1,5)
  • RANDINT(-2,2)

SIGN

Die SIGN-Funktion gibt das arithmetische Vorzeichen (+1, -1 oder 0) einer Zahl zurück. D. h. ist die Zahl positiv, gibt SIGN +1 zurück, ist sie negativ, -1, und wenn sie 0 ist, 0.

SIGN(number)

Beispiele:

  • SIGN(100) … 1
  • SIGN(0) … 0
  • SIGN(-100) … -1

SQRT

Die SQRT-Funktion berechnet die positive Quadratwurzel einer Zahl.

SQRT(number)

Beispiele:

  • SQRT(25) … 5

LOG

Die LOG-Funktion berechnet den Logarithmus einer gegebenen Zahl zu einer angegebenen Basis.

LOG(number, base)

Argumente:

  • number – Die positive reelle Zahl, deren Logarithmus berechnet werden soll.
  • base (optional) – Ein optionaler Parameter, der die Basis angibt, zu der der Logarithmus berechnet werden soll. Wenn der Parameter nicht angegeben wird, gilt die Standardbasis 10.

Beispiele:

  • LOG(4,0.5) … -2
  • LOG(100) … 2

LN

Die LN-Funktion berechnet den natürlichen Logarithmus einer gegebenen Zahl.

LN(number)

wobei der Zahlenparameter die positive reelle Zahl ist, deren natürlicher Logarithmus berechnet werden soll.

Beispiele:

  • LN(100) … 4,60517