JavaScript/jQuery Chart - commonSeriesSettings.valueErrorBar
Error bars are used on charts to indicate an error or an uncertainty in a reported measurement. They give a general idea of how precise the measurement is.
Error bars can be generated either from concrete or calculated values. To generate one error bar, two values, high and low, are needed. If the data source of your chart provides concrete high and low values, assign the required data source fields to the highValueField and lowValueField options.
Alternatively, error bar values can be calculated according to an algorithm. In this case, choose the required algorithm using the type option, and specify the value to be used in calculation using the value option.
color
This option supports the following colors:
- Hexadecimal colors
- RGB colors
- RGBA colors
- Predefined/cross-browser color names
- Predefined SVG colors
displayMode
This option accepts the following values.
| displayMode | Result |
|---|---|
| "auto" | Displays error bars in full. |
| "low" | Displays only the lower part of each error bar. |
| "high" | Displays only the higher part of each error bar. |
| "none" | Hides error bars. |
Use the ValueErrorBarDisplayMode enum to specify this option when the widget is used as an ASP.NET MVC 5 Control or a DevExtreme-Based ASP.NET Core Control. This enum accepts the following values: Auto, Low, High, and None.
edgeLength
A value in the range from 0 to 1 specifies the length relative to the point diameter (for circular series points) or width (for bars).
Any other value specifies the length in pixels.
type
Depending on the type of errors you need to visualize, use error bars of one of the following types.
| type | Description |
|---|---|
| "percent" | Defines the confidential interval in percentages. Error bar values are calculated as a percentage of the series point value. The percentage value is determined by the value option. The high and low error bar values are drawn symmetrically up and down from the series point. |
| "stdError" | For information on the standard error, refer to the article in Wikipedia. |
| "stdDeviation" | For information on the standard deviation, refer to the article in Wikipedia. |
| "variance" | For information on variance, refer to the article in Wikipedia. |
| "fixed" | Defines the confidential interval in constant values. Error bar values are determined by the value option. The high and low error bar values are drawn symmetrically up and down from the series point. |
Use the ValueErrorBarType enum to specify this option when the widget is used as an ASP.NET MVC 5 Control or a DevExtreme-Based ASP.NET Core Control. This enum accepts the following values: Percent, StdError, StdDeviation, Variance, and Fixed.
value
Depending on the value of the type option, the value option applies as follows.
type: 'percent'
The value option specifies the percentage of the series point value to be taken.type: 'stdError'
The value option multiplies the calculated standard error.type: 'stdDeviation'
The value option multiplies the calculated standard deviation.type: 'variance'
The value option multiplies the calculated variance.type: 'fixed'
The value option specifies constant error bar values.