Spence

产品支持情况

产品	是否支持
Ascend 950PR/Ascend 950DT	√
Atlas A3 训练系列产品/Atlas A3 推理系列产品	√
Atlas A2 训练系列产品/Atlas A2 推理系列产品	√
Atlas 200I/500 A2 推理产品	×
Atlas 推理系列产品	√
Atlas 训练系列产品	√

功能说明

• 算子功能：计算Spence函数（dilogarithm），S(x) = -integral_0^x ln(1-t)/t dt。

• 计算公式：

$$\text{Spence}(x)={\int }_1^x\frac{\ln t}{t-1}dt={\text{Li}}_2(1-x)$$

特殊值：

• $x<0$ 时输出 NaN
• $x=0$ 时输出 ${\pi }^2/6\approx 1.6449$
• $x=1$ 时输出 $0$

参数说明

参数名	输入/输出/属性	描述	数据类型	数据格式
x	输入	Spence函数的自变量，对应公式中x。x < 0的元素输出NaN。	FLOAT16、FLOAT、BFLOAT16	ND
y	输出	Spence函数的计算结果，对应公式中Spence(x)。	FLOAT16、FLOAT、BFLOAT16	ND

约束说明

• FLOAT16、BFLOAT16输入在kernel内部提升到FLOAT32计算，结果再转回原始数据类型。

调用说明

调用方式	调用样例	说明
图模式调用	test_geir_spence	通过图模式调用Spence算子。