Angular Axis Types
The Ignite UI for Angular Category Chart uses only one IgxCategoryXAxisComponent and one IgxNumericYAxisComponent type. Similarly, Ignite UI for Angular Financial Chart uses only one IgxTimeXAxisComponent and one IgxNumericYAxisComponent types. However, the Ignite UI for Angular 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 IgxDataChartComponent with Cartesian Axes, allows you to plot data in horizontal (X-axis) and vertical (X-axis) direction with 3 types of X-Axis
(IgxCategoryXAxisComponent, IgxNumericXAxisComponent, and IgxTimeXAxisComponent) and 2 types of Y-Axis (IgxCategoryYAxisComponent and IgxNumericYAxisComponent).
Category X-Axis
The IgxCategoryXAxisComponent 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 IgxCategoryXAxisComponent requires you to provide a DataSource and a label in order to plot data with it. It is generally used with the IgxNumericYAxisComponent to plot the following type of series:
The following example demonstrates usage of the IgxCategoryXAxisComponent type:
Category Y-Axis
The IgxCategoryYAxisComponent works very similarly to the IgxCategoryXAxisComponent 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 IgxCategoryYAxisComponent is generally used with the IgxNumericXAxisComponent to plot the following type of series:
The following example demonstrates usage of the IgxCategoryYAxisComponent type:
Numeric X-Axis
The IgxNumericXAxisComponent treats its data as continuously varying numerical data items. Labels on this axis are placed horizontally along the X-Axis. The location of the IgxNumericXAxisComponent labels depends on the XMemberPath property of the various Scatter Series that it supports if combined with a IgxNumericYAxisComponent. Alternatively, if combined with the IgxCategoryXAxisComponent, these labels will be placed corresponding to the ValueMemberPath of the IgxBarSeriesComponent, IgxStackedBarSeriesComponent, and IgxStacked100BarSeriesComponent.
The IgxNumericXAxisComponent is compatible with the following type of series:
IgxBarSeriesComponentIgxBubbleSeriesComponentIgxHighDensityScatterSeriesComponentIgxScatterSeriesComponentIgxScatterLineSeriesComponentIgxScatterSplineSeriesComponentIgxScatterAreaSeriesComponentIgxScatterContourSeriesComponentIgxScatterPolylineSeriesComponentIgxScatterPolygonSeriesComponentIgxStackedBarSeriesComponentIgxStacked100BarSeriesComponent
The following example demonstrates usage of the IgxNumericXAxisComponent:
Numeric Y-Axis
The IgxNumericYAxisComponent treats its data as continuously varying numerical data items. Labels on this axis are placed vertically along the Y-Axis. The location of the IgxNumericYAxisComponent labels depends on the YMemberPath property of the various ScatterSeries that is supports if combined with a IgxNumericXAxisComponent. Alternatively, if combined with the IgxCategoryYAxisComponent, 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 IgxNumericYAxisComponent is compatible with the following type of series:
The following example demonstrates usage of the IgxNumericYAxisComponent:
Time X Axis
The IgxTimeXAxisComponent 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 IgxTimeXAxisComponent is the X-Axis type in the IgxFinancialChartComponent component.
Breaks in Time X Axis
The IgxTimeXAxisComponent 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 IgxTimeAxisBreakComponent 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 IgxTimeXAxisComponent has the labelFormats property, which represents a collection of IgxTimeAxisLabelFormatComponent objects. Each IgxTimeAxisLabelFormatComponent 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 IgxTimeAxisLabelFormatComponent specifies what format to use for a particular visible range. The range property of the IgxTimeAxisLabelFormatComponent specifies the visible range at which the axis label formats will switch to a different format. For example, if you have two IgxTimeAxisLabelFormatComponent 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 IgxTimeXAxisComponent replaces the conventional interval property of the category and numeric axes with an intervals collection of type IgxTimeAxisIntervalComponent. Each IgxTimeAxisIntervalComponent 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 theintervalTypeproperty. For example, if theintervalTypeis set toDays, then the numeric value specified inintervalwill 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 theintervalproperty.
Polar Axes
The IgxDataChartComponent 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 IgxCategoryAngleAxisComponent 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 IgxCategoryAngleAxisComponent is generally used with the IgxNumericRadiusAxisComponent to plot Radial Series.
The following example demonstrates usage of the IgxCategoryAngleAxisComponent type:
Proportional Category Angle Axis
The IgxProportionalCategoryAngleAxisComponent 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 IgxProportionalCategoryAngleAxisComponent is generally used with the IgxNumericRadiusAxisComponent to plot a pie chart eg. Radial Series.
The following example demonstrates usage of the IgxProportionalCategoryAngleAxisComponent type:
Numeric Angle Axis
The IgxNumericAngleAxisComponent 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 IgxNumericAngleAxisComponent 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 IgxNumericAngleAxisComponent can be used with either the IgxCategoryAngleAxisComponent to plot Radial Series or with the IgxNumericRadiusAxisComponent to plot Polar Series respectively.
The following example demonstrates usage of the IgxNumericAngleAxisComponent type:
Numeric Radius Axis
The IgxNumericRadiusAxisComponent 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 IgxNumericRadiusAxisComponent can be used with the IgxNumericRadiusAxisComponent to plot Polar Series.
The following example demonstrates usage of the IgxNumericRadiusAxisComponent type:
Additional Resources
You can find more information about related chart features in these topics:
GitHub