WorksheetFunction.Pearson Method

Returns the Pearson product moment correlation coefficient, r, a dimensionless index that ranges from -1.0 to 1.0 inclusive and reflects the extent of a linear relationship between two data sets.

Namespace:  Microsoft.Office.Interop.Excel
Assembly:  Microsoft.Office.Interop.Excel (in Microsoft.Office.Interop.Excel.dll)

Syntax

'Declaration
Function Pearson ( _
    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.Pearson(Arg1, Arg2)

double Pearson(
    Object Arg1,
    Object Arg2
)

Parameters

• Arg1
  Type: System.Object

  Array1 - a set of independent values.

• Arg2
  Type: System.Object

  Array2 - a set of dependent values.

Return Value

Type: System.Double

Remarks

The arguments must be either numbers or names, array constants, 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 array1 and array2 are empty or have a different number of data points, Pearson returns the #N/A error value.

The formula for the Pearson product moment correlation coefficient, r, is:

Figure 1: Pearson product moment correlation coefficient

where x and y are the sample means AVERAGE(array1) and AVERAGE(array2).

See Also

Reference

WorksheetFunction Interface

WorksheetFunction Members

Microsoft.Office.Interop.Excel Namespace