infra/paperspec
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

First implementation (#1)
check / check (push) Successful in 42s
Details
site / site (push) Successful in 3m4s
Details

Browse Source 
Reviewed-on: #1
This commit was merged in pull request #1.
This commit is contained in:
alexm committed 2026-10-15 05:47:05 -04:00
1 parent 34c0abb26a
commit 4fa326dc76
534 files changed
+28280 -37
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

spec/16-digitization.md
+18
View File
@@ -0,0 +1,18 @@
# 16. Digitization records
A digitization, `scienting-digitization/1`, says how numbers were read off a figure panel, completely enough to repeat.
| Part | Holds |
| --- | --- |
| `target` | The panel's `anchor`, and the `region` read, as a box on the page given by `page_fp`, with the witness's SHA-256 as evidence; or, for a figure that exists only as an image, the image's SHA-256 with the region in its pixels. |
| `axes` | For each axis: its `scale` (`linear`, `log`, `reciprocal` or `date`), `unit`, at least two `calibration` points from page coordinates to value, an optional third `check`, and its `label` anchored to the panel's figure text. |
| `series` | For each series: its legend, its mark (color, marker, line), its kind (`points`, `line`, `bars`, `error-bars` or `region`) and its values: each a position, a value, and an uncertainty from the image's resolution, the marker's size and the calibration's residual. |
| `method` | `manual`, `traced` or `proposed` (by a model), with the tool and its version. |
| `verification` | The overlay check: the image of the values re-plotted under the calibration, by SHA-256, and the mean and largest residual. |
| `confirmation` | The receipt of the person who confirmed it after seeing the overlay, or null. |
| `dataset`, `rev` | The dataset it yields, and the revision it was made at. |
Calibration and values are in page coordinates, not an image's pixels, so a digitization does not depend on the raster it was done on.
A digitization stays current while the document has a page with its `page_fp` and its panel anchor is not stale.
A teammate's re-download, stamped differently, has the same fingerprints, so the digitization stays current on it; a different edition or region has a different fingerprint, so a swapped image never passes.
A digitization counts only when a person confirms it: a receipt with the record `["digitization", id, hash]`, where the hash is SHA-256 of the record without `confirmation`.