numpy.ma.dot

numpy.ma.dot(a, b, strict=False, out=None) [source]

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

Эта функция эквивалентна numpy.dot, учитывающей значения с маской. Обратите внимание, что strict и out находятся в другом положении, чем в версии метода. Для сохранения совместимости с соответствующим методом рекомендуется рассматривать необязательные аргументы как только ключевые. В какой-то момент это может стать обязательным.

Примечание

В настоящее время работает только с двумерными массивами.

Параметры

a, bmasked_array_like

Входные массивы.

strictbool, optional

Определяет, распространяются ли значения с маской (True) или устанавливаются в 0 (False) при вычислении. По умолчанию False. Распространение маски означает, что если появляется значение с маской в строке или столбце, вся строка или столбец считаются замаскированными.

outmasked_array, optional

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

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

См. также

numpy.dot

Эквивалентная функция для nd-массивов.

Примеры

>>> a = np.ma.array([[1, 2, 3], [4, 5, 6]], mask=[[1, 0, 0], [0, 0, 0]])
>>> b = np.ma.array([[1, 2], [3, 4], [5, 6]], mask=[[1, 0], [0, 0], [0, 0]])
>>> np.ma.dot(a, b)
masked_array(
  data=[[21, 26],
        [45, 64]],
  mask=[[False, False],
        [False, False]],
  fill_value=999999)
>>> np.ma.dot(a, b, strict=True)
masked_array(
  data=[[--, --],
        [--, 64]],
  mask=[[ True,  True],
        [ True, False]],
  fill_value=999999)