Spec-Zone.ru › NumPy 1.14

numpy.dot

numpy.dot(a, b, out=None)

Скалярное произведение двух массивов. В частности:

  • Если оба a и b являются одномерными массивами, то это скалярное произведение векторов (без комплексного сопряжения).
  • Если оба a и b являются двумерными массивами, это матричное умножение, но предпочтительнее использовать matmul или a @ b.
  • Если один из a или b является нульмерным (скалярным), это эквивалентно multiply, и предпочтительнее использовать numpy.multiply(a, b) или a * b.
  • Если a является N-мерным массивом, а b - одномерным, то это сумма произведений по последней оси a и b.
  • Если a является N-мерным массивом, а b - M-мерным массивом (где M>=2), это сумма произведений по последней оси a и предпоследней оси b:

    dot(a, b)[i,j,k,m] = sum(a[i,j,:] * b[k,:,m])
    
Параметры:

a : array_like

Первый аргумент.

b : array_like

Второй аргумент.

out : ndarray, необязательно

Аргумент вывода. Он должен иметь точно тот же тип, что и был бы возвращён без его использования. В частности, он должен иметь правильный тип, быть C-непрерывным и иметь тот же тип данных, что и был бы возвращён для dot(a,b). Это функция производительности. Поэтому, если эти условия не выполнены, возникает исключение, вместо попытки гибкости.

Возвращает:

output : ndarray

Возвращает скалярное произведение a и b. Если a и b являются скалярами или оба являются одномерными массивами, то возвращается скаляр; в противном случае возвращается массив. Если out задан, то он возвращается.

Возможные исключения:

ValueError

Если последняя размерность a не совпадает с предпоследней размерностью b.

См. также

vdot
Комплексное сопряжённое скалярное произведение.
tensordot
Сумма произведений по произвольным осям.
einsum
Условное суммирование по Эйнштейну.
matmul
Оператор ‘@’ как метод с параметром out.

Примеры

>>> np.dot(3, 4)
12

Ни один из аргументов не комплексно сопряжён:

>>> np.dot([2j, 3j], [2j, 3j])
(-13+0j)

Для двумерных массивов это матричное произведение:

>>> a = [[1, 0], [0, 1]]
>>> b = [[4, 1], [2, 2]]
>>> np.dot(a, b)
array([[4, 1],
       [2, 2]])
>>> a = np.arange(3*4*5*6).reshape((3,4,5,6))
>>> b = np.arange(3*4*5*6)[::-1].reshape((5,4,6,3))
>>> np.dot(a, b)[2,3,2,1,2,2]
499128
>>> sum(a[2,3,2,:] * b[1,2,:,2])
499128

© 2005–2019 NumPy Developers
Licensed under the 3-clause BSD License.
https://docs.scipy.org/doc/numpy-1.14.5/reference/generated/numpy.dot.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API