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

应该对 axis 进行标准化的数组的维度数。

argnamestr,可选

放在错误消息之前的字符串前缀,通常是参数的名称。

allow_duplicatebool,可选

如果为 False(默认值),则禁止重复指定轴。

返回:
normalized_axesint 的元组

标准化的轴索引,使得 0 <= normalized_axis < ndim

引发:
AxisError

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

ValueError

如果轴重复

另请参阅

normalize_axis_index

标准化单个标量轴