Skip to content

feat: Diamond I13-2 Zn-13X synchrotron pipeline, RRDB-RaGAN & 3D CNN baselines, 3D transport physics, and OpenImpala bridge - #3

Merged
jameslehoux merged 1 commit into
mainfrom
stage2-synchrotron-transport-paper
Nov 17, 2026
Merged

jameslehoux merged 1 commit into
mainfrom
stage2-synchrotron-transport-paper

Conversation

@jameslehoux

Copy link
Copy Markdown

Summary

Implements Stage 2 of the OpenLSR-X publication roadmap, extending the v0.2.0 JOSS foundation on main into a complete experimental synchrotron super-resolution + 3D pore-scale transport physics suite ready for Isambard-AI (GH200) multi-seed campaigns:

1. Experimental Diamond Light Source I13-2 Zn-13X Pipeline (openlsrx.data.zn13x)

  • Adds calibrated magnification metadata (2.5x/2.600 µm, 4x/1.625 µm, 8x/0.8125 µm, 20x/0.325 µm) and Zenodo DOIs (10.5281/zenodo.12206815, 13327651, 13327682, 13327692, 14245751) from Green et al. (Scientific Data 12, 329, 2025).
  • Implements chunked HDF5 ROI slab extraction (extract_aligned_slab_from_h5) + vectorized 3D FFT phase cross-correlation + SSIM registration (register_multires_pair_3d) and calibrated two-phase Zn-13X phantom fallback (synthesize_zn13x_phantom_pair).
  • Adds configs/i13-xct/zn13x_2x_1625_to_08125.yaml & zn13x_8x_2600_to_0325.yaml and wires --datasets zn13x_2x zn13x_8x into openlsrx download-benchmarks.

2. Modern 2D (RRDB-RaGAN + Arbitrary Scale) & Native 3D (SR3DResNet) Baselines

  • Adds normalization-free RRDBGenerator + ArbitraryScaleUpsample (src/openlsrx/models/rrdb.py) supporting non-power-of-two beamline ratios (e.g., $2.5\times$ for $0.8125 \to 0.325\ \mu\text{m}$ and $5\times$ for $1.625 \to 0.325\ \mu\text{m}$) with global bicubic skip residual learning, plus Relativistic Average GAN (gan_loss_type="ragan") in SRGAN.
  • Adds memory-matched volumetric 3D CNN baseline SR3DResNet + raised-cosine sliding-window 3D inference super_resolve_volume_3d (src/openlsrx/models/sr3d.py).

3. 3D Pore-Scale Transport Physics & BASE-Laboratory/OpenImpala Bridge

  • Implements cell-centered 6-neighbor finite-volume 3D Fickian Laplace steady-state diffusion (solve_steady_state_diffusion_axis, compute_directional_tortuosity) matching OpenImpala and TauFactor ($D_{\text{eff}}/D_0$, $\tau_z, \tau_y, \tau_x$, formation factor $F$, and directional transport anisotropy), plus simulated capillary drainage curve RMSE (compute_drainage_rmse).
  • Adds export_for_openimpala (src/openlsrx/io/openimpala.py) and CLI openlsrx export-openimpala / openlsrx evaluate --include-transport --export-openimpala-dir ... generating uncompressed 8-bit 3D TIFFs + AMReX ParmParse .inputs decks.

4. Synchrotron Benchmark, Campaign Aggregator & Isambard-AI SLURM Array

  • Adds scripts/benchmarks/zn13x_synchrotron_study.py, scripts/benchmarks/aggregate_campaign.py (multi-seed mean ± std Markdown, booktabs LaTeX tables, and PSNR-vs-transport Pareto plots), and scripts/hpc/isambard_ai_array.slurm.
  • Adds analytical & integration test suite tests/test_stage2_synchrotron_and_transport.py (61 tests passing, 89.64% coverage).

…, 3D tortuosity physics, and OpenImpala bridge
@jameslehoux
jameslehoux merged commit 6cb4eba into main Nov 17, 2026
5 checks passed
@jameslehoux
jameslehoux deleted the stage2-synchrotron-transport-paper branch November 17, 2026 22:29
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