docs-v2/content/flux/v0.x/stdlib/math/expm1.md

3.7 KiB

title description menu weight
math.expm1() function `math.expm1()` returns `e**x - 1`, the base-e exponential of `x` minus 1. It is more accurate than `math.exp(x:x) - 1` when `x` is near zero.
flux_0_x_ref
name parent identifier
math.expm1 math math/expm1
101

math.expm1() returns e**x - 1, the base-e exponential of x minus 1. It is more accurate than math.exp(x:x) - 1 when x is near zero.

Function type signature
(x: float) => float

{{% caption %}}For more information, see Function type signatures.{{% /caption %}}

Parameters

x

({{< req >}}) Value to operate on.

Examples

Get more accurate base-e exponentials for values near zero

import "math"

math.expm1(x: 0.022)// 0.022243784470438233


Use math.expm1 in map

import "math"

data
    |> map(fn: (r) => ({r with _value: math.expm1(x: r._value)}))

{{< expand-wrapper >}} {{% expand "View example input and ouput" %}}

Input data

_time _value *tag
2021-01-01T00:00:00Z -0.021800000000000003 t1
2021-01-01T00:00:10Z 0.1092 t1
2021-01-01T00:00:20Z 0.0735 t1
2021-01-01T00:00:30Z 0.1753 t1
2021-01-01T00:00:40Z 0.15230000000000002 t1
2021-01-01T00:00:50Z 0.0443 t1
_time _value *tag
2021-01-01T00:00:00Z 0.1985 t2
2021-01-01T00:00:10Z 0.0497 t2
2021-01-01T00:00:20Z -0.0375 t2
2021-01-01T00:00:30Z 0.1977 t2
2021-01-01T00:00:40Z 0.1386 t2
2021-01-01T00:00:50Z 0.018600000000000002 t2

Output data

_time _value *tag
2021-01-01T00:00:00Z -0.02156409733567063 t1
2021-01-01T00:00:10Z 0.11538540511625006 t1
2021-01-01T00:00:20Z 0.07626853667189179 t1
2021-01-01T00:00:30Z 0.1916036440887826 t1
2021-01-01T00:00:40Z 0.16450953689549175 t1
2021-01-01T00:00:50Z 0.045295896623819054 t1
_time _value *tag
2021-01-01T00:00:00Z 0.21957202741425103 t2
2021-01-01T00:00:10Z 0.05095576234958021 t2
2021-01-01T00:00:20Z -0.03680558227917823 t2
2021-01-01T00:00:30Z 0.21859675995131905 t2
2021-01-01T00:00:40Z 0.14866454228127554 t2
2021-01-01T00:00:50Z 0.018774057481622756 t2

{{% /expand %}} {{< /expand-wrapper >}}