numpy.ma.cov

numpy.ma.cov(x, y=None, rowvar=True, bias=False, allow_masked=True, ddof=None) [source]

Оценивает матрицу ковариации.

За исключением обработки пропущенных данных, эта функция выполняет те же действия, что и numpy.cov. Более подробную информацию и примеры см. в numpy.cov.

По умолчанию, значения с маской распознаются как таковые. Если x и y имеют одинаковую форму, выделяется общая маска: если x[i,j] имеет маску, то y[i,j] также будет иметь маску. Установка allow_masked в значение False вызовет исключение, если значения отсутствуют в одном из массивов входных данных.

Parameters

xarray_like

Массив 1-D или 2-D, содержащий несколько переменных и наблюдений. Каждая строка в x представляет переменную, а каждый столбец — одно наблюдение всех этих переменных. Также см. rowvar ниже.

yarray_like, optional

Дополнительный набор переменных и наблюдений. y имеет ту же форму, что и x.

rowvarbool, optional

Если rowvar имеет значение True (по умолчанию), то каждая строка представляет переменную, а наблюдения содержатся в столбцах. В противном случае, соотношение транспонируется: каждый столбец представляет переменную, а строки содержат наблюдения.

biasbool, optional

Нормализация по умолчанию (False) осуществляется по (N-1), где N — число предоставленных наблюдений (несмещённая оценка). Если bias имеет значение True, то нормализация осуществляется по N. Этот ключевой параметр может быть переопределён ключевым параметром ddof в версиях numpy >= 1.5.

allow_maskedbool, optional

Если True, значения с маской распространяются попарно: если значение имеет маску в x, соответствующее значение имеет маску в y. Если False, возникает исключение ValueError, когда некоторые значения отсутствуют.

ddof{None, int}, optional

Если не None, нормализация производится по (N - ddof), где N — количество наблюдений; это переопределяет значение, подразумеваемое bias. Значение по умолчанию — None.

New in version 1.5.

Raises

ValueError

Возникает, если некоторые значения отсутствуют, а allow_masked имеет значение False.

См. также

numpy.cov