Skip to content

npj Computational Materials Study Design & Manuscript Blueprint

This guide documents the scientific thesis, methodology equations, ablation matrix, and figure plan for the flagship BASE Laboratory research manuscript built on OpenLSR-X, targeting npj Computational Materials (with Journal of Synchrotron Radiation as secondary open-access venue).


Working Title

Physics-Guided 2.5D Orthogonal Super-Resolution and View-Disagreement Transport Uncertainty for Multi-Magnification Synchrotron Tomography


150-Word Draft Abstract

Quantitative X-ray computed tomography (XCT) of functional porous materials at synchrotron beamlines is constrained by the hardware coupling between spatial resolution, field of view (FOV), and X-ray dose. Existing deep super-resolution methods either incur cubic memory scaling in 3D convolutional networks or rely on 2D natural-image adversarial priors that distort greyscale attenuation consistency and pinch off sub-micron pore throats without diagnostic error indicators. Here we introduce a cell-centered 2.5D-to-3D orthogonal super-resolution framework (OpenLSR-X) combining multi-axis shifted-window self-attention (SwinIR), linear-attenuation downsampling consistency (2.5D $z$-PSF corrected), and differentiable soft-skeleton (soft-clDice) pore-throat topology supervision. Across three orthogonal sweeps (yz, xz, xy), outlier-suppressed 3D Fourier synthesis yields zero-overhead voxel-wise view-disagreement maps $\sigma_{\text{ortho}}(\mathbf{x})$ that correlate spatially with reconstruction error and propagate into 3D Fickian diffusive tortuosity sensitivity bounds. Evaluated on sub-voxel-registered multi-magnification Diamond Light Source I13-2 tomograms of reactive Zn-doped Zeolite 13X (2× and 8×), our method improves reference FSC = 0.5 spectral recovery, tri-phase Pore / Na-13X / Zn-13X segmentation, and pore-scale diffusivity fidelity.


Four Core Contributions (Addressing npj Computational Materials Criteria)

  1. Zero-Overhead Orthogonal View-Disagreement Uncertainty $\sigma_{\text{ortho}}(\mathbf{x}) \to [D_{\text{eff}}^-, D_{\text{eff}}^+]$: Three-axis orthogonal reconstruction ($n=3$ sweeps) naturally measures inter-view disagreement between in-plane super-resolution and through-plane structure at sub-resolution interfaces. We evaluate $\sigma_{\text{ortho}}(\mathbf{x})$ rigorously via voxel-wise Spearman rank correlation against ground-truth error $|\hat{V} - V_{\text{HR}}|$ and empirical ground-truth $D_{\text{eff}}$ bracketing rates under $\hat{V} \pm k\sigma_{\text{ortho}}$ sensitivity propagation (solve_steady_state_diffusion_axis / OpenImpala).
  2. Domain-Grounded Tomographic Attenuation & Topology Supervision: Replaces RGB ImageNet VGG-19 perceptual priors with AttenuationConservationLoss (enforcing joint-calibrated linear-attenuation $\mu$ downsampling consistency with a 2.5D through-plane $z$-PSF Laplacian correction), bimodal SoftCLDiceLoss (preventing pore-throat pinch-off), and FocalFrequencyLoss.
  3. Multi-Axis Native-LR-Strided SwinIR-2.5D + Outlier-Suppressed Fourier Synthesis: Samples [z - s, z, z + s] neighbors at true physical LR slice spacing ($\pm \Delta z_{\text{LR}}$) across all three training orientations (train_axes=("yz", "xz", "xy")) at < 0.3% parameter overhead over 2D models, paired with Winsorized confidence_fourier fusion tested in a controlled 9-arm stepwise ablation ladder (SwinIR-2.5D-L1-Fourier $\to$ +Physics-Fourier $\to$ +ConfFourier).
  4. Full-Reference 3D FSC Metrology & Tri-Phase Reactive Zeolite Validation (Zn-13X): Evaluates blur-sensitive prediction-vs-reference FSC = 0.5 crossover frequencies and spectral AUC (compute_fsc_3d) alongside reference-locked petrophysics and three-phase (Macropore / Na-13X Core / Zn-Exchanged Shell) segmentation fidelity on coaxial sub-voxel-registered Diamond I13-2 scans (Green et al., Sci. Data 2025, 10.1038/s41597-025-04605-9).

Six-Figure Manuscript Plan

Figure Content & Scientific Message Generated By
Fig. 1 FOV–Resolution–Dose Trade-off & Architecture: Diamond I13-2 multi-magnification optics (2.60 -> 0.325 um), cell-centered 2.5D SwinIR trunk, physics/topology losses, and Confidence-Fourier + $\sigma_{\text{ortho}}$ pipeline. Schematic + quickstart_walkthrough.py
Fig. 2 Paired Synchrotron Visual & Spectral Fidelity (2× and 8×): Cross-sections (xy, xz, yz), radial 3D FSC curves with FSC = 0.5 reference crossovers and spectral AUC quantifying spatial frequency recovery. compute_fsc_3d + zn13x_synchrotron_study.py
Fig. 3 Tri-Phase Reactive Zn-13X Ion-Exchange Fidelity: Three-phase segmentation (Macropore, Na-13X core, Zn-13X shell), phase volume-fraction conservation, and joint-calibrated attenuation histograms. evaluate_triphase_zn13x_metrics
Fig. 4 Orthogonal View-Disagreement Diagnostics: Spatial co-localization of $\sigma_{\text{ortho}}(\mathbf{x})$ with actual HR error $ \hat{V} - V_{\text{HR}}
Fig. 5 3D Pore-Scale Diffusive Tortuosity & Capillary Drainage: Converged steady-state concentration fields $c(\mathbf{x})$, $D_{\text{eff}}/D_0$ & $\tau$ parity plots with $\pm k\sigma_{\text{ortho}}$ sensitivity bounds and empirical bracketing rates, plus simulated drainage $S_{\text{nwp}}(P_c)$ curves. evaluate_transport_metrics + compute_tortuosity_uncertainty_bounds + OpenImpala
Fig. 6 Compute/VRAM Scaling & 9-Arm Controlled Stepwise Ablation: GPU memory, inference wall-time, and controlled stepwise ablations (SRResNet vs SR3DResNet vs SRGAN vs RRDB-RaGAN vs SwinIR-2.5D-L1 vs +Physics vs +ConfFourier). aggregate_campaign.py (campaign_tradeoffs.png & campaign_table.tex)

Running the Full Isambard-AI Experimental Campaign

  1. Stage Real Diamond I13-2 Zn-13X Zenodo Sub-Volumes (14245751 or raw 169065–169068 HDF5):
    openlsrx download-zn13x --dest data/benchmarks --lr-size 48
    openlsrx download-benchmarks --dest data/benchmarks --size 128
    
  2. Launch Multi-Seed Array Campaign on Isambard-AI (GH200):
    sbatch scripts/hpc/isambard_ai_array.slurm
    
    Or train the flagship configuration directly via CLI:
    openlsrx fit --config configs/i13-xct/zn13x_2x_swinir_25d_physics.yaml
    
  3. Aggregate Multi-Seed Statistics, Booktabs LaTeX Tables & Pareto Figures:
    python scripts/benchmarks/aggregate_campaign.py \
      --inputs results \
      --output-dir results/campaign_summary