Charts

Add line, bar, pie and scatter charts to a Python trace with the recount.chart builder.

The recount.chart() builder constructs a single ChartData dict. Call .build() to get a value ready to pass directly as span input or output.

Basic usage

recount.add_span("chart", "Monthly revenue", {
    "output": recount.chart("line", "Monthly Revenue")
        .labels(["Jan", "Feb", "Mar", "Apr"])
        .series("Revenue", [12000, 15400, 11200, 18900])
        .build(),
})

`recount.chart(chart_type, title=None)`

Returns a ChartBuilder. Chain methods and call .build() to get a ChartData dict, ready to use as span input or output.

Chart types

Type	Description
`'line'`	Line chart
`'bar'`	Bar chart
`'pie'`	Pie / donut chart
`'scatter'`	Scatter plot

Methods

`.labels(labels)`

Set the category labels (x-axis for line/bar, slice names for pie).

.labels(["Q1", "Q2", "Q3", "Q4"])

`.series(name_or_data, data=None)`

Add a data series. Call multiple times for multi-series charts.

.series("Revenue", [1200, 1500, 900, 2100])
.series("Cost",    [800,  900,  700, 1100])

Omit the name for single-series charts by passing the data alone:

.series([1200, 1500, 900, 2100])

`.from_records(data, label_key, series_keys)`

Build labels and series from a list of dicts.

.from_records(rows, "month", ["revenue", "cost"])

`.reference_line(value, label=None)`

Add a horizontal reference line (e.g. a target or threshold).

.reference_line(10000, "Target")

Multiple charts

To display multiple charts together, use a group span. Each chart is its own span inside the group:

def build_group(g):
    g.span("chart", "Claims by Month", {
        "output": recount.chart("line", "Claims by Month")
            .labels(["Jan", "Feb", "Mar", "Apr", "May", "Jun"])
            .series("Submitted", [142, 158, 134, 171, 163, 189])
            .series("Approved", [118, 131, 109, 144, 140, 162])
            .build(),
    })

    g.span("chart", "By Category", {
        "output": recount.chart("bar", "By Category")
            .labels(["Vehicle", "Property", "Medical", "Liability"])
            .series("Count", [312, 187, 94, 56])
            .build(),
    })


recount.add_group("Claims dashboard", build_group)

Bar chart from records

rows = [
    {"plan": "Starter", "users": 412},
    {"plan": "Pro", "users": 1839},
    {"plan": "Enterprise", "users": 264},
]

recount.add_span("chart", "Plan distribution", {
    "output": recount.chart("bar", "Users by Plan")
        .from_records(rows, "plan", ["users"])
        .build(),
})

Shorthand export

For simple cases where you don't need to chain builder methods:

`recount.chart_from_records(chart_type, data, label_key, series_keys, title=None)`

Equivalent to recount.chart(chart_type, title).from_records(data, label_key, series_keys).build(). Returns ChartData directly.

rows = [
    {"month": "Jan", "revenue": 12000},
    {"month": "Feb", "revenue": 15400},
    {"month": "Mar", "revenue": 11200},
]

recount.add_span("chart", "revenue", {
    "output": recount.chart_from_records(
        "line", rows, "month", ["revenue"], title="Monthly Revenue"
    ),
})

On this page