Computes the base e natural logarithm of a specified input value.
If x is 0, ln is -
. If x is not complex and is less than 0, ln is not a number (NaN).
x
An input for this operation. x must be in the range [1/e, 1) and unsigned. The integer word length must be 0 bits.
This input supports only scalar values of the fixed-point data type.
Computing ln(x) When x is Outside the Valid Range
Complete the following steps to compute ln( x) when x is outside the range [1/e, 1):
-
Shift the binary point of x until the binary point is immediately to the left of the first nonzero bit of x. The resulting number M always is greater than or equal to 0.5, which is in the valid range [1/e, 1).
-
Compute ln(M) + (E × ln(2)), where E is equal the number of times you shifted the binary point to the left. The result is equivalent to ln(x).
-
Because M is in the valid range of [1/e, 1), use this node to compute ln(M)
Note
If you shift the binary point to the right, E is the negative value of the number of times you shifted the point. For example, if you shift the binary point three places to the right, E is -3.
NI recommends a binary shift to transform x into M because this operation requires fewer FPGA resources than a division operation.
input valid
Boolean value that specifies whether the next data point is valid and can be processed.
Wire output valid of an upstream node to this input to transfer data from the upstream node to this node.
True |
The data point is valid and can be processed. |
False |
The data point is not valid. |
ready for output
Boolean value that specifies whether downstream nodes are ready for this node to return a new value.
Use Feedback Node to wire ready for input of a downstream node to ready for output of the current node. If this input is False during a given cycle, output valid returns False during that cycle.
True |
The downstream node is ready for the next data point. |
False |
The downstream node is not ready for the next data point. |
Default: False
ln(x)
Natural logarithm of x. If x is outside the range [1/e, 1), ln(x) is undefined.
undefined
A Boolean that indicates whether ln(x) is undefined.
TRUE |
ln(x) is undefined. |
FALSE |
ln(x) is not undefined. |
output valid
Boolean value that indicates whether this node computes a result that downstream nodes can use.
Wire this output to input valid of a downstream node to transfer data from the node to the downstream node.
True |
Downstream nodes can use the result this node computes. |
False |
This node returns an undefined value that downstream nodes cannot use.
Note
This node may return different undefined values when executed in simulation mode versus when executed on hardware.
|
ready for input
Boolean value that indicates whether this node is ready to accept new input data.
Use Feedback Node to wire this output to ready for output of an upstream node.
True |
The node is ready to accept new input data. |
False |
The node is not ready to accept new input data. |
Note
If this output returns False during a given cycle, this node discards any data that other nodes send to this node during the following cycle. This node discards the data even if input valid is True during the following cycle.
Where This Node Can Run:
Desktop OS: none
FPGA: All devices
Web Server: Not supported in VIs that run in a web application