WorksheetFunction.Pearson(Object, Object) Method

Reference

Definition

Namespace:: Microsoft.Office.Interop.Excel

Assembly:: Microsoft.Office.Interop.Excel.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

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.

public:
 double Pearson(System::Object ^ Arg1, System::Object ^ Arg2);

public double Pearson (object Arg1, object Arg2);

Public Function Pearson (Arg1 As Object, Arg2 As Object) As Double

Parameters

Arg1: Object

Array1 - a set of independent values.

Arg2: Object

Array2 - a set of dependent values.

Returns

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).

Applies to