Skip to content

docs: update RAVEN cross-references for the post-reorg folder layout#20

Merged
edkerk merged 1 commit into
developfrom
docs/align-raven-folder-reorg
Jun 8, 2026
Merged

docs: update RAVEN cross-references for the post-reorg folder layout#20
edkerk merged 1 commit into
developfrom
docs/align-raven-folder-reorg

Conversation

@edkerk

@edkerk edkerk commented Jun 7, 2026

Copy link
Copy Markdown
Member

What

RAVEN reorganised its MATLAB functions out of the core/ catch-all into purpose-based top-level folders (SysBioChalmers/RAVEN#614, on develop3). This repoints the RAVEN file paths in raven-python's cross-reference docs to their current locations.

IMPROVEMENTS.md and docs/reference/matlab_raven_backports.md — every core/<fn>.m reference updated:

function(s) new RAVEN folder
FSEOF, randomSampling, reporterMetabolites analysis/
parseTaskList, checkTasks tasks/
fillGaps gapfilling/
addRxns, changeRxns, standardizeGrRules manipulation/
getIndexes, checkModelStruct, getElementalBalance queries/
getModelFromHomology reconstruction/homology/
getKEGGModelForOrganism reconstruction/kegg/
runINIT, ftINIT INIT/

Doc-only; no code changes. raven-python's module layout already matches RAVEN's new structure (it was the template the reorg mirrored), so the only thing that drifted was these textual cross-references. (Two were stale even before the reorg — getKEGGModelForOrganism lived in external/kegg/ — and the proposed GPR-lint back-port findPotentialErrors now points at manipulation/.)

Assessed but intentionally not done (follow-ups)

  • plotting/visualization/ — RAVEN unified pathway/ + plotting/ into visualization/. raven-python's plotting/ is an unused stub, and renaming it would also churn the user-facing [plotting] pip extra — better done when that subpackage is actually implemented.
  • reconstruction/metacyc/ — RAVEN has MetaCyc reconstruction; porting it is feature work, out of scope for a folder-alignment change.

RAVEN moved its functions out of the core/ catch-all into purpose-based top-level
folders (SysBioChalmers/RAVEN#614). Repoint every RAVEN file path in the
cross-reference docs (IMPROVEMENTS.md, docs/reference/matlab_raven_backports.md):

- FSEOF / randomSampling / reporterMetabolites -> analysis/
- parseTaskList / checkTasks                   -> tasks/
- fillGaps                                      -> gapfilling/
- addRxns / changeRxns / standardizeGrRules     -> manipulation/
- getIndexes / checkModelStruct / getElementalBalance -> queries/
- getModelFromHomology                          -> reconstruction/homology/
- getKEGGModelForOrganism                       -> reconstruction/kegg/
- runINIT / ftINIT                              -> INIT/

Also corrects references that were stale even before the reorg (getKEGGModelForOrganism
was in external/kegg/) and points the proposed GPR-lint back-port findPotentialErrors at
manipulation/, alongside standardizeGrRules.

Doc-only: raven-python's module layout already matches RAVEN's new structure (it was the
template the reorg mirrored), so no code changes are needed.
@edkerk edkerk merged commit 6f366c3 into develop Jun 8, 2026
5 checks passed
@edkerk edkerk deleted the docs/align-raven-folder-reorg branch June 8, 2026 07:31
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