⚠️ Snapshot note (2026-08-05; live generation updated 2026-09). The 202601 file examples below pin a stable, versioned snapshot. Those objects still exist and their byte counts are correct, but they are not what the Interactive Explorer serves today — the live app reads the 202609 family, including sample_facets_v4, samples_map_lite_v3, wide, and the sharded search index. (Other generations may also appear here, such as the current/ alias or the 202512 narrow file.) Use 202601 for a stable citable snapshot; for what the Explorer actually loads, see isamples_202609_release_manifest.json (human twin: CANONICAL.md).

This repository provides the source for SMR fork isamplesorg.github.io.

The site uses the Quarto and is built using GitHub actions.

Sources are in markdown or "quarto markdown" (.qmd files), and may include content computed at build time.

Visit the Quarto site for documentation on using the Quarto environment and features.

The tutorials/ directory contains interactive data analysis tutorials:

• isamples_explorer.qmd - Interactive search and exploration of 6.7M samples
• explorer_guided_tour.qmd - Guided tour of the Interactive Explorer (replaced the migration-era Zenodo deep-dive, 2026-07)
• parquet_cesium_isamples_wide.qmd - Cesium-based 3D globe visualization
• narrow_vs_wide_performance.qmd - Technical schema comparison

All tutorials use browser-based analysis with DuckDB-WASM - no server required.

For simple editing tasks, the sources may be edited directly on GitHub. A local setup will be beneficial for larger or more complex changes.

To setup a development environment:

1. Install Quarto
2. Create a python virtual environment, e.g. mkvirtualenv isamples-quarto
3. git clone https://github.com/isamplesorg/isamplesorg.github.io.git
4. cd isamplesorg.github.io

Preview the site:

quarto preview

The vocabulary pages under models/generated/vocabularies/ (e.g. material_sample_object_type.html) are produced by a deterministic two-stage pipeline:

1. TTL → markdown. scripts/generate_vocab_docs.sh fetches each .ttl from isamplesorg/vocabularies (and the extension repos) and runs vocab markdown <ttl-url> — the vocab CLI from isamplesorg/vocab_tools, installed via pipx in CI. The output is written as a .qmd (core vocabularies) or .md (extensions) into models/generated/.
2. Markdown → HTML. quarto render walks the site and applies the theme, navigation, and sidebar defined in _quarto.yml to every page, including the generated vocabulary markdown. The site chrome comes from Quarto; the vocabulary content is untouched.

Both stages run in the quarto-pages.yml GitHub Action on every deploy.

To regenerate locally, from the repo root:

scripts/generate_vocab_docs.sh
quarto render

Note on scripts/vocab2md.py. An earlier version of this pipeline invoked vocab2md.py directly. PR #48 switched to the vocab markdown CLI entry point — same tool, same transform. The vocab2md.py file is retained for reference but is no longer part of the build.

After editing, push the sources to GitHub. The rendered pages are generated using the Render using Quarto and push to GH-pages GitHub action that is currently manually triggered.

Updating dependencies using pip -U <<package name>> and regenerate requirements.txt with pip freeze > requirements.txt.

All tutorials query parquet files hosted on Cloudflare R2:

// Wide format (recommended) - 292 MB, 20.7M rows
const WIDE_URL = "https://data.isamples.org/isamples_202601_wide.parquet";

// Narrow format (advanced) - 860 MB, 101,387,180 rows
const NARROW_URL = "https://data.isamples.org/isamples_202512_narrow.parquet";