numpy.lib.array_utils.normalize_axis_tuple

lib.array_utils.normalize_axis_tuple(axis, ndim, argname=None, allow_duplicate=False)

将轴参数规范化为非负整数轴的元组。

它处理诸如 1 这样的简写形式并将其转换为 (1,)，同时处理由 normalize_axis_index 所涵盖的负索引。

默认情况下，此函数禁止多次指定轴。

内部用于多轴检查逻辑。

参数:

axisint, int 可迭代对象

轴的未规范化索引。

ndimint

应参照其进行规范化的数组的维度数量。

argnamestr, 可选

放置在错误消息前的词缀，通常是参数的名称。

allow_duplicatebool, 可选

如果为 False（默认值），则禁止多次指定轴。

返回:

normalized_axesint 元组

规范化后的轴索引，使得 0 <= normalized_axis < ndim

抛出:

AxisError

如果提供的任何轴超出范围

ValueError

如果轴重复出现

另请参阅

normalize_axis_index

规范化单个标量轴