numpy 1.22.4 Pypi GitHub Homepage
Other Docs
ParametersRaises
cov(x, y=None, rowvar=True, bias=False, allow_masked=True, ddof=None)

Except for the handling of missing data this function does the same as numpy.cov . For more details and examples, see numpy.cov .

By default, masked values are recognized as such. If x and y have the same shape, a common mask is allocated: if x[i,j] is masked, then y[i,j] will also be masked. Setting :None:None:`allow_masked` to False will raise an exception if values are missing in either of the input arrays.

Parameters

x : array_like

A 1-D or 2-D array containing multiple variables and observations. Each row of x represents a variable, and each column a single observation of all those variables. Also see :None:None:`rowvar` below.

y : array_like, optional

An additional set of variables and observations. y has the same shape as x.

rowvar : bool, optional

If :None:None:`rowvar` is True (default), then each row represents a variable, with observations in the columns. Otherwise, the relationship is transposed: each column represents a variable, while the rows contain observations.

bias : bool, optional

Default normalization (False) is by (N-1) , where N is the number of observations given (unbiased estimate). If :None:None:`bias` is True, then normalization is by N . This keyword can be overridden by the keyword ddof in numpy versions >= 1.5.

allow_masked : bool, optional

If True, masked values are propagated pair-wise: if a value is masked in x, the corresponding value is masked in y. If False, raises a :None:None:`ValueError` exception when some values are missing.

ddof : {None, int}, optional

If not None normalization is by (N - ddof) , where N is the number of observations; this overrides the value implied by bias . The default value is None .

versionadded

Raises

ValueError

Raised if some values are missing and :None:None:`allow_masked` is False.

Estimate the covariance matrix.

See Also

numpy.cov

Examples

See :

Local connectivity graph

Hover to see nodes names; edges to Self not shown, Caped at 50 nodes.

Using a canvas is more power efficient and can get hundred of nodes ; but does not allow hyperlinks; , arrows or text (beyond on hover)

SVG is more flexible but power hungry; and does not scale well to 50 + nodes.

All aboves nodes referred to, (or are referred from) current nodes; Edges from Self to other have been omitted (or all nodes would be connected to the central node "self" which is not useful). Nodes are colored by the library they belong to, and scaled with the number of references pointing them


GitHub : /numpy/ma/extras.py#1302
type: <class 'function'>
Commit: