dotnetCHARTING Send comments on this topic.
CFrequencyTableBOL(SeriesCollection,Double[]) Method
See Also 
dotnetCHARTING Namespace > StatisticalEngine Class > CFrequencyTableBOL Method : CFrequencyTableBOL(SeriesCollection,Double[]) Method


sc
A collection of series objects. For example, to evaluate this indicator for two series you will need to pass a series collection containing this two series.
boundaries
A strictly increasing sequence of boundaries of the intervals over the real line in which the data sets point will be assigned.
Calculates the cumulative frequency table from below for a discrete data set in accordance with the open left boundary (OLB) convention.

Syntax

Visual Basic (Declaration)  
Public Overloads Shared Function CFrequencyTableBOL( _
   ByVal sc As SeriesCollection, _
   ByVal boundaries() As Double _
) As SeriesCollection
Visual Basic (Usage) Copy Code
Dim sc As SeriesCollection
Dim boundaries() As Double
Dim value As SeriesCollection
 
value = StatisticalEngine.CFrequencyTableBOL(sc, boundaries)
C#  
public static SeriesCollection CFrequencyTableBOL( 
   SeriesCollection sc,
   double[] boundaries
)

Parameters

sc
A collection of series objects. For example, to evaluate this indicator for two series you will need to pass a series collection containing this two series.
boundaries
A strictly increasing sequence of boundaries of the intervals over the real line in which the data sets point will be assigned.

Exceptions

Exception Description
ArgumentException Thrown if data set or the boundaries intervals are null.

Remarks

The value of the cumulative frequency table values at a given point is the number of elements within the data set below the highest value of that interval of the frequency table constructed in accordance with the open left boundary convention.

Example

Within this example we work through an illustration in which the cumulative frequency table from below using the open left boundary convention is evaluated.

Consider the set of boundaries { 1, 2, 3, 4, 5 }, which divide the real line into six sub-intervals. Now if we use the open left boundary convention then the real line will be divided into the sub-intervals:

(-infinity, 1], (1,2], (2,3], (3,4], (4,5], (5, infinity)

Note that, each point on the real line can be assigned to one of these sub-intervals and therefore when assigning a data point to one of these intervals there will only be one sub-interval in which it belongs.

Therefore, if we consider the data set { 0.5, 1.4, 1.3, 2.0, 2.3, 4.5, 5.5}, if the assign this data set in accordance with the above the conventions then we will have: using Open Left Boundary (OLB) convention:

  • Within the interval (-infinity, 1], we assign the data element 0.5; and hence the frequency of this interval is 1.
  • Within the interval (1, 2], we assign the data element 1.4, 1.3, 2.0; and hence the frequency of this interval (wrt OLB convention) is 3.
  • Within the interval (2, 3], we assign the data element 2.3, and hence the frequency of this interval (wrt OLB convention) is 1.
  • Within the interval (3, 4], we assign no data elements, and hence the frequency of this interval (wrt OLB convention) is 0.
  • Within the interval (4, 5], we assign the data element 4.5, and hence the frequency of this interval (wrt OLB convention) is 1.
  • Within the interval (5, infinity), we assign the data element 5.5, and hence the frequency of this interval (wrt OLB convention) is 1.

Now in follows that the associated values of the cumulative frequency table are given by:

  • Cumulative frequency table up to 1 is: 1
  • Cumulative frequency table up to 2 is: 4
  • Cumulative frequency table up to 3 is: 5
  • Cumulative frequency table up to 4 is: 5
  • Cumulative frequency table up to 5 is: 6
  • Cumulative frequency table up to 5 is: 7

Hence, for this case the series returned by this methods to represent the cumulative frequency table would be: {1, 4, 5, 5, 6, 7}.

See Also