HMPlot

Contour

Contour lines or filled bands of a grid, such as a 2-D density.

Segments. x from -2 to 8, y from -1 to 6. 3,462 segments.

Static preview; loading the interactive plot

<script>
  import { Plot, Density, Contour, Segments } from "hmplot";
  const data = { x: [1, 2, 2, 3, 3, 4, 5], y: [2, 1, 3, 2, 4, 3, 4] };
</script>

<Plot {data} height={300} axes2d>
  <Density x="x" y="y">
    <Contour field="density">
      <Segments start="start" end="end" />
    </Contour>
  </Density>
</Plot>

Options

namestring
Names the transform, so a Facet's getTransform(name) reaches its copy in every cell.
fieldcolumn
The grid table's column to contour (a Density's or an Interpolate's output, or a gridded dataset).
thresholdsnumber | number[]
The levels: a count of round values across the field's range (about that many), or the list of levels. Default: 10.
mode"lines" | "bands"
"lines" gives a row per segment (`start`, `end`, `level`) for Segments; "bands" gives the regions between levels as triangles (`lower`, `upper`, `band`) for Polygon. Default: "lines".
xstring
The grid dimension on the x axis. Default: the grid's last dimension.
ystring
The grid dimension on the y axis. Default: the grid's second-to-last dimension.

Usage

Contour draws iso-lines (mode="lines": start, end and level per segment, for Segments) or filled bands (mode="bands": triangles with lower, upper and band, for Polygon) of a grid table’s field, on the GPU. thresholds is a count of nice levels over the field’s range (default 10) or the levels themselves.

Lines match d3-contour’s marching squares. Bands clip four triangles per cell against each band, so a saddle is resolved by the cell’s mean. Missing values and hidden cells draw nothing.

Related examples

Density contours