pypto_pro.language.simt.normcdfinv#

产品支持情况#

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

  • Atlas A3系列产品：不支持

  • Atlas A2系列产品：不支持

功能说明#

计算标准正态分布累积分布函数的反函数，数学上满足\(\Phi(result)=value\)，返回其浮点近似值。

函数原型#

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

参数说明#

参数

输入/输出

说明

value

输入

累计概率，Scalar类型，仅支持DT_FP32，实数定义域为\([0,1]\)。Tensor或Tile元素需通过下标访问后传入。

约束说明#

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

  • 定义域是数学语义说明，不进行输入数值范围的编译期校验。输入超出\([0,1]\)（包括正负无穷）或为NaN时返回NaN。

返回值说明#

返回标准正态分布分位数，数据类型为DT_FP32。输入为0和1时分别返回负无穷和正无穷，输入为0.5时返回零。

调用示例#

import pypto_pro.language as pl


@pl.vector_function(mode="simt", max_threads=64)
def normcdfinv_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.normcdfinv(value[0, tid])


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