{
  "title": "A tool for each part of the work — Tools & experiences",
  "text": "MODAVIS (2026). A tool for each part of the work — Tools & experiences. Research notebooks, September 2026 · expanded edition. https://modavis.org/editions/2026-09-r3/software/introduction/",
  "bibtex": "@misc{modavis_software_introduction_2026_09_r3,\n  author = {{MODAVIS}},\n  title = {A tool for each part of the work — Tools & experiences},\n  year = {2026},\n  month = {09},\n  version = {2026-09-r3},\n  url = {https://modavis.org/editions/2026-09-r3/software/introduction/},\n  note = {Content SHA-256: d9c246ab701ff976bbec1831ef469675ef660a7cab74e3a876e7c7e638988c5b}\n}",
  "url": "https://modavis.org/editions/2026-09-r3/software/introduction/",
  "sha256": "d9c246ab701ff976bbec1831ef469675ef660a7cab74e3a876e7c7e638988c5b",
  "edition": "2026-09-r3",
  "date": "2026-09-26",
  "canonicalPayload": "{\"book\":{\"number\":\"06\",\"slug\":\"software\",\"title\":\"Tools & experiences\"},\"chapter\":{\"blocks\":[{\"items\":[{\"detail\":\"57 entries · software, modules, standards and research collections\",\"href\":\"/notebooks/software/directory/\",\"label\":\"Explore the complete ecosystem\"}],\"type\":\"links\"},{\"items\":[{\"detail\":\"Explore instruments, sources and their relationships.\",\"href\":\"https://navigator.modavis.org\",\"label\":\"Open MODAVIS Navigator\"},{\"detail\":\"Geographic access to organological data.\",\"href\":\"https://map.modavis.org/\",\"label\":\"OrgMap\"},{\"detail\":\"Browser-based exploration of Virtual Acoustic Objects.\",\"href\":\"https://vaoxr.modavis.org/\",\"label\":\"vaoXR\"},{\"detail\":\"The recording application’s release record.\",\"href\":\"https://doi.org/10.5281/zenodo.22698744\",\"label\":\"OrgRec 0.3.2\"}],\"type\":\"links\"},{\"id\":\"workflow\",\"text\":\"From fieldwork to publication\",\"type\":\"heading\"},{\"text\":\"Recording, reconciliation, analysis and interactive presentation ask different things of a tool. MODAVIS treats them as connected stages with explicit inputs, outputs and responsibilities.\",\"type\":\"p\"},{\"text\":\"Six core components organize the research workflow. Monitor and the musiXplora Bridge provide supporting capabilities. Twelve Processor modules and specialist applications handle particular transcription, analysis, modelling and presentation tasks.\",\"type\":\"p\"},{\"text\":\"A public interface, a software release record and a source repository are separate forms of access. Follow each resource’s own documentation for its availability and licensing.\",\"title\":\"Access differs by component\",\"type\":\"note\"},{\"id\":\"choose-a-tool\",\"text\":\"Start with an outcome\",\"type\":\"heading\"},{\"headers\":[\"You want to…\",\"Start with…\",\"Then keep…\"],\"rows\":[[\"Explore instruments and their sources\",\"Navigator or OrgMap\",\"Record identities, source references and dataset version.\"],[\"Document a recording session\",\"OrgRec\",\"Original takes, configuration and review decisions.\"],[\"Review photographed text\",\"Scriptor\",\"Source crops, raw transcription and corrections.\"],[\"Inspect a VAO package\",\"VAO CLI or a compatible viewer\",\"Package version, capabilities and verification result.\"],[\"Build a Unity or Blender workflow\",\"The corresponding VAO importer\",\"The importer version and the supported contract.\"],[\"Reuse an analytical corpus\",\"A fixed dataset or research collection\",\"Distribution, checksum and method.\"]],\"type\":\"table\"},{\"text\":\"These entry points serve different audiences. Public viewers offer immediate exploration. Desktop applications and importers require an appropriate local environment. The framework’s backend components organise research processing under controlled operation; they are not public upload endpoints that a visitor is expected to discover or configure.\",\"type\":\"p\"},{\"id\":\"three-versions\",\"text\":\"Read three versions separately\",\"type\":\"heading\"},{\"text\":\"A software version identifies an implementation, a standard version identifies a contract, and a data version identifies an input or object release. A demonstration may combine one of each. Write down all three when reporting a result or a problem: “the latest tool” is not enough to reproduce what happened.\",\"type\":\"p\"},{\"id\":\"demonstration-to-reuse\",\"text\":\"From a demonstration to reuse\",\"type\":\"heading\"},{\"text\":\"A demonstration shows a particular configuration working under particular conditions. Before adapting it, inspect the input assumptions, supported platform and documented output. This is especially important for research modules whose results need review, or whose scope is narrower than a familiar product label suggests. The directory’s expanded entries describe the practical role and the interpretation boundary together.\",\"type\":\"p\"},{\"items\":[{\"href\":\"/notebooks/software/processing/\",\"label\":\"A worked Processor workflow\"},{\"href\":\"/notebooks/software/clients/\",\"label\":\"Choose a VAO client\"}],\"type\":\"links\"}],\"intro\":\"The MODAVIS ecosystem separates research responsibilities while connecting the resulting evidence.\",\"slug\":\"introduction\",\"sources\":[{\"detail\":\"Musikinstrumente im virtuellen Raum, submitted 11 September 2026.\",\"href\":\"/notebooks/about/research/\",\"label\":\"About the doctoral research\"},{\"detail\":\"The recording application’s release record.\",\"href\":\"https://doi.org/10.5281/zenodo.22698744\",\"label\":\"OrgRec 0.3.2\"},{\"detail\":\"Research data, software and publications.\",\"href\":\"https://zenodo.org/communities/modavis/\",\"label\":\"MODAVIS on Zenodo\"}],\"title\":\"A tool for each part of the work\"},\"date\":\"2026-09-26\",\"edition\":\"2026-09-r3\",\"figures\":{}}",
  "payload": {
    "edition": "2026-09-r3",
    "date": "2026-09-26",
    "book": {
      "slug": "software",
      "title": "Tools & experiences",
      "number": "06"
    },
    "chapter": {
      "slug": "introduction",
      "title": "A tool for each part of the work",
      "intro": "The MODAVIS ecosystem separates research responsibilities while connecting the resulting evidence.",
      "blocks": [
        {
          "type": "links",
          "items": [
            {
              "label": "Explore the complete ecosystem",
              "href": "/notebooks/software/directory/",
              "detail": "57 entries · software, modules, standards and research collections"
            }
          ]
        },
        {
          "type": "links",
          "items": [
            {
              "label": "Open MODAVIS Navigator",
              "href": "https://navigator.modavis.org",
              "detail": "Explore instruments, sources and their relationships."
            },
            {
              "label": "OrgMap",
              "href": "https://map.modavis.org/",
              "detail": "Geographic access to organological data."
            },
            {
              "label": "vaoXR",
              "href": "https://vaoxr.modavis.org/",
              "detail": "Browser-based exploration of Virtual Acoustic Objects."
            },
            {
              "label": "OrgRec 0.3.2",
              "href": "https://doi.org/10.5281/zenodo.22698744",
              "detail": "The recording application’s release record."
            }
          ]
        },
        {
          "type": "heading",
          "text": "From fieldwork to publication",
          "id": "workflow"
        },
        {
          "type": "p",
          "text": "Recording, reconciliation, analysis and interactive presentation ask different things of a tool. MODAVIS treats them as connected stages with explicit inputs, outputs and responsibilities."
        },
        {
          "type": "p",
          "text": "Six core components organize the research workflow. Monitor and the musiXplora Bridge provide supporting capabilities. Twelve Processor modules and specialist applications handle particular transcription, analysis, modelling and presentation tasks."
        },
        {
          "type": "note",
          "title": "Access differs by component",
          "text": "A public interface, a software release record and a source repository are separate forms of access. Follow each resource’s own documentation for its availability and licensing."
        },
        {
          "type": "heading",
          "text": "Start with an outcome",
          "id": "choose-a-tool"
        },
        {
          "type": "table",
          "headers": [
            "You want to…",
            "Start with…",
            "Then keep…"
          ],
          "rows": [
            [
              "Explore instruments and their sources",
              "Navigator or OrgMap",
              "Record identities, source references and dataset version."
            ],
            [
              "Document a recording session",
              "OrgRec",
              "Original takes, configuration and review decisions."
            ],
            [
              "Review photographed text",
              "Scriptor",
              "Source crops, raw transcription and corrections."
            ],
            [
              "Inspect a VAO package",
              "VAO CLI or a compatible viewer",
              "Package version, capabilities and verification result."
            ],
            [
              "Build a Unity or Blender workflow",
              "The corresponding VAO importer",
              "The importer version and the supported contract."
            ],
            [
              "Reuse an analytical corpus",
              "A fixed dataset or research collection",
              "Distribution, checksum and method."
            ]
          ]
        },
        {
          "type": "p",
          "text": "These entry points serve different audiences. Public viewers offer immediate exploration. Desktop applications and importers require an appropriate local environment. The framework’s backend components organise research processing under controlled operation; they are not public upload endpoints that a visitor is expected to discover or configure."
        },
        {
          "type": "heading",
          "text": "Read three versions separately",
          "id": "three-versions"
        },
        {
          "type": "p",
          "text": "A software version identifies an implementation, a standard version identifies a contract, and a data version identifies an input or object release. A demonstration may combine one of each. Write down all three when reporting a result or a problem: “the latest tool” is not enough to reproduce what happened."
        },
        {
          "type": "heading",
          "text": "From a demonstration to reuse",
          "id": "demonstration-to-reuse"
        },
        {
          "type": "p",
          "text": "A demonstration shows a particular configuration working under particular conditions. Before adapting it, inspect the input assumptions, supported platform and documented output. This is especially important for research modules whose results need review, or whose scope is narrower than a familiar product label suggests. The directory’s expanded entries describe the practical role and the interpretation boundary together."
        },
        {
          "type": "links",
          "items": [
            {
              "label": "A worked Processor workflow",
              "href": "/notebooks/software/processing/"
            },
            {
              "label": "Choose a VAO client",
              "href": "/notebooks/software/clients/"
            }
          ]
        }
      ],
      "sources": [
        {
          "label": "About the doctoral research",
          "href": "/notebooks/about/research/",
          "detail": "Musikinstrumente im virtuellen Raum, submitted 11 September 2026."
        },
        {
          "label": "OrgRec 0.3.2",
          "href": "https://doi.org/10.5281/zenodo.22698744",
          "detail": "The recording application’s release record."
        },
        {
          "label": "MODAVIS on Zenodo",
          "href": "https://zenodo.org/communities/modavis/",
          "detail": "Research data, software and publications."
        }
      ]
    },
    "figures": {}
  }
}