playbook/docs/tsl/reference/catalog/math/statistics_descriptive.md

数学函数 - 描述统计

文档类型：函数事实页 是否可直接用于生成代码：是；本页函数条目均包含参数表 遇到不确定时：回到 ../math.md、../../index.md

本页收录一般统计量、次序统计量和含 NAN 统计函数。

一般统计量

minIntValue(a)

用途：进行数值统计计算。

参数个数：1 返回值：处理后的结果值

参数位置	参数名	必填	接收类型	说明
1	a	是	数组	按源文档示例顺序传入

sumOfSquares(a)

用途：进行数值统计计算。

参数个数：1 返回值：处理后的结果值

参数位置	参数名	必填	接收类型	说明
1	a	是	数组	按源文档示例顺序传入

stdDev(a[, arg2][, arg3][, arg4])

用途：一般统计量相关函数。

参数个数：1 到 4 返回值：处理后的结果值

参数位置	参数名	必填	接收类型	说明
1	a	是	数组	按源文档示例顺序传入
2	arg2	否	整数	按源文档示例顺序传入
3	arg3	否	任意值	按源文档示例顺序传入
4	arg4	否	字符串	按源文档示例顺序传入

mean(a[, arg2][, arg3][, arg4])

用途：进行数值统计计算。

参数个数：1 到 4 返回值：处理后的结果值

参数位置	参数名	必填	接收类型	说明
1	a	是	数组	按源文档示例顺序传入
2	arg2	否	整数	按源文档示例顺序传入
3	arg3	否	任意值	按源文档示例顺序传入
4	arg4	否	字符串	按源文档示例顺序传入

sum(a[, arg2][, arg3][, arg4])

用途：进行数值统计计算。

参数个数：1 到 4 返回值：处理后的结果值

参数位置	参数名	必填	接收类型	说明
1	a	是	数组	按源文档示例顺序传入
2	arg2	否	整数	按源文档示例顺序传入
3	arg3	否	任意值	按源文档示例顺序传入
4	arg4	否	字符串	按源文档示例顺序传入

maxValue(a[, arg2][, arg3][, arg4])

用途：进行数值统计计算。

参数个数：1 到 4 返回值：处理后的结果值

参数位置	参数名	必填	接收类型	说明
1	a	是	数组	按源文档示例顺序传入
2	arg2	否	整数	按源文档示例顺序传入
3	arg3	否	任意值	按源文档示例顺序传入
4	arg4	否	字符串	按源文档示例顺序传入

minValue(a[, arg2][, arg3][, arg4])

用途：进行数值统计计算。

参数个数：1 到 4 返回值：处理后的结果值

参数位置	参数名	必填	接收类型	说明
1	a	是	数组	按源文档示例顺序传入
2	arg2	否	整数	按源文档示例顺序传入
3	arg3	否	任意值	按源文档示例顺序传入
4	arg4	否	字符串	按源文档示例顺序传入

norm(a[, arg2][, arg3][, arg4])

用途：一般统计量相关函数。

参数个数：1 到 4 返回值：处理后的结果值

参数位置	参数名	必填	接收类型	说明
1	a	是	数组	按源文档示例顺序传入
2	arg2	否	整数	按源文档示例顺序传入
3	arg3	否	任意值	按源文档示例顺序传入
4	arg4	否	字符串	按源文档示例顺序传入

sumsAndSquares(a, b, c)

用途：进行数值统计计算。

参数个数：3 返回值：处理后的结果值

参数位置	参数名	必填	接收类型	说明
1	a	是	数组	按源文档示例顺序传入
2	b	是	任意值	按源文档示例顺序传入；源文档示例传入变量 b
3	c	是	任意值	按源文档示例顺序传入；源文档示例传入变量 c

maxIntValue(a)

用途：进行数值统计计算。

参数个数：1 返回值：处理后的结果值

参数位置	参数名	必填	接收类型	说明
1	a	是	数组	按源文档示例顺序传入

