---
name: chart
description: 'Generate standalone SVG vector charts (bar, line, scatter, pie) from tabular data. Tools: plot. Use when a request needs any of these; each tool''s own trigger is in SKILL.md.'
compatibility: 'Requires fragletc and Docker. Hermetic: no network access.'
metadata:
  tags: media, computation
  tools: plot.py
---

# Chart

Generate standalone SVG vector charts (bar, line, scatter, pie) from tabular data.

Every tool below is one executable file beside this `SKILL.md`, in the directory the commands below call `<skill-dir>`. Run it directly. Two host requirements: [`fragletc`](https://github.com/ofthemachine/fraglet) (`curl -fsSL https://raw.githubusercontent.com/ofthemachine/fraglet/main/install.sh | sh && fragletc version`) and Docker; the image, parameters, outputs and network reach are declared in the file itself. Before running a tool, print its contract:

```sh
<skill-dir>/plot.py --fraglet-help
```

Parameters are passed as `-p name=value` (a `file` parameter takes a host path); declared outputs are copied out with `--output <name>[=<host path>]`. A missing required parameter fails host-side with exit 2 before any container starts; otherwise the tool's own exit code is the run's. A declared output not named with `--output` is produced and discarded (a stderr note says what you could have copied). Add `--receipt run.json` (or set `FRAGLETC_RECEIPT_DIR`) to record the run: the receipt carries the tool's `procedure_hash`, image digest, parameters, and every input and output by content hash, and `receipt/attest.py` can verify it later without re-running anything.

## Tools

### `plot.py`

Generate standalone SVG vector charts (bar, line, scatter, pie) from CSV or JSON data.

Use when the user wants to visualize data, plot metrics, create a chart, or generate an SVG graph from numbers.

```sh
<skill-dir>/plot.py [-p data="<data>"] [-p data_text="<data_text>"] [-p type=bar] [-p title=] [-p x="<x>"] [-p y="<y>"] [-p width=800] [-p height=500] --output chart.svg
```

Parameters:
- `data` (file, optional) — CSV or JSON data file mounted at /input/data
- `data_text` (string, optional) — Inline CSV or JSON text (or pipe stdin)
- `type` (string, optional, default `bar`) — Chart type: bar, line, scatter, pie
- `title` (string, optional, default ``) — Chart title displayed at the top
- `x` (string, optional) — Field name or 1-indexed column for X axis / labels
- `y` (string, optional) — Field name or 1-indexed column for Y axis / values
- `width` (string, optional, default `800`) — SVG viewport width in pixels
- `height` (string, optional, default `500`) — SVG viewport height in pixels
- stdin (optional) — piped input is read in full and hashed into the run's receipt

Outputs:
- `chart.svg` — copy out with `--output chart.svg[=<host path>]`

Runs in `ofthemachine/python3@sha256:a015b4f9f0e7c1648f8fcd4164f6a296dd3c9189404f88f333a9764d08d13522`; hermetic — `network=none`; a run is a pure function of its inputs and safe to memoize.
