Numeric Axis

15 Mar 202224 minutes to read

You can use numeric axis to represent numeric values of data in chart. By default, the valueType of an axis is Double.

<ejs-chart id="container" width="60%">
        <e-series-collection>
            <e-series dataSource="ViewBag.dataSource" xName="xValue" yName="yValue" name="India" type="@Syncfusion.EJ2.Charts.ChartSeriesType.Line"></e-series>
        </e-series-collection>
    </ejs-chart>
public ActionResult Index()
        {
            List<ChartData> chartData = new List<ChartData>
            {
                new ChartData { xValue = 10, yValue = 21, yValue1 = 28 },
                new ChartData { xValue = 20, yValue = 24, yValue1 = 44 },
                new ChartData { xValue = 30, yValue = 36, yValue1 = 48 },
                new ChartData { xValue = 40, yValue = 38, yValue1 = 50 },
                new ChartData { xValue = 50, yValue = 54, yValue1 = 66 },
                new ChartData { xValue = 60, yValue = 57, yValue1 = 78 },
                new ChartData { xValue = 70, yValue = 70, yValue1 = 84 },
            };
            ViewBag.dataSource = chartData;
            return View();
        }

        public class ChartData
        {
            public double xValue;
            public double yValue;
            public double yValue1;
        }

Range

Range for an axis, will be calculated automatically based on the provided data, you can also customize the range of the axis using minimummaximum and interval property of the axis.

<ejs-chart id="container" width="60%">
        <e-chart-primaryxaxis minimum="10" maximum="80" interval="5"></e-chart-primaryxaxis>
        <e-series-collection>
            <e-series dataSource="ViewBag.dataSource" xName="xValue" yName="yValue" name="India" type="@Syncfusion.EJ2.Charts.ChartSeriesType.Line"></e-series>
        </e-series-collection>
    </ejs-chart>
public ActionResult Index()
        {
            List<ChartData> chartData = new List<ChartData>
            {
                new ChartData { xValue = 10, yValue = 21, yValue1 = 28 },
                new ChartData { xValue = 20, yValue = 24, yValue1 = 44 },
                new ChartData { xValue = 30, yValue = 36, yValue1 = 48 },
                new ChartData { xValue = 40, yValue = 38, yValue1 = 50 },
                new ChartData { xValue = 50, yValue = 54, yValue1 = 66 },
                new ChartData { xValue = 60, yValue = 57, yValue1 = 78 },
                new ChartData { xValue = 70, yValue = 70, yValue1 = 84 },
            };
            ViewBag.dataSource = chartData;
            return View();
        }

        public class ChartData
        {
            public double xValue;
            public double yValue;
            public double yValue1;
        }

Range Padding

Padding can be applied to the minimum and maximum extremes of the axis range by using the rangePadding property. Numeric axis supports the following types of padding.

  • None
  • Round
  • Additional
  • Normal
  • Auto

Numeric - None

When the rangePadding is set to None, minimum and maximum of an axis is based on the data.

<ejs-chart id="container" width="60%">
        <e-chart-primaryxaxis rangePadding="None"></e-chart-primaryxaxis>
        <e-chart-primaryyaxis rangePadding="None"></e-chart-primaryyaxis>
        <e-series-collection>
            <e-series dataSource="ViewBag.dataSource" xName="xValue" yName="yValue" name="India" type="@Syncfusion.EJ2.Charts.ChartSeriesType.Line"></e-series>
        </e-series-collection>
    </ejs-chart>
public ActionResult Index()
        {
            List<ChartData> chartData = new List<ChartData>
            {
                new ChartData { xValue = 10, yValue = 21, yValue1 = 28 },
                new ChartData { xValue = 20, yValue = 24, yValue1 = 44 },
                new ChartData { xValue = 30, yValue = 36, yValue1 = 48 },
                new ChartData { xValue = 40, yValue = 38, yValue1 = 50 },
                new ChartData { xValue = 50, yValue = 54, yValue1 = 66 },
                new ChartData { xValue = 60, yValue = 57, yValue1 = 78 },
                new ChartData { xValue = 70, yValue = 70, yValue1 = 84 },
            };
            ViewBag.dataSource = chartData;
            return View();
        }

        public class ChartData
        {
            public double xValue;
            public double yValue;
            public double yValue1;
        }

Numeric - Round

When the rangePadding is set to Round, minimum and maximum will be rounded to the nearest possible value divisible by interval. For example, when the minimum is 3.5 and the interval is 1, then the minimum will be rounded to 3.

<ejs-chart id="container" width="60%">
        <e-chart-primaryyaxis rangePadding="Round"></e-chart-primaryyaxis>
        <e-series-collection>
            <e-series dataSource="ViewBag.dataSource" xName="xValue" yName="yValue" name="India" type="@Syncfusion.EJ2.Charts.ChartSeriesType.Line"></e-series>
        </e-series-collection>
    </ejs-chart>
public ActionResult Index()
        {
            List<ChartData> chartData = new List<ChartData>
            {
                new ChartData { xValue = 10, yValue = 21, yValue1 = 28 },
                new ChartData { xValue = 20, yValue = 24, yValue1 = 44 },
                new ChartData { xValue = 30, yValue = 36, yValue1 = 48 },
                new ChartData { xValue = 40, yValue = 38, yValue1 = 50 },
                new ChartData { xValue = 50, yValue = 54, yValue1 = 66 },
                new ChartData { xValue = 60, yValue = 57, yValue1 = 78 },
                new ChartData { xValue = 70, yValue = 70, yValue1 = 84 },
            };
            ViewBag.dataSource = chartData;
            return View();
        }

        public class ChartData
        {
            public double xValue;
            public double yValue;
            public double yValue1;
        }

Numeric - Additional

When the rangePadding is set to Additional, interval of an axis will be padded to the minimum and maximum of the axis.

<ejs-chart id="container" width="60%">
        <e-chart-primaryyaxis rangePadding="Additional"></e-chart-primaryyaxis>
        <e-series-collection>
            <e-series dataSource="ViewBag.dataSource" xName="xValue" yName="yValue" name="India" type="@Syncfusion.EJ2.Charts.ChartSeriesType.Line"></e-series>
        </e-series-collection>
    </ejs-chart>
public ActionResult Index()
        {
            List<ChartData> chartData = new List<ChartData>
            {
                new ChartData { xValue = 10, yValue = 21, yValue1 = 28 },
                new ChartData { xValue = 20, yValue = 24, yValue1 = 44 },
                new ChartData { xValue = 30, yValue = 36, yValue1 = 48 },
                new ChartData { xValue = 40, yValue = 38, yValue1 = 50 },
                new ChartData { xValue = 50, yValue = 54, yValue1 = 66 },
                new ChartData { xValue = 60, yValue = 57, yValue1 = 78 },
                new ChartData { xValue = 70, yValue = 70, yValue1 = 84 },
            };
            ViewBag.dataSource = chartData;
            return View();
        }

        public class ChartData
        {
            public double xValue;
            public double yValue;
            public double yValue1;
        }

Numeric - Normal

When the rangePadding is set to Normal, padding is applied to the axis based on default range calculation.

<ejs-chart id="container" width="60%">
        <e-chart-primaryyaxis rangePadding="Normal"></e-chart-primaryyaxis>
        <e-series-collection>
            <e-series dataSource="ViewBag.dataSource" xName="xValue" yName="yValue" name="India" type="@Syncfusion.EJ2.Charts.ChartSeriesType.Line"></e-series>
        </e-series-collection>
    </ejs-chart>
public ActionResult Index()
        {
            List<ChartData> chartData = new List<ChartData>
            {
                new ChartData { xValue = 10, yValue = 21, yValue1 = 28 },
                new ChartData { xValue = 20, yValue = 24, yValue1 = 44 },
                new ChartData { xValue = 30, yValue = 36, yValue1 = 48 },
                new ChartData { xValue = 40, yValue = 38, yValue1 = 50 },
                new ChartData { xValue = 50, yValue = 54, yValue1 = 66 },
                new ChartData { xValue = 60, yValue = 57, yValue1 = 78 },
                new ChartData { xValue = 70, yValue = 70, yValue1 = 84 },
            };
            ViewBag.dataSource = chartData;
            return View();
        }

        public class ChartData
        {
            public double xValue;
            public double yValue;
            public double yValue1;
        }

Numeric - Auto

When the rangePadding is set to Auto, horizontal numeric axis takes None as padding calculation, while the vertical numeric axis takes Normal as padding calculation.

<ejs-chart id="container" width="60%">
        <e-chart-primaryyaxis rangePadding="Auto"></e-chart-primaryyaxis>
        <e-series-collection>
            <e-series dataSource="ViewBag.dataSource" xName="xValue" yName="yValue" name="India" type="@Syncfusion.EJ2.Charts.ChartSeriesType.Line"></e-series>
        </e-series-collection>
    </ejs-chart>
public ActionResult Index()
        {
            List<ChartData> chartData = new List<ChartData>
            {
                new ChartData { xValue = 10, yValue = 21, yValue1 = 28 },
                new ChartData { xValue = 20, yValue = 24, yValue1 = 44 },
                new ChartData { xValue = 30, yValue = 36, yValue1 = 48 },
                new ChartData { xValue = 40, yValue = 38, yValue1 = 50 },
                new ChartData { xValue = 50, yValue = 54, yValue1 = 66 },
                new ChartData { xValue = 60, yValue = 57, yValue1 = 78 },
                new ChartData { xValue = 70, yValue = 70, yValue1 = 84 },
            };
            ViewBag.dataSource = chartData;
            return View();
        }

        public class ChartData
        {
            public double xValue;
            public double yValue;
            public double yValue1;
        }

Label Format

Numeric Label Format

Numeric labels can be formatted by using the labelFormat property. Numeric labels supports all globalize format.

<ejs-chart id="container" width="60%">
        <e-chart-primaryyaxis labelFormat="c"></e-chart-primaryyaxis>
        <e-series-collection>
            <e-series dataSource="ViewBag.dataSource" xName="xValue" yName="yValue" name="India" type="@Syncfusion.EJ2.Charts.ChartSeriesType.Line"></e-series>
        </e-series-collection>
    </ejs-chart>
public ActionResult Index()
        {
            List<ChartData> chartData = new List<ChartData>
            {
                new ChartData { xValue = 10, yValue = 21, yValue1 = 28 },
                new ChartData { xValue = 20, yValue = 24, yValue1 = 44 },
                new ChartData { xValue = 30, yValue = 36, yValue1 = 48 },
                new ChartData { xValue = 40, yValue = 38, yValue1 = 50 },
                new ChartData { xValue = 50, yValue = 54, yValue1 = 66 },
                new ChartData { xValue = 60, yValue = 57, yValue1 = 78 },
                new ChartData { xValue = 70, yValue = 70, yValue1 = 84 },
            };
            ViewBag.dataSource = chartData;
            return View();
        }

        public class ChartData
        {
            public double xValue;
            public double yValue;
            public double yValue1;
        }

The following table describes the result of applying some commonly used label formats on numeric values.

Label Value Label Format property value Result Description
1000 n1 1000.0 The Number is rounded to 1 decimal place
1000 n2 1000.00 The Number is rounded to 2 decimal places
1000 n3 1000.000 The Number is rounded to 3 decimal places
0.01 p1 1.0% The Number is converted to percentage with 1 decimal place
0.01 p2 1.00% The Number is converted to percentage with 2 decimal places
0.01 p3 1.000% The Number is converted to percentage with 3 decimal places
1000 c1 $1000.0 The Currency symbol is appended to number and number is rounded to 1 decimal place
1000 c2 $1000.00 The Currency symbol is appended to number and number is rounded to 2 decimal places

GroupingSeparator

To separate groups of thousands, use useGroupingSeparator property in chart.

<ejs-chart id="lineContainer" title="Sales Comparison" useGroupingSeparator="true">
        <e-series-collection>
            <e-series dataSource="ViewBag.dataSource"  name="Germany" xName="x" width="2" opacity="1" yName="y" type="@Syncfusion.EJ2.Charts.ChartSeriesType.Column"></e-series>
        </e-series-collection>
    </ejs-chart>
public ActionResult Index()
        {
            List<ColumnChartData> chartData = new List<ColumnChartData>
            {
                new ColumnChartData{ x= "USA", y=50  },
                new ColumnChartData{ x="China", y=40 },
                new ColumnChartData{ x= "Japan", y=70 },
                new ColumnChartData{ x= "Australia", y=60},
                new ColumnChartData{ x= "France", y=50 },
                new ColumnChartData{ x= "Germany", y=40 },
                new ColumnChartData{ x= "Italy", y=40 },
                new ColumnChartData{ x= "Sweden", y=30 }
            };
            ViewBag.dataSource = chartData;
            return View();
        }

        public class ColumnChartData
        {
            public string x;
            public double y;
        }

Custom Label Format

Axis also supports custom label format using placeholder like {value}°C, in which the value represents the axis label e.g 20°C.

<ejs-chart id="container" width="60%">
        <e-chart-primaryyaxis labelFormat="${value}K"></e-chart-primaryyaxis>
        <e-series-collection>
            <e-series dataSource="ViewBag.dataSource" xName="xValue" yName="yValue" name="India" type="@Syncfusion.EJ2.Charts.ChartSeriesType.Line"></e-series>
        </e-series-collection>
    </ejs-chart>
public ActionResult Index()
        {
            List<ChartData> chartData = new List<ChartData>
            {
                new ChartData { xValue = 10, yValue = 21, yValue1 = 28 },
                new ChartData { xValue = 20, yValue = 24, yValue1 = 44 },
                new ChartData { xValue = 30, yValue = 36, yValue1 = 48 },
                new ChartData { xValue = 40, yValue = 38, yValue1 = 50 },
                new ChartData { xValue = 50, yValue = 54, yValue1 = 66 },
                new ChartData { xValue = 60, yValue = 57, yValue1 = 78 },
                new ChartData { xValue = 70, yValue = 70, yValue1 = 84 },
            };
            ViewBag.dataSource = chartData;
            return View();
        }

        public class ChartData
        {
            public double xValue;
            public double yValue;
            public double yValue1;
        }