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.
|
||||
+13
-5
@@ -57,14 +57,14 @@ This context defines `kind`, `status`, `audience`, `AnchorSelector` and `anchor`
|
||||
|
||||
## What it defines
|
||||
|
||||
The file defines 36 terms.
|
||||
Thirty-five map to IRIs under `https://paperspec.scient.ing/vocab#`: `format`, `kind`, `status`, `receipt`, `layer`, `audience`, `visibility`, `purpose`, `project`, `docs`, `pin`, `role`, `symbol`, `key`, `verdict`, `reason`, `reference`, `note`, `proposer`, `identity`, `written`, `alphabet`, `organism`, `start`, `accessions`, `terms`, `regions`, `variants`, `for`, `category`, `generator`, `exercise`, `anchor`, `rights_use` and the class `AnchorSelector`.
|
||||
Six are renamed: `key`, the key of a `symbol` body's symbol, is `sct:symbolKey`, `for` is `sct:questionFor`, `generator` is `sct:generatedBy`, `proposer`, the tool that found a trace, is `sct:proposedBy`, `terms`, the force-field terms of a structure, is `sct:structureTerms`, and `rights_use` is `sct:rightsUse`.
|
||||
The thirty-sixth, `total`, maps to `totalItems` in the ActivityStreams namespace.
|
||||
The file defines 41 terms.
|
||||
Forty map to IRIs under `https://paperspec.scient.ing/vocab#`: `format`, `kind`, `status`, `receipt`, `layer`, `audience`, `visibility`, `purpose`, `project`, `docs`, `pin`, `role`, `symbol`, `key`, `verdict`, `reason`, `reference`, `note`, `proposer`, `identity`, `written`, `alphabet`, `organism`, `start`, `accessions`, `terms`, `regions`, `variants`, `data_type`, `dataset`, `method`, `quantities`, `subjects`, `for`, `category`, `generator`, `exercise`, `anchor`, `rights_use` and the class `AnchorSelector`.
|
||||
Seven are renamed: `key`, the key of a `symbol` body's symbol, is `sct:symbolKey`, `for` is `sct:questionFor`, `generator` is `sct:generatedBy`, `proposer`, the tool that found a trace, is `sct:proposedBy`, `terms`, the force-field terms of a structure, is `sct:structureTerms`, `data_type`, the kind of data a `data` body names, is `sct:dataType`, and `rights_use` is `sct:rightsUse`.
|
||||
The forty-first, `total`, maps to `totalItems` in the ActivityStreams namespace.
|
||||
Two terms carry a type rule.
|
||||
A processor reads `layer` as an IRI, and it always reads `docs` as a set, so a one-element list stays a list.
|
||||
|
||||
The file declares `anchor`, `exercise`, `proposer`, `accessions`, `terms`, `regions` and `variants` as JSON literals (`"@type": "@json"`, a JSON-LD 1.1 feature, which is why the file sets `"@version": 1.1`).
|
||||
The file declares `anchor`, `exercise`, `proposer`, `accessions`, `terms`, `regions`, `variants`, `quantities` and `subjects` as JSON literals (`"@type": "@json"`, a JSON-LD 1.1 feature, which is why the file sets `"@version": 1.1`).
|
||||
A JSON-LD processor then keeps a `scienting-anchor/1` record intact instead of expanding it.
|
||||
An anchor holds hashes (fixed-length fingerprints of text) and a `span`, a pair of character offsets whose order carries meaning.
|
||||
Expansion would drop the anchor's unmapped field names ([JSON-LD 1.1 API, expansion step 13.3](https://www.w3.org/TR/json-ld11-api/#alg-expand-each-key-value)) and would give its arrays no order ([JSON-LD 1.1 §4.3](https://www.w3.org/TR/json-ld11/#sets-and-lists)).
|
||||
@@ -105,6 +105,14 @@ Both are text bodies, so the Web Annotation context supplies `value` and this on
|
||||
`terms` maps to `sct:structureTerms`, because the word alone is too general for a vocabulary that other kinds of body may join.
|
||||
[`fixtures/records/chemistry/annotations.jsonl`](../fixtures/records/chemistry/annotations.jsonl) and [`fixtures/records/biology/annotations.jsonl`](../fixtures/records/biology/annotations.jsonl) hold four structures on the example paper and three sequences on the draft.
|
||||
|
||||
## Bodies that hold data
|
||||
|
||||
A `data` body ([spec/18 §18.8](../spec/18-layers.md#188-data)) says what kind of data a table, a figure panel or a passage presents and what it is about.
|
||||
It is a text body, so the Web Annotation context supplies `value`, and this one adds `data_type`, `dataset` and `method`.
|
||||
`data_type` maps to `sct:dataType`, as `rights_use` maps to `sct:rightsUse`.
|
||||
`quantities` and `subjects` are lists of objects, so the context declares them JSON literals, as it does `accessions`, and a processor keeps them whole.
|
||||
[`fixtures/records/data/annotations.jsonl`](../fixtures/records/data/annotations.jsonl) holds three on the example paper.
|
||||
|
||||
## Using the context
|
||||
|
||||
- Writer: Put both URLs (web addresses), in the order shown, in `@context` of `layer.json` and of every line of `annotations.jsonl`. [Chapter 18](../spec/18-layers.md) defines layers (§18.2), annotations (§18.3) and bodies (§18.4).
|
||||
|
||||
@@ -51,6 +51,17 @@
|
||||
"@id": "sct:variants",
|
||||
"@type": "@json"
|
||||
},
|
||||
"data_type": "sct:dataType",
|
||||
"dataset": "sct:dataset",
|
||||
"method": "sct:method",
|
||||
"quantities": {
|
||||
"@id": "sct:quantities",
|
||||
"@type": "@json"
|
||||
},
|
||||
"subjects": {
|
||||
"@id": "sct:subjects",
|
||||
"@type": "@json"
|
||||
},
|
||||
"for": "sct:questionFor",
|
||||
"category": "sct:category",
|
||||
"generator": "sct:generatedBy",
|
||||
|
||||
+1
-1
@@ -428,7 +428,7 @@ Keep using it as a reading and distribution format.
|
||||
*Status.*
|
||||
The specification is version 0.1.0.
|
||||
`registry/formats.json` lists 32 formats: 19 are `candidate` (complete, with vectors and fixtures, ready to implement) and 13 are `provisional` (complete; expected to change as implementations gain experience): project, bundle, dataset, digitization, view, snapshot, draft-ids, exercise, submission, grade, checklist, log-entry and checkpoint ([spec/00 §0.4](../spec/00-introduction.md#04-status)).
|
||||
The repository holds 24 chapters, 43 JSON Schemas, 28 vector files, five valid fixture packages, one of them also zipped, and 31 invalid ones, each naming the rule it breaks, and a reference checker, `paperspec check`.
|
||||
The repository holds 24 chapters, 43 JSON Schemas, 29 vector files, five valid fixture packages, one of them also zipped, and 31 invalid ones, each naming the rule it breaks, and a reference checker, `paperspec check`.
|
||||
Licenses: prose CC BY 4.0; schemas, SQL, the JSON-LD context, registries, vectors and fixtures CC0 1.0; the code in `src/` Apache-2.0 ([README.md](../README.md#licenses)).
|
||||
|
||||
*No adoption claim.*
|
||||
|
||||
+4
-1
@@ -383,8 +383,11 @@ Nothing finds a molecule in free text, so a person ties each one by hand and the
|
||||
A structure is a SMILES for a molecule or a SMARTS for a group, a fragment with open positions (`R-OH`) or a pattern of atom types, and it may carry the bonds, angles and torsions the paper gives force-field constants for, citing atoms by their numbers in the text.
|
||||
A sequence has an alphabet, an optional numbering that starts where the fragment does, regions and variants checked against the residues.
|
||||
Both carry an `identity` that finds the same structure or sequence however it was written.
|
||||
A `data` annotation says what kind of data a table, a figure panel or a passage presents, from a fixed list of fifteen kinds such as `binding-affinity`, `energy-profile` or `force-field-parameters`.
|
||||
It names the dataset that holds the values, what each of its fields measures with the dataset's own unit, and the molecules and sequences the data is about by their identities, so data can be found by its kind and by its subject.
|
||||
A kind that the list lacks is carried by an outside term in `accessions`, and where the values came from stays the dataset's `origin`.
|
||||
Layers are `candidate`.
|
||||
Pinned by the layer records in `fixtures/records/layer/`, `traces/`, `chemistry/` and `biology/`, and by [vectors/traces.jsonl](../vectors/traces.jsonl), [vectors/structures.jsonl](../vectors/structures.jsonl) and [vectors/sequences.jsonl](../vectors/sequences.jsonl).
|
||||
Pinned by the layer records in `fixtures/records/layer/`, `traces/`, `chemistry/`, `biology/` and `data/`, and by [vectors/traces.jsonl](../vectors/traces.jsonl), [vectors/structures.jsonl](../vectors/structures.jsonl), [vectors/sequences.jsonl](../vectors/sequences.jsonl) and [vectors/data.jsonl](../vectors/data.jsonl).
|
||||
See [chapter 18](../spec/18-layers.md).
|
||||
|
||||
## Exercises
|
||||
|
||||
@@ -280,6 +280,51 @@ The identity finds the same thing however it was written: the name a model propo
|
||||
The last line is the rule that lets a term cite atoms without a chemistry toolkit: `O([H])[H]` writes three atoms, numbered from 0 as it writes them, and the oxygen (0) is bonded to each hydrogen (1 and 2) and the hydrogens are not bonded to each other, so a bond term on atoms 1 and 2, or an angle on atoms 0, 1 and 2, is refused.
|
||||
[vectors/structures.jsonl](../vectors/structures.jsonl) and [vectors/sequences.jsonl](../vectors/sequences.jsonl) show every rule broken.
|
||||
|
||||
## Find data by its kind and by what it is about
|
||||
|
||||
This shows how a table or a figure panel is tagged with the kind of data it presents, and how that tag is checked against the dataset and found by a molecule.
|
||||
A `data` annotation names the dataset that holds the values, the quantities its fields measure, and the molecules and sequences it is about by the identities that `structure` and `sequence` annotations carry ([chapter 18](../spec/18-layers.md#188-data)).
|
||||
`paperspec.data` checks an annotation against the rules, and against the dataset's descriptor when it is given one, with the standard library alone:
|
||||
|
||||
```python
|
||||
import json
|
||||
from paperspec import data
|
||||
|
||||
descriptors = {}
|
||||
for folder in ("fixtures/packages/hale2026harmonic-damb/datasets/ds-hale-bond-params",
|
||||
"fixtures/records/datasets/ds-hale-ctct-scan"):
|
||||
with open(folder + "/datapackage.json", encoding="utf-8") as f:
|
||||
d = json.load(f)
|
||||
descriptors[d["id"]] = d
|
||||
|
||||
annotations = [json.loads(line) for line in open("fixtures/records/data/annotations.jsonl", encoding="utf-8")]
|
||||
for a in annotations:
|
||||
b = a["body"]
|
||||
quote = a["target"]["selector"][1]["exact"]
|
||||
about = [s["label"] for s in b.get("subjects", [])]
|
||||
print(a["status"], b["role"], b["data_type"], b.get("dataset"), repr(quote), about,
|
||||
data.problems(a, descriptors.get(b.get("dataset"))))
|
||||
|
||||
ethane = "OTMSDBZUPAUEDD-UHFFFAOYSA-N"
|
||||
for a in annotations:
|
||||
b = a["body"]
|
||||
if b["data_type"] == "force-field-parameters" and any(s["identity"] == ethane for s in b.get("subjects", [])):
|
||||
print([(q["name"], q["unit"]) for q in b["quantities"]])
|
||||
```
|
||||
|
||||
```text
|
||||
confirmed reports force-field-parameters ds-hale-bond-params 'Fitted harmonic bond parameters.' ['ethane', 'water', 'CT–CT'] []
|
||||
confirmed reports energy-profile ds-hale-ctct-scan '(a) The scan.' ['ethane'] []
|
||||
proposed uses force-field-parameters ds-hale-bond-params 'Table 1 lists the fitted constants for both parameter sets.' [] []
|
||||
[('harmonic bond force constant', 'kcal / mol / angstrom ** 2'), ('equilibrium bond length', 'angstrom')]
|
||||
```
|
||||
|
||||
Each of the first three lines gives the annotation's status, what its span does with the data, the kind, the dataset, the words, the subjects and the rules it breaks, none here.
|
||||
The caption of Table 1 and the sentence that introduces it lead to one dataset: the caption `reports` it, and the sentence `uses` it and is a model's proposal that a person has not yet confirmed.
|
||||
The subjects are the identities of the chemistry layer, so a search for force-field parameters about ethane, the last line, finds the table by the molecule and not by the word, and gives the units as the dataset spells them.
|
||||
The unit is compared as a string and never parsed, so a checker that wants to know that `kcal / mol / angstrom ** 2` is a force constant needs a unit library of its own.
|
||||
[vectors/data.jsonl](../vectors/data.jsonl) shows every rule broken, among them a quantity whose unit is not its dataset's.
|
||||
|
||||
## Test your implementation against a vector
|
||||
|
||||
A test vector is a recorded input together with the output every correct implementation must produce.
|
||||
|
||||
+1
-1
@@ -107,7 +107,7 @@ A `candidate` format is complete, with vectors and fixtures, and ready to implem
|
||||
A `provisional` one is complete and expected to change as implementations gain experience.
|
||||
The provisional formats are dataset, digitization, view, project, bundle, snapshot, draft-ids, exercise, submission, grade, checklist, log-entry and checkpoint.
|
||||
|
||||
The repository holds a reference checker (`paperspec check`), 28 vector files, five valid packages, one of them also as a zip, and 31 deliberately broken packages ([spec/00 §0.4](../spec/00-introduction.md#04-status), [spec/22](../spec/22-conformance.md)).
|
||||
The repository holds a reference checker (`paperspec check`), 29 vector files, five valid packages, one of them also as a zip, and 31 deliberately broken packages ([spec/00 §0.4](../spec/00-introduction.md#04-status), [spec/22](../spec/22-conformance.md)).
|
||||
|
||||
## What does it not do?
|
||||
|
||||
|
||||
@@ -44,6 +44,10 @@ Format `scienting-checkpoint/1`, `provisional`. ([23.2](../spec/23-log.md#232-ch
|
||||
Correction
|
||||
: An operation on an established document, with its evidence and author; never edited, only appended. ([11](../spec/11-corrections.md))
|
||||
|
||||
Data
|
||||
: What kind of data a table, a figure panel or a passage presents, tied to its words by a `data` annotation: one of fifteen kinds, the dataset that holds the values, what each field measures and the molecules and sequences it is about.
|
||||
The kind is one reader's reading and a model's stays `proposed`; where the values came from is the dataset's `origin`. ([18.8](../spec/18-layers.md#188-data))
|
||||
|
||||
Description
|
||||
: An annotation that describes a figure, panel or table for readers who cannot see it, as a short text equivalent (`alt`) or a full description (`long`); an accessible export uses confirmed descriptions only. ([18.4](../spec/18-layers.md#184-bodies))
|
||||
|
||||
|
||||
+1
-1
@@ -56,7 +56,7 @@ It appears inside hashed data and test vectors, and it is separate from the repo
|
||||
| [registry/](../registry/README.md) | The list of formats, the rule IDs a checker reports, download-stamp rules, and default rights requirements. |
|
||||
| [tools/](../tools/README.md) | How to run the reference commands: `paperspec check` checks everything, `paperspec build` rebuilds the fixtures and vectors, and `paperspec load` loads packages into SQLite. |
|
||||
| [src/paperspec/](../src/paperspec/) | The oracle, a compact implementation of every rule, which the other repositories of the project install as the Python package `paperspec`. |
|
||||
| [vectors/](../vectors/README.md) | 28 files of test vectors: inputs and the exact outputs every implementation must compute. |
|
||||
| [vectors/](../vectors/README.md) | 29 files of test vectors: inputs and the exact outputs every implementation must compute. |
|
||||
| [fixtures/](../fixtures/README.md) | Five valid example packages, one of them also as a zip, 31 deliberately broken ones that each break one named rule, example records, and the test keys that signed them. All text is synthetic. |
|
||||
| [sql/](../sql/README.md) | Tables for SQLite, Dolt and PostgreSQL, and a SQLite bundle with full-text search. |
|
||||
| [context/](../context/README.md) | The JSON-LD context that makes annotation layers W3C Web Annotations. |
|
||||
|
||||
@@ -51,6 +51,7 @@ Each record is a single file, or a folder where a format needs several files.
|
||||
| `traces/` | A layer of traced citations on the Typst draft, which cites the main example (`layer.json`, `annotations.jsonl`, `receipt.json`): a trace a model proposed from the draft's citation of "a two-step fit" to the abstract of the main example and a person confirmed, with its receipt; a second candidate, the introduction's sentence, that a person rejected; a person's trace of the same sentence to Table 1; and a person's reply that disputes the first ([spec/18 §18.5](../spec/18-layers.md#185-traced-citations)). `vectors/traces.jsonl` resolves them after corrections. |
|
||||
| `chemistry/` | A layer of chemical structures on the main example (`layer.json`, `annotations.jsonl`, `receipt.json`): ethane, named in the methods and confirmed; water, named by a model and still `proposed`; the CT–CT pattern of Table 1, a SMARTS with the bond constants of both parameter sets as terms; and water again as a SMILES that writes its hydrogens, with the OW–HW bond constants. The two writings of water share an InChIKey ([spec/18 §18.6](../spec/18-layers.md#186-chemical-structures)). `vectors/structures.jsonl` pins the rules. |
|
||||
| `biology/` | A layer of sequences on the Typst draft (`layer.json`, `annotations.jsonl`, `receipt.json`): the villin headpiece subdomain HP35, named by the words that name it, shown by the sequence the sentence prints, with its three helices as regions, and its N68H variant as a variant a model proposed ([spec/18 §18.7](../spec/18-layers.md#187-sequences)). The residues are numbered 42 to 76, as the headpiece is. `vectors/sequences.jsonl` pins the rules. |
|
||||
| `data/` | A layer of data on the main example (`layer.json`, `annotations.jsonl`, `receipt.json`): the caption of Table 1, confirmed, tied to `ds-hale-bond-params` as force-field parameters for ethane, water and the CT–CT pattern, with the force constant and the equilibrium length as its quantities; the caption of Figure 1a, confirmed, tied to `ds-hale-ctct-scan` as an energy profile of ethane; and the sentence that introduces Table 1, tied to the first dataset by a model and still `proposed` ([spec/18 §18.8](../spec/18-layers.md#188-data)). The subjects are the identities of the chemistry layer, and the units are the datasets' own. `vectors/data.jsonl` pins the rules. |
|
||||
| `submissions/`, `grades/` | A student's answers to exercises in the layer, and the grader's result for each. |
|
||||
| `suspect.json` | A doubtful reading raised for review: the converter's reading of an exponent in the main example, before the first correction answered it. |
|
||||
| `qa-report.json` | Reviewer error bounds for a delivery that covers two of the main example's receipts, signed by the team's owner key. |
|
||||
|
||||
@@ -0,0 +1,3 @@
|
||||
{"@context":["http://www.w3.org/ns/anno.jsonld","https://paperspec.scient.ing/context/scienting-1.jsonld"],"body":{"data_type":"force-field-parameters","dataset":"ds-hale-bond-params","kind":"data","label":"bond parameters","method":"scanned in steps of 0.01 Å, energies fitted by least squares","quantities":[{"field":"k_r","name":"harmonic bond force constant","unit":"kcal / mol / angstrom ** 2"},{"field":"r_eq","name":"equilibrium bond length","unit":"angstrom"}],"role":"reports","subjects":[{"identity":"OTMSDBZUPAUEDD-UHFFFAOYSA-N","kind":"structure","label":"ethane"},{"identity":"XLYOFNOQVPJJNP-UHFFFAOYSA-N","kind":"structure","label":"water"},{"identity":"smarts:2e2a923f840c","kind":"structure","label":"CT–CT"}],"type":"TextualBody","value":"Harmonic bond constants for CT–CT, CT–HC and OW–HW, in two parameter sets"},"created":"2026-10-14T09:00:00Z","creator":{"id":"tag:scient.ing,2026:key:ana","name":"Ana Example","type":"Person"},"id":"tag:scient.ing,2026:annotation:smithlab/c4648hbwpavgp","layer":"tag:scient.ing,2026:layer:smithlab/dt9n2k5y","motivation":"classifying","receipt":"v84xfyx5n1wg4","status":"confirmed","target":{"selector":[{"anchor":{"doc":"hale2026harmonic-damb","format":"scienting-anchor/1","kind":"sentence","node":"wxxhb3s","node_hash":"52063ded5cf76abdd32ba5c1d0d5d7348843eb0516ad29f5b1f249964e015b50","own_hash":"506d3bd0afffb1dff34f1563338d538c85be50434905c86784a94b747f979bc3","quote":{"exact":"Fitted harmonic bond parameters."},"rev":12,"store":"smithlab"},"type":"AnchorSelector"},{"exact":"Fitted harmonic bond parameters.","prefix":"","suffix":"","type":"TextQuoteSelector"}],"source":"tag:scient.ing,2026:doc:smithlab/hale2026harmonic-damb","type":"SpecificResource"},"type":"Annotation"}
|
||||
{"@context":["http://www.w3.org/ns/anno.jsonld","https://paperspec.scient.ing/context/scienting-1.jsonld"],"body":{"data_type":"energy-profile","dataset":"ds-hale-ctct-scan","kind":"data","label":"CT–CT scan","method":"scanned in steps of 0.01 Å around the minimum","quantities":[{"field":"r","name":"C–C bond length","unit":"angstrom"},{"field":"e","name":"energy","unit":"kcal / mol"}],"role":"reports","subjects":[{"identity":"OTMSDBZUPAUEDD-UHFFFAOYSA-N","kind":"structure","label":"ethane"}],"type":"TextualBody","value":"Energy along the C–C stretch of ethane"},"created":"2026-10-14T09:05:00Z","creator":{"id":"tag:scient.ing,2026:key:ana","name":"Ana Example","type":"Person"},"id":"tag:scient.ing,2026:annotation:smithlab/d3b924s8ve538","layer":"tag:scient.ing,2026:layer:smithlab/dt9n2k5y","motivation":"classifying","receipt":"v84xfyx5n1wg4","status":"confirmed","target":{"selector":[{"anchor":{"doc":"hale2026harmonic-damb","format":"scienting-anchor/1","kind":"sentence","node":"caehhp6","node_hash":"9f9c9a412cd08d0634daa3f23c63f5125c1270c13834c45c045c1a9a7452af86","own_hash":"75a68ec1ba13ad2d3fb7ef61634103b8740eb98494ca8fb607a3429f464ed278","quote":{"exact":"(a) The scan."},"rev":12,"store":"smithlab"},"type":"AnchorSelector"},{"exact":"(a) The scan.","prefix":"","suffix":"","type":"TextQuoteSelector"}],"source":"tag:scient.ing,2026:doc:smithlab/hale2026harmonic-damb","type":"SpecificResource"},"type":"Annotation"}
|
||||
{"@context":["http://www.w3.org/ns/anno.jsonld","https://paperspec.scient.ing/context/scienting-1.jsonld"],"body":{"data_type":"force-field-parameters","dataset":"ds-hale-bond-params","kind":"data","role":"uses","type":"TextualBody","value":"The fitted bond constants of Table 1, which this sentence introduces"},"created":"2026-10-14T09:10:00Z","creator":{"id":"tag:scient.ing,2026:software:example-model","name":"A model (illustrative)","type":"Software"},"id":"tag:scient.ing,2026:annotation:smithlab/j4c41y21r5a8f","layer":"tag:scient.ing,2026:layer:smithlab/dt9n2k5y","motivation":"classifying","status":"proposed","target":{"selector":[{"anchor":{"doc":"hale2026harmonic-damb","format":"scienting-anchor/1","kind":"sentence","node":"a4jrz2t","node_hash":"f64c6a5040f9c773d5ac4e559b58465aeae30bba79a82fc38b14ac7b61826ba8","own_hash":"dde95db22e0600c8e6da72dd6701436315a786655cb74fc313a4bf574c9356ee","quote":{"exact":"Table 1 lists the fitted constants for both parameter sets."},"rev":12,"store":"smithlab"},"type":"AnchorSelector"},{"exact":"Table 1 lists the fitted constants for both parameter sets.","prefix":"","suffix":"","type":"TextQuoteSelector"}],"source":"tag:scient.ing,2026:doc:smithlab/hale2026harmonic-damb","type":"SpecificResource"},"type":"Annotation"}
|
||||
@@ -0,0 +1 @@
|
||||
{"@context":["http://www.w3.org/ns/anno.jsonld","https://paperspec.scient.ing/context/scienting-1.jsonld"],"audience":"expert","created":"2026-10-14T09:00:00Z","creator":{"id":"tag:scient.ing,2026:key:ana","name":"Ana Example","type":"Person"},"docs":["smithlab/hale2026harmonic-damb"],"format":"scienting-layer/1","id":"tag:scient.ing,2026:layer:smithlab/dt9n2k5y","label":"Data in Hale and Osei","license":{"spdx":"CC-BY-4.0"},"project":"smithlab-charges","purpose":"What kind of data the paper's table and figure present, and what they are about.","total":3,"type":"AnnotationCollection","visibility":"team"}
|
||||
@@ -0,0 +1 @@
|
||||
{"at":"2026-10-14T09:30:00Z","by":"ana","doc":"hale2026harmonic-damb","evidence":[],"format":"scienting-receipt/1","id":"v84xfyx5n1wg4","level":"F3","nodes":[],"records":[["annotation","c4648hbwpavgp","c455aa6956e11ec8fcad44e525ef1029f9c7670218a912fb634fe55aea5d0c74"],["annotation","d3b924s8ve538","81aae04ef8ad507462eca1626ae43c40670d074e053edf2759743b5583e642bf"]],"rev":12,"root":"159ca32cd0673a86388ceaa593216665e942a4aaf31094e9996d34efd9f60812","scope":"targeted:data","signature":{"key":"ana","scheme":"ed25519","value":"FQxsuXHOeBz/Dfjcf5YitIvnRKyrgI64eRgHtJYC2dxZC97wlp563dzbLu85l5vogwIkh4rJfFBaMu3RbsGCCA=="}}
|
||||
@@ -1 +1 @@
|
||||
{"claims":{"paperclaim":"amber"},"datasets":["ds-hale-bond-params","ds-hale-ctct-scan"],"documents":[{"doc":"smithlab/hale2026harmonic-damb","reason":"The bond constants we start from.","status":{"Ben Example":"read","Cara Example":"reading"},"tags":["parameters"]},{"doc":"okafor2025solvent-acth","reason":"Solvent shifts for the validation set.","tags":["spectra"]}],"drafts":["smithlab/writer2027fixed-ynr7.v3"],"format":"scienting-project/1","key":"smithlab-charges","layers":["tag:scient.ing,2026:layer:smithlab/kp4m2x7q","tag:scient.ing,2026:layer:smithlab/tr6c3q8m","tag:scient.ing,2026:layer:smithlab/cm7h4p2x","tag:scient.ing,2026:layer:smithlab/bq5k8r3w"],"members":[{"keys":["ana"],"person":"Ana Example","role":"owner"},{"keys":["ben","ben-spot"],"person":"Ben Example","role":"editor"},{"keys":["cara"],"person":"Cara Example","role":"reader"}],"name":"Charges and bonds","paths":[{"id":"onboarding","steps":[{"note":"Read the introduction.","ref":"smithlab/hale2026harmonic-damb","type":"document"},{"note":"Then the table.","ref":"smithlab/hale2026harmonic-damb#hj4s7pb","type":"node"},{"note":"The bond force constant, amber/k-bond.","ref":"claim:272XTX7C","type":"claim"}],"title":"First week"}],"settings":{"digit_rule":"anchored-sections","drift_threshold":"0.25","log":{"origin":"scient.ing/log/smithlab","threshold":1,"witnesses":["wit"]},"rights_unknown":"refuse","spot_check":{"minimum":10,"rate":"0.05"},"stages":"scienting-stages-default"},"store":"smithlab","views":["ctct-scan"]}
|
||||
{"claims":{"paperclaim":"amber"},"datasets":["ds-hale-bond-params","ds-hale-ctct-scan"],"documents":[{"doc":"smithlab/hale2026harmonic-damb","reason":"The bond constants we start from.","status":{"Ben Example":"read","Cara Example":"reading"},"tags":["parameters"]},{"doc":"okafor2025solvent-acth","reason":"Solvent shifts for the validation set.","tags":["spectra"]}],"drafts":["smithlab/writer2027fixed-ynr7.v3"],"format":"scienting-project/1","key":"smithlab-charges","layers":["tag:scient.ing,2026:layer:smithlab/kp4m2x7q","tag:scient.ing,2026:layer:smithlab/tr6c3q8m","tag:scient.ing,2026:layer:smithlab/cm7h4p2x","tag:scient.ing,2026:layer:smithlab/bq5k8r3w","tag:scient.ing,2026:layer:smithlab/dt9n2k5y"],"members":[{"keys":["ana"],"person":"Ana Example","role":"owner"},{"keys":["ben","ben-spot"],"person":"Ben Example","role":"editor"},{"keys":["cara"],"person":"Cara Example","role":"reader"}],"name":"Charges and bonds","paths":[{"id":"onboarding","steps":[{"note":"Read the introduction.","ref":"smithlab/hale2026harmonic-damb","type":"document"},{"note":"Then the table.","ref":"smithlab/hale2026harmonic-damb#hj4s7pb","type":"node"},{"note":"The bond force constant, amber/k-bond.","ref":"claim:272XTX7C","type":"claim"}],"title":"First week"}],"settings":{"digit_rule":"anchored-sections","drift_threshold":"0.25","log":{"origin":"scient.ing/log/smithlab","threshold":1,"witnesses":["wit"]},"rights_unknown":"refuse","spot_check":{"minimum":10,"rate":"0.05"},"stages":"scienting-stages-default"},"store":"smithlab","views":["ctct-scan"]}
|
||||
@@ -448,6 +448,26 @@
|
||||
"description": "The exercise kind is unknown.",
|
||||
"chapter": "spec/22-conformance.md"
|
||||
},
|
||||
{
|
||||
"id": "layer.data.dataset",
|
||||
"description": "A data body's dataset is not a dataset ID, is not the dataset whose descriptor was given, or has a quantity whose field the dataset lacks or whose unit differs from the field's.",
|
||||
"chapter": "spec/18-layers.md"
|
||||
},
|
||||
{
|
||||
"id": "layer.data.quantity",
|
||||
"description": "A data body has two quantities for one field.",
|
||||
"chapter": "spec/18-layers.md"
|
||||
},
|
||||
{
|
||||
"id": "layer.data.subject",
|
||||
"description": "A data body's subject is not a structure or a sequence, has an identity not of the form its kind gives, or repeats another subject.",
|
||||
"chapter": "spec/18-layers.md"
|
||||
},
|
||||
{
|
||||
"id": "layer.data.type",
|
||||
"description": "A data body's kind of data or role is not one the body allows.",
|
||||
"chapter": "spec/18-layers.md"
|
||||
},
|
||||
{
|
||||
"id": "layer.sequence.identity",
|
||||
"description": "A sequence body's identity is not its alphabet, a colon and the first sixteen hex digits of the SHA-256 of its residues with the gaps taken out.",
|
||||
|
||||
@@ -61,7 +61,7 @@
|
||||
]
|
||||
},
|
||||
"accession": {
|
||||
"description": "An entry of an outside database that a structure or a sequence is: `db` names the database in lower case (pubchem, chebi, cas, uniprot, genbank, refseq, ensembl, pdb) and `id` is the entry's identifier there (spec/18 §18.6).",
|
||||
"description": "An entry of an outside database or vocabulary that a structure, a sequence or some data is, or is of: `db` names it in lower case (pubchem, chebi, cas, uniprot, genbank, refseq, ensembl, pdb, zenodo, geo, edam, chmo) and `id` is the entry's identifier there (spec/18 §18.6).",
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"db": {
|
||||
@@ -271,6 +271,54 @@
|
||||
"alt"
|
||||
],
|
||||
"additionalProperties": false
|
||||
},
|
||||
"quantity": {
|
||||
"description": "What a field of a dataset measures: `field` is the dataset's field, `name` says what it is in words, and `unit` is the field's unit as the dataset spells it (spec/18 §18.8).",
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"field": {
|
||||
"type": "string",
|
||||
"pattern": "^[A-Za-z_][A-Za-z0-9_.-]*$"
|
||||
},
|
||||
"name": {
|
||||
"type": "string",
|
||||
"minLength": 1
|
||||
},
|
||||
"unit": {
|
||||
"type": "string",
|
||||
"minLength": 1
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"field",
|
||||
"name"
|
||||
],
|
||||
"additionalProperties": false
|
||||
},
|
||||
"subject": {
|
||||
"description": "A molecule or a sequence that data is about, found by the identity a `structure` or a `sequence` body carries (spec/18 §18.8).",
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"kind": {
|
||||
"enum": [
|
||||
"structure",
|
||||
"sequence"
|
||||
]
|
||||
},
|
||||
"identity": {
|
||||
"type": "string",
|
||||
"pattern": "^([A-Z]{14}-[A-Z]{10}-[A-Z]|(smiles|smarts):[0-9a-f]{12}|(protein|dna|rna):[0-9a-f]{16})$"
|
||||
},
|
||||
"label": {
|
||||
"type": "string",
|
||||
"minLength": 1
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"kind",
|
||||
"identity"
|
||||
],
|
||||
"additionalProperties": false
|
||||
}
|
||||
},
|
||||
"type": "object",
|
||||
@@ -961,6 +1009,92 @@
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"type": {
|
||||
"const": "TextualBody"
|
||||
},
|
||||
"kind": {
|
||||
"const": "data"
|
||||
},
|
||||
"value": {
|
||||
"description": "The data in a few words: what it is and what it is about (spec/18 §18.8).",
|
||||
"type": "string",
|
||||
"minLength": 1,
|
||||
"maxLength": 2000
|
||||
},
|
||||
"data_type": {
|
||||
"description": "What kind of data it is (spec/18 §18.8).",
|
||||
"enum": [
|
||||
"abundance",
|
||||
"benchmark",
|
||||
"binding-affinity",
|
||||
"dose-response",
|
||||
"energy-profile",
|
||||
"force-field-parameters",
|
||||
"geometry",
|
||||
"kinetics",
|
||||
"other",
|
||||
"physical-property",
|
||||
"sequence-property",
|
||||
"simulation-observable",
|
||||
"spectrum",
|
||||
"thermodynamics",
|
||||
"variant-effect"
|
||||
]
|
||||
},
|
||||
"role": {
|
||||
"enum": [
|
||||
"reports",
|
||||
"uses"
|
||||
]
|
||||
},
|
||||
"dataset": {
|
||||
"description": "The dataset (spec/15) that holds the values.",
|
||||
"$ref": "common.schema.json#/$defs/datasetId"
|
||||
},
|
||||
"label": {
|
||||
"type": "string",
|
||||
"minLength": 1
|
||||
},
|
||||
"method": {
|
||||
"description": "How the data was obtained, in the paper's words.",
|
||||
"type": "string",
|
||||
"minLength": 1
|
||||
},
|
||||
"quantities": {
|
||||
"type": "array",
|
||||
"items": {
|
||||
"$ref": "#/$defs/quantity"
|
||||
},
|
||||
"minItems": 1
|
||||
},
|
||||
"subjects": {
|
||||
"type": "array",
|
||||
"items": {
|
||||
"$ref": "#/$defs/subject"
|
||||
},
|
||||
"minItems": 1
|
||||
},
|
||||
"accessions": {
|
||||
"type": "array",
|
||||
"items": {
|
||||
"$ref": "#/$defs/accession"
|
||||
},
|
||||
"minItems": 1,
|
||||
"uniqueItems": true
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"type",
|
||||
"kind",
|
||||
"value",
|
||||
"data_type",
|
||||
"role"
|
||||
],
|
||||
"additionalProperties": false
|
||||
},
|
||||
{
|
||||
"type": "object",
|
||||
"properties": {
|
||||
|
||||
@@ -55,6 +55,7 @@ Replies are annotations that target annotations, so discussions are threads anch
|
||||
| `trace` | `SpecificResource` | `source`, `selector`, `reference`, `note`, `verdict`, `proposer` | That the target's sentence cites `reference` on the strength of a passage of the cited document ([18.5](#185-traced-citations)). |
|
||||
| `structure` | `TextualBody` | `format`, `role`, `identity`, `written`, `label`, `accessions`, `terms` | That the span names, draws, gives parameters for or uses a chemical structure ([18.6](#186-chemical-structures)). |
|
||||
| `sequence` | `TextualBody` | `alphabet`, `role`, `identity`, `start`, `label`, `organism`, `accessions`, `regions`, `variants` | That the span names, shows, uses or reports a variant of a protein, DNA or RNA sequence ([18.7](#187-sequences)). |
|
||||
| `data` | `TextualBody` | `data_type`, `role`, `dataset`, `quantities`, `subjects`, `method`, `label`, `accessions` | That the span presents data of a kind, what its fields measure and which molecules and sequences it is about ([18.8](#188-data)). |
|
||||
| `translation` | `TextualBody` | `language` | The span in another language. |
|
||||
| `description` | `TextualBody` | `role` | A description of a figure, panel or table for readers who cannot see it: `alt`, a short text equivalent, or `long`, a full description. |
|
||||
| `generated` | `TextualBody` | `generator` | Text a model wrote about the span; never mistaken for source. `generator` is `{model, run}` as a correction's model author is ([11.2](11-corrections.md#112-every-correction-records)). |
|
||||
@@ -198,3 +199,51 @@ A sequence body breaks `layer.sequence.value` when its letters are not those of
|
||||
The reference implementation is `paperspec.sequences.problems`.
|
||||
It needs no toolkit, since an alphabet is a set of letters; a producer that knows the molecule SHOULD also check the sequence against the `accessions` it names.
|
||||
`vectors/sequences.jsonl` mints identities and breaks every rule, and `fixtures/records/biology/` holds a layer of three annotations on the draft `writer2027fixed-ynr7.v3`, whose last sentence tests its charges on the villin headpiece subdomain HP35: the words that name it, the printed sequence with its three helices as regions, and a model's proposal of the N68H variant, in the numbering 42 to 76 that the headpiece uses.
|
||||
|
||||
## 18.8 Data
|
||||
|
||||
A paper reports data in a table, a figure or a passage, and a dataset ([15](15-datasets.md)) holds its values.
|
||||
A `data` annotation says what kind of data its span presents, what the dataset's fields measure and which molecules and sequences it is about, so that data can be found by kind and by subject.
|
||||
Its target is the span, as for any annotation.
|
||||
The words and the dataset stay as they are, the kind is one reader's reading, attributed and withdrawable, and a model's tie stays `proposed` until a person confirms it.
|
||||
Whether the values hold is a claim ([18.1](#181-one-rule-decides-what-is-a-claim-and-what-is-a-layer)); this body says only what they are.
|
||||
|
||||
| Property | Required | Holds |
|
||||
| --- | --- | --- |
|
||||
| `value` | Yes | The data in a few words: what it is and what it is about. |
|
||||
| `data_type` | Yes | What kind of data it is, one of the kinds below. |
|
||||
| `role` | Yes | What the span does with the data: `reports` it (the span is the table, figure panel or passage that gives it) or `uses` it (the span relies on data given elsewhere). |
|
||||
| `dataset` | No | The ID of the dataset that holds the values, `ds-` and a key ([15](15-datasets.md)). |
|
||||
| `quantities` | No | What the dataset's fields measure: a list of `{field, name, unit?}`, with the `field` of the dataset, a `name` in words (`harmonic bond force constant`) and the `unit` as the dataset spells it. |
|
||||
| `subjects` | No | The molecules and sequences the data is about: a list of `{kind, identity, label?}`, with `kind` `structure` or `sequence` and the `identity` of a `structure` ([18.6](#186-chemical-structures)) or `sequence` ([18.7](#187-sequences)) body. |
|
||||
| `method` | No | How the data was obtained, in the paper's words: `isothermal titration calorimetry`, `DFT, B3LYP/6-31G*`. |
|
||||
| `label` | No | A short name. |
|
||||
| `accessions` | No | Entries of outside databases or vocabularies that the data is, or is of: a list of `{db, id}`, with `db` in lower case (`zenodo`, `geo`, `edam`, `chmo`). |
|
||||
|
||||
| `data_type` | Covers |
|
||||
| --- | --- |
|
||||
| `abundance` | Counts, expression levels or concentrations measured in samples. |
|
||||
| `benchmark` | How well a method or model does against a reference or against other methods: errors, scores, run times. |
|
||||
| `binding-affinity` | How tightly molecules bind: dissociation constants, inhibition constants, IC50, binding free energies. |
|
||||
| `dose-response` | A response as a function of dose or concentration. |
|
||||
| `energy-profile` | Energy along a coordinate: scans, potentials of mean force, reaction paths. |
|
||||
| `force-field-parameters` | Constants a force field or model uses for bonded and non-bonded terms. |
|
||||
| `geometry` | Lengths, angles, torsions, distances or deviations of structures. |
|
||||
| `kinetics` | Rates, rate constants, half-lives and barriers. |
|
||||
| `physical-property` | A property of a substance: density, melting point, pKa, logP, solubility. |
|
||||
| `sequence-property` | Values for the positions of a sequence: conservation, disorder, fitness scores. |
|
||||
| `simulation-observable` | A quantity computed from a simulation: distributions, time series, order parameters. |
|
||||
| `spectrum` | A spectrum or its peaks: NMR, infrared, Raman, ultraviolet-visible, mass. |
|
||||
| `thermodynamics` | Enthalpy, entropy, free energy, heat capacity, or a melting temperature of a process. |
|
||||
| `variant-effect` | What a change to a sequence or a structure does to a property. |
|
||||
| `other` | Data none of these describes; the `value` says what it is. |
|
||||
|
||||
The list is fixed by this chapter, and a new kind is a minor change ([0.4](00-introduction.md#04-status)).
|
||||
Where a kind has an outside term, `accessions` carries it, so a producer is not limited to this list when it says what the data is.
|
||||
A dataset's `origin` ([15](15-datasets.md)) says where its values came from, so the body does not repeat whether they were reported, digitized, computed or measured.
|
||||
|
||||
A data body breaks `layer.data.type` when its `data_type` or its `role` is not one the body allows, `layer.data.quantity` when two quantities are for one field, `layer.data.subject` when a subject's identity is not of the form its kind gives or a subject repeats another, and `layer.data.dataset` when `dataset` is not a dataset ID or, for a checker given the dataset's descriptor, is not that dataset, or a quantity names a field the dataset lacks or gives it a unit other than the dataset's ([22.4](22-conformance.md#224-rules)).
|
||||
The reference implementation is `paperspec.data.problems`, which takes the descriptor as an optional second argument.
|
||||
It compares units as strings and needs no unit library; a producer SHOULD also check that each unit parses and that its dimension fits the quantity it is given for, and that each subject's identity belongs to a `structure` or `sequence` annotation of the same layer or another.
|
||||
`vectors/data.jsonl` breaks every rule, and `fixtures/records/data/` holds a layer of three annotations on `hale2026harmonic-damb`: the caption of Table 1, tied to its dataset as force-field parameters for ethane, water and the CT–CT pattern with its force constant and equilibrium length; the caption of Figure 1a, tied to the dataset read from the scan as an energy profile of ethane; and the sentence that introduces Table 1, tied by a model and still `proposed`.
|
||||
The subjects' identities are those of the annotations in `fixtures/records/chemistry/`.
|
||||
@@ -6,7 +6,7 @@
|
||||
| --- | --- | --- |
|
||||
| `vectors/*.jsonl` | Inputs and expected outputs, one case per line. | Computes every expected output from its input. |
|
||||
| `fixtures/packages/` | Valid packages: a converted chemistry paper with corrections, receipts, a multi-level-header table and a dataset; its checks-only export; an open-access paper with two witnesses; a Typst draft; a tiny document, as a folder and as the zip of [12.2](12-package.md#122-paths). | Accepts each, and recomputes every value it contains. |
|
||||
| `fixtures/records/` | A valid record of every other format that is a JSON file of its own, and three more layers: traced citations ([18.5](18-layers.md#185-traced-citations)), whose traces resolve as `vectors/traces.jsonl` says, chemical structures ([18.6](18-layers.md#186-chemical-structures)) and sequences ([18.7](18-layers.md#187-sequences)), whose rules `vectors/structures.jsonl` and `vectors/sequences.jsonl` pin; the stage requirements and stamp rules are in `registry/`, and a bundle is built by `paperspec load --bundle`. | Accepts each. |
|
||||
| `fixtures/records/` | A valid record of every other format that is a JSON file of its own, and four more layers: traced citations ([18.5](18-layers.md#185-traced-citations)), whose traces resolve as `vectors/traces.jsonl` says, chemical structures ([18.6](18-layers.md#186-chemical-structures)), sequences ([18.7](18-layers.md#187-sequences)) and data ([18.8](18-layers.md#188-data)), whose rules `vectors/structures.jsonl`, `vectors/sequences.jsonl` and `vectors/data.jsonl` pin; the stage requirements and stamp rules are in `registry/`, and a bundle is built by `paperspec load --bundle`. | Accepts each. |
|
||||
| `fixtures/invalid/` | Invalid packages, each with `expect.json` naming the rule it breaks. | Refuses each, and SHOULD name that rule. |
|
||||
| `fixtures/keys/` | The test keys that signed the fixtures and the team secret of the checks-only export. | Never uses them for anything else. |
|
||||
|
||||
@@ -49,10 +49,10 @@ Rule IDs are stable: a rule's meaning never changes, and a retired rule's ID is
|
||||
| `doc.receipt.`, `doc.qa.`, `doc.fidelity.` | Receipts, spot-checks and levels. |
|
||||
| `doc.witness.`, `doc.page.`, `doc.location.`, `doc.reference.` | Witnesses and geometry. |
|
||||
| `grade.` | Grading. |
|
||||
| `layer.` | Annotations: `layer.trace.source` and `layer.trace.target`, which refer to documents ([18.5](18-layers.md#185-traced-citations)); `layer.structure.value`, `layer.structure.identity` and `layer.structure.term` ([18.6](18-layers.md#186-chemical-structures)); and `layer.sequence.value`, `layer.sequence.identity`, `layer.sequence.region` and `layer.sequence.variant` ([18.7](18-layers.md#187-sequences)). |
|
||||
| `layer.` | Annotations: `layer.trace.source` and `layer.trace.target`, which refer to documents ([18.5](18-layers.md#185-traced-citations)); `layer.structure.value`, `layer.structure.identity` and `layer.structure.term` ([18.6](18-layers.md#186-chemical-structures)); `layer.sequence.value`, `layer.sequence.identity`, `layer.sequence.region` and `layer.sequence.variant` ([18.7](18-layers.md#187-sequences)); and `layer.data.type`, `layer.data.quantity`, `layer.data.subject` and `layer.data.dataset` ([18.8](18-layers.md#188-data)). |
|
||||
|
||||
A package is validated by [22.2](#222-validating-a-package), but a layer is not part of one.
|
||||
The `layer.` rules are reported for an annotation, in the form `annotation: rule: message`, by a validator that has the annotation and, for a trace, the states of the documents it names; the reference implementation does so in `paperspec.traces.problems`, `paperspec.structures.problems` and `paperspec.sequences.problems`.
|
||||
The `layer.` rules are reported for an annotation, in the form `annotation: rule: message`, by a validator that has the annotation and, for a trace, the states of the documents it names; the reference implementation does so in `paperspec.traces.problems`, `paperspec.structures.problems`, `paperspec.sequences.problems` and `paperspec.data.problems`.
|
||||
|
||||
## 22.5 Stability
|
||||
|
||||
|
||||
+1
-1
@@ -68,7 +68,7 @@ CREATE TABLE layers (
|
||||
CREATE TABLE annotations (
|
||||
id VARCHAR(256) NOT NULL,
|
||||
layer VARCHAR(256) NOT NULL,
|
||||
body_kind VARCHAR(24) NOT NULL CHECK (body_kind IN ('gloss', 'claim-link', 'symbol', 'comment', 'caveat', 'question', 'exercise', 'citation-context', 'prerequisite', 'crosslink', 'trace', 'structure', 'sequence', 'translation', 'description', 'generated')),
|
||||
body_kind VARCHAR(24) NOT NULL CHECK (body_kind IN ('gloss', 'claim-link', 'symbol', 'comment', 'caveat', 'question', 'exercise', 'citation-context', 'prerequisite', 'crosslink', 'trace', 'structure', 'sequence', 'data', 'translation', 'description', 'generated')),
|
||||
category VARCHAR(12) CHECK (category IN ('comment', 'context', 'critique', 'question', 'correction', 'feedback', 'resource')),
|
||||
status VARCHAR(10) NOT NULL CHECK (status IN ('proposed', 'confirmed', 'rejected', 'withdrawn')),
|
||||
receipt VARCHAR(32),
|
||||
|
||||
+109
-7
@@ -27,7 +27,7 @@ from paperspec import anchors as AN # noqa: E402
|
||||
from paperspec import corrections as CO # noqa: E402
|
||||
from paperspec import crypto, fingerprint as FP, grade as GR, hashing, jcs, receipts as RC, rights as RI # noqa: E402
|
||||
from paperspec import keys as K, log as LG, mldsa, targets as TG, traces as TR, vrf # noqa: E402
|
||||
from paperspec import sequences as SQ, structures as ST # noqa: E402
|
||||
from paperspec import data as DT, sequences as SQ, structures as ST # noqa: E402
|
||||
from paperspec.model import LEAVES, MATH_KINDS, RUN_KINDS, VERBATIM_KINDS, Doc # noqa: E402
|
||||
from paperspec.notation import fold_math # noqa: E402
|
||||
from paperspec.package import ZIP_EXTENSION, history_items, jsonl, line, read_state, witness_id, write, write_zip # noqa: E402
|
||||
@@ -1400,6 +1400,8 @@ TRACE_LAYER = TAG + "layer:smithlab/tr6c3q8m"
|
||||
# The layers of chemical structures on the main example and of sequences on the draft (spec/18 §18.6 and §18.7).
|
||||
CHEMISTRY_LAYER = TAG + "layer:smithlab/cm7h4p2x"
|
||||
BIOLOGY_LAYER = TAG + "layer:smithlab/bq5k8r3w"
|
||||
# The layer of data on the main example (spec/18 §18.8).
|
||||
DATA_LAYER = TAG + "layer:smithlab/dt9n2k5y"
|
||||
# A model's provenance: enough to name the weights and the instructions it ran with (all illustrative).
|
||||
MODEL = {"name": "example-model", "provider": "Example Models (illustrative)", "version": "2026-09",
|
||||
"weights": sha256_hex("illustrative weights"), "prompt": sha256_hex("illustrative review prompt"),
|
||||
@@ -1606,7 +1608,7 @@ def records(out, hale):
|
||||
{"type": "document", "ref": QHALE, "note": "Read the introduction."},
|
||||
{"type": "node", "ref": QHALE + "#" + I["@tab1"], "note": "Then the table."},
|
||||
{"type": "claim", "ref": CLAIM_K_BOND, "note": "The bond force constant, amber/k-bond."}]}],
|
||||
"layers": [layer_id, TRACE_LAYER, CHEMISTRY_LAYER, BIOLOGY_LAYER], "datasets": ["ds-hale-bond-params", "ds-hale-ctct-scan"], "views": ["ctct-scan"],
|
||||
"layers": [layer_id, TRACE_LAYER, CHEMISTRY_LAYER, BIOLOGY_LAYER, DATA_LAYER], "datasets": ["ds-hale-bond-params", "ds-hale-ctct-scan"], "views": ["ctct-scan"],
|
||||
"drafts": [STORE + "/" + DRAFT], "claims": {"paperclaim": "amber"},
|
||||
"settings": {"digit_rule": "anchored-sections", "drift_threshold": "0.25",
|
||||
"spot_check": {"rate": "0.05", "minimum": 10}, "rights_unknown": "refuse",
|
||||
@@ -1980,21 +1982,27 @@ def sequence_body(alphabet, value, role, **more):
|
||||
return b
|
||||
|
||||
|
||||
def data_body(data_type, value, role, **more):
|
||||
b = {"type": "TextualBody", "kind": "data", "value": value, "data_type": data_type, "role": role}
|
||||
b.update(more)
|
||||
return b
|
||||
|
||||
|
||||
def term(kind, atoms, types, values, units, source):
|
||||
return {"kind": kind, "atoms": atoms, "types": types, "values": values, "units": units, "source": source}
|
||||
|
||||
|
||||
def entities(out, hale, draft):
|
||||
"""The layer of chemical structures on the main example, the layer of sequences on the draft (spec/18 §18.6 and
|
||||
§18.7), and vectors/structures.jsonl and vectors/sequences.jsonl: the atoms and bonds a SMILES or SMARTS writes,
|
||||
the identities, and the annotations that break each rule."""
|
||||
"""The layer of chemical structures on the main example, the layer of sequences on the draft, the layer of data on
|
||||
the main example (spec/18 §18.6 to §18.8), and vectors/structures.jsonl, vectors/sequences.jsonl and vectors/data.jsonl:
|
||||
the atoms and bonds a SMILES or SMARTS writes, the identities, and the annotations that break each rule."""
|
||||
HALE, WRITER = hale["key"], draft["key"]
|
||||
QHALE, QWRITER = STORE + "/" + HALE, STORE + "/" + WRITER
|
||||
pkgs = os.path.join(out, "fixtures", "packages")
|
||||
ana = {"id": TAG + "key:ana", "type": "Person", "name": "Ana Example"}
|
||||
model = {"id": TAG + "software:example-model", "type": "Software", "name": "A model (illustrative)"}
|
||||
|
||||
def layer(name, layer_id, state, qdoc, label, purpose, scope, items):
|
||||
def layer(name, layer_id, state, qdoc, label, purpose, scope, items, motivation="identifying"):
|
||||
"""Write a layer of annotations on one document, with the receipt that confirms its confirmed ones."""
|
||||
doc = state.doc()
|
||||
vals = hashing.compute(doc)
|
||||
@@ -2017,7 +2025,7 @@ def entities(out, hale, draft):
|
||||
|
||||
anns = []
|
||||
for body, where, who, status, created in items(anchor):
|
||||
a = {"@context": CTX, "type": "Annotation", "layer": layer_id, "motivation": "identifying", "creator": who,
|
||||
a = {"@context": CTX, "type": "Annotation", "layer": layer_id, "motivation": motivation, "creator": who,
|
||||
"created": created, "body": body, "target": target(where)}
|
||||
a["id"] = TAG + "annotation:smithlab/" + record_id(H(jcs.dumpb(a)))
|
||||
a["status"] = status
|
||||
@@ -2081,6 +2089,45 @@ def entities(out, hale, draft):
|
||||
"Sequences in the draft", "The peptide the draft tests its charges on, its helices and its variant.",
|
||||
"sequences", biology_items)
|
||||
|
||||
def descriptor(*parts):
|
||||
with open(os.path.join(out, *parts), encoding="utf-8") as f:
|
||||
return json.load(f)
|
||||
|
||||
params_ds = descriptor("fixtures", "packages", HALE, "datasets", "ds-hale-bond-params", "datapackage.json")
|
||||
scan_ds = descriptor("fixtures", "records", "datasets", "ds-hale-ctct-scan", "datapackage.json")
|
||||
|
||||
def quantity(ds, field, name):
|
||||
"""A quantity of a dataset's field, with the unit the dataset gives it."""
|
||||
unit = next(f for r in ds["resources"] for f in r["schema"]["fields"] if f["name"] == field)["unit"]
|
||||
return {"field": field, "name": name, "unit": unit}
|
||||
|
||||
ethane_subject = {"kind": "structure", "identity": chem[0]["body"]["identity"], "label": "ethane"}
|
||||
water_subject = {"kind": "structure", "identity": chem[3]["body"]["identity"], "label": "water"}
|
||||
ctct_subject = {"kind": "structure", "identity": chem[2]["body"]["identity"], "label": ct}
|
||||
|
||||
def data_items(anchor):
|
||||
return [
|
||||
(data_body("force-field-parameters", "Harmonic bond constants for CT" + en + "CT, CT" + en + "HC and OW" + en + "HW, in two parameter sets",
|
||||
"reports", dataset="ds-hale-bond-params", label="bond parameters",
|
||||
method="scanned in steps of 0.01 Å, energies fitted by least squares",
|
||||
quantities=[quantity(params_ds, "k_r", "harmonic bond force constant"),
|
||||
quantity(params_ds, "r_eq", "equilibrium bond length")],
|
||||
subjects=[ethane_subject, water_subject, ctct_subject]),
|
||||
anchor(lambda t: t == "Fitted harmonic bond parameters."), ana, "confirmed", "2026-10-14T09:00:00Z"),
|
||||
(data_body("energy-profile", "Energy along the C" + en + "C stretch of ethane", "reports", dataset="ds-hale-ctct-scan",
|
||||
label="CT" + en + "CT scan", method="scanned in steps of 0.01 Å around the minimum",
|
||||
quantities=[quantity(scan_ds, "r", "C" + en + "C bond length"), quantity(scan_ds, "e", "energy")],
|
||||
subjects=[ethane_subject]),
|
||||
anchor(lambda t: t == "(a) The scan."), ana, "confirmed", "2026-10-14T09:05:00Z"),
|
||||
(data_body("force-field-parameters", "The fitted bond constants of Table 1, which this sentence introduces", "uses",
|
||||
dataset="ds-hale-bond-params"),
|
||||
anchor(lambda t: t.startswith("Table 1 lists")), model, "proposed", "2026-10-14T09:10:00Z"),
|
||||
]
|
||||
|
||||
data = layer("data", DATA_LAYER, read_state(os.path.join(pkgs, HALE)), QHALE,
|
||||
"Data in Hale and Osei", "What kind of data the paper's table and figure present, and what they are about.",
|
||||
"data", data_items, motivation="classifying")
|
||||
|
||||
def with_body(a, **edit):
|
||||
"""The annotation with its body changed; a key set to None is removed."""
|
||||
b = copy.deepcopy(a)
|
||||
@@ -2230,6 +2277,61 @@ def entities(out, hale, draft):
|
||||
]
|
||||
wv(out, "sequences.jsonl", cases)
|
||||
|
||||
# --- data
|
||||
params, scan, intro = data
|
||||
hp35_subject = {"kind": "sequence", "identity": SQ.identity("protein", HP35), "label": "HP35"}
|
||||
|
||||
def data_case(cid, a, note, dataset=None):
|
||||
c = {"id": cid, "op": "problems", "annotation": a, "schema": not schema_validate(SCHEMAS, "annotation.schema.json", a),
|
||||
"expect": DT.problems(a, dataset), "note": note}
|
||||
if dataset is not None:
|
||||
c["dataset"] = dataset
|
||||
return c
|
||||
|
||||
def quantities_of(a, *edit):
|
||||
return [dict(q, **e) for q, e in zip(a["body"]["quantities"], edit)]
|
||||
|
||||
minimal = lambda kind: dict(intro, body=data_body(kind, "Data of the kind " + kind, "reports")) # noqa: E731
|
||||
cases = [data_case("valid-kind-" + kind, minimal(kind), DT.DATA_TYPES[kind]) for kind in DT.DATA_TYPES]
|
||||
cases += [
|
||||
data_case("valid-a-table", params, "The caption of Table 1, tied to its dataset, two quantities and three subjects."),
|
||||
data_case("valid-a-table-against-its-dataset", params, "The same, checked against the dataset's descriptor.", params_ds),
|
||||
data_case("valid-a-figure-panel-against-its-dataset", scan, "Figure 1a, whose dataset was read from it.", scan_ds),
|
||||
data_case("valid-a-passage-that-uses-data", intro, "A sentence that introduces a table: the role is uses."),
|
||||
data_case("valid-no-dataset", dict(intro, body=data_body("benchmark", "Run times of three methods on a test set", "reports")),
|
||||
"Data not yet extracted: no dataset, no quantities, no subjects."),
|
||||
data_case("valid-a-sequence-and-accessions", dict(intro, body=data_body(
|
||||
"variant-effect", "Folding stability of HP35 variants", "reports", method="thermal denaturation, circular dichroism",
|
||||
subjects=[hp35_subject], accessions=[{"db": "zenodo", "id": "1234567"}, {"db": "chmo", "id": "0000594"}])),
|
||||
"A sequence as the subject, and two outside entries."),
|
||||
data_case("valid-a-quantity-without-a-unit", dict(params, body=dict(params["body"], quantities=[
|
||||
{"field": "k_r", "name": "harmonic bond force constant"}])), "The unit is optional.", params_ds),
|
||||
data_case("valid-a-field-no-descriptor-was-given", dict(params, body=dict(params["body"], quantities=[
|
||||
{"field": "k_theta", "name": "harmonic angle force constant"}])), "Without the descriptor the field cannot be checked."),
|
||||
data_case("type-an-unknown-kind", dict(params, body=dict(params["body"], data_type="spectroscopy")), "Not a kind of data."),
|
||||
data_case("type-an-unknown-role", dict(params, body=dict(params["body"], role="names")), "Not a role of this body."),
|
||||
data_case("quantity-a-field-twice", dict(params, body=dict(params["body"], quantities=quantities_of(params, {}, {}) + [
|
||||
{"field": "k_r", "name": "the force constant again"}])), "Two quantities for k_r."),
|
||||
data_case("subject-a-kind-that-is-neither", dict(params, body=dict(params["body"], subjects=[
|
||||
{"kind": "reaction", "identity": ethane_subject["identity"]}])), "A subject is a structure or a sequence."),
|
||||
data_case("subject-a-sequence-identity-for-a-structure", dict(params, body=dict(params["body"], subjects=[
|
||||
{"kind": "structure", "identity": hp35_subject["identity"]}])), "A protein: identity for a structure."),
|
||||
data_case("subject-a-structure-identity-for-a-sequence", dict(params, body=dict(params["body"], subjects=[
|
||||
{"kind": "sequence", "identity": ETHANE_KEY}])), "An InChIKey for a sequence."),
|
||||
data_case("subject-a-hash-too-short", dict(params, body=dict(params["body"], subjects=[
|
||||
{"kind": "structure", "identity": "smarts:2e2a923f"}])), "Twelve hexadecimal digits are needed."),
|
||||
data_case("subject-listed-twice", dict(params, body=dict(params["body"], subjects=[ethane_subject, water_subject, ethane_subject])),
|
||||
"Ethane is the first and the third."),
|
||||
data_case("dataset-not-an-id", dict(params, body=dict(params["body"], dataset="Table 1")), "A dataset ID begins ds-."),
|
||||
data_case("dataset-another-than-the-descriptor", params, "The annotation names ds-hale-bond-params; the descriptor is of the scan, which has none of its fields.",
|
||||
scan_ds),
|
||||
data_case("dataset-a-field-the-dataset-lacks", dict(params, body=dict(params["body"], quantities=[
|
||||
{"field": "k_theta", "name": "harmonic angle force constant"}])), "The table has no k_theta.", params_ds),
|
||||
data_case("dataset-a-unit-other-than-the-datasets", dict(params, body=dict(params["body"], quantities=quantities_of(
|
||||
params, {"unit": "kcal/mol/A^2"}, {}))), "The dataset gives k_r the unit kcal / mol / angstrom ** 2.", params_ds),
|
||||
]
|
||||
wv(out, "data.jsonl", cases)
|
||||
|
||||
|
||||
def _anchors_of(body):
|
||||
return [s["anchor"] for s in body["selector"] if s["type"] == "AnchorSelector"]
|
||||
|
||||
+119
-6
@@ -28,7 +28,7 @@ from paperspec import corrections as CO # noqa: E402
|
||||
from paperspec import crypto, db, fingerprint as FP, grade as GR, hashing, jcs, receipts as RC, rights as RI # noqa: E402
|
||||
from paperspec import package as PK # noqa: E402
|
||||
from paperspec import keys as K, log as LG, mldsa, targets as TG, traces as TR, vrf # noqa: E402
|
||||
from paperspec import sequences as SQ, structures as ST # noqa: E402
|
||||
from paperspec import data as DT, sequences as SQ, structures as ST # noqa: E402
|
||||
import unicodedata # noqa: E402
|
||||
from paperspec.model import Doc # noqa: E402
|
||||
from paperspec.notation import fold_math # noqa: E402
|
||||
@@ -197,9 +197,9 @@ def check_records():
|
||||
stages = js(os.path.join(R, "project.json")).get("settings", {}).get("stages")
|
||||
ok("records", stages is None or stages in stage_ids, "project settings.stages names no stage file: %s" % stages)
|
||||
# Confirmed annotations are covered by the layer receipt at their content hash, in every layer: the example
|
||||
# layer on the main example, the layer of traces on the draft, the structures of the main example and the draft's
|
||||
# sequences.
|
||||
for layer in ("layer", "traces", "chemistry", "biology"):
|
||||
# layer on the main example, the layer of traces on the draft, the structures and the data of the main example and
|
||||
# the draft's sequences.
|
||||
for layer in ("layer", "traces", "chemistry", "biology", "data"):
|
||||
lj = js(os.path.join(R, layer, "layer.json"))
|
||||
lr = js(os.path.join(R, layer, "receipt.json"))
|
||||
items = {(k, i): h for k, i, h in lr["records"]}
|
||||
@@ -1094,6 +1094,118 @@ def check_entities():
|
||||
"the sequence vectors lack a case they are known for")
|
||||
|
||||
|
||||
def check_data():
|
||||
"""Data (spec/18 §18.8): the four rules, the fixture layer on the main example against its datasets and its
|
||||
structures, the body's schema, the context's terms, and the vectors, which break every rule."""
|
||||
R = p("fixtures", "records")
|
||||
rules = {r["id"]: r for r in js(p("registry", "rules.json"))["rules"]}
|
||||
mine = ("layer.data.type", "layer.data.quantity", "layer.data.subject", "layer.data.dataset")
|
||||
for rule in mine:
|
||||
ok("data", rule in rules and rules[rule]["chapter"] == "spec/18-layers.md", "%s is not registered" % rule)
|
||||
try:
|
||||
DT.problems({"body": {"kind": "comment"}})
|
||||
raised = False
|
||||
except ValueError:
|
||||
raised = True
|
||||
ok("data", raised, "data.problems accepted a body of another kind")
|
||||
ok("data", set(DT.DATA_TYPES) == set(next(b for b in STORE.load("annotation.schema.json")["properties"]["body"]["oneOf"]
|
||||
if b["properties"]["kind"]["const"] == "data")["properties"]["data_type"]["enum"]),
|
||||
"the kinds of data in the schema differ from paperspec.data.DATA_TYPES")
|
||||
|
||||
# The fixture layer: three annotations on the main example. Each breaks no rule against the dataset it names, and
|
||||
# each subject is a structure the chemistry layer annotates.
|
||||
anns = jl(os.path.join(R, "data", "annotations.jsonl"))
|
||||
chem = jl(os.path.join(R, "chemistry", "annotations.jsonl"))
|
||||
descriptors = {"ds-hale-bond-params": js(p("fixtures", "packages", HALE, "datasets", "ds-hale-bond-params", "datapackage.json")),
|
||||
"ds-hale-ctct-scan": js(p("fixtures", "records", "datasets", "ds-hale-ctct-scan", "datapackage.json"))}
|
||||
ok("data", len(anns) == 3 and all(a["body"]["kind"] == "data" for a in anns), "the data layer holds three data annotations")
|
||||
ok("data", all(DT.problems(a, descriptors.get(a["body"].get("dataset"))) == [] for a in anns),
|
||||
"a data annotation of the layer breaks a rule against its dataset")
|
||||
ok("data", {a["status"] for a in anns} == {"confirmed", "proposed"}
|
||||
and all((a["creator"]["type"] == "Software") == (a["status"] == "proposed") for a in anns),
|
||||
"the layer holds a model's proposal beside a person's confirmed annotations, and only a model proposes")
|
||||
ok("data", {a["body"]["role"] for a in anns} == {"reports", "uses"} and {a["body"]["data_type"] for a in anns}
|
||||
== {"force-field-parameters", "energy-profile"}, "the layer lacks a role or a kind it is known for")
|
||||
project = js(os.path.join(R, "project.json"))
|
||||
ok("data", all(a["body"]["dataset"] in project["datasets"] for a in anns if "dataset" in a["body"]),
|
||||
"an annotation names a dataset the project does not hold")
|
||||
known = {a["body"]["identity"] for a in chem}
|
||||
ok("data", all(s["identity"] in known for a in anns for s in a["body"].get("subjects", [])),
|
||||
"a subject is a structure the chemistry layer does not annotate")
|
||||
ok("data", all(a["motivation"] == "classifying" for a in anns), "a data annotation classifies")
|
||||
# A reported table or panel gives each quantity the unit its dataset does; the unit is the dataset's own string.
|
||||
reported = [a for a in anns if a["body"]["role"] == "reports"]
|
||||
ok("data", len(reported) == 2 and all(a["body"].get("quantities") and a["body"].get("subjects") for a in reported),
|
||||
"a reported dataset has quantities and subjects")
|
||||
ok("data", all("unit" in q for a in reported for q in a["body"]["quantities"]), "a quantity of the fixtures lacks its unit")
|
||||
|
||||
# The schema: what the body takes and refuses (spec/18 §18.4).
|
||||
base = reported[0]
|
||||
|
||||
def edit(**kw):
|
||||
a = json.loads(json.dumps(base))
|
||||
for k, v in kw.items():
|
||||
if v is None:
|
||||
a["body"].pop(k, None)
|
||||
else:
|
||||
a["body"][k] = v
|
||||
return a
|
||||
|
||||
first_unit = base["body"]["quantities"][0]["unit"]
|
||||
schema_cases = (
|
||||
("a data body", base, True),
|
||||
("data with no data_type", edit(data_type=None), False),
|
||||
("data with a data_type that is not a kind", edit(data_type="spectroscopy"), False),
|
||||
("data with a data_type in capitals", edit(data_type="Spectrum"), False),
|
||||
("data with no role", edit(role=None), False),
|
||||
("data with a role of another body", edit(role="names"), False),
|
||||
("data whose value is empty", edit(value=""), False),
|
||||
("data with an extra property", edit(alphabet="protein"), False),
|
||||
("data with a dataset that is no ID", edit(dataset="Table 1"), False),
|
||||
("data with no dataset", edit(dataset=None), True),
|
||||
("data with a method that is empty", edit(method=""), False),
|
||||
("data with an empty list of quantities", edit(quantities=[]), False),
|
||||
("data with a quantity of no name", edit(quantities=[{"field": "k_r"}]), False),
|
||||
("data with a quantity of no field", edit(quantities=[{"name": "force constant"}]), False),
|
||||
("data with a quantity with an extra property", edit(quantities=[{"field": "k_r", "name": "force constant", "dimension": "energy"}]), False),
|
||||
("data with a quantity of the dataset's unit",edit(quantities=[{"field": "k_r", "name": "force constant", "unit": first_unit}]), True),
|
||||
("data with a subject of another kind", edit(subjects=[{"kind": "reaction", "identity": "OTMSDBZUPAUEDD-UHFFFAOYSA-N"}]), False),
|
||||
("data with a subject whose identity has no form", edit(subjects=[{"kind": "structure", "identity": "ethane"}]), False),
|
||||
("data with an empty list of subjects", edit(subjects=[]), False),
|
||||
("data with two equal accessions", edit(accessions=[{"db": "zenodo", "id": "1"}] * 2), False))
|
||||
for name, a, good in schema_cases:
|
||||
ok("data", (schema_errors("annotation.schema.json", a) == []) == good, "schema, %s" % name)
|
||||
|
||||
# The vocabulary knows the terms (spec/18 §18.8, context/README.md).
|
||||
ctx = js(p("context", "scienting-1.jsonld"))["@context"]
|
||||
ok("data", all(t in ctx for t in ("data_type", "dataset", "method", "quantities", "subjects")),
|
||||
"the context lacks a term of the data body")
|
||||
ok("data", all(isinstance(ctx[t], dict) and ctx[t]["@type"] == "@json" for t in ("quantities", "subjects")),
|
||||
"a list of objects is a JSON literal in the context")
|
||||
|
||||
# The vectors.
|
||||
seen, ids = set(), set()
|
||||
by_prefix = {"type": "layer.data.type", "quantity": "layer.data.quantity", "subject": "layer.data.subject",
|
||||
"dataset": "layer.data.dataset"}
|
||||
for c in V("data.jsonl"):
|
||||
ids.add(c["id"])
|
||||
got = DT.problems(c["annotation"], c.get("dataset"))
|
||||
ok("data", got == c["expect"], "data.jsonl %s" % c["id"])
|
||||
ok("data", (schema_errors("annotation.schema.json", c["annotation"]) == []) == c["schema"],
|
||||
"data.jsonl %s: the schema flag is not what the schema says" % c["id"])
|
||||
ok("data", all(x["rule"] in rules for x in got), "data.jsonl %s: an unregistered rule" % c["id"])
|
||||
seen |= {x["rule"] for x in got}
|
||||
stem = c["id"].split("-", 1)[0]
|
||||
if stem == "valid":
|
||||
ok("data", got == [], "data.jsonl %s: a valid case breaks a rule" % c["id"])
|
||||
else:
|
||||
ok("data", by_prefix[stem] in {x["rule"] for x in got}, "data.jsonl %s: does not break %s" % (c["id"], by_prefix[stem]))
|
||||
ok("data", seen == set(mine), "data.jsonl: every rule is broken by some case: %s" % sorted(seen))
|
||||
ok("data", {"valid-kind-" + k for k in DT.DATA_TYPES} <= ids, "data.jsonl lacks a valid case for a kind of data")
|
||||
ok("data", {"valid-a-table-against-its-dataset", "dataset-a-unit-other-than-the-datasets", "subject-listed-twice",
|
||||
"valid-a-sequence-and-accessions"} <= ids, "the data vectors lack a case they are known for")
|
||||
|
||||
|
||||
def check_determinism():
|
||||
with tempfile.TemporaryDirectory() as tmp:
|
||||
subprocess.run([sys.executable, "-m", "paperspec", "build", "--out", tmp], check=True)
|
||||
@@ -1181,7 +1293,7 @@ def check_sql():
|
||||
check_bundle(conn)
|
||||
# Store records satisfy the store tables' CHECK constraints.
|
||||
R = p("fixtures", "records")
|
||||
for layer in ("layer", "traces", "chemistry", "biology"):
|
||||
for layer in ("layer", "traces", "chemistry", "biology", "data"):
|
||||
lay = js(os.path.join(R, layer, "layer.json"))
|
||||
conn.execute("INSERT INTO layers VALUES (?,?,?,?,?,?,?,?)",
|
||||
(lay["id"], lay.get("project"), lay["label"], lay["purpose"], lay.get("audience"),
|
||||
@@ -1191,7 +1303,7 @@ def check_sql():
|
||||
(a["id"], a["layer"], a["body"]["kind"], a["body"].get("category"), a["status"],
|
||||
a.get("receipt"), a["creator"]["id"], a["created"], jcs.dumps(a)))
|
||||
kinds = {k for (k,) in conn.execute("SELECT DISTINCT body_kind FROM annotations")}
|
||||
ok("sql", {"trace", "structure", "sequence"} <= kinds, "the store holds no trace, structure or sequence annotation")
|
||||
ok("sql", {"trace", "structure", "sequence", "data"} <= kinds, "the store holds no trace, structure, sequence or data annotation")
|
||||
prj = js(os.path.join(R, "project.json"))
|
||||
conn.execute("INSERT INTO projects VALUES (?,?,?,?,?,?,?)",
|
||||
(prj["key"], prj.get("store"), prj["name"], prj.get("description"), jcs.dumps(prj.get("claims")),
|
||||
@@ -1584,6 +1696,7 @@ def run(args):
|
||||
check_vectors()
|
||||
check_traces()
|
||||
check_entities()
|
||||
check_data()
|
||||
if not args.quick:
|
||||
check_determinism()
|
||||
check_sql()
|
||||
|
||||
@@ -0,0 +1,91 @@
|
||||
"""Data tied to words: the `data` body of an annotation.
|
||||
|
||||
A data annotation says what kind of data a table, a figure panel or a passage presents, what its fields measure and which
|
||||
molecules and sequences it is about, so that data can be searched by kind and by subject. Non-normative; see
|
||||
spec/18-layers.md §18.8 for the body and spec/22-conformance.md §22.4 for the rules `layer.data.type`,
|
||||
`layer.data.quantity`, `layer.data.subject` and `layer.data.dataset`.
|
||||
|
||||
Everything here needs only the standard library. Units are not parsed: whether a unit fits a quantity is for a checker
|
||||
with a unit library, and the rules here compare units only as strings, with the dataset's own.
|
||||
"""
|
||||
|
||||
import re
|
||||
|
||||
DATA_TYPES = {
|
||||
"abundance": "Counts, expression levels or concentrations measured in samples.",
|
||||
"benchmark": "How well a method or model does against a reference or against other methods: errors, scores, run times.",
|
||||
"binding-affinity": "How tightly molecules bind: dissociation constants, inhibition constants, IC50, binding free energies.",
|
||||
"dose-response": "A response as a function of dose or concentration.",
|
||||
"energy-profile": "Energy along a coordinate: scans, potentials of mean force, reaction paths.",
|
||||
"force-field-parameters": "Constants a force field or model uses for bonded and non-bonded terms.",
|
||||
"geometry": "Lengths, angles, torsions, distances or deviations of structures.",
|
||||
"kinetics": "Rates, rate constants, half-lives and barriers.",
|
||||
"physical-property": "A property of a substance: density, melting point, pKa, logP, solubility.",
|
||||
"sequence-property": "Values for the positions of a sequence: conservation, disorder, fitness scores.",
|
||||
"simulation-observable": "A quantity computed from a simulation: distributions, time series, order parameters.",
|
||||
"spectrum": "A spectrum or its peaks: NMR, infrared, Raman, ultraviolet-visible, mass.",
|
||||
"thermodynamics": "Enthalpy, entropy, free energy, heat capacity, or a melting temperature of a process.",
|
||||
"variant-effect": "What a change to a sequence or a structure does to a property.",
|
||||
"other": "Data none of these describes; the value says what it is.",
|
||||
}
|
||||
"""The kinds of data a body can name, with what each covers."""
|
||||
ROLES = ("reports", "uses")
|
||||
SUBJECT_KINDS = {
|
||||
"structure": re.compile(r"^([A-Z]{14}-[A-Z]{10}-[A-Z]|(smiles|smarts):[0-9a-f]{12})$"),
|
||||
"sequence": re.compile(r"^(protein|dna|rna):[0-9a-f]{16}$"),
|
||||
}
|
||||
"""The form of a subject's identity for each kind, the forms of a `structure` and a `sequence` body's identity."""
|
||||
DATASET_ID = re.compile(r"^ds-[a-z0-9][a-z0-9._-]*$")
|
||||
|
||||
|
||||
def problems(annotation, dataset=None):
|
||||
"""The rules a data annotation breaks, as `[{"rule", "message"}]` in the order checked.
|
||||
|
||||
`layer.data.type` covers the kind of data and the role, `layer.data.quantity` each quantity against the others,
|
||||
`layer.data.subject` each subject's identity against its kind, and `layer.data.dataset` the dataset's ID and, when the
|
||||
dataset's descriptor (`datapackage.json`, parsed) is given, each quantity's field and unit against it.
|
||||
"""
|
||||
found = []
|
||||
|
||||
def add(rule, message):
|
||||
found.append({"rule": rule, "message": message})
|
||||
|
||||
body = annotation["body"]
|
||||
if body.get("kind") != "data":
|
||||
raise ValueError("not a data annotation")
|
||||
if body.get("data_type") not in DATA_TYPES:
|
||||
add("layer.data.type", "the kind of data is not one of %s" % ", ".join(DATA_TYPES))
|
||||
if body.get("role") not in ROLES:
|
||||
add("layer.data.type", "the role is not one of %s" % ", ".join(ROLES))
|
||||
fields = set()
|
||||
for k, q in enumerate(body.get("quantities", [])):
|
||||
name = q.get("field", "")
|
||||
if name in fields:
|
||||
add("layer.data.quantity", "quantity %d repeats the field %s" % (k, name))
|
||||
fields.add(name)
|
||||
seen = set()
|
||||
for k, s in enumerate(body.get("subjects", [])):
|
||||
kind, ident = s.get("kind", ""), s.get("identity", "")
|
||||
form = SUBJECT_KINDS.get(kind)
|
||||
if form is None:
|
||||
add("layer.data.subject", "subject %d is of a kind that is not %s" % (k, " or ".join(SUBJECT_KINDS)))
|
||||
elif not form.match(ident):
|
||||
add("layer.data.subject", "subject %d: %s is not the form of a %s identity" % (k, ident, kind))
|
||||
if (kind, ident) in seen:
|
||||
add("layer.data.subject", "subject %d repeats the %s %s" % (k, kind, ident))
|
||||
seen.add((kind, ident))
|
||||
ds = body.get("dataset")
|
||||
if ds is not None and not DATASET_ID.match(ds):
|
||||
add("layer.data.dataset", "%s is not the ID of a dataset" % ds)
|
||||
if dataset is not None and ds is not None:
|
||||
if dataset.get("id") != ds:
|
||||
add("layer.data.dataset", "the dataset is %s, not %s" % (dataset.get("id"), ds))
|
||||
units = {f["name"]: f.get("unit") for r in dataset.get("resources", []) for f in r.get("schema", {}).get("fields", [])}
|
||||
for k, q in enumerate(body.get("quantities", [])):
|
||||
name = q.get("field", "")
|
||||
if name not in units:
|
||||
add("layer.data.dataset", "quantity %d names the field %s, which %s does not have" % (k, name, ds))
|
||||
elif "unit" in q and q["unit"] != units[name]:
|
||||
add("layer.data.dataset", "quantity %d gives %s the unit %s, but %s gives it %s"
|
||||
% (k, name, q["unit"], ds, units[name]))
|
||||
return found
|
||||
+1
-1
@@ -75,7 +75,7 @@ A node's five values depend only on its own subtree, so after a correction the o
|
||||
`paperspec check` compares the result after every correction with a slow computation that projects each node from its whole subtree.
|
||||
|
||||
Other repositories of the project do not reimplement the specification: they install this repository as the Python package `paperspec`, from the Gitea package registry or as a git pin ([deploy/](../deploy/README.md#install-from-the-registry)), and import the oracle from it, so that every key, identifier, canonical JSON string, package check and database form comes from one piece of code.
|
||||
The library surface they use is `keys`, `text`, `jcs`, `package`, `db`, `schema`, `rights`, `traces`, `structures` and `sequences`, with the schemas, SQL and vectors as package data: `paperspec.resources.path("sql")` finds a folder in an installed wheel and in an editable install alike.
|
||||
The library surface they use is `keys`, `text`, `jcs`, `package`, `db`, `schema`, `rights`, `traces`, `structures`, `sequences` and `data`, with the schemas, SQL and vectors as package data: `paperspec.resources.path("sql")` finds a folder in an installed wheel and in an editable install alike.
|
||||
The vectors travel with the package, but `resolve.jsonl`, `grading.jsonl`, `targets.jsonl` and `traces.jsonl` name a fixture package, and the fixtures stay in the repository.
|
||||
The package needs Python 3.14, the only version with the Unicode 16.0 character data the specification pins, and refuses to import on any other.
|
||||
Importing any of its modules needs only the standard library.
|
||||
|
||||
+6
-4
@@ -52,7 +52,7 @@ The procedure is the same for every file:
|
||||
3.
|
||||
Find the inputs and the expected outputs of the case.
|
||||
The table below says which fields are which, and the chapter it links defines the rule.
|
||||
Only nine files, `alignment`, `corrections`, `grading`, `resolve`, `rights`, `sequences`, `structures`, `targets` and `traces`, put the expected outputs under `expect`.
|
||||
Only ten files, `alignment`, `corrections`, `data`, `grading`, `resolve`, `rights`, `sequences`, `structures`, `targets` and `traces`, put the expected outputs under `expect`.
|
||||
In the other nineteen the expected outputs are fields beside the inputs, such as `output`, `sha256`, `canonical` or `parsed`.
|
||||
4.
|
||||
Compute each output from the inputs with your implementation.
|
||||
@@ -77,15 +77,16 @@ Some files change the procedure:
|
||||
- `traces.jsonl` names two packages, `citing` (the draft) and `cited` (the main example), and for a `resolve` case lists the corrections to apply to each, in order, before judging the trace, and the `same_as` identifiers of the cited work.
|
||||
Apply them with the gate ([11.4](../spec/11-corrections.md#114-the-gate)) to the package's state at its own revision.
|
||||
A `problems` case gives the packages' states as they are, and `cited` is null when the trace names no passage in the main example.
|
||||
- `structures.jsonl` and `sequences.jsonl` need no package.
|
||||
- `structures.jsonl`, `sequences.jsonl` and `data.jsonl` need no package.
|
||||
A `scan` case (structures) gives a SMILES or SMARTS in `text` and its `format`, and expects the number of `atoms` and the `bonds` between them as pairs of atom numbers in order, or null when the text is refused.
|
||||
An `identity` case expects the identity the body carries, from `text` and `inchikey` (structures) or from `text` and `alphabet` (sequences).
|
||||
A `problems` case gives a whole annotation and expects the list of rules it breaks, in the order checked; `schema` says whether `schemas/annotation.schema.json` accepts it, because some cases are refused by the schema as well as by a rule.
|
||||
A `problems` case of `data.jsonl` may also give the `dataset`, the dataset's `datapackage.json` parsed; the rule `layer.data.dataset` then compares the annotation's dataset ID, fields and units with it, and without one it checks only the form of the ID.
|
||||
|
||||
Several files also mix more than one kind of case, told apart by their fields.
|
||||
`ids.jsonl` has minting cases and letter-first cases, `keyed.jsonl` and `signatures.jsonl` have a case for each derivation or record, `spotcheck.jsonl` has sample-size cases and one full sample, and `rights.jsonl` has stage checks (a `stage` field), backend checks (a `backend` field) and one combining case (neither).
|
||||
|
||||
The reference checker, `paperspec check` ([tools/](../tools/README.md)), runs all twenty-eight files, together with the rest of the repository's checks:
|
||||
The reference checker, `paperspec check` ([tools/](../tools/README.md)), runs all twenty-nine files, together with the rest of the repository's checks:
|
||||
|
||||
```sh
|
||||
paperspec check --quick
|
||||
@@ -130,6 +131,7 @@ The table below uses a few terms that the chapters define:
|
||||
| `traces.jsonl` | Traced citations: a trace on the draft's sentence that cites the main example, with the corrections that make it current, changed, stale, unlinked or misresolved, the passage's current address and the citations inside it (`op` `resolve`); and traces that break `layer.trace.source` or `layer.trace.target` (`op` `problems`). | [18.5](../spec/18-layers.md#185-traced-citations) |
|
||||
| `structures.jsonl` | Chemical structures: the atoms and bonds that SMILES and SMARTS texts write, and the texts that are refused (`op` `scan`); the identity of a structure with and without an InChIKey (`op` `identity`); and annotations that are valid or break `layer.structure.value`, `layer.structure.identity` or `layer.structure.term` (`op` `problems`). | [18.6](../spec/18-layers.md#186-chemical-structures) |
|
||||
| `sequences.jsonl` | Sequences: the identity of a sequence with and without gaps and in each alphabet (`op` `identity`); and annotations that are valid or break `layer.sequence.value`, `layer.sequence.identity`, `layer.sequence.region` or `layer.sequence.variant` (`op` `problems`). | [18.7](../spec/18-layers.md#187-sequences) |
|
||||
| `data.jsonl` | Data: annotations that are valid, one for each kind of data, or break `layer.data.type`, `layer.data.quantity`, `layer.data.subject` or `layer.data.dataset` (`op` `problems`), some of them checked against the dataset's descriptor. | [18.8](../spec/18-layers.md#188-data) |
|
||||
| `rights.jsonl` | Stage checks with policies and expiry, the combining rule, and backend conditions. | [14](../spec/14-rights.md) |
|
||||
| `grading.jsonl` | Exercises, submissions and the grades they earn. | [19.4](../spec/19-exercises.md#194-grading) |
|
||||
| `targets.jsonl` | The target set of targeted F3 for the example paper under each digit rule, given the anchored nodes. | [8.10](../spec/08-fidelity.md#810-targeted-f3) |
|
||||
@@ -148,7 +150,7 @@ A candidate format changes only with a recorded reason and a new or changed vect
|
||||
|
||||
A passing run shows one thing: for these inputs, your implementation computes the same values as the reference implementation in `src/paperspec/`.
|
||||
That code computed the expected outputs, and `pixi run build` regenerates them ([tools/](../tools/README.md)).
|
||||
The vectors hold 454 cases in all, some of them small: `hashes.jsonl` has two documents, `alignment.jsonl` two pairs of readings, `offsets.jsonl` two cases.
|
||||
The vectors hold 489 cases in all, some of them small: `hashes.jsonl` has two documents, `alignment.jsonl` two pairs of readings, `offsets.jsonl` two cases.
|
||||
|
||||
The vectors do not show the following.
|
||||
|
||||
|
||||
@@ -0,0 +1,35 @@
|
||||
{"annotation":{"@context":["http://www.w3.org/ns/anno.jsonld","https://paperspec.scient.ing/context/scienting-1.jsonld"],"body":{"data_type":"abundance","kind":"data","role":"reports","type":"TextualBody","value":"Data of the kind abundance"},"created":"2026-10-14T09:10:00Z","creator":{"id":"tag:scient.ing,2026:software:example-model","name":"A model (illustrative)","type":"Software"},"id":"tag:scient.ing,2026:annotation:smithlab/j4c41y21r5a8f","layer":"tag:scient.ing,2026:layer:smithlab/dt9n2k5y","motivation":"classifying","status":"proposed","target":{"selector":[{"anchor":{"doc":"hale2026harmonic-damb","format":"scienting-anchor/1","kind":"sentence","node":"a4jrz2t","node_hash":"f64c6a5040f9c773d5ac4e559b58465aeae30bba79a82fc38b14ac7b61826ba8","own_hash":"dde95db22e0600c8e6da72dd6701436315a786655cb74fc313a4bf574c9356ee","quote":{"exact":"Table 1 lists the fitted constants for both parameter sets."},"rev":12,"store":"smithlab"},"type":"AnchorSelector"},{"exact":"Table 1 lists the fitted constants for both parameter sets.","prefix":"","suffix":"","type":"TextQuoteSelector"}],"source":"tag:scient.ing,2026:doc:smithlab/hale2026harmonic-damb","type":"SpecificResource"},"type":"Annotation"},"expect":[],"id":"valid-kind-abundance","note":"Counts, expression levels or concentrations measured in samples.","op":"problems","schema":true}
|
||||
{"annotation":{"@context":["http://www.w3.org/ns/anno.jsonld","https://paperspec.scient.ing/context/scienting-1.jsonld"],"body":{"data_type":"benchmark","kind":"data","role":"reports","type":"TextualBody","value":"Data of the kind benchmark"},"created":"2026-10-14T09:10:00Z","creator":{"id":"tag:scient.ing,2026:software:example-model","name":"A model (illustrative)","type":"Software"},"id":"tag:scient.ing,2026:annotation:smithlab/j4c41y21r5a8f","layer":"tag:scient.ing,2026:layer:smithlab/dt9n2k5y","motivation":"classifying","status":"proposed","target":{"selector":[{"anchor":{"doc":"hale2026harmonic-damb","format":"scienting-anchor/1","kind":"sentence","node":"a4jrz2t","node_hash":"f64c6a5040f9c773d5ac4e559b58465aeae30bba79a82fc38b14ac7b61826ba8","own_hash":"dde95db22e0600c8e6da72dd6701436315a786655cb74fc313a4bf574c9356ee","quote":{"exact":"Table 1 lists the fitted constants for both parameter sets."},"rev":12,"store":"smithlab"},"type":"AnchorSelector"},{"exact":"Table 1 lists the fitted constants for both parameter sets.","prefix":"","suffix":"","type":"TextQuoteSelector"}],"source":"tag:scient.ing,2026:doc:smithlab/hale2026harmonic-damb","type":"SpecificResource"},"type":"Annotation"},"expect":[],"id":"valid-kind-benchmark","note":"How well a method or model does against a reference or against other methods: errors, scores, run times.","op":"problems","schema":true}
|
||||
{"annotation":{"@context":["http://www.w3.org/ns/anno.jsonld","https://paperspec.scient.ing/context/scienting-1.jsonld"],"body":{"data_type":"binding-affinity","kind":"data","role":"reports","type":"TextualBody","value":"Data of the kind binding-affinity"},"created":"2026-10-14T09:10:00Z","creator":{"id":"tag:scient.ing,2026:software:example-model","name":"A model (illustrative)","type":"Software"},"id":"tag:scient.ing,2026:annotation:smithlab/j4c41y21r5a8f","layer":"tag:scient.ing,2026:layer:smithlab/dt9n2k5y","motivation":"classifying","status":"proposed","target":{"selector":[{"anchor":{"doc":"hale2026harmonic-damb","format":"scienting-anchor/1","kind":"sentence","node":"a4jrz2t","node_hash":"f64c6a5040f9c773d5ac4e559b58465aeae30bba79a82fc38b14ac7b61826ba8","own_hash":"dde95db22e0600c8e6da72dd6701436315a786655cb74fc313a4bf574c9356ee","quote":{"exact":"Table 1 lists the fitted constants for both parameter sets."},"rev":12,"store":"smithlab"},"type":"AnchorSelector"},{"exact":"Table 1 lists the fitted constants for both parameter sets.","prefix":"","suffix":"","type":"TextQuoteSelector"}],"source":"tag:scient.ing,2026:doc:smithlab/hale2026harmonic-damb","type":"SpecificResource"},"type":"Annotation"},"expect":[],"id":"valid-kind-binding-affinity","note":"How tightly molecules bind: dissociation constants, inhibition constants, IC50, binding free energies.","op":"problems","schema":true}
|
||||
{"annotation":{"@context":["http://www.w3.org/ns/anno.jsonld","https://paperspec.scient.ing/context/scienting-1.jsonld"],"body":{"data_type":"dose-response","kind":"data","role":"reports","type":"TextualBody","value":"Data of the kind dose-response"},"created":"2026-10-14T09:10:00Z","creator":{"id":"tag:scient.ing,2026:software:example-model","name":"A model (illustrative)","type":"Software"},"id":"tag:scient.ing,2026:annotation:smithlab/j4c41y21r5a8f","layer":"tag:scient.ing,2026:layer:smithlab/dt9n2k5y","motivation":"classifying","status":"proposed","target":{"selector":[{"anchor":{"doc":"hale2026harmonic-damb","format":"scienting-anchor/1","kind":"sentence","node":"a4jrz2t","node_hash":"f64c6a5040f9c773d5ac4e559b58465aeae30bba79a82fc38b14ac7b61826ba8","own_hash":"dde95db22e0600c8e6da72dd6701436315a786655cb74fc313a4bf574c9356ee","quote":{"exact":"Table 1 lists the fitted constants for both parameter sets."},"rev":12,"store":"smithlab"},"type":"AnchorSelector"},{"exact":"Table 1 lists the fitted constants for both parameter sets.","prefix":"","suffix":"","type":"TextQuoteSelector"}],"source":"tag:scient.ing,2026:doc:smithlab/hale2026harmonic-damb","type":"SpecificResource"},"type":"Annotation"},"expect":[],"id":"valid-kind-dose-response","note":"A response as a function of dose or concentration.","op":"problems","schema":true}
|
||||
{"annotation":{"@context":["http://www.w3.org/ns/anno.jsonld","https://paperspec.scient.ing/context/scienting-1.jsonld"],"body":{"data_type":"energy-profile","kind":"data","role":"reports","type":"TextualBody","value":"Data of the kind energy-profile"},"created":"2026-10-14T09:10:00Z","creator":{"id":"tag:scient.ing,2026:software:example-model","name":"A model (illustrative)","type":"Software"},"id":"tag:scient.ing,2026:annotation:smithlab/j4c41y21r5a8f","layer":"tag:scient.ing,2026:layer:smithlab/dt9n2k5y","motivation":"classifying","status":"proposed","target":{"selector":[{"anchor":{"doc":"hale2026harmonic-damb","format":"scienting-anchor/1","kind":"sentence","node":"a4jrz2t","node_hash":"f64c6a5040f9c773d5ac4e559b58465aeae30bba79a82fc38b14ac7b61826ba8","own_hash":"dde95db22e0600c8e6da72dd6701436315a786655cb74fc313a4bf574c9356ee","quote":{"exact":"Table 1 lists the fitted constants for both parameter sets."},"rev":12,"store":"smithlab"},"type":"AnchorSelector"},{"exact":"Table 1 lists the fitted constants for both parameter sets.","prefix":"","suffix":"","type":"TextQuoteSelector"}],"source":"tag:scient.ing,2026:doc:smithlab/hale2026harmonic-damb","type":"SpecificResource"},"type":"Annotation"},"expect":[],"id":"valid-kind-energy-profile","note":"Energy along a coordinate: scans, potentials of mean force, reaction paths.","op":"problems","schema":true}
|
||||
{"annotation":{"@context":["http://www.w3.org/ns/anno.jsonld","https://paperspec.scient.ing/context/scienting-1.jsonld"],"body":{"data_type":"force-field-parameters","kind":"data","role":"reports","type":"TextualBody","value":"Data of the kind force-field-parameters"},"created":"2026-10-14T09:10:00Z","creator":{"id":"tag:scient.ing,2026:software:example-model","name":"A model (illustrative)","type":"Software"},"id":"tag:scient.ing,2026:annotation:smithlab/j4c41y21r5a8f","layer":"tag:scient.ing,2026:layer:smithlab/dt9n2k5y","motivation":"classifying","status":"proposed","target":{"selector":[{"anchor":{"doc":"hale2026harmonic-damb","format":"scienting-anchor/1","kind":"sentence","node":"a4jrz2t","node_hash":"f64c6a5040f9c773d5ac4e559b58465aeae30bba79a82fc38b14ac7b61826ba8","own_hash":"dde95db22e0600c8e6da72dd6701436315a786655cb74fc313a4bf574c9356ee","quote":{"exact":"Table 1 lists the fitted constants for both parameter sets."},"rev":12,"store":"smithlab"},"type":"AnchorSelector"},{"exact":"Table 1 lists the fitted constants for both parameter sets.","prefix":"","suffix":"","type":"TextQuoteSelector"}],"source":"tag:scient.ing,2026:doc:smithlab/hale2026harmonic-damb","type":"SpecificResource"},"type":"Annotation"},"expect":[],"id":"valid-kind-force-field-parameters","note":"Constants a force field or model uses for bonded and non-bonded terms.","op":"problems","schema":true}
|
||||
{"annotation":{"@context":["http://www.w3.org/ns/anno.jsonld","https://paperspec.scient.ing/context/scienting-1.jsonld"],"body":{"data_type":"geometry","kind":"data","role":"reports","type":"TextualBody","value":"Data of the kind geometry"},"created":"2026-10-14T09:10:00Z","creator":{"id":"tag:scient.ing,2026:software:example-model","name":"A model (illustrative)","type":"Software"},"id":"tag:scient.ing,2026:annotation:smithlab/j4c41y21r5a8f","layer":"tag:scient.ing,2026:layer:smithlab/dt9n2k5y","motivation":"classifying","status":"proposed","target":{"selector":[{"anchor":{"doc":"hale2026harmonic-damb","format":"scienting-anchor/1","kind":"sentence","node":"a4jrz2t","node_hash":"f64c6a5040f9c773d5ac4e559b58465aeae30bba79a82fc38b14ac7b61826ba8","own_hash":"dde95db22e0600c8e6da72dd6701436315a786655cb74fc313a4bf574c9356ee","quote":{"exact":"Table 1 lists the fitted constants for both parameter sets."},"rev":12,"store":"smithlab"},"type":"AnchorSelector"},{"exact":"Table 1 lists the fitted constants for both parameter sets.","prefix":"","suffix":"","type":"TextQuoteSelector"}],"source":"tag:scient.ing,2026:doc:smithlab/hale2026harmonic-damb","type":"SpecificResource"},"type":"Annotation"},"expect":[],"id":"valid-kind-geometry","note":"Lengths, angles, torsions, distances or deviations of structures.","op":"problems","schema":true}
|
||||
{"annotation":{"@context":["http://www.w3.org/ns/anno.jsonld","https://paperspec.scient.ing/context/scienting-1.jsonld"],"body":{"data_type":"kinetics","kind":"data","role":"reports","type":"TextualBody","value":"Data of the kind kinetics"},"created":"2026-10-14T09:10:00Z","creator":{"id":"tag:scient.ing,2026:software:example-model","name":"A model (illustrative)","type":"Software"},"id":"tag:scient.ing,2026:annotation:smithlab/j4c41y21r5a8f","layer":"tag:scient.ing,2026:layer:smithlab/dt9n2k5y","motivation":"classifying","status":"proposed","target":{"selector":[{"anchor":{"doc":"hale2026harmonic-damb","format":"scienting-anchor/1","kind":"sentence","node":"a4jrz2t","node_hash":"f64c6a5040f9c773d5ac4e559b58465aeae30bba79a82fc38b14ac7b61826ba8","own_hash":"dde95db22e0600c8e6da72dd6701436315a786655cb74fc313a4bf574c9356ee","quote":{"exact":"Table 1 lists the fitted constants for both parameter sets."},"rev":12,"store":"smithlab"},"type":"AnchorSelector"},{"exact":"Table 1 lists the fitted constants for both parameter sets.","prefix":"","suffix":"","type":"TextQuoteSelector"}],"source":"tag:scient.ing,2026:doc:smithlab/hale2026harmonic-damb","type":"SpecificResource"},"type":"Annotation"},"expect":[],"id":"valid-kind-kinetics","note":"Rates, rate constants, half-lives and barriers.","op":"problems","schema":true}
|
||||
{"annotation":{"@context":["http://www.w3.org/ns/anno.jsonld","https://paperspec.scient.ing/context/scienting-1.jsonld"],"body":{"data_type":"physical-property","kind":"data","role":"reports","type":"TextualBody","value":"Data of the kind physical-property"},"created":"2026-10-14T09:10:00Z","creator":{"id":"tag:scient.ing,2026:software:example-model","name":"A model (illustrative)","type":"Software"},"id":"tag:scient.ing,2026:annotation:smithlab/j4c41y21r5a8f","layer":"tag:scient.ing,2026:layer:smithlab/dt9n2k5y","motivation":"classifying","status":"proposed","target":{"selector":[{"anchor":{"doc":"hale2026harmonic-damb","format":"scienting-anchor/1","kind":"sentence","node":"a4jrz2t","node_hash":"f64c6a5040f9c773d5ac4e559b58465aeae30bba79a82fc38b14ac7b61826ba8","own_hash":"dde95db22e0600c8e6da72dd6701436315a786655cb74fc313a4bf574c9356ee","quote":{"exact":"Table 1 lists the fitted constants for both parameter sets."},"rev":12,"store":"smithlab"},"type":"AnchorSelector"},{"exact":"Table 1 lists the fitted constants for both parameter sets.","prefix":"","suffix":"","type":"TextQuoteSelector"}],"source":"tag:scient.ing,2026:doc:smithlab/hale2026harmonic-damb","type":"SpecificResource"},"type":"Annotation"},"expect":[],"id":"valid-kind-physical-property","note":"A property of a substance: density, melting point, pKa, logP, solubility.","op":"problems","schema":true}
|
||||
{"annotation":{"@context":["http://www.w3.org/ns/anno.jsonld","https://paperspec.scient.ing/context/scienting-1.jsonld"],"body":{"data_type":"sequence-property","kind":"data","role":"reports","type":"TextualBody","value":"Data of the kind sequence-property"},"created":"2026-10-14T09:10:00Z","creator":{"id":"tag:scient.ing,2026:software:example-model","name":"A model (illustrative)","type":"Software"},"id":"tag:scient.ing,2026:annotation:smithlab/j4c41y21r5a8f","layer":"tag:scient.ing,2026:layer:smithlab/dt9n2k5y","motivation":"classifying","status":"proposed","target":{"selector":[{"anchor":{"doc":"hale2026harmonic-damb","format":"scienting-anchor/1","kind":"sentence","node":"a4jrz2t","node_hash":"f64c6a5040f9c773d5ac4e559b58465aeae30bba79a82fc38b14ac7b61826ba8","own_hash":"dde95db22e0600c8e6da72dd6701436315a786655cb74fc313a4bf574c9356ee","quote":{"exact":"Table 1 lists the fitted constants for both parameter sets."},"rev":12,"store":"smithlab"},"type":"AnchorSelector"},{"exact":"Table 1 lists the fitted constants for both parameter sets.","prefix":"","suffix":"","type":"TextQuoteSelector"}],"source":"tag:scient.ing,2026:doc:smithlab/hale2026harmonic-damb","type":"SpecificResource"},"type":"Annotation"},"expect":[],"id":"valid-kind-sequence-property","note":"Values for the positions of a sequence: conservation, disorder, fitness scores.","op":"problems","schema":true}
|
||||
{"annotation":{"@context":["http://www.w3.org/ns/anno.jsonld","https://paperspec.scient.ing/context/scienting-1.jsonld"],"body":{"data_type":"simulation-observable","kind":"data","role":"reports","type":"TextualBody","value":"Data of the kind simulation-observable"},"created":"2026-10-14T09:10:00Z","creator":{"id":"tag:scient.ing,2026:software:example-model","name":"A model (illustrative)","type":"Software"},"id":"tag:scient.ing,2026:annotation:smithlab/j4c41y21r5a8f","layer":"tag:scient.ing,2026:layer:smithlab/dt9n2k5y","motivation":"classifying","status":"proposed","target":{"selector":[{"anchor":{"doc":"hale2026harmonic-damb","format":"scienting-anchor/1","kind":"sentence","node":"a4jrz2t","node_hash":"f64c6a5040f9c773d5ac4e559b58465aeae30bba79a82fc38b14ac7b61826ba8","own_hash":"dde95db22e0600c8e6da72dd6701436315a786655cb74fc313a4bf574c9356ee","quote":{"exact":"Table 1 lists the fitted constants for both parameter sets."},"rev":12,"store":"smithlab"},"type":"AnchorSelector"},{"exact":"Table 1 lists the fitted constants for both parameter sets.","prefix":"","suffix":"","type":"TextQuoteSelector"}],"source":"tag:scient.ing,2026:doc:smithlab/hale2026harmonic-damb","type":"SpecificResource"},"type":"Annotation"},"expect":[],"id":"valid-kind-simulation-observable","note":"A quantity computed from a simulation: distributions, time series, order parameters.","op":"problems","schema":true}
|
||||
{"annotation":{"@context":["http://www.w3.org/ns/anno.jsonld","https://paperspec.scient.ing/context/scienting-1.jsonld"],"body":{"data_type":"spectrum","kind":"data","role":"reports","type":"TextualBody","value":"Data of the kind spectrum"},"created":"2026-10-14T09:10:00Z","creator":{"id":"tag:scient.ing,2026:software:example-model","name":"A model (illustrative)","type":"Software"},"id":"tag:scient.ing,2026:annotation:smithlab/j4c41y21r5a8f","layer":"tag:scient.ing,2026:layer:smithlab/dt9n2k5y","motivation":"classifying","status":"proposed","target":{"selector":[{"anchor":{"doc":"hale2026harmonic-damb","format":"scienting-anchor/1","kind":"sentence","node":"a4jrz2t","node_hash":"f64c6a5040f9c773d5ac4e559b58465aeae30bba79a82fc38b14ac7b61826ba8","own_hash":"dde95db22e0600c8e6da72dd6701436315a786655cb74fc313a4bf574c9356ee","quote":{"exact":"Table 1 lists the fitted constants for both parameter sets."},"rev":12,"store":"smithlab"},"type":"AnchorSelector"},{"exact":"Table 1 lists the fitted constants for both parameter sets.","prefix":"","suffix":"","type":"TextQuoteSelector"}],"source":"tag:scient.ing,2026:doc:smithlab/hale2026harmonic-damb","type":"SpecificResource"},"type":"Annotation"},"expect":[],"id":"valid-kind-spectrum","note":"A spectrum or its peaks: NMR, infrared, Raman, ultraviolet-visible, mass.","op":"problems","schema":true}
|
||||
{"annotation":{"@context":["http://www.w3.org/ns/anno.jsonld","https://paperspec.scient.ing/context/scienting-1.jsonld"],"body":{"data_type":"thermodynamics","kind":"data","role":"reports","type":"TextualBody","value":"Data of the kind thermodynamics"},"created":"2026-10-14T09:10:00Z","creator":{"id":"tag:scient.ing,2026:software:example-model","name":"A model (illustrative)","type":"Software"},"id":"tag:scient.ing,2026:annotation:smithlab/j4c41y21r5a8f","layer":"tag:scient.ing,2026:layer:smithlab/dt9n2k5y","motivation":"classifying","status":"proposed","target":{"selector":[{"anchor":{"doc":"hale2026harmonic-damb","format":"scienting-anchor/1","kind":"sentence","node":"a4jrz2t","node_hash":"f64c6a5040f9c773d5ac4e559b58465aeae30bba79a82fc38b14ac7b61826ba8","own_hash":"dde95db22e0600c8e6da72dd6701436315a786655cb74fc313a4bf574c9356ee","quote":{"exact":"Table 1 lists the fitted constants for both parameter sets."},"rev":12,"store":"smithlab"},"type":"AnchorSelector"},{"exact":"Table 1 lists the fitted constants for both parameter sets.","prefix":"","suffix":"","type":"TextQuoteSelector"}],"source":"tag:scient.ing,2026:doc:smithlab/hale2026harmonic-damb","type":"SpecificResource"},"type":"Annotation"},"expect":[],"id":"valid-kind-thermodynamics","note":"Enthalpy, entropy, free energy, heat capacity, or a melting temperature of a process.","op":"problems","schema":true}
|
||||
{"annotation":{"@context":["http://www.w3.org/ns/anno.jsonld","https://paperspec.scient.ing/context/scienting-1.jsonld"],"body":{"data_type":"variant-effect","kind":"data","role":"reports","type":"TextualBody","value":"Data of the kind variant-effect"},"created":"2026-10-14T09:10:00Z","creator":{"id":"tag:scient.ing,2026:software:example-model","name":"A model (illustrative)","type":"Software"},"id":"tag:scient.ing,2026:annotation:smithlab/j4c41y21r5a8f","layer":"tag:scient.ing,2026:layer:smithlab/dt9n2k5y","motivation":"classifying","status":"proposed","target":{"selector":[{"anchor":{"doc":"hale2026harmonic-damb","format":"scienting-anchor/1","kind":"sentence","node":"a4jrz2t","node_hash":"f64c6a5040f9c773d5ac4e559b58465aeae30bba79a82fc38b14ac7b61826ba8","own_hash":"dde95db22e0600c8e6da72dd6701436315a786655cb74fc313a4bf574c9356ee","quote":{"exact":"Table 1 lists the fitted constants for both parameter sets."},"rev":12,"store":"smithlab"},"type":"AnchorSelector"},{"exact":"Table 1 lists the fitted constants for both parameter sets.","prefix":"","suffix":"","type":"TextQuoteSelector"}],"source":"tag:scient.ing,2026:doc:smithlab/hale2026harmonic-damb","type":"SpecificResource"},"type":"Annotation"},"expect":[],"id":"valid-kind-variant-effect","note":"What a change to a sequence or a structure does to a property.","op":"problems","schema":true}
|
||||
{"annotation":{"@context":["http://www.w3.org/ns/anno.jsonld","https://paperspec.scient.ing/context/scienting-1.jsonld"],"body":{"data_type":"other","kind":"data","role":"reports","type":"TextualBody","value":"Data of the kind other"},"created":"2026-10-14T09:10:00Z","creator":{"id":"tag:scient.ing,2026:software:example-model","name":"A model (illustrative)","type":"Software"},"id":"tag:scient.ing,2026:annotation:smithlab/j4c41y21r5a8f","layer":"tag:scient.ing,2026:layer:smithlab/dt9n2k5y","motivation":"classifying","status":"proposed","target":{"selector":[{"anchor":{"doc":"hale2026harmonic-damb","format":"scienting-anchor/1","kind":"sentence","node":"a4jrz2t","node_hash":"f64c6a5040f9c773d5ac4e559b58465aeae30bba79a82fc38b14ac7b61826ba8","own_hash":"dde95db22e0600c8e6da72dd6701436315a786655cb74fc313a4bf574c9356ee","quote":{"exact":"Table 1 lists the fitted constants for both parameter sets."},"rev":12,"store":"smithlab"},"type":"AnchorSelector"},{"exact":"Table 1 lists the fitted constants for both parameter sets.","prefix":"","suffix":"","type":"TextQuoteSelector"}],"source":"tag:scient.ing,2026:doc:smithlab/hale2026harmonic-damb","type":"SpecificResource"},"type":"Annotation"},"expect":[],"id":"valid-kind-other","note":"Data none of these describes; the value says what it is.","op":"problems","schema":true}
|
||||
{"annotation":{"@context":["http://www.w3.org/ns/anno.jsonld","https://paperspec.scient.ing/context/scienting-1.jsonld"],"body":{"data_type":"force-field-parameters","dataset":"ds-hale-bond-params","kind":"data","label":"bond parameters","method":"scanned in steps of 0.01 Å, energies fitted by least squares","quantities":[{"field":"k_r","name":"harmonic bond force constant","unit":"kcal / mol / angstrom ** 2"},{"field":"r_eq","name":"equilibrium bond length","unit":"angstrom"}],"role":"reports","subjects":[{"identity":"OTMSDBZUPAUEDD-UHFFFAOYSA-N","kind":"structure","label":"ethane"},{"identity":"XLYOFNOQVPJJNP-UHFFFAOYSA-N","kind":"structure","label":"water"},{"identity":"smarts:2e2a923f840c","kind":"structure","label":"CT–CT"}],"type":"TextualBody","value":"Harmonic bond constants for CT–CT, CT–HC and OW–HW, in two parameter sets"},"created":"2026-10-14T09:00:00Z","creator":{"id":"tag:scient.ing,2026:key:ana","name":"Ana Example","type":"Person"},"id":"tag:scient.ing,2026:annotation:smithlab/c4648hbwpavgp","layer":"tag:scient.ing,2026:layer:smithlab/dt9n2k5y","motivation":"classifying","receipt":"v84xfyx5n1wg4","status":"confirmed","target":{"selector":[{"anchor":{"doc":"hale2026harmonic-damb","format":"scienting-anchor/1","kind":"sentence","node":"wxxhb3s","node_hash":"52063ded5cf76abdd32ba5c1d0d5d7348843eb0516ad29f5b1f249964e015b50","own_hash":"506d3bd0afffb1dff34f1563338d538c85be50434905c86784a94b747f979bc3","quote":{"exact":"Fitted harmonic bond parameters."},"rev":12,"store":"smithlab"},"type":"AnchorSelector"},{"exact":"Fitted harmonic bond parameters.","prefix":"","suffix":"","type":"TextQuoteSelector"}],"source":"tag:scient.ing,2026:doc:smithlab/hale2026harmonic-damb","type":"SpecificResource"},"type":"Annotation"},"expect":[],"id":"valid-a-table","note":"The caption of Table 1, tied to its dataset, two quantities and three subjects.","op":"problems","schema":true}
|
||||
{"annotation":{"@context":["http://www.w3.org/ns/anno.jsonld","https://paperspec.scient.ing/context/scienting-1.jsonld"],"body":{"data_type":"force-field-parameters","dataset":"ds-hale-bond-params","kind":"data","label":"bond parameters","method":"scanned in steps of 0.01 Å, energies fitted by least squares","quantities":[{"field":"k_r","name":"harmonic bond force constant","unit":"kcal / mol / angstrom ** 2"},{"field":"r_eq","name":"equilibrium bond length","unit":"angstrom"}],"role":"reports","subjects":[{"identity":"OTMSDBZUPAUEDD-UHFFFAOYSA-N","kind":"structure","label":"ethane"},{"identity":"XLYOFNOQVPJJNP-UHFFFAOYSA-N","kind":"structure","label":"water"},{"identity":"smarts:2e2a923f840c","kind":"structure","label":"CT–CT"}],"type":"TextualBody","value":"Harmonic bond constants for CT–CT, CT–HC and OW–HW, in two parameter sets"},"created":"2026-10-14T09:00:00Z","creator":{"id":"tag:scient.ing,2026:key:ana","name":"Ana Example","type":"Person"},"id":"tag:scient.ing,2026:annotation:smithlab/c4648hbwpavgp","layer":"tag:scient.ing,2026:layer:smithlab/dt9n2k5y","motivation":"classifying","receipt":"v84xfyx5n1wg4","status":"confirmed","target":{"selector":[{"anchor":{"doc":"hale2026harmonic-damb","format":"scienting-anchor/1","kind":"sentence","node":"wxxhb3s","node_hash":"52063ded5cf76abdd32ba5c1d0d5d7348843eb0516ad29f5b1f249964e015b50","own_hash":"506d3bd0afffb1dff34f1563338d538c85be50434905c86784a94b747f979bc3","quote":{"exact":"Fitted harmonic bond parameters."},"rev":12,"store":"smithlab"},"type":"AnchorSelector"},{"exact":"Fitted harmonic bond parameters.","prefix":"","suffix":"","type":"TextQuoteSelector"}],"source":"tag:scient.ing,2026:doc:smithlab/hale2026harmonic-damb","type":"SpecificResource"},"type":"Annotation"},"dataset":{"format":"scienting-dataset/1","id":"ds-hale-bond-params","name":"hale-bond-params","resources":[{"encoding":"utf-8","format":"csv","name":"bond-parameters","origin":{"anchors":"anchors.jsonl","kind":"reported"},"path":"data.csv","schema":{"fields":[{"name":"key","type":"string"},{"name":"bond","type":"string"},{"name":"set","type":"string"},{"name":"k_r","type":"number","unit":"kcal / mol / angstrom ** 2"},{"name":"r_eq","type":"number","uncertainty":{"kind":"unknown"},"unit":"angstrom"}],"primaryKey":"key"}}],"title":"Harmonic bond parameters reported in Table 1"},"expect":[],"id":"valid-a-table-against-its-dataset","note":"The same, checked against the dataset's descriptor.","op":"problems","schema":true}
|
||||
{"annotation":{"@context":["http://www.w3.org/ns/anno.jsonld","https://paperspec.scient.ing/context/scienting-1.jsonld"],"body":{"data_type":"energy-profile","dataset":"ds-hale-ctct-scan","kind":"data","label":"CT–CT scan","method":"scanned in steps of 0.01 Å around the minimum","quantities":[{"field":"r","name":"C–C bond length","unit":"angstrom"},{"field":"e","name":"energy","unit":"kcal / mol"}],"role":"reports","subjects":[{"identity":"OTMSDBZUPAUEDD-UHFFFAOYSA-N","kind":"structure","label":"ethane"}],"type":"TextualBody","value":"Energy along the C–C stretch of ethane"},"created":"2026-10-14T09:05:00Z","creator":{"id":"tag:scient.ing,2026:key:ana","name":"Ana Example","type":"Person"},"id":"tag:scient.ing,2026:annotation:smithlab/d3b924s8ve538","layer":"tag:scient.ing,2026:layer:smithlab/dt9n2k5y","motivation":"classifying","receipt":"v84xfyx5n1wg4","status":"confirmed","target":{"selector":[{"anchor":{"doc":"hale2026harmonic-damb","format":"scienting-anchor/1","kind":"sentence","node":"caehhp6","node_hash":"9f9c9a412cd08d0634daa3f23c63f5125c1270c13834c45c045c1a9a7452af86","own_hash":"75a68ec1ba13ad2d3fb7ef61634103b8740eb98494ca8fb607a3429f464ed278","quote":{"exact":"(a) The scan."},"rev":12,"store":"smithlab"},"type":"AnchorSelector"},{"exact":"(a) The scan.","prefix":"","suffix":"","type":"TextQuoteSelector"}],"source":"tag:scient.ing,2026:doc:smithlab/hale2026harmonic-damb","type":"SpecificResource"},"type":"Annotation"},"dataset":{"format":"scienting-dataset/1","id":"ds-hale-ctct-scan","name":"hale-ctct-scan","resources":[{"encoding":"utf-8","format":"csv","name":"scan","origin":{"anchors":"anchors.jsonl","digitization":"n43jx89tgmmzy","kind":"digitized"},"path":"data.csv","schema":{"fields":[{"name":"point","type":"string"},{"name":"r","type":"number","uncertainty":{"field":"r_u","kind":"resolution"},"unit":"angstrom"},{"name":"r_u","type":"number","unit":"angstrom"},{"name":"e","type":"number","uncertainty":{"field":"e_u","kind":"resolution"},"unit":"kcal / mol"},{"name":"e_u","type":"number","unit":"kcal / mol"}],"primaryKey":"point"}}],"title":"Energy along the C–C stretch, read from Figure 1a"},"expect":[],"id":"valid-a-figure-panel-against-its-dataset","note":"Figure 1a, whose dataset was read from it.","op":"problems","schema":true}
|
||||
{"annotation":{"@context":["http://www.w3.org/ns/anno.jsonld","https://paperspec.scient.ing/context/scienting-1.jsonld"],"body":{"data_type":"force-field-parameters","dataset":"ds-hale-bond-params","kind":"data","role":"uses","type":"TextualBody","value":"The fitted bond constants of Table 1, which this sentence introduces"},"created":"2026-10-14T09:10:00Z","creator":{"id":"tag:scient.ing,2026:software:example-model","name":"A model (illustrative)","type":"Software"},"id":"tag:scient.ing,2026:annotation:smithlab/j4c41y21r5a8f","layer":"tag:scient.ing,2026:layer:smithlab/dt9n2k5y","motivation":"classifying","status":"proposed","target":{"selector":[{"anchor":{"doc":"hale2026harmonic-damb","format":"scienting-anchor/1","kind":"sentence","node":"a4jrz2t","node_hash":"f64c6a5040f9c773d5ac4e559b58465aeae30bba79a82fc38b14ac7b61826ba8","own_hash":"dde95db22e0600c8e6da72dd6701436315a786655cb74fc313a4bf574c9356ee","quote":{"exact":"Table 1 lists the fitted constants for both parameter sets."},"rev":12,"store":"smithlab"},"type":"AnchorSelector"},{"exact":"Table 1 lists the fitted constants for both parameter sets.","prefix":"","suffix":"","type":"TextQuoteSelector"}],"source":"tag:scient.ing,2026:doc:smithlab/hale2026harmonic-damb","type":"SpecificResource"},"type":"Annotation"},"expect":[],"id":"valid-a-passage-that-uses-data","note":"A sentence that introduces a table: the role is uses.","op":"problems","schema":true}
|
||||
{"annotation":{"@context":["http://www.w3.org/ns/anno.jsonld","https://paperspec.scient.ing/context/scienting-1.jsonld"],"body":{"data_type":"benchmark","kind":"data","role":"reports","type":"TextualBody","value":"Run times of three methods on a test set"},"created":"2026-10-14T09:10:00Z","creator":{"id":"tag:scient.ing,2026:software:example-model","name":"A model (illustrative)","type":"Software"},"id":"tag:scient.ing,2026:annotation:smithlab/j4c41y21r5a8f","layer":"tag:scient.ing,2026:layer:smithlab/dt9n2k5y","motivation":"classifying","status":"proposed","target":{"selector":[{"anchor":{"doc":"hale2026harmonic-damb","format":"scienting-anchor/1","kind":"sentence","node":"a4jrz2t","node_hash":"f64c6a5040f9c773d5ac4e559b58465aeae30bba79a82fc38b14ac7b61826ba8","own_hash":"dde95db22e0600c8e6da72dd6701436315a786655cb74fc313a4bf574c9356ee","quote":{"exact":"Table 1 lists the fitted constants for both parameter sets."},"rev":12,"store":"smithlab"},"type":"AnchorSelector"},{"exact":"Table 1 lists the fitted constants for both parameter sets.","prefix":"","suffix":"","type":"TextQuoteSelector"}],"source":"tag:scient.ing,2026:doc:smithlab/hale2026harmonic-damb","type":"SpecificResource"},"type":"Annotation"},"expect":[],"id":"valid-no-dataset","note":"Data not yet extracted: no dataset, no quantities, no subjects.","op":"problems","schema":true}
|
||||
{"annotation":{"@context":["http://www.w3.org/ns/anno.jsonld","https://paperspec.scient.ing/context/scienting-1.jsonld"],"body":{"accessions":[{"db":"zenodo","id":"1234567"},{"db":"chmo","id":"0000594"}],"data_type":"variant-effect","kind":"data","method":"thermal denaturation, circular dichroism","role":"reports","subjects":[{"identity":"protein:5807fcbf6d5567ca","kind":"sequence","label":"HP35"}],"type":"TextualBody","value":"Folding stability of HP35 variants"},"created":"2026-10-14T09:10:00Z","creator":{"id":"tag:scient.ing,2026:software:example-model","name":"A model (illustrative)","type":"Software"},"id":"tag:scient.ing,2026:annotation:smithlab/j4c41y21r5a8f","layer":"tag:scient.ing,2026:layer:smithlab/dt9n2k5y","motivation":"classifying","status":"proposed","target":{"selector":[{"anchor":{"doc":"hale2026harmonic-damb","format":"scienting-anchor/1","kind":"sentence","node":"a4jrz2t","node_hash":"f64c6a5040f9c773d5ac4e559b58465aeae30bba79a82fc38b14ac7b61826ba8","own_hash":"dde95db22e0600c8e6da72dd6701436315a786655cb74fc313a4bf574c9356ee","quote":{"exact":"Table 1 lists the fitted constants for both parameter sets."},"rev":12,"store":"smithlab"},"type":"AnchorSelector"},{"exact":"Table 1 lists the fitted constants for both parameter sets.","prefix":"","suffix":"","type":"TextQuoteSelector"}],"source":"tag:scient.ing,2026:doc:smithlab/hale2026harmonic-damb","type":"SpecificResource"},"type":"Annotation"},"expect":[],"id":"valid-a-sequence-and-accessions","note":"A sequence as the subject, and two outside entries.","op":"problems","schema":true}
|
||||
{"annotation":{"@context":["http://www.w3.org/ns/anno.jsonld","https://paperspec.scient.ing/context/scienting-1.jsonld"],"body":{"data_type":"force-field-parameters","dataset":"ds-hale-bond-params","kind":"data","label":"bond parameters","method":"scanned in steps of 0.01 Å, energies fitted by least squares","quantities":[{"field":"k_r","name":"harmonic bond force constant"}],"role":"reports","subjects":[{"identity":"OTMSDBZUPAUEDD-UHFFFAOYSA-N","kind":"structure","label":"ethane"},{"identity":"XLYOFNOQVPJJNP-UHFFFAOYSA-N","kind":"structure","label":"water"},{"identity":"smarts:2e2a923f840c","kind":"structure","label":"CT–CT"}],"type":"TextualBody","value":"Harmonic bond constants for CT–CT, CT–HC and OW–HW, in two parameter sets"},"created":"2026-10-14T09:00:00Z","creator":{"id":"tag:scient.ing,2026:key:ana","name":"Ana Example","type":"Person"},"id":"tag:scient.ing,2026:annotation:smithlab/c4648hbwpavgp","layer":"tag:scient.ing,2026:layer:smithlab/dt9n2k5y","motivation":"classifying","receipt":"v84xfyx5n1wg4","status":"confirmed","target":{"selector":[{"anchor":{"doc":"hale2026harmonic-damb","format":"scienting-anchor/1","kind":"sentence","node":"wxxhb3s","node_hash":"52063ded5cf76abdd32ba5c1d0d5d7348843eb0516ad29f5b1f249964e015b50","own_hash":"506d3bd0afffb1dff34f1563338d538c85be50434905c86784a94b747f979bc3","quote":{"exact":"Fitted harmonic bond parameters."},"rev":12,"store":"smithlab"},"type":"AnchorSelector"},{"exact":"Fitted harmonic bond parameters.","prefix":"","suffix":"","type":"TextQuoteSelector"}],"source":"tag:scient.ing,2026:doc:smithlab/hale2026harmonic-damb","type":"SpecificResource"},"type":"Annotation"},"dataset":{"format":"scienting-dataset/1","id":"ds-hale-bond-params","name":"hale-bond-params","resources":[{"encoding":"utf-8","format":"csv","name":"bond-parameters","origin":{"anchors":"anchors.jsonl","kind":"reported"},"path":"data.csv","schema":{"fields":[{"name":"key","type":"string"},{"name":"bond","type":"string"},{"name":"set","type":"string"},{"name":"k_r","type":"number","unit":"kcal / mol / angstrom ** 2"},{"name":"r_eq","type":"number","uncertainty":{"kind":"unknown"},"unit":"angstrom"}],"primaryKey":"key"}}],"title":"Harmonic bond parameters reported in Table 1"},"expect":[],"id":"valid-a-quantity-without-a-unit","note":"The unit is optional.","op":"problems","schema":true}
|
||||
{"annotation":{"@context":["http://www.w3.org/ns/anno.jsonld","https://paperspec.scient.ing/context/scienting-1.jsonld"],"body":{"data_type":"force-field-parameters","dataset":"ds-hale-bond-params","kind":"data","label":"bond parameters","method":"scanned in steps of 0.01 Å, energies fitted by least squares","quantities":[{"field":"k_theta","name":"harmonic angle force constant"}],"role":"reports","subjects":[{"identity":"OTMSDBZUPAUEDD-UHFFFAOYSA-N","kind":"structure","label":"ethane"},{"identity":"XLYOFNOQVPJJNP-UHFFFAOYSA-N","kind":"structure","label":"water"},{"identity":"smarts:2e2a923f840c","kind":"structure","label":"CT–CT"}],"type":"TextualBody","value":"Harmonic bond constants for CT–CT, CT–HC and OW–HW, in two parameter sets"},"created":"2026-10-14T09:00:00Z","creator":{"id":"tag:scient.ing,2026:key:ana","name":"Ana Example","type":"Person"},"id":"tag:scient.ing,2026:annotation:smithlab/c4648hbwpavgp","layer":"tag:scient.ing,2026:layer:smithlab/dt9n2k5y","motivation":"classifying","receipt":"v84xfyx5n1wg4","status":"confirmed","target":{"selector":[{"anchor":{"doc":"hale2026harmonic-damb","format":"scienting-anchor/1","kind":"sentence","node":"wxxhb3s","node_hash":"52063ded5cf76abdd32ba5c1d0d5d7348843eb0516ad29f5b1f249964e015b50","own_hash":"506d3bd0afffb1dff34f1563338d538c85be50434905c86784a94b747f979bc3","quote":{"exact":"Fitted harmonic bond parameters."},"rev":12,"store":"smithlab"},"type":"AnchorSelector"},{"exact":"Fitted harmonic bond parameters.","prefix":"","suffix":"","type":"TextQuoteSelector"}],"source":"tag:scient.ing,2026:doc:smithlab/hale2026harmonic-damb","type":"SpecificResource"},"type":"Annotation"},"expect":[],"id":"valid-a-field-no-descriptor-was-given","note":"Without the descriptor the field cannot be checked.","op":"problems","schema":true}
|
||||
{"annotation":{"@context":["http://www.w3.org/ns/anno.jsonld","https://paperspec.scient.ing/context/scienting-1.jsonld"],"body":{"data_type":"spectroscopy","dataset":"ds-hale-bond-params","kind":"data","label":"bond parameters","method":"scanned in steps of 0.01 Å, energies fitted by least squares","quantities":[{"field":"k_r","name":"harmonic bond force constant","unit":"kcal / mol / angstrom ** 2"},{"field":"r_eq","name":"equilibrium bond length","unit":"angstrom"}],"role":"reports","subjects":[{"identity":"OTMSDBZUPAUEDD-UHFFFAOYSA-N","kind":"structure","label":"ethane"},{"identity":"XLYOFNOQVPJJNP-UHFFFAOYSA-N","kind":"structure","label":"water"},{"identity":"smarts:2e2a923f840c","kind":"structure","label":"CT–CT"}],"type":"TextualBody","value":"Harmonic bond constants for CT–CT, CT–HC and OW–HW, in two parameter sets"},"created":"2026-10-14T09:00:00Z","creator":{"id":"tag:scient.ing,2026:key:ana","name":"Ana Example","type":"Person"},"id":"tag:scient.ing,2026:annotation:smithlab/c4648hbwpavgp","layer":"tag:scient.ing,2026:layer:smithlab/dt9n2k5y","motivation":"classifying","receipt":"v84xfyx5n1wg4","status":"confirmed","target":{"selector":[{"anchor":{"doc":"hale2026harmonic-damb","format":"scienting-anchor/1","kind":"sentence","node":"wxxhb3s","node_hash":"52063ded5cf76abdd32ba5c1d0d5d7348843eb0516ad29f5b1f249964e015b50","own_hash":"506d3bd0afffb1dff34f1563338d538c85be50434905c86784a94b747f979bc3","quote":{"exact":"Fitted harmonic bond parameters."},"rev":12,"store":"smithlab"},"type":"AnchorSelector"},{"exact":"Fitted harmonic bond parameters.","prefix":"","suffix":"","type":"TextQuoteSelector"}],"source":"tag:scient.ing,2026:doc:smithlab/hale2026harmonic-damb","type":"SpecificResource"},"type":"Annotation"},"expect":[{"message":"the kind of data is not one of abundance, benchmark, binding-affinity, dose-response, energy-profile, force-field-parameters, geometry, kinetics, physical-property, sequence-property, simulation-observable, spectrum, thermodynamics, variant-effect, other","rule":"layer.data.type"}],"id":"type-an-unknown-kind","note":"Not a kind of data.","op":"problems","schema":false}
|
||||
{"annotation":{"@context":["http://www.w3.org/ns/anno.jsonld","https://paperspec.scient.ing/context/scienting-1.jsonld"],"body":{"data_type":"force-field-parameters","dataset":"ds-hale-bond-params","kind":"data","label":"bond parameters","method":"scanned in steps of 0.01 Å, energies fitted by least squares","quantities":[{"field":"k_r","name":"harmonic bond force constant","unit":"kcal / mol / angstrom ** 2"},{"field":"r_eq","name":"equilibrium bond length","unit":"angstrom"}],"role":"names","subjects":[{"identity":"OTMSDBZUPAUEDD-UHFFFAOYSA-N","kind":"structure","label":"ethane"},{"identity":"XLYOFNOQVPJJNP-UHFFFAOYSA-N","kind":"structure","label":"water"},{"identity":"smarts:2e2a923f840c","kind":"structure","label":"CT–CT"}],"type":"TextualBody","value":"Harmonic bond constants for CT–CT, CT–HC and OW–HW, in two parameter sets"},"created":"2026-10-14T09:00:00Z","creator":{"id":"tag:scient.ing,2026:key:ana","name":"Ana Example","type":"Person"},"id":"tag:scient.ing,2026:annotation:smithlab/c4648hbwpavgp","layer":"tag:scient.ing,2026:layer:smithlab/dt9n2k5y","motivation":"classifying","receipt":"v84xfyx5n1wg4","status":"confirmed","target":{"selector":[{"anchor":{"doc":"hale2026harmonic-damb","format":"scienting-anchor/1","kind":"sentence","node":"wxxhb3s","node_hash":"52063ded5cf76abdd32ba5c1d0d5d7348843eb0516ad29f5b1f249964e015b50","own_hash":"506d3bd0afffb1dff34f1563338d538c85be50434905c86784a94b747f979bc3","quote":{"exact":"Fitted harmonic bond parameters."},"rev":12,"store":"smithlab"},"type":"AnchorSelector"},{"exact":"Fitted harmonic bond parameters.","prefix":"","suffix":"","type":"TextQuoteSelector"}],"source":"tag:scient.ing,2026:doc:smithlab/hale2026harmonic-damb","type":"SpecificResource"},"type":"Annotation"},"expect":[{"message":"the role is not one of reports, uses","rule":"layer.data.type"}],"id":"type-an-unknown-role","note":"Not a role of this body.","op":"problems","schema":false}
|
||||
{"annotation":{"@context":["http://www.w3.org/ns/anno.jsonld","https://paperspec.scient.ing/context/scienting-1.jsonld"],"body":{"data_type":"force-field-parameters","dataset":"ds-hale-bond-params","kind":"data","label":"bond parameters","method":"scanned in steps of 0.01 Å, energies fitted by least squares","quantities":[{"field":"k_r","name":"harmonic bond force constant","unit":"kcal / mol / angstrom ** 2"},{"field":"r_eq","name":"equilibrium bond length","unit":"angstrom"},{"field":"k_r","name":"the force constant again"}],"role":"reports","subjects":[{"identity":"OTMSDBZUPAUEDD-UHFFFAOYSA-N","kind":"structure","label":"ethane"},{"identity":"XLYOFNOQVPJJNP-UHFFFAOYSA-N","kind":"structure","label":"water"},{"identity":"smarts:2e2a923f840c","kind":"structure","label":"CT–CT"}],"type":"TextualBody","value":"Harmonic bond constants for CT–CT, CT–HC and OW–HW, in two parameter sets"},"created":"2026-10-14T09:00:00Z","creator":{"id":"tag:scient.ing,2026:key:ana","name":"Ana Example","type":"Person"},"id":"tag:scient.ing,2026:annotation:smithlab/c4648hbwpavgp","layer":"tag:scient.ing,2026:layer:smithlab/dt9n2k5y","motivation":"classifying","receipt":"v84xfyx5n1wg4","status":"confirmed","target":{"selector":[{"anchor":{"doc":"hale2026harmonic-damb","format":"scienting-anchor/1","kind":"sentence","node":"wxxhb3s","node_hash":"52063ded5cf76abdd32ba5c1d0d5d7348843eb0516ad29f5b1f249964e015b50","own_hash":"506d3bd0afffb1dff34f1563338d538c85be50434905c86784a94b747f979bc3","quote":{"exact":"Fitted harmonic bond parameters."},"rev":12,"store":"smithlab"},"type":"AnchorSelector"},{"exact":"Fitted harmonic bond parameters.","prefix":"","suffix":"","type":"TextQuoteSelector"}],"source":"tag:scient.ing,2026:doc:smithlab/hale2026harmonic-damb","type":"SpecificResource"},"type":"Annotation"},"expect":[{"message":"quantity 2 repeats the field k_r","rule":"layer.data.quantity"}],"id":"quantity-a-field-twice","note":"Two quantities for k_r.","op":"problems","schema":true}
|
||||
{"annotation":{"@context":["http://www.w3.org/ns/anno.jsonld","https://paperspec.scient.ing/context/scienting-1.jsonld"],"body":{"data_type":"force-field-parameters","dataset":"ds-hale-bond-params","kind":"data","label":"bond parameters","method":"scanned in steps of 0.01 Å, energies fitted by least squares","quantities":[{"field":"k_r","name":"harmonic bond force constant","unit":"kcal / mol / angstrom ** 2"},{"field":"r_eq","name":"equilibrium bond length","unit":"angstrom"}],"role":"reports","subjects":[{"identity":"OTMSDBZUPAUEDD-UHFFFAOYSA-N","kind":"reaction"}],"type":"TextualBody","value":"Harmonic bond constants for CT–CT, CT–HC and OW–HW, in two parameter sets"},"created":"2026-10-14T09:00:00Z","creator":{"id":"tag:scient.ing,2026:key:ana","name":"Ana Example","type":"Person"},"id":"tag:scient.ing,2026:annotation:smithlab/c4648hbwpavgp","layer":"tag:scient.ing,2026:layer:smithlab/dt9n2k5y","motivation":"classifying","receipt":"v84xfyx5n1wg4","status":"confirmed","target":{"selector":[{"anchor":{"doc":"hale2026harmonic-damb","format":"scienting-anchor/1","kind":"sentence","node":"wxxhb3s","node_hash":"52063ded5cf76abdd32ba5c1d0d5d7348843eb0516ad29f5b1f249964e015b50","own_hash":"506d3bd0afffb1dff34f1563338d538c85be50434905c86784a94b747f979bc3","quote":{"exact":"Fitted harmonic bond parameters."},"rev":12,"store":"smithlab"},"type":"AnchorSelector"},{"exact":"Fitted harmonic bond parameters.","prefix":"","suffix":"","type":"TextQuoteSelector"}],"source":"tag:scient.ing,2026:doc:smithlab/hale2026harmonic-damb","type":"SpecificResource"},"type":"Annotation"},"expect":[{"message":"subject 0 is of a kind that is not structure or sequence","rule":"layer.data.subject"}],"id":"subject-a-kind-that-is-neither","note":"A subject is a structure or a sequence.","op":"problems","schema":false}
|
||||
{"annotation":{"@context":["http://www.w3.org/ns/anno.jsonld","https://paperspec.scient.ing/context/scienting-1.jsonld"],"body":{"data_type":"force-field-parameters","dataset":"ds-hale-bond-params","kind":"data","label":"bond parameters","method":"scanned in steps of 0.01 Å, energies fitted by least squares","quantities":[{"field":"k_r","name":"harmonic bond force constant","unit":"kcal / mol / angstrom ** 2"},{"field":"r_eq","name":"equilibrium bond length","unit":"angstrom"}],"role":"reports","subjects":[{"identity":"protein:5807fcbf6d5567ca","kind":"structure"}],"type":"TextualBody","value":"Harmonic bond constants for CT–CT, CT–HC and OW–HW, in two parameter sets"},"created":"2026-10-14T09:00:00Z","creator":{"id":"tag:scient.ing,2026:key:ana","name":"Ana Example","type":"Person"},"id":"tag:scient.ing,2026:annotation:smithlab/c4648hbwpavgp","layer":"tag:scient.ing,2026:layer:smithlab/dt9n2k5y","motivation":"classifying","receipt":"v84xfyx5n1wg4","status":"confirmed","target":{"selector":[{"anchor":{"doc":"hale2026harmonic-damb","format":"scienting-anchor/1","kind":"sentence","node":"wxxhb3s","node_hash":"52063ded5cf76abdd32ba5c1d0d5d7348843eb0516ad29f5b1f249964e015b50","own_hash":"506d3bd0afffb1dff34f1563338d538c85be50434905c86784a94b747f979bc3","quote":{"exact":"Fitted harmonic bond parameters."},"rev":12,"store":"smithlab"},"type":"AnchorSelector"},{"exact":"Fitted harmonic bond parameters.","prefix":"","suffix":"","type":"TextQuoteSelector"}],"source":"tag:scient.ing,2026:doc:smithlab/hale2026harmonic-damb","type":"SpecificResource"},"type":"Annotation"},"expect":[{"message":"subject 0: protein:5807fcbf6d5567ca is not the form of a structure identity","rule":"layer.data.subject"}],"id":"subject-a-sequence-identity-for-a-structure","note":"A protein: identity for a structure.","op":"problems","schema":true}
|
||||
{"annotation":{"@context":["http://www.w3.org/ns/anno.jsonld","https://paperspec.scient.ing/context/scienting-1.jsonld"],"body":{"data_type":"force-field-parameters","dataset":"ds-hale-bond-params","kind":"data","label":"bond parameters","method":"scanned in steps of 0.01 Å, energies fitted by least squares","quantities":[{"field":"k_r","name":"harmonic bond force constant","unit":"kcal / mol / angstrom ** 2"},{"field":"r_eq","name":"equilibrium bond length","unit":"angstrom"}],"role":"reports","subjects":[{"identity":"OTMSDBZUPAUEDD-UHFFFAOYSA-N","kind":"sequence"}],"type":"TextualBody","value":"Harmonic bond constants for CT–CT, CT–HC and OW–HW, in two parameter sets"},"created":"2026-10-14T09:00:00Z","creator":{"id":"tag:scient.ing,2026:key:ana","name":"Ana Example","type":"Person"},"id":"tag:scient.ing,2026:annotation:smithlab/c4648hbwpavgp","layer":"tag:scient.ing,2026:layer:smithlab/dt9n2k5y","motivation":"classifying","receipt":"v84xfyx5n1wg4","status":"confirmed","target":{"selector":[{"anchor":{"doc":"hale2026harmonic-damb","format":"scienting-anchor/1","kind":"sentence","node":"wxxhb3s","node_hash":"52063ded5cf76abdd32ba5c1d0d5d7348843eb0516ad29f5b1f249964e015b50","own_hash":"506d3bd0afffb1dff34f1563338d538c85be50434905c86784a94b747f979bc3","quote":{"exact":"Fitted harmonic bond parameters."},"rev":12,"store":"smithlab"},"type":"AnchorSelector"},{"exact":"Fitted harmonic bond parameters.","prefix":"","suffix":"","type":"TextQuoteSelector"}],"source":"tag:scient.ing,2026:doc:smithlab/hale2026harmonic-damb","type":"SpecificResource"},"type":"Annotation"},"expect":[{"message":"subject 0: OTMSDBZUPAUEDD-UHFFFAOYSA-N is not the form of a sequence identity","rule":"layer.data.subject"}],"id":"subject-a-structure-identity-for-a-sequence","note":"An InChIKey for a sequence.","op":"problems","schema":true}
|
||||
{"annotation":{"@context":["http://www.w3.org/ns/anno.jsonld","https://paperspec.scient.ing/context/scienting-1.jsonld"],"body":{"data_type":"force-field-parameters","dataset":"ds-hale-bond-params","kind":"data","label":"bond parameters","method":"scanned in steps of 0.01 Å, energies fitted by least squares","quantities":[{"field":"k_r","name":"harmonic bond force constant","unit":"kcal / mol / angstrom ** 2"},{"field":"r_eq","name":"equilibrium bond length","unit":"angstrom"}],"role":"reports","subjects":[{"identity":"smarts:2e2a923f","kind":"structure"}],"type":"TextualBody","value":"Harmonic bond constants for CT–CT, CT–HC and OW–HW, in two parameter sets"},"created":"2026-10-14T09:00:00Z","creator":{"id":"tag:scient.ing,2026:key:ana","name":"Ana Example","type":"Person"},"id":"tag:scient.ing,2026:annotation:smithlab/c4648hbwpavgp","layer":"tag:scient.ing,2026:layer:smithlab/dt9n2k5y","motivation":"classifying","receipt":"v84xfyx5n1wg4","status":"confirmed","target":{"selector":[{"anchor":{"doc":"hale2026harmonic-damb","format":"scienting-anchor/1","kind":"sentence","node":"wxxhb3s","node_hash":"52063ded5cf76abdd32ba5c1d0d5d7348843eb0516ad29f5b1f249964e015b50","own_hash":"506d3bd0afffb1dff34f1563338d538c85be50434905c86784a94b747f979bc3","quote":{"exact":"Fitted harmonic bond parameters."},"rev":12,"store":"smithlab"},"type":"AnchorSelector"},{"exact":"Fitted harmonic bond parameters.","prefix":"","suffix":"","type":"TextQuoteSelector"}],"source":"tag:scient.ing,2026:doc:smithlab/hale2026harmonic-damb","type":"SpecificResource"},"type":"Annotation"},"expect":[{"message":"subject 0: smarts:2e2a923f is not the form of a structure identity","rule":"layer.data.subject"}],"id":"subject-a-hash-too-short","note":"Twelve hexadecimal digits are needed.","op":"problems","schema":false}
|
||||
{"annotation":{"@context":["http://www.w3.org/ns/anno.jsonld","https://paperspec.scient.ing/context/scienting-1.jsonld"],"body":{"data_type":"force-field-parameters","dataset":"ds-hale-bond-params","kind":"data","label":"bond parameters","method":"scanned in steps of 0.01 Å, energies fitted by least squares","quantities":[{"field":"k_r","name":"harmonic bond force constant","unit":"kcal / mol / angstrom ** 2"},{"field":"r_eq","name":"equilibrium bond length","unit":"angstrom"}],"role":"reports","subjects":[{"identity":"OTMSDBZUPAUEDD-UHFFFAOYSA-N","kind":"structure","label":"ethane"},{"identity":"XLYOFNOQVPJJNP-UHFFFAOYSA-N","kind":"structure","label":"water"},{"identity":"OTMSDBZUPAUEDD-UHFFFAOYSA-N","kind":"structure","label":"ethane"}],"type":"TextualBody","value":"Harmonic bond constants for CT–CT, CT–HC and OW–HW, in two parameter sets"},"created":"2026-10-14T09:00:00Z","creator":{"id":"tag:scient.ing,2026:key:ana","name":"Ana Example","type":"Person"},"id":"tag:scient.ing,2026:annotation:smithlab/c4648hbwpavgp","layer":"tag:scient.ing,2026:layer:smithlab/dt9n2k5y","motivation":"classifying","receipt":"v84xfyx5n1wg4","status":"confirmed","target":{"selector":[{"anchor":{"doc":"hale2026harmonic-damb","format":"scienting-anchor/1","kind":"sentence","node":"wxxhb3s","node_hash":"52063ded5cf76abdd32ba5c1d0d5d7348843eb0516ad29f5b1f249964e015b50","own_hash":"506d3bd0afffb1dff34f1563338d538c85be50434905c86784a94b747f979bc3","quote":{"exact":"Fitted harmonic bond parameters."},"rev":12,"store":"smithlab"},"type":"AnchorSelector"},{"exact":"Fitted harmonic bond parameters.","prefix":"","suffix":"","type":"TextQuoteSelector"}],"source":"tag:scient.ing,2026:doc:smithlab/hale2026harmonic-damb","type":"SpecificResource"},"type":"Annotation"},"expect":[{"message":"subject 2 repeats the structure OTMSDBZUPAUEDD-UHFFFAOYSA-N","rule":"layer.data.subject"}],"id":"subject-listed-twice","note":"Ethane is the first and the third.","op":"problems","schema":true}
|
||||
{"annotation":{"@context":["http://www.w3.org/ns/anno.jsonld","https://paperspec.scient.ing/context/scienting-1.jsonld"],"body":{"data_type":"force-field-parameters","dataset":"Table 1","kind":"data","label":"bond parameters","method":"scanned in steps of 0.01 Å, energies fitted by least squares","quantities":[{"field":"k_r","name":"harmonic bond force constant","unit":"kcal / mol / angstrom ** 2"},{"field":"r_eq","name":"equilibrium bond length","unit":"angstrom"}],"role":"reports","subjects":[{"identity":"OTMSDBZUPAUEDD-UHFFFAOYSA-N","kind":"structure","label":"ethane"},{"identity":"XLYOFNOQVPJJNP-UHFFFAOYSA-N","kind":"structure","label":"water"},{"identity":"smarts:2e2a923f840c","kind":"structure","label":"CT–CT"}],"type":"TextualBody","value":"Harmonic bond constants for CT–CT, CT–HC and OW–HW, in two parameter sets"},"created":"2026-10-14T09:00:00Z","creator":{"id":"tag:scient.ing,2026:key:ana","name":"Ana Example","type":"Person"},"id":"tag:scient.ing,2026:annotation:smithlab/c4648hbwpavgp","layer":"tag:scient.ing,2026:layer:smithlab/dt9n2k5y","motivation":"classifying","receipt":"v84xfyx5n1wg4","status":"confirmed","target":{"selector":[{"anchor":{"doc":"hale2026harmonic-damb","format":"scienting-anchor/1","kind":"sentence","node":"wxxhb3s","node_hash":"52063ded5cf76abdd32ba5c1d0d5d7348843eb0516ad29f5b1f249964e015b50","own_hash":"506d3bd0afffb1dff34f1563338d538c85be50434905c86784a94b747f979bc3","quote":{"exact":"Fitted harmonic bond parameters."},"rev":12,"store":"smithlab"},"type":"AnchorSelector"},{"exact":"Fitted harmonic bond parameters.","prefix":"","suffix":"","type":"TextQuoteSelector"}],"source":"tag:scient.ing,2026:doc:smithlab/hale2026harmonic-damb","type":"SpecificResource"},"type":"Annotation"},"expect":[{"message":"Table 1 is not the ID of a dataset","rule":"layer.data.dataset"}],"id":"dataset-not-an-id","note":"A dataset ID begins ds-.","op":"problems","schema":false}
|
||||
{"annotation":{"@context":["http://www.w3.org/ns/anno.jsonld","https://paperspec.scient.ing/context/scienting-1.jsonld"],"body":{"data_type":"force-field-parameters","dataset":"ds-hale-bond-params","kind":"data","label":"bond parameters","method":"scanned in steps of 0.01 Å, energies fitted by least squares","quantities":[{"field":"k_r","name":"harmonic bond force constant","unit":"kcal / mol / angstrom ** 2"},{"field":"r_eq","name":"equilibrium bond length","unit":"angstrom"}],"role":"reports","subjects":[{"identity":"OTMSDBZUPAUEDD-UHFFFAOYSA-N","kind":"structure","label":"ethane"},{"identity":"XLYOFNOQVPJJNP-UHFFFAOYSA-N","kind":"structure","label":"water"},{"identity":"smarts:2e2a923f840c","kind":"structure","label":"CT–CT"}],"type":"TextualBody","value":"Harmonic bond constants for CT–CT, CT–HC and OW–HW, in two parameter sets"},"created":"2026-10-14T09:00:00Z","creator":{"id":"tag:scient.ing,2026:key:ana","name":"Ana Example","type":"Person"},"id":"tag:scient.ing,2026:annotation:smithlab/c4648hbwpavgp","layer":"tag:scient.ing,2026:layer:smithlab/dt9n2k5y","motivation":"classifying","receipt":"v84xfyx5n1wg4","status":"confirmed","target":{"selector":[{"anchor":{"doc":"hale2026harmonic-damb","format":"scienting-anchor/1","kind":"sentence","node":"wxxhb3s","node_hash":"52063ded5cf76abdd32ba5c1d0d5d7348843eb0516ad29f5b1f249964e015b50","own_hash":"506d3bd0afffb1dff34f1563338d538c85be50434905c86784a94b747f979bc3","quote":{"exact":"Fitted harmonic bond parameters."},"rev":12,"store":"smithlab"},"type":"AnchorSelector"},{"exact":"Fitted harmonic bond parameters.","prefix":"","suffix":"","type":"TextQuoteSelector"}],"source":"tag:scient.ing,2026:doc:smithlab/hale2026harmonic-damb","type":"SpecificResource"},"type":"Annotation"},"dataset":{"format":"scienting-dataset/1","id":"ds-hale-ctct-scan","name":"hale-ctct-scan","resources":[{"encoding":"utf-8","format":"csv","name":"scan","origin":{"anchors":"anchors.jsonl","digitization":"n43jx89tgmmzy","kind":"digitized"},"path":"data.csv","schema":{"fields":[{"name":"point","type":"string"},{"name":"r","type":"number","uncertainty":{"field":"r_u","kind":"resolution"},"unit":"angstrom"},{"name":"r_u","type":"number","unit":"angstrom"},{"name":"e","type":"number","uncertainty":{"field":"e_u","kind":"resolution"},"unit":"kcal / mol"},{"name":"e_u","type":"number","unit":"kcal / mol"}],"primaryKey":"point"}}],"title":"Energy along the C–C stretch, read from Figure 1a"},"expect":[{"message":"the dataset is ds-hale-ctct-scan, not ds-hale-bond-params","rule":"layer.data.dataset"},{"message":"quantity 0 names the field k_r, which ds-hale-bond-params does not have","rule":"layer.data.dataset"},{"message":"quantity 1 names the field r_eq, which ds-hale-bond-params does not have","rule":"layer.data.dataset"}],"id":"dataset-another-than-the-descriptor","note":"The annotation names ds-hale-bond-params; the descriptor is of the scan, which has none of its fields.","op":"problems","schema":true}
|
||||
{"annotation":{"@context":["http://www.w3.org/ns/anno.jsonld","https://paperspec.scient.ing/context/scienting-1.jsonld"],"body":{"data_type":"force-field-parameters","dataset":"ds-hale-bond-params","kind":"data","label":"bond parameters","method":"scanned in steps of 0.01 Å, energies fitted by least squares","quantities":[{"field":"k_theta","name":"harmonic angle force constant"}],"role":"reports","subjects":[{"identity":"OTMSDBZUPAUEDD-UHFFFAOYSA-N","kind":"structure","label":"ethane"},{"identity":"XLYOFNOQVPJJNP-UHFFFAOYSA-N","kind":"structure","label":"water"},{"identity":"smarts:2e2a923f840c","kind":"structure","label":"CT–CT"}],"type":"TextualBody","value":"Harmonic bond constants for CT–CT, CT–HC and OW–HW, in two parameter sets"},"created":"2026-10-14T09:00:00Z","creator":{"id":"tag:scient.ing,2026:key:ana","name":"Ana Example","type":"Person"},"id":"tag:scient.ing,2026:annotation:smithlab/c4648hbwpavgp","layer":"tag:scient.ing,2026:layer:smithlab/dt9n2k5y","motivation":"classifying","receipt":"v84xfyx5n1wg4","status":"confirmed","target":{"selector":[{"anchor":{"doc":"hale2026harmonic-damb","format":"scienting-anchor/1","kind":"sentence","node":"wxxhb3s","node_hash":"52063ded5cf76abdd32ba5c1d0d5d7348843eb0516ad29f5b1f249964e015b50","own_hash":"506d3bd0afffb1dff34f1563338d538c85be50434905c86784a94b747f979bc3","quote":{"exact":"Fitted harmonic bond parameters."},"rev":12,"store":"smithlab"},"type":"AnchorSelector"},{"exact":"Fitted harmonic bond parameters.","prefix":"","suffix":"","type":"TextQuoteSelector"}],"source":"tag:scient.ing,2026:doc:smithlab/hale2026harmonic-damb","type":"SpecificResource"},"type":"Annotation"},"dataset":{"format":"scienting-dataset/1","id":"ds-hale-bond-params","name":"hale-bond-params","resources":[{"encoding":"utf-8","format":"csv","name":"bond-parameters","origin":{"anchors":"anchors.jsonl","kind":"reported"},"path":"data.csv","schema":{"fields":[{"name":"key","type":"string"},{"name":"bond","type":"string"},{"name":"set","type":"string"},{"name":"k_r","type":"number","unit":"kcal / mol / angstrom ** 2"},{"name":"r_eq","type":"number","uncertainty":{"kind":"unknown"},"unit":"angstrom"}],"primaryKey":"key"}}],"title":"Harmonic bond parameters reported in Table 1"},"expect":[{"message":"quantity 0 names the field k_theta, which ds-hale-bond-params does not have","rule":"layer.data.dataset"}],"id":"dataset-a-field-the-dataset-lacks","note":"The table has no k_theta.","op":"problems","schema":true}
|
||||
{"annotation":{"@context":["http://www.w3.org/ns/anno.jsonld","https://paperspec.scient.ing/context/scienting-1.jsonld"],"body":{"data_type":"force-field-parameters","dataset":"ds-hale-bond-params","kind":"data","label":"bond parameters","method":"scanned in steps of 0.01 Å, energies fitted by least squares","quantities":[{"field":"k_r","name":"harmonic bond force constant","unit":"kcal/mol/A^2"},{"field":"r_eq","name":"equilibrium bond length","unit":"angstrom"}],"role":"reports","subjects":[{"identity":"OTMSDBZUPAUEDD-UHFFFAOYSA-N","kind":"structure","label":"ethane"},{"identity":"XLYOFNOQVPJJNP-UHFFFAOYSA-N","kind":"structure","label":"water"},{"identity":"smarts:2e2a923f840c","kind":"structure","label":"CT–CT"}],"type":"TextualBody","value":"Harmonic bond constants for CT–CT, CT–HC and OW–HW, in two parameter sets"},"created":"2026-10-14T09:00:00Z","creator":{"id":"tag:scient.ing,2026:key:ana","name":"Ana Example","type":"Person"},"id":"tag:scient.ing,2026:annotation:smithlab/c4648hbwpavgp","layer":"tag:scient.ing,2026:layer:smithlab/dt9n2k5y","motivation":"classifying","receipt":"v84xfyx5n1wg4","status":"confirmed","target":{"selector":[{"anchor":{"doc":"hale2026harmonic-damb","format":"scienting-anchor/1","kind":"sentence","node":"wxxhb3s","node_hash":"52063ded5cf76abdd32ba5c1d0d5d7348843eb0516ad29f5b1f249964e015b50","own_hash":"506d3bd0afffb1dff34f1563338d538c85be50434905c86784a94b747f979bc3","quote":{"exact":"Fitted harmonic bond parameters."},"rev":12,"store":"smithlab"},"type":"AnchorSelector"},{"exact":"Fitted harmonic bond parameters.","prefix":"","suffix":"","type":"TextQuoteSelector"}],"source":"tag:scient.ing,2026:doc:smithlab/hale2026harmonic-damb","type":"SpecificResource"},"type":"Annotation"},"dataset":{"format":"scienting-dataset/1","id":"ds-hale-bond-params","name":"hale-bond-params","resources":[{"encoding":"utf-8","format":"csv","name":"bond-parameters","origin":{"anchors":"anchors.jsonl","kind":"reported"},"path":"data.csv","schema":{"fields":[{"name":"key","type":"string"},{"name":"bond","type":"string"},{"name":"set","type":"string"},{"name":"k_r","type":"number","unit":"kcal / mol / angstrom ** 2"},{"name":"r_eq","type":"number","uncertainty":{"kind":"unknown"},"unit":"angstrom"}],"primaryKey":"key"}}],"title":"Harmonic bond parameters reported in Table 1"},"expect":[{"message":"quantity 0 gives k_r the unit kcal/mol/A^2, but ds-hale-bond-params gives it kcal / mol / angstrom ** 2","rule":"layer.data.dataset"}],"id":"dataset-a-unit-other-than-the-datasets","note":"The dataset gives k_r the unit kcal / mol / angstrom ** 2.","op":"problems","schema":true}
|
||||
Reference in new issue
Block a user