statsmodels.genmod.cov_struct.Nested.covariance_matrix_solve¶
- Nested.covariance_matrix_solve(expval, index, stdev, rhs)¶
Solves matrix equations of the form covmat * soln = rhs and returns the values of soln, where covmat is the covariance matrix represented by this class.
- Parameters:
- expvalarray_like
The expected value of endog for each observed value in the group.
- index
int The group index.
- stdevarray_like
The standard deviation of endog for each observation in the group.
- rhslist/tuple
ofarray_like A set of right-hand sides; each defines a matrix equation to be solved.
- Returns:
- solnlist/tuple
ofarray_like The solutions to the matrix equations.
- solnlist/tuple
Notes
Returns None if the solver fails.
Some dependence structures do not use expval and/or index to determine the correlation matrix. Some families (e.g. binomial) do not use the stdev parameter when forming the covariance matrix.
If the covariance matrix is singular or not SPD, it is projected to the nearest such matrix. These projection events are recorded in the fit_history attribute of the GEE model.
Systems of linear equations with the covariance matrix as the left hand side (LHS) are solved for different right hand sides (RHS); the LHS is only factorized once to save time.
This is a default implementation, it can be reimplemented in subclasses to optimize the linear algebra according to the structure of the covariance matrix.