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 приведет к ошибке, если значения отсутствуют в одном из входных массивов.

Параметры

xarray_like

Одномерный или двумерный массив, содержащий несколько переменных и наблюдений. Каждая строка 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.

Доступно с версии 1.5.

Исключения

ValueError

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

См. также

numpy.cov