GoFish Graphics
Internals

clock ​

A polar coordinate system oriented like a clock face. 0° is at 12 o'clock (top) and angles increase clockwise. Ideal for pie charts, donut charts, and radial visualizations.

python
from gofish import chart, stack, rect, clock

chart(seafood, coord=clock()) \
    .flow(stack(by="species", dir="x")) \
    .mark(rect(w="count", fill="species")) \
    .render(w=400, h=300)

Signature ​

python
clock(
    inner_radius: float | None = None,
    central_angle: float | None = None,
    start_angle: float | None = None,
    direction: int | None = None,
    center: tuple[float, float] | None = None,
) -> Coord

Parameters ​

clock() is a polar() preset and accepts the same options — inner_radius, central_angle, start_angle, direction, center — but with clock-face defaults (0° at 12 o'clock, clockwise). See polar's Parameters.

Usage ​

Pass the coordinate transform to chart via the coord keyword:

python
chart(data, coord=clock()) \
    .flow(...) \
    .mark(...) \
    .render(w=400, h=300)

coord may also be passed as a positional options dict — chart(data, {"coord": clock()}) — but the keyword form above is preferred in Python.

Coordinate Mapping ​

CartesianClock
xangle (theta), 0° at top, clockwise
yradius from center

Examples ​

python
import math

# Pie chart
chart(data, coord=clock()) \
    .flow(stack(by="category", dir="x")) \
    .mark(rect(w="value", fill="category"))

# Donut chart (hollow center via inner radius)
chart(data, coord=clock(inner_radius=0.6)) \
    .flow(stack(by="category", dir="x")) \
    .mark(rect(w="value", fill="category"))

# Rose chart (radial bar chart)
chart(data, coord=clock()) \
    .flow(stack(by="month", dir="x")) \
    .mark(rect(w=(math.pi * 2) / 12, emX=True, h="value"))

See Also ​

  • polar — Standard polar coordinates with 0° at right