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, iterable of int

轴的未归一化索引或索引。

ndimint

应针对其归一化 axis 的数组的维度数。

argnamestr, optional

添加到错误消息前面的前缀,通常是参数的名称。

allow_duplicatebool, optional

如果为 False(默认值),则不允许重复指定轴。

返回:
normalized_axestuple of int

归一化后的轴索引,满足 0 <= normalized_axis < ndim

引发:
AxisError

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

ValueError

如果轴重复

另请参阅

normalize_axis_index

归一化单个标量轴