Skip to content

docs: catalog vocab_labels.parquet (#148)#151

Merged
rdhyee merged 1 commit intoisamplesorg:mainfrom
rdhyee:docs/vocab-labels-catalog
Apr 30, 2026
Merged

docs: catalog vocab_labels.parquet (#148)#151
rdhyee merged 1 commit intoisamplesorg:mainfrom
rdhyee:docs/vocab-labels-catalog

Conversation

@rdhyee
Copy link
Copy Markdown
Contributor

@rdhyee rdhyee commented Apr 30, 2026

Summary

Adds vocab_labels.parquet (537 SKOS concepts, 58 KB, served from data.isamples.org) to the three places that catalog supplementary parquet files:

  • SERIALIZATIONS.md — new "vocabulary labels" tier row in §3 plus a parallel-input note in the §2 derivation DAG
  • data.qmd — quick-pick table row + §3.6 copy-pasteable join recipe (sample_facets_v2 ⨝ vocab_labels → human-readable material label)
  • how-to-use.qmd — pre-aggregated-helpers row + tutorial-usage matrix entry

Sourced from isamplesorg/vocabularies TTLs by scripts/build_vocab_labels.py. Already consumed by the Interactive Explorer to render facet URIs as prefLabels (#148 step 2, merged in #149 and a1f13d4).

The §3.6 join snippet was verified against the live data — returns prefLabels like "Organic material" for OPENCONTEXT/MVZ samples.

Test plan

  • quarto render data.qmd how-to-use.qmd succeeds
  • §3.6 DuckDB snippet executes against data.isamples.org and returns labeled rows
  • Reviewer eyeballs the new rows for tone consistency with surrounding catalog entries

🤖 Generated with Claude Code

Add vocab_labels.parquet to the supplementary parquet catalog in three places:

- SERIALIZATIONS.md: new "vocabulary labels" tier row + DAG note
- data.qmd: quick-pick table row + §3.6 join recipe
- how-to-use.qmd: pre-aggregated helpers row + tutorial-usage matrix entry

Sources from isamplesorg/vocabularies TTLs (537 SKOS concepts, 58 KB),
consumed by the Interactive Explorer to render facet URIs as
human-readable prefLabels.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@rdhyee rdhyee force-pushed the docs/vocab-labels-catalog branch from ee66766 to b68626f Compare April 30, 2026 23:02
@rdhyee rdhyee merged commit f9c98b0 into isamplesorg:main Apr 30, 2026
1 check passed
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