Add the data annotation body (spec 18.8)
A data body says what kind of data a table, figure panel or passage presents: one of fifteen kinds, the dataset that holds the values, what each field measures (with the dataset's own unit) and the molecules and sequences it is about, by the identities of structure and sequence bodies. Where the values came from stays the dataset's origin. - spec/18 section 18.8, the body in annotation.schema.json, 'data' in the store's body_kind CHECK, five terms in the JSON-LD context. - paperspec.data.problems and the rules layer.data.type, layer.data.quantity, layer.data.subject and layer.data.dataset. Units are compared as strings with the dataset's; no unit library is needed. - fixtures/records/data/ (three annotations on the main example) and vectors/data.jsonl (35 cases); paperspec check covers both, and the determinism rebuild matches. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01B8cL4zN4XpaQF5cBtASzfq
This commit is contained in:
25 files changed
+670
-33
No files matched your search
@@ -121,3 +121,17 @@ It is a minor change in the sense of [spec/00](spec/00-introduction.md): two new
|
||||
The example project holds the two layers, which changes `project.json`.
|
||||
The draft gains a last sentence, which the biology layer is about, so the draft package, its draft IDs and the one traces vector that anchors its paragraph change; the traces layer's anchors, its receipt and every other vector are as they were.
|
||||
- The prose check's UK spelling pattern no longer takes `organism` for a form of `organise`.
|
||||
|
||||
One more, asked for by paperdata, which finds data by its kind and by the molecules and sequences it is about.
|
||||
It is a minor change in the sense of [spec/00](spec/00-introduction.md): one new body kind, optional properties and four rules, with no valid file made invalid and no computed value changed; the other layers, the traces and every receipt are as they were.
|
||||
|
||||
- Data ([spec/18 §18.8](spec/18-layers.md#188-data), `annotation.schema.json`): a `data` body says what kind of data a span presents, with a `data_type` from a fixed list of fifteen, a `role` (`reports` or `uses`), the `dataset` that holds the values, the `quantities` its fields measure (a field, a name and the dataset's unit), the `subjects` it is about (the identities of `structure` and `sequence` bodies), a `method`, a `label` and outside `accessions`, so that a term of an ontology can say more than the list does.
|
||||
A dataset's `origin` already says whether its values were reported, digitized, computed or measured, so the body does not.
|
||||
- `paperspec.data` and the rules `layer.data.type`, `layer.data.quantity`, `layer.data.subject` and `layer.data.dataset` ([spec/22 §22.4](spec/22-conformance.md#224-rules)).
|
||||
`data.problems` compares a quantity's unit with its dataset's as a string and parses no unit; a producer with a unit library SHOULD also check that each unit parses and has the dimension its quantity needs.
|
||||
- `body_kind` of the store's `annotations` table takes `data` ([sql/store.sql](sql/store.sql)).
|
||||
A store made before this change has the old CHECK, so a consumer migrates it by rebuilding the table; the table's columns do not change.
|
||||
- The JSON-LD context gains five terms: `data_type`, `dataset`, `method`, and `quantities` and `subjects` as JSON literals.
|
||||
- `fixtures/records/data/`, on the main example, with `vectors/data.jsonl` (35 cases): a valid case for each kind of data, annotations that break no rule and one or more that break each.
|
||||
The layer ties the caption of Table 1 to its dataset as force-field parameters for ethane, water and the CT–CT pattern, the caption of Figure 1a to the dataset read from it as an energy profile of ethane, and the sentence that introduces Table 1 to the same dataset as a model's proposal.
|
||||
The example project holds the layer, which changes `project.json`; no other fixture or vector changes.
|
||||
Reference in new issue
Block a user