{
  "generator": {
    "matra": "0.3.0",
    "udpipe_model": {
      "name": "english-ewt-ud-2.5-191206",
      "sha256": "784bd0fa85e3d831fd02a55290d0acfd05c953159dc38cc33d52e1b28add9957"
    }
  },
  "page": "explanation/situation-model.md",
  "paragraphs": [
    {
      "compression_ratio": null,
      "kind": "paragraph",
      "lexical_density": 0.5238,
      "readability_grade": 7.0081,
      "sentences": 3,
      "text": "matra reports the structure of text and measurements over it. Text goes in; a typed tree, a set of measures, and a set of ranked extractions come out. Everything it returns is a value your code can read, store, and reason over.",
      "words": 42
    },
    {
      "compression_ratio": null,
      "kind": "paragraph",
      "lexical_density": 0.3529,
      "readability_grade": 5.0779,
      "sentences": 2,
      "text": "It is a library, not an application. The analysis on top of it is yours to write.",
      "words": 17
    },
    {
      "compression_ratio": null,
      "kind": "paragraph",
      "lexical_density": 0.4688,
      "readability_grade": 4.1238,
      "sentences": 1,
      "text": "matra reports passive_ratio = 0.4. Whether 0.4 is too passive for the document at hand is your call, and the answer differs between a statute, a lab report, and a landing page.",
      "words": 32
    },
    {
      "compression_ratio": null,
      "kind": "paragraph",
      "lexical_density": 0.6667,
      "readability_grade": null,
      "sentences": 1,
      "text": "That split runs through every tier:",
      "words": 6
    },
    {
      "compression_ratio": null,
      "kind": "paragraph",
      "lexical_density": 0.4333,
      "readability_grade": 4.8133,
      "sentences": 2,
      "text": "The reason for the split is reuse. A judgment is fitted to one purpose and is dead weight to the next caller; the arc it was computed from is not.",
      "words": 30
    },
    {
      "compression_ratio": null,
      "kind": "paragraph",
      "lexical_density": 0.6667,
      "readability_grade": null,
      "sentences": 1,
      "text": "Upstream of interpretation, downstream of ingestion.",
      "words": 6
    },
    {
      "compression_ratio": 0.5677,
      "kind": "paragraph",
      "lexical_density": 0.5294,
      "readability_grade": 12.8129,
      "sentences": 3,
      "text": "Two properties make it usable that far downstream. Every value is serde-serializable, so the parse crosses into Python as a plain dict and can be stored as JSON. And every value has a place in the tree: a token id is scoped to its sentence, a sentence belongs to the paragraph whose text was parsed to produce it, and every heading, paragraph, sentence and token carries a span into the analysed text, so a value can be traced back to the bytes it came from.",
      "words": 86
    },
    {
      "compression_ratio": 0.5653,
      "kind": "paragraph",
      "lexical_density": 0.5816,
      "readability_grade": 9.4161,
      "sentences": 5,
      "text": "Nothing has to be set up first. Engine::new() in Rust, matra.Engine() in Python, and any matra command resolve where models live and fetch what is missing. The directory comes from an explicit argument if you pass one, else MATRA_MODEL_DIR, else the models subdirectory of the data root (MATRA_DATA_DIR, else $XDG_DATA_HOME/matra, else ~/.local/share/matra), with a non-empty ~/.matra/models from an older install used when the new location does not exist yet. The config file does not move the model directory, and it does not choose the parsing model, which is pinned in the source. Programming model has the resolution order.",
      "words": 103
    },
    {
      "compression_ratio": 0.5313,
      "kind": "paragraph",
      "lexical_density": 0.5789,
      "readability_grade": 11.9421,
      "sentences": 5,
      "text": "Models are fetched, not bundled, and only against a pinned digest. The UDPipe English model arrives on the first call to Engine::new or Engine::from_config, in Rust or in Python; the reference embedding model arrives on the first call to Model2Vec::potion_base_8m or Model2Vec::from_config. Both fetch from URLs written in the source and load nothing whose SHA-256 does not equal a constant written beside them. A download that fails verification is fetched once more, in memory, and a second failed download raises without anything having been written. Exactly one artifact set can arrive this way for each.",
      "words": 99
    },
    {
      "compression_ratio": 0.6335,
      "kind": "paragraph",
      "lexical_density": 0.5,
      "readability_grade": 7.812,
      "sentences": 4,
      "text": "Bringing your own embedding model is a first-class path. Model2Vec::from_dir loads what you supply and touches no network, whatever the directory holds. The parsing model is a pin. For those, the digest is identity rather than proof: it says which artifacts produced a value, not that they are the ones you meant to fetch.",
      "words": 55
    },
    {
      "compression_ratio": null,
      "kind": "paragraph",
      "lexical_density": 0.5556,
      "readability_grade": 5.8385,
      "sentences": 3,
      "text": "Verification and load share one read. Bytes are hashed in memory and the model is loaded from those same bytes. Nothing re-reads the disk between the two.",
      "words": 27
    },
    {
      "compression_ratio": null,
      "kind": "paragraph",
      "lexical_density": 0.5385,
      "readability_grade": 10.3569,
      "sentences": 1,
      "text": "Those pinned model fetches are the only network access anywhere in the library.",
      "words": 13
    },
    {
      "compression_ratio": null,
      "kind": "paragraph",
      "lexical_density": 0.5263,
      "readability_grade": 8.2779,
      "sentences": 2,
      "text": "The primitive fields from the table above, as matra fills them for five short sentences written to carry one each. Every mark is a construction in the tree; whether it matters for a text stays with the reader.",
      "words": 38
    }
  ]
}
