pypto_pro.language.simt.atanh

产品支持情况

• Ascend 950PR&950DT系列产品：支持

• Atlas A3系列产品：不支持

• Atlas A2系列产品：不支持

功能说明

计算value的反双曲正切，计算公式如下。

\[result = \operatorname{atanh}(value)=\frac{1}{2}\ln\left(\frac{1+value}{1-value}\right)\]

函数原型

pypto_pro.language.simt.atanh(
    value: float,
) -> Scalar

参数说明

参数	输入/输出	说明
value	输入	源操作数，浮点型常量或运行时浮点标量表达式，仅支持DT_FP32，有限实数定义域为\([-1,1]\)。Tensor或Tile元素需通过下标访问后传入。

约束说明

只能在由@pypto_pro.language.vector_function(mode=”simt”)定义的SIMT函数中调用。

返回值说明

返回反双曲正切值，数据类型为DT_FP32。特殊值如下：

value取值	返回值
+0	+0
-0	-0
+1	+Inf
-1	-Inf
绝对值大于1的有限数	NaN
±Inf	NaN
NaN	NaN

调用示例

import pypto_pro.language as pl


@pl.vector_function(mode="simt", max_threads=64)
def atanh_example(
    value: pl.Tensor[[1, 64], pl.DT_FP32],
    output: pl.Tensor[[1, 64], pl.DT_FP32],
):
    tid = pl.simt.linear_thread_idx()
    output[0, tid] = pl.simt.atanh(value[0, tid])


@pl.jit()
def atanh_kernel(
    value: pl.Tensor[[1, 64], pl.DT_FP32],
    output: pl.Tensor[[1, 64], pl.DT_FP32],
):
    with pl.section_vector():
        atanh_example[64](value, output)