Histogram

A histogram based on the NVD3 library.

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

Histogram Column: Select the column that contains the values used to calculate the bins for the histogram.
Aggregation Method: Select the aggregation method used on the selected frequency columns. In case of Occurrence Count the occurrence of the unique values of the selected category columns are determined.
Frequency columns: Select the columns with frequencies for which you wish to plot bars. Note: Missing values in the frequency column will be ignored with a corresponding warning message.
If, after aggregation, some bars or entire categories contain only missing values, they will be excluded from the view and a warning message will be raised.
Process in memory: Process the table in the memory. Requires more memory but is faster since the table needs not to be sorted prior aggregation. The memory consumption depends on the number of unique groups and the chosen aggregation method.
Report on missing values: Check to get the detailed warning messages in the view about missing values and enable 'Missing values' category.
If not checked, missing values will be ignored without raising a warning. 'Missing values' category will not be present.
Include 'Missing values' category: If checked, missing values in the category column will form a separate class named "Missing values". Otherwise they will be ignored.

Binning

Binning method

Use Fixed number of bins for bins with equal width over the domain range or bins that have an equal frequency of element occurrences.
Use Sample quantiles to produces bins corresponding to the given list of probabilities. The smallest element corresponds to a probability of 0 and the largest to probability of 1. The applied estimation method is Type 7 which is the default method in R, S and Excel.

Number of bins

Number of bins for the fixed number binning method.

Bin to equal

Choose bins of equal width or equal frequency for the fixed number binning method.

Quantiles

Provide a comma separated list of quantiles for the sample quantiles binning method.

Bin Naming

Use Numbered for bins labeled by an integer with prefix "Bin", Borders for labels using '"(a,b]"' interval notation or Midpoints for labels that show the midpoint of the interval.

Force integer bounds

Forces the bounds of the interval to be integers. The decimal bounds will be converted so that the lower bound of the first interval will be the floor of the lowest value and the upper bound of the last interval will be the ceiling of the highest value. The edges that separate the intervals will be the ceiling of the decimal edges. Duplicates of edges will be removed.

Examples:
[0.1,0.9], (0.9,1.8] -> [0,1], (1,2]
[3.9,4.1], (4.1,4.9], (4.9,5.1] -> [3,5], (5,6]

Number format settings

If advanced formatting is enabled the format of the doubles in the labels can be configured by the options in this tab.

Output format

Specify the output format.
The number 0.00000035239 will be displayed as 3.52E-7 with Standard String, 0.000000352 with Plain String (no exponent) and 352E-9 with Engineering String.

Precision

The scale of the double values to round to. If the scale is reduced the specified rounding mode is applied.

Precision mode

The type of precision to which the values are rounded. Decimal places, the default option rounds to the specified decimal places, whereas significant figures rounds to significant figures or numbers.

Rounding mode

The rounding mode which is applied when double values are rounded.
The rounding mode specifies the rounding behavior. Seven different rounding modes are available:

UP: Rounding mode to round away from zero.
DOWN: Rounding mode to round towards zero.
CEILING: Rounding mode to round towards positive infinity.
FLOOR: Rounding mode to round towards negative infinity.
HALF_UP: Rounding mode to round towards "nearest neighbor" unless both neighbors are equidistant, in which case round up.
HALF_DOWN: Rounding mode to round towards "nearest neighbor" unless both neighbors are equidistant, in which case round down.
HALF_EVEN: Rounding mode to round towards the "nearest neighbor" unless both neighbors are equidistant, in which case, round towards the even neighbor.

For a detailed description of each rounding mode please see the Java documentation.

General Plot Options

Title (*): The chart title.
Subtitle (*): The chart subtitle.
Category-axis label (*): The label used for the category axis.
Frequency-axis label (*): The label used for the frequency axis.
Chart type: Select how to display the histogram columns. In Grouped chart one bar indicates a separate value from a column, while in Stacked chart a bar is a stack of all values in a column.
Display legend: When checked, the histogram legend is displayed.
Display rich tooltips: When checked, a rich tooltip is displayed when hovering over the individual bars of the histogram.
Plot horizontal bar chart: Check to plot the histogram horizontally. By default the histogram is plotted with vertical bars.
Display fullscreen button: Check to display a button which switches the view into fullscreen mode. The button is only available in the KNIME WebPortal.
Show maximum value: Check if the maximum of the Y-Axis should be displayed.
Image: Settings for SVG image generation.
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 Grouped/Stacked Chooser: Check to enable the display a control to choose grouped or stacked display of the bars.
Enable plot orientation change: Check to enable interactive toggling between a horizontal or vertical histogram.
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 Axis title editing: Check to enable the editing of the axis titles within the view.
Enable switching 'Missing values' category: Check to enable to show and hide 'Missing values' category in the view.
Enable showing maximum value on y-axis: Check to enable to show and hide maximum value on the y-axis.

Interactivity

The JavaScript histogram view allows for several ways of interactivity. Please use the options below to configure which features will be activated on the view and further configuration of interactive properties.

Enable selection: If checked a separate column containing checkboxes is rendered in the view.
Subscribe to selection events: If checked, the view reacts on notifications from other interactive views that the selection has been changed. See also "Publish selection events".
Publish selection events: If checked, notifies other interactive views when user changes the selection in the current view. See also "Subscribe to selection events".
Display clear selection button: Displays a button to clear current selection.

Input Ports

: Data table containing the values to be plotted in a histogram.

Output Ports

: SVG image of the histogram.

Popular Predecessors

Popular Successors

Views

Interactive View: Histogram View: A histogram based on the NVD3 library.

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.