Kagi Chart
The Kagi chart type displays a series of connecting vertical lines where the thickness and direction of the lines are dependent on the action of the price value. This chart ignores the passage of time, and is used to mark out changes in data trends, such as the trend of the stock market. This is similar to the Point and Figure, Renko, and Three Line Break chart types.
Chart Characteristics
SeriesChartType value |
SeriesChartType.Kagi |
Number of Y values per point |
1 |
Number of series |
1 |
Supports markers |
Yes |
Cannot be combined with: |
Any other chart type. |
Custom attributes |
PixelPointDepth, PixelPointGapDepth, PriceUpColor, ReversalAmount, UsedYValue |
Remarks
Note the following when working with the Kagi chart type:
The X values of data points are automatically indexed. For more information, see Indexing Data Point X Value.
The number of data points and the X-Y values that the chart displays is different from the original data. This is because a formula is applied to the original data before plotting.
It is recommended that you do not set the minimum or maximum values for the X axis, since you cannot determine how many data points are plotted after the formula is applied.
Note
If you do set the minimum or maximum value for the X axis, then you should also set the Maximum or Minimum properties to data point index values.
This chart type does not support data point anchoring and annotations.
This chart uses the color scheme rather than the thickness scheme. You can select the up-trend color using the PriceUpColor custom attribute. The down-trend color is red.
Selecting Y Values in a Series
If you have a data series with multiple Y values per data point, use the UsedYValue custom attribute to select the index of the Y value to use. By default, the Kagi chart uses the first value in DataPoint.YValues, which is found at index 0.
The following code selects the fourth Y value (index of 3) in the data points to plot on the Kagi chart.
Chart1.Series("Series1")("UsedYVale")="3"
Chart1.Series["Series1"]["UsedYValue"]="3";
Setting the Reversal Amount
To set the reversal amount in the Kagi chart, use the ReversalAmount custom attribute. You can specify a numeral to signify a fixed value, or attach a '%' to the numeral to signify a percentage.
The following code defines a reversal amount of 0.6. This causes the Kagi chart to change directions when the data trend reversal exceeds the value 0.6.
Chart1.Series("Series1")("ReversalAmount")="0.6"
Chart1.Series["Series1"]["ReversalAmount"]="0.6";