Dundas Chart for Windows Forms
FormulaFinancial(FinancialFormula,Series,Series) Method
See Also  Example Send comments on this topic.
DundasWinChart Assembly > Dundas.Charting.WinControl Namespace > DataManipulator Class > FormulaFinancial Method : FormulaFinancial(FinancialFormula,Series,Series) Method


formulaName
A FinancialFormula enumeration value that determines the technical analysis or time series formula to be used.
inputSeries
Series object that has the formula applied to it. The first Y-value of each data point will be used.
outputSeries
Series object that stores the formula data points. If it does not exist an exception will be thrown.

Applies a financial formula to the first Y-values of a series' data points. The specified output series stores the calculated values.

Syntax

Visual Basic (Declaration)  
Public Overloads Sub FormulaFinancial( _
   ByVal formulaName As FinancialFormula, _
   ByVal inputSeries As Series, _
   ByVal outputSeries As Series _
)
Visual Basic (Usage) Copy Code
Dim instance As DataManipulator
Dim formulaName As FinancialFormula
Dim inputSeries As Series
Dim outputSeries As Series
 
instance.FormulaFinancial(formulaName, inputSeries, outputSeries)
C#  
public void FormulaFinancial( 
   FinancialFormula formulaName,
   Series inputSeries,
   Series outputSeries
)

Parameters

formulaName
A FinancialFormula enumeration value that determines the technical analysis or time series formula to be used.
inputSeries
Series object that has the formula applied to it. The first Y-value of each data point will be used.
outputSeries
Series object that stores the formula data points. If it does not exist an exception will be thrown.

Example

This example demonstrates how to call the EaseOfMovement formula for stock data, storing output values in Series2. We will assume that there is stock data stored in Series1 (i.e. Series1 has data points with 4 Y-values: High, Low, Open and Close values), and that Series1 is a stock chart.  We also assume that Series2 has been declared as an output series.
Visual Basic Copy Code
Imports Dundas.Charting.WinControl
...

    ' The input series that the formula uses to calculate output values.
    Dim inputSeries As Series = chart1.Series("Series1")

    ' The series that stores the output values.
    Dim outputSeries As Series = chart1.Series("Series2")

    ' Call the formula.
    chart1.DataManipulator.FormulaFinancial(FinancialFormula.EaseOfMovement, inputSeries, outputSeries)

...
C# Copy Code
using Dundas.Charting.WinControl
...

   // The input series that the formula uses to calculate output values.
   Series inputSeries = chart1.Series["Series1"];
   
   // The series that stores the output values.
   Series outputSeries = chart1.Series["Series2"];
   
   // Call the formula.
   chart1.DataManipulator.FormulaFinancial(FinancialFormula.EaseOfMovement, inputSeries, outputSeries);

...

Remarks

This method applies a formula to the first Y-values of a series' data points.

This particular function definition cannot be used for those formulas that must:

  • Have multiple data point values for input/output. To use multiple values use another definition that takes a string expression for the input (inputSeriesNames) and/or output (outputSeriesNames).
  • Have a parameter argument specified (use another definition that takes a parameters argument).

Each particular formula has certain requirements, which are listed in the formula topics located in the "Formula Reference" folder.

If the specified output series has not been created and added to the SeriesCollection when this function call is made an exception will be thrown.

Note: If you are applying an averaging formula (e.g. Simple Moving Average) see the StartFromFirst property.

For an overview of how to apply a formula see the Using Financial Formulas  topic. For a detailed discussion on a particular formula see that formula's topic in the "Formula Reference" folder.

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.