Project model

The browser workbench, Python package, R package, and embed driver use the .gph format. It contains the graph and the workspace state needed to continue working with it.

What a project contains

Part	Contains
info	Version and optional project metadata.
datasets	One or more graph datasets in node-link form.
config	Layout, bindings, filters, transformations, and related workspace state.
Presentation state	Positions, camera, visible detail, saved sets, history, annotations, and story scenes.

The published GPH schema is the validation reference. Use File formats for the formats that carry graph data without the complete workspace.

Project identity

The Python and R packages expose complete-project and semantic graph fingerprints. A project fingerprint changes when visual state changes; a semantic fingerprint changes when the graph data changes. Use the pair when a pipeline needs to distinguish “the drawing changed” from “the network changed.”

Choose a format

• Use .gph to continue editing in Garphield, Python, R, or an embed.
• Use GEXF, GraphML, GML, or node-link JSON to exchange graph data.
• Use a share link for a supported browser view and its current presentation.
• Use PNG for a rendered image.

See Save, share, and export and The .gph document for examples of each format.