User Expressions

In Topological Tree Analyszer user-defined expressions are used to calculate the actual data (e.g., distances between trees) from basic topological values. A set of functions is available to formulate such expressions and to access the basic values. An unlimited number of user expressions can be defined and will be written to a results table at the end of an analysis. It is also possible to reference results from one user expression from another one and reuse the result there.

Operators

The following list contains all valid operators. Each operator binds as strong or more than all operators listed below. The right columns indicate which types the operands need to have.

Name:	Operator:	Numeric:	Textual:	Boolean:	Example:
Power	^				10^-2 (= 0.02)
Unary plus	+				+4
Unary minus	-				-4
Modulo	%				10 % 4 (= 2)
Division	/				treeUserValue("someValue") / 2
Multiplication	*				treeUserValue("someValue") * 100
Addition	+				treeUserValue("someValue") + 10 "Two " + "words"
Less or equal	<=				if(treeUserValue("someValue") <= 100, treeUserValue("someValue"), 100)
Greater or equal	>=				if(treeUserValue("someValue") <= 100, "A", "B")
Less then	<				if(treeUserValue("someValue") < 100, treeUserValue("someValue"), 100)
Greater then	>				if(treeUserValue("someValue") < 100, "A", "B")
Equal	=				if(treeUserValue("value1") = 100, treeUserValue("value2"), treeUserValue("value3"))
Not equal	!=				if(treeUserValue("value1") != "empty", treeUserValue("value2"), 0)
And	&&				if(treeUserValue("value1") < 100 && treeUserValue("value1") > 50, treeUserValue("value2"), "")
Or	||				if(treeUserValue("value1") < 100 || treeUserValue("value2") < 100, treeUserValue("value3"), "undefined")

General mathematical functions

Name:	Definition:	Description:
Sine	sin(Numeric x)	Calculates the sine of the passed numeric value.
Cosine	cos(Numeric x)	Calculates the cosine of the passed numeric value.
Tangent	tan(Numeric x)	Calculates the tangent of the passed numeric value.
Inverse sine	asin(Numeric x)	Calculates the inverse sine of the passed numeric value.
Inverse cosine	acos(Numeric x)	Calculates the inverse cosine of the passed numeric value.
Inverse tangent	atan(Numeric x)	Calculates the inverse tangent of the passed numeric value.
Inverse tangent	atan2(Numeric x, Numeric y)	Calculates the inverse tangent (or arcus tangent) of y / x given adjacent and x. The result is between -π and π
Hyperbolic sine	sinh(Numeric x)	Calculates the hyperbolic sine of the given angle.
Hyperbolic cosine	cosh(Numeric x)	Calculates the hyperbolic cosine of the given angle.
Hyperbolic tangent	tanh(Numeric x)	Calculates the hyperbolic tangent of the given angle.
Inverse hyperbolic sine	asinh(Numeric x)	Calculates the inverse hyperbolic sine of the given angle.
Inverse hyperbolic cosine	acosh(Numeric x)	Calculates the inverse hyperbolic cosine of the given angle.
Inverse hyperbolic tangent	atanh(Numeric x)	Calculates the inverse hyperbolic tangent of the given angle.
Natural logarithm	ln(Numeric x)	Calculates the natural logarithm of the passed numeric value.
Logarithm to the base 10	log(Numeric x)	Calculates the logarithm to the base 10 of the passed numeric value.
Exponential function	exp(Numeric x)	Calculates the exponential function to the base e. It is the inverse function of the natural logarithm (ln).
Magnitude	abs(Numeric x)	Returns the absolute value of the passed numeric parameter.
Random number	rand(Numeric x)	Returns a random number between 0 and 1.
Square Root	sqrt(Numeric x)	Calculates the square root of the passed numeric parameter.
Alternative	if(Boolean condition, Numeric or textual trueValue, Numeric or textual falseValue)	Returns the second parameter if the condition is true or the third if not.
Number to text	str(Numeric or textual x)	Returns a textual representation of the passed parameter.