sumInt(a)

用途：进行数值统计计算。

参数个数：1 返回值：处理后的结果值

参数位置	参数名	必填	接收类型	说明
1	a	是	数组	按源文档示例顺序传入

harmean(data[, arg2][, arg3][, arg4])

用途：进行数值统计计算。

参数个数：1 到 4 返回值：处理后的结果值

参数位置	参数名	必填	接收类型	说明
1	data	是	数组	按源文档示例顺序传入
2	arg2	否	整数	按源文档示例顺序传入
3	arg3	否	任意值	按源文档示例顺序传入
4	arg4	否	字符串	按源文档示例顺序传入

variance(a[, arg2][, arg3][, arg4])

用途：一般统计量相关函数。

参数个数：1 到 4 返回值：处理后的结果值

参数位置	参数名	必填	接收类型	说明
1	a	是	数组	按源文档示例顺序传入
2	arg2	否	整数	按源文档示例顺序传入
3	arg3	否	任意值	按源文档示例顺序传入
4	arg4	否	字符串	按源文档示例顺序传入

meanAndStdDev(a, b, c)

用途：进行数值统计计算。

参数个数：3 返回值：处理后的结果值

参数位置	参数名	必填	接收类型	说明
1	a	是	数组	按源文档示例顺序传入
2	b	是	任意值	按源文档示例顺序传入；源文档示例传入变量 b
3	c	是	任意值	按源文档示例顺序传入；源文档示例传入变量 c

aveDev(data)

用途：一般统计量相关函数。

参数个数：1 返回值：处理后的结果值

参数位置	参数名	必填	接收类型	说明
1	data	是	数组	按源文档示例顺序传入

skewness(data[, arg2][, arg3][, arg4])

用途：一般统计量相关函数。

参数个数：1 到 4 返回值：处理后的结果值

参数位置	参数名	必填	接收类型	说明
1	data	是	数组	按源文档示例顺序传入
2	arg2	否	整数	按源文档示例顺序传入
3	arg3	否	任意值	按源文档示例顺序传入
4	arg4	否	字符串	按源文档示例顺序传入

totalVariance(a)

用途：一般统计量相关函数。

参数个数：1 返回值：处理后的结果值

参数位置	参数名	必填	接收类型	说明
1	a	是	数组	按源文档示例顺序传入

product(data[, arg2][, arg3][, arg4])

用途：一般统计量相关函数。

参数个数：1 到 4 返回值：处理后的结果值

参数位置	参数名	必填	接收类型	说明
1	data	是	数组	按源文档示例顺序传入
2	arg2	否	整数	按源文档示例顺序传入
3	arg3	否	任意值	按源文档示例顺序传入
4	arg4	否	字符串	按源文档示例顺序传入

popnStdDev(a[, arg2][, arg3][, arg4])

用途：一般统计量相关函数。

参数个数：1 到 4 返回值：处理后的结果值

参数位置	参数名	必填	接收类型	说明
1	a	是	数组	按源文档示例顺序传入
2	arg2	否	整数	按源文档示例顺序传入
3	arg3	否	任意值	按源文档示例顺序传入
4	arg4	否	字符串	按源文档示例顺序传入

kurtosis2(data[, arg2][, arg3][, arg4])

用途：一般统计量相关函数。

参数个数：1 到 4 返回值：处理后的结果值

参数位置	参数名	必填	接收类型	说明
1	data	是	数组	按源文档示例顺序传入
2	arg2	否	整数	按源文档示例顺序传入
3	arg3	否	任意值	按源文档示例顺序传入
4	arg4	否	字符串	按源文档示例顺序传入

median(data)

用途：一般统计量相关函数。

参数个数：1 返回值：处理后的结果值

参数位置	参数名	必填	接收类型	说明
1	data	是	数组	按源文档示例顺序传入

skewness2(data[, arg2][, arg3][, arg4])

