{ "title": "Build, repair and export an evidence package — Virtual Acoustic Objects", "text": "MODAVIS (2026). Build, repair and export an evidence package — Virtual Acoustic Objects. Research notebooks, October 2026 · Interactive reuse and evidence edition. https://modavis.org/editions/2026-10-workbench/vao/workbench/", "bibtex": "@misc{modavis_vao_workbench_2026_10_workbench,\n author = {{MODAVIS}},\n title = {Build, repair and export an evidence package — Virtual Acoustic Objects},\n year = {2026},\n month = {10},\n version = {2026-10-workbench},\n url = {https://modavis.org/editions/2026-10-workbench/vao/workbench/},\n note = {Content SHA-256: 4c06b4c8e92b8c6429166dc8eae15ab0a65f3073a7c04b386253bbcddf421349}\n}", "url": "https://modavis.org/editions/2026-10-workbench/vao/workbench/", "sha256": "4c06b4c8e92b8c6429166dc8eae15ab0a65f3073a7c04b386253bbcddf421349", "edition": "2026-10-workbench", "date": "2026-10-09", "canonicalPayload": "{\"book\":{\"number\":\"01\",\"slug\":\"vao\",\"title\":\"Virtual Acoustic Objects\"},\"chapter\":{\"blocks\":[{\"id\":\"workbench-purpose\",\"text\":\"A small package you can finish\",\"type\":\"heading\"},{\"text\":\"Start with one instrument identity and one text note. This supported workflow is intentionally small: it teaches the same distinction between a subject, a logical asset and exact realization bytes that larger recording or model packages require. The example begins as an attributed learning derivative of the standard’s minimal fixture, with its own identifiers and authoring activity.\",\"type\":\"p\"},{\"type\":\"visual\",\"visual\":{\"caption\":\"Follow the relationship between the things, then check the exact records in the workbench.\",\"layout\":\"flow\",\"nodes\":[{\"detail\":\"What the note concerns.\",\"icon\":\"organ\",\"label\":\"Subject\",\"value\":\"Practice instrument\"},{\"detail\":\"One exact UTF-8 realization.\",\"icon\":\"file\",\"label\":\"Resource\",\"value\":\"Evidence note\"},{\"detail\":\"A manifest, carrier mapping and embedded note.\",\"icon\":\"layers\",\"label\":\"Delivery\",\"value\":\"VAO carrier\"}],\"relations\":[\"aboutEntityIds connects the asset to the subject\",\"The carrier embeds the realization and binds the manifest\"],\"title\":\"From a note to a checked carrier\"}},{\"assets\":{\"config\":{\"byteSize\":5796,\"sha256\":\"a27dd862407ff9c31b58035c4f7ab7045b2e3e7295540e19af8995d12385995e\",\"src\":\"/runtime/workbench-a27dd862407ff9c3.json\"},\"seed\":{\"byteSize\":10880,\"sha256\":\"b84d75af4570d1f0895cd2eaf6db6142ef7afe89490c7d4d063b6f6cec44bdae\",\"src\":\"/examples/workbench-seed-b84d75af4570d1f0.json\"},\"worker\":{\"byteSize\":2748,\"sha256\":\"46cab36e569e890832f3698eb6ad408fc8f05d7bee5ff5878449468d0d17c9dd\",\"src\":\"/runtime/worker-46cab36e569e8908.mjs\"}},\"id\":\"evidence-package-workbench\",\"intro\":\"Change the label or note, inspect the connections, and validate. Introduce a digest mismatch to learn what an exact-byte error means, then repair and check again.\",\"mode\":\"package\",\"title\":\"Your evidence package\",\"type\":\"workbench\"},{\"id\":\"workbench-read-report\",\"text\":\"Read the report before exporting\",\"type\":\"heading\"},{\"text\":\"The released VAO 0.5.0 tool checks JSON Schema conditions, semantic references, declared profiles and the actual embedded bytes. The packer writes a carrier only after workspace validation; that packed carrier is then checked again. Download is enabled only for the current passing contents. Editing clears the result, so an earlier pass cannot stand in for a new check.\",\"type\":\"p\"},{\"text\":\"The current practice workspace and packed carrier pass the released reference checks for their declared Core, Dynamic Delivery and Scientific profiles. This does not prove historical truth, a playable instrument, acoustic fidelity or acceptance by a repository.\",\"title\":\"What a passing result establishes\",\"type\":\"note\"},{\"id\":\"workbench-production\",\"text\":\"Move from practice to your own project\",\"type\":\"heading\"},{\"items\":[\"Keep the original evidence and identify its source, permissions and processing history. Use identifiers appropriate to your project; the example.org identifiers in this practice package are placeholders.\",\"For an audio recording, use audio technical metadata and any required additional profiles. Do not rename source.txt to .wav or copy this document realization as an audio declaration. Follow the package guide and native tools for that workflow.\",\"Choose acquisition groups and capabilities for your intended delivery. A bootstrap carrier may provide a useful subset without establishing preservation closure.\",\"Run the reference checks on the exact files you will distribute. Check repository descriptors and citation requirements separately.\"],\"type\":\"list\"},{\"items\":[{\"detail\":\"Choose profiles, rights, byte identities and delivery.\",\"href\":\"/notebooks/vao/reuse/\",\"label\":\"Package a recording: full reuse guide\"},{\"detail\":\"Keep the instrument and its representation distinct.\",\"href\":\"/notebooks/ontologies/workbench/\",\"label\":\"Describe the subject in a graph\"},{\"detail\":\"A practical checklist with separate validation scopes.\",\"href\":\"/notebooks/standards/reuse-checklist/\",\"label\":\"Before you publish\"}],\"type\":\"links\"},{\"boundary\":\"This is an illustrative workflow, not a historical claim or a repository certification.\",\"caseLabel\":\"Practice workflow\",\"concept\":\"A reusable result keeps its identity, source and validation scope visible.\",\"evidence\":\"Illustrative scenario\",\"id\":\"package-byte-example\",\"scenario\":\"Use the generic practice example to make one deliberate edit and see what changes.\",\"sources\":[{\"detail\":\"Unmodified released reference validator, packer, schemas and minimal fixture. Software Apache 2.0; schemas and examples CC BY 4.0, Dominik Ukolov and contributors.\",\"href\":\"https://doi.org/10.5281/zenodo.22214248\",\"label\":\"VAO Standard 0.5.0\"}],\"steps\":[{\"text\":\"The supported form creates a coherent practice record. Direct technical edits can introduce errors.\",\"title\":\"Edit a label or note\"},{\"text\":\"The released validator evaluates the exact current input and returns its actual report.\",\"title\":\"Check the current contents\"},{\"text\":\"An edit clears the previous pass. Export the current checked graph or packed carrier with its report.\",\"title\":\"Export the passing result\"}],\"takeaway\":\"A passing check belongs to specific contents and a stated profile.\",\"title\":\"Make a change you can check\",\"type\":\"example\",\"visual\":{\"caption\":\"Follow the relationship between the things, then check the exact records in the workbench.\",\"layout\":\"flow\",\"nodes\":[{\"detail\":\"What the note concerns.\",\"icon\":\"organ\",\"label\":\"Subject\",\"value\":\"Practice instrument\"},{\"detail\":\"One exact UTF-8 realization.\",\"icon\":\"file\",\"label\":\"Resource\",\"value\":\"Evidence note\"},{\"detail\":\"A manifest, carrier mapping and embedded note.\",\"icon\":\"layers\",\"label\":\"Delivery\",\"value\":\"VAO carrier\"}],\"relations\":[\"aboutEntityIds connects the asset to the subject\",\"The carrier embeds the realization and binds the manifest\"],\"title\":\"From a note to a checked carrier\"}}],\"intro\":\"Turn a small source-evidence note into a portable VAO. Edit a verified practice example, follow its file identities, run the released reference validator, and download the resulting carrier.\",\"overview\":{\"example\":{\"detail\":\"\",\"href\":\"#package-byte-example\",\"label\":\"See the worked example\"},\"summary\":\"A reusable result keeps its identity, source and validation scope visible.\",\"takeaway\":\"A passing check belongs to specific contents and a stated profile.\"},\"slug\":\"workbench\",\"sources\":[{\"detail\":\"Unmodified released reference validator, packer, schemas and minimal fixture. Software Apache 2.0; schemas and examples CC BY 4.0, Dominik Ukolov and contributors.\",\"href\":\"https://doi.org/10.5281/zenodo.22214248\",\"label\":\"VAO Standard 0.5.0\"},{\"detail\":\"Released ontology, vocabulary and exchange SHACL modules. Teaching graph adapted from the verified starter; no remote imports or inference. Publication profile is excluded.\",\"href\":\"https://doi.org/10.5281/zenodo.22126086\",\"label\":\"MODAVIS Ontology Network 0.1.0\"}],\"title\":\"Build, repair and export an evidence package\"},\"date\":\"2026-10-09\",\"edition\":\"2026-10-workbench\",\"figures\":{},\"glossary\":[{\"definition\":\"An intellectual or functional resource, such as a take, a mesh or a score. Its role is distinguished from the particular bytes used to represent it.\",\"example\":{\"detail\":\"\",\"href\":\"/notebooks/standards/cuntz/#cuntz-asset\",\"label\":\"Work through the Cuntz example\"},\"term\":\"Logical asset\"},{\"definition\":\"One exact byte sequence representing an asset. Different encodings or derivatives have different exact identities.\",\"example\":{\"detail\":\"\",\"href\":\"/notebooks/standards/cuntz/#cuntz-asset\",\"label\":\"Work through the Cuntz example\"},\"term\":\"Realization\"},{\"definition\":\"A package or workspace that contains a manifest, carrier mapping and selected realizations. Bootstrap, preservation-closure and custom carriers serve different delivery purposes.\",\"example\":{\"detail\":\"\",\"href\":\"/notebooks/standards/cuntz/#cuntz-carriers\",\"label\":\"Work through the Cuntz example\"},\"term\":\"Carrier\"},{\"definition\":\"A versioned set of additional requirements. A client must satisfy the declared capabilities before claiming full support for that profile.\",\"example\":{\"detail\":\"\",\"href\":\"/notebooks/standards/cuntz/#cuntz-profiles\",\"label\":\"Work through the Cuntz example\"},\"term\":\"Profile\"}]}", "payload": { "edition": "2026-10-workbench", "date": "2026-10-09", "book": { "slug": "vao", "title": "Virtual Acoustic Objects", "number": "01" }, "chapter": { "slug": "workbench", "title": "Build, repair and export an evidence package", "intro": "Turn a small source-evidence note into a portable VAO. Edit a verified practice example, follow its file identities, run the released reference validator, and download the resulting carrier.", "sources": [ { "label": "VAO Standard 0.5.0", "href": "https://doi.org/10.5281/zenodo.22214248", "detail": "Unmodified released reference validator, packer, schemas and minimal fixture. Software Apache 2.0; schemas and examples CC BY 4.0, Dominik Ukolov and contributors." }, { "label": "MODAVIS Ontology Network 0.1.0", "href": "https://doi.org/10.5281/zenodo.22126086", "detail": "Released ontology, vocabulary and exchange SHACL modules. Teaching graph adapted from the verified starter; no remote imports or inference. Publication profile is excluded." } ], "blocks": [ { "type": "heading", "id": "workbench-purpose", "text": "A small package you can finish" }, { "type": "p", "text": "Start with one instrument identity and one text note. This supported workflow is intentionally small: it teaches the same distinction between a subject, a logical asset and exact realization bytes that larger recording or model packages require. The example begins as an attributed learning derivative of the standard’s minimal fixture, with its own identifiers and authoring activity." }, { "type": "visual", "visual": { "layout": "flow", "title": "From a note to a checked carrier", "caption": "Follow the relationship between the things, then check the exact records in the workbench.", "nodes": [ { "label": "Subject", "value": "Practice instrument", "detail": "What the note concerns.", "icon": "organ" }, { "label": "Resource", "value": "Evidence note", "detail": "One exact UTF-8 realization.", "icon": "file" }, { "label": "Delivery", "value": "VAO carrier", "detail": "A manifest, carrier mapping and embedded note.", "icon": "layers" } ], "relations": [ "aboutEntityIds connects the asset to the subject", "The carrier embeds the realization and binds the manifest" ] } }, { "type": "workbench", "id": "evidence-package-workbench", "title": "Your evidence package", "intro": "Change the label or note, inspect the connections, and validate. Introduce a digest mismatch to learn what an exact-byte error means, then repair and check again.", "mode": "package", "assets": { "config": { "src": "/runtime/workbench-a27dd862407ff9c3.json", "sha256": "a27dd862407ff9c31b58035c4f7ab7045b2e3e7295540e19af8995d12385995e", "byteSize": 5796 }, "worker": { "src": "/runtime/worker-46cab36e569e8908.mjs", "sha256": "46cab36e569e890832f3698eb6ad408fc8f05d7bee5ff5878449468d0d17c9dd", "byteSize": 2748 }, "seed": { "src": "/examples/workbench-seed-b84d75af4570d1f0.json", "sha256": "b84d75af4570d1f0895cd2eaf6db6142ef7afe89490c7d4d063b6f6cec44bdae", "byteSize": 10880 } } }, { "type": "heading", "id": "workbench-read-report", "text": "Read the report before exporting" }, { "type": "p", "text": "The released VAO 0.5.0 tool checks JSON Schema conditions, semantic references, declared profiles and the actual embedded bytes. The packer writes a carrier only after workspace validation; that packed carrier is then checked again. Download is enabled only for the current passing contents. Editing clears the result, so an earlier pass cannot stand in for a new check." }, { "type": "note", "title": "What a passing result establishes", "text": "The current practice workspace and packed carrier pass the released reference checks for their declared Core, Dynamic Delivery and Scientific profiles. This does not prove historical truth, a playable instrument, acoustic fidelity or acceptance by a repository." }, { "type": "heading", "id": "workbench-production", "text": "Move from practice to your own project" }, { "type": "list", "items": [ "Keep the original evidence and identify its source, permissions and processing history. Use identifiers appropriate to your project; the example.org identifiers in this practice package are placeholders.", "For an audio recording, use audio technical metadata and any required additional profiles. Do not rename source.txt to .wav or copy this document realization as an audio declaration. Follow the package guide and native tools for that workflow.", "Choose acquisition groups and capabilities for your intended delivery. A bootstrap carrier may provide a useful subset without establishing preservation closure.", "Run the reference checks on the exact files you will distribute. Check repository descriptors and citation requirements separately." ] }, { "type": "links", "items": [ { "label": "Package a recording: full reuse guide", "href": "/notebooks/vao/reuse/", "detail": "Choose profiles, rights, byte identities and delivery." }, { "label": "Describe the subject in a graph", "href": "/notebooks/ontologies/workbench/", "detail": "Keep the instrument and its representation distinct." }, { "label": "Before you publish", "href": "/notebooks/standards/reuse-checklist/", "detail": "A practical checklist with separate validation scopes." } ] }, { "type": "example", "id": "package-byte-example", "caseLabel": "Practice workflow", "evidence": "Illustrative scenario", "title": "Make a change you can check", "concept": "A reusable result keeps its identity, source and validation scope visible.", "scenario": "Use the generic practice example to make one deliberate edit and see what changes.", "steps": [ { "title": "Edit a label or note", "text": "The supported form creates a coherent practice record. Direct technical edits can introduce errors." }, { "title": "Check the current contents", "text": "The released validator evaluates the exact current input and returns its actual report." }, { "title": "Export the passing result", "text": "An edit clears the previous pass. Export the current checked graph or packed carrier with its report." } ], "takeaway": "A passing check belongs to specific contents and a stated profile.", "boundary": "This is an illustrative workflow, not a historical claim or a repository certification.", "sources": [ { "label": "VAO Standard 0.5.0", "href": "https://doi.org/10.5281/zenodo.22214248", "detail": "Unmodified released reference validator, packer, schemas and minimal fixture. Software Apache 2.0; schemas and examples CC BY 4.0, Dominik Ukolov and contributors." } ], "visual": { "layout": "flow", "title": "From a note to a checked carrier", "caption": "Follow the relationship between the things, then check the exact records in the workbench.", "nodes": [ { "label": "Subject", "value": "Practice instrument", "detail": "What the note concerns.", "icon": "organ" }, { "label": "Resource", "value": "Evidence note", "detail": "One exact UTF-8 realization.", "icon": "file" }, { "label": "Delivery", "value": "VAO carrier", "detail": "A manifest, carrier mapping and embedded note.", "icon": "layers" } ], "relations": [ "aboutEntityIds connects the asset to the subject", "The carrier embeds the realization and binds the manifest" ] } } ], "overview": { "summary": "A reusable result keeps its identity, source and validation scope visible.", "takeaway": "A passing check belongs to specific contents and a stated profile.", "example": { "label": "See the worked example", "href": "#package-byte-example", "detail": "" } } }, "glossary": [ { "term": "Logical asset", "definition": "An intellectual or functional resource, such as a take, a mesh or a score. Its role is distinguished from the particular bytes used to represent it.", "example": { "label": "Work through the Cuntz example", "href": "/notebooks/standards/cuntz/#cuntz-asset", "detail": "" } }, { "term": "Realization", "definition": "One exact byte sequence representing an asset. Different encodings or derivatives have different exact identities.", "example": { "label": "Work through the Cuntz example", "href": "/notebooks/standards/cuntz/#cuntz-asset", "detail": "" } }, { "term": "Carrier", "definition": "A package or workspace that contains a manifest, carrier mapping and selected realizations. Bootstrap, preservation-closure and custom carriers serve different delivery purposes.", "example": { "label": "Work through the Cuntz example", "href": "/notebooks/standards/cuntz/#cuntz-carriers", "detail": "" } }, { "term": "Profile", "definition": "A versioned set of additional requirements. A client must satisfy the declared capabilities before claiming full support for that profile.", "example": { "label": "Work through the Cuntz example", "href": "/notebooks/standards/cuntz/#cuntz-profiles", "detail": "" } } ], "figures": {} } }