.netCHARTING v10.5 Documentation


dotnetCHARTING Namespace > StatisticalEngine Class > CFrequencyTableBOL Method : CFrequencyTableBOL(SeriesCollection,Double[]) Method
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.
A strictly increasing sequence of boundaries of the intervals over the real line in which the data sets point will be assigned.
CFrequencyTableBOL(SeriesCollection,Double[]) Method
Calculates the cumulative frequency table from below for a discrete data set in accordance with the open left boundary (OLB) convention.
Syntax
'Declaration
 
Public Overloads Shared Function CFrequencyTableBOL( _
   ByVal sc As SeriesCollection, _
   ByVal boundaries() As Double _
) As SeriesCollection
'Usage
 
Dim sc As SeriesCollection
Dim boundaries() As Double
Dim value As SeriesCollection
 
value = StatisticalEngine.CFrequencyTableBOL(sc, boundaries)
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
ExceptionDescription
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}.

Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

See Also