Reproducibility Manifests

Schema and artifact notes for graph export manifests, embedded metadata, CSV coordinates, and LaTeX figure source.

A Macro by Mark graph export manifest records the provenance of an exported figure. It is meant to travel with the figure into a paper folder, replication package, teaching deck, or internal research archive.

The current schema identifier is:

macro-by-mark/chart-export/v1

Manifest Shape

{
  "schemaVersion": "macro-by-mark/chart-export/v1",
  "attribution": {
    "author": "Mark Jayson Farol / Macro by Mark",
    "copyright": "© 2026 Mark Jayson Farol / Macro by Mark",
    "notes": [],
    "source": "Macro by Mark theoretical model solver",
    "sourceUrl": null
  },
  "generatedAt": "2026-05-05T00:00:00.000Z",
  "model": "IS-LM",
  "preset": "journal-clean",
  "scenario": "IS-LM scenario",
  "title": "IS-LM: IS-LM scenario"
}

Fields

Field	Meaning
`schemaVersion`	Stable identifier for the manifest format
`attribution.author`	Person or product credited for the export source
`attribution.copyright`	Copyright line for the export artifact
`attribution.notes`	Model slug, variant, companion graph, or other provenance notes
`attribution.source`	Runtime surface that generated the export
`attribution.sourceUrl`	Optional source route or external source URL
`generatedAt`	ISO timestamp for export generation
`model`	Model or graph family when available
`preset`	`journal-clean`, `stamped`, or `teaching-slide`
`scenario`	Scenario label when available
`title`	Human-readable export title

Artifact Carriers

Artifact	Where the manifest lives
`manifest.json`	Plain JSON in the ZIP bundle
`chart.png`	PNG `iTXt` metadata chunk named `MacroByMarkManifest`
Standalone PNG	Same PNG `iTXt` metadata chunk
`chart.svg`	SVG `<metadata>` element
Standalone SVG	Same SVG `<metadata>` element
`figure.tex`	Source comments and ZIP context

PNG metadata is embedded as text metadata. Some image editors strip metadata when saving, optimizing, or compressing images. If a PNG is edited, keep the original ZIP manifest with the final paper or deck.

Data Coordinates

The ZIP bundle includes data.csv. This file contains the plotted coordinates behind the graph export. It is not a substitute for a full model replication package, but it lets reviewers check the plotted paths without reading pixel positions from the image.

Use data.csv to verify:

Series names.
Axis coordinates.
Marker coordinates.
Plotted discontinuities, jumps, and smooth transitions.
Whether the figure shown in the paper matches the exported coordinate data.

LaTeX Source

The ZIP bundle includes figure.tex. This is the preferred source for manuscript figures because PGFPlots/TikZ stores the plotted data as vector coordinates.

Typical use:

\usepackage{pgfplots}
\pgfplotsset{compat=1.18}

Then copy the figure block from figure.tex into the manuscript or compile it as a standalone figure. Keep manifest.json with the manuscript assets.

Review Checklist

Before sending a graph to a coauthor, professor, referee, or client, confirm:

manifest.json is present when the figure came from a ZIP.
Standalone PNG exports still contain the MacroByMarkManifest chunk if they were not edited.
SVG exports include a <metadata> element.
data.csv contains the expected series and coordinates.
figure.tex compiles in the target LaTeX environment if the paper uses vector figures.
The paper cites both Macro by Mark and the underlying model or data source where needed.

Versioning

The schema is intentionally small. Future versions may add checksums, route URLs, parameter maps, and commit identifiers. A new version will use a new schema string rather than silently changing the meaning of existing fields.