React Axis Types

    The Ignite UI for React Category Chart uses only one IgrCategoryXAxis and one IgrNumericYAxis type. Similarly, Ignite UI for React Financial Chart uses only one IgrTimeXAxis and one IgrNumericYAxis types. However, the Ignite UI for React Data Chart provides support for multiple axis types that you can position on any side of the chart by setting axis location or even inside of the chart by using axis crossing properties. This topic goes over each one, which axes and series are compatible with each other, and some specific properties to the unique axes.

    Cartesian Axes

    The IgrDataChart with Cartesian Axes, allows you to plot data in horizontal (X-axis) and vertical (X-axis) direction with 3 types of X-Axis (IgrCategoryXAxis, IgrNumericXAxis, and IgrTimeXAxis) and 2 types of Y-Axis (IgrCategoryYAxis and IgrNumericYAxis).

    Category X-Axis

    The IgrCategoryXAxis treats its data as a sequence of categorical data items. It can display almost any type of data including strings and numbers. If you are plotting numbers on this axis, it is important to keep in mind that this axis is a discrete axis and not continuous. This means that each categorical data item will be placed equidistant from the one before it. The items will also be plotted in the order that they appear in the axis' data source.

    The IgrCategoryXAxis requires you to provide a DataSource and a label in order to plot data with it. It is generally used with the IgrNumericYAxis to plot the following type of series:

    Category Series Stacked Series Financial Series
    - IgrAreaSeries
    - IgrColumnSeries
    - IgrLineSeries
    - IgrPointSeries
    - IgrSplineSeries
    - IgrSplineAreaSeries
    - IgrStepLineSeries
    - IgrStepAreaSeries
    - IgrRangeAreaSeries
    - IgrRangeColumnSeries
    - IgrWaterfallSeries    		 - IgrStackedAreaSeries
    - IgrStackedColumnSeries
    - IgrStackedLineSeries
    - IgrStackedSplineSeries
    - IgrStacked100AreaSeries
    - IgrStacked100ColumnSeries
    - IgrStacked100LineSeries
    - IgrStacked100SplineSeries



    		- IgrFinancialPriceSeries
    - IgrBollingerBandsOverlay
    - IgrForceIndexIndicator
    - IgrMedianPriceIndicator
    - IgrMassIndexIndicator
    - IgrRelativeStrengthIndexIndicator
    - IgrStandardDeviationIndicator
    - IgrTypicalPriceIndicator



    The following example demonstrates usage of the IgrCategoryXAxis type:

    Category Y-Axis

    The IgrCategoryYAxis works very similarly to the IgrCategoryXAxis described above, but it is placed vertically rather than horizontally. Also, this axis requires you to provide a DataSource and a label in order to plot data with it. The IgrCategoryYAxis is generally used with the IgrNumericXAxis to plot the following type of series:

    The following example demonstrates usage of the IgrCategoryYAxis type:

    Numeric X-Axis

    The IgrNumericXAxis treats its data as continuously varying numerical data items. Labels on this axis are placed horizontally along the X-Axis. The location of the IgrNumericXAxis labels depends on the XMemberPath property of the various Scatter Series that it supports if combined with a IgrNumericYAxis. Alternatively, if combined with the IgrCategoryXAxis, these labels will be placed corresponding to the ValueMemberPath of the IgrBarSeries, IgrStackedBarSeries, and IgrStacked100BarSeries.

    The IgrNumericXAxis is compatible with the following type of series:

    The following example demonstrates usage of the IgrNumericXAxis:

    Numeric Y-Axis

    The IgrNumericYAxis treats its data as continuously varying numerical data items. Labels on this axis are placed vertically along the Y-Axis. The location of the IgrNumericYAxis labels depends on the YMemberPath property of the various ScatterSeries that is supports if combined with a IgrNumericXAxis. Alternatively, if combined with the IgrCategoryYAxis, these labels will be placed corresponding to the ValueMemberPath of the category or stacked series mentioned in the table above. If you are using one of the financial series, they will be placed corresponding to the Open/High/Low/Close paths and the series type that you are using.

    The IgrNumericYAxis is compatible with the following type of series:

    Category Series Stacked Series Financial Series Scatter Series
    - IgrAreaSeries
    - IgrColumnSeries
    - IgrLineSeries
    - IgrPointSeries
    - IgrSplineSeries
    - IgrSplineAreaSeries
    - IgrStepLineSeries
    - IgrStepAreaSeries
    - IgrRangeAreaSeries
    - IgrRangeColumnSeries
    - IgrWaterfallSeries
    		- IgrStackedAreaSeries
    - IgrStackedColumnSeries
    - IgrStackedLineSeries
    - IgrStackedSplineSeries
    - IgrStacked100AreaSeries
    - IgrStacked100ColumnSeries
    - IgrStacked100LineSeries
    - IgrStacked100SplineSeries
    		- IgrFinancialPriceSeries
    - IgrBollingerBandsOverlay
    - IgrForceIndexIndicator
    - IgrMedianPriceIndicator
    - IgrMassIndexIndicator
    - IgrRelativeStrengthIndexIndicator
    - IgrStandardDeviationIndicator
    - IgrTypicalPriceIndicator
    		- IgrBubbleSeries
    - IgrHighDensityScatterSeries
    - IgrScatterSeries
    - IgrScatterLineSeries
    - IgrScatterSplineSeries
    - IgrScatterAreaSeries
    - IgrScatterContourSeries
    - IgrScatterPolylineSeries
    - IgrScatterPolygonSeries

    The following example demonstrates usage of the IgrNumericYAxis:

    Time X Axis

    The IgrTimeXAxis treats its data as a sequence of data items, sorted by date. Labels on this axis type are dates and can be formatted and arranged according to date intervals. The date range of this axis is determined by the date values in a data column that is mapped using its DateTimeMemberPath. This, along with a DataSource is required to plot data with this axis type.

    The IgrTimeXAxis is the X-Axis type in the IgrFinancialChart component.

    Breaks in Time X Axis

    The IgrTimeXAxis has the option to exclude intervals of data by using breaks. As a result, the labels and plotted data will not appear at the excluded interval. For example, working/non-working days, holidays, and/or weekends. An instance of IgrTimeAxisBreak can be added to the Breaks collection of the axis and configured by using a unique start, end and interval.

    Formating in Time X Axis

    The IgrTimeXAxis has the labelFormats property, which represents a collection of IgrTimeAxisLabelFormat objects. Each IgrTimeAxisLabelFormat added to the collection is responsible for assigning a unique format and range. This can be especially useful for drilling down data from years to milliseconds and adjusting the labels depending on the range of time shown by the chart.

    The format property of the IgrTimeAxisLabelFormat specifies what format to use for a particular visible range. The range property of the IgrTimeAxisLabelFormat specifies the visible range at which the axis label formats will switch to a different format. For example, if you have two IgrTimeAxisLabelFormat elements with a range set to 10 days and another set to 5 hours, then as soon as the visible range of the axis becomes less than 10 days, it will switch to 5-hour format.

    Intervals in Time X Axis

    The IgrTimeXAxis replaces the conventional interval property of the category and numeric axes with an intervals collection of type IgrTimeAxisInterval. Each IgrTimeAxisInterval added to the collection is responsible for assigning a unique interval, range and intervalType. This can be especially useful for drilling down data from years to milliseconds to provide unique spacing between labels depending on the range of time shown by the chart. A description of these properties is below:

    • interval: This specifies the interval to use. This is tied to the intervalType property. For example, if the intervalType is set to Days, then the numeric value specified in interval will be in days.
    • range: This specifies the visible range at which the axis interval will switch to a different interval. For example, if you have two TimeAxisInterval with a range set to 10 days and another set to 5 hours, as soon as the visible range in the axis becomes less than 10 days it will switch to the interval whose range is 5 hours.
    • intervalType: This specifies the unit of time for the interval property.

    Polar Axes

    The IgrDataChart with Polar Axes, allows you to plot data outwards (radius axis) from center of the chart and around (angle axis) of center of the chart.

    Category Angle Axis

    The IgrCategoryAngleAxis treats its data as a sequence of category data items. The labels on this axis are placed along the edge of a circle according to their position in that sequence. This type of axis can display almost any type of data including strings and numbers.

    The IgrCategoryAngleAxis is generally used with the IgrNumericRadiusAxis to plot Radial Series.

    The following example demonstrates usage of the IgrCategoryAngleAxis type:

    Proportional Category Angle Axis

    The IgrProportionalCategoryAngleAxis treats its data as a sequence of category data items. The labels on this axis are placed along the edge of a circle according to their position in that sequence. This type of axis can display almost any type of data including strings and numbers.

    The IgrProportionalCategoryAngleAxis is generally used with the IgrNumericRadiusAxis to plot a pie chart eg. Radial Series.

    The following example demonstrates usage of the IgrProportionalCategoryAngleAxis type:

    Numeric Angle Axis

    The IgrNumericAngleAxis treats its data as continuously varying numerical data items. The labels on this axis area placed along a radius line starting from the center of the circular plot. The location of the labels on the IgrNumericAngleAxis varies according to the value in the data column mapped using the RadiusMemberPath property of the Polar Series object or the ValueMemberPath property of the Radial Series object.

    The The IgrNumericAngleAxis can be used with either the IgrCategoryAngleAxis to plot Radial Series or with the IgrNumericRadiusAxis to plot Polar Series respectively.

    The following example demonstrates usage of the IgrNumericAngleAxis type:

    Numeric Radius Axis

    The IgrNumericRadiusAxis treats the data as continuously varying numerical data items. The labels on this axis are placed around the circular plot. The location of the labels varies according to the value in a data column mapped using the AngleMemberPath property of the corresponding polar series.

    The IgrNumericRadiusAxis can be used with the IgrNumericRadiusAxis to plot Polar Series.

    The following example demonstrates usage of the IgrNumericRadiusAxis type:

    Additional Resources

    You can find more information about related chart features in these topics: