# 2D Histogram

### #

NameSets 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

**[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.**

*Structure > Traces*HTML tags and CSS formatting can be used to enrich text styling.

### #

Trace OpacitySets the opacity (transparency) of the trace.

## #

Values### #

Histogram Normalization Only available if 3 grid columns are chosen in ** Structure** >

**.**

*Traces*The span of each bar corresponds to the number of occurrences (i.e. the number of data points inside the corresponding bin).*Number of Occurences*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).*Percent*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).*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).*Probability Density*

## #

BinningData 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 StartSets 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

**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.**

*Start*### #

X Bin EndSets 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

**until we reach or exceed**

*Start***. Defaults to the maximum data value. Like**

*End***, for dates use a date string, and for category data**

*Start***is based on the category serial numbers.**

*End*### #

Max X BinsSpecifies 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 SizeIf multiple non-overlaying histograms share a subplot, this first encountered explicit ** Size** is used and all others discarded. If no

**is provided,the sample data from all traces is combined to determine**

*Size***as described above.**

*Size*### #

Y Bin StartSets 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

**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.**

*Start*### #

Y Bin EndSets 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

**until we reach or exceed**

*Start***. Defaults to the maximum data value. Like**

*End***, for dates use a date string, and for category data**

*Start***is based on the category serial numbers.**

*End*### #

Max Y BinsSpecifies 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 SizeIf multiple non-overlaying histograms share a subplot, this first encountered explicit ** Size** is used and all others discarded. If no

**is provided,the sample data from all traces is combined to determine**

*Size***as described above.**

*Size*## #

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

### #

ColorscaleExplained under Style > General.

### #

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

### #

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

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

### #

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

#### #

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.

### #

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

## #

Gaps Between Cells Only available when ** Colorscale > Smoothing** is set to

**.**

*Off*#### #

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

#### #

Vertical GapThis 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 GapsThis setting is linked to ** Horizontal Gap** above. Either setting can be used to change the gap between trace tiles in the horizontal direction.

#### #

Vertical GapsThis 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 Gapsinterpolates missing data points by using available adjacent data. Has the side effect of overruling the*On*below.*Hover On Gaps*shows gaps in data.*Off*

## #

Hover/Tooltip### #

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

### #

Show Only available when ** Mode** is set to

**.**

*Values*Tooltips will display values of ** X**,

**,**

*Y***and**

*Z***when each of the corresponding check box is ticked.**

*Trace Name*### #

TraceName Only available when ** Trace name** is ticked in

**above or**

*Show***is set to**

*Mode***.**

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

### #

Text AlignmentSets 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**,

**or**

*Left***.**

*Right*