charted AGENTS.md

AGENTS.md: Charted (Python SVG Chart Library)

Quick API Reference

import charted
from charted import (
    BarChart, ColumnChart, LineChart, ScatterChart,
    PieChart, RadarChart, AreaChart, BoxPlot, Histogram,
    HeatmapChart, GanttChart,
)

# Bar (horizontal)
BarChart(data=[10, 20, 30], labels=["A", "B", "C"], title="Sales")

# Column (vertical)
ColumnChart(data=[10, 20, 30], labels=["A", "B", "C"])

# Line
LineChart(data=[[10, 20, 30]], labels=["Jan", "Feb", "Mar"])

# Scatter (note: uses x_data/y_data, NOT data=)
ScatterChart(x_data=[1, 2, 3], y_data=[10, 20, 30])

# Pie
PieChart(data=[35, 28, 18], labels=["A", "B", "C"])

# Radar
RadarChart(data=[85, 90, 75, 88, 92], labels=["Spd", "Str", "Def", "Tech", "Sta"])

# Area
AreaChart(data=[10, 20, 15, 25], labels=["Q1", "Q2", "Q3", "Q4"])

# Box Plot: each item in data is a raw distribution list
BoxPlot(data=[[1,2,3,4,5,6,7], [2,4,6,8,10]], labels=["A", "B"])

# Histogram: single flat list, bins param
Histogram(data=[1.2, 2.3, 2.5, 3.1, 4.0], bins=5)

# Heatmap: 2D matrix
HeatmapChart(data=[[1,2,3],[4,5,6],[7,8,9]], labels=["R1","R2","R3"])

# Gantt
GanttChart(tasks=[{"name": "Task 1", "start": 0, "end": 5}])

Common Patterns

Single series

chart = BarChart(data=[120, 180, 210], labels=["Q1", "Q2", "Q3"], title="Revenue")
chart.save("chart.svg")

Multi-series

chart = ColumnChart(
    data=[[12, 22, 30], [-8, -15, -20]],
    labels=["Q1", "Q2", "Q3"],
    series_names=["Revenue", "Costs"],
)

Stacked vs side-by-side

# Column: stacked by default (y_stacked=True). Disable:
ColumnChart(data=[[1,2],[3,4]], labels=["A","B"], y_stacked=False)

# Bar: side-by-side by default. Stack with:
BarChart(data=[[1,2],[3,4]], labels=["A","B"], x_stacked=True)

Dark theme

chart = BarChart(data=[1,2,3], labels=["A","B","C"], theme="dark")

Custom dimensions

chart = LineChart(data=[[1,2,3]], labels=["A","B","C"], width=800, height=400)