用途：一般统计量相关函数。

参数个数：1 到 4 返回值：处理后的结果值

参数位置	参数名	必填	接收类型	说明
1	data	是	数组	按源文档示例顺序传入
2	arg2	否	整数	按源文档示例顺序传入
3	arg3	否	任意值	按源文档示例顺序传入
4	arg4	否	字符串	按源文档示例顺序传入

kurtosis(data[, arg2][, arg3][, arg4])

用途：一般统计量相关函数。

参数个数：1 到 4 返回值：处理后的结果值

参数位置	参数名	必填	接收类型	说明
1	data	是	数组	按源文档示例顺序传入
2	arg2	否	整数	按源文档示例顺序传入
3	arg3	否	任意值	按源文档示例顺序传入
4	arg4	否	字符串	按源文档示例顺序传入

mode(data)

用途：一般统计量相关函数。

参数个数：1 返回值：处理后的结果值

参数位置	参数名	必填	接收类型	说明
1	data	是	数组	按源文档示例顺序传入

randG(arg1, arg2)

用途：一般统计量相关函数。

参数个数：2 返回值：处理后的结果值

参数位置	参数名	必填	接收类型	说明
1	arg1	是	整数	按源文档示例顺序传入
2	arg2	是	整数	按源文档示例顺序传入

geomean(data[, arg2][, arg3][, arg4])

用途：进行数值统计计算。

参数个数：1 到 4 返回值：处理后的结果值

参数位置	参数名	必填	接收类型	说明
1	data	是	数组	按源文档示例顺序传入
2	arg2	否	整数	按源文档示例顺序传入
3	arg3	否	任意值	按源文档示例顺序传入
4	arg4	否	字符串	按源文档示例顺序传入

popnVariance(a[, arg2][, arg3][, arg4])

用途：一般统计量相关函数。

参数个数：1 到 4 返回值：处理后的结果值

参数位置	参数名	必填	接收类型	说明
1	a	是	数组	按源文档示例顺序传入
2	arg2	否	整数	按源文档示例顺序传入
3	arg3	否	任意值	按源文档示例顺序传入
4	arg4	否	字符串	按源文档示例顺序传入

momentSkewKurtosis(data, m1, m2, m3, m4, skew, kurtosis)

用途：一般统计量相关函数。

参数个数：7 返回值：处理后的结果值

参数位置	参数名	必填	接收类型	说明
1	data	是	数组	按源文档示例顺序传入
2	m1	是	任意值	按源文档示例顺序传入；源文档示例传入变量 M1
3	m2	是	任意值	按源文档示例顺序传入；源文档示例传入变量 M2
4	m3	是	任意值	按源文档示例顺序传入；源文档示例传入变量 M3
5	m4	是	任意值	按源文档示例顺序传入；源文档示例传入变量 M4
6	skew	是	任意值	按源文档示例顺序传入；源文档示例传入变量 Skew
7	kurtosis	是	任意值	按源文档示例顺序传入；源文档示例传入变量 Kurtosis

devSq(data)

用途：一般统计量相关函数。

参数个数：1 返回值：处理后的结果值

参数位置	参数名	必填	接收类型	说明
1	data	是	数组	按源文档示例顺序传入

服务器统计函数

cov(left_values, right_values)

用途：计算两个数值序列的协方差。

参数个数：2 返回值：实数

参数位置	参数名	必填	接收类型	说明
1	left_values	是	数值数组	第一个数值序列
2	right_values	是	数值数组	第二个数值序列；长度应与第一个序列一致且不少于 2

correl(left_values, right_values)

用途：计算两个数值序列的相关系数。

参数个数：2 返回值：实数

参数位置	参数名	必填	接收类型	说明
1	left_values	是	数值数组	第一个数值序列
2	right_values	是	数值数组	第二个数值序列；长度应与第一个序列一致且不少于 2

slope(y_values, x_values)

