# 2D Contour

### 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

**[link] section and in the legend[link] of the chart. The trace name can be also edited directly by double-clicking the trace name in the chart legend.**

*Structure > Traces*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*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*

## 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 subchart, 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

**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 subchart, 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 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

**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 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 subchart, 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 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

**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 subchart, 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 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

**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 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 subchart, 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*## Contoursâ€‹

### Coloringâ€‹

Only available when ** Type** is set to

**.**

*Levels*fills each contour with an uniform color.*Fill*fills each contour with a color gradient.*Heatmap*shows only the borders of each contour (in color).*Lines*shows only the borders of each contour (in grayscale).*None*

### Contour Linesâ€‹

Only available when ** Type** is set to

**, or when**

*Constraint***is set to**

*Type***and**

*Levels***is set to**

*Coloring***.**

*Fill*enables lines between adjacent contours.*On*disables lines between adjacent contours.*Off*

Due to a bug, [link] this currently does not work when ** Type** is set to

**.**

*Constraint*### Contour Labelsâ€‹

enables labels on the boundary of each contour.*On*disables labels on the boundary of each contour.*Off*

### Number of Contoursâ€‹

Only available when ** Type** is set to

**.**

*Levels*automatically determines the number of contours.*Auto*reveals the menus*Custom*and*Step Size*, described below, allowing manual determination of contour number.*Min Contour*

### Step Sizeâ€‹

Only available when ** Number Of Contours** is set to

**.**

*Custom*Integer, determines in how many contours are displayed.

### Min Contourâ€‹

Only available when ** Number Of Contours** is set to

**.**

*Custom*Sets the lower bound on the displayed range of contours, combining all lower values into the min contour.

### Max Contourâ€‹

Only available when ** Number Of Contours** is set to

**.**

*Custom*Sets the upper bound on the displayed range of contours, combining all higher values into the max contour.

## Linesâ€‹

This section determines the styling of the lines between contours. Available options vary depending on the combinations chosen in the ** Contours** settings.[link]

### Widthâ€‹

Only available when ** Contour Lines** above is set to

**.**

*On*Sets the width of the contour line in (fractions of) pixels.

### Colorâ€‹

Only available when ** Contour Lines** above is set to

**.**

*On* Only available when ** Coloring** above is not set to

**.**

*Lines*Sets the color of the lines separating the contour levels. When ** Lines** in is chosen

**, the line color is determined by the used**

*Coloring***.**

*Colorscale*### Typeâ€‹

Only available when ** Contour Lines** above is set to

**.**

*On*Determines the types of continuous and striped lines.

### Smoothingâ€‹

Draws straight lines between datapoints (** Smoothing** set to 0) or fits curves between datapoints (

**set to 1.3).**

*Smoothing*## 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â€‹

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

### Orientationâ€‹

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

### Rangeâ€‹

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

## Hover/Tooltipâ€‹

### Showâ€‹

Tooltips will display values of ** X**,

**,**

*Y***and**

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

*Trace Name*### 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**,

**or**

*Left***.**

*Right*