numpy.matmul

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

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

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

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

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

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

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

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

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

Новая в версии 1.10.0.

Параметры:	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

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

dot

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

Примечания

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

Примеры

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

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

Для двумерных, смешанных с одномерными, результат обычный.

>>> 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