用途：计算 y_values 对 x_values 做线性回归时的斜率。

参数个数：2 返回值：实数

参数位置	参数名	必填	接收类型	说明
1	y_values	是	数值数组	因变量序列
2	x_values	是	数值数组	自变量序列；长度应与因变量序列一致且不少于 2

intercept(y_values, x_values)

用途：计算 y_values 对 x_values 做线性回归时的截距。

参数个数：2 返回值：实数

参数位置	参数名	必填	接收类型	说明
1	y_values	是	数值数组	因变量序列
2	x_values	是	数值数组	自变量序列；长度应与因变量序列一致且不少于 2

rsq(y_values, x_values)

用途：计算 y_values 与 x_values 的回归判定系数。

参数个数：2 返回值：实数

参数位置	参数名	必填	接收类型	说明
1	y_values	是	数值数组	因变量序列
2	x_values	是	数值数组	自变量序列；长度应与因变量序列一致且不少于 2

steyx(y_values, x_values)

用途：计算 y_values 对 x_values 做线性回归时的估计标准误差。

参数个数：2 返回值：实数

参数位置	参数名	必填	接收类型	说明
1	y_values	是	数值数组	因变量序列
2	x_values	是	数值数组	自变量序列；长度应与因变量序列一致且大于 2

slopeAndIntercept(y_values, x_values)

用途：计算 y_values 对 x_values 做线性回归时的斜率和截距。

参数个数：2 返回值：数组；第 1 个元素为斜率，第 2 个元素为截距

参数位置	参数名	必填	接收类型	说明
1	y_values	是	数值数组	因变量序列
2	x_values	是	数值数组	自变量序列；长度应与因变量序列一致且不少于 2

variationCoefficient(values)

用途：计算数值序列的变异系数。

参数个数：1 返回值：实数

参数位置	参数名	必填	接收类型	说明
1	values	是	数值数组	要计算的数值序列

selfStdDev(values, threshold)

用途：按给定阈值计算数值序列的下行标准差。

参数个数：2 返回值：实数

参数位置	参数名	必填	接收类型	说明
1	values	是	数值数组	要计算的数值序列
2	threshold	是	数值	阈值；按 value - threshold 处理后，将大于 0 的部分按 0 参与计算

skew(values, out_skew)

用途：计算数值序列的偏度。

参数个数：2 返回值：整数状态码；成功返回 1

参数位置	参数名	必填	接收类型	说明
1	values	是	数值数组	要计算的数值序列
2	out_skew	是	变量引用	接收偏度结果，结果类型为实数

kurt(values, out_kurt)

用途：计算数值序列的峰度。

参数个数：2 返回值：整数状态码；成功返回 1

参数位置	参数名	必填	接收类型	说明
1	values	是	数值数组	要计算的数值序列
2	out_kurt	是	变量引用	接收峰度结果，结果类型为实数

meanAndPopnStdDevWithRate(values, rates, out_mean, out_std_dev)

用途：按权重序列计算均值和总体标准差。

参数个数：4 返回值：整数状态码；成功返回 0

参数位置	参数名	必填	接收类型	说明
1	values	是	数值数组	要计算的数值序列
2	rates	是	数值数组	权重序列；长度应与 values 一致
3	out_mean	是	变量引用	接收均值，结果类型为实数
4	out_std_dev	是	变量引用	接收总体标准差，结果类型为实数

betaAndAlpha(y_values, x_values, out_beta, out_alpha)

用途：计算 y_values 对 x_values 做线性回归时的 beta 和 alpha。

参数个数：4 返回值：整数状态码；成功返回 0

参数位置	参数名	必填	接收类型	说明
1	y_values	是	数值数组	因变量序列
2	x_values	是	数值数组	自变量序列；长度应与因变量序列一致
3	out_beta	是	变量引用	接收 beta，结果类型为实数
4	out_alpha	是	变量引用	接收 alpha，结果类型为实数

