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归一化单个标量轴