numpy.lib.array_utils.normalize_axis_tuple

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

Нормализует аргумент оси в кортеж осей с целочисленными значениями, неотрицательными значениями.

Обрабатывает сокращения, такие как 1 и преобразует их в (1,), а также выполняет обработку отрицательных индексов, охваченных normalize_axis_index.

По умолчанию запрещает указание осей несколько раз.

Используется во внутренней логике проверки осей.

Добавлена в версии 1.13.0.

Параметры:

axisint, итерируемый из int

Ненормализованный индекс или индексы оси.

ndimint

Количество измерений массива, по отношению к которому должна быть нормализована ось axis.

argnamestr, необязательно

Префикс, добавляемый к сообщению об ошибке, обычно имя аргумента.

allow_duplicatebool, необязательно

Если False (по умолчанию), не допускает указания оси дважды.

Возвращаемое значение:

normalized_axesкортеж из int

Индекс нормализованной оси, такой что 0 <= normalized_axis < ndim.

Исключения:

AxisError

Если какая-либо предоставленная ось выходит за пределы допустимых значений.

ValueError

Если ось повторяется.

См. также

normalize_axis_index

нормализация скалярной оси