Skip to main content

2D Histogram

Name#

Sets the trace name. The trace name appears as the legend item and on hover.

In the Name text box, the name can be entered and formatted. This is automatically reflected in the Structure > Traces[link] section and in the legend[link] of the plot. The trace name can be also edited directly by double-clicking the trace name in the plot legend.

HTML tags and CSS formatting can be used to enrich text styling.

Trace Opacity#

Sets the opacity (transparency) of the trace.

Values#

Histogram Normalization#

Only available if 3 grid columns are chosen in Structure > Traces.

  • Number of Occurences The span of each bar corresponds to the number of occurrences (i.e. the number of data points inside the corresponding bin).
  • Percent The span of each bar corresponds to the percentage / fraction of occurrences with respect to the total number of data points (here, the sum of all bin HEIGHTS equals 100% / 1).
  • Probability The span of each bar corresponds to the number of occurrences in a bin divided by the size of the bin interval (here, the sum of all bin AREAS equals the total number of sample points).
  • Density
  • Probability Density The area of each bar corresponds to the probability that an event will fall into the corresponding bin (here, the sum of all bin AREAS equals 1).

Binning#

Data is grouped into bins, and each bin covers an area in the chart that reflects the number of occurences of the values falling within the bin range. For category data - the area reflects the number of categories that are binned together (always defaults to 1). For date data, use milliseconds or "M<n>" for months. If multiple non-overlaying histograms share a subplot, the first explicitly calculated bin size is used, and all others discarded.

X Bin Start#

Sets the starting value for the x axis bins.

Defaults to the lowest data value, shifted down if necessary to round values and to remove ambiguous bin edges. For example, if most of the data are integers, we shift the bin edges by 0.5 down, so a Size of 5 would have a default Start of -0.5, so it is clear that 0-4 are in the first bin and 5-9 in the second bin. Continuous data gets a bin start of 0 and bins [0,5), [5,10) etc. Dates behave similarly, and Start should be a date string. For category data, start is based on the category serial numbers, and defaults to -0.5. If multiple non-overlaying histograms share a subplot, the first explicit Start is used exactly and all others are shifted down (if necessary) to differ from that one by an integer number of bins.

X Bin End#

Sets the end value for the x axis bins.

The last bin may not end exactly at this value, we increment the bin edge by Size from Start until we reach or exceed End. Defaults to the maximum data value. Like Start, for dates use a date string, and for category data End is based on the category serial numbers.

Max X Bins#

Specifies the maximum number of desired bins. This value will be used in an algorithm that will decide the optimal bin size such that the histogram best visualizes the distribution of the data.

X Bin Size#

If multiple non-overlaying histograms share a subplot, this first encountered explicit Size is used and all others discarded. If no Size is provided,the sample data from all traces is combined to determine Size as described above.

Y Bin Start#

Sets the starting value for the y axis bins.

Defaults to the lowest data value, shifted down if necessary to round values and to remove ambiguous bin edges. For example, if most of the data are integers, we shift the bin edges by 0.5 down, so a Size of 5 would have a default Start of -0.5, so it is clear that 0-4 are in the first bin and 5-9 in the second bin. Continuous data gets a bin start of 0 and bins [0,5), [5,10) etc. Dates behave similarly, and Start should be a date string. For category data, start is based on the category serial numbers, and defaults to -0.5. If multiple non-overlaying histograms share a subplot, the first explicit Start is used exactly and all others are shifted down (if necessary) to differ from that one by an integer number of bins.

Y Bin End#

Sets the end value for the y axis bins.

The last bin may not end exactly at this value, we increment the bin edge by Size from Start until we reach or exceed End. Defaults to the maximum data value. Like Start, for dates use a date string, and for category data End is based on the category serial numbers.

Max Y Bins#

Specifies the maximum number of desired bins. This value will be used in an algorithm that will decide the optimal bin size such that the histogram best visualizes the distribution of the data.

Y Bin Size#

If multiple non-overlaying histograms share a subplot, this first encountered explicit Size is used and all others discarded. If no Size is provided,the sample data from all traces is combined to determine Size as described above.

Colorscale#

The data points can be visualized using a number of different color sets, picked from the Colorscales pulldown menu[link].

Colorscale#

Explained under Style > General.

Color Bar#

  • Show enables the color bar (shown next to the plot), which relates colors in the plot to the numeric data values.
  • Hide disables the color bar.

Orientation#

Sets the relation between the numeric data values and the chosen color scale.

  • Normal applies the colors of the Colorscale colors in their original order.
  • Reversed applies the Colorscale colors in reversed order.

Range#

  • Auto distributes colors and values linearly within range.
  • Custom allows the range to be distributed across manually-set limits.

Min#

Only available when Colorscale > Range is set to Custom.

Sets the lower end of the scale. All data values lower than this number will be mapped onto this value.

Max#

Only available when Colorscale > Range is set to Custom.

Sets the upper end of the scale. All data values higher than this number will be mapped onto this value.

Smoothing#

  • On When smoothing is turned on, extra menu items Gaps Between Cells and Heatmap are hidden and the chart colors are interpolated, creating a contiuosly changing color field.
  • Off When smoothing is turned off, extra menu items Gaps Between Cells and Heatmap are shown. The chart colors change stepswise.

Gaps Between Cells#

Only available when Colorscale > Smoothing is set to Off.

Horizontal Gap#

This setting is linked to Horizontal Gap below. Either setting can be used to change the gap between trace tiles in the horizontal direction.

Vertical Gap#

This setting is linked to Vertical Gap below. Either setting can be used to change the gap between trace tiles in the vertical direction.

Heatmap#

Only available when Colorscale > Smoothing is set to Off.

Horizontal Gaps#

This setting is linked to Horizontal Gap above. Either setting can be used to change the gap between trace tiles in the horizontal direction.

Vertical Gaps#

This setting is linked to Vertical Gap above. Either setting can be used to change the gap between trace tiles in the vertical direction.

Gaps In Data#

Interpolate Gaps#

  • On interpolates missing data points by using available adjacent data. Has the side effect of overruling the Hover On Gaps below.
  • Off shows gaps in data.

Hover/Tooltip#

Mode#

  • Values tooltips will show actual data values on hover.
  • Template tooltips will show custom-formatted values on hover. This option also enables the template formatting field.

Show#

Only available when Mode is set to Values.

Tooltips will display values of X, Y, Z and Trace Name when each of the corresponding check box is ticked.

TraceName#

Only available when Trace name is ticked in Show above or Mode is set to Template.

  • Clip To The trace name is partially shown in a side pane attached to the hover pane. Opens extra numerical data field.
  • No Clip An extra side-panel is added to the hover pane, showing the entire trace name.
  • Hide No trace name is shown in the hover info pane.
  • px Numerical field to enter the number of pixels the trace name will be clipped to, only appears when Clip To is selected.

Text Alignment#

Sets the horizontal alignment of the text content within the hover label box. Has an effect only if the hover label text spans two or more lines. Alignment of Hover/Tooltip can be set to Auto, Left or Right.