Skip to content

Collapse romanisim step dir#17

Merged
bryce-wedig merged 4 commits into
mainfrom
collapse-romanisim-step-dir
Jul 20, 2026
Merged

Collapse romanisim step dir#17
bryce-wedig merged 4 commits into
mainfrom
collapse-romanisim-step-dir

Conversation

@bryce-wedig

Copy link
Copy Markdown
Collaborator

This pull request updates documentation and configuration to reflect the consolidation of the L3 romanisim pipeline into a single step (_05_romanisim.py), removing references to the previous romanisim_l3_pipeline.py and clarifying directory and flag usage. It also improves Sphinx documentation support for new romanisim dependencies and corrects configuration and documentation references to the new pipeline structure.

Documentation and pipeline step consolidation:

  • Updated all documentation and configuration references from romanisim_l3_pipeline.py to _05_romanisim.py, reflecting the consolidation of L3 romanisim processing into a single script and directory (05_romanisim/). This includes clarifying that all outputs, regardless of flags, are written to 05_romanisim/, and that the resume logic now requires exact match of --level and --dither-pattern to avoid mixing incompatible products. [1] [2] [3] [4] [5] [6] [7] [8] [9] [10] [11] [12] [13] [14]

Sphinx and build system improvements:

  • Added asdf, roman_datamodels, romancal, and stcal to autodoc_mock_imports in conf.py to ensure Sphinx builds succeed even when these romanisim dependencies are not installed.

Configuration cleanup:

  • Removed obsolete script_05_romanisim_l3 worker configuration from scratch.yaml and test.yaml, as this step is now merged into script_05_romanisim. [1] [2]

Documentation bug report:

  • Added a new developer-facing bug report documenting a namespace collision with the --prev-step flag in mejiro_pipeline.py, outlining the problem, its effects, and suggested fixes.

Minor documentation reorganization:

  • Merged the two Step 1 documentation sections in the pipeline Sphinx docs for clarity, and updated module references to match the new filenames.

bryce-wedig and others added 4 commits July 19, 2026 04:24
_05_romanisim.py selected its output directory from its flags, writing to
05_romanisim, 05_romanisim_l3, or 05_romanisim_l3_subpixel depending on
--level and --dither-pattern. A step directory should name the step, not
the flags it was invoked with; --level and --dither-pattern are run
parameters like --max-systems.

Every invocation now writes to 05_romanisim/. Drop the cores key
script_05_romanisim_l3 in favor of script_05_romanisim for both levels,
and remove _subpixel_pattern_names(), whose only caller was the directory
branch. This also fixes --level l3 raising KeyError under simple.yaml and
roman_test.yaml, which never carried the _l3 key.

Point _06_h5_export.py's PREV_SCRIPT_NAME at 05_romanisim, matching what
its own docstring already claimed.

Variants of one config now overwrite each other, so --resume across
differing --level/--dither-pattern is unsafe; the sentinels record
neither. Expand the docstring caveat to say so.

roman_data_challenge_rung_1_unlabeled.yaml had script_05_romanisim: 60
against _l3: 12; the collapsed key keeps 12 so L3 runs stay within their
memory budget, lowering that config's L2 worker count.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
mejiro_pipeline.py declares one --prev-step for _04, but _06_h5_export.py
and calculate_snrs.py read the same attribute off the shared Namespace and
so resolve their input to 03/ when driven through the orchestrator. Found
while collapsing the romanisim step dirs; left unfixed as it is
independent of that change.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
The romanisim section referenced mejiro.pipeline.romanisim_pipeline, removed
when the romanisim scripts were consolidated into _05_romanisim, and a Step 1
section referenced _01_run_survey_simulation, removed when survey simulation
was consolidated into _01b. Neither consolidation touched docs/, and Sphinx
only warns on an unimportable automodule target, so both sections had been
rendering as empty headings.

Retarget the romanisim section to _05_romanisim and drop the redundant Step 1
section, since _01b already has one; also drop the now-misleading
"(Pre-computed Tables)" qualifier from the 1b heading.

Retargeting alone was not enough: conf.py mocks numpy but not asdf, so asdf's
module-level numpy arithmetic raised TypeError against the mock and
_05_romanisim still failed to import. Add asdf, roman_datamodels, romancal,
and stcal to autodoc_mock_imports. This also restores mejiro_pipeline, which
had been failing to import from the same gap.

Two docutils warnings remain, from RST formatting in the _05_romanisim module
docstring that only surfaced now that it renders.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Outputs-only re-execution; no cell sources changed. Picks up deflector_only
True and the new main_halo_mass field from the regenerated export.
@bryce-wedig
bryce-wedig merged commit b5172b8 into main Jul 20, 2026
1 check passed
@bryce-wedig
bryce-wedig deleted the collapse-romanisim-step-dir branch July 20, 2026 06:57
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