SmellBook
Menu

RESEARCH EXPORTS

Portable public records for spreadsheets and citation managers.

The public atlas can now move into ordinary research tools without a special SDK: CSV for tabular analysis, CSL JSON for citation software and BibTeX for reference workflows.

/data/catalog.csv

Canonical catalog

Generated deterministically from the same version-controlled public source data used by the website.

CSV ↗
/data/claims.csv

Verified claims

Generated deterministically from the same version-controlled public source data used by the website.

CSV ↗
/data/sources.csl.json

Source registry

Generated deterministically from the same version-controlled public source data used by the website.

CSL JSON ↗
/data/sources.bib

Source registry

Generated deterministically from the same version-controlled public source data used by the website.

BibTeX ↗

Single-file tools that run with Node.js 18 or later on your own computer. Each runs the same check the site uses, reads only the files you name, makes no network calls and stores nothing.

Before running a downloaded tool, compare its SHA-256 with the published value: shasum -a 256 <file> (macOS) or sha256sum <file> (Linux), or Get-FileHash <file> -Algorithm SHA256 (Windows PowerShell). Digests are also published in /data/checksums.json.

Keeping heritage records in a spreadsheet? Start from the heritage records template (CSV), then check the filled file with the heritage record checker.

Have a Dublin Core or LIDO collection export? The collection crosswalk shows how it maps to heritage records, and the offline collection tool turns it into draft records. Add the smell fields, then check the result with the heritage record checker. More for museums, archives and universities: how institutions can use SmellBook.

/data/tools/smellbook-check-heritage.mjs

Heritage record checker

Check one heritage record, a JSON array of records or a filled heritage-records.csv spreadsheet against the draft schema and SmellBook identifiers. Run: node smellbook-check-heritage.mjs records.json (or records.csv)

SHA-256: bba7e2ae53948c6acb4ed4783709bfef596b8540e94a240fd4c675e8762ab028

.mjs ↓
/data/tools/smellbook-diff-graph.mjs

Graph export diff

Compare two copies of the knowledge-graph export and list what changed. Run: node smellbook-diff-graph.mjs old-export.json new-export.json [--json]

SHA-256: 1386e65ec821c97f826deb3e26caa285a93fb5f8645b48da0ddfdd9a00bae236

.mjs ↓
/data/tools/smellbook-collection-tools.mjs

Collection import and export

Turn a LIDO or Dublin Core collection export into draft heritage records, and print valid records as Dublin Core, EDM or LIDO statements for your own catalogue. Run: node smellbook-collection-tools.mjs import export.xml|export.csv [--csv] · node smellbook-collection-tools.mjs export records.json|records.csv --format dc|edm|lido

SHA-256: a2b1bb909b01e234b4daa6a546a9f244400cc705cc5a0c168e8d91db96da8ff9

.mjs ↓
CITATION GUIDANCE

Cite the underlying scientific source for scientific claims.

SmellBook can be cited for its own catalog structure and editorial material, but scientific statements should continue to point to the registered underlying paper or source whenever one is provided.