# PivoGraph

> PivoGraph is a browser-based scientific graphing and data-analysis workspace (a local-first web application: research data stays in the browser). Projects can be saved as `.pivograph` files: plain JSON with a published specification, JSON Schema, and examples. Scripts and AI assistants can draft project files that PivoGraph validates and opens for further editing.

Key facts for agents: a `.pivograph` file is one JSON object with `"format": "pivograph-project"`, an integer `"schemaVersion"` and a `"tables"` array; every other field is optional and may be partial. Unknown keys are rejected with their JSON path. The current schema version is listed in the version catalog below; each version has an immutable JSON Schema URL, a specification page, a Markdown copy of it and example files.

## Project file format (.pivograph)

- [Format overview and AI quick start](https://pivograph.com/developers/project-format/): what the format is, versions, minimal example, editor support
- [Specification v1 (Markdown)](https://pivograph.com/developers/project-format/v1.md): normative description of every field, semantics, versioning, limits and validation
- [Specification v1 (HTML)](https://pivograph.com/developers/project-format/v1/)
- [JSON Schema v1 (draft-07)](https://pivograph.com/schemas/project/v1.json): authoritative field names, enumerations (graph variants, theme presets, analysis methods) and limits
- [Version catalog](https://pivograph.com/schemas/project/index.json): all schema versions, which one is current, and the URLs of their artifacts
- [Example: column table with t test](https://pivograph.com/schemas/project/v1/examples/minimal-column.pivograph)
- [Example: XY table with replicates and linear regression](https://pivograph.com/schemas/project/v1/examples/minimal-xy.pivograph)
- [Example: grouped table](https://pivograph.com/schemas/project/v1/examples/minimal-grouped.pivograph)
- [Example: grouped heat map](https://pivograph.com/schemas/project/v1/examples/minimal-heat-map.pivograph)
- [Example: nested table](https://pivograph.com/schemas/project/v1/examples/minimal-nested.pivograph)
- [Example: contingency table](https://pivograph.com/schemas/project/v1/examples/minimal-contingency.pivograph)
- [Example: survival table](https://pivograph.com/schemas/project/v1/examples/minimal-survival.pivograph)
- [Example: parts-of-whole table](https://pivograph.com/schemas/project/v1/examples/minimal-parts-of-whole.pivograph)
- [Example: multiple-variables table with scatter plot](https://pivograph.com/schemas/project/v1/examples/minimal-multiple-variables.pivograph)
- [Example: representative project written by PivoGraph](https://pivograph.com/schemas/project/v1/examples/representative.pivograph): every table family, analyses, annotations and style overrides

## Product

- [PivoGraph home](https://pivograph.com/): what the application does; open the editor at https://pivograph.com/app/
- [Validation](https://pivograph.com/validation/): which statistical methods are implemented and how they are verified
- [Updates](https://pivograph.com/changelog/): release notes per version
- [About](https://pivograph.com/about/): scope, data locality, contact

## Optional

- [中文首页](https://pivograph.com/zh-cn/)
- [中文：项目文件格式导览](https://pivograph.com/zh-cn/developers/project-format/)
- [Privacy](https://pivograph.com/privacy/)
- [Terms](https://pivograph.com/terms/)