WorksheetFunction.RSq Method

Returns the square of the Pearson product moment correlation coefficient through data points in known_y's and known_x's. For more information, see Pearson(Object, Object). The r-squared value can be interpreted as the proportion of the variance in y attributable to the variance in x.

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

Syntax

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

Parameters

  • Arg1
    Type: System.Object

    Known_y's - an array or range of data points.

  • Arg2
    Type: System.Object

    Known_x's - an array or range of data points.

Return Value

Type: System.Double

Remarks

Arguments can either be numbers or names, arrays, or references that contain numbers.

Logical values and text representations of numbers that you type directly into the list of arguments are counted.

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.

Arguments that are error values or text that cannot be translated into numbers cause errors.

If known_y's and known_x's are empty or have a different number of data points, RSq returns the #N/A error value.

If known_y's and known_x's contain only 1 data point, RSq returns the #DIV/0! error value.

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

Figure 1: Pearson product moment correlation coefficient

Pearson product moment correlation coefficient

where x and y are the sample means AVERAGE(known_x’s) and AVERAGE(known_y’s).

RSq returns r2, which is the square of this correlation coefficient.

See Also

Reference

WorksheetFunction Interface

WorksheetFunction Members

Microsoft.Office.Interop.Excel Namespace