WorksheetFunction.Covar Method
Returns covariance, the average of the products of deviations for each data point pair.
Namespace: Microsoft.Office.Interop.Excel
Assembly: Microsoft.Office.Interop.Excel (in Microsoft.Office.Interop.Excel.dll)
Syntax
'Declaration
Function Covar ( _
Arg1 As Object, _
Arg2 As Object _
) As Double
'Usage
Dim instance As WorksheetFunction
Dim Arg1 As Object
Dim Arg2 As Object
Dim returnValue As Double
returnValue = instance.Covar(Arg1, Arg2)
double Covar(
Object Arg1,
Object Arg2
)
Parameters
Arg1
Type: System.ObjectThe first cell range of integers.
Arg2
Type: System.ObjectThe second cell range of integers.
Return Value
Type: System.Double
Remarks
Important
This function has been replaced with one or more new functions that may provide improved accuracy and whose names better reflect their usage. This function is still available for compatibility with earlier versions of Excel. However, if backward compatibility is not required, you should consider using the new functions from now on, because they more accurately describe their functionality. For more information about the new functions, see the Covariance_P(Object, Object) and Covariance_S(Object, Object) method.
Use covariance to determine the relationship between two data sets. For example, you can examine whether greater income accompanies greater levels of education.
The arguments must either be numbers or be names, arrays, or references that contain numbers.
If an array or reference argument contains text, logical values, or empty cells, those values are ignored; however, cells with the value zero are included.
If Arg1 and Arg2 have different numbers of data points, Covar generates an error.
If either Arg1 or Arg2 is empty, Covar generates an error.
The covariance is:
Figure 1: Equation for covariance
.jpg "Equation for covariance")
where x and y are the sample means AVERAGE(array1) and AVERAGE(array2), and n is the sample size.