regressionChannel(y_values, x_values, now_y, now_x, out_beta, out_alpha, out_upper_alpha, out_lower_alpha, out_upper_y, out_lower_y, out_position_percent, out_expected_y)

用途：按线性回归结果计算上下轨道、当前点所在轨道百分比和当前 x 的预期回归值。

参数个数：12 返回值：整数状态码；成功返回 0

参数位置	参数名	必填	接收类型	说明
1	y_values	是	数值数组	因变量序列
2	x_values	是	数值数组	自变量序列；长度应与因变量序列一致
3	now_y	是	数值	当前点的 y 值
4	now_x	是	数值	当前点的 x 值
5	out_beta	是	变量引用	接收 beta，结果类型为实数
6	out_alpha	是	变量引用	接收 alpha，结果类型为实数
7	out_upper_alpha	是	变量引用	接收上轨 alpha，结果类型为实数
8	out_lower_alpha	是	变量引用	接收下轨 alpha，结果类型为实数
9	out_upper_y	是	变量引用	接收 now_x 对应的上轨 y 值，结果类型为实数
10	out_lower_y	是	变量引用	接收 now_x 对应的下轨 y 值，结果类型为实数
11	out_position_percent	是	变量引用	接收 now_y 在上下轨之间的位置百分比，低于下轨可小于 0，高于上轨可大于 100
12	out_expected_y	是	变量引用	接收 now_x 对应的预期回归 y 值，结果类型为实数

correlpaired(left_values, right_values)

用途：按配对方式计算一个序列与另一个序列或矩阵的相关系数。

参数个数：2 返回值：数组

参数位置	参数名	必填	接收类型	说明
1	left_values	是	数值数组/数值矩阵	左侧序列或矩阵
2	right_values	是	数值数组/数值矩阵	右侧序列或矩阵

correlpairedSide(values, filter_type)

用途：按指定过滤方向计算配对相关系数矩阵。

参数个数：2 返回值：数组

参数位置	参数名	必填	接收类型	说明
1	values	是	数值矩阵	待计算的数值矩阵
2	filter_type	是	整数	过滤方向或样式参数

扩充统计函数

expdMax(values)

用途：计算数值序列的扩展最大值序列。

参数个数：1 返回值：数值数组

参数位置	参数名	必填	接收类型	说明
1	values	是	数值数组	待计算的数值序列

expdMin(values)

用途：计算数值序列的扩展最小值序列。

参数个数：1 返回值：数值数组

参数位置	参数名	必填	接收类型	说明
1	values	是	数值数组	待计算的数值序列

expdSum(values)

用途：计算数值序列的扩展求和序列。

参数个数：1 返回值：数值数组

参数位置	参数名	必填	接收类型	说明
1	values	是	数值数组	待计算的数值序列

expdProduct(values)

用途：计算数值序列的扩展乘积序列。

参数个数：1 返回值：数值数组

参数位置	参数名	必填	接收类型	说明
1	values	是	数值数组	待计算的数值序列

expdVar(values, mode)

用途：计算数值序列的扩展方差序列。

参数个数：2 返回值：数值数组

参数位置	参数名	必填	接收类型	说明
1	values	是	数值数组	待计算的数值序列
2	mode	是	整数	方差计算方式参数；常用 0

expdStd(values, mode)

用途：计算数值序列的扩展标准差序列。

参数个数：2 返回值：数值数组

参数位置	参数名	必填	接收类型	说明
1	values	是	数值数组	待计算的数值序列
2	mode	是	整数	标准差计算方式参数；常用 0

次序统计量

large(data, arg2)

用途：次序统计量相关函数。

参数个数：2 返回值：处理后的结果值

参数位置	参数名	必填	接收类型	说明
1	data	是	数组	按源文档示例顺序传入
2	arg2	是	整数	按源文档示例顺序传入

small(data, arg2)

用途：次序统计量相关函数。

