numpy.put_along_axis

numpy.put_along_axis(arr, indices, values, axis)[source]

Размещение значений в массив назначения путём сопоставления 1d индексов и слайсов данных.

Этот метод итерируется по сопоставляющим 1d слайсам, ориентированным вдоль указанной оси в массивах индексов и данных, и использует первые для размещения значений во вторые. Эти слайсы могут иметь различную длину.

Функции, возвращающие индекс вдоль оси, такие как argsort и argpartition, генерируют подходящие индексы для этой функции.

Введено в версии 1.15.0.

Параметры

arrndarray (Ni…, M, Nk…)

Массив назначения.

indicesndarray (Ni…, J, Nk…)

Индексы для изменения вдоль каждого 1d слайса arr. Этот массив должен соответствовать размерности arr, но размерности в Ni и Nj могут быть 1 для трансляции против arr.

valuesarray_like (Ni…, J, Nk…)

Значения для вставки по этим индексам. Его форма и размерность транслируются для соответствия форме и размерности indices.

axisint

Ось, вдоль которой брать 1d слайсы. Если axis равно None, массив назначения обрабатывается так, как будто был создан сплющенный 1d вид.

См. также

take_along_axis

Извлечение значений из входного массива по сопоставлению 1d индексов и слайсов данных

Примечания

Это эквивалентно (но быстрее, чем) следующему использованию ndindex и s_, которое устанавливает каждый из ii и kk в кортеж индексов:

Ni, M, Nk = a.shape[:axis], a.shape[axis], a.shape[axis+1:]
J = indices.shape[axis]  # Need not equal M

for ii in ndindex(Ni):
    for kk in ndindex(Nk):
        a_1d       = a      [ii + s_[:,] + kk]
        indices_1d = indices[ii + s_[:,] + kk]
        values_1d  = values [ii + s_[:,] + kk]
        for j in range(J):
            a_1d[indices_1d[j]] = values_1d[j]

Аналогично, исключив внутренний цикл, последние две строки будут:

a_1d[indices_1d] = values_1d

Примеры

Для этого образцового массива

>>> a = np.array([[10, 30, 20], [60, 40, 50]])

Мы можем заменить максимальные значения на:

>>> ai = np.expand_dims(np.argmax(a, axis=1), axis=1)
>>> ai
array([[1],
       [0]])
>>> np.put_along_axis(a, ai, 99, axis=1)
>>> a
array([[10, 99, 20],
       [99, 40, 50]])