Skip to content
Internals

area

Fills the region between a baseline and a set of data points. Like line, an area traces a layout produced by another chart, selected with select().

python
from gofish import Layer, chart, spread, blank, select, area

Layer([
    chart(lake_totals)
        .flow(spread(by="lake", dir="x", spacing=64))
        .mark(blank(h="count").name("points")),
    chart(select("points")).mark(area(opacity=0.8)),
]).render(w=500, h=300, axes=True)

Signature

python
area(stroke=None, strokeWidth=None, opacity=None, mixBlendMode=None,
     dir=None, interpolation=None) -> Mark

Parameters

ParameterTypeDescription
strokestrOutline color
strokeWidthintOutline width in pixels
opacityfloatOpacity, 01
mixBlendModestrCSS blend mode for overlapping areas
dirstrDirection the area fills toward
interpolationstrCurve interpolation, e.g. "linear", "monotone"

Returns a Mark for use in .mark().

The area pattern

Areas use the same two-chart recipe as line: one chart positions named blank marks, a second selects them and draws the area(). select(name) reads a named layer from an earlier chart, and Layer([chartA, chartB]) composes multiple charts into one figure.

Stack several areas in one Layer — with opacity or mixBlendMode — for layered and stacked area charts.

Examples

python
# Semi-transparent area
chart(select("points")).mark(area(opacity=0.8))