Loading
Configuring Standard Deviation
Standard deviation is the measure of the variation or the dispersion of a set of data from the mean. It gives an idea of how spread out is the set of data from the mean.
In a box and whisker chart, along with the dataset seriesname, the legend also shows the icons for mean, mean deviation, standard deviation, quartile deviation, and the outliers of every data plot. This is a concept exclusively applicable to the box and whisker chart. Each dataset is highlighted by different colors to easily differentiate between them and their icons. The legend icons are interactive; you can click the icons to show/hide the associated values on the chart.
In this section, you will be shown how you can:
-
Show/hide the standard deviation icon in the legend
-
Show/hide the individual standard deviation values
-
Customize the standard deviation icon
-
Draw standard deviation connectors
-
Connect null data
##Showing/Hiding the Standard Deviation Icon
A box and whisker chart with the standard deviation icon shown in the legend box looks like this:
Given below is a brief description of the attribute used to show the standard deviation icon in the legend:
| Attribute Name | Description |
|---|---|
|
It is used to specify whether the icon representing the standard deviation value of the dataset will be shown in the legend. Setting this attribute to |
The data structure needed to show standard deviation icon in the legend is given below:
{
"chart": {
"caption": "Distribution of annual salaries",
"subCaption": "By Gender",
"xAxisName": "Pay Grades",
"YAxisName": "Salaries (In USD)",
"numberPrefix": "$",
"theme": "fint",
"showValues": "0",
"showSD": "1",
"SDIconSides": "5"
},
"categories": [
{
"category": [
{
"label": "Grade 1"
},
{
"label": "Grade 2"
},
{
"label": "Grade 3"
}
]
}
],
"dataset": [
{
"seriesname": "Male",
"lowerBoxColor": "#008ee4",
"upperBoxColor": "#6baa01",
"data": [
{
"value": "2400,2000,2500,2800,3500,4000, 3700, 3750, 3880, 5000,5500,7500,8000,8200, 8400, 8500, 8550, 8800, 8700, 9000, 14000"
},
{
"value": "7500,9000,12000,13000,14000,16500,17000, 18000, 19000, 19500"
},
{
"value": "15000,19000,25000,32000,50000,65000"
}
]
},
{
"seriesname": "Female",
"lowerBoxColor": "#e44a00",
"upperBoxColor": "#f8bd19",
"data": [
{
"value": "1900,2100,2300,2350,2400,2550,3000,3500,4000, 6000, 6500, 9000"
},
{
"value": "7000,8000,8300,8700,9500,11000,15000, 17000, 21000"
},
{
"value": "24000,32000,35000,37000,39000, 58000"
}
]
}
]
}Showing/Hiding Individual Standard Deviation Values
You can opt to show/hide the standard deviation for specific datasets.
A box and whisker chart with the standard deviation icon shown for a specific dataset in the legends box looks like this:
To show/hide individual quartile deviation values, use the showSD attribute with the data object, that belongs to the dataset object.
The data structure needed to show the standard deviation icon for a specific dataset is given below:
{
"chart": {
"caption": "Distribution of annual salaries",
"subCaption": "By Gender",
"xAxisName": "Pay Grades",
"YAxisName": "Salaries (In USD)",
"numberPrefix": "$",
"theme": "fint",
"showValues": "0",
"SDIconSides": "5"
},
"categories": [
{
"category": [
{
"label": "Grade 1"
},
{
"label": "Grade 2"
},
{
"label": "Grade 3"
}
]
}
],
"dataset": [
{
"seriesname": "Male",
"lowerBoxColor": "#008ee4",
"upperBoxColor": "#6baa01",
"showSD": "1",
"data": [
{
"value": "2400,2000,2500,2800,3500,4000, 3700, 3750, 3880, 5000,5500,7500,8000,8200, 8400, 8500, 8550, 8800, 8700, 9000, 14000"
},
{
"value": "7500,9000,12000,13000,14000,16500,17000, 18000, 19000, 19500"
},
{
"value": "15000,19000,25000,32000,50000,65000"
}
]
},
{
"seriesname": "Female",
"lowerBoxColor": "#e44a00",
"upperBoxColor": "#f8bd19",
"data": [
{
"value": "1900,2100,2300,2350,2400,2550,3000,3500,4000, 6000, 6500, 9000"
},
{
"value": "7000,8000,8300,8700,9500,11000,15000, 17000, 21000"
},
{
"value": "24000,32000,35000,37000,39000, 58000"
}
]
}
]
}Customizing the Standard Deviation Icon
Given below is a brief description of the attributes used to customize the standard deviation icon:
| Attribute Name | Description |
|---|---|
|
It is used to specify the number of sides for the standard deviation icon. The default value of this attribute is |
|
It is used to specify the hex code of the color that will be used to render the standard deviation icon in the legend. |
|
It is used to specify the shape for the standard deviation icon. This attribute can take one of the following two values: |
|
It is used to specify the radius, in pixels, for the standard deviation icon. |
|
It is used to specify the transparency for the standard deviation icon. This attribute takes values between 0 (transparent) and 100 (opaque). |
Drawing Standard Deviation Connectors
For multiple data plots, you can draw a line to connect the standard deviation icons of each dataplot.
A box and whisker chart rendered with a standard deviation connector looks like this:
Given below is a brief description of the attribute used to draw standard deviation connectors for the box and whisker chart:
| Attribute Name | Description |
|---|---|
|
It is used to specify whether a connector will be drawn to connect the standard deviation for multiple sets of data. Setting this attribute to The color that is used to render the standard deviation icon is also used to render the connecting line. |
The data structure needed to draw a standard deviation connector is given below:
{
"chart": {
"caption": "Distribution of annual salaries",
"subCaption": "By Gender",
"xAxisName": "Pay Grades",
"YAxisName": "Salaries (In USD)",
"numberPrefix": "$",
"theme": "fint",
"showValues": "0",
"SDIconSides": "5",
"drawSDConnector": "1"
},
"categories": [
{
"category": [
{
"label": "Grade 1"
},
{
"label": "Grade 2"
},
{
"label": "Grade 3"
}
]
}
],
"dataset": [
{
"seriesname": "Male",
"lowerBoxColor": "#008ee4",
"upperBoxColor": "#6baa01",
"showSD": "1",
"data": [
{
"value": "2400,2000,2500,2800,3500,4000, 3700, 3750, 3880, 5000,5500,7500,8000,8200, 8400, 8500, 8550, 8800, 8700, 9000, 14000"
},
{
"value": "7500,9000,12000,13000,14000,16500,17000, 18000, 19000, 19500"
},
{
"value": "15000,19000,25000,32000,50000,65000"
}
]
},
{
"seriesname": "Female",
"lowerBoxColor": "#e44a00",
"upperBoxColor": "#f8bd19",
"data": [
{
"value": "1900,2100,2300,2350,2400,2550,3000,3500,4000, 6000, 6500, 9000"
},
{
"value": "7000,8000,8300,8700,9500,11000,15000, 17000, 21000"
},
{
"value": "24000,32000,35000,37000,39000, 58000"
}
]
}
]
}Connecting Null data
If you use the showSD attribute with the data object and set it to 0, the chart will not display the standard deviation icon for that particular set of data. In this case, the missing standard deviation is considered as null data. Consequently, the standard deviation connectors will skip this null data and draw a continuous connector.
A box and whisker chart with the standard deviation null data connected looks like this:
In the above chart, a connector is drawn connecting the standard deviation icons of the first and the third data plots, skipping the second data plot.
Given below is a brief description of the attribute used to connect null data using standard deviation connectors:
| Attribute Name | Description |
|---|---|
|
It is used to specify whether the null values will be skipped and a continuous connector line will be drawn for multiple sets of data. Setting this attribute to |
The data structure needed to connect null data using standard deviation connectors is given below:
{
"chart": {
"caption": "Distribution of annual salaries",
"subCaption": "By Gender",
"xAxisName": "Pay Grades",
"YAxisName": "Salaries (In USD)",
"numberPrefix": "$",
"theme": "fint",
"showValues": "0",
"SDIconSides": "5",
"drawSDConnector": "1",
"connectNullData ": "1"
},
"categories": [
{
"category": [
{
"label": "Grade 1"
},
{
"label": "Grade 2"
},
{
"label": "Grade 3"
}
]
}
],
"dataset": [
{
"seriesname": "Male",
"lowerBoxColor": "#008ee4",
"upperBoxColor": "#6baa01",
"data": [
{
"value": "2400,2000,2500,2800,3500,4000, 3700, 3750, 3880, 5000,5500,7500,8000,8200, 8400, 8500, 8550, 8800, 8700, 9000, 14000",
"showSD": "1"
},
{
"value": "7500,9000,12000,13000,14000,16500,17000, 18000, 19000, 19500",
"showSD": "0"
},
{
"value": "15000,19000,25000,32000,50000,65000",
"showSD": "1"
}
]
},
{
"seriesname": "Female",
"lowerBoxColor": "#e44a00",
"upperBoxColor": "#f8bd19",
"data": [
{
"value": "1900,2100,2300,2350,2400,2550,3000,3500,4000, 6000, 6500, 9000"
},
{
"value": "7000,8000,8300,8700,9500,11000,15000, 17000, 21000"
},
{
"value": "24000,32000,35000,37000,39000, 58000"
}
]
}
]
}There! You have now seen how you can configure the standard deviation for the box and whisker chart.