Skip to content

Refresh tutorial notebook outputs against DataJoint 2.2.2#171

Merged
dimitri-yatsenko merged 1 commit into
docs/notebook-output-hygienefrom
docs/refresh-notebook-outputs
May 19, 2026
Merged

Refresh tutorial notebook outputs against DataJoint 2.2.2#171
dimitri-yatsenko merged 1 commit into
docs/notebook-output-hygienefrom
docs/refresh-notebook-outputs

Conversation

@dimitri-yatsenko
Copy link
Copy Markdown
Member

Summary

Refreshes the committed cell outputs of all 23 tutorial / how-to notebooks by re-executing them against DataJoint 2.2.2 with the new executor image from #170.

  • 21 notebooks previously displayed DataJoint 2.1.1 connected in their connection banner; all now read DataJoint 2.2.2 connected.
  • blob-detection.ipynb no longer renders the TqdmWarning: IProgress not found block or the scikit-image Downloading file 'data/mitosis.tif' from gitlab.com ... line.

Stacked on #170 — the cleanliness of these outputs depends on the ipywidgets dependency + scikit-image pre-cache added there. Merge #170 first; this PR will then retarget main automatically.

Test plan

  • git diff --stat docs/notebook-output-hygiene.. shows only *.ipynb files under src/tutorials/ and src/how-to/ — no source-code changes.
  • python scripts/check_notebook_versions.py exits 0.
  • grep -rln 'TqdmWarning\|IProgress not found' src/ → empty.
  • grep -rln 'Downloading file.*scikit-image' src/ → empty.
  • MODE=LIVE docker compose up and visit /tutorials/examples/blob-detection/. Cell 6 has no yellow warning, cell 2 banner reads 2.2.2, cell 16 progress bar is a single widget instead of six text snapshots.
  • Sample a few unrelated tutorials (tutorials/basics/01-first-pipeline/, tutorials/advanced/json-type/) and confirm the only meaningful diff is the version banner.

All 23 tutorial and how-to notebooks have been re-executed against the
current released DataJoint version (2.2.2). The committed cell outputs
were stale: 21 notebooks still showed "DataJoint 2.1.1 connected" in
their connection banner, and blob-detection additionally rendered a
spurious TqdmWarning and a scikit-image dataset download line.

Built on top of #170 (which added ipywidgets to the executor image and
pre-cached the scikit-image datasets), so the regenerated outputs are
free of the previous noise:

  - No "TqdmWarning: IProgress not found" stderr blocks.
  - No "Downloading file 'data/mitosis.tif' from gitlab.com ..." stdout.
  - All connection banners read "DataJoint 2.2.2 connected to ...".

scripts/check_notebook_versions.py now exits 0.
@dimitri-yatsenko dimitri-yatsenko merged commit a1a2ca0 into docs/notebook-output-hygiene May 19, 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.

2 participants