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:
alexmandClaude committed 2026-10-18 18:05:11 -04:00
1 parent 3ab96d653f
commit 6025ea3f79
25 files changed
+670 -33

No files matched your search

+3
View File
@@ -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"}
+1
View File
@@ -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"}
+1
View File
@@ -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
View File
@@ -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"]}