{ "title": "From Cuntz evidence to a portable VAO — Standards & citation", "text": "MODAVIS (2026). From Cuntz evidence to a portable VAO — Standards & citation. Research notebooks, September 2026 · Cuntz worked examples edition. https://modavis.org/editions/2026-09-r5/standards/cuntz/", "bibtex": "@misc{modavis_standards_cuntz_2026_09_r5,\n author = {{MODAVIS}},\n title = {From Cuntz evidence to a portable VAO — Standards & citation},\n year = {2026},\n month = {09},\n version = {2026-09-r5},\n url = {https://modavis.org/editions/2026-09-r5/standards/cuntz/},\n note = {Content SHA-256: 795dc6066f869014a071ab93e6deaec6e76d97be7392e822c84791b9c9f3e3a5}\n}", "url": "https://modavis.org/editions/2026-09-r5/standards/cuntz/", "sha256": "795dc6066f869014a071ab93e6deaec6e76d97be7392e822c84791b9c9f3e3a5", "edition": "2026-09-r5", "date": "2026-09-26", "canonicalPayload": "{\"book\":{\"number\":\"08\",\"slug\":\"standards\",\"title\":\"Standards & citation\"},\"chapter\":{\"blocks\":[{\"items\":[{\"detail\":\"The physical organ, its state and the evidence behind an observation.\",\"href\":\"/notebooks/ontologies/cuntz/\",\"label\":\"Begin with the ontology example\"}],\"type\":\"links\"},{\"id\":\"records-and-meaning\",\"text\":\"1. Give a record an explicit meaning\",\"type\":\"heading\"},{\"boundary\":\"Do not copy a few fields from the manifest and assume the excerpt retains the complete JSON-LD or VAO contract.\",\"concept\":\"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.\",\"expanded\":true,\"id\":\"cuntz-jsonld\",\"scenario\":\"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.\",\"sources\":[{\"detail\":\"Published manifest: identities, measurement observations, realization digests, profiles and rights. Exact examples checked against this release.\",\"href\":\"https://doi.org/10.5281/zenodo.22151203\",\"label\":\"Cuntz Positiv · VAO 0.5.0-rc.2\"},{\"detail\":\"The standard contract is separate from the Cuntz dataset content version 0.5.0-rc.2.\",\"href\":\"https://doi.org/10.5281/zenodo.22214248\",\"label\":\"VAO Standard 0.5.0\"}],\"steps\":[{\"text\":\"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.\",\"title\":\"Read the ordinary data first\"},{\"text\":\"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.\",\"title\":\"Identify the terms explicitly\"},{\"text\":\"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.\",\"title\":\"Pin the interpretation\"}],\"takeaway\":\"The context explains how the data’s terms connect to identified meanings; it does not add missing evidence.\",\"title\":\"How does JSON become linked data?\",\"type\":\"example\"},{\"label\":\"Exact fields from the published observation · excerpt, not a complete VAO\",\"text\":\"{\\n \\\"featureOfInterestId\\\": \\\"urn:musixplora:4010243:cuntz-positiv:rank:ged:pipe:key-036\\\",\\n \\\"observedProperty\\\": \\\"https://w3id.org/modavis/vao/cuntz-positiv/measurement/GesL\\\",\\n \\\"result\\\": {\\n \\\"quantityKind\\\": \\\"https://w3id.org/modavis/vao/cuntz-positiv/quantity/GesL\\\",\\n \\\"unit\\\": \\\"http://qudt.org/vocab/unit/MilliM\\\",\\n \\\"value\\\": 1281\\n },\\n \\\"qualityFlags\\\": [\\n \\\"result-time-from-workbook-modification-timestamp\\\",\\n \\\"source-cell:Holzgedackt 8!D9\\\",\\n \\\"source-series:2019\\\"\\n ],\\n \\\"resultTime\\\": \\\"2020-09-16T10:33:05Z\\\"\\n}\",\"type\":\"code\"},{\"text\":\"Read the identifiers as links to other records, not as a requirement to memorize the strings. The human interpretation is: the specified pipe has an asserted GesL result of 1281 millimetres, traceable to a named workbook cell, with an explicit timestamp qualification. The full manifest supplies the surrounding context and referenced entities.\",\"type\":\"p\"},{\"id\":\"files-and-delivery\",\"text\":\"2. Distinguish a research asset from its files\",\"type\":\"heading\"},{\"boundary\":\"The smaller web derivative has not been retroactively inserted into the published VAO manifest.\",\"concept\":\"A logical asset names a role in the research object. A realization identifies one exact encoding of that asset. A distribution says where a realization can be obtained.\",\"expanded\":true,\"id\":\"cuntz-asset\",\"scenario\":\"The Cuntz manifest groups the 4010243_segmented_03b2 FBX source and GLB runtime model under one logical model asset. Their byte sizes, formats and digests differ.\",\"sources\":[{\"detail\":\"Published manifest: identities, measurement observations, realization digests, profiles and rights. Exact examples checked against this release.\",\"href\":\"https://doi.org/10.5281/zenodo.22151203\",\"label\":\"Cuntz Positiv · VAO 0.5.0-rc.2\"},{\"detail\":\"The standard contract is separate from the Cuntz dataset content version 0.5.0-rc.2.\",\"href\":\"https://doi.org/10.5281/zenodo.22214248\",\"label\":\"VAO Standard 0.5.0\"}],\"steps\":[{\"text\":\"The asset groups representations serving the named model role. It supplies the connection that a filename alone cannot guarantee.\",\"title\":\"Identify the shared asset\"},{\"text\":\"The FBX source is 61,745,100 bytes; the released GLB is 115,416,448 bytes. The GLB is marked derived, with a model-conversion activity. Each has an independent SHA-256.\",\"title\":\"Inspect each realization\"},{\"text\":\"The smaller model served by this notebook is another derived file. Its caption and file identity distinguish it from both published realizations, and its provenance leads back to the released GLB.\",\"title\":\"Identify the notebook derivative separately\"}],\"takeaway\":\"“Same asset” expresses a relationship; “same bytes” is a separate, testable claim.\",\"title\":\"How can two model files represent one asset?\",\"type\":\"example\"},{\"boundary\":\"A downloaded bootstrap does not prove that every external resource has been fetched or verified.\",\"concept\":\"A manifest describes the research object and its resource relationships. A carrier is a package that delivers some or all of those exact resources.\",\"expanded\":true,\"id\":\"cuntz-carriers\",\"scenario\":\"The published Cuntz record offers a bootstrap carrier and a preservation carrier. The release states that both carry the same manifest; the preservation carrier includes every declared realization.\",\"sources\":[{\"detail\":\"Published manifest: identities, measurement observations, realization digests, profiles and rights. Exact examples checked against this release.\",\"href\":\"https://doi.org/10.5281/zenodo.22151203\",\"label\":\"Cuntz Positiv · VAO 0.5.0-rc.2\"},{\"detail\":\"The standard contract is separate from the Cuntz dataset content version 0.5.0-rc.2.\",\"href\":\"https://doi.org/10.5281/zenodo.22214248\",\"label\":\"VAO Standard 0.5.0\"}],\"steps\":[{\"text\":\"The bootstrap supplies the semantic inventory and core evidence. It lets a reader discover what exists without first downloading all the media.\",\"title\":\"Begin with the inventory\"},{\"text\":\"A geometry inspection needs the selected model and its dependencies. A playable experience may need audio, control mappings and other groups. Reading metadata does not make those resources locally available.\",\"title\":\"Request the required material\"},{\"text\":\"The complete preservation carrier supports the full declared realization inventory. Cite the exact release and record which carrier or selected closure you actually acquired.\",\"title\":\"Choose preservation deliberately\"}],\"takeaway\":\"One research release can have several delivery packages without becoming several historical interpretations.\",\"title\":\"Why does the Cuntz release offer two VAO downloads?\",\"type\":\"example\"},{\"boundary\":\"This example explains the selection rule; it does not assert that the published Cuntz GLB uses an external texture or that the web viewer executes a complete VAO.\",\"concept\":\"A dependency is something an item needs to work as declared. Closure means including everything required by the selected items, continuing until no required dependency is missing.\",\"expanded\":true,\"id\":\"cuntz-closure\",\"scenario\":\"Imagine a Cuntz display model delivered with a separate material texture. This is an illustrative delivery scenario; the notebook’s GLB instead embeds its texture.\",\"sources\":[{\"detail\":\"Published manifest: identities, measurement observations, realization digests, profiles and rights. Exact examples checked against this release.\",\"href\":\"https://doi.org/10.5281/zenodo.22151203\",\"label\":\"Cuntz Positiv · VAO 0.5.0-rc.2\"},{\"detail\":\"The standard contract is separate from the Cuntz dataset content version 0.5.0-rc.2.\",\"href\":\"https://doi.org/10.5281/zenodo.22214248\",\"label\":\"VAO Standard 0.5.0\"}],\"steps\":[{\"text\":\"Begin with the geometry realization needed for the task. Selecting its name alone does not guarantee a complete visual representation.\",\"title\":\"Select the model\"},{\"text\":\"If the model needs a texture, include it. If a playback task also requires a sample map and audio files, follow those requirements too. Do not confuse optional enhancements with mandatory dependencies.\",\"title\":\"Follow every declared requirement\"},{\"text\":\"Only after the required bytes are acquired and verified can the selected capability be described as materialized. Record missing resources as missing rather than silently substituting unrelated files.\",\"title\":\"Verify the complete selection\"}],\"takeaway\":\"Closure is the complete set of prerequisites for a chosen task, not necessarily the entire archive.\",\"title\":\"What does “dependency closure” mean for a model?\",\"type\":\"example\"},{\"id\":\"checks-and-capabilities\",\"text\":\"3. State what is available and what was checked\",\"type\":\"heading\"},{\"boundary\":\"No acoustics profile or calibrated acoustic response is inferred from the presence of an organ model.\",\"concept\":\"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.\",\"expanded\":true,\"id\":\"cuntz-profiles\",\"scenario\":\"The Cuntz manifest declares Core, Dynamic Delivery, Playable, Physical Instrument, Scientific, Multimodal, Spatial and Zenodo Repository profiles under VAO 0.5.0.\",\"sources\":[{\"detail\":\"Published manifest: identities, measurement observations, realization digests, profiles and rights. Exact examples checked against this release.\",\"href\":\"https://doi.org/10.5281/zenodo.22151203\",\"label\":\"Cuntz Positiv · VAO 0.5.0-rc.2\"},{\"detail\":\"The standard contract is separate from the Cuntz dataset content version 0.5.0-rc.2.\",\"href\":\"https://doi.org/10.5281/zenodo.22214248\",\"label\":\"VAO Standard 0.5.0\"}],\"steps\":[{\"text\":\"The object contains information for several uses, including physical topology, scientific observations and sampled interaction. These requirements describe the package contract.\",\"title\":\"Read the object’s declarations\"},{\"text\":\"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.\",\"title\":\"State the viewer’s operation\"},{\"text\":\"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.\",\"title\":\"Choose another client when the task changes\"}],\"takeaway\":\"A working 3D preview proves that the chosen model can be displayed; it does not establish complete VAO conformance or playability.\",\"title\":\"Does showing the organ in 3D mean the VAO is playable?\",\"type\":\"example\"},{\"boundary\":\"This website verifies the model’s expected byte length and full SHA-256 before passing it to the renderer. That is a file-identity check, not a VAO conformance report.\",\"concept\":\"A checksum is a fingerprint calculated from bytes. Fixity checking compares that fingerprint with a trusted expected value to detect changed or mismatched files.\",\"expanded\":true,\"id\":\"cuntz-fixity\",\"scenario\":\"The published GLB source for this notebook has SHA-256 beginning 19527c2188b08d85. The display derivative has a different digest because its texture and encoding were changed.\",\"sources\":[{\"detail\":\"Published manifest: identities, measurement observations, realization digests, profiles and rights. Exact examples checked against this release.\",\"href\":\"https://doi.org/10.5281/zenodo.22151203\",\"label\":\"Cuntz Positiv · VAO 0.5.0-rc.2\"},{\"detail\":\"The standard contract is separate from the Cuntz dataset content version 0.5.0-rc.2.\",\"href\":\"https://doi.org/10.5281/zenodo.22214248\",\"label\":\"VAO Standard 0.5.0\"}],\"steps\":[{\"text\":\"Check the complete source GLB digest against the exact source realization. Compare the website derivative against its own expected digest, not against the source GLB’s digest.\",\"title\":\"Compare like with like\"},{\"text\":\"A texture conversion or mesh encoding change produces a different file identity. Even reformatting a JSON manifest can change its exact-byte hash without changing its parsed meaning.\",\"title\":\"Notice byte-changing edits\"},{\"text\":\"Matching bytes establish which representation was obtained. The digest does not verify the model’s physical scale, the pipe measurement method or a claim about the sound of 1610.\",\"title\":\"Keep the scientific question separate\"}],\"takeaway\":\"Fixity makes evidence identifiable; it does not independently validate the evidence’s interpretation.\",\"title\":\"What does the model’s SHA-256 prove?\",\"type\":\"example\"},{\"boundary\":\"The notebook’s JSON teaching excerpt is deliberately incomplete and is not presented as a complete, independently conforming VAO package.\",\"concept\":\"Conformance means meeting a specified contract. Different checks address parsing, structure, relationships, required capabilities and file identity.\",\"expanded\":true,\"id\":\"cuntz-conformance\",\"scenario\":\"Take the published observation with value 1281 millimetres. A reader wants to know both whether its record is valid and whether the measurement answers a question about the pipe.\",\"sources\":[{\"detail\":\"Published manifest: identities, measurement observations, realization digests, profiles and rights. Exact examples checked against this release.\",\"href\":\"https://doi.org/10.5281/zenodo.22151203\",\"label\":\"Cuntz Positiv · VAO 0.5.0-rc.2\"},{\"detail\":\"The standard contract is separate from the Cuntz dataset content version 0.5.0-rc.2.\",\"href\":\"https://doi.org/10.5281/zenodo.22214248\",\"label\":\"VAO Standard 0.5.0\"}],\"steps\":[{\"text\":\"A schema can check that the result has the required form and that a numerical field contains a number. Semantic checks can verify that references point to appropriate records.\",\"title\":\"Check the structure\"},{\"text\":\"Resolve the pipe, measurement activity and workbook realization; verify the cited source bytes. These operations establish what the record says and which source it identifies.\",\"title\":\"Check the evidence links\"},{\"text\":\"The workbook timestamp still is not the measurement-session date. A valid record without a documented calibration uncertainty cannot support an uncertainty claim simply because its schema passed.\",\"title\":\"Assess fitness for the question\"}],\"takeaway\":\"Validation and scientific assessment complement one another; each needs an explicitly stated scope.\",\"title\":\"How can a file pass validation but support a limited conclusion?\",\"type\":\"example\"},{\"id\":\"reuse\",\"text\":\"4. Make reuse recoverable\",\"type\":\"heading\"},{\"boundary\":\"The dataset content version 0.5.0-rc.2, VAO format version 0.5.0 and website edition are separate version systems.\",\"concept\":\"Versioned citation separates the physical subject, the released research object and the explanation or derived artifact actually used.\",\"expanded\":true,\"id\":\"cuntz-citation\",\"scenario\":\"A reader uses the notebook’s model to discuss a geometry, while another uses the 1281 mm workbook observation. Their references should identify different evidence even though both concern Cuntz.\",\"sources\":[{\"detail\":\"Published manifest: identities, measurement observations, realization digests, profiles and rights. Exact examples checked against this release.\",\"href\":\"https://doi.org/10.5281/zenodo.22151203\",\"label\":\"Cuntz Positiv · VAO 0.5.0-rc.2\"},{\"detail\":\"The standard contract is separate from the Cuntz dataset content version 0.5.0-rc.2.\",\"href\":\"https://doi.org/10.5281/zenodo.22214248\",\"label\":\"VAO Standard 0.5.0\"}],\"steps\":[{\"text\":\"Use version DOI 10.5281/zenodo.22151203 for the inspected dataset. Record the specific realization or observation, rather than citing only the project community.\",\"title\":\"Identify the release\"},{\"text\":\"For the web preview, retain the derivative’s digest and transformation note. For the observation, identify the pipe, property, source cell and workbook realization.\",\"title\":\"Identify what was used\"},{\"text\":\"Use “Cite this page” for the notebook’s fixed edition. Its fingerprint identifies the explanation; it does not replace the source dataset or model fingerprint.\",\"title\":\"Cite the explanation separately\"}],\"takeaway\":\"A citation chain lets a reader recover both the evidence and the interpretation.\",\"title\":\"Which Cuntz identifier belongs in a citation?\",\"type\":\"example\"},{\"boundary\":\"This example describes the release’s recorded terms; it does not assign new rights to unrelated third-party assets.\",\"concept\":\"A rights record specifies access and reuse information. Provenance separately identifies contributors and transformations; keeping both supports responsible reuse.\",\"expanded\":true,\"id\":\"cuntz-rights\",\"scenario\":\"The Cuntz release’s explicit rights properties state open access and CC BY-SA 4.0, with a contributor attribution. This notebook’s model is a changed display derivative.\",\"sources\":[{\"detail\":\"Published manifest: identities, measurement observations, realization digests, profiles and rights. Exact examples checked against this release.\",\"href\":\"https://doi.org/10.5281/zenodo.22151203\",\"label\":\"Cuntz Positiv · VAO 0.5.0-rc.2\"}],\"steps\":[{\"text\":\"Use the rights properties and linked licence for the exact version, rather than an older development README or an opaque identifier suffix.\",\"title\":\"Read the explicit release statement\"},{\"text\":\"Credit the source dataset and contributors, link its version record and licence, and identify the changes made for this website.\",\"title\":\"Carry the attribution forward\"},{\"text\":\"The release retains its original bytes. The website publishes its derivative with its own fingerprint and a transformation note, making the relationship inspectable.\",\"title\":\"Keep file identities distinct\"}],\"takeaway\":\"Open access and a traceable derivative still require clear source, credit and change information.\",\"title\":\"Does an open dataset remove the need for attribution?\",\"type\":\"example\"},{\"items\":[{\"detail\":\"See how a web derivative retains source and file identity.\",\"href\":\"/notebooks/vao/model-study/\",\"label\":\"Inspect the Cuntz model\"},{\"detail\":\"A small source-attributed extract; not a replacement for the complete VAO.\",\"href\":\"/examples/cuntz-observation.json\",\"label\":\"Download the observation teaching excerpt\"}],\"type\":\"links\"}],\"intro\":\"Use the same organ, pipe observation and model to understand the exchange contract. Each distinction answers a practical question about what a file contains, how it can be obtained and what a successful check establishes.\",\"slug\":\"cuntz\",\"sources\":[{\"detail\":\"Published manifest: identities, measurement observations, realization digests, profiles and rights. Exact examples checked against this release.\",\"href\":\"https://doi.org/10.5281/zenodo.22151203\",\"label\":\"Cuntz Positiv · VAO 0.5.0-rc.2\"},{\"detail\":\"The standard contract is separate from the Cuntz dataset content version 0.5.0-rc.2.\",\"href\":\"https://doi.org/10.5281/zenodo.22214248\",\"label\":\"VAO Standard 0.5.0\"},{\"detail\":\"Identity, state, configuration, evidence, assertions, context and provenance. Teaching examples explain its distinctions without inventing new normative properties.\",\"href\":\"https://doi.org/10.5281/zenodo.22126086\",\"label\":\"MODAVIS Ontology Network 0.1.0\"}],\"title\":\"From Cuntz evidence to a portable VAO\"},\"date\":\"2026-09-26\",\"edition\":\"2026-09-r5\",\"figures\":{}}", "payload": { "edition": "2026-09-r5", "date": "2026-09-26", "book": { "slug": "standards", "title": "Standards & citation", "number": "08" }, "chapter": { "slug": "cuntz", "title": "From Cuntz evidence to a portable VAO", "intro": "Use the same organ, pipe observation and model to understand the exchange contract. Each distinction answers a practical question about what a file contains, how it can be obtained and what a successful check establishes.", "sources": [ { "label": "Cuntz Positiv · VAO 0.5.0-rc.2", "href": "https://doi.org/10.5281/zenodo.22151203", "detail": "Published manifest: identities, measurement observations, realization digests, profiles and rights. Exact examples checked against this release." }, { "label": "VAO Standard 0.5.0", "href": "https://doi.org/10.5281/zenodo.22214248", "detail": "The standard contract is separate from the Cuntz dataset content version 0.5.0-rc.2." }, { "label": "MODAVIS Ontology Network 0.1.0", "href": "https://doi.org/10.5281/zenodo.22126086", "detail": "Identity, state, configuration, evidence, assertions, context and provenance. Teaching examples explain its distinctions without inventing new normative properties." } ], "blocks": [ { "type": "links", "items": [ { "label": "Begin with the ontology example", "href": "/notebooks/ontologies/cuntz/", "detail": "The physical organ, its state and the evidence behind an observation." } ] }, { "type": "heading", "id": "records-and-meaning", "text": "1. Give a record an explicit meaning" }, { "type": "example", "id": "cuntz-jsonld", "title": "How does JSON become linked data?", "concept": "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.", "scenario": "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.", "steps": [ { "title": "Read the ordinary data first", "text": "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." }, { "title": "Identify the terms explicitly", "text": "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." }, { "title": "Pin the interpretation", "text": "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." } ], "takeaway": "The context explains how the data’s terms connect to identified meanings; it does not add missing evidence.", "boundary": "Do not copy a few fields from the manifest and assume the excerpt retains the complete JSON-LD or VAO contract.", "sources": [ { "label": "Cuntz Positiv · VAO 0.5.0-rc.2", "href": "https://doi.org/10.5281/zenodo.22151203", "detail": "Published manifest: identities, measurement observations, realization digests, profiles and rights. Exact examples checked against this release." }, { "label": "VAO Standard 0.5.0", "href": "https://doi.org/10.5281/zenodo.22214248", "detail": "The standard contract is separate from the Cuntz dataset content version 0.5.0-rc.2." } ], "expanded": true }, { "type": "code", "label": "Exact fields from the published observation · excerpt, not a complete VAO", "text": "{\n \"featureOfInterestId\": \"urn:musixplora:4010243:cuntz-positiv:rank:ged:pipe:key-036\",\n \"observedProperty\": \"https://w3id.org/modavis/vao/cuntz-positiv/measurement/GesL\",\n \"result\": {\n \"quantityKind\": \"https://w3id.org/modavis/vao/cuntz-positiv/quantity/GesL\",\n \"unit\": \"http://qudt.org/vocab/unit/MilliM\",\n \"value\": 1281\n },\n \"qualityFlags\": [\n \"result-time-from-workbook-modification-timestamp\",\n \"source-cell:Holzgedackt 8!D9\",\n \"source-series:2019\"\n ],\n \"resultTime\": \"2020-09-16T10:33:05Z\"\n}" }, { "type": "p", "text": "Read the identifiers as links to other records, not as a requirement to memorize the strings. The human interpretation is: the specified pipe has an asserted GesL result of 1281 millimetres, traceable to a named workbook cell, with an explicit timestamp qualification. The full manifest supplies the surrounding context and referenced entities." }, { "type": "heading", "id": "files-and-delivery", "text": "2. Distinguish a research asset from its files" }, { "type": "example", "id": "cuntz-asset", "title": "How can two model files represent one asset?", "concept": "A logical asset names a role in the research object. A realization identifies one exact encoding of that asset. A distribution says where a realization can be obtained.", "scenario": "The Cuntz manifest groups the 4010243_segmented_03b2 FBX source and GLB runtime model under one logical model asset. Their byte sizes, formats and digests differ.", "steps": [ { "title": "Identify the shared asset", "text": "The asset groups representations serving the named model role. It supplies the connection that a filename alone cannot guarantee." }, { "title": "Inspect each realization", "text": "The FBX source is 61,745,100 bytes; the released GLB is 115,416,448 bytes. The GLB is marked derived, with a model-conversion activity. Each has an independent SHA-256." }, { "title": "Identify the notebook derivative separately", "text": "The smaller model served by this notebook is another derived file. Its caption and file identity distinguish it from both published realizations, and its provenance leads back to the released GLB." } ], "takeaway": "“Same asset” expresses a relationship; “same bytes” is a separate, testable claim.", "boundary": "The smaller web derivative has not been retroactively inserted into the published VAO manifest.", "sources": [ { "label": "Cuntz Positiv · VAO 0.5.0-rc.2", "href": "https://doi.org/10.5281/zenodo.22151203", "detail": "Published manifest: identities, measurement observations, realization digests, profiles and rights. Exact examples checked against this release." }, { "label": "VAO Standard 0.5.0", "href": "https://doi.org/10.5281/zenodo.22214248", "detail": "The standard contract is separate from the Cuntz dataset content version 0.5.0-rc.2." } ], "expanded": true }, { "type": "example", "id": "cuntz-carriers", "title": "Why does the Cuntz release offer two VAO downloads?", "concept": "A manifest describes the research object and its resource relationships. A carrier is a package that delivers some or all of those exact resources.", "scenario": "The published Cuntz record offers a bootstrap carrier and a preservation carrier. The release states that both carry the same manifest; the preservation carrier includes every declared realization.", "steps": [ { "title": "Begin with the inventory", "text": "The bootstrap supplies the semantic inventory and core evidence. It lets a reader discover what exists without first downloading all the media." }, { "title": "Request the required material", "text": "A geometry inspection needs the selected model and its dependencies. A playable experience may need audio, control mappings and other groups. Reading metadata does not make those resources locally available." }, { "title": "Choose preservation deliberately", "text": "The complete preservation carrier supports the full declared realization inventory. Cite the exact release and record which carrier or selected closure you actually acquired." } ], "takeaway": "One research release can have several delivery packages without becoming several historical interpretations.", "boundary": "A downloaded bootstrap does not prove that every external resource has been fetched or verified.", "sources": [ { "label": "Cuntz Positiv · VAO 0.5.0-rc.2", "href": "https://doi.org/10.5281/zenodo.22151203", "detail": "Published manifest: identities, measurement observations, realization digests, profiles and rights. Exact examples checked against this release." }, { "label": "VAO Standard 0.5.0", "href": "https://doi.org/10.5281/zenodo.22214248", "detail": "The standard contract is separate from the Cuntz dataset content version 0.5.0-rc.2." } ], "expanded": true }, { "type": "example", "id": "cuntz-closure", "title": "What does “dependency closure” mean for a model?", "concept": "A dependency is something an item needs to work as declared. Closure means including everything required by the selected items, continuing until no required dependency is missing.", "scenario": "Imagine a Cuntz display model delivered with a separate material texture. This is an illustrative delivery scenario; the notebook’s GLB instead embeds its texture.", "steps": [ { "title": "Select the model", "text": "Begin with the geometry realization needed for the task. Selecting its name alone does not guarantee a complete visual representation." }, { "title": "Follow every declared requirement", "text": "If the model needs a texture, include it. If a playback task also requires a sample map and audio files, follow those requirements too. Do not confuse optional enhancements with mandatory dependencies." }, { "title": "Verify the complete selection", "text": "Only after the required bytes are acquired and verified can the selected capability be described as materialized. Record missing resources as missing rather than silently substituting unrelated files." } ], "takeaway": "Closure is the complete set of prerequisites for a chosen task, not necessarily the entire archive.", "boundary": "This example explains the selection rule; it does not assert that the published Cuntz GLB uses an external texture or that the web viewer executes a complete VAO.", "sources": [ { "label": "Cuntz Positiv · VAO 0.5.0-rc.2", "href": "https://doi.org/10.5281/zenodo.22151203", "detail": "Published manifest: identities, measurement observations, realization digests, profiles and rights. Exact examples checked against this release." }, { "label": "VAO Standard 0.5.0", "href": "https://doi.org/10.5281/zenodo.22214248", "detail": "The standard contract is separate from the Cuntz dataset content version 0.5.0-rc.2." } ], "expanded": true }, { "type": "heading", "id": "checks-and-capabilities", "text": "3. State what is available and what was checked" }, { "type": "example", "id": "cuntz-profiles", "title": "Does showing the organ in 3D mean the VAO is playable?", "concept": "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.", "scenario": "The Cuntz manifest declares Core, Dynamic Delivery, Playable, Physical Instrument, Scientific, Multimodal, Spatial and Zenodo Repository profiles under VAO 0.5.0.", "steps": [ { "title": "Read the object’s declarations", "text": "The object contains information for several uses, including physical topology, scientific observations and sampled interaction. These requirements describe the package contract." }, { "title": "State the viewer’s operation", "text": "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." }, { "title": "Choose another client when the task changes", "text": "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." } ], "takeaway": "A working 3D preview proves that the chosen model can be displayed; it does not establish complete VAO conformance or playability.", "boundary": "No acoustics profile or calibrated acoustic response is inferred from the presence of an organ model.", "sources": [ { "label": "Cuntz Positiv · VAO 0.5.0-rc.2", "href": "https://doi.org/10.5281/zenodo.22151203", "detail": "Published manifest: identities, measurement observations, realization digests, profiles and rights. Exact examples checked against this release." }, { "label": "VAO Standard 0.5.0", "href": "https://doi.org/10.5281/zenodo.22214248", "detail": "The standard contract is separate from the Cuntz dataset content version 0.5.0-rc.2." } ], "expanded": true }, { "type": "example", "id": "cuntz-fixity", "title": "What does the model’s SHA-256 prove?", "concept": "A checksum is a fingerprint calculated from bytes. Fixity checking compares that fingerprint with a trusted expected value to detect changed or mismatched files.", "scenario": "The published GLB source for this notebook has SHA-256 beginning 19527c2188b08d85. The display derivative has a different digest because its texture and encoding were changed.", "steps": [ { "title": "Compare like with like", "text": "Check the complete source GLB digest against the exact source realization. Compare the website derivative against its own expected digest, not against the source GLB’s digest." }, { "title": "Notice byte-changing edits", "text": "A texture conversion or mesh encoding change produces a different file identity. Even reformatting a JSON manifest can change its exact-byte hash without changing its parsed meaning." }, { "title": "Keep the scientific question separate", "text": "Matching bytes establish which representation was obtained. The digest does not verify the model’s physical scale, the pipe measurement method or a claim about the sound of 1610." } ], "takeaway": "Fixity makes evidence identifiable; it does not independently validate the evidence’s interpretation.", "boundary": "This website verifies the model’s expected byte length and full SHA-256 before passing it to the renderer. That is a file-identity check, not a VAO conformance report.", "sources": [ { "label": "Cuntz Positiv · VAO 0.5.0-rc.2", "href": "https://doi.org/10.5281/zenodo.22151203", "detail": "Published manifest: identities, measurement observations, realization digests, profiles and rights. Exact examples checked against this release." }, { "label": "VAO Standard 0.5.0", "href": "https://doi.org/10.5281/zenodo.22214248", "detail": "The standard contract is separate from the Cuntz dataset content version 0.5.0-rc.2." } ], "expanded": true }, { "type": "example", "id": "cuntz-conformance", "title": "How can a file pass validation but support a limited conclusion?", "concept": "Conformance means meeting a specified contract. Different checks address parsing, structure, relationships, required capabilities and file identity.", "scenario": "Take the published observation with value 1281 millimetres. A reader wants to know both whether its record is valid and whether the measurement answers a question about the pipe.", "steps": [ { "title": "Check the structure", "text": "A schema can check that the result has the required form and that a numerical field contains a number. Semantic checks can verify that references point to appropriate records." }, { "title": "Check the evidence links", "text": "Resolve the pipe, measurement activity and workbook realization; verify the cited source bytes. These operations establish what the record says and which source it identifies." }, { "title": "Assess fitness for the question", "text": "The workbook timestamp still is not the measurement-session date. A valid record without a documented calibration uncertainty cannot support an uncertainty claim simply because its schema passed." } ], "takeaway": "Validation and scientific assessment complement one another; each needs an explicitly stated scope.", "boundary": "The notebook’s JSON teaching excerpt is deliberately incomplete and is not presented as a complete, independently conforming VAO package.", "sources": [ { "label": "Cuntz Positiv · VAO 0.5.0-rc.2", "href": "https://doi.org/10.5281/zenodo.22151203", "detail": "Published manifest: identities, measurement observations, realization digests, profiles and rights. Exact examples checked against this release." }, { "label": "VAO Standard 0.5.0", "href": "https://doi.org/10.5281/zenodo.22214248", "detail": "The standard contract is separate from the Cuntz dataset content version 0.5.0-rc.2." } ], "expanded": true }, { "type": "heading", "id": "reuse", "text": "4. Make reuse recoverable" }, { "type": "example", "id": "cuntz-citation", "title": "Which Cuntz identifier belongs in a citation?", "concept": "Versioned citation separates the physical subject, the released research object and the explanation or derived artifact actually used.", "scenario": "A reader uses the notebook’s model to discuss a geometry, while another uses the 1281 mm workbook observation. Their references should identify different evidence even though both concern Cuntz.", "steps": [ { "title": "Identify the release", "text": "Use version DOI 10.5281/zenodo.22151203 for the inspected dataset. Record the specific realization or observation, rather than citing only the project community." }, { "title": "Identify what was used", "text": "For the web preview, retain the derivative’s digest and transformation note. For the observation, identify the pipe, property, source cell and workbook realization." }, { "title": "Cite the explanation separately", "text": "Use “Cite this page” for the notebook’s fixed edition. Its fingerprint identifies the explanation; it does not replace the source dataset or model fingerprint." } ], "takeaway": "A citation chain lets a reader recover both the evidence and the interpretation.", "boundary": "The dataset content version 0.5.0-rc.2, VAO format version 0.5.0 and website edition are separate version systems.", "sources": [ { "label": "Cuntz Positiv · VAO 0.5.0-rc.2", "href": "https://doi.org/10.5281/zenodo.22151203", "detail": "Published manifest: identities, measurement observations, realization digests, profiles and rights. Exact examples checked against this release." }, { "label": "VAO Standard 0.5.0", "href": "https://doi.org/10.5281/zenodo.22214248", "detail": "The standard contract is separate from the Cuntz dataset content version 0.5.0-rc.2." } ], "expanded": true }, { "type": "example", "id": "cuntz-rights", "title": "Does an open dataset remove the need for attribution?", "concept": "A rights record specifies access and reuse information. Provenance separately identifies contributors and transformations; keeping both supports responsible reuse.", "scenario": "The Cuntz release’s explicit rights properties state open access and CC BY-SA 4.0, with a contributor attribution. This notebook’s model is a changed display derivative.", "steps": [ { "title": "Read the explicit release statement", "text": "Use the rights properties and linked licence for the exact version, rather than an older development README or an opaque identifier suffix." }, { "title": "Carry the attribution forward", "text": "Credit the source dataset and contributors, link its version record and licence, and identify the changes made for this website." }, { "title": "Keep file identities distinct", "text": "The release retains its original bytes. The website publishes its derivative with its own fingerprint and a transformation note, making the relationship inspectable." } ], "takeaway": "Open access and a traceable derivative still require clear source, credit and change information.", "boundary": "This example describes the release’s recorded terms; it does not assign new rights to unrelated third-party assets.", "sources": [ { "label": "Cuntz Positiv · VAO 0.5.0-rc.2", "href": "https://doi.org/10.5281/zenodo.22151203", "detail": "Published manifest: identities, measurement observations, realization digests, profiles and rights. Exact examples checked against this release." } ], "expanded": true }, { "type": "links", "items": [ { "label": "Inspect the Cuntz model", "href": "/notebooks/vao/model-study/", "detail": "See how a web derivative retains source and file identity." }, { "label": "Download the observation teaching excerpt", "href": "/examples/cuntz-observation.json", "detail": "A small source-attributed extract; not a replacement for the complete VAO." } ] } ] }, "figures": {} } }