Skip to content

Docs, README overhaul & input dedup fix (Stage 7 of #301)#319

Merged
nx10 merged 1 commit into
mainfrom
refactor/longitudinal-stage-7
Apr 17, 2026
Merged

Docs, README overhaul & input dedup fix (Stage 7 of #301)#319
nx10 merged 1 commit into
mainfrom
refactor/longitudinal-stage-7

Conversation

@nx10
Copy link
Copy Markdown
Contributor

@nx10 nx10 commented Apr 17, 2026

Summary

Final stage of the longitudinal refactor (#301). Docs polish and a small bug fix.

  • README restructured: purpose and BIDS requirement up front, install inlined into quick start, longitudinal as a subsection of workflows, dev/testing consolidated at the bottom, license corrected from MIT to LGPL-3.0-or-later
  • Output tree SVG: color-coded visualization of all derivative files by pipeline stage, replaces the old text tree
  • Data dictionary completed: longitudinal metrics, QC, and template sections added; three missing cross-sectional entries added (MNI-space T1w, ITK affine, pre-bandpass regressed BOLD); fixed incorrect xfm entities in longitudinal anat (was T1w<->longitudinal, actually longitudinal<->MNI152NLin6Asym)
  • Input dedup fix: load_table now deduplicates resolved dataset roots, preventing double-indexing when one input dir is a subdirectory of another (e.g., /data and /data/derivatives)
  • Removed --runner docker from all README examples (auto-detect is the default)

Closes #301

Test plan

  • uv run pytest -m unit passes (780 passed)
  • uv run pre-commit run --files README.md docs/data_dictionary.md clean
  • rbc longitudinal --help output matches documented CLI
  • rbc long --help alias works
  • Verify SVG renders correctly on GitHub (light + dark mode)

- Restructure README: purpose up front, BIDS requirement stated,
  quick start with install, longitudinal as subsection, dev section
  consolidated, license corrected to LGPL-3.0-or-later
- Add SVG output tree visualization with per-stage color coding
- Complete data dictionary: add longitudinal metrics/QC/template
  sections, add missing cross-sectional entries (MNI-space T1w,
  ITK affine, pre-bandpass regressed BOLD), fix longitudinal anat
  xfm entities (longitudinal<->MNI, not longitudinal<->T1w)
- Fix double-indexing when input dirs are nested (e.g. /data and
  /data/derivatives): deduplicate resolved roots in load_table
- Remove --runner docker from all README examples (auto-detect)
@github-actions
Copy link
Copy Markdown

Coverage

Tests Skipped Failures Errors Time
781 0 💤 0 ❌ 0 🔥 11.467s ⏱️

@nx10 nx10 merged commit fb22681 into main Apr 17, 2026
8 checks 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.

Longitudinal pipeline: refactor and release readiness (tracker)

1 participant