Dundas Chart for Windows Forms
Covariance Method
See Also  Example Send comments on this topic.
DundasWinChart Assembly > Dundas.Charting.WinControl Namespace > Statistics Class : Covariance Method


firstInputSeriesName
The name of the series that stores the first group of data. Data must be stored in the first Y-values of the series' data points.
First Input Series Name
secondInputSeriesName
The name of the series  that stores the second group of data. Data must be stored in the first Y-values of the series' data points. An exception will be raised if both series do not have the same number of data points.
Second Input Series Name

Enterprise Edition Only Feature. This method gets the covariance value for two series of data.


This analysis tool and its formula return the average of the product of deviations of data points from their respective means. Covariance is a measure of the relationship between two ranges of data. You can use the Covariance tool to determine whether two ranges of data move together — that is, whether large values of one set are associated with large values of the other (positive covariance), whether small values of one set are associated with large values of the other (negative covariance), or whether values in both sets are unrelated (covariance near zero).

Syntax

Visual Basic (Declaration)  
Public Function Covariance( _
   ByVal firstInputSeriesName As String, _
   ByVal secondInputSeriesName As String _
) As Double
Visual Basic (Usage) Copy Code
Dim instance As Statistics
Dim firstInputSeriesName As String
Dim secondInputSeriesName As String
Dim value As Double
 
value = instance.Covariance(firstInputSeriesName, secondInputSeriesName)
C#  
public double Covariance( 
   string firstInputSeriesName,
   string secondInputSeriesName
)

Parameters

firstInputSeriesName
The name of the series that stores the first group of data. Data must be stored in the first Y-values of the series' data points.
First Input Series Name
secondInputSeriesName
The name of the series  that stores the second group of data. Data must be stored in the first Y-values of the series' data points. An exception will be raised if both series do not have the same number of data points.
Second Input Series Name

Return Value

Returns Covariance

Example

The following sample gets the covariance between two groups of data (Series1 and Series2) and returns the covariance between the two groups as a double.
Visual Basic Copy Code
Imports Dundas.Charting.WinControl
...

' Get covariance
Dim result As double = Chart1.DataManipulator.Statistics.Covariance("Series1", "Series2")
C# Copy Code
using Dundas.Charting.WinControl;
...

// Get covariance
double result = Chart1.DataManipulator.Statistics.Covariance("Series1", "Series2");

Remarks

This method returns the average of the product of deviations of the data points from their respective means.

Covariance is a measure of the relationship between two ranges of data, and can be used to determine whether two ranges of data move together - that is, whether large values of one set are associated with large values of the other (positive covariance), whether small values of one set are associated with large values of the other (negative covariance), or whether values in both sets are unrelated (covariance near zero).

If a specified input series does not exist in the series collection at the time of the method call than an exception will be thrown. An exception will also be raised if the series do not have the same number of data points.

Requirements

Target Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family, Windows Vista, Windows Server 2008 family

See Also

© 2009 All Rights Reserved.