{ "title": "Cite what you actually used — Standards & citation", "text": "MODAVIS (2026). Cite what you actually used — Standards & citation. Research notebooks, September 2026 · Connected evidence edition. https://modavis.org/editions/2026-09-r6/standards/citing/", "bibtex": "@misc{modavis_standards_citing_2026_09_r6,\n author = {{MODAVIS}},\n title = {Cite what you actually used — Standards & citation},\n year = {2026},\n month = {09},\n version = {2026-09-r6},\n url = {https://modavis.org/editions/2026-09-r6/standards/citing/},\n note = {Content SHA-256: d3568f9e2e2a2def95835244c3d8de547fb73cc773e79d90cf705d022e3a49c5}\n}", "url": "https://modavis.org/editions/2026-09-r6/standards/citing/", "sha256": "d3568f9e2e2a2def95835244c3d8de547fb73cc773e79d90cf705d022e3a49c5", "edition": "2026-09-r6", "date": "2026-09-26", "canonicalPayload": "{\"book\":{\"number\":\"08\",\"slug\":\"standards\",\"title\":\"Standards & citation\"},\"chapter\":{\"blocks\":[{\"items\":[{\"detail\":\"A continuous worked example: readable explanations, exact records and the limits of each claim.\",\"href\":\"/notebooks/standards/cuntz/\",\"label\":\"Learn this through the Cuntz organ\"}],\"type\":\"links\"},{\"id\":\"notebook-citation\",\"text\":\"Citing a notebook page\",\"type\":\"heading\"},{\"text\":\"Use “Cite this page” in any notebook to obtain its edition URL, access-ready reference and BibTeX record. The edition URL identifies the fixed content snapshot. The SHA-256 fingerprint identifies the structured page content and its bibliographic context.\",\"type\":\"p\"},{\"text\":\"The fingerprint covers the edition identifier, publication date, notebook identity and the complete chapter, including references and the exact definitions of its diagrams. It does not cover the surrounding site design, external websites or files reached through links.\",\"type\":\"p\"},{\"text\":\"These pages provide versioned local editions. A repository deposit and DOI would add independent archival persistence; this website does not claim that its notebook editions have already been deposited.\",\"title\":\"An edition URL is not a DOI\",\"type\":\"note\"},{\"id\":\"resource-citation\",\"text\":\"Citing the research resource\",\"type\":\"heading\"},{\"text\":\"For an analysis of POD, cite the exact dataset version. For an implementation of VAO, cite the specification version. A citation of an explanatory notebook helps readers follow your reasoning, but does not substitute for either of those references.\",\"type\":\"p\"},{\"id\":\"citation-matrix\",\"text\":\"Match the citation to the work performed\",\"type\":\"heading\"},{\"headers\":[\"You used…\",\"Cite…\",\"Also record…\"],\"rows\":[[\"An explanatory chapter\",\"Its fixed notebook edition.\",\"The relevant section and any underlying evidence used.\"],[\"POD records in an analysis\",\"The exact POD version.\",\"Distribution, selection, query and checksum.\"],[\"A software method\",\"The exact application or tool release.\",\"Parameters, environment and input identities.\"],[\"A VAO object\",\"The instrument-package release.\",\"Standard contract, selected resources and client version where relevant.\"],[\"A specification or vocabulary\",\"Its immutable version record.\",\"The profile, term or constraint used.\"]],\"type\":\"table\"},{\"id\":\"version-doi\",\"text\":\"Why a version DOI matters\",\"type\":\"heading\"},{\"text\":\"A project or concept record may group successive releases. For a reproducible reference, use the identifier that fixes the version you actually used. A community link helps a reader discover related work but does not identify a unique input. Keep the human-readable citation and the machine-readable identifiers together so the reference remains interpretable outside the original application.\",\"type\":\"p\"},{\"boundary\":\"The dataset content version 0.5.0-rc.2, VAO format version 0.5.0 and website edition are separate version systems.\",\"caseLabel\":\"Cuntz\",\"concept\":\"Versioned citation separates the physical subject, the released research object and the explanation or derived artifact actually used.\",\"evidence\":\"Illustrative scenario\",\"expanded\":false,\"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\"},{\"id\":\"checksum-and-citation\",\"text\":\"A checksum complements a citation\",\"type\":\"heading\"},{\"text\":\"The digest answers whether a particular sequence of bytes or canonical structured content matches a recorded identity. It does not identify an author by itself, explain why a transformation was made or guarantee that an external service will remain online. Those needs are met by the citation, provenance, release documentation and preservation arrangements working together.\",\"type\":\"p\"},{\"text\":\"For this site, the downloadable metadata contains the exact canonical string that was hashed. Compare its recomputed digest with the recorded SHA-256 and retain the edition URL. If an external dataset or recording underpins the result, verify that artifact separately: the notebook’s fingerprint covers its own content and references, not the remote bytes behind each link.\",\"type\":\"p\"},{\"items\":[{\"detail\":\"The fixed dataset release, methods and checksums.\",\"href\":\"https://doi.org/10.5281/zenodo.22308263\",\"label\":\"Pipe Organ Dataset 1.6.0\"},{\"detail\":\"The versioned specification and reference tools.\",\"href\":\"https://doi.org/10.5281/zenodo.22214248\",\"label\":\"VAO Standard 0.5.0\"},{\"detail\":\"The published semantic model.\",\"href\":\"https://doi.org/10.5281/zenodo.22126086\",\"label\":\"MODAVIS Ontology Network 0.1.0\"}],\"type\":\"links\"},{\"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.\",\"caseLabel\":\"Cuntz\",\"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.\",\"evidence\":\"Released record\",\"expanded\":false,\"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\"},{\"id\":\"citation-chain-example\",\"text\":\"A citation chain for a derived acoustic result\",\"type\":\"heading\"},{\"text\":\"Suppose a figure reports a pitch statistic from an exported recording excerpt. Cite the exact object or dataset release, identify the signal realization and excerpt, record the analysis tool and configuration, and retain the derived table or figure identity. If this notebook supplied the explanatory method, cite its fixed page edition separately. The notebook explains the procedure; the data and analysis records support the numerical result.\",\"type\":\"p\"},{\"text\":\"For a standard-dependent operation, also identify the exact standard and profiles used. A concept DOI can help readers discover the family of releases, but the version DOI identifies the release used in the analysis. Keep acquisition receipts and local digests with the working record so that the obtained material can be compared with the cited artifact.\",\"type\":\"p\"},{\"items\":[{\"detail\":\"Follow a release to verified realizations.\",\"href\":\"/notebooks/vao/delivery/\",\"label\":\"Exact resolution and receipts\"},{\"detail\":\"Keep the exported result connected to the original signal.\",\"href\":\"/notebooks/fieldwork/analysis/\",\"label\":\"Recording analysis\"}],\"type\":\"links\"}],\"intro\":\"A notebook page, a software tool and a dataset are different research resources.\",\"slug\":\"citing\",\"sources\":[{\"detail\":\"The versioned specification and reference tools.\",\"href\":\"https://doi.org/10.5281/zenodo.22214248\",\"label\":\"VAO Standard 0.5.0\"},{\"detail\":\"The fixed dataset release, methods and checksums.\",\"href\":\"https://doi.org/10.5281/zenodo.22308263\",\"label\":\"Pipe Organ Dataset 1.6.0\"},{\"detail\":\"Normative standard, profile index, Dynamic Delivery Profile and conformance specification in the versioned release.\",\"href\":\"https://doi.org/10.5281/zenodo.22214248\",\"label\":\"VAO Standard 0.5.0\"}],\"title\":\"Cite what you actually used\"},\"date\":\"2026-09-26\",\"edition\":\"2026-09-r6\",\"figures\":{}}", "payload": { "edition": "2026-09-r6", "date": "2026-09-26", "book": { "slug": "standards", "title": "Standards & citation", "number": "08" }, "chapter": { "slug": "citing", "title": "Cite what you actually used", "intro": "A notebook page, a software tool and a dataset are different research resources.", "blocks": [ { "type": "links", "items": [ { "label": "Learn this through the Cuntz organ", "href": "/notebooks/standards/cuntz/", "detail": "A continuous worked example: readable explanations, exact records and the limits of each claim." } ] }, { "type": "heading", "text": "Citing a notebook page", "id": "notebook-citation" }, { "type": "p", "text": "Use “Cite this page” in any notebook to obtain its edition URL, access-ready reference and BibTeX record. The edition URL identifies the fixed content snapshot. The SHA-256 fingerprint identifies the structured page content and its bibliographic context." }, { "type": "p", "text": "The fingerprint covers the edition identifier, publication date, notebook identity and the complete chapter, including references and the exact definitions of its diagrams. It does not cover the surrounding site design, external websites or files reached through links." }, { "type": "note", "title": "An edition URL is not a DOI", "text": "These pages provide versioned local editions. A repository deposit and DOI would add independent archival persistence; this website does not claim that its notebook editions have already been deposited." }, { "type": "heading", "text": "Citing the research resource", "id": "resource-citation" }, { "type": "p", "text": "For an analysis of POD, cite the exact dataset version. For an implementation of VAO, cite the specification version. A citation of an explanatory notebook helps readers follow your reasoning, but does not substitute for either of those references." }, { "type": "heading", "text": "Match the citation to the work performed", "id": "citation-matrix" }, { "type": "table", "headers": [ "You used…", "Cite…", "Also record…" ], "rows": [ [ "An explanatory chapter", "Its fixed notebook edition.", "The relevant section and any underlying evidence used." ], [ "POD records in an analysis", "The exact POD version.", "Distribution, selection, query and checksum." ], [ "A software method", "The exact application or tool release.", "Parameters, environment and input identities." ], [ "A VAO object", "The instrument-package release.", "Standard contract, selected resources and client version where relevant." ], [ "A specification or vocabulary", "Its immutable version record.", "The profile, term or constraint used." ] ] }, { "type": "heading", "text": "Why a version DOI matters", "id": "version-doi" }, { "type": "p", "text": "A project or concept record may group successive releases. For a reproducible reference, use the identifier that fixes the version you actually used. A community link helps a reader discover related work but does not identify a unique input. Keep the human-readable citation and the machine-readable identifiers together so the reference remains interpretable outside the original application." }, { "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": false, "caseLabel": "Cuntz", "evidence": "Illustrative scenario" }, { "type": "heading", "text": "A checksum complements a citation", "id": "checksum-and-citation" }, { "type": "p", "text": "The digest answers whether a particular sequence of bytes or canonical structured content matches a recorded identity. It does not identify an author by itself, explain why a transformation was made or guarantee that an external service will remain online. Those needs are met by the citation, provenance, release documentation and preservation arrangements working together." }, { "type": "p", "text": "For this site, the downloadable metadata contains the exact canonical string that was hashed. Compare its recomputed digest with the recorded SHA-256 and retain the edition URL. If an external dataset or recording underpins the result, verify that artifact separately: the notebook’s fingerprint covers its own content and references, not the remote bytes behind each link." }, { "type": "links", "items": [ { "label": "Pipe Organ Dataset 1.6.0", "href": "https://doi.org/10.5281/zenodo.22308263", "detail": "The fixed dataset release, methods and checksums." }, { "label": "VAO Standard 0.5.0", "href": "https://doi.org/10.5281/zenodo.22214248", "detail": "The versioned specification and reference tools." }, { "label": "MODAVIS Ontology Network 0.1.0", "href": "https://doi.org/10.5281/zenodo.22126086", "detail": "The published semantic model." } ] }, { "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": false, "caseLabel": "Cuntz", "evidence": "Released record" }, { "type": "heading", "id": "citation-chain-example", "text": "A citation chain for a derived acoustic result" }, { "type": "p", "text": "Suppose a figure reports a pitch statistic from an exported recording excerpt. Cite the exact object or dataset release, identify the signal realization and excerpt, record the analysis tool and configuration, and retain the derived table or figure identity. If this notebook supplied the explanatory method, cite its fixed page edition separately. The notebook explains the procedure; the data and analysis records support the numerical result." }, { "type": "p", "text": "For a standard-dependent operation, also identify the exact standard and profiles used. A concept DOI can help readers discover the family of releases, but the version DOI identifies the release used in the analysis. Keep acquisition receipts and local digests with the working record so that the obtained material can be compared with the cited artifact." }, { "type": "links", "items": [ { "label": "Exact resolution and receipts", "href": "/notebooks/vao/delivery/", "detail": "Follow a release to verified realizations." }, { "label": "Recording analysis", "href": "/notebooks/fieldwork/analysis/", "detail": "Keep the exported result connected to the original signal." } ] } ], "sources": [ { "label": "VAO Standard 0.5.0", "href": "https://doi.org/10.5281/zenodo.22214248", "detail": "The versioned specification and reference tools." }, { "label": "Pipe Organ Dataset 1.6.0", "href": "https://doi.org/10.5281/zenodo.22308263", "detail": "The fixed dataset release, methods and checksums." }, { "label": "VAO Standard 0.5.0", "href": "https://doi.org/10.5281/zenodo.22214248", "detail": "Normative standard, profile index, Dynamic Delivery Profile and conformance specification in the versioned release." } ] }, "figures": {} } }