Overview
Active Inference offers a unifying account of perception, learning, and action under the free energy principle, yet the generative models at its core are still communicated ad hoc: scattered across prose descriptions, bespoke notebooks, and framework-specific code that rarely agree. This fragmentation makes published models hard to reproduce, compare, or port between tools, and it raises the barrier for newcomers learning the formalism. GeneralizedNotationNotation (GNN) addresses this gap with a standardized, human- and machine-readable text language for specifying Active Inference generative models, paired with a 25-step processing pipeline that transforms a single specification into validation, visualization, simulation, and analysis artifacts. A GNN file denotes a generative model, and the language lets that model take the several shapes the field actually uses: the notation blocks a file declares — categorical A/B/C/D[/E] tensors, linear-Gaussian system matrices F/H/Q/R with a Gaussian prior, per-agent and per-level compositions — fix its model kind, which the pipeline classifies structurally and carries through rendering and execution, recording explicitly which registered backends can render and run a model of each kind and which report it unsupported. GNN's "Triple Play" treats each model as three coordinated views — a textual specification, graphical visualizations, and executable cognitive models — so that one source yields consistent outputs across modalities. The framework spans 32 exemplar specifications (27 discrete-state and 5 continuous linear-Gaussian) across 9 model families and 10 registered rendering backends, with explicit gates for cross-format semantic fidelity and cross-framework reliability. GNN 3.0.0 layered safe-by-design long-running orchestration on top of this language and pipeline — durable observation streams, resumable run sessions, and auditable container plans that generate, validate, and replay data only, with no live infrastructure mutation. We describe the language, the model kinds it denotes, the pipeline architecture, and the validation that confirms specifications round-trip faithfully across formats and execute across multiple simulation backends — with coverage gaps recorded as explicit profiled-unsupported statuses rather than silently omitted — establishing GNN as reproducible, interoperable infrastructure for communicating Active Inference models.
Overview source: Archived manuscript abstract.
Methods and contributions
Read the source for the full argument, qualifications, and evidence.
Findings and contributions
- The manuscript presents the Triple Play as text, graphical, and executable views derived from a shared model specification.
- At the manuscript snapshot, the framework covers 32 exemplar specifications across nine model families and ten registered rendering backends.
- The manuscript reports profiled execution gaps for continuous and hierarchical models, and a deliberate render-only scope for structural models; it does not claim that every model executes on every backend.
- The manuscript specifies reproducible validation commands and explicitly avoids asserting a fixed passing-check count.
- The manuscript describes long-running orchestration contracts that generate, validate, and replay data without mutating live infrastructure.
Methods
- Parsing and structured export — Parses plain-text model specifications into an internal representation and structured export formats, retaining declared model vocabulary.
- Model-kind type checking and validation — Checks state spaces, observation modalities, control factors, matrix dimensions, and kind-specific shape contracts before code generation.
- Kind-aware model rendering — Carries structurally determined model kinds into rendering and execution, recording which backends can handle each kind and which report it unsupported.
- Semantic fidelity and cross-framework gates — Provides reproducible commands for testing semantic preservation in round trips and comparing generated model structure across backend implementations.
Summary sources: Paper metadata and evidence · Extracted source text.
Document downloads
PDFs are hosted here; supporting sources may use pinned archives.
- GeneralizedNotationNotation_v3.6.0.pdf PDF · 1.36 MiB · declared primary
Citation
Citation metadata follows the unified bibliography.
Catalog details and resources
Related works
Ranked by recorded methods, topics, contributors and associated software, with contributor roles and domain-only matches labelled. Metadata overlap is not a citation or a scientific equivalence.