# Box Plot

A box plot displays robust statistical parameters: minimum, lower quartile, median, upper quartile, and maximum. These parameters called robust, since they are not sensitive to extreme outliers.

A box plot for one numerical attribute is constructed in the following way: The box itself goes from the lower quartile (Q1) to the upper quartile (Q3). The median is drawn as a horizontal bar inside the box. The distance between Q1 and Q3 is called the interquartile range (IQR). Above and below the box are the so-called whiskers. They are drawn at the minimum and the maximum value as horizontal bars and are connected with the box by a dotted line. The whiskers never exceed 1.5 * IQR. This means if there are some data points which exceed either Q1 - (1.5 * IQR) or Q3 + (1.5 * IQR) than the whiskers are drawn at exactly these ranges and the data points are drawn separately as outliers. For the outliers the distinction between mild and extreme outliers is made. As mild outliers are those datapoints p considered for which holds: p < Q1 - (1.5 * IQR) AND p > Q1 - (3 * IQR) or p > Q3 + (1.5 * IQR) AND p < Q3 + (3 * IQR). In other words mild outliers are those data points which lay between 1.5 * IRQ and 3 * IRQ. Extreme outliers are those datapoints p for which holds: p < Q1 - (3 * IQR) or p > Q3 + (3 * IQR). Thus, three times the box width (IQR) marks the boundary between "mild" and "extreme" outliers. Mild outliers are painted as dots, while extreme outliers are displayed as crosses. In order to identify the outliers they can be selected and hilited. This provides a quick overview over extreme characteristics of a dataset.

The node supports custom CSS styling. You can simply put CSS rules into a single string and set it as a flow variable 'customCSS' in the node configuration dialog. You will find the list of available classes and their description on our documentation page.

## Options

Included columns
Select the columns for which you wish to plot boxes. Missing values in data columns will be ignored with a corresponding warning messages.
Plot multiple boxes
Check to plot boxes for each of the selected column. If not checked, the plot contains a dropdown selector for choosing the column to plot.
Selected column
Select the column that contains the numeric values.
Report on missing values
Check to get the detailed warning messages in the view about missing values. If not checked, missing values will be ignored without raising a warning.
Fail on special doubles
If checked the option will let the execution of the node fail, when it encounters a special double in the input data. This can either be NaN, negative or positive infinity values. When unchecked special doubles are treated the same as missing values and be reported together if Report on missing values is set.

#### General Plot Options

Title (*)
The chart title.
Subtitle (*)
The chart subtitle.
Display fullscreen button
Check to display a button which switches the view into fullscreen mode. The button is only available in the KNIME WebPortal.
Image
Settings for image generation.
Background color
The color of the background.
Data area color
The background color of the data area, within the axes.
Box color
The filling color of the box.
Show warnings in view
If checked, warning messages will be displayed in the view when they occur.

#### Control Options

Enable view controls
Check to enable controls in the chart.
Enable column selection
Check to enable the selection of the numeric column to show the box plot for. Note that this only has an effect if the 'Plot multiple boxes' option is not checked.
Enable Title editing
Check to enable the editing of the title within the view.
Enable Subtitle editing
Check to enable the editing of the subtitle within the view.

## Input Ports

Data table containing the categories and values to be plotted in a box plot.

## Output Ports

SVG image of the box plot.

## Views

Interactive View: Box Plot
A JavaScript implementation of a Box Plot.