参数个数：2 返回值：处理后的结果值

参数位置	参数名	必填	接收类型	说明
1	data	是	数组	按源文档示例顺序传入
2	arg2	是	整数	按源文档示例顺序传入

percentile(data, arg2[, arg3][, arg4][, arg5])

用途：次序统计量相关函数。

参数个数：2 到 5 返回值：处理后的结果值

参数位置	参数名	必填	接收类型	说明
1	data	是	数组	按源文档示例顺序传入
2	arg2	是	实数	按源文档示例顺序传入
3	arg3	否	整数	按源文档示例顺序传入
4	arg4	否	整数	按源文档示例顺序传入
5	arg5	否	数组	按源文档示例顺序传入

percentrank(data, arg2)

用途：次序统计量相关函数。

参数个数：2 返回值：处理后的结果值

参数位置	参数名	必填	接收类型	说明
1	data	是	数组	按源文档示例顺序传入
2	arg2	是	整数	按源文档示例顺序传入

quartile(data, arg2)

用途：次序统计量相关函数。

参数个数：2 返回值：处理后的结果值

参数位置	参数名	必填	接收类型	说明
1	data	是	数组	按源文档示例顺序传入
2	arg2	是	整数	按源文档示例顺序传入

rank(data, arg2)

用途：次序统计量相关函数。

参数个数：2 返回值：处理后的结果值

参数位置	参数名	必填	接收类型	说明
1	data	是	数组	按源文档示例顺序传入
2	arg2	是	整数	按源文档示例顺序传入

trimmean(data, arg2)

用途：对字符串进行裁剪处理。

参数个数：2 返回值：处理后的结果值

参数位置	参数名	必填	接收类型	说明
1	data	是	数组	按源文档示例顺序传入
2	arg2	是	实数	按源文档示例顺序传入

frequency(data, freq_data)

用途：次序统计量相关函数。

参数个数：2 返回值：处理后的结果值

参数位置	参数名	必填	接收类型	说明
1	data	是	数组	按源文档示例顺序传入
2	freq_data	是	数组	按源文档示例顺序传入

含NAN统计

nanPopnVariance()

用途：含NAN统计相关函数。

参数个数：0 返回值：处理结果

参数位置	参数名	必填	接收类型	说明

nanMean(values)

用途：忽略 nan 计算数值序列均值。

参数个数：1 返回值：实数

参数位置	参数名	必填	接收类型	说明
1	values	是	数值数组	可包含 nan 的数值序列

nanSum(values)

用途：忽略 nan 计算数值序列总和。

参数个数：1 返回值：实数

参数位置	参数名	必填	接收类型	说明
1	values	是	数值数组	可包含 nan 的数值序列

nanStd(values)

用途：忽略 nan 计算数值序列样本标准差。

参数个数：1 返回值：实数

参数位置	参数名	必填	接收类型	说明
1	values	是	数值数组	可包含 nan 的数值序列

nanVariance(values)

用途：忽略 nan 计算数值序列样本方差。

参数个数：1 返回值：实数

参数位置	参数名	必填	接收类型	说明
1	values	是	数值数组	可包含 nan 的数值序列

nanPopnStd(values)

用途：忽略 nan 计算数值序列总体标准差。

参数个数：1 返回值：实数

参数位置	参数名	必填	接收类型	说明
1	values	是	数值数组	可包含 nan 的数值序列

nanRankArr(values)

用途：忽略 nan 计算数值序列的秩数组。

参数个数：1 返回值：数组

参数位置	参数名	必填	接收类型	说明
1	values	是	数值数组	可包含 nan 的数值序列；nan 位置在结果中保持为 nan

nanPercentRankArr(values)

用途：忽略 nan 计算数值序列的百分位秩数组。

参数个数：1 返回值：数组

参数位置	参数名	必填	接收类型	说明
1	values	是	数值数组	可包含 nan 的数值序列；nan 位置在结果中保持为 nan