Conditional Box Plot (JavaScript)

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

The conditional box plot partitions the data of a numeric column into classes according to another nominal column and creates a box plot for each of the classes.

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 the first value in 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 data points 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 data points 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

Category Column: Select the column that contains the category values.
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.
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 and enable 'Missing values' class. If not checked, missing values will be ignored without raising a warning. 'Missing values' class will not be present.
Include 'Missing values' class: If checked, missing values in the category column will form a separate class named "Missing values". Otherwise they will be ignored.
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.
Apply colors by category: Check to apply a color scheme to the boxes by category. The colors can be defined as a table with a single column which contains the category names and color settings applied accordingly.
If the table with desired color scheme is not provided, a standard color scheme will be used.
Box color: The filling color of the boxes. Not available if the previous option is checked.
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.
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.
Enable switching 'Missing values' class: Check to enable to show and hide 'Missing values' class in the view.

Input Ports

: Data table containing the categories and values to be plotted in a box plot.
: Data table containing the category names with colors applied.

Output Ports

: SVG image of the box plot.

Popular Predecessors

Popular Successors

Views

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

Workflows

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.

Installation

To use this node in KNIME, install the extension KNIME JavaScript Views from the below update site following our NodePit Product and Node Installation Guide:

v5.3

A zipped version of the software site can be downloaded here.

Plugin provider: KNIME AG, Zurich, Switzerland

Plugin version: 5.3.0.v202312081534

On NodePit since: 2024-07-09

Last update: 2024-11-15

KNIME versions: v5.3, v5.2, v5.1, v5.0, v3.7, v3.6

Deploy, schedule, execute, and monitor your KNIME workflows locally, in the cloud or on-premises – with our brand new NodePit Runner.

Try NodePit Runner!