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)¶
- 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). - Domain-Grounded Tomographic Attenuation & Topology Supervision:
Replaces RGB ImageNet
VGG-19perceptual priors withAttenuationConservationLoss(enforcing joint-calibrated linear-attenuation $\mu$ downsampling consistency with a2.5Dthrough-plane $z$-PSF Laplacian correction), bimodalSoftCLDiceLoss(preventing pore-throat pinch-off), andFocalFrequencyLoss. - 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 Winsorizedconfidence_fourierfusion tested in a controlled 9-arm stepwise ablation ladder (SwinIR-2.5D-L1-Fourier$\to$+Physics-Fourier$\to$+ConfFourier). - Full-Reference
3D FSCMetrology & Tri-Phase Reactive Zeolite Validation (Zn-13X): Evaluates blur-sensitive prediction-vs-referenceFSC = 0.5crossover 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¶
- Stage Real Diamond I13-2
Zn-13XZenodo Sub-Volumes (14245751or raw169065–169068HDF5):openlsrx download-zn13x --dest data/benchmarks --lr-size 48 openlsrx download-benchmarks --dest data/benchmarks --size 128 - Launch Multi-Seed Array Campaign on Isambard-AI (
GH200):Or train the flagship configuration directly via CLI:sbatch scripts/hpc/isambard_ai_array.slurmopenlsrx fit --config configs/i13-xct/zn13x_2x_swinir_25d_physics.yaml - Aggregate Multi-Seed Statistics, Booktabs LaTeX Tables & Pareto Figures:
python scripts/benchmarks/aggregate_campaign.py \ --inputs results \ --output-dir results/campaign_summary