Polybench® Reference
Results in the natural logarithm (ln) of the input signal

Ln(S)

Overview

This operator calculates the natural Logarithm (ln).
The ln is applied to every input value on every channel. The result is written to the same channel at the output.

Operator ports

Input S: Floating point values

Output ln(S): Floating point values

Properties

Find more information about changing properties here: link

Caption
type: Word or phrase
The name of the object in the project. This name must not contain '.' or '$' characters.

Every object has the Caption property. This property is very important, because it is the name by which Polybench recognizes this object.
It is allowed to give multiple objects the same name, as long as the objects are of the same type. In that case, a reference to this caption includes all the objects with the same caption.
In Polybench, every object can be addressed by an Address specifier, which starts with the dollar sign, for example: $My Page.My Object. 'My Page' would be the Caption of a page, and 'My Object' the Caption of an object on that page.

Documentation
type: See description
Optional documentation of this object.

It is good practice to write in short notes why you have used this object, and why its properties are set the way they are set. If this object is an operator, the Documentation text is displayed below the operator symbol.

Details

A calculation of ln of the value 0 or negative values is not allowed. If the ln calculation cannot be performed, the operator outputs the last valid sample once more. The symbol of the ln will then display a warning.

Examples

Example: Log - Ln - Exp Demo
This demo shows the behavior of the 10Log, Ln and e^y operators. Press 'Start displays' first so that the numerical displays display values. Then type values in the Input Field.
Note the behavior of the operators when they are forced to do illegal calculations. They will show a warning about any problems, but keep their output unchanged.
Examples\DF0411129_001_ln_Demo.xmc