{
  "title": "Describe, check and reuse an instrument graph — Ontologies & vocabularies",
  "text": "MODAVIS (2026). Describe, check and reuse an instrument graph — Ontologies & vocabularies. Research notebooks, October 2026 · Interactive reuse and evidence edition. https://modavis.org/editions/2026-10-workbench/ontologies/workbench/",
  "bibtex": "@misc{modavis_ontologies_workbench_2026_10_workbench,\n  author = {{MODAVIS}},\n  title = {Describe, check and reuse an instrument graph — Ontologies & vocabularies},\n  year = {2026},\n  month = {10},\n  version = {2026-10-workbench},\n  url = {https://modavis.org/editions/2026-10-workbench/ontologies/workbench/},\n  note = {Content SHA-256: 656961d10484283e79695ea3910e9860c7b417ec72f75ad15bcb2aeaa93bc2cc}\n}",
  "url": "https://modavis.org/editions/2026-10-workbench/ontologies/workbench/",
  "sha256": "656961d10484283e79695ea3910e9860c7b417ec72f75ad15bcb2aeaa93bc2cc",
  "edition": "2026-10-workbench",
  "date": "2026-10-09",
  "canonicalPayload": "{\"book\":{\"number\":\"07\",\"slug\":\"ontologies\",\"title\":\"Ontologies & vocabularies\"},\"chapter\":{\"blocks\":[{\"id\":\"graph-workbench-purpose\",\"text\":\"Two identities, one useful connection\",\"type\":\"heading\"},{\"text\":\"A physical subject and a digital representation need separate identities. The generic teaching graph uses MusicalInstrument and DigitalRepresentation from the released modules, canonicalLabel for language-tagged names, instrumentType for the pipe-organ vocabulary term, and representationOf to connect the model to the instrument. It makes no historical assertion about Cuntz.\",\"type\":\"p\"},{\"type\":\"visual\",\"visual\":{\"caption\":\"Follow the relationship between the things, then check the exact records in the workbench.\",\"layout\":\"flow\",\"nodes\":[{\"detail\":\"A MusicalInstrument with its own IRI.\",\"icon\":\"organ\",\"label\":\"Subject\",\"value\":\"Learning organ\"},{\"detail\":\"An explicit relationship between two things.\",\"icon\":\"layers\",\"label\":\"Link\",\"value\":\"representationOf\"},{\"detail\":\"A DigitalRepresentation with its own IRI.\",\"icon\":\"file\",\"label\":\"Representation\",\"value\":\"Illustrative model\"}],\"relations\":[\"The model points to the subject\",\"Its authored status qualifies the representation\"],\"title\":\"The model is about the instrument\"}},{\"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\":\"instrument-graph-workbench\",\"intro\":\"Edit the labels or representation status. Introduce a self-reference to see an actual SHACL error; repair it and export the checked graph.\",\"mode\":\"graph\",\"title\":\"Your instrument graph\",\"type\":\"workbench\"},{\"id\":\"graph-workbench-report\",\"text\":\"Understand the validation boundary\",\"type\":\"heading\"},{\"text\":\"The browser executes RDFLib and pySHACL against the exact MODAVIS 0.1.0 source release. It loads all released ontology and vocabulary modules and the exchange shapes, excludes the publication shape module, uses no inference and does not fetch remote imports. The report shows a failing focus node, property and message when the shape supplies them.\",\"type\":\"p\"},{\"text\":\"SHACL checks declared graph conditions. A valid graph can contain a mistaken historical claim. Keep attributable source accounts, qualifications and review decisions alongside the convenient accepted view. This small graph does not demonstrate the complete evidence or publication workflow.\",\"title\":\"Conformance and evidence answer different questions\",\"type\":\"note\"},{\"id\":\"graph-workbench-reuse\",\"text\":\"Reuse the network without copying the example’s assumptions\",\"type\":\"heading\"},{\"items\":[\"Use the immutable release and the modules needed for your domain. Preserve the source, version and licence of the terms and example you adapt.\",\"Replace the placeholder IRIs with persistent identifiers for your own entities. Keep representations, subjects and file realizations distinct.\",\"Use evidence and assertions modules when a claim requires attribution, uncertainty or review. Do not treat an authored model as a calibrated measurement.\",\"Run the exchange checks for exchanged data and add the publication profile when your publishing workflow requires it. Record tool versions, inference settings and exact input files.\"],\"type\":\"list\"},{\"items\":[{\"detail\":\"See source, result and qualification together.\",\"href\":\"/notebooks/ontologies/cuntz/#cuntz-evidence-explorer\",\"label\":\"Follow a released Cuntz observation\"},{\"detail\":\"Select modules, model the claim and run native checks.\",\"href\":\"/notebooks/ontologies/reuse/\",\"label\":\"Full ontology reuse guide\"},{\"detail\":\"Package a resource with exact byte identity.\",\"href\":\"/notebooks/vao/workbench/\",\"label\":\"Export an evidence carrier\"}],\"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\":\"graph-identity-example\",\"scenario\":\"Use the generic practice example to make one deliberate edit and see what changes.\",\"sources\":[{\"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\"}],\"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\":\"A MusicalInstrument with its own IRI.\",\"icon\":\"organ\",\"label\":\"Subject\",\"value\":\"Learning organ\"},{\"detail\":\"An explicit relationship between two things.\",\"icon\":\"layers\",\"label\":\"Link\",\"value\":\"representationOf\"},{\"detail\":\"A DigitalRepresentation with its own IRI.\",\"icon\":\"file\",\"label\":\"Representation\",\"value\":\"Illustrative model\"}],\"relations\":[\"The model points to the subject\",\"Its authored status qualifies the representation\"],\"title\":\"The model is about the instrument\"}}],\"intro\":\"Create a comprehensible exchange graph with an instrument and its digital representation. Change the labels, inspect the relationship, validate against the released MODAVIS shapes, and export Turtle.\",\"overview\":{\"example\":{\"detail\":\"\",\"href\":\"#graph-identity-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\":\"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\"},{\"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\"}],\"title\":\"Describe, check and reuse an instrument graph\"},\"date\":\"2026-10-09\",\"edition\":\"2026-10-workbench\",\"figures\":{},\"glossary\":[{\"definition\":\"A statement that can be identified, attributed, qualified and reviewed. Its presence in a source or dataset does not by itself establish truth.\",\"example\":{\"detail\":\"\",\"href\":\"/notebooks/ontologies/cuntz/#cuntz-assertions\",\"label\":\"Work through the Cuntz example\"},\"term\":\"Assertion\"},{\"definition\":\"A graph data model: statements connect a subject to an object through an identified relationship. For Cuntz, an observation can point to the pipe it describes and the evidence it uses.\",\"example\":{\"detail\":\"\",\"href\":\"/notebooks/ontologies/cuntz/#cuntz-graph\",\"label\":\"Follow a Cuntz observation through the graph\"},\"term\":\"RDF\"},{\"definition\":\"A language for checking an RDF data graph against declared shapes and constraints. It can find a modeling error; it does not independently settle a disputed historical register count.\",\"example\":{\"detail\":\"\",\"href\":\"/notebooks/ontologies/cuntz/#cuntz-owl-shacl\",\"label\":\"Work through a hypothetical Cuntz modeling error\"},\"term\":\"SHACL\"}]}",
  "payload": {
    "edition": "2026-10-workbench",
    "date": "2026-10-09",
    "book": {
      "slug": "ontologies",
      "title": "Ontologies & vocabularies",
      "number": "07"
    },
    "chapter": {
      "slug": "workbench",
      "title": "Describe, check and reuse an instrument graph",
      "intro": "Create a comprehensible exchange graph with an instrument and its digital representation. Change the labels, inspect the relationship, validate against the released MODAVIS shapes, and export Turtle.",
      "sources": [
        {
          "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."
        },
        {
          "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."
        }
      ],
      "blocks": [
        {
          "type": "heading",
          "id": "graph-workbench-purpose",
          "text": "Two identities, one useful connection"
        },
        {
          "type": "p",
          "text": "A physical subject and a digital representation need separate identities. The generic teaching graph uses MusicalInstrument and DigitalRepresentation from the released modules, canonicalLabel for language-tagged names, instrumentType for the pipe-organ vocabulary term, and representationOf to connect the model to the instrument. It makes no historical assertion about Cuntz."
        },
        {
          "type": "visual",
          "visual": {
            "layout": "flow",
            "title": "The model is about the instrument",
            "caption": "Follow the relationship between the things, then check the exact records in the workbench.",
            "nodes": [
              {
                "label": "Subject",
                "value": "Learning organ",
                "detail": "A MusicalInstrument with its own IRI.",
                "icon": "organ"
              },
              {
                "label": "Link",
                "value": "representationOf",
                "detail": "An explicit relationship between two things.",
                "icon": "layers"
              },
              {
                "label": "Representation",
                "value": "Illustrative model",
                "detail": "A DigitalRepresentation with its own IRI.",
                "icon": "file"
              }
            ],
            "relations": [
              "The model points to the subject",
              "Its authored status qualifies the representation"
            ]
          }
        },
        {
          "type": "workbench",
          "id": "instrument-graph-workbench",
          "title": "Your instrument graph",
          "intro": "Edit the labels or representation status. Introduce a self-reference to see an actual SHACL error; repair it and export the checked graph.",
          "mode": "graph",
          "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": "graph-workbench-report",
          "text": "Understand the validation boundary"
        },
        {
          "type": "p",
          "text": "The browser executes RDFLib and pySHACL against the exact MODAVIS 0.1.0 source release. It loads all released ontology and vocabulary modules and the exchange shapes, excludes the publication shape module, uses no inference and does not fetch remote imports. The report shows a failing focus node, property and message when the shape supplies them."
        },
        {
          "type": "note",
          "title": "Conformance and evidence answer different questions",
          "text": "SHACL checks declared graph conditions. A valid graph can contain a mistaken historical claim. Keep attributable source accounts, qualifications and review decisions alongside the convenient accepted view. This small graph does not demonstrate the complete evidence or publication workflow."
        },
        {
          "type": "heading",
          "id": "graph-workbench-reuse",
          "text": "Reuse the network without copying the example’s assumptions"
        },
        {
          "type": "list",
          "items": [
            "Use the immutable release and the modules needed for your domain. Preserve the source, version and licence of the terms and example you adapt.",
            "Replace the placeholder IRIs with persistent identifiers for your own entities. Keep representations, subjects and file realizations distinct.",
            "Use evidence and assertions modules when a claim requires attribution, uncertainty or review. Do not treat an authored model as a calibrated measurement.",
            "Run the exchange checks for exchanged data and add the publication profile when your publishing workflow requires it. Record tool versions, inference settings and exact input files."
          ]
        },
        {
          "type": "links",
          "items": [
            {
              "label": "Follow a released Cuntz observation",
              "href": "/notebooks/ontologies/cuntz/#cuntz-evidence-explorer",
              "detail": "See source, result and qualification together."
            },
            {
              "label": "Full ontology reuse guide",
              "href": "/notebooks/ontologies/reuse/",
              "detail": "Select modules, model the claim and run native checks."
            },
            {
              "label": "Export an evidence carrier",
              "href": "/notebooks/vao/workbench/",
              "detail": "Package a resource with exact byte identity."
            }
          ]
        },
        {
          "type": "example",
          "id": "graph-identity-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": "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."
            }
          ],
          "visual": {
            "layout": "flow",
            "title": "The model is about the instrument",
            "caption": "Follow the relationship between the things, then check the exact records in the workbench.",
            "nodes": [
              {
                "label": "Subject",
                "value": "Learning organ",
                "detail": "A MusicalInstrument with its own IRI.",
                "icon": "organ"
              },
              {
                "label": "Link",
                "value": "representationOf",
                "detail": "An explicit relationship between two things.",
                "icon": "layers"
              },
              {
                "label": "Representation",
                "value": "Illustrative model",
                "detail": "A DigitalRepresentation with its own IRI.",
                "icon": "file"
              }
            ],
            "relations": [
              "The model points to the subject",
              "Its authored status qualifies the representation"
            ]
          }
        }
      ],
      "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": "#graph-identity-example",
          "detail": ""
        }
      }
    },
    "glossary": [
      {
        "term": "Assertion",
        "definition": "A statement that can be identified, attributed, qualified and reviewed. Its presence in a source or dataset does not by itself establish truth.",
        "example": {
          "label": "Work through the Cuntz example",
          "href": "/notebooks/ontologies/cuntz/#cuntz-assertions",
          "detail": ""
        }
      },
      {
        "term": "RDF",
        "definition": "A graph data model: statements connect a subject to an object through an identified relationship. For Cuntz, an observation can point to the pipe it describes and the evidence it uses.",
        "example": {
          "label": "Follow a Cuntz observation through the graph",
          "href": "/notebooks/ontologies/cuntz/#cuntz-graph",
          "detail": ""
        }
      },
      {
        "term": "SHACL",
        "definition": "A language for checking an RDF data graph against declared shapes and constraints. It can find a modeling error; it does not independently settle a disputed historical register count.",
        "example": {
          "label": "Work through a hypothetical Cuntz modeling error",
          "href": "/notebooks/ontologies/cuntz/#cuntz-owl-shacl",
          "detail": ""
        }
      }
    ],
    "figures": {}
  }
}