docs: Add guide for updating Rica without rerunning tedana#111
Merged
eurunuela merged 2 commits intoME-ICA:masterfrom Mar 3, 2026
Merged
docs: Add guide for updating Rica without rerunning tedana#111eurunuela merged 2 commits intoME-ICA:masterfrom
eurunuela merged 2 commits intoME-ICA:masterfrom
Conversation
✅ Deploy Preview for rica-fmri ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
Contributor
There was a problem hiding this comment.
Pull request overview
This PR adds documentation for updating Rica independently of tedana runs, and also introduces runtime changes to improve large-NIfTI handling and local-server file discovery.
Changes:
- Add a new MkDocs page plus README section describing how to update
index.html/rica_server.pyin existing tedana outputs. - Update the app to optionally load NIfTI data via URL (including extracting TR from a small header slice / HTTP Range request) to better support very large files.
- Update
rica_server.pyfile discovery patterns/filters (includingregistry.json) to improve auto-discovery from tedana output directories.
Reviewed changes
Copilot reviewed 12 out of 12 changed files in this pull request and generated 4 comments.
Show a summary per file
| File | Description |
|---|---|
| src/utils/niftiUtils.js | Adjust gzip header decompression flow to avoid deadlock with large inputs. |
| src/index.js | Add niftiUrl state and plumb it into major tabs. |
| src/Tree/DecisionTreeTab.js | Pass niftiUrl through to the Decision Tree view. |
| src/Tree/DecisionTree.js | Gate BrainViewer rendering based on NIfTI buffer-or-URL availability. |
| src/PopUps/IntroPopUp.js | Extract TR from header slice/Range request; set niftiUrl and attempt full buffer load with fallback. |
| src/Plots/Plots.js | Update interactive view gating and pass niftiUrl to BrainViewer. |
| src/Plots/BrainViewer.js | Support loading the stat map from URL (prefer URL over Blob) and update cleanup logic. |
| scripts/rica_server.py | Add registry.json and refine _components.nii.gz discovery filtering. |
| mkdocs.yml | Register the new “Updating Rica” page in site navigation. |
| docs/updating-rica.md | Add a new guide page describing how to update Rica without rerunning tedana. |
| README.md | Add a concise “Updating Rica Without Rerunning Tedana” section linking to the full guide. |
| claude-progress.txt | Add session notes documenting the changes made. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
Add a new documentation page (docs/updating-rica.md) and a README section explaining how users can update the open_rica_report.py that tedana generates by replacing it with the latest index.html and rica_server.py from a Rica release. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
The script already auto-downloads the latest Rica from GitHub on every run. Update the docs and README to reflect the real workflow: - Just running the script is enough to get the latest version - --force-download bypasses the cache check - TEDANA_RICA_PATH env var pins a local/custom build - Falls back to cache automatically when offline Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
fd2bcb4 to
933833f
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
docs/updating-rica.md: a dedicated guide explaining how to update theopen_rica_report.pythat tedana generates without having to rerun tedanaREADME.mdwith links to the full guidemkdocs.ymlso it appears in the documentation site navigationWhat the guide covers
index.html+rica_server.pyfrom a release and dropping them into an existing tedana output folderopen_rica_report.pydoes and whyrica_server.pyis a drop-in replacementTest plan
mkdocs serve)🤖 Generated with Claude Code