Built on explicit agreements
Standards make it possible to exchange a research object without losing the meaning of its parts.
MODAVIS connects complementary standards rather than asking one format to do everything. The ontology describes meaning and relationships. VAO binds digital resources into an exchange and preservation contract. Repositories supply persistent version records.
| Layer | Role |
|---|---|
| MODAVIS Ontology Network | Semantic identities and evidence-qualified relationships. |
| VAO Standard | Manifest, resources, profiles, carriers and file integrity. |
| Persistent identifiers | Stable references to entities and exact releases. |
| Provenance | Documented source, transformation and editorial lineage. |
Established media and research-object formats remain useful within this architecture. A VAO is an integration envelope; it does not replace an audio format, a repository or a domain ontology.
The agreement at each boundary
| Boundary | Agreement needed |
|---|---|
| A source enters a research workflow | Identity, capture context, transfer structure and attribution. |
| A statement becomes a research representation | Semantic identity, evidence, interpretation and historical applicability. |
| A representation becomes an exchange package | Exact manifest, resources, profiles, rights and carrier mappings. |
| A package becomes a published release | Persistent version information, file identities and repository metadata. |
These agreements address different kinds of interoperability. Two applications can read the same audio encoding while disagreeing about which instrument state the recording represents. Two catalogues can use the same label while assigning it to different concepts. Interoperability therefore requires both usable bytes and an explicit account of their meaning.
Cuntz · Worked example#
Does showing the organ in 3D mean the VAO is playable?
A profile names a set of requirements for a capability. A client’s support describes what an application can do with the object; the two declarations must be compared.
Work through the example 3 STEPS
The Cuntz manifest declares Core, Dynamic Delivery, Playable, Physical Instrument, Scientific, Multimodal, Spatial and Zenodo Repository profiles under VAO 0.5.0.
Read the object’s declarations
The object contains information for several uses, including physical topology, scientific observations and sampled interaction. These requirements describe the package contract.
State the viewer’s operation
The notebook loads a GLB display derivative and provides camera controls. It does not import the full VAO manifest, evaluate its scientific records or execute its keyboard and stop behavior.
Choose another client when the task changes
To test sampled playback or synchronized controls, choose a client whose documented version supports the relevant format, profiles and resources. Record the tested operation separately from successful visual loading.
BASIS FOR THIS EXAMPLE
- Cuntz Positiv · VAO 0.5.0-rc.2 ↗
Published manifest: identities, measurement observations, realization digests, profiles and rights. Exact examples checked against this release.
- VAO Standard 0.5.0 ↗
The standard contract is separate from the Cuntz dataset content version 0.5.0-rc.2.
No acoustics profile or calibrated acoustic response is inferred from the presence of an organ model.
The useful distinction. A working 3D preview proves that the chosen model can be displayed; it does not establish complete VAO conformance or playability.
Reuse established formats inside the envelope
VAO can identify realizations in established media and research formats, such as WAVE or FLAC audio, glTF geometry and MIDI or score data. The carrier adds the relationships, fixed identities and declared capabilities needed to interpret those realizations together. The chosen format still carries its own technical requirements; packaging a file does not make an incompatible renderer understand it.
Version the contract as carefully as the content
Record the exact schema, profile and vocabulary versions used by a release. A moving “latest” pointer can be convenient for discovering documentation, but it cannot identify the rules under which an earlier package was prepared. When migrating, keep the source release available and describe what changed. A successful migration creates an attributable successor rather than retroactively rewriting the old contract.
VAO Standard 0.5.0The versioned specification and reference tools.
MODAVIS Ontology Network 0.1.0The published semantic model.
Which standard answers which question?
| Contract | Role in this ecosystem | Read the result as |
|---|---|---|
| JSON Schema Draft 2020-12 | Structural validation of the VAO JSON record, with the required format assertions. | A check of the encoded structure, alongside additional semantic rules. |
| JSON-LD 1.1 | Explicit mappings from JSON terms to linked-data identifiers and graph relationships. | A semantic interpretation under an identified context, not a replacement for the authoritative VAO JSON. |
| PROV-O | A vocabulary for entities, activities, agents and their provenance relationships. | An account of derivation and responsibility, not a certificate that the resulting assertion is true. |
| SHACL | Validation of an RDF data graph against declared shapes and constraints. | A report for a particular data graph, shapes graph and validation setup. |
| VAO profiles and carrier contracts | Capabilities, exact realizations, dependency closure and package exchange. | A version-specific interoperability claim whose scope must be stated. |
These contracts work at different layers. A JSON record may satisfy its schema while referring to an inappropriate historical state. A graph may satisfy its shapes while an underlying source remains disputed. PROV-O can express that an analysis was generated by an activity associated with an agent; it does not independently verify that the activity used a calibrated instrument. The domain model and the research method provide the interpretation around the technical contract.
For implementation, keep the relevant documents and contexts pinned with the release. Start with the project’s specified contract rather than substituting a newer vocabulary or a moving context URL. For reading, consult the official specifications below alongside the project-specific requirements. This separates the general mechanism from the particular agreement MODAVIS or VAO makes with its consumers.
W3C JSON-LD 1.1Contexts and linked-data representation.
W3C PROV-OThe provenance vocabulary.
W3C SHACLRDF graph constraints and validation reports.
VAO validation guideApply these layers to a concrete object.
Cuntz · Worked example#
How does JSON become linked data?
JSON is a way to write structured values. JSON-LD adds an explicit context that relates terms to identifiers, so relationships can be interpreted consistently across records.
Work through the example 3 STEPS
The Cuntz manifest contains both a formatVersion and an @context. Its observation identifies the property GesL with an IRI and its unit with the QUDT MilliM identifier.
Read the ordinary data first
A human explanation says: this pipe has a recorded GesL result of 1281 millimetres in this source cell. That sentence should remain understandable before a reader meets graph syntax.
Identify the terms explicitly
An identified property and unit avoid relying on an unexplained local word such as “length” or “mm” alone. Their definitions and mapping must be inspected rather than guessed from spelling.
Pin the interpretation
Use the context and contract appropriate to the exact VAO version. Changing a context can change interpretation; a moving “latest” mapping is unsuitable for reproducing a fixed release.
BASIS FOR THIS EXAMPLE
- Cuntz Positiv · VAO 0.5.0-rc.2 ↗
Published manifest: identities, measurement observations, realization digests, profiles and rights. Exact examples checked against this release.
- VAO Standard 0.5.0 ↗
The standard contract is separate from the Cuntz dataset content version 0.5.0-rc.2.
Do not copy a few fields from the manifest and assume the excerpt retains the complete JSON-LD or VAO contract.
The useful distinction. The context explains how the data’s terms connect to identified meanings; it does not add missing evidence.
Sources & further reading
- VAO Standard 0.5.0
The versioned specification and reference tools.
- MODAVIS Ontology Network 0.1.0
The published semantic model.
- W3C · JSON-LD 1.1
Official specification; consulted for contexts and linked-data representation.
- W3C · PROV-O
Official provenance ontology; entities, activities and agents.
- W3C · SHACL
Official graph-validation specification, including Core and SPARQL-based constraints.
Page editions 2026-09-r5 ↓
Read a fixed snapshot of this chapter, or return to the current notebook.
Edition 2026-09-r5 · SHA-256
6b31a7c4d93dPage metadata ↗