numpy.matmul

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

Матричное произведение двух массивов.

Поведение зависит от аргументов следующим образом.

• Если оба аргумента являются 2-мерными, они умножаются как обычные матрицы.
• Если любой из аргументов является N-мерным, N > 2, он рассматривается как набор матриц, расположенных в двух последних индексах, и соответствующим образом транслируется.
• Если первый аргумент является 1-мерным, он преобразуется в матрицу, добавив 1 к его размерностям. После умножения матриц добавленная 1 удаляется.
• Если второй аргумент является 1-мерным, он преобразуется в матрицу, добавив 1 к его размерностям. После умножения матриц добавленная 1 удаляется.

Умножение на скаляр запрещено, используйте * вместо этого. Обратите внимание, что умножение набора матриц на вектор приведет к набору векторов, но matmul не распознает это как таковое.

matmul отличается от dot двумя важными способами.

• Умножение на скаляры запрещено.
• Наборы матриц транслируются вместе, как если бы матрицы были элементами.

Предупреждение

Эта функция предварительная и включена в Numpy 1.10 для тестирования и документирования. Ее семантика не изменится, но количество и порядок необязательных аргументов будут.

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

Параметры:	a : array_like Первый аргумент. b : array_like Второй аргумент. out : ndarray, необязательно Аргумент вывода. Он должен иметь точный тип, который был бы возвращен, если бы он не использовался. В частности, он должен иметь правильный тип, должен быть C-непрерывным, и его dtype должен быть dtype, который был бы возвращен для dot(a,b). Это функция производительности. Поэтому, если эти условия не выполнены, генерируется исключение, вместо попытки быть гибким.
Возвращает:	output : ndarray Возвращает скалярное произведение a и b. Если a и b оба являются 1-мерными массивами, то возвращается скаляр; в противном случае возвращается массив. Если out задано, то возвращается оно.
Исключения:	ValueError Если последняя размерность a не совпадает с предпоследней размерностью b. Если передан скаляр.

См. также

vdot

Комплексно-сопряжённое скалярное произведение.

tensordot

Сумма произведений по произвольным осям.

einsum

Обозначение Эйнштейна для суммирования.

dot

альтернативное матричное произведение с другими правилами трансляции.

Примечания

Функция matmul реализует семантику оператора @ введенного в Python 3.5, согласно PEP465.

Примеры

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

>>> a = [[1, 0], [0, 1]]
>>> b = [[4, 1], [2, 2]]
>>> np.matmul(a, b)
array([[4, 1],
       [2, 2]])

Для 2-мерных массивов в сочетании с 1-мерными результатом является обычное произведение.

>>> a = [[1, 0], [0, 1]]
>>> b = [1, 2]
>>> np.matmul(a, b)
array([1, 2])
>>> np.matmul(b, a)
array([1, 2])

Трансляция является стандартной для наборов массивов

>>> a = np.arange(2*2*4).reshape((2,2,4))
>>> b = np.arange(2*2*4).reshape((2,4,2))
>>> np.matmul(a,b).shape
(2, 2, 2)
>>> np.matmul(a,b)[0,1,1]
98
>>> sum(a[0,1,:] * b[0,:,1])
98

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

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

Умножение на скаляр приводит к ошибке.

>>> np.matmul([1,2], 3)
Traceback (most recent call last):
...
ValueError: Scalar operands are not allowed, use '*' instead