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

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

Output Ports

Icon
SVG image of the histogram.

Views

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

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.