The TANH() function returns the hyperbolic tangent of a given value. It's a hyperbolic function that calculates the ratio of hyperbolic sine to hyperbolic cosine, mathematically expressed as TANH(x) = SINH(x) / COSH(x) = (e^x - e^(-x)) / (e^x + e^(-x)). The function accepts any real number and returns a value between -1 and 1. It creates an S-shaped curve commonly used for normalization and smooth transitions.
This function can be useful to compress raw rolling forecast signals into a normalised range, smoothing out extreme outliers over time.
Syntax
TANH(Value)
Arguments
| Argument | Data type | Description |
| Value | Number | The numeric value for which you want to calculate the hyperbolic tangent. The input can be any finite number. |
The TANH() function returns a numeric value between -1 and 1, inclusive.
Calculation engine functionality differences
This function is only available in the Polaris Calculation Engine.
Syntax example
TANH(1)
Additional information
Returns NaN when Angle is NaN.
Excel equivalent
Examples
| Formula | Result |
TANH(-2) | -0.964 |
TANH(1) | 0 |
TANH(0.5) | 0.4621 |
Example 1: Price discount saturation modeling
Example 2: Market sentiment score normalisation for investment signals
Example 3: Supplier capacity utilisation signal compression
Example 4: New hire productivity ramp-up modeling
