Skip to main content

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

Contours#

Coloring#

Only available when Type is set to Levels.

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

Contour Lines#

Only available when Type is set to Constraint, or when Type is set to Levels and Coloring is set to Fill.

  • On enables lines between adjacent contours.
  • Off disables lines between adjacent contours.

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

Contour Labels#

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

Number of Contours#

Only available when Type is set to Levels.

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

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 Coloring, the line color is determined by the used 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 (Smoothing set to 1.3).

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.

Hover/Tooltip#

Show#

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

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.