{
  "title": "From acquired evidence to a reviewed result — Tools & experiences",
  "text": "MODAVIS (2026). From acquired evidence to a reviewed result — Tools & experiences. Research notebooks, September 2026 · expanded edition. https://modavis.org/editions/2026-09-r3/software/processing/",
  "bibtex": "@misc{modavis_software_processing_2026_09_r3,\n  author = {{MODAVIS}},\n  title = {From acquired evidence to a reviewed result — Tools & experiences},\n  year = {2026},\n  month = {09},\n  version = {2026-09-r3},\n  url = {https://modavis.org/editions/2026-09-r3/software/processing/},\n  note = {Content SHA-256: a56693238b6fd0b36c5eb215323f9b1804d4ba13e834efd21021cd3d538e9ee7}\n}",
  "url": "https://modavis.org/editions/2026-09-r3/software/processing/",
  "sha256": "a56693238b6fd0b36c5eb215323f9b1804d4ba13e834efd21021cd3d538e9ee7",
  "edition": "2026-09-r3",
  "date": "2026-09-26",
  "canonicalPayload": "{\"book\":{\"number\":\"06\",\"slug\":\"software\",\"title\":\"Tools & experiences\"},\"chapter\":{\"blocks\":[{\"text\":\"Processor work begins with identified evidence and ends with outputs whose status is explicit. Some modules prepare candidates, others perform bounded analyses, and controlled projection connects reviewed decisions to the canonical research view. The modules should not be read as twelve mandatory stages for every record.\",\"type\":\"p\"},{\"id\":\"processing-example\",\"text\":\"A source statement through the workflow\",\"type\":\"heading\"},{\"text\":\"Imagine an acquired document naming a workshop and a place. Ingestor first stages its transfer record. Document evidence can identify the relevant passage; language detection can provide a qualified language observation; Normalizer and Localizer can propose structured interpretations. The workflow retains the original wording and lets a reviewer distinguish an extracted string from a supported identity or geographic link. This is an illustrative workflow rather than a report of a particular processed document.\",\"type\":\"p\"},{\"headers\":[\"Module\",\"Input and useful output\"],\"rows\":[[\"Ingestor\",\"Acquired transfers → source-preserving staging with structural validation.\"],[\"Document evidence\",\"Identified documents → page assets, selectors and source-bound candidates.\"],[\"Language detection\",\"Text → detection and quality evidence, including abstention.\"],[\"Normalizer\",\"Staged observations → deterministic normalization and reconciliation proposals.\"],[\"Localizer\",\"Place mentions and provider evidence → ranked, qualified geographic proposals.\"],[\"Litparser\",\"Citation text → literature candidates with literal field evidence.\"],[\"Enrichment\",\"Authorized source requests → retained evidence and reviewable facts.\"],[\"PLENUM\",\"Claim-specific evidence → suitability, dependency and uncertainty assessments.\"],[\"Bootstrap\",\"Versioned policy and reviewed decisions → authorized projection receipts.\"]],\"type\":\"table\"},{\"id\":\"analytical-paths\",\"text\":\"Three specialist analytical paths\",\"type\":\"heading\"},{\"headers\":[\"Module\",\"Result\",\"Interpretation boundary\"],\"rows\":[[\"Ambitus\",\"Nominal pitch-range evidence from MusicXML, MXL or MIDI.\",\"Score or event content does not establish acoustic performance or instrument identity.\"],[\"Imageseg\",\"Aligned image masks and annotations.\",\"Class-agnostic segmentation needs interpretation before assigning organological meaning.\"],[\"Modelgenerator\",\"Photographic point clouds and camera paths.\",\"A supported reconstruction output does not guarantee a textured mesh or an acoustic model.\"]],\"type\":\"table\"},{\"id\":\"review-handoff\",\"text\":\"What a reviewable handoff contains\",\"type\":\"heading\"},{\"items\":[\"The fixed inputs and their source context.\",\"The operation, software state, parameters and any relevant model dependencies.\",\"The resulting observation or candidate, with uncertainty and limitations.\",\"A distinction between a successful computation and an accepted historical interpretation.\",\"The review decision and projection record when canonical data is affected.\"],\"type\":\"list\"},{\"text\":\"A module can execute successfully while producing an unresolved candidate. Conversely, a technical failure says nothing by itself about the historical truth of the source. Keeping execution status and interpretation status separate helps operators diagnose problems without silently changing the scholarly meaning of the record.\",\"type\":\"p\"},{\"id\":\"processor-status\",\"text\":\"Read the package status literally\",\"type\":\"heading\"},{\"text\":\"The cohesive Processor 0.2.0 package is described here as a development candidate. The public workflow demonstrations are separately versioned review material and do not establish that every current module or operational configuration has been released as a public service. Use the directory for dated availability and the demonstration deposit for the scope of that artifact.\",\"type\":\"p\"},{\"items\":[{\"href\":\"/notebooks/software/directory/#processor-modules\",\"label\":\"Processor modules in the directory\"},{\"href\":\"https://doi.org/10.5281/zenodo.22662664\",\"label\":\"Workflow demonstrations 0.1.1\"},{\"href\":\"/notebooks/ontologies/evidence/\",\"label\":\"Evidence and reviewed assertions\"}],\"type\":\"links\"}],\"intro\":\"A practical reading of the Processor’s twelve modules, organised around the decisions they support.\",\"slug\":\"processing\",\"sources\":[{\"href\":\"/notebooks/about/research/\",\"label\":\"Doctoral research and reference cases\"},{\"href\":\"https://doi.org/10.5281/zenodo.22662664\",\"label\":\"Research workflow demonstrations 0.1.1\"}],\"title\":\"From acquired evidence to a reviewed result\"},\"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": "processing",
      "title": "From acquired evidence to a reviewed result",
      "intro": "A practical reading of the Processor’s twelve modules, organised around the decisions they support.",
      "blocks": [
        {
          "type": "p",
          "text": "Processor work begins with identified evidence and ends with outputs whose status is explicit. Some modules prepare candidates, others perform bounded analyses, and controlled projection connects reviewed decisions to the canonical research view. The modules should not be read as twelve mandatory stages for every record."
        },
        {
          "type": "heading",
          "text": "A source statement through the workflow",
          "id": "processing-example"
        },
        {
          "type": "p",
          "text": "Imagine an acquired document naming a workshop and a place. Ingestor first stages its transfer record. Document evidence can identify the relevant passage; language detection can provide a qualified language observation; Normalizer and Localizer can propose structured interpretations. The workflow retains the original wording and lets a reviewer distinguish an extracted string from a supported identity or geographic link. This is an illustrative workflow rather than a report of a particular processed document."
        },
        {
          "type": "table",
          "headers": [
            "Module",
            "Input and useful output"
          ],
          "rows": [
            [
              "Ingestor",
              "Acquired transfers → source-preserving staging with structural validation."
            ],
            [
              "Document evidence",
              "Identified documents → page assets, selectors and source-bound candidates."
            ],
            [
              "Language detection",
              "Text → detection and quality evidence, including abstention."
            ],
            [
              "Normalizer",
              "Staged observations → deterministic normalization and reconciliation proposals."
            ],
            [
              "Localizer",
              "Place mentions and provider evidence → ranked, qualified geographic proposals."
            ],
            [
              "Litparser",
              "Citation text → literature candidates with literal field evidence."
            ],
            [
              "Enrichment",
              "Authorized source requests → retained evidence and reviewable facts."
            ],
            [
              "PLENUM",
              "Claim-specific evidence → suitability, dependency and uncertainty assessments."
            ],
            [
              "Bootstrap",
              "Versioned policy and reviewed decisions → authorized projection receipts."
            ]
          ]
        },
        {
          "type": "heading",
          "text": "Three specialist analytical paths",
          "id": "analytical-paths"
        },
        {
          "type": "table",
          "headers": [
            "Module",
            "Result",
            "Interpretation boundary"
          ],
          "rows": [
            [
              "Ambitus",
              "Nominal pitch-range evidence from MusicXML, MXL or MIDI.",
              "Score or event content does not establish acoustic performance or instrument identity."
            ],
            [
              "Imageseg",
              "Aligned image masks and annotations.",
              "Class-agnostic segmentation needs interpretation before assigning organological meaning."
            ],
            [
              "Modelgenerator",
              "Photographic point clouds and camera paths.",
              "A supported reconstruction output does not guarantee a textured mesh or an acoustic model."
            ]
          ]
        },
        {
          "type": "heading",
          "text": "What a reviewable handoff contains",
          "id": "review-handoff"
        },
        {
          "type": "list",
          "items": [
            "The fixed inputs and their source context.",
            "The operation, software state, parameters and any relevant model dependencies.",
            "The resulting observation or candidate, with uncertainty and limitations.",
            "A distinction between a successful computation and an accepted historical interpretation.",
            "The review decision and projection record when canonical data is affected."
          ]
        },
        {
          "type": "p",
          "text": "A module can execute successfully while producing an unresolved candidate. Conversely, a technical failure says nothing by itself about the historical truth of the source. Keeping execution status and interpretation status separate helps operators diagnose problems without silently changing the scholarly meaning of the record."
        },
        {
          "type": "heading",
          "text": "Read the package status literally",
          "id": "processor-status"
        },
        {
          "type": "p",
          "text": "The cohesive Processor 0.2.0 package is described here as a development candidate. The public workflow demonstrations are separately versioned review material and do not establish that every current module or operational configuration has been released as a public service. Use the directory for dated availability and the demonstration deposit for the scope of that artifact."
        },
        {
          "type": "links",
          "items": [
            {
              "label": "Processor modules in the directory",
              "href": "/notebooks/software/directory/#processor-modules"
            },
            {
              "label": "Workflow demonstrations 0.1.1",
              "href": "https://doi.org/10.5281/zenodo.22662664"
            },
            {
              "label": "Evidence and reviewed assertions",
              "href": "/notebooks/ontologies/evidence/"
            }
          ]
        }
      ],
      "sources": [
        {
          "label": "Doctoral research and reference cases",
          "href": "/notebooks/about/research/"
        },
        {
          "label": "Research workflow demonstrations 0.1.1",
          "href": "https://doi.org/10.5281/zenodo.22662664"
        }
      ]
    },
    "figures": {}
  }
}