Box Plot

The view can be accessed either via the “Open view” action on the executed node or on KNIME Hub.
In the node configuration, you can enable certain controls, which are then available in the view. This includes the ability to choose different dimension columns and a condition column or the possibility to set a title.
The configuration also offers a preview of the view, which should help to get the box plot in the desired shape quickly.

A box plot 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 with a 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.

Since missing values as well as NaN (not a number) cannot be displayed in the view, they will be omitted.

Options

Dimension columns
Select the columns with numerical values for which you wish to plot boxes. Note: Missing and NaN (not a number) values in a dimension column will be ignored with a corresponding warning message. If all values from which a box is computed are missing or NaN, the box will be excluded from the view and a warning message will be raised.
Condition column
Select a column with respect to which a conditional box plot should be created. The values of the selected column are treated as categories. For each of these categories there is one box (indicated by color) within each of the dimensions. Note: Missing values are treated as a separate category.
Title
The title of the graph shown above the generated image. If left blank, no title will be shown.
Value axis limits
Choose if the axis range of the value axis should be calculated automatically by the charting framework, taken from the domain range or set manually. You might need to use a Domain Calculator or Edit Numeric Domain node before this node.
Value axis min
Value that sets the vertical axis minimum.
Value axis max
Value that sets the vertical axis maximum.
Dimension axis label
The label used for the horizontal dimension axis. If left blank, no label will be shown.
Value axis label
The label used for the vertical value axis. If left blank, no label will be shown.
Display legend
When checked, the chart’s legend containing the categories of the condition column is displayed.
Enable image download
When checked, an image of the chart can be downloaded by clicking the image download button in the view.
Show tooltip
When checked, hovering over a box will show information about the data.
Enable animation
When checked, the animation of the graph is active.
Generate image
If checked, adds an image output port and, upon execution, generates a PNG image which is made available via this port.
Width
The width of the generated image (in pixels).
Height
The height of the generated image (in pixels).

Input Ports

Icon
Data table containing the dimensions and conditions to be plotted in a box plot.

Output Ports

Icon
Rendered PNG image.

Views

Box Plot
A box plot visualization of the input data.

Workflows

Links

Developers

You want to see the source code for this node? Click the following button and we’ll use our super-powers to find it for you.