Loading
Configuring Mean
Mean is the mathematical average for a set of numbers.
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 mean icon in the legend
-
Customize the mean icon
-
Draw mean connectors
-
Connect null data
Showing/Hiding the Mean Icon
A box and whisker chart with the mean icon shown in the legend looks like this:
Given below is a brief description of the attribute used to show the mean deviation icon in the legend:
| Attribute Name | Description |
|---|---|
|
It is used to specify whether the icon representing the mean of the dataset will be shown in the legend. Setting this attribute to |
The data structure needed to show the mean 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",
"usePlotGradientColor": "",
"showValues": "0",
"showMean": "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"
},
{
"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 Mean Icon
Given below is a brief description of the attributes used to customize the mean icon:
| Attribute Name | Description |
|---|---|
|
It is used to specify the radius for the mean icon. |
|
It is used to specify the number of sides for the mean icon. |
|
It is used to specify the shape for the mean icon. This attribute can take one of the following two values: |
|
It is used to specify the hex code of the color that will be used to render the mean icon. |
|
It is used to specify the transparency of the mean icon. This attribute takes values between 0 (transparent) and 100 (opaque). |
Drawing Mean Connectors
For multiple data plots, you can draw a line to connect the mean values of each dataplot.
A box and whisker chart rendered with mean connectors looks like this:
Given below is a brief description of the attribute used to draw mean connectors:
| Attribute Name | Description |
|---|---|
|
It is used to specify whether a connector will be drawn to connect the mean for multiple sets of data. Setting this attribute to The color that is used to render the mean deviation icon is also used to render the connecting line. |
The data structure needed to draw mean connectors is given below:
{
"chart": {
"caption": "Distribution of annual salaries",
"subcaption": "By Gender",
"xAxisName": "Pay Grades",
"YAxisName": "Salaries (In USD)",
"numberPrefix": "$",
"theme": "fint",
"usePlotGradientColor": "",
"showValues": "0",
"showMean": "1",
"drawMeanConnector": "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"
},
{
"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 showMean attribute with the data object and set it to 0, the chart will not display the mean icon for that particular set of data. In this case, the missing mean deviation is considered as null data. Consequently, the mean connectors will skip this null data and draw a continuous connector.
A box and whisker chart with null data connected using mean connectors is given below:
In the above chart, a connector is drawn connecting the mean 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 mean 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 This attribute is applicable for the mean icon and all the other deviation icons. |
The data structure needed to connect null data using mean 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",
"drawMeanConnector": "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",
"showMean": "1"
},
{
"value": "7500,9000,12000,13000,14000,16500,17000, 18000, 19000, 19500",
"showMean": "0"
},
{
"value": "15000,19000,25000,32000,50000,65000",
"showMean": "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 rendering of the mean on the box and whisker chart.