circle

Draws a circle for each data item. The mark for scatter plots, bubble charts, and dot-based glyphs.

from gofish import chart, scatter, circle

chart(catch_locations, axes=True).flow(scatter(by="lake", x="x", y="y")).mark(
    circle(r=5)
).render(w=500, h=300)

Signature

circle(r=None, fill=None, stroke=None, strokeWidth=None, opacity=None,
       debug=None) -> Mark

Parameters

Parameter	Type	Description
r	int | str	Radius — a constant or a field name
fill	str	Fill color — a constant or a field name
stroke	str	Stroke color
strokeWidth	int	Stroke width in pixels
opacity	float	Opacity, 0–1

Returns a Mark for use in .mark(). To attach a text label, chain .label(accessor, ...) on the returned mark rather than passing a label option here.

Examples

# Fixed-size dots
chart(data).flow(scatter(x="x", y="y")).mark(circle(r=5))

# Bubble chart — radius encodes a field
chart(data).flow(scatter(x="x", y="y")).mark(circle(r="population", fill="region"))

# Outlined dots
chart(data).flow(scatter(x="x", y="y")).mark(
    circle(r=4, fill="white", stroke="black", strokeWidth=2)
)