Skip to content

docs: data-requirements spec + NIST/RI/Joback findings + GS-LF terms - #58

Merged
rvnminers-A-and-N merged 1 commit into
mainfrom
docs/data-requirements-and-verdicts
Jun 29, 2026
Merged

rvnminers-A-and-N merged 1 commit into
mainfrom
docs/data-requirements-and-verdicts

Conversation

@rvnminers-A-and-N

Copy link
Copy Markdown
Collaborator

Records the data-completion findings and adds the client-facing data spec.

New: docs/DATA-REQUIREMENTS.md

The precise "what data unlocks each capability, in what format, what we ask clients for" spec — identifier conventions, what's built on open data, the data-gated tables (odor thresholds, FEMA levels, Kovats RI), the aroma intake (molecules + expert odor descriptors), the customer-only unlocks (blend perception, liking, stability), and the exact loader column schemas. Doubles as the pilot data-intake sheet.

Findings recorded

  • RI is not in PubChem (verified) and NIST RI is paid (~$595 data-only FTP → ~$2,850 single-seat).
  • Joback re-validated across 12 flavor molecules: mean abs error 33 °C, max 89 °C — measured lookup stands.
  • Academic-access nuance: academic doesn't launder paid/copyrighted data, but institutional licenses/library access often make it attainable in research.
  • GS-LF clarified: OpenPOM's GoodScents+Leffingwell combined NC set — distinct from the paid PMP 2001 product.
  • GRAS + BP/VP marked built.

README

Input accepts a common or IUPAC name (or SMILES); pointer to the new spec.

…gs, GS-LF terms

- DATA-REQUIREMENTS.md (new): the precise "what data unlocks each capability, in what
  format, and what we ask a client to provide" spec — conventions, built-on-open-data,
  data-gated tables (dosing thresholds, FEMA levels, RI), the aroma intake (molecules +
  expert odor descriptors), the customer-only unlocks (blend perception, liking,
  stability), and the exact loader column schemas. Doubles as the pilot data-intake sheet.
- DATA-SOURCES.md: RI is NOT in PubChem (verified) and NIST RI is paid (~$595–$2,850);
  GRAS + BP/VP now marked BUILT; "academic-access nuance" (institutional licenses make
  paid data attainable in research, distinct from NC-laundering); GS-LF clarified as the
  GoodScents+Leffingwell *combined* NC set, distinct from the paid PMP 2001 product.
- CAPABILITIES.md: Joback re-validated across 12 molecules — mean abs error 33 °C,
  max 89 °C; measured lookup stands.
- README: input accepts a common or IUPAC name (or SMILES); pointer to DATA-REQUIREMENTS.

Signed-off-by: Austin L. <86896075+rvnminers-A-and-N@users.noreply.github.com>
@rvnminers-A-and-N
rvnminers-A-and-N merged commit d090340 into main Jun 29, 2026
3 checks passed
@rvnminers-A-and-N
rvnminers-A-and-N deleted the docs/data-requirements-and-verdicts branch June 29, 2026 20:54
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant