From a74e832d5804896936eb8159305647e65ca6263d Mon Sep 17 00:00:00 2001
From: James Le Houx <37665786+jameslehoux@users.noreply.github.com>
Date: Wed, 18 Nov 2026 10:17:17 +0000
Subject: [PATCH 1/5] fix(props): enforce conservative finite-volume stencil
and CUDA pin in periodic homogenisation
---
python/openimpala/_solver.py | 177 +++++++-----------
python/tests/test_v460_features.py | 34 +++-
src/props/DeffTensor.H | 32 ++--
src/props/DeffTensor.cpp | 118 ++++++++----
src/props/EffDiffFillMtx.H | 230 +++++++++---------------
src/props/EffectiveDiffusivityHypre.cpp | 24 ++-
src/props/TortuosityHypre.cpp | 4 +-
src/props/TortuositySolverBase.cpp | 4 +-
tests/tEffectiveDiffusivity.cpp | 117 +-----------
9 files changed, 307 insertions(+), 433 deletions(-)
diff --git a/python/openimpala/_solver.py b/python/openimpala/_solver.py
index 67fa9197..cbc0b3ba 100644
--- a/python/openimpala/_solver.py
+++ b/python/openimpala/_solver.py
@@ -458,13 +458,17 @@ def solve_tortuosity(
# Periodic homogenization 3x3 D_eff tensor solver
# ---------------------------------------------------------------------------
-def _build_cell_problem_system(
+def _build_cell_problem_operator(
active_mask: np.ndarray,
diff_coeff: np.ndarray,
- dir_k_xyz: int,
voxel_size: tuple[float, float, float],
-) -> tuple[sp.csr_matrix, np.ndarray]:
- """Assemble the periodic cell-problem matrix matching EffDiffFillMtx.H + EffectiveDiffusivityHypre."""
+) -> tuple[sp.csr_matrix, list[np.ndarray], Optional[int]]:
+ """Assemble the SPD conservative finite-volume periodic cell-problem matrix.
+
+ Solves ``-div(D (e_k + grad chi_k)) = 0`` on the periodic 3-torus with
+ harmonic-mean face conductances ``D_{i+1/2}`` between active neighbours and
+ zero-flux insulating faces wherever either side has ``D == 0``.
+ """
shape = active_mask.shape # (Nz, Ny, Nx)
N = int(np.prod(shape))
idx_grid = np.arange(N, dtype=np.int64).reshape(shape)
@@ -475,99 +479,70 @@ def _build_cell_problem_system(
d_max = float(np.max(diff_coeff)) if N > 0 else 1.0
d_scale = d_max if d_max > 0.0 else 1.0
- inv_h2_max = max(1.0 / (h * h) for h in voxel_size)
- pin_scale = d_scale * inv_h2_max
+ inv_h2_sum = sum(1.0 / (h * h) for h in voxel_size)
+ pin_scale = d_scale * max(1.0 / (h * h) for h in voxel_size)
+
+ # Precompute +d face harmonic diffusivities D_{i+1/2}^{(d)} for d_xyz = 0(X), 1(Y), 2(Z)
+ d_face_plus: list[np.ndarray] = []
+ for d_xyz in range(3):
+ ax = 2 - d_xyz
+ d_nbr = np.roll(diff_coeff, -1, axis=ax)
+ both = is_active_3d & np.roll(is_active_3d, -1, axis=ax)
+ denom = np.where(both, diff_coeff + d_nbr, 1.0)
+ d_face_plus.append(np.where(both, 2.0 * diff_coeff * d_nbr / denom, 0.0))
rows = [inactive_idx]
cols = [inactive_idx]
vals = [np.full(len(inactive_idx), pin_scale, dtype=np.float64)]
- rhs = np.zeros(N, dtype=np.float64)
+ pin_idx: Optional[int] = None
if len(active_idx) > 0:
- D_c = diff_coeff[is_active_3d]
- diag = np.zeros(len(active_idx), dtype=np.float64)
- flux_bc_rhs = np.zeros(len(active_idx), dtype=np.float64)
-
- # Spatial directions d_xyz = 0(X -> axis 2), 1(Y -> axis 1), 2(Z -> axis 0)
+ diag = np.zeros(N, dtype=np.float64)
for d_xyz in range(3):
ax = 2 - d_xyz
- h = voxel_size[ax]
- inv_h2 = 1.0 / (h * h)
-
- # -d face (index - 1 along ax -> np.roll +1)
- m_nbr_idx = np.roll(idx_grid, 1, axis=ax)[is_active_3d]
- m_nbr_active = np.roll(is_active_3d, 1, axis=ax)[is_active_3d]
- m_D_nbr = np.roll(diff_coeff, 1, axis=ax)[is_active_3d]
-
- if np.any(m_nbr_active):
- dc_m = D_c[m_nbr_active]
- dn_m = m_D_nbr[m_nbr_active]
- denom_m = dc_m + dn_m
- d_face_m = np.where(denom_m > 0.0, 2.0 * dc_m * dn_m / denom_m, 0.0)
- c_m = -d_face_m * inv_h2
- rows.append(active_idx[m_nbr_active])
- cols.append(m_nbr_idx[m_nbr_active])
- vals.append(c_m)
- diag[m_nbr_active] -= c_m
-
- m_inact = ~m_nbr_active
- if np.any(m_inact):
- diag[m_inact] += D_c[m_inact] * inv_h2
- if dir_k_xyz == d_xyz:
- flux_bc_rhs[m_inact] += D_c[m_inact] / h
-
- # +d face (index + 1 along ax -> np.roll -1)
- p_nbr_idx = np.roll(idx_grid, -1, axis=ax)[is_active_3d]
- p_nbr_active = np.roll(is_active_3d, -1, axis=ax)[is_active_3d]
- p_D_nbr = np.roll(diff_coeff, -1, axis=ax)[is_active_3d]
-
- if np.any(p_nbr_active):
- dc_p = D_c[p_nbr_active]
- dn_p = p_D_nbr[p_nbr_active]
- denom_p = dc_p + dn_p
- d_face_p = np.where(denom_p > 0.0, 2.0 * dc_p * dn_p / denom_p, 0.0)
- c_p = -d_face_p * inv_h2
- rows.append(active_idx[p_nbr_active])
- cols.append(p_nbr_idx[p_nbr_active])
- vals.append(c_p)
- diag[p_nbr_active] -= c_p
-
- p_inact = ~p_nbr_active
- if np.any(p_inact):
- diag[p_inact] += D_c[p_inact] * inv_h2
- if dir_k_xyz == d_xyz:
- flux_bc_rhs[p_inact] -= D_c[p_inact] / h
-
- ax_k = 2 - dir_k_xyz
- h_k = voxel_size[ax_k]
- rhs_div_De = -(
- np.roll(diff_coeff, -1, axis=ax_k)[is_active_3d]
- - np.roll(diff_coeff, 1, axis=ax_k)[is_active_3d]
- ) / (2.0 * h_k)
- rhs[active_idx] = rhs_div_De + flux_bc_rhs
-
+ inv_h2 = 1.0 / (voxel_size[ax] * voxel_size[ax])
+ dp = d_face_plus[d_xyz]
+ dm = np.roll(dp, 1, axis=ax)
+ p_idx = np.roll(idx_grid, -1, axis=ax)
+ m_idx = np.roll(idx_grid, 1, axis=ax)
+
+ has_p = dp > 0.0
+ if np.any(has_p):
+ rows.append(idx_grid[has_p])
+ cols.append(p_idx[has_p])
+ vals.append(-dp[has_p] * inv_h2)
+
+ has_m = dm > 0.0
+ if np.any(has_m):
+ rows.append(idx_grid[has_m])
+ cols.append(m_idx[has_m])
+ vals.append(-dm[has_m] * inv_h2)
+
+ diag += ((dp + dm) * inv_h2).ravel()
+
+ # Tiny regularisation ensures disconnected active pockets are nonsingular
+ diag[active_idx] += 1e-12 * diff_coeff[is_active_3d] * inv_h2_sum
rows.append(active_idx)
cols.append(active_idx)
- vals.append(diag)
+ vals.append(diag[active_idx])
all_rows = np.concatenate(rows)
all_cols = np.concatenate(cols)
all_vals = np.concatenate(vals)
- # Pin the first active cell (matching EffectiveDiffusivityHypre.cpp) to remove constant nullspace
+ # Symmetrically pin the first active cell to chi = 0 to remove the constant nullspace
pin_idx = int(active_idx[0])
- keep = all_rows != pin_idx
+ keep = (all_rows != pin_idx) & (all_cols != pin_idx)
all_rows = np.append(all_rows[keep], pin_idx)
all_cols = np.append(all_cols[keep], pin_idx)
all_vals = np.append(all_vals[keep], pin_scale)
- rhs[pin_idx] = 0.0
else:
all_rows = np.concatenate(rows)
all_cols = np.concatenate(cols)
all_vals = np.concatenate(vals)
A = sp.coo_matrix((all_vals, (all_rows, all_cols)), shape=(N, N)).tocsr()
- return A, rhs
+ return A, d_face_plus, pin_idx
def solve_effective_diffusivity(
@@ -614,13 +589,22 @@ def solve_effective_diffusivity(
out["chi"] = {"x": zeros.copy(), "y": zeros.copy(), "z": zeros.copy()}
return out
+ A_sp, d_face_plus, pin_idx = _build_cell_problem_operator(active_mask, diff_coeff, vz)
+
chi_fields: list[np.ndarray] = []
dir_iters: list[int] = []
dir_res: list[float] = []
all_converged = True
+ x0_zero = np.zeros(N, dtype=np.float64)
for dir_k_xyz in range(3):
- A_sp, rhs = _build_cell_problem_system(active_mask, diff_coeff, dir_k_xyz, vz)
+ ax_k = 2 - dir_k_xyz
+ dp_k = d_face_plus[dir_k_xyz]
+ dm_k = np.roll(dp_k, 1, axis=ax_k)
+ rhs = ((dp_k - dm_k) / vz[ax_k]).ravel()
+ if pin_idx is not None:
+ rhs[pin_idx] = 0.0
+
rhs_norm = float(np.linalg.norm(rhs))
if rhs_norm == 0.0:
chi_fields.append(np.zeros(shape, dtype=np.float64))
@@ -628,57 +612,26 @@ def solve_effective_diffusivity(
dir_res.append(0.0)
continue
- diag = A_sp.diagonal()
- inv_diag = np.where(np.abs(diag) > 0.0, 1.0 / diag, 1.0)
- M = sp.diags(inv_diag)
-
- iters = [0]
-
- def _cb(_xk):
- iters[0] += 1
-
- try:
- sol, info = sp_linalg.bicgstab(
- A_sp, rhs, M=M, rtol=tol, atol=0.0, maxiter=maxiter, callback=_cb
- )
- except TypeError:
- sol, info = sp_linalg.bicgstab(
- A_sp, rhs, M=M, tol=tol, maxiter=maxiter, callback=_cb
- )
-
- if info != 0:
- iters[0] = 0
- try:
- sol, info = sp_linalg.gmres(
- A_sp, rhs, M=M, rtol=tol, atol=0.0, maxiter=maxiter, callback=_cb,
- callback_type="legacy",
- )
- except TypeError:
- sol, info = sp_linalg.gmres(
- A_sp, rhs, M=M, tol=tol, maxiter=maxiter, callback=_cb
- )
-
- res_norm = float(np.linalg.norm(rhs - A_sp @ sol) / max(rhs_norm, 1e-300))
- conv = info == 0 or res_norm <= tol * 10.0
+ sol, conv, iters, res_norm = _solve_spd_cg(
+ A_sp, rhs, x0_zero, tol=tol, maxiter=maxiter
+ )
+ conv = conv or res_norm <= tol * 10.0
all_converged = all_converged and conv
chi_fields.append(sol.reshape(shape))
- dir_iters.append(iters[0])
+ dir_iters.append(iters)
dir_res.append(res_norm)
tensor = np.full((3, 3), np.nan, dtype=np.float64)
if all_converged and N > 0:
- is_act = active_mask == 1
- D_act = diff_coeff[is_act]
for r in range(3):
ax_r = 2 - r
h_r = vz[ax_r]
+ dp_r = d_face_plus[r]
for c in range(3):
chi_c = chi_fields[c]
- dchi_dxr = (np.roll(chi_c, -1, axis=ax_r) - np.roll(chi_c, 1, axis=ax_r)) / (
- 2.0 * h_r
- )
+ dchi_face = (np.roll(chi_c, -1, axis=ax_r) - chi_c) / h_r
delta_rc = 1.0 if r == c else 0.0
- tensor[r, c] = float(np.sum(D_act * (delta_rc + dchi_dxr[is_act]))) / float(N)
+ tensor[r, c] = float(np.sum(dp_r * (delta_rc + dchi_face))) / float(N)
out = {
"tensor": tensor,
diff --git a/python/tests/test_v460_features.py b/python/tests/test_v460_features.py
index 29283643..c3e796c1 100644
--- a/python/tests/test_v460_features.py
+++ b/python/tests/test_v460_features.py
@@ -181,14 +181,38 @@ def test_empty_phase_returns_zero_tensor(self):
assert res.active_volume_fraction == 0.0
np.testing.assert_allclose(res.tensor, np.zeros((3, 3)), atol=1e-12)
+ def test_blocked_slab_zero_normal_and_voigt_parallel(self):
+ # Insulating wall normal to X: half active (phase=1), half solid (phase=0)
+ # Exact periodic D_eff: D_xx = 0, D_yy = D_zz = 0.5
+ slab = np.zeros((8, 8, 16), dtype=np.int32)
+ slab[:, :, :8] = 1
+ res = oi.effective_diffusivity(slab, phase=1)
+ assert res.solver_converged
+ assert res.active_volume_fraction == pytest.approx(0.5)
+ expected = np.diag([0.0, 0.5, 0.5])
+ np.testing.assert_allclose(res.tensor, expected, atol=1e-6)
+
+ def test_multiphase_reuss_voigt_laminate(self):
+ # Two-phase periodic laminate normal to X: D_1 = 1.0, D_0 = 0.25 (equal thickness)
+ # Exact Reuss normal to X: 2 * 1.0 * 0.25 / (1.0 + 0.25) = 0.4
+ # Exact Voigt parallel (Y, Z): 0.5 * (1.0 + 0.25) = 0.625
+ lam = np.zeros((8, 8, 16), dtype=np.int32)
+ lam[:, :, :8] = 1
+ res = oi.effective_diffusivity(lam, phase_diffusivities={0: 0.25, 1: 1.0})
+ assert res.solver_converged
+ assert res.active_volume_fraction == pytest.approx(1.0)
+ expected = np.diag([0.4, 0.625, 0.625])
+ np.testing.assert_allclose(res.tensor, expected, atol=1e-5)
+
def test_diagonal_channels_off_diagonal_symmetry(self):
- # Periodic 45-degree diagonal sheets in the (x, y) plane: (ix - iy) % 4 < 2
- # Transport is preferential along x+y => D_xy = D_yx > 0 and D_xx == D_yy, D_xz == D_yz == 0
- nz, ny, nx = 8, 12, 12
+ # Periodic 45-degree diagonal sheets in the (x, y) plane: (ix - iy) % 8 < 4
+ # Note: staircase diagonal sheets require width >= 2 voxels so active cells
+ # connect across faces; width 4 gives percolating 45-degree sheets with D_xy = D_yx > 0.
+ nz, ny, nx = 8, 16, 16
iz, iy, ix = np.meshgrid(
np.arange(nz), np.arange(ny), np.arange(nx), indexing="ij"
)
- data = (((ix - iy) % 4) < 2).astype(np.int32)
+ data = (((ix - iy) % 8) < 4).astype(np.int32)
res = oi.effective_diffusivity(data, phase=1)
assert res.solver_converged
@@ -196,7 +220,7 @@ def test_diagonal_channels_off_diagonal_symmetry(self):
np.testing.assert_allclose(D, D.T, atol=1e-6)
assert D[0, 0] == pytest.approx(D[1, 1], rel=1e-5)
assert D[2, 2] == pytest.approx(0.5, rel=1e-5)
- assert D[0, 1] > 0.02
+ assert D[0, 1] > 0.1
assert abs(D[0, 2]) < 1e-6
assert abs(D[1, 2]) < 1e-6
diff --git a/src/props/DeffTensor.H b/src/props/DeffTensor.H
index f3651fc8..22ef8061 100644
--- a/src/props/DeffTensor.H
+++ b/src/props/DeffTensor.H
@@ -1,11 +1,13 @@
/** @file DeffTensor.H
* @brief Computes the effective diffusivity tensor from homogenization corrector fields.
*
- * Given the three corrector fields chi_x, chi_y, chi_z (solutions of the cell problem
- * nabla_xi . (D nabla_xi chi_k) = -nabla_xi . (D e_k)), assembles the full 3x3
- * effective diffusivity tensor via volume averaging:
+ * Given the three corrector fields chi_x, chi_y, chi_z (solutions of the periodic
+ * conservative finite-volume cell problem -div(D (e_k + grad chi_k)) = 0),
+ * assembles the symmetric positive semi-definite 3x3 effective diffusivity tensor
+ * by averaging harmonic face fluxes across the periodic unit cell:
*
- * D_eff[i][j] = (1/V) * sum_active{ delta_ij + d(chi_j)/d(x_i) }
+ * D_eff[r][c] = (1/N_total) * sum_{x in Omega} D_{x+1/2}^{(r)} * (delta_rc + (chi_c(x+e_r) -
+ * chi_c(x)) / h_r)
*/
#ifndef DEFF_TENSOR_H
#define DEFF_TENSOR_H
@@ -17,18 +19,20 @@
namespace OpenImpala {
-/** @brief Assembles the effective diffusivity tensor from corrector fields.
+/** @brief Assembles the effective diffusivity tensor from periodic corrector fields.
*
- * Computes D_eff[i][j] = (1/|Omega|) * integral_Omega { delta_ij + d(chi_j)/d(x_i) } dV
- * using central differences on the chi fields and masking by the active phase.
+ * Integrates conservative harmonic face fluxes across all +x, +y, +z faces in the
+ * periodic domain, preserving exact discrete Onsager symmetry and Voigt/Reuss bounds.
*
- * @param[out] Deff_tensor 3x3 output tensor (row-major: Deff_tensor[row][col]).
- * @param[in] mf_chi_x Corrector field for x-direction (1 component, >= 1 ghost cell).
- * @param[in] mf_chi_y Corrector field for y-direction (1 component, >= 1 ghost cell).
- * @param[in] mf_chi_z Corrector field for z-direction (1 component, >= 1 ghost cell).
- * @param[in] active_mask Integer mask: 1 = active cell, 0 = inactive (0 ghost cells).
- * @param[in] geom AMReX Geometry defining cell sizes for gradient computation.
- * @param[in] verbose Verbosity level (0 = silent).
+ * @param[out] Deff_tensor 3x3 output tensor (row-major: Deff_tensor[row][col]).
+ * @param[in] mf_chi_x Corrector field for x-direction (1 component, >= 1 ghost cell).
+ * @param[in] mf_chi_y Corrector field for y-direction (1 component, >= 1 ghost cell).
+ * @param[in] mf_chi_z Corrector field for z-direction (1 component, >= 1 ghost cell).
+ * @param[in] active_mask Integer mask: 1 = active cell, 0 = inactive (>= 0 ghost cells).
+ * @param[in] geom Periodic AMReX Geometry defining cell sizes and periodicity.
+ * @param[in] verbose Verbosity level (0 = silent).
+ * @param[in] mf_diff_coeff Optional cell-centred diffusivity MultiFab (defaults to 1.0 on active
+ * cells).
*/
void calculateDeffTensor(amrex::Real Deff_tensor[AMREX_SPACEDIM][AMREX_SPACEDIM],
const amrex::MultiFab& mf_chi_x, const amrex::MultiFab& mf_chi_y,
diff --git a/src/props/DeffTensor.cpp b/src/props/DeffTensor.cpp
index e929954c..341681c2 100644
--- a/src/props/DeffTensor.cpp
+++ b/src/props/DeffTensor.cpp
@@ -30,12 +30,38 @@ void calculateDeffTensor(amrex::Real Deff_tensor[AMREX_SPACEDIM][AMREX_SPACEDIM]
if (AMREX_SPACEDIM == 3) {
AMREX_ALWAYS_ASSERT(mf_chi_z.isDefined() && mf_chi_z.nGrow() >= 1);
}
- AMREX_ALWAYS_ASSERT(active_mask.nGrow() == 0);
+
+ const amrex::BoxArray& ba = active_mask.boxArray();
+ const amrex::DistributionMapping& dm = active_mask.DistributionMap();
+
+ // Populate 1-ghost periodic copies of active_mask and diff_coeff so +x/+y/+z
+ // harmonic face conductances are exact across tile and periodic boundaries.
+ amrex::iMultiFab mask_1g(ba, dm, 1, 1);
+ mask_1g.setVal(0);
+ amrex::Copy(mask_1g, active_mask, 0, 0, 1, 0);
+ mask_1g.FillBoundary(geom.periodicity());
+
+ const bool has_dc = (mf_diff_coeff != nullptr && mf_diff_coeff->isDefined());
+ amrex::MultiFab dc_1g(ba, dm, 1, 1);
+ dc_1g.setVal(0.0);
+ if (has_dc) {
+ amrex::Copy(dc_1g, *mf_diff_coeff, 0, 0, 1, 0);
+ } else {
+ for (amrex::MFIter mfi(dc_1g, amrex::TilingIfNotGPU()); mfi.isValid(); ++mfi) {
+ const amrex::Box& tbx = mfi.tilebox();
+ amrex::Array4 const dc_arr = dc_1g.array(mfi);
+ amrex::Array4 const m_arr = mask_1g.const_array(mfi);
+ amrex::ParallelFor(tbx, [=] AMREX_GPU_DEVICE(int i, int j, int k) noexcept {
+ dc_arr(i, j, k, 0) = (m_arr(i, j, k, 0) == 1) ? 1.0 : 0.0;
+ });
+ }
+ }
+ dc_1g.FillBoundary(geom.periodicity());
const amrex::Real* dx_arr = geom.CellSize();
- amrex::Real inv_2dx_0 = 1.0 / (2.0 * dx_arr[0]);
- amrex::Real inv_2dx_1 = 1.0 / (2.0 * dx_arr[1]);
- amrex::Real inv_2dx_2 = (AMREX_SPACEDIM == 3) ? 1.0 / (2.0 * dx_arr[2]) : 0.0;
+ const amrex::Real inv_dx_0 = 1.0 / dx_arr[0];
+ const amrex::Real inv_dx_1 = 1.0 / dx_arr[1];
+ const amrex::Real inv_dx_2 = (AMREX_SPACEDIM == 3) ? 1.0 / dx_arr[2] : 0.0;
// GPU-compatible 9-component reduction for the full D_eff tensor
amrex::ReduceOps
reduce_data(reduce_op);
- const bool has_dc = (mf_diff_coeff != nullptr && mf_diff_coeff->isDefined());
-
- for (amrex::MFIter mfi(active_mask); mfi.isValid(); ++mfi) {
+ for (amrex::MFIter mfi(mask_1g); mfi.isValid(); ++mfi) {
const amrex::Box& bx = mfi.validbox();
- amrex::Array4 const mask_arr = active_mask.const_array(mfi);
+ amrex::Array4 const mask_arr = mask_1g.const_array(mfi);
+ amrex::Array4 const dc_arr = dc_1g.const_array(mfi);
amrex::Array4 const chi_x_arr = mf_chi_x.const_array(mfi);
amrex::Array4 const chi_y_arr = mf_chi_y.const_array(mfi);
amrex::Array4 const chi_z_arr =
(AMREX_SPACEDIM == 3 && mf_chi_z.isDefined()) ? mf_chi_z.const_array(mfi)
: mf_chi_x.const_array(mfi);
- amrex::Array4 const dc_arr =
- has_dc ? mf_diff_coeff->const_array(mfi) : mf_chi_x.const_array(mfi);
reduce_op.eval(
bx, reduce_data,
[=] AMREX_GPU_DEVICE(int i, int j, int k) noexcept
- -> amrex::GpuTuple {
+ -> amrex::GpuTuple {
if (mask_arr(i, j, k, 0) != 1) {
return {0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0};
}
- const amrex::Real D_val = has_dc ? dc_arr(i, j, k, 0) : 1.0;
+ const amrex::Real D_c = dc_arr(i, j, k, 0);
+ if (D_c <= 0.0) {
+ return {0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0};
+ }
- amrex::Real dchix_dx =
- (chi_x_arr(i + 1, j, k, 0) - chi_x_arr(i - 1, j, k, 0)) * inv_2dx_0;
- amrex::Real dchix_dy =
- (chi_x_arr(i, j + 1, k, 0) - chi_x_arr(i, j - 1, k, 0)) * inv_2dx_1;
- amrex::Real dchiy_dx =
- (chi_y_arr(i + 1, j, k, 0) - chi_y_arr(i - 1, j, k, 0)) * inv_2dx_0;
- amrex::Real dchiy_dy =
- (chi_y_arr(i, j + 1, k, 0) - chi_y_arr(i, j - 1, k, 0)) * inv_2dx_1;
+ amrex::Real D_px = 0.0;
+ if (mask_arr(i + 1, j, k, 0) == 1) {
+ const amrex::Real D_nbr = dc_arr(i + 1, j, k, 0);
+ if (D_c + D_nbr > 0.0) {
+ D_px = 2.0 * D_c * D_nbr / (D_c + D_nbr);
+ }
+ }
+
+ amrex::Real D_py = 0.0;
+ if (mask_arr(i, j + 1, k, 0) == 1) {
+ const amrex::Real D_nbr = dc_arr(i, j + 1, k, 0);
+ if (D_c + D_nbr > 0.0) {
+ D_py = 2.0 * D_c * D_nbr / (D_c + D_nbr);
+ }
+ }
- amrex::Real dchix_dz = 0.0, dchiy_dz = 0.0;
- amrex::Real dchiz_dx = 0.0, dchiz_dy = 0.0, dchiz_dz = 0.0;
+ const amrex::Real dchix_dx =
+ (chi_x_arr(i + 1, j, k, 0) - chi_x_arr(i, j, k, 0)) * inv_dx_0;
+ const amrex::Real dchiy_dx =
+ (chi_y_arr(i + 1, j, k, 0) - chi_y_arr(i, j, k, 0)) * inv_dx_0;
+ const amrex::Real dchix_dy =
+ (chi_x_arr(i, j + 1, k, 0) - chi_x_arr(i, j, k, 0)) * inv_dx_1;
+ const amrex::Real dchiy_dy =
+ (chi_y_arr(i, j + 1, k, 0) - chi_y_arr(i, j, k, 0)) * inv_dx_1;
+
+ amrex::Real D_pz = 0.0;
+ amrex::Real dchiz_dx = 0.0, dchiz_dy = 0.0;
+ amrex::Real dchix_dz = 0.0, dchiy_dz = 0.0, dchiz_dz = 0.0;
if (AMREX_SPACEDIM == 3) {
- dchix_dz = (chi_x_arr(i, j, k + 1, 0) - chi_x_arr(i, j, k - 1, 0)) * inv_2dx_2;
- dchiy_dz = (chi_y_arr(i, j, k + 1, 0) - chi_y_arr(i, j, k - 1, 0)) * inv_2dx_2;
- dchiz_dx = (chi_z_arr(i + 1, j, k, 0) - chi_z_arr(i - 1, j, k, 0)) * inv_2dx_0;
- dchiz_dy = (chi_z_arr(i, j + 1, k, 0) - chi_z_arr(i, j - 1, k, 0)) * inv_2dx_1;
- dchiz_dz = (chi_z_arr(i, j, k + 1, 0) - chi_z_arr(i, j, k - 1, 0)) * inv_2dx_2;
+ if (mask_arr(i, j, k + 1, 0) == 1) {
+ const amrex::Real D_nbr = dc_arr(i, j, k + 1, 0);
+ if (D_c + D_nbr > 0.0) {
+ D_pz = 2.0 * D_c * D_nbr / (D_c + D_nbr);
+ }
+ }
+ dchiz_dx = (chi_z_arr(i + 1, j, k, 0) - chi_z_arr(i, j, k, 0)) * inv_dx_0;
+ dchiz_dy = (chi_z_arr(i, j + 1, k, 0) - chi_z_arr(i, j, k, 0)) * inv_dx_1;
+ dchix_dz = (chi_x_arr(i, j, k + 1, 0) - chi_x_arr(i, j, k, 0)) * inv_dx_2;
+ dchiy_dz = (chi_y_arr(i, j, k + 1, 0) - chi_y_arr(i, j, k, 0)) * inv_dx_2;
+ dchiz_dz = (chi_z_arr(i, j, k + 1, 0) - chi_z_arr(i, j, k, 0)) * inv_dx_2;
}
- // D_eff[r][c] = D(x) * (delta_rc + d(chi_c)/d(x_r)), summed over active cells
- // Cell problem: div(D grad chi_k) = -div(D e_k) => plus sign
- return {
- D_val * (1.0 + dchix_dx), D_val * dchiy_dx, D_val * dchiz_dx,
- D_val * dchix_dy, D_val * (1.0 + dchiy_dy), D_val * dchiz_dy,
- D_val * dchix_dz, D_val * dchiy_dz, D_val * (1.0 + dchiz_dz)};
+ // Conservative face flux: D_{i+1/2}^{(r)} * (delta_rc + (chi_c(i+e_r) - chi_c(i)) /
+ // h_r)
+ return {D_px * (1.0 + dchix_dx), D_px * dchiy_dx, D_px * dchiz_dx,
+ D_py * dchix_dy, D_py * (1.0 + dchiy_dy), D_py * dchiz_dy,
+ D_pz * dchix_dz, D_pz * dchiy_dz, D_pz * (1.0 + dchiz_dz)};
});
}
@@ -134,7 +182,7 @@ void calculateDeffTensor(amrex::Real Deff_tensor[AMREX_SPACEDIM][AMREX_SPACEDIM]
}
if (verbose > 1 && amrex::ParallelDescriptor::IOProcessor()) {
- amrex::Print() << " [calculateDeffTensor] Raw summed (1+dchi_x_dx): " << sum_local[0][0]
+ amrex::Print() << " [calculateDeffTensor] Raw summed flux_xx: " << sum_local[0][0]
<< ", N_total: " << N_total << std::endl;
}
}
diff --git a/src/props/EffDiffFillMtx.H b/src/props/EffDiffFillMtx.H
index 5dd61e03..c7d514a5 100644
--- a/src/props/EffDiffFillMtx.H
+++ b/src/props/EffDiffFillMtx.H
@@ -103,121 +103,92 @@ inline void effDiffFillMatrix(amrex::Real* a_out, amrex::Real* rhs_out, amrex::R
continue;
}
- // --- Active cell ---
+ // --- Active cell: conservative finite-volume -div(D (e_k + grad chi_k)) = 0 ---
const amrex::Real D_c = dc(i, j, k);
amrex::Real diag_val = 0.0;
- amrex::Real flux_bc_rhs = 0.0;
- // === LHS: div(D grad(chi_k)) with harmonic mean at faces ===
-
- // Track which neighbors are active for RHS computation
bool mx_active = (mask(i - 1, j, k) == CELL_ACTIVE);
bool px_active = (mask(i + 1, j, k) == CELL_ACTIVE);
bool my_active = (mask(i, j - 1, k) == CELL_ACTIVE);
bool py_active = (mask(i, j + 1, k) == CELL_ACTIVE);
- // -X face
+ amrex::Real D_mx = 0.0, D_px = 0.0;
+ amrex::Real D_my = 0.0, D_py = 0.0;
+ amrex::Real D_mz = 0.0, D_pz = 0.0;
+
+ // -X / +X faces (insulating faces contribute zero conductance)
if (mx_active) {
amrex::Real D_nbr = dc(i - 1, j, k);
- amrex::Real D_face = 2.0 * D_c * D_nbr / (D_c + D_nbr);
- a_out[stn + STN_MX] = -D_face * inv_dx2;
- diag_val += D_face * inv_dx2;
- } else {
- // Internal Neumann BC: ghost cell with dchi/dn = -(e_k . n_hat)
- diag_val += D_c * inv_dx2;
- if (dir_k == 0)
- flux_bc_rhs += D_c / dx;
+ if (D_c + D_nbr > 0.0)
+ D_mx = 2.0 * D_c * D_nbr / (D_c + D_nbr);
+ a_out[stn + STN_MX] = -D_mx * inv_dx2;
+ diag_val += D_mx * inv_dx2;
}
-
- // +X face
if (px_active) {
amrex::Real D_nbr = dc(i + 1, j, k);
- amrex::Real D_face = 2.0 * D_c * D_nbr / (D_c + D_nbr);
- a_out[stn + STN_PX] = -D_face * inv_dx2;
- diag_val += D_face * inv_dx2;
- } else {
- diag_val += D_c * inv_dx2;
- if (dir_k == 0)
- flux_bc_rhs -= D_c / dx;
+ if (D_c + D_nbr > 0.0)
+ D_px = 2.0 * D_c * D_nbr / (D_c + D_nbr);
+ a_out[stn + STN_PX] = -D_px * inv_dx2;
+ diag_val += D_px * inv_dx2;
}
- // -Y face
+ // -Y / +Y faces
if (my_active) {
amrex::Real D_nbr = dc(i, j - 1, k);
- amrex::Real D_face = 2.0 * D_c * D_nbr / (D_c + D_nbr);
- a_out[stn + STN_MY] = -D_face * inv_dy2;
- diag_val += D_face * inv_dy2;
- } else {
- diag_val += D_c * inv_dy2;
- if (dir_k == 1)
- flux_bc_rhs += D_c / dy;
+ if (D_c + D_nbr > 0.0)
+ D_my = 2.0 * D_c * D_nbr / (D_c + D_nbr);
+ a_out[stn + STN_MY] = -D_my * inv_dy2;
+ diag_val += D_my * inv_dy2;
}
-
- // +Y face
if (py_active) {
amrex::Real D_nbr = dc(i, j + 1, k);
- amrex::Real D_face = 2.0 * D_c * D_nbr / (D_c + D_nbr);
- a_out[stn + STN_PY] = -D_face * inv_dy2;
- diag_val += D_face * inv_dy2;
- } else {
- diag_val += D_c * inv_dy2;
- if (dir_k == 1)
- flux_bc_rhs -= D_c / dy;
+ if (D_c + D_nbr > 0.0)
+ D_py = 2.0 * D_c * D_nbr / (D_c + D_nbr);
+ a_out[stn + STN_PY] = -D_py * inv_dy2;
+ diag_val += D_py * inv_dy2;
}
#if (AMREX_SPACEDIM == 3)
bool mz_active = (mask(i, j, k - 1) == CELL_ACTIVE);
bool pz_active = (mask(i, j, k + 1) == CELL_ACTIVE);
- // -Z face
+ // -Z / +Z faces
if (mz_active) {
amrex::Real D_nbr = dc(i, j, k - 1);
- amrex::Real D_face = 2.0 * D_c * D_nbr / (D_c + D_nbr);
- a_out[stn + STN_MZ] = -D_face * inv_dz2;
- diag_val += D_face * inv_dz2;
- } else {
- diag_val += D_c * inv_dz2;
- if (dir_k == 2)
- flux_bc_rhs += D_c / dz;
+ if (D_c + D_nbr > 0.0)
+ D_mz = 2.0 * D_c * D_nbr / (D_c + D_nbr);
+ a_out[stn + STN_MZ] = -D_mz * inv_dz2;
+ diag_val += D_mz * inv_dz2;
}
-
- // +Z face
if (pz_active) {
amrex::Real D_nbr = dc(i, j, k + 1);
- amrex::Real D_face = 2.0 * D_c * D_nbr / (D_c + D_nbr);
- a_out[stn + STN_PZ] = -D_face * inv_dz2;
- diag_val += D_face * inv_dz2;
- } else {
- diag_val += D_c * inv_dz2;
- if (dir_k == 2)
- flux_bc_rhs -= D_c / dz;
+ if (D_c + D_nbr > 0.0)
+ D_pz = 2.0 * D_c * D_nbr / (D_c + D_nbr);
+ a_out[stn + STN_PZ] = -D_pz * inv_dz2;
+ diag_val += D_pz * inv_dz2;
}
#endif
+ // Tiny regularisation keeps disconnected active pockets nonsingular
+ diag_val += 1.0e-12 * D_c * (inv_dx2 + inv_dy2 + inv_dz2);
a_out[stn + STN_C] = diag_val;
- // === RHS: -div(D e_k) using central differences ===
- amrex::Real rhs_div_De = 0.0;
+ // Conservative face-flux RHS: (D_{i+1/2}^{(k)} - D_{i-1/2}^{(k)}) / h_k
+ amrex::Real rhs_val = 0.0;
if (dir_k == 0) {
- rhs_div_De = -(dc(i + 1, j, k) - dc(i - 1, j, k)) * inv_2dx;
+ rhs_val = (D_px - D_mx) * inv_dx2 * dx;
} else if (dir_k == 1) {
- rhs_div_De = -(dc(i, j + 1, k) - dc(i, j - 1, k)) * inv_2dy;
+ rhs_val = (D_py - D_my) * inv_dy2 * dy;
}
#if (AMREX_SPACEDIM == 3)
else if (dir_k == 2) {
- rhs_div_De = -(dc(i, j, k + 1) - dc(i, j, k - 1)) * inv_2dz;
+ rhs_val = (D_pz - D_mz) * inv_dz2 * dz;
}
#endif
-
- rhs_out[m_idx] = rhs_div_De + flux_bc_rhs;
+ rhs_out[m_idx] = rhs_val;
// Safety: decouple cells with near-zero diagonal
if (std::abs(diag_val) < SMALL_REAL) {
- if (verbose > 0) {
- std::printf("effdiff_fillmtx WARNING: Near-zero diagonal in ACTIVE "
- "cell (%d,%d,%d), diag_val=%.4e. Decoupling.\n",
- i, j, k, diag_val);
- }
for (int s = 0; s < NSTEN; ++s)
a_out[stn + s] = 0.0;
a_out[stn + STN_C] = 1.0;
@@ -225,16 +196,6 @@ inline void effDiffFillMatrix(amrex::Real* a_out, amrex::Real* rhs_out, amrex::R
xinit_out[m_idx] = 0.0;
}
- if (verbose >= 3) {
- std::printf("DEBUG effdiff_fillmtx: Cell (%d,%d,%d) dir_k=%d D_c=%.4e\n", i, j,
- k, dir_k, D_c);
- std::printf(" Stencil A: %.4e %.4e %.4e %.4e %.4e %.4e %.4e\n", a_out[stn],
- a_out[stn + 1], a_out[stn + 2], a_out[stn + 3], a_out[stn + 4],
- a_out[stn + 5], a_out[stn + 6]);
- std::printf(" RHS terms: div_De=%.4e flux_bc=%.4e Total_RHS=%.4e\n",
- rhs_div_De, flux_bc_rhs, rhs_out[m_idx]);
- }
-
++m_idx;
}
}
@@ -251,8 +212,8 @@ inline void effDiffFillMatrix(amrex::Real* a_out, amrex::Real* rhs_out, amrex::R
/**
* @brief GPU-compatible effective diffusivity matrix fill using AMReX ParallelFor.
*
- * Fills HYPRE stencil coefficients, RHS, and initial guess for the cell problem
- * div(D grad(chi_k)) = -div(D e_k) on GPU. Uses Array4<> accessors.
+ * Fills HYPRE stencil coefficients, RHS, and initial guess for the conservative
+ * finite-volume cell problem -div(D (e_k + grad chi_k)) = 0 on GPU.
*
* @param bx Valid box defining the region.
* @param a_out Device pointer: flattened stencil, size bx.numPts()*7.
@@ -277,12 +238,12 @@ inline void effDiffFillMatrixGpu(const amrex::Box& bx, amrex::Real* a_out, amrex
const amrex::Real dy = cell_sizes[1];
const amrex::Real dz = cell_sizes[2];
- const amrex::Real inv_dx2 = 1.0 / (dx * dx);
- const amrex::Real inv_dy2 = 1.0 / (dy * dy);
- const amrex::Real inv_dz2 = 1.0 / (dz * dz);
- const amrex::Real inv_2dx = 1.0 / (2.0 * dx);
- const amrex::Real inv_2dy = 1.0 / (2.0 * dy);
- const amrex::Real inv_2dz = 1.0 / (2.0 * dz);
+ const amrex::Real inv_dx = 1.0 / dx;
+ const amrex::Real inv_dy = 1.0 / dy;
+ const amrex::Real inv_dz = 1.0 / dz;
+ const amrex::Real inv_dx2 = inv_dx * inv_dx;
+ const amrex::Real inv_dy2 = inv_dy * inv_dy;
+ const amrex::Real inv_dz2 = inv_dz * inv_dz;
constexpr int NSTEN = 7;
@@ -302,111 +263,84 @@ inline void effDiffFillMatrixGpu(const amrex::Box& bx, amrex::Real* a_out, amrex
return;
}
- // Active cell
const amrex::Real D_c = dc_arr(i, j, k);
amrex::Real diag_val = 0.0;
- amrex::Real flux_bc_rhs = 0.0;
bool mx_active = (mask_arr(i - 1, j, k) == CELL_ACTIVE);
bool px_active = (mask_arr(i + 1, j, k) == CELL_ACTIVE);
bool my_active = (mask_arr(i, j - 1, k) == CELL_ACTIVE);
bool py_active = (mask_arr(i, j + 1, k) == CELL_ACTIVE);
- // -X face
+ amrex::Real D_mx = 0.0, D_px = 0.0;
+ amrex::Real D_my = 0.0, D_py = 0.0;
+ amrex::Real D_mz = 0.0, D_pz = 0.0;
+
if (mx_active) {
amrex::Real D_nbr = dc_arr(i - 1, j, k);
- amrex::Real D_face = 2.0 * D_c * D_nbr / (D_c + D_nbr);
- a_out[stn + STN_MX] = -D_face * inv_dx2;
- diag_val += D_face * inv_dx2;
- } else {
- diag_val += D_c * inv_dx2;
- if (dir_k == 0)
- flux_bc_rhs += D_c / dx;
+ if (D_c + D_nbr > 0.0)
+ D_mx = 2.0 * D_c * D_nbr / (D_c + D_nbr);
+ a_out[stn + STN_MX] = -D_mx * inv_dx2;
+ diag_val += D_mx * inv_dx2;
}
-
- // +X face
if (px_active) {
amrex::Real D_nbr = dc_arr(i + 1, j, k);
- amrex::Real D_face = 2.0 * D_c * D_nbr / (D_c + D_nbr);
- a_out[stn + STN_PX] = -D_face * inv_dx2;
- diag_val += D_face * inv_dx2;
- } else {
- diag_val += D_c * inv_dx2;
- if (dir_k == 0)
- flux_bc_rhs -= D_c / dx;
+ if (D_c + D_nbr > 0.0)
+ D_px = 2.0 * D_c * D_nbr / (D_c + D_nbr);
+ a_out[stn + STN_PX] = -D_px * inv_dx2;
+ diag_val += D_px * inv_dx2;
}
- // -Y face
if (my_active) {
amrex::Real D_nbr = dc_arr(i, j - 1, k);
- amrex::Real D_face = 2.0 * D_c * D_nbr / (D_c + D_nbr);
- a_out[stn + STN_MY] = -D_face * inv_dy2;
- diag_val += D_face * inv_dy2;
- } else {
- diag_val += D_c * inv_dy2;
- if (dir_k == 1)
- flux_bc_rhs += D_c / dy;
+ if (D_c + D_nbr > 0.0)
+ D_my = 2.0 * D_c * D_nbr / (D_c + D_nbr);
+ a_out[stn + STN_MY] = -D_my * inv_dy2;
+ diag_val += D_my * inv_dy2;
}
-
- // +Y face
if (py_active) {
amrex::Real D_nbr = dc_arr(i, j + 1, k);
- amrex::Real D_face = 2.0 * D_c * D_nbr / (D_c + D_nbr);
- a_out[stn + STN_PY] = -D_face * inv_dy2;
- diag_val += D_face * inv_dy2;
- } else {
- diag_val += D_c * inv_dy2;
- if (dir_k == 1)
- flux_bc_rhs -= D_c / dy;
+ if (D_c + D_nbr > 0.0)
+ D_py = 2.0 * D_c * D_nbr / (D_c + D_nbr);
+ a_out[stn + STN_PY] = -D_py * inv_dy2;
+ diag_val += D_py * inv_dy2;
}
#if (AMREX_SPACEDIM == 3)
bool mz_active = (mask_arr(i, j, k - 1) == CELL_ACTIVE);
bool pz_active = (mask_arr(i, j, k + 1) == CELL_ACTIVE);
- // -Z face
if (mz_active) {
amrex::Real D_nbr = dc_arr(i, j, k - 1);
- amrex::Real D_face = 2.0 * D_c * D_nbr / (D_c + D_nbr);
- a_out[stn + STN_MZ] = -D_face * inv_dz2;
- diag_val += D_face * inv_dz2;
- } else {
- diag_val += D_c * inv_dz2;
- if (dir_k == 2)
- flux_bc_rhs += D_c / dz;
+ if (D_c + D_nbr > 0.0)
+ D_mz = 2.0 * D_c * D_nbr / (D_c + D_nbr);
+ a_out[stn + STN_MZ] = -D_mz * inv_dz2;
+ diag_val += D_mz * inv_dz2;
}
-
- // +Z face
if (pz_active) {
amrex::Real D_nbr = dc_arr(i, j, k + 1);
- amrex::Real D_face = 2.0 * D_c * D_nbr / (D_c + D_nbr);
- a_out[stn + STN_PZ] = -D_face * inv_dz2;
- diag_val += D_face * inv_dz2;
- } else {
- diag_val += D_c * inv_dz2;
- if (dir_k == 2)
- flux_bc_rhs -= D_c / dz;
+ if (D_c + D_nbr > 0.0)
+ D_pz = 2.0 * D_c * D_nbr / (D_c + D_nbr);
+ a_out[stn + STN_PZ] = -D_pz * inv_dz2;
+ diag_val += D_pz * inv_dz2;
}
#endif
+ diag_val += 1.0e-12 * D_c * (inv_dx2 + inv_dy2 + inv_dz2);
a_out[stn + STN_C] = diag_val;
- // RHS: -div(D e_k) using central differences
- amrex::Real rhs_div_De = 0.0;
+ amrex::Real rhs_val = 0.0;
if (dir_k == 0) {
- rhs_div_De = -(dc_arr(i + 1, j, k) - dc_arr(i - 1, j, k)) * inv_2dx;
+ rhs_val = (D_px - D_mx) * inv_dx;
} else if (dir_k == 1) {
- rhs_div_De = -(dc_arr(i, j + 1, k) - dc_arr(i, j - 1, k)) * inv_2dy;
+ rhs_val = (D_py - D_my) * inv_dy;
}
#if (AMREX_SPACEDIM == 3)
else if (dir_k == 2) {
- rhs_div_De = -(dc_arr(i, j, k + 1) - dc_arr(i, j, k - 1)) * inv_2dz;
+ rhs_val = (D_pz - D_mz) * inv_dz;
}
#endif
+ rhs_out[m_idx] = rhs_val;
- rhs_out[m_idx] = rhs_div_De + flux_bc_rhs;
-
- // Safety: decouple near-zero diagonal
if (amrex::Math::abs(diag_val) < SMALL_REAL) {
for (int s = 0; s < NSTEN; ++s)
a_out[stn + s] = 0.0;
diff --git a/src/props/EffectiveDiffusivityHypre.cpp b/src/props/EffectiveDiffusivityHypre.cpp
index 12e08544..55e556b7 100644
--- a/src/props/EffectiveDiffusivityHypre.cpp
+++ b/src/props/EffectiveDiffusivityHypre.cpp
@@ -571,8 +571,29 @@ void EffectiveDiffusivityHypre::setupMatrixEquation() {
auto lo = EffectiveDiffusivityHypre::loV(pin_box);
auto hi = EffectiveDiffusivityHypre::hiV(pin_box);
+ amrex::Real max_d = 0.0;
+ for (const auto& kv : m_phase_coeff_map) {
+ max_d = std::max(max_d, kv.second);
+ }
+ const amrex::Real pin_scale = (max_d > 0.0 ? max_d : 1.0) / (m_dx[0] * m_dx[0]);
+
std::vector pin_mtx(stencil_size, 0.0);
- pin_mtx[0] = 1.0; // center diagonal = 1
+ pin_mtx[0] = pin_scale;
+#ifdef OPENIMPALA_USE_GPU
+ amrex::Gpu::DeviceVector d_pin_mtx(stencil_size);
+ amrex::Gpu::copy(amrex::Gpu::hostToDevice, pin_mtx.begin(), pin_mtx.end(),
+ d_pin_mtx.begin());
+ amrex::Gpu::DeviceVector d_pin_zero(1, 0.0);
+ amrex::Gpu::streamSynchronize();
+
+ ierr = HYPRE_StructMatrixSetBoxValues(m_A, lo.data(), hi.data(), stencil_size,
+ stencil_indices_hypre, d_pin_mtx.data());
+ HYPRE_CHECK(ierr);
+ ierr = HYPRE_StructVectorSetBoxValues(m_b, lo.data(), hi.data(), d_pin_zero.data());
+ HYPRE_CHECK(ierr);
+ ierr = HYPRE_StructVectorSetBoxValues(m_x, lo.data(), hi.data(), d_pin_zero.data());
+ HYPRE_CHECK(ierr);
+#else
amrex::Real pin_rhs = 0.0;
amrex::Real pin_x = 0.0;
@@ -583,6 +604,7 @@ void EffectiveDiffusivityHypre::setupMatrixEquation() {
HYPRE_CHECK(ierr);
ierr = HYPRE_StructVectorSetBoxValues(m_x, lo.data(), hi.data(), &pin_x);
HYPRE_CHECK(ierr);
+#endif
if (m_verbose > 0 && amrex::ParallelDescriptor::IOProcessor()) {
amrex::Print() << " setupMatrixEquation: Pinned active cell (" << local_pin[0]
diff --git a/src/props/TortuosityHypre.cpp b/src/props/TortuosityHypre.cpp
index be9a0432..e818e11f 100644
--- a/src/props/TortuosityHypre.cpp
+++ b/src/props/TortuosityHypre.cpp
@@ -1307,7 +1307,7 @@ void OpenImpala::TortuosityHypre::global_fluxes() {
flux_reduce_op.eval(
lobox_face, flux_reduce_data,
[=] AMREX_GPU_DEVICE(int i, int j, int k) noexcept
- -> amrex::GpuTuple {
+ -> amrex::GpuTuple {
amrex::Real fxin = 0.0, cells_in = 0.0;
if (mask(i, j, k) == cell_active) {
cells_in = 1.0;
@@ -1332,7 +1332,7 @@ void OpenImpala::TortuosityHypre::global_fluxes() {
flux_reduce_op.eval(
hibox_face, flux_reduce_data,
[=] AMREX_GPU_DEVICE(int i, int j, int k) noexcept
- -> amrex::GpuTuple {
+ -> amrex::GpuTuple {
amrex::Real fxout = 0.0, cells_out = 0.0;
if (mask(i, j, k) == cell_active) {
cells_out = 1.0;
diff --git a/src/props/TortuositySolverBase.cpp b/src/props/TortuositySolverBase.cpp
index f7863235..dfa21ef9 100644
--- a/src/props/TortuositySolverBase.cpp
+++ b/src/props/TortuositySolverBase.cpp
@@ -346,7 +346,7 @@ void TortuositySolverBase::globalFluxes() {
if (!lobox_face.isEmpty()) {
flux_reduce_op.eval(lobox_face, flux_reduce_data,
[=] AMREX_GPU_DEVICE(int i, int j, int k) noexcept
- -> amrex::GpuTuple {
+ -> amrex::GpuTuple {
amrex::IntVect iv(i, j, k);
if (mask(iv) == cell_active) {
return {-2.0 * dc(iv) * (soln(iv) - vlo) / dxd, 0.0};
@@ -362,7 +362,7 @@ void TortuositySolverBase::globalFluxes() {
if (!hibox_face.isEmpty()) {
flux_reduce_op.eval(hibox_face, flux_reduce_data,
[=] AMREX_GPU_DEVICE(int i, int j, int k) noexcept
- -> amrex::GpuTuple {
+ -> amrex::GpuTuple {
amrex::IntVect iv(i, j, k);
if (mask(iv) == cell_active) {
return {0.0, -2.0 * dc(iv) * (vhi - soln(iv)) / dxd};
diff --git a/tests/tEffectiveDiffusivity.cpp b/tests/tEffectiveDiffusivity.cpp
index 911c749f..b7f1c629 100644
--- a/tests/tEffectiveDiffusivity.cpp
+++ b/tests/tEffectiveDiffusivity.cpp
@@ -1,6 +1,7 @@
// tests/tEffectiveDiffusivity.cpp
#include "TiffReader.H"
+#include "DeffTensor.H"
#include "EffectiveDiffusivityHypre.H"
#include "Tortuosity.H"
#include "SolverConfig.H"
@@ -36,120 +37,8 @@ void calculate_Deff_tensor_homogenization(amrex::Real Deff_tensor[AMREX_SPACEDIM
const amrex::iMultiFab& active_mask,
const amrex::MultiFab& diff_coeff,
const amrex::Geometry& geom, int verbose_level) {
- BL_PROFILE("calculate_Deff_tensor_homogenization");
- for (int i = 0; i < AMREX_SPACEDIM; ++i) {
- for (int j = 0; j < AMREX_SPACEDIM; ++j) {
- Deff_tensor[i][j] = 0.0;
- }
- }
- AMREX_ASSERT(mf_chi_x_in.nGrow() >= 1);
- AMREX_ASSERT(mf_chi_y_in.nGrow() >= 1);
- if (AMREX_SPACEDIM == 3) {
- AMREX_ASSERT(mf_chi_z_in.isDefined() && mf_chi_z_in.nGrow() >= 1);
- }
- AMREX_ASSERT(active_mask.nGrow() == 0);
- AMREX_ASSERT(diff_coeff.nGrow() == 0);
-
- const amrex::Real* dx_arr = geom.CellSize();
- amrex::Real inv_2dx[AMREX_SPACEDIM];
- for (int i = 0; i < AMREX_SPACEDIM; ++i) {
- inv_2dx[i] = 1.0 / (2.0 * dx_arr[i]);
- }
-
- amrex::Real sum_integrand_tensor_comp_local[AMREX_SPACEDIM][AMREX_SPACEDIM];
- for (int i = 0; i < AMREX_SPACEDIM; ++i) {
- for (int j = 0; j < AMREX_SPACEDIM; ++j) {
- sum_integrand_tensor_comp_local[i][j] = 0.0;
- }
- }
-
-#ifdef AMREX_USE_OMP
-#pragma omp parallel reduction(+ : sum_integrand_tensor_comp_local)
-#endif
- for (amrex::MFIter mfi(active_mask, amrex::TilingIfNotGPU()); mfi.isValid(); ++mfi) {
- const amrex::Box& bx = mfi.tilebox();
- amrex::Array4 const mask_arr = active_mask.const_array(mfi);
- amrex::Array4 const dc_arr = diff_coeff.const_array(mfi);
- amrex::Array4 const chi_x_arr = mf_chi_x_in.const_array(mfi);
- amrex::Array4 const chi_y_arr = mf_chi_y_in.const_array(mfi);
- amrex::Array4 const chi_z_arr =
- (AMREX_SPACEDIM == 3 && mf_chi_z_in.isDefined()) ? mf_chi_z_in.const_array(mfi)
- : mf_chi_x_in.const_array(mfi);
-
- amrex::LoopOnCpu(bx, [=, &sum_integrand_tensor_comp_local](int i, int j, int k) noexcept {
- if (mask_arr(i, j, k, 0) == 1) {
- amrex::Real D_val = dc_arr(i, j, k, 0);
- amrex::Real grad_chi_x[AMREX_SPACEDIM] = {0.0};
- amrex::Real grad_chi_y[AMREX_SPACEDIM] = {0.0};
- amrex::Real grad_chi_z[AMREX_SPACEDIM] = {0.0};
-
- grad_chi_x[0] =
- (chi_x_arr(i + 1, j, k, 0) - chi_x_arr(i - 1, j, k, 0)) * inv_2dx[0];
- grad_chi_x[1] =
- (chi_x_arr(i, j + 1, k, 0) - chi_x_arr(i, j - 1, k, 0)) * inv_2dx[1];
- if (AMREX_SPACEDIM == 3)
- grad_chi_x[2] =
- (chi_x_arr(i, j, k + 1, 0) - chi_x_arr(i, j, k - 1, 0)) * inv_2dx[2];
-
- grad_chi_y[0] =
- (chi_y_arr(i + 1, j, k, 0) - chi_y_arr(i - 1, j, k, 0)) * inv_2dx[0];
- grad_chi_y[1] =
- (chi_y_arr(i, j + 1, k, 0) - chi_y_arr(i, j - 1, k, 0)) * inv_2dx[1];
- if (AMREX_SPACEDIM == 3)
- grad_chi_y[2] =
- (chi_y_arr(i, j, k + 1, 0) - chi_y_arr(i, j, k - 1, 0)) * inv_2dx[2];
-
- if (AMREX_SPACEDIM == 3) {
- grad_chi_z[0] =
- (chi_z_arr(i + 1, j, k, 0) - chi_z_arr(i - 1, j, k, 0)) * inv_2dx[0];
- grad_chi_z[1] =
- (chi_z_arr(i, j + 1, k, 0) - chi_z_arr(i, j - 1, k, 0)) * inv_2dx[1];
- grad_chi_z[2] =
- (chi_z_arr(i, j, k + 1, 0) - chi_z_arr(i, j, k - 1, 0)) * inv_2dx[2];
- }
-
- // D_eff[i][j] = (1/|V|) * sum( D(x) * (delta_ij + d_chi_j/d_x_i) )
- sum_integrand_tensor_comp_local[0][0] += D_val * (1.0 - grad_chi_x[0]);
- sum_integrand_tensor_comp_local[0][1] += D_val * (-grad_chi_y[0]);
- sum_integrand_tensor_comp_local[1][0] += D_val * (-grad_chi_x[1]);
- sum_integrand_tensor_comp_local[1][1] += D_val * (1.0 - grad_chi_y[1]);
-
- if (AMREX_SPACEDIM == 3) {
- sum_integrand_tensor_comp_local[0][2] += D_val * (-grad_chi_z[0]);
- sum_integrand_tensor_comp_local[2][0] += D_val * (-grad_chi_x[2]);
- sum_integrand_tensor_comp_local[1][2] += D_val * (-grad_chi_z[1]);
- sum_integrand_tensor_comp_local[2][1] += D_val * (-grad_chi_y[2]);
- sum_integrand_tensor_comp_local[2][2] += D_val * (1.0 - grad_chi_z[2]);
- }
- }
- });
- }
-
- for (int r = 0; r < AMREX_SPACEDIM; ++r) {
- for (int c = 0; c < AMREX_SPACEDIM; ++c) {
- amrex::ParallelDescriptor::ReduceRealSum(sum_integrand_tensor_comp_local[r][c]);
- }
- }
-
- amrex::Long N_total_cells_in_domain = geom.Domain().numPts();
- if (N_total_cells_in_domain > 0) {
- for (int l_idx = 0; l_idx < AMREX_SPACEDIM; ++l_idx) {
- for (int m_idx = 0; m_idx < AMREX_SPACEDIM; ++m_idx) {
- Deff_tensor[l_idx][m_idx] = sum_integrand_tensor_comp_local[l_idx][m_idx] /
- static_cast(N_total_cells_in_domain);
- }
- }
- } else {
- if (amrex::ParallelDescriptor::IOProcessor() && verbose_level > 0) {
- amrex::Warning("Total cells in domain is zero, D_eff cannot be calculated.");
- }
- }
-
- if (verbose_level > 1 && amrex::ParallelDescriptor::IOProcessor()) {
- amrex::Print() << " [TestCalcDeff] Raw summed D*(1-dchi_x_dx): "
- << sum_integrand_tensor_comp_local[0][0]
- << ", N_total_cells: " << N_total_cells_in_domain << std::endl;
- }
+ OpenImpala::calculateDeffTensor(Deff_tensor, mf_chi_x_in, mf_chi_y_in, mf_chi_z_in, active_mask,
+ geom, verbose_level, &diff_coeff);
}
} // end anonymous namespace
From 85b181a405f8f33b82bce298ad8a7b46ad8d6224 Mon Sep 17 00:00:00 2001
From: James Le Houx <37665786+jameslehoux@users.noreply.github.com>
Date: Wed, 18 Nov 2026 10:17:17 +0000
Subject: [PATCH 2/5] feat(python,tutorials): add sample datasets, notebook
ergonomics, and 5 executed tutorials
---
notebooks/profiling_and_tuning.ipynb | 583 ------------------
notebooks/visualization_yt.ipynb | 399 ------------
python/openimpala/__init__.py | 6 +-
python/openimpala/_io.py | 453 ++++++++++++++
python/openimpala/datasets.py | 113 ++++
python/openimpala/facade.py | 362 ++++++++---
python/openimpala/session.py | 29 +-
python/tests/test_config.py | 2 +-
python/tests/test_datasets_and_io.py | 150 +++++
python/tests/test_enums.py | 4 +-
python/tests/test_facade_helpers.py | 2 +-
python/tests/test_percolation.py | 6 +-
python/tests/test_plane_flux_diagnostic.py | 3 +-
python/tests/test_tortuosity.py | 6 +-
python/tests/test_volume_fraction.py | 6 +-
tutorials/01_getting_started.ipynb | 469 ++++++++++++++
tutorials/01_hello_openimpala.ipynb | 116 ----
tutorials/02_digital_twin.ipynb | 182 ------
.../02_microstructure_and_anisotropy.ipynb | 438 +++++++++++++
tutorials/03_homogenisation_tensor.ipynb | 555 +++++++++++++++++
tutorials/03_rev_and_uncertainty.ipynb | 247 --------
tutorials/04_multiphase_and_fields.ipynb | 153 -----
tutorials/04_multiphase_transport.ipynb | 447 ++++++++++++++
tutorials/05_rev_and_uncertainty.ipynb | 334 ++++++++++
tutorials/05_surrogate_modelling.ipynb | 140 -----
tutorials/06_topology_optimisation.ipynb | 136 ----
tutorials/07_hpc_scaling.ipynb | 367 -----------
27 files changed, 3304 insertions(+), 2404 deletions(-)
delete mode 100644 notebooks/profiling_and_tuning.ipynb
delete mode 100644 notebooks/visualization_yt.ipynb
create mode 100644 python/openimpala/_io.py
create mode 100644 python/openimpala/datasets.py
create mode 100644 python/tests/test_datasets_and_io.py
create mode 100644 tutorials/01_getting_started.ipynb
delete mode 100644 tutorials/01_hello_openimpala.ipynb
delete mode 100644 tutorials/02_digital_twin.ipynb
create mode 100644 tutorials/02_microstructure_and_anisotropy.ipynb
create mode 100644 tutorials/03_homogenisation_tensor.ipynb
delete mode 100644 tutorials/03_rev_and_uncertainty.ipynb
delete mode 100644 tutorials/04_multiphase_and_fields.ipynb
create mode 100644 tutorials/04_multiphase_transport.ipynb
create mode 100644 tutorials/05_rev_and_uncertainty.ipynb
delete mode 100644 tutorials/05_surrogate_modelling.ipynb
delete mode 100644 tutorials/06_topology_optimisation.ipynb
delete mode 100644 tutorials/07_hpc_scaling.ipynb
diff --git a/notebooks/profiling_and_tuning.ipynb b/notebooks/profiling_and_tuning.ipynb
deleted file mode 100644
index 000a65ec..00000000
--- a/notebooks/profiling_and_tuning.ipynb
+++ /dev/null
@@ -1,583 +0,0 @@
-{
- "nbformat": 4,
- "nbformat_minor": 0,
- "metadata": {
- "colab": {
- "provenance": [],
- "gpuType": "T4"
- },
- "kernelspec": {
- "name": "python3",
- "display_name": "Python 3"
- },
- "language_info": {
- "name": "python"
- },
- "accelerator": "GPU"
- },
- "cells": [
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": "[](https://colab.research.google.com/github/BASE-Laboratory/OpenImpala/blob/master/notebooks/profiling_and_tuning.ipynb)\n\n# OpenImpala — Profiling and Performance Tuning\n\nThis notebook is the diagnostic complement to the seven user tutorials. Where the tutorials show *what to do*, this one shows *why a given solve takes the time it does* — and what to change when it takes too long.\n\nThe headline result, summarised up front: **the default solver `solver=\"auto\"` is now MLMG** (AMReX's matrix-free geometric multigrid), the only option that scales near-linearly with voxel count. The notebook validates that experimentally on real porespy data, compares it against every HYPRE Krylov + multigrid configuration, and provides the diagnostics needed to spot regressions in future versions.\n\n## Contents\n\n| Section | Topic |\n|---|---|\n| 1 | Setup — environment detection and dependency install |\n| 1a | Build verification — confirm the GPU build is actually active |\n| 2 | Synthetic datasets at 16³ – 128³ |\n| **3** | **Solver bake-off on porous media — the headline diagnostic** |\n| **4** | **Scaling validation (4 solvers) — does compute hold O(N)?** |\n| 5 | `max_grid_size` tuning |\n| 6 | NVIDIA Nsight Systems — GPU kernel timeline (optional) |\n| 7 | Appendix — binding overhead diagnostics |\n| 8 | Summary & HPC recommendations |\n\nSections 1 – 5 run on any environment in a few minutes. Section 6 produces the most useful output on a Colab GPU runtime (T4 / A100 / L4) with `nsys` available.\n"
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": "## 1. Setup\n\nDetect hardware, install dependencies, import, start a session."
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "import subprocess\n",
- "try:\n",
- " r = subprocess.run([\"nvidia-smi\", \"--query-gpu=name\", \"--format=csv,noheader\"],\n",
- " capture_output=True, text=True, timeout=10)\n",
- " gpu_name = r.stdout.strip()\n",
- " print(f\"GPU detected: {gpu_name}\" if gpu_name else \"No GPU — CPU only.\")\n",
- "except FileNotFoundError:\n",
- " gpu_name = \"\"\n",
- " print(\"nvidia-smi not found — CPU only.\")\n"
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": "# OpenImpala ships two PyPI wheels:\n# openimpala — pure-Python + SciPy fallback (CPU only)\n# openimpala-cuda — compiled C++ HYPRE/AMReX backend with CUDA kernels\n#\n# On a GPU runtime we install the CUDA wheel; otherwise we fall back to the\n# pure-Python package.\n!apt-get install -y libopenmpi-dev > /dev/null 2>&1\nif gpu_name:\n print(\"GPU detected — installing openimpala-cuda\")\n !pip install -q openimpala-cuda porespy py-spy\nelse:\n print(\"No GPU detected — installing openimpala (CPU)\")\n !pip install -q openimpala porespy py-spy\nprint(\"Dependencies installed.\")"
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "import openimpala as oi\n",
- "from openimpala import core as oic # noqa: F401\n",
- "import numpy as np\n",
- "import pandas as pd\n",
- "import matplotlib.pyplot as plt\n",
- "import time, io, sys, re, cProfile, pstats, warnings\n",
- "\n",
- "warnings.filterwarnings(\"ignore\")\n",
- "plt.style.use(\"seaborn-v0_8-whitegrid\")\n",
- "print(f\"OpenImpala version: {oi.__version__}\")\n"
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "session = oi.Session()\n",
- "session.__enter__()\n",
- "print(\"OpenImpala session started.\")\n"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": "## 1a. Build verification\n\nBefore profiling anything, confirm that the wheel `pip` installed actually has the GPU backend you expect. The most common cause of \"OpenImpala feels slow on Colab\" is a CPU-only wheel running on a GPU-equipped host — every solve in the rest of the notebook would be CPU-bound and ~10–50× slower than necessary on a single-phase 3D diffusion problem at 128³+.\n\n`oi.build_info()` returns a dict of compile-time feature flags plus the runtime GPU device count. We check that the backend matches the hardware, and warn loudly if it doesn't."
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": "info = oi.build_info()\nbackend = info[\"backend\"] # one of: cpp-cuda, cpp-hip, cpp-cpu, pure-python\n\nprint(f\"openimpala backend: {backend}\")\nprint(f\" version: {info.get('version', 'unknown')}\")\nprint(f\" OpenMP threads: {info.get('openmp_max_threads', 1)}\")\nprint(f\" MPI enabled: {info.get('mpi_enabled', False)}\")\nprint(f\" HYPRE CUDA: {info.get('hypre_cuda', False)}\")\nprint(f\" TinyProfile: {info.get('tiny_profile', False)}\")\nif info.get(\"gpu_device_count\", -1) > 0:\n print(f\" GPU devices: {info['gpu_device_count']}\")\n\nis_gpu_build = backend in (\"cpp-cuda\", \"cpp-hip\")\n\nif gpu_name and not is_gpu_build:\n print()\n print(\"=\" * 70)\n print(\" WARNING: CPU-only build detected on a GPU-equipped host\")\n print(\"=\" * 70)\n print(f\" Host GPU: {gpu_name}\")\n print(f\" openimpala build: {backend}\")\n print()\n print(\" The GPU is idle. Every solve in this notebook will run on the CPU,\")\n print(\" which is typically 10–50× slower than the CUDA build for\")\n print(\" single-phase 3D diffusion on 128³+ grids.\")\n print()\n print(\" To fix:\")\n print(\" !pip uninstall -y openimpala\")\n print(\" !pip install openimpala-cuda\")\n print(\" Then Runtime → Restart session and re-run from the top.\")\n print(\"=\" * 70)\nelif is_gpu_build:\n print(f\"\\n{backend.upper()} build active on {gpu_name or 'accelerator'}.\")\nelse:\n print(\"\\nCPU-only run (no accelerator detected).\")"
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": "## 2. Synthetic datasets\n\nPoreSpy is used to generate five synthetic porous structures at 16³, 32³, 64³, 96³, and 128³. Sizes are kept small enough that a full profiling run completes in minutes rather than hours, and large enough that the cubic scaling of voxel count is visible in the timings.\n\nThe 16³ dataset is small enough that its solve time is dominated by per-call setup rather than compute — useful for extracting the fixed overhead in §4."
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "import porespy as ps\n",
- "\n",
- "def make_micro(size, porosity=0.5, seed=42):\n",
- " np.random.seed(seed)\n",
- " im = ps.generators.blobs(shape=[size] * 3, porosity=porosity, blobiness=1.5)\n",
- " return im.astype(np.int32)\n",
- "\n",
- "sizes = [16, 32, 64, 96, 128]\n",
- "datasets = {n: make_micro(n) for n in sizes}\n",
- "data_medium = datasets[64] # default workhorse for most diagnostics\n",
- "\n",
- "for n, d in datasets.items():\n",
- " print(f\" {n:>4d}^3 porosity={np.mean(d == 0):.3f} bytes={d.nbytes/1e6:.2f} MB\")\n"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "## 3. Solver bake-off on porous media\n",
- "\n",
- "This is the headline diagnostic. All available HYPRE Krylov methods, all HYPRE multigrid preconditioners, and the matrix-free AMReX MLMG are run on the *same* porespy structure at 64³. Wall time and iteration count are reported side-by-side; solvers that fail (multigrid stalls on masked rows, etc.) are flagged in red.\n",
- "\n",
- "**The default solver (`solver=\"auto\"`, since v4.2.20) is MLMG** — it scales near-linearly (see §4) and has the lowest memory footprint of any option. The bake-off below confirms it's also the fastest on this geometry. The runner-up among HYPRE configurations is `flexgmres+pfmg`; `pcg+smg` is the safe fallback if MLMG ever stalls.\n",
- "\n",
- "> **Robustness note.** Standalone structured-multigrid solvers (`smg`, `pfmg` with no Krylov wrapper) can abort at the C++ level on a GPU build — a CUDA out-of-memory or HYPRE kernel error that kills the notebook kernel uncatchably. They are diagnostic-only and stall on masked porous rows in any case, so the cell below skips them on GPU builds (they still run on CPU, where they are stable). Every other combo either converges or fails with a catchable Python exception, shown as a red `FAILED` bar."
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "import sys\n",
- "\n",
- "# Sanity: make sure the porespy datasets cell (§2) has run. The restructure\n",
- "# moved cells around; if you opened the notebook and jumped here directly,\n",
- "# `data_medium` won't exist yet and the whole loop raises NameError before\n",
- "# any print fires — looking exactly like \"no output\".\n",
- "if \"data_medium\" not in dir():\n",
- " raise RuntimeError(\n",
- " \"data_medium not defined — re-run §2 (Synthetic datasets) first.\"\n",
- " )\n",
- "\n",
- "# Compare Krylov and multigrid choices on 64^3.\n",
- "# Each entry is (label, solver, preconditioner). A preconditioner of None means\n",
- "# the solver ignores it (standalone SMG/PFMG/Jacobi, or MLMG). `mlmg` is the\n",
- "# AMReX-native matrix-free path and the library default since v4.3.0.\n",
- "combos = [\n",
- " (\"pcg\", \"pcg\", None),\n",
- " (\"pcg+pfmg\", \"pcg\", \"pfmg\"),\n",
- " (\"pcg+smg\", \"pcg\", \"smg\"),\n",
- " (\"flexgmres+pfmg\", \"flexgmres\", \"pfmg\"),\n",
- " (\"gmres\", \"gmres\", None),\n",
- " (\"gmres+pfmg\", \"gmres\", \"pfmg\"),\n",
- " (\"bicgstab\", \"bicgstab\", None),\n",
- " (\"smg\", \"smg\", None),\n",
- " (\"pfmg\", \"pfmg\", None),\n",
- " (\"mlmg\", \"mlmg\", None),\n",
- "]\n",
- "\n",
- "# --- Skip the uncatchable crashers on GPU ------------------------------------\n",
- "# *Standalone* structured multigrid (smg/pfmg with no Krylov wrapper) drives\n",
- "# many full cyclic-reduction V-cycles to tolerance. On a GPU build that path\n",
- "# can abort at the C++ level — a CUDA out-of-memory or a HYPRE kernel error —\n",
- "# which kills the Python kernel outright, with no traceback and nothing the\n",
- "# `except` below can catch. (As a *preconditioner*, e.g. pcg+smg, SMG is capped\n",
- "# at one V-cycle per iteration and is fine — hence we keep those.)\n",
- "#\n",
- "# These standalone solvers are diagnostic-only and stall on the masked\n",
- "# (inactive) rows of porous media anyway, so we drop them on GPU. On CPU they\n",
- "# are stable and stay in for completeness. Everything else either converges or\n",
- "# raises a catchable Python exception, shown below as a red FAILED bar.\n",
- "if is_gpu_build:\n",
- " _unsafe = {(\"smg\", None), (\"pfmg\", None)}\n",
- " combos = [c for c in combos if (c[1], c[2]) not in _unsafe]\n",
- " print(\"GPU build detected — skipping standalone SMG/PFMG \"\n",
- " \"(they hard-abort on GPU; use them as preconditioners instead).\")\n",
- "\n",
- "print(f\"Running bake-off on {data_medium.shape[0]}³ porespy data... \"\n",
- " f\"({len(combos)} solver/preconditioner combinations)\", flush=True)\n",
- "\n",
- "records = []\n",
- "for label, s, pc in combos:\n",
- " kwargs = dict(phase=0, direction=\"z\", solver=s, max_grid_size=32, verbose=0)\n",
- " if pc is not None:\n",
- " kwargs[\"preconditioner\"] = pc\n",
- "\n",
- " # Flush before each call: a C++-level AMReX::Abort or CUDA OOM kills\n",
- " # the kernel without unwinding Python, so anything we haven't printed\n",
- " # already is lost. Live progress also makes it obvious *which* solver\n",
- " # killed the cell if one of them does.\n",
- " sys.stdout.flush()\n",
- "\n",
- " try:\n",
- " t0 = time.perf_counter()\n",
- " res = oi.tortuosity(data_medium, **kwargs)\n",
- " dt = time.perf_counter() - t0\n",
- " records.append({\"label\": label, \"solver\": s, \"precond\": pc, \"t\": dt,\n",
- " \"iters\": res.iterations, \"tau\": res.tortuosity,\n",
- " \"ok\": res.solver_converged})\n",
- " print(f\" {label:18s} t={dt:6.2f}s iters={res.iterations:4d} \"\n",
- " f\"tau={res.tortuosity:.4f}\", flush=True)\n",
- " except TypeError as e:\n",
- " if \"preconditioner\" in str(e) and pc is not None:\n",
- " print(f\" {label:18s} SKIP — wheel predates preconditioner plumbing\",\n",
- " flush=True)\n",
- " records.append({\"label\": label, \"solver\": s, \"precond\": pc,\n",
- " \"t\": np.nan, \"iters\": np.nan, \"tau\": np.nan, \"ok\": False})\n",
- " continue\n",
- " raise\n",
- " except Exception as e:\n",
- " records.append({\"label\": label, \"solver\": s, \"precond\": pc,\n",
- " \"t\": np.nan, \"iters\": np.nan, \"tau\": np.nan, \"ok\": False})\n",
- " print(f\" {label:18s} FAILED — {e}\", flush=True)\n",
- "\n",
- "df_solvers = pd.DataFrame(records)\n",
- "df_solvers\n"
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": "ok = df_solvers.dropna(subset=[\"t\"])\nif not ok.empty:\n best_row = ok.loc[ok[\"t\"].idxmin()]\n best_label = best_row[\"label\"]\n best_solver = best_row[\"solver\"]\n best_precond = best_row[\"precond\"]\nelse:\n best_label = \"pcg\"\n best_solver = \"pcg\"\n best_precond = None\n\nfig, ax1 = plt.subplots(figsize=(11, max(4, 0.5 * len(df_solvers))))\ncolors = [\"#2ecc71\" if c else \"#e74c3c\" for c in df_solvers[\"ok\"]]\ny = np.arange(len(df_solvers))\n\nax1.barh(y, df_solvers[\"t\"], color=colors, alpha=0.85, edgecolor=\"white\")\nax1.set_yticks(y)\nax1.set_yticklabels(df_solvers[\"label\"])\nax1.set_xlabel(\"Wall time (s)\", color=\"#2c3e50\")\nax1.set_title(f\"Solver comparison — 64³, best by wall time: {best_label}\",\n fontweight=\"bold\")\nax1.invert_yaxis()\n\n# Overlay iteration counts on a twin axis — this is the key diagnostic.\n# A solver with few iterations but expensive each (multigrid) can still\n# win overall; wall time alone hides that.\nax2 = ax1.twiny()\nax2.plot(df_solvers[\"iters\"], y, \"D\", color=\"#8e44ad\", markersize=9,\n markeredgecolor=\"white\", markeredgewidth=1.2, zorder=5)\nax2.set_xlabel(\"Iterations\", color=\"#8e44ad\")\nax2.tick_params(axis=\"x\", colors=\"#8e44ad\")\n\n# Annotate each row with iter count and per-iter cost\nfor i, (_, row) in enumerate(df_solvers.iterrows()):\n if row[\"ok\"] and not np.isnan(row[\"t\"]):\n per_iter = row[\"t\"] / max(row[\"iters\"], 1)\n ax1.text(row[\"t\"] * 1.02, i,\n f\" {int(row['iters'])} iters ({per_iter*1000:.0f} ms/iter)\",\n va=\"center\", fontsize=8, color=\"#2c3e50\")\n\nfrom matplotlib.patches import Patch\nlegend = [\n Patch(facecolor=\"#2ecc71\", label=\"Converged\"),\n Patch(facecolor=\"#e74c3c\", label=\"Failed\"),\n plt.Line2D([0], [0], marker=\"D\", color=\"#8e44ad\", linestyle=\"None\",\n markersize=8, label=\"Iterations\"),\n]\nax1.legend(handles=legend, loc=\"lower right\", framealpha=0.9)\nplt.tight_layout()\nplt.show()\n\n# Flag solvers with few iterations — likely multigrid/preconditioned.\n# If one converged in <10 iterations but is slower per iteration, it may\n# still be the better choice at larger problem sizes.\nlow_iter = ok[ok[\"iters\"] < 10]\nif not low_iter.empty:\n print(\"\\nSolvers converging in <10 iterations (likely multigrid):\")\n for _, r in low_iter.iterrows():\n print(f\" {r['label']:18s} {int(r['iters'])} iters {r['t']:.2f}s\")\n print(\" These scale O(N) and will overtake PCG at larger grids.\")\n\nprint(f\"\\nBest solver at 64³ by wall time: {best_label} \"\n f\"(solver={best_solver}, preconditioner={best_precond})\")\n"
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": "## 4. Scaling validation — does the solver hold O(N) compute?\n\nSweep four solvers across 32³ → 128³ on a uniform geometry and fit `t ~ N^p` log-log per solver. The line we want is near-linear (p ~ 1) — anything appreciably above 1.2 means iteration count is growing with problem size, which kills scalability to HPC-sized images.\n\nFour solvers are compared:\n\n* **`pcg`** — Krylov baseline with no preconditioning. The control.\n* **`pcg+pfmg`** — fastest HYPRE at small N but its semicoarsening stalls on masked rows; included to show why it's not the default.\n* **`flexgmres+pfmg`** — the bake-off's HYPRE winner. flexgmres handles PFMG's non-symmetric preconditioner application correctly.\n* **`mlmg`** — the matrix-free AMReX path, the library default."
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": "scaling_sizes = [32, 64, 96, 128]\nscaling_combos = [\n (\"pcg\", {\"solver\": \"pcg\"}),\n (\"pcg+pfmg\", {\"solver\": \"pcg\", \"preconditioner\": \"pfmg\"}),\n (\"flexgmres+pfmg\", {\"solver\": \"flexgmres\", \"preconditioner\": \"pfmg\"}),\n (\"mlmg\", {\"solver\": \"mlmg\"}),\n]\n\nscaling_records = []\nfor label, kw in scaling_combos:\n for N in scaling_sizes:\n arr = np.zeros((N, N, N), dtype=np.int32) # uniform phase 0 — always percolates\n try:\n t0 = time.perf_counter()\n res = oi.tortuosity(arr, phase=0, direction=\"z\",\n max_grid_size=min(32, N), verbose=0, **kw)\n dt = time.perf_counter() - t0\n scaling_records.append({\"solver\": label, \"N\": N, \"t\": dt,\n \"iters\": int(res.iterations),\n \"ok\": bool(res.solver_converged)})\n print(f\" {label:10s} {N:3d}^3 t={dt:7.3f}s iters={res.iterations:4d}\")\n except TypeError as e:\n # Wheel predates the preconditioner kwarg — skip only those rows.\n msg = str(e)\n if (\"preconditioner\" in msg) and (\"preconditioner\" in kw):\n print(f\" {label:10s} {N:3d}^3 SKIP — wheel predates preconditioner kwarg\")\n scaling_records.append({\"solver\": label, \"N\": N, \"t\": np.nan,\n \"iters\": 0, \"ok\": False})\n continue\n raise\n except Exception as e:\n scaling_records.append({\"solver\": label, \"N\": N, \"t\": np.nan,\n \"iters\": 0, \"ok\": False})\n print(f\" {label:10s} {N:3d}^3 FAILED — {e}\")\n\ndf_scale = pd.DataFrame(scaling_records)\ndf_scale\n"
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": "# Fit t = a · N^p in log-log per solver, then overlay the curves with an\n# O(N) reference line and the O(N^1.76) baseline from §3b.\nfig, ax = plt.subplots(figsize=(9, 5.5))\npalette = {\"pcg\": \"#e74c3c\", \"pcg+pfmg\": \"#2ecc71\",\n \"flexgmres+pfmg\": \"#3498db\", \"mlmg\": \"#8e44ad\"}\nfit_results = {}\nfor label, _ in scaling_combos:\n sub = df_scale[(df_scale[\"solver\"] == label) & df_scale[\"ok\"]].dropna(subset=[\"t\"])\n if len(sub) < 2:\n fit_results[label] = np.nan\n continue\n p, loga = np.polyfit(np.log(sub[\"N\"].astype(float)), np.log(sub[\"t\"].astype(float)), 1)\n fit_results[label] = p\n ax.loglog(sub[\"N\"], sub[\"t\"], \"o-\", color=palette.get(label, \"#333333\"),\n markersize=8, linewidth=2, label=f\"{label} (p={p:.2f})\")\n\n# Reference lines — anchored at the first successful measurement\nanchor = df_scale[df_scale[\"ok\"]].dropna(subset=[\"t\"]).sort_values(\"N\")\nif not anchor.empty:\n N_anchor = float(anchor.iloc[0][\"N\"])\n t_anchor = float(anchor.iloc[0][\"t\"])\n Ns = np.array(scaling_sizes, dtype=float)\n ax.loglog(Ns, t_anchor * (Ns / N_anchor) ** 1.0,\n \"k--\", alpha=0.4, linewidth=1, label=\"O(N) reference\")\n ax.loglog(Ns, t_anchor * (Ns / N_anchor) ** 1.76,\n \"r:\", alpha=0.5, linewidth=1, label=\"O(N^1.76) (§3b baseline)\")\n\nax.set_xlabel(\"Grid size N (domain = N^3)\")\nax.set_ylabel(\"Wall time (s)\")\nax.set_title(\"Scaling validation — multigrid vs. plain Krylov\",\n fontweight=\"bold\")\nax.legend(loc=\"upper left\", framealpha=0.9)\nax.grid(True, which=\"both\", alpha=0.3)\nplt.tight_layout()\nplt.show()\n\n# Verdict against the near-linear target (p < 1.2)\nprint(\"\\nScaling exponents vs. near-linear target (p < 1.2):\")\nfor label, p in fit_results.items():\n if np.isnan(p):\n print(f\" {label:10s} n/a (insufficient data)\")\n elif p < 1.2:\n print(f\" {label:10s} p = {p:.2f} near-linear — target met\")\n else:\n print(f\" {label:10s} p = {p:.2f} super-linear — target NOT met\")"
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": "## 5. `max_grid_size` tuning\n\nAMReX splits the domain into boxes of `max_grid_size` per side, one box per MPI rank (or GPU stream). Too small and the per-box overhead dominates; too large and load balancing suffers. The sweet spot is geometry- and hardware-dependent; this sweep finds it for the current platform."
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": "from openimpala import ConvergenceError\n\ngrid_sizes = [8, 16, 32, 64]\ngrid_rows = []\n# Re-use the winner from §9 (best_solver / best_precond). On the porespy blob\n# the winner is typically flexgmres+pfmg on GPU; on CPU PCG+SMG.\nfor gs in grid_sizes:\n kwargs = dict(phase=0, direction=\"z\", solver=best_solver,\n max_grid_size=gs, verbose=0)\n if best_precond is not None:\n kwargs[\"preconditioner\"] = best_precond\n t0 = time.perf_counter()\n try:\n res = oi.tortuosity(data_medium, **kwargs)\n dt = time.perf_counter() - t0\n tau = res.tortuosity\n grid_rows.append({\"max_grid_size\": gs, \"t\": dt, \"tau\": tau, \"ok\": True})\n print(f\" max_grid_size={gs:3d} t={dt:.2f}s tau={tau:.4f}\")\n except ConvergenceError as e:\n dt = time.perf_counter() - t0\n grid_rows.append({\"max_grid_size\": gs, \"t\": np.nan, \"tau\": np.nan, \"ok\": False})\n print(f\" max_grid_size={gs:3d} FAILED ({e})\")\n\ndf_grid = pd.DataFrame(grid_rows)\ndf_grid_ok = df_grid.dropna(subset=[\"t\"])\nif df_grid_ok.empty:\n best_gs = 32\n print(\"No successful grid sweeps — falling back to max_grid_size=32.\")\nelse:\n best_gs = int(df_grid_ok.loc[df_grid_ok[\"t\"].idxmin(), \"max_grid_size\"])\n\nfig, ax = plt.subplots(figsize=(7, 3.5))\nax.plot(df_grid_ok[\"max_grid_size\"], df_grid_ok[\"t\"], \"o-\", linewidth=2, markersize=9)\nax.set_xlabel(\"max_grid_size\")\nax.set_ylabel(\"Wall time (s)\")\nax.set_title(f\"Grid sweep — 64³, solver={best_label}\", fontweight=\"bold\")\nplt.tight_layout()\nplt.show()\nprint(f\"Optimal max_grid_size: {best_gs}\")"
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": "## 6. NVIDIA Nsight Systems — GPU kernel timeline (optional)\n\nIf a GPU is available *and* `nsys` is installed, this section captures a kernel-level timeline: launches, memory transfers, idle gaps. Signatures of binding overhead leaking onto the GPU path are many tiny launches with gaps between them, or H2D transfers of the same data on every solve. On Colab `nsys` is not pre-installed; the cell below attempts an `apt-get` install and skips cleanly if that fails."
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": "import shutil\n\n# Try to find nsys. On Colab it isn't pre-installed but can be apt-get'd\n# in a few seconds. Pull it now if missing so §8 doesn't silently skip.\nif shutil.which(\"nsys\") is None and bool(gpu_name):\n print(\"nsys not on PATH — apt-get installing nsight-systems...\")\n !apt-get install -y nsight-systems-cli > /dev/null 2>&1 || \\\n apt-get install -y nsight-systems > /dev/null 2>&1\n if shutil.which(\"nsys\") is None:\n # Fall back to whichever nsys ships under /opt/nvidia or similar\n import glob\n for p in glob.glob(\"/opt/nvidia/nsight-systems*/bin/nsys\") + \\\n glob.glob(\"/usr/local/cuda*/bin/nsys\"):\n import os\n os.environ[\"PATH\"] = os.path.dirname(p) + \":\" + os.environ[\"PATH\"]\n break\n\nnsys_available = shutil.which(\"nsys\") is not None and bool(gpu_name)\n\nif not nsys_available:\n if not gpu_name:\n print(\"No GPU — skipping Nsight. (Runtime > Change runtime type > T4 GPU)\")\n else:\n print(\"nsys still not available after install attempt. \"\n \"Try: !apt-get install -y nsight-systems-cli\")\nelse:\n print(f\"nsys: {shutil.which('nsys')} GPU: {gpu_name}\")\n script = '''\nimport openimpala as oi, numpy as np, porespy as ps\nnp.random.seed(42)\ndata = ps.generators.blobs(shape=[64]*3, porosity=0.5, blobiness=1.5).astype(np.int32)\nwith oi.Session():\n r = oi.tortuosity(data, phase=0, direction=\"z\", solver=\"pcg\",\n max_grid_size=32, verbose=0)\n print(f\"tau={r.tortuosity:.4f} converged={r.solver_converged}\")\n'''\n with open(\"/tmp/oi_profile.py\", \"w\") as f:\n f.write(script)\n !nsys profile --output=/tmp/oi_profile --force-overwrite=true \\\n --trace=cuda,nvtx,osrt --cuda-memory-usage=true --stats=true \\\n python3 /tmp/oi_profile.py 2>&1 | tail -60\n print(\"\\nReport saved to /tmp/oi_profile.nsys-rep (download for Nsight GUI).\")"
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "if nsys_available:\n",
- " stats = subprocess.run(\n",
- " [\"nsys\", \"stats\", \"--report\", \"cuda_gpu_kern_sum\",\n",
- " \"--format\", \"csv\", \"/tmp/oi_profile.nsys-rep\"],\n",
- " capture_output=True, text=True, timeout=60,\n",
- " )\n",
- " if stats.returncode == 0 and stats.stdout.strip():\n",
- " lines = stats.stdout.strip().split(\"\\n\")\n",
- " hdr = next((i for i, l in enumerate(lines) if \"Time\" in l and \"Name\" in l), None)\n",
- " if hdr is not None:\n",
- " df_k = pd.read_csv(io.StringIO(\"\\n\".join(lines[hdr:])))\n",
- " if \"Total Time (ns)\" in df_k.columns:\n",
- " df_k[\"Total Time (ms)\"] = df_k[\"Total Time (ns)\"] / 1e6\n",
- " df_k = df_k.sort_values(\"Total Time (ns)\", ascending=False).head(10)\n",
- " print(\"Top CUDA kernels by total GPU time:\")\n",
- " print(df_k[[\"Name\", \"Total Time (ms)\", \"Instances\"]].to_string(index=False))\n",
- " else:\n",
- " print(df_k.head().to_string(index=False))\n",
- " else:\n",
- " print(stats.stdout[:2000])\n",
- " else:\n",
- " print(\"nsys stats produced no kernel data.\")\n"
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "if nsys_available:\n",
- " mem = subprocess.run(\n",
- " [\"nsys\", \"stats\", \"--report\", \"cuda_gpu_mem_size_sum\",\n",
- " \"--format\", \"csv\", \"/tmp/oi_profile.nsys-rep\"],\n",
- " capture_output=True, text=True, timeout=60,\n",
- " )\n",
- " if mem.returncode == 0 and mem.stdout.strip():\n",
- " lines = mem.stdout.strip().split(\"\\n\")\n",
- " hdr = next((i for i, l in enumerate(lines)\n",
- " if \"Operation\" in l or \"Total\" in l), None)\n",
- " if hdr is not None:\n",
- " df_mem = pd.read_csv(io.StringIO(\"\\n\".join(lines[hdr:])))\n",
- " print(\"CUDA memory transfer summary (H2D/D2H):\")\n",
- " print(df_mem.to_string(index=False))\n",
- " print(\"\\nRed flags:\")\n",
- " print(\" • Frequent H2D transfers of similar size → numpy→VoxelImage\")\n",
- " print(\" copy leaking out of bindings into the hot path\")\n",
- " print(\" • Large D2H transfer per call → result readback overhead\")\n",
- " else:\n",
- " print(mem.stdout[:1500])\n",
- " else:\n",
- " print(\"nsys mem report produced no data.\")\n"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": "## 7. Appendix — binding overhead diagnostics\n\nThe cells in this section were the original motivation for the notebook: *\"is the pybind11 layer slow?\"*. Three independent measurements all answer **no**:\n\n* §7a — stage-by-stage timing of a single solve: `solver.value()` accounts for >99% of wall time at 64³, every other stage is <1%.\n* §7b — amortising the VoxelImage across repeated solves: the speedup is ~1.02×, i.e. nothing to amortise.\n* §7c — `cProfile` of the Python call: the binding helpers (parsing, dispatch) cost <3 ms out of ~26 s.\n\nKeep this in mind for future suspicion that the Python facade is wasteful — it isn't. The bottleneck is the linear solve, which §3 and §4 show MLMG handles optimally."
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": "### 7a. Stage breakdown\n\n`oi.tortuosity(numpy_array, ...)` is not a single operation. From\n`facade.py` it is roughly:\n\n```\nnumpy → VoxelImage.from_numpy (copy + AMReX BoxArray/Geometry/iMultiFab build)\nPercolationCheck(img, ...) (flood fill — runs every call!)\nVolumeFraction(img, ...) (cheap count)\nTortuosityHypre(img, ..., solver) (HYPRE grid/stencil/matrix assembly)\nsolver.value() (actual linear solve + flux integration)\n```\n\nWe time each stage independently. Whichever bar dominates *is* the\nbottleneck. If `from_numpy` or `TortuosityHypre(...)` construction dominates,\nyour slowdown is in binding/setup — not the solver.\n\n**Note on solver choice for this section**: we time PCG+SMG below because\nit's the most direct apples-to-apples comparison with a CPU solver and\nits iteration count is informative. On GPU hardware **MLMG is usually\n2–5× faster** for this problem class (matrix-free, no assembly cost,\nfully GPU-native kernels). §9 runs the full bake-off including MLMG so\nyou can see the numbers side-by-side."
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": "from openimpala import _core as _core\nfrom openimpala.facade import _parse_direction, _parse_solver\n\ndef time_stages(data, solver=\"pcg\", direction=\"z\", max_grid_size=32, maxiter=1000):\n \"\"\"Decompose a single tortuosity call into timed binding stages.\n\n Returns a dict of stage timings plus metadata. If the solver fails to\n converge or produces an invalid result (e.g. boundary flux conservation\n check tripped at large N), the dict still contains every successful stage\n timing and sets _tau / _iters to NaN — callers can then plot or skip the\n failed point without crashing.\n \"\"\"\n d = _parse_direction(direction)\n st = _parse_solver(solver)\n out = {}\n\n t0 = time.perf_counter()\n arr = np.ascontiguousarray(data, dtype=np.int32)\n out[\"np.ascontiguousarray copy\"] = time.perf_counter() - t0\n\n t0 = time.perf_counter()\n img = _core.VoxelImage.from_numpy(arr, max_grid_size)\n out[\"VoxelImage.from_numpy (AMReX grid + voxel write)\"] = time.perf_counter() - t0\n\n t0 = time.perf_counter()\n pc = _core.PercolationCheck(img, 0, d, 0)\n out[\"PercolationCheck (flood fill)\"] = time.perf_counter() - t0\n\n t0 = time.perf_counter()\n vf_val = _core.VolumeFraction(img, 0, 0).value_vf()\n out[\"VolumeFraction\"] = time.perf_counter() - t0\n\n t0 = time.perf_counter()\n solver_obj = _core.TortuosityHypre(img, vf_val, 0, d, st, \".\", 0.0, 1.0, 0, False)\n out[\"TortuosityHypre ctor (HYPRE setup + matrix assembly)\"] = time.perf_counter() - t0\n\n t0 = time.perf_counter()\n try:\n tau = solver_obj.value()\n out[\"solver.value() (solve + flux)\"] = time.perf_counter() - t0\n out[\"_tau\"] = tau\n out[\"_iters\"] = solver_obj.iterations\n except RuntimeError as e:\n out[\"solver.value() (solve + flux)\"] = time.perf_counter() - t0\n out[\"_tau\"] = float(\"nan\")\n out[\"_iters\"] = solver_obj.iterations\n out[\"_error\"] = str(e)\n\n out[\"_total\"] = sum(v for k, v in out.items() if not k.startswith(\"_\"))\n return out\n\n# Warm-up — first call pays lazy-init inside AMReX/HYPRE\n_ = time_stages(datasets[32])\n\nstages = time_stages(data_medium, solver=\"pcg\")\nif np.isnan(stages[\"_tau\"]):\n print(f\"⚠ solve did not produce a valid tau ({stages.get('_error', 'unknown')}); \"\n f\"stage timings still shown.\\n\")\nelse:\n print(f\"tau = {stages['_tau']:.4f} iters = {stages['_iters']} total = {stages['_total']:.3f}s\\n\")\nfor k, v in stages.items():\n if k.startswith(\"_\"):\n continue\n print(f\" {k:55s} {v:7.3f}s ({100*v/stages['_total']:5.1f}%)\")"
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "stage_names = [k for k in stages if not k.startswith(\"_\")]\n",
- "stage_times = [stages[k] for k in stage_names]\n",
- "\n",
- "fig, ax = plt.subplots(figsize=(11, 4))\n",
- "y = np.arange(len(stage_names))\n",
- "colors = [\"#9b59b6\", \"#8e44ad\", \"#2ecc71\", \"#95a5a6\", \"#f39c12\", \"#e74c3c\"]\n",
- "ax.barh(y, stage_times, color=colors[:len(stage_names)], alpha=0.85, edgecolor=\"white\")\n",
- "for i, t in enumerate(stage_times):\n",
- " ax.text(t + max(stage_times) * 0.01, i,\n",
- " f\"{t:.3f}s ({100*t/stages['_total']:.1f}%)\", va=\"center\", fontsize=9)\n",
- "ax.set_yticks(y)\n",
- "ax.set_yticklabels(stage_names, fontsize=9)\n",
- "ax.set_xlabel(\"Wall time (s)\")\n",
- "ax.set_title(\"Single oi.tortuosity(64³) call — stage breakdown\", fontweight=\"bold\")\n",
- "ax.invert_yaxis()\n",
- "plt.tight_layout()\n",
- "plt.show()\n",
- "\n",
- "slowest = max(stage_names, key=lambda k: stages[k])\n",
- "print(f\"\\nBottleneck at 64³: {slowest} ({100*stages[slowest]/stages['_total']:.1f}%)\")\n"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "### 7b. Per-stage scaling\n\nRun the same decomposition at 32³ and 128³ and plot the ratio per stage.\nA stage with ratio ≈ `(128/32)³ = 64×` is doing O(N) work — legitimate\ncompute. A stage with ratio ≈ 1× is constant overhead — every call pays\nthe same price regardless of problem size, which is the *classic* signature\nof binding / setup cost.\n"
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": "stages_small = time_stages(datasets[32])\nstages_big = time_stages(datasets[128])\n\nif np.isnan(stages_big.get(\"_tau\", 1.0)):\n print(f\"Note: 128³ solve did not return a valid tau \"\n f\"({stages_big.get('_error', 'unknown')}); stage timings still usable \"\n f\"for the scaling-ratio analysis below.\\n\")\n\n# Ideal O(N) ratio when scaling voxel count by (128/32)^3\nN_ratio = (128 / 32) ** 3\nprint(f\"Ideal O(N) work ratio for 32->128: {N_ratio:.0f}×\")\nprint(f\"{'stage':<55s} {'32³ (s)':>10s} {'128³ (s)':>10s} {'ratio':>8s} behaviour\")\nprint(\"-\" * 110)\n\nrows = []\nfor k in stage_names:\n ts, tb = stages_small[k], stages_big[k]\n r = tb / max(ts, 1e-9)\n if r > 0.5 * N_ratio:\n label = \"scales O(N) ✓\"\n elif r < 2.0:\n label = \"~constant (overhead)\"\n else:\n label = \"sub-linear\"\n rows.append({\"stage\": k, \"t_32\": ts, \"t_128\": tb, \"ratio\": r, \"label\": label})\n print(f\"{k:<55s} {ts:>10.3f} {tb:>10.3f} {r:>8.1f}× {label}\")\n\ndf_scale = pd.DataFrame(rows)"
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "fig, ax = plt.subplots(figsize=(11, 4))\n",
- "y = np.arange(len(stage_names))\n",
- "w = 0.4\n",
- "ax.barh(y - w/2, df_scale[\"t_32\"], w, color=\"#3498db\", alpha=0.85, label=\"32³\")\n",
- "ax.barh(y + w/2, df_scale[\"t_128\"], w, color=\"#e74c3c\", alpha=0.85, label=\"128³\")\n",
- "for i, r in enumerate(df_scale[\"ratio\"]):\n",
- " ax.text(df_scale[\"t_128\"].iloc[i] * 1.02, i + w/2, f\"{r:.0f}×\",\n",
- " va=\"center\", fontsize=8, color=\"#2c3e50\")\n",
- "ax.set_yticks(y)\n",
- "ax.set_yticklabels(stage_names, fontsize=9)\n",
- "ax.set_xlabel(\"Wall time (s)\")\n",
- "ax.set_title(f\"Per-stage scaling (ideal O(N) ratio = {N_ratio:.0f}×)\", fontweight=\"bold\")\n",
- "ax.axvline(0, color=\"#bdc3c7\", linewidth=0.5)\n",
- "ax.invert_yaxis()\n",
- "ax.legend(loc=\"lower right\")\n",
- "plt.tight_layout()\n",
- "plt.show()\n",
- "\n",
- "constant_stages = df_scale[df_scale[\"ratio\"] < 2.0]\n",
- "if not constant_stages.empty:\n",
- " print(\"\\n⚠ Stages that DON'T scale with problem size (pure overhead):\")\n",
- " for _, r in constant_stages.iterrows():\n",
- " print(f\" {r['stage']:55s} ratio={r['ratio']:.1f}×\")\n",
- " print(\" Every oi.tortuosity() call pays these, regardless of image size.\")\n"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": "### 7c. Amortisation test — reusing the VoxelImage\n\nIf most per-call time goes into rebuilding AMReX state, then running the solver multiple times against the *same* `VoxelImage` should be markedly cheaper than the equivalent number of calls through the high-level facade. This cell measures the gap.\n\nTwo paths are compared on `data_medium`, five calls each:\n\n* **Naive**: five calls to `oi.tortuosity(numpy_array, ...)`. Every call rebuilds the geometry, BoxArray, distribution mapping, iMultiFab, percolation mask, and HYPRE matrix from the bare NumPy input.\n* **Amortized**: one call to `_numpy_to_voxelimage` to build the `VoxelImage` once, then five direct calls to `_core.TortuosityHypre` reusing it.\n\nThe difference is the per-call setup tax. Sweeping (e.g. directional tortuosity, parameter studies) should always use the amortized pattern."
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "from openimpala.facade import _numpy_to_voxelimage, _parse_direction, _parse_solver\n",
- "\n",
- "def naive_repeat(data, n=5, solver=\"pcg\"):\n",
- " \"\"\"Top-level facade — rebuilds everything every call.\"\"\"\n",
- " ts = []\n",
- " for _ in range(n):\n",
- " t0 = time.perf_counter()\n",
- " oi.tortuosity(data, phase=0, direction=\"z\", solver=solver,\n",
- " max_grid_size=32, verbose=0)\n",
- " ts.append(time.perf_counter() - t0)\n",
- " return ts\n",
- "\n",
- "def amortized_repeat(data, n=5, solver=\"pcg\"):\n",
- " \"\"\"Build VoxelImage once, reuse across solves.\"\"\"\n",
- " d = _parse_direction(\"z\")\n",
- " st = _parse_solver(solver)\n",
- " img = _numpy_to_voxelimage(data, 32)\n",
- " vf = _core.VolumeFraction(img, 0, 0).value_vf()\n",
- "\n",
- " ts = []\n",
- " for _ in range(n):\n",
- " t0 = time.perf_counter()\n",
- " s = _core.TortuosityHypre(img, vf, 0, d, st, \".\", 0.0, 1.0, 0, False)\n",
- " s.value()\n",
- " ts.append(time.perf_counter() - t0)\n",
- " return ts\n",
- "\n",
- "n_repeat = 5\n",
- "naive = naive_repeat(data_medium, n_repeat)\n",
- "amort = amortized_repeat(data_medium, n_repeat)\n",
- "\n",
- "print(f\"Naive oi.tortuosity(numpy) × {n_repeat}: \" + \", \".join(f\"{t:.2f}s\" for t in naive))\n",
- "print(f\"Amortized (reuse VoxelImage): \" + \", \".join(f\"{t:.2f}s\" for t in amort))\n",
- "print(f\"\\nNaive total: {sum(naive):.2f}s (mean {np.mean(naive):.2f}s/call)\")\n",
- "print(f\"Amortized total: {sum(amort):.2f}s (mean {np.mean(amort):.2f}s/call)\")\n",
- "print(f\"Speedup from reuse: {sum(naive)/max(sum(amort), 1e-9):.2f}×\")\n"
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "fig, ax = plt.subplots(figsize=(9, 4))\n",
- "x = np.arange(1, n_repeat + 1)\n",
- "ax.plot(x, naive, \"o-\", color=\"#e74c3c\", linewidth=2, markersize=9,\n",
- " label=\"Naive: oi.tortuosity(numpy, ...)\")\n",
- "ax.plot(x, amort, \"o-\", color=\"#2ecc71\", linewidth=2, markersize=9,\n",
- " label=\"Amortized: reuse VoxelImage + TortuosityHypre\")\n",
- "ax.set_xlabel(\"Call #\")\n",
- "ax.set_ylabel(\"Wall time (s)\")\n",
- "ax.set_title(\"Per-call cost: rebuild-everything vs reuse\", fontweight=\"bold\")\n",
- "ax.legend()\n",
- "plt.tight_layout()\n",
- "plt.show()\n",
- "\n",
- "gap = np.mean(naive) - np.mean(amort)\n",
- "print(f\"Average per-call rebuild tax: {gap:.2f}s \"\n",
- " f\"({100*gap/np.mean(naive):.0f}% of a naive call)\")\n"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": "### 7d. cProfile — Python-level hot frames\n\ncProfile captures cumulative time per Python frame, including time spent inside pybind11 wrappers around C++ calls. This is a different view from §3 — instead of timing named stages, it counts every function call and surfaces unexpected frame costs.\n\nThings to look for in the top 20 frames:\n\n* `_numpy_to_voxelimage`, `VoxelImage.from_numpy` — data ingestion\n* `PercolationCheck.__init__` — flood-fill setup\n* `TortuosityHypre.__init__` — HYPRE matrix assembly\n* `TortuosityHypre.value` — the linear solve\n\nIf pure-Python helpers like `_parse_direction` or `_parse_solver` show up high, the binding is doing too much Python-side dispatch."
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "pr = cProfile.Profile()\n",
- "pr.enable()\n",
- "oi.tortuosity(data_medium, phase=0, direction=\"z\", solver=\"pcg\",\n",
- " max_grid_size=32, verbose=0)\n",
- "pr.disable()\n",
- "\n",
- "stream = io.StringIO()\n",
- "ps_stats = pstats.Stats(pr, stream=stream).sort_stats(\"cumulative\")\n",
- "ps_stats.print_stats(20)\n",
- "print(stream.getvalue())\n"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "## 8. Summary & HPC recommendations\n"
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": "# Headline numbers from the diagnostics above.\n# The fixed-overhead extraction (§4 in pre-v4.3 layouts) was dropped from\n# the notebook because three independent measurements (§7a/b/c) all show\n# binding overhead is below 1% — there is nothing to extract. So this\n# summary now reads only from the appendix stage diagnostic and the\n# bake-off / scaling sections.\nstage_total = stages[\"_total\"]\nstage_top = max((k for k in stages if not k.startswith(\"_\")), key=lambda k: stages[k])\nnaive_mean = float(np.mean(naive))\namort_mean = float(np.mean(amort))\n\n# Scaling exponent: use the bake-off scaling fit if available, else fall\n# back to the per-stage 32->128 ratio computed in §7b.\nmlmg_p = fit_results.get(\"mlmg\", float(\"nan\"))\npcg_p = fit_results.get(\"pcg\", float(\"nan\"))\nfastest_solver = best_solver\nsolve_ratio = df_scale.iloc[-1][\"ratio\"] if \"ratio\" in df_scale.columns else float(\"nan\")\n\nprint(\"=\" * 64)\nprint(\" DIAGNOSIS\")\nprint(\"=\" * 64)\nprint(f\" Build backend: {backend.upper()}\"\n + (f\" (host GPU: {gpu_name})\" if gpu_name else \"\"))\nprint(f\" Single-call bottleneck: {stage_top}\")\nprint(f\" ({100*stages[stage_top]/stage_total:.1f}% of {stage_total:.2f}s)\")\nif not np.isnan(mlmg_p):\n print(f\" MLMG scaling exponent: O(N^{mlmg_p:.2f})\"\n + (\" (super-linear)\" if mlmg_p > 1.2 else \" (near-linear ✓)\"))\nif not np.isnan(pcg_p):\n print(f\" PCG scaling exponent: O(N^{pcg_p:.2f})\"\n + (\" (super-linear)\" if pcg_p > 1.2 else \"\"))\nprint(f\" Per-call rebuild tax: {naive_mean - amort_mean:.2f}s \"\n f\"({100*(naive_mean-amort_mean)/max(naive_mean,1e-9):.0f}% of naive call)\")\nprint(f\" Fastest solver on this run: {fastest_solver}\")\nprint(f\" Best max_grid_size: {best_gs}\")\nprint(\"=\" * 64)\n\n# Headline recommendation — the single most impactful change for this run\nprint(\"\\n TOP RECOMMENDATION\")\nprint(\" \" + \"-\" * 62)\nif gpu_name and not is_gpu_build:\n print(f\" A {gpu_name} is available but the installed wheel is CPU-only.\")\n print(\" Switch to openimpala-cuda for an expected 10–50× speedup on\")\n print(\" single-phase 3D diffusion at 128³+. Everything below is\")\n print(\" secondary until this is resolved.\")\nelif not np.isnan(mlmg_p) and mlmg_p < 1.2:\n print(f\" MLMG scales near-linearly (p={mlmg_p:.2f}) and is the library\")\n print( \" default since v4.3.0. Use solver='auto' (or 'mlmg' explicitly).\")\n print( \" HYPRE Krylov methods are available for diagnostic comparison\")\n print( \" but scale super-linearly with iteration count on porous media.\")\nelif not np.isnan(pcg_p) and pcg_p > 1.2:\n print(f\" Compute scales as O(N^{pcg_p:.2f}). Plain Krylov iterations grow\")\n print(\" with problem size — switch to a multigrid preconditioner\")\n print(\" (PFMG/SMG via HYPRE, or AMReX MLMG) to restore O(N).\")\nelse:\n print(f\" Solver dominates wall time. Best configuration on this run:\")\n print(f\" solver={fastest_solver}, max_grid_size={best_gs}.\")\n print(\" Further speedup needs algorithmic changes or larger hardware.\")\n\n# Amortization recommendation — only fires when the rebuild tax is meaningful\nif naive_mean > 2 * amort_mean:\n print()\n print(\" Per-call setup is a significant fraction of wall time. For sweeps,\")\n print(\" build the VoxelImage once and reuse it:\")\n print()\n print(\" from openimpala.facade import _numpy_to_voxelimage\")\n print(\" from openimpala import _core\")\n print(\" img = _numpy_to_voxelimage(arr, max_grid_size)\")\n print(\" s = _core.TortuosityHypre(img, vf, 0, d, st, '.', 0, 1, 0, False)\")\n print(\" s.value()\")\n print()\n print(\" …rather than calling oi.tortuosity(numpy_array, ...) per iteration.\")"
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "inputs_template = f\"\"\"# Recommended OpenImpala inputs (generated by profiling notebook)\n",
- "filename = your_image.tif\n",
- "phase_id = 0\n",
- "direction = ALL\n",
- "solver_type = {best_solver}\n",
- "box_size = {best_gs}\n",
- "calculation_method = flow_through\n",
- "hypre.maxiter = 1000\n",
- "hypre.eps = 1e-9\n",
- "physics.type = diffusion\n",
- "verbose = 1\n",
- "\"\"\"\n",
- "print(inputs_template)\n"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "## Cleanup\n"
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "try:\n",
- " from openimpala._core import amrex_initialized\n",
- " if amrex_initialized():\n",
- " session.__exit__(None, None, None)\n",
- " print(\"Session closed.\")\n",
- " else:\n",
- " print(\"Session already finalized.\")\n",
- "except Exception:\n",
- " print(\"Cleanup done.\")\n"
- ]
- }
- ]
-}
diff --git a/notebooks/visualization_yt.ipynb b/notebooks/visualization_yt.ipynb
deleted file mode 100644
index bbfb89c9..00000000
--- a/notebooks/visualization_yt.ipynb
+++ /dev/null
@@ -1,399 +0,0 @@
-{
- "cells": [
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "[]",
- "(https://colab.research.google.com/github/BASE-Laboratory/OpenImpala/blob/master/notebooks/visualization_yt.ipynb)\n",
- "\n",
- "# Visualizing OpenImpala Results with yt\n",
- "\n",
- "OpenImpala uses the [AMReX](https://amrex-codes.github.io/amrex/) backend, which means its output plotfiles are natively supported by [yt](https://yt-project.org/) — a Python package designed for out-of-core analysis of large volumetric datasets.\n",
- "\n",
- "This notebook demonstrates how to load and visualize OpenImpala results directly in Jupyter, without loading the entire dataset into RAM. This is critical for multi-billion voxel domains that would otherwise trigger Out-of-Memory errors.\n",
- "\n",
- "**What you will learn:**\n",
- "1. Run an OpenImpala solve with plotfile output enabled.\n",
- "2. Load an AMReX plotfile with `yt.load()`.\n",
- "3. Create 2D slice plots of the solution field.\n",
- "4. Create 1D profile plots (e.g., average potential along an axis).\n",
- "5. Extract numerical data for custom analysis.\n",
- "\n",
- "**Prerequisites:** None — this notebook generates its own data."
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "## 0. Install Dependencies"
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": "import subprocess, sys\n\ndef _has_gpu():\n try:\n subprocess.check_output([\"nvidia-smi\"], stderr=subprocess.DEVNULL)\n return True\n except (FileNotFoundError, subprocess.CalledProcessError):\n return False\n\n_extras = \"yt matplotlib porespy\"\nif _has_gpu():\n print(\"GPU detected — installing openimpala-cuda\")\n !pip install -q openimpala-cuda {_extras}\nelse:\n print(\"No GPU detected — installing openimpala (CPU)\")\n !pip install -q openimpala {_extras}"
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "## 1. Generate a Plotfile with OpenImpala\n",
- "\n",
- "We create a synthetic porous microstructure using PoreSpy, then run the\n",
- "TortuosityHypre solver with `write_plotfile=True` to produce an AMReX\n",
- "plotfile on disk."
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "import os\n",
- "import numpy as np\n",
- "import porespy as ps\n",
- "import openimpala as oi\n",
- "from openimpala import core as oic\n",
- "\n",
- "print(f\"OpenImpala version {oi.__version__}\")\n",
- "\n",
- "session = oi.Session()\n",
- "session.__enter__()\n",
- "\n",
- "# Generate a 100³ synthetic microstructure\n",
- "np.random.seed(42)\n",
- "micro = ps.generators.blobs(\n",
- " shape=[100, 100, 100], porosity=0.50, blobiness=1.5,\n",
- ").astype(np.int32)\n",
- "\n",
- "print(f\"Microstructure: {micro.shape}, porosity={micro.mean():.3f}\")\n",
- "\n",
- "# Compute volume fraction for the solver constructor\n",
- "vf = oi.volume_fraction(micro, phase=1)\n",
- "\n",
- "# Wrap the array and run the solver with plotfile output\n",
- "out_dir = \"./plotfiles\"\n",
- "os.makedirs(out_dir, exist_ok=True)\n",
- "\n",
- "img = oi.VoxelImage.from_numpy(micro.copy(), max_grid_size=64)\n",
- "solver = oic.TortuosityHypre(\n",
- " img,\n",
- " vf.fraction, # volume fraction\n",
- " 1, # phase ID\n",
- " oic.Direction.Z, # solve direction\n",
- " oic.SolverType.FlexGMRES, # HYPRE solver\n",
- " out_dir, # results directory\n",
- " 0.0, 1.0, # Dirichlet BCs (V_lo, V_hi)\n",
- " 1, # verbose\n",
- " True # write_plotfile\n",
- ")\n",
- "\n",
- "tau = solver.value()\n",
- "print(f\"Tortuosity (Z): {tau:.4f}\")\n",
- "print(f\"Converged: {solver.solver_converged}, Iterations: {solver.iterations}\")"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "## 2. Load the Plotfile with yt\n",
- "\n",
- "yt auto-detects AMReX plotfile format. The solver wrote its output to\n",
- "`plotfiles/tortuosity_solution_2` (direction Z = axis index 2)."
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "import yt\n",
- "import glob\n",
- "\n",
- "# Suppress verbose yt logging\n",
- "yt.funcs.mylog.setLevel(40)\n",
- "\n",
- "# Find the plotfile directory written by the solver\n",
- "PLOTFILE = \"./plotfiles/tortuosity_solution_2\"\n",
- "if not os.path.isdir(PLOTFILE):\n",
- " plotfile_dirs = sorted(d for d in glob.glob(\"./plotfiles/*\") if os.path.isdir(d))\n",
- " PLOTFILE = plotfile_dirs[-1]\n",
- "\n",
- "ds = yt.load(PLOTFILE)\n",
- "\n",
- "print(f\"Plotfile: {PLOTFILE}\")\n",
- "print(f\"Domain dimensions: {ds.domain_dimensions}\")\n",
- "print(f\"Domain left edge: {ds.domain_left_edge}\")\n",
- "print(f\"Domain right edge: {ds.domain_right_edge}\")\n",
- "print()\n",
- "print(\"Available fields:\")\n",
- "for field in sorted(ds.field_list):\n",
- " print(f\" {field}\")"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "OpenImpala plotfiles contain three fields:\n",
- "- `('boxlib', 'solution_potential')` — the solved steady-state concentration/potential field\n",
- "- `('boxlib', 'phase_id')` — the segmented phase map (0 = pore, 1 = solid)\n",
- "- `('boxlib', 'active_mask')` — binary mask of voxels included in the solve (connected pore space)"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "## 3. 2D Slice Plots\n",
- "\n",
- "`yt.SlicePlot` generates a 2D cross-section through the 3D domain. This is the most common visualization for transport fields — it shows the concentration gradient across the pore network.\n",
- "\n",
- "**Key advantage:** yt reads data lazily from disk, so this works on datasets far larger than available RAM."
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "# Slice through the centre of the domain, normal to the Y axis\n",
- "field = ('boxlib', 'solution_potential')\n",
- "\n",
- "slc = yt.SlicePlot(ds, \"y\", field)\n",
- "slc.set_cmap(field, \"magma\")\n",
- "slc.set_log(field, False)\n",
- "slc.set_zlim(field, 0.0, 1.0)\n",
- "slc.set_colorbar_label(field, \"Potential $\\\\phi$\")\n",
- "slc.annotate_title(\"Steady-State Diffusion Potential (Y-slice)\")\n",
- "slc.show()"
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "# Phase map — shows pore (0) vs solid (1)\n",
- "phase_field = ('boxlib', 'phase_id')\n",
- "\n",
- "slc_phase = yt.SlicePlot(ds, \"y\", phase_field)\n",
- "slc_phase.set_cmap(phase_field, \"RdBu\")\n",
- "slc_phase.set_log(phase_field, False)\n",
- "slc_phase.set_colorbar_label(phase_field, \"Phase ID\")\n",
- "slc_phase.annotate_title(\"Phase Map\")\n",
- "slc_phase.show()"
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "# Slices at different depths along the flow direction (Z)\n",
- "for z_frac in [0.25, 0.5, 0.75]:\n",
- " center = ds.domain_center.copy()\n",
- " center[2] = ds.domain_left_edge[2] + z_frac * (ds.domain_right_edge[2] - ds.domain_left_edge[2])\n",
- "\n",
- " slc = yt.SlicePlot(ds, \"z\", field, center=center)\n",
- " slc.set_cmap(field, \"magma\")\n",
- " slc.set_log(field, False)\n",
- " slc.set_zlim(field, 0.0, 1.0)\n",
- " slc.annotate_title(f\"Z = {z_frac:.0%} of domain\")\n",
- " slc.show()"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "## 4. 1D Profile Plots\n",
- "\n",
- "`yt.ProfilePlot` computes bin-averaged quantities along a chosen axis. This is ideal for visualizing how the average potential varies along the flow direction — the gradient of this curve is directly related to the effective diffusivity."
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "ad = ds.all_data()\n",
- "\n",
- "profile = yt.ProfilePlot(\n",
- " ad,\n",
- " (\"index\", \"z\"), # bin along Z (the flow direction)\n",
- " (\"boxlib\", \"solution_potential\"), # average this field\n",
- " weight_field=(\"index\", \"ones\"), # simple average\n",
- ")\n",
- "\n",
- "profile.set_ylabel((\"boxlib\", \"solution_potential\"), \"Average Potential $\\\\langle\\\\phi\\\\rangle$\")\n",
- "profile.set_xlabel(\"Position along Z (flow direction)\")\n",
- "profile.annotate_title(\"Through-Thickness Potential Profile\")\n",
- "profile.show()"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "**Interpreting the profile:**\n",
- "- For a uniform medium with Dirichlet BCs ($\\phi=0$ at inlet, $\\phi=1$ at outlet), the profile is a straight line.\n",
- "- For a heterogeneous porous medium, the profile deviates from linearity. Steeper gradients indicate regions of higher resistance (lower local diffusivity).\n",
- "- The overall slope relates to the effective diffusivity: $D_{\\text{eff}} = \\text{flux} / |\\nabla\\phi|$."
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "## 5. Extracting Numerical Data\n",
- "\n",
- "For custom analysis beyond built-in yt plots, extract data into NumPy arrays."
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "import matplotlib.pyplot as plt\n",
- "\n",
- "ad = ds.all_data()\n",
- "prof = yt.create_profile(\n",
- " ad,\n",
- " (\"index\", \"z\"),\n",
- " (\"boxlib\", \"solution_potential\"),\n",
- " n_bins=64,\n",
- " weight_field=(\"index\", \"ones\"),\n",
- ")\n",
- "\n",
- "z = np.array(prof.x)\n",
- "phi_avg = np.array(prof[(\"boxlib\", \"solution_potential\")])\n",
- "\n",
- "fig, ax = plt.subplots(figsize=(8, 4), dpi=120)\n",
- "ax.plot(z, phi_avg, 'o-', color='#1f77b4', ms=4, lw=1.5)\n",
- "ax.set_xlabel(\"Position along flow direction (Z)\", fontweight='bold')\n",
- "ax.set_ylabel(\"$\\\\langle\\\\phi\\\\rangle$\", fontweight='bold', fontsize=14)\n",
- "ax.set_title(\"Through-Thickness Potential Profile\")\n",
- "ax.grid(True, alpha=0.3)\n",
- "ax.spines['top'].set_visible(False)\n",
- "ax.spines['right'].set_visible(False)\n",
- "plt.tight_layout()\n",
- "plt.show()\n",
- "\n",
- "dphi_dz = np.gradient(phi_avg, z)\n",
- "print(f\"Mean gradient dphi/dz = {np.mean(dphi_dz):.6f}\")"
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "# Extract a 2D slice as a NumPy array (fixed resolution buffer)\n",
- "slc = ds.slice(\"y\", ds.domain_center[1])\n",
- "\n",
- "# frb = Fixed Resolution Buffer — rasterizes the AMR data to a uniform grid\n",
- "frb = slc.to_frb(\n",
- " width=ds.domain_width[0],\n",
- " resolution=(512, 512),\n",
- ")\n",
- "\n",
- "phi_2d = np.array(frb[(\"boxlib\", \"solution_potential\")])\n",
- "\n",
- "fig, ax = plt.subplots(figsize=(6, 6), dpi=120)\n",
- "im = ax.imshow(phi_2d, origin='lower', cmap='magma', vmin=0, vmax=1)\n",
- "plt.colorbar(im, ax=ax, label='Potential $\\\\phi$')\n",
- "ax.set_title(\"Solution Field (Y-midplane)\")\n",
- "ax.set_xlabel(\"X\")\n",
- "ax.set_ylabel(\"Z\")\n",
- "plt.tight_layout()\n",
- "plt.show()\n",
- "\n",
- "print(f\"Extracted array shape: {phi_2d.shape}\")\n",
- "print(f\"Value range: [{phi_2d.min():.4f}, {phi_2d.max():.4f}]\")"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "## 6. Working with Large Datasets\n",
- "\n",
- "The key advantage of yt is **lazy loading** — it only reads the data needed for the current operation. This means the techniques above work identically on a $100^3$ test domain and a $2000^3$ synchrotron dataset.\n",
- "\n",
- "### Tips for large datasets\n",
- "\n",
- "| Technique | Memory Usage | When to Use |\n",
- "|-----------|-------------|-------------|\n",
- "| `yt.SlicePlot` | Low — reads one 2D plane | Quick visual inspection |\n",
- "| `yt.ProjectionPlot` | Medium — integrates along an axis | Overview of field structure |\n",
- "| `yt.ProfilePlot` | Low — bin-averages on the fly | Quantitative 1D analysis |\n",
- "| `ds.all_data()` | **High** — reads everything | Only for small datasets or HPC |\n",
- "| `ds.region(...)` | Configurable | Sub-volume analysis |\n",
- "\n",
- "### Selecting sub-regions\n",
- "\n",
- "```python\n",
- "# Analyse only a sub-volume (avoids loading the full dataset)\n",
- "left = ds.domain_left_edge + 0.25 * ds.domain_width\n",
- "right = ds.domain_left_edge + 0.75 * ds.domain_width\n",
- "region = ds.region(center=0.5*(left+right), left_edge=left, right_edge=right)\n",
- "\n",
- "# All yt operations work on regions too\n",
- "profile = yt.ProfilePlot(region, (\"index\", \"z\"), (\"boxlib\", \"solution_potential\"))\n",
- "```\n",
- "\n",
- "### Producing plotfiles from your own data\n",
- "\n",
- "To run OpenImpala on your own data with plotfile output, either use the Python API (as shown above) or set `write_plotfile = 1` in an inputs file:\n",
- "\n",
- "```ini\n",
- "filename = my_sample.tif\n",
- "phase_id = 1\n",
- "direction = Z\n",
- "solver_type = FlexGMRES\n",
- "write_plotfile = 1\n",
- "```"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "## References\n",
- "\n",
- "- [yt documentation](https://yt-project.org/docs/dev/)\n",
- "- [yt AMReX frontend](https://yt-project.org/docs/dev/examining/loading_data.html#amrex-boxlib-data)\n",
- "- [AMReX plotfile format](https://amrex-codes.github.io/amrex/docs_html/Visualization.html)\n",
- "- [OpenImpala tutorials](../tutorials/)"
- ]
- }
- ],
- "metadata": {
- "kernelspec": {
- "display_name": "Python 3",
- "language": "python",
- "name": "python3"
- },
- "language_info": {
- "name": "python",
- "version": "3.10.0"
- }
- },
- "nbformat": 4,
- "nbformat_minor": 4
-}
\ No newline at end of file
diff --git a/python/openimpala/__init__.py b/python/openimpala/__init__.py
index aeff0b64..e29cae1d 100644
--- a/python/openimpala/__init__.py
+++ b/python/openimpala/__init__.py
@@ -71,7 +71,8 @@ def _preload_cuda_libs():
_preload_cuda_libs()
-# Session context manager (pure Python — always available)
+# Session context manager and datasets (pure Python — always available)
+from . import datasets
from .session import Session
# Custom exceptions (pure Python — always available)
@@ -105,6 +106,7 @@ def __getattr__(name):
"volume_fraction",
"percolation_check",
"tortuosity",
+ "tortuosity_all",
"effective_diffusivity",
"specific_surface_area",
"connected_components",
@@ -148,6 +150,7 @@ def __getattr__(name):
__all__ = [
"__version__",
+ "datasets",
"core",
"VoxelImage",
"Direction",
@@ -164,6 +167,7 @@ def __getattr__(name):
"volume_fraction",
"percolation_check",
"tortuosity",
+ "tortuosity_all",
"effective_diffusivity",
"specific_surface_area",
"connected_components",
diff --git a/python/openimpala/_io.py b/python/openimpala/_io.py
new file mode 100644
index 00000000..ab1b7c31
--- /dev/null
+++ b/python/openimpala/_io.py
@@ -0,0 +1,453 @@
+"""Pure-Python 3-D voxel image readers matching OpenImpala C++ I/O semantics.
+
+Supports uncompressed 1/8/16/32/64-bit stripped and tiled TIFF stacks using the
+Python standard library (falling back to ``tifffile`` for compressed TIFFs),
+HDF5 datasets (via optional ``h5py``), legacy ``.dat`` files, flat binary ``.raw``
+volumes, and ``.npy`` arrays.
+"""
+
+from __future__ import annotations
+
+import os
+import struct
+from pathlib import Path
+from typing import Optional, Sequence
+
+import numpy as np
+
+# RawDataType integer codes matching src/io/RawReader.H & python/bindings/enums.cpp
+_RAW_DTYPE_MAP: dict[str, str] = {
+ "uint8": "i2",
+ "uint16_le": "u2",
+ "int32_le": "i4",
+ "uint32_le": "u4",
+ "float32_le": "f4",
+ "float64_le": "f8",
+}
+
+_TIFF_TYPE_INFO: dict[int, tuple[int, str]] = {
+ 1: (1, "B"), # BYTE
+ 2: (1, "s"), # ASCII
+ 3: (2, "H"), # SHORT
+ 4: (4, "I"), # LONG
+ 5: (8, "II"), # RATIONAL
+ 6: (1, "b"), # SBYTE
+ 7: (1, "B"), # UNDEFINED
+ 8: (2, "h"), # SSHORT
+ 9: (4, "i"), # SLONG
+ 11: (4, "f"), # FLOAT
+ 12: (8, "d"), # DOUBLE
+ 16: (8, "Q"), # LONG8 (BigTIFF)
+ 17: (8, "q"), # SLONG8 (BigTIFF)
+ 18: (8, "Q"), # IFD8 (BigTIFF)
+}
+
+
+class PureVoxelImage:
+ """Pure-Python counterpart to ``openimpala._core.VoxelImage``."""
+
+ def __init__(
+ self,
+ arr: np.ndarray,
+ *,
+ dx: float = 1.0,
+ dy: float = 1.0,
+ dz: float = 1.0,
+ periodic: Sequence[bool] = (False, False, False),
+ ) -> None:
+ arr_c = np.ascontiguousarray(arr, dtype=np.int32)
+ if arr_c.ndim != 3:
+ raise ValueError(f"Expected a 3-D array, got shape {arr_c.shape}")
+ if dx <= 0.0 or dy <= 0.0 or dz <= 0.0:
+ raise ValueError("Voxel sizes (dx, dy, dz) must all be strictly positive.")
+ self._arr = arr_c
+ self._dx = float(dx)
+ self._dy = float(dy)
+ self._dz = float(dz)
+ self._periodic = (bool(periodic[0]), bool(periodic[1]), bool(periodic[2]))
+
+ @classmethod
+ def from_numpy(
+ cls,
+ arr: np.ndarray,
+ max_grid_size: int = 32,
+ dx: float = 1.0,
+ dy: float = 1.0,
+ dz: float = 1.0,
+ periodic: Sequence[bool] = (False, False, False),
+ ) -> "PureVoxelImage":
+ del max_grid_size
+ return cls(arr, dx=dx, dy=dy, dz=dz, periodic=periodic)
+
+ def with_voxel_size(
+ self,
+ dx: float = 1.0,
+ dy: float = 1.0,
+ dz: float = 1.0,
+ periodic: Sequence[bool] = (False, False, False),
+ ) -> "PureVoxelImage":
+ return PureVoxelImage(self._arr, dx=dx, dy=dy, dz=dz, periodic=periodic)
+
+ @property
+ def shape(self) -> tuple[int, int, int]:
+ nz, ny, nx = self._arr.shape
+ return (int(nz), int(ny), int(nx))
+
+ @property
+ def voxel_size(self) -> tuple[float, float, float]:
+ return (self._dz, self._dy, self._dx)
+
+ @property
+ def cell_size_xyz(self) -> tuple[float, float, float]:
+ return (self._dx, self._dy, self._dz)
+
+ def to_numpy(self) -> np.ndarray:
+ return self._arr.copy()
+
+ def __array__(self, dtype=None) -> np.ndarray:
+ if dtype is None:
+ return self._arr
+ return self._arr.astype(dtype, copy=False)
+
+ def __repr__(self) -> str:
+ nz, ny, nx = self._arr.shape
+ return f""
+
+
+class PureReader:
+ """Pure-Python reader handle matching C++ reader metadata & thresholding."""
+
+ def __init__(self, raw_volume: np.ndarray, kind: str = "PureReader") -> None:
+ if raw_volume.ndim == 2:
+ raw_volume = raw_volume[np.newaxis, :, :]
+ if raw_volume.ndim != 3:
+ raise ValueError(f"Expected 3-D volume (Nz, Ny, Nx), got shape {raw_volume.shape}")
+ self._raw = raw_volume
+ self._kind = kind
+
+ @property
+ def depth(self) -> int:
+ return int(self._raw.shape[0])
+
+ @property
+ def height(self) -> int:
+ return int(self._raw.shape[1])
+
+ @property
+ def width(self) -> int:
+ return int(self._raw.shape[2])
+
+ @property
+ def is_read(self) -> bool:
+ return True
+
+ def threshold(
+ self,
+ raw_threshold: float,
+ value_if_true_or_grid: int = 32,
+ value_if_false: Optional[int] = None,
+ max_grid_size: int = 32,
+ ) -> PureVoxelImage:
+ del max_grid_size
+ if value_if_false is None:
+ v_true, v_false = 1, 0
+ else:
+ v_true = int(value_if_true_or_grid)
+ v_false = int(value_if_false)
+ binary = np.where(self._raw > raw_threshold, v_true, v_false).astype(np.int32)
+ return PureVoxelImage(binary)
+
+ def __repr__(self) -> str:
+ return f"<{self._kind} {self.width}x{self.height}x{self.depth}>"
+
+
+def _sample_numpy_dtype(endian: str, bps: int, sample_format: int) -> np.dtype:
+ bytes_per_sample = bps // 8
+ if sample_format == 1: # unsigned int
+ code = "u"
+ elif sample_format == 2: # signed int
+ code = "i"
+ elif sample_format == 3: # IEEE float
+ code = "f"
+ else:
+ raise ValueError(f"Unsupported TIFF SampleFormat={sample_format}")
+ return np.dtype(f"{endian}{code}{bytes_per_sample}")
+
+
+def _decode_uncompressed_chunk(
+ buf: bytes,
+ rows: int,
+ cols: int,
+ bps: int,
+ fill_order: int,
+ endian: str,
+ sample_format: int,
+) -> np.ndarray:
+ if bps == 1:
+ row_bytes = (cols + 7) // 8
+ needed = rows * row_bytes
+ raw_bytes = np.frombuffer(buf[:needed], dtype=np.uint8)
+ if raw_bytes.size < needed:
+ padded = np.zeros(needed, dtype=np.uint8)
+ padded[: raw_bytes.size] = raw_bytes
+ raw_bytes = padded
+ bitorder = "big" if fill_order == 1 else "little"
+ bits = np.unpackbits(raw_bytes.reshape(rows, row_bytes), axis=1, bitorder=bitorder)
+ return bits[:, :cols]
+
+ if bps in (8, 16, 32, 64):
+ dt = _sample_numpy_dtype(endian, bps, sample_format)
+ needed_elems = rows * cols
+ needed_bytes = needed_elems * dt.itemsize
+ chunk = np.frombuffer(buf[:needed_bytes], dtype=dt)
+ if chunk.size < needed_elems:
+ padded = np.zeros(needed_elems, dtype=dt)
+ padded[: chunk.size] = chunk
+ chunk = padded
+ return chunk.reshape(rows, cols)
+
+ raise ValueError(f"Unsupported uncompressed TIFF BitsPerSample={bps}")
+
+
+def read_tiff_volume(path: str | os.PathLike) -> np.ndarray:
+ """Read a 2-D or multi-page 3-D TIFF into a ``(Nz, Ny, Nx)`` NumPy array.
+
+ Uncompressed 1/8/16/32/64-bit stripped and tiled TIFFs (Classic TIFF and
+ BigTIFF) are decoded directly with the Python standard library, matching
+ ``OpenImpala::TiffReader`` raw bit/sample semantics. Compressed TIFFs
+ transparently fall back to ``tifffile`` when installed.
+ """
+ fpath = Path(path)
+ data = fpath.read_bytes()
+ if len(data) < 8:
+ raise ValueError(f"File '{fpath}' is too small to be a valid TIFF.")
+
+ byte_order = data[:2]
+ if byte_order == b"II":
+ endian = "<"
+ elif byte_order == b"MM":
+ endian = ">"
+ else:
+ raise ValueError(f"File '{fpath}' does not have a valid TIFF header.")
+
+ magic = struct.unpack_from(f"{endian}H", data, 2)[0]
+ if magic == 42:
+ bigtiff = False
+ ifd_offset = struct.unpack_from(f"{endian}I", data, 4)[0]
+ elif magic == 43:
+ bigtiff = True
+ offset_size, zero = struct.unpack_from(f"{endian}HH", data, 4)
+ if offset_size != 8 or zero != 0:
+ raise ValueError(f"Malformed BigTIFF header in '{fpath}'.")
+ ifd_offset = struct.unpack_from(f"{endian}Q", data, 8)[0]
+ else:
+ raise ValueError(f"Unsupported TIFF magic number {magic} in '{fpath}'.")
+
+ pages: list[np.ndarray] = []
+ inline_limit = 8 if bigtiff else 4
+
+ while ifd_offset != 0:
+ if bigtiff:
+ num_entries = struct.unpack_from(f"{endian}Q", data, ifd_offset)[0]
+ pos = ifd_offset + 8
+ entry_stride = 20
+ else:
+ num_entries = struct.unpack_from(f"{endian}H", data, ifd_offset)[0]
+ pos = ifd_offset + 2
+ entry_stride = 12
+
+ tags: dict[int, tuple] = {}
+ for _ in range(num_entries):
+ if bigtiff:
+ tag, ftype, count = struct.unpack_from(f"{endian}HHQ", data, pos)
+ val_bytes = data[pos + 12 : pos + 20]
+ else:
+ tag, ftype, count = struct.unpack_from(f"{endian}HHI", data, pos)
+ val_bytes = data[pos + 8 : pos + 12]
+ pos += entry_stride
+
+ if ftype not in _TIFF_TYPE_INFO:
+ continue
+ unit_size, fmt_char = _TIFF_TYPE_INFO[ftype]
+ total_bytes = unit_size * count
+ if total_bytes <= inline_limit:
+ raw_val = val_bytes[:total_bytes]
+ else:
+ ext_off = struct.unpack_from(
+ f"{endian}{'Q' if bigtiff else 'I'}", val_bytes, 0
+ )[0]
+ raw_val = data[ext_off : ext_off + total_bytes]
+
+ if fmt_char == "s":
+ tags[tag] = (raw_val.rstrip(b"\x00").decode("latin1", errors="replace"),)
+ elif ftype == 5:
+ vals = struct.unpack(f"{endian}{2 * count}I", raw_val)
+ tags[tag] = tuple(
+ vals[2 * i] / vals[2 * i + 1] if vals[2 * i + 1] else 0.0
+ for i in range(count)
+ )
+ else:
+ tags[tag] = struct.unpack(f"{endian}{count}{fmt_char}", raw_val)
+
+ ifd_offset = struct.unpack_from(
+ f"{endian}{'Q' if bigtiff else 'I'}", data, pos
+ )[0]
+
+ width = int(tags[256][0])
+ height = int(tags[257][0])
+ bps = int(tags.get(258, (1,))[0])
+ compression = int(tags.get(259, (1,))[0])
+ fill_order = int(tags.get(266, (1,))[0])
+ spp = int(tags.get(277, (1,))[0])
+ sample_format = int(tags.get(339, (1,))[0])
+
+ if compression != 1 or spp != 1:
+ try:
+ import tifffile
+ except ImportError as exc:
+ raise RuntimeError(
+ f"TIFF '{fpath}' uses compression={compression}, samples_per_pixel={spp}. "
+ "Install 'tifffile' (`pip install tifffile`) to read compressed or multi-channel TIFFs."
+ ) from exc
+ arr_tf = tifffile.imread(str(fpath))
+ if arr_tf.ndim == 2:
+ arr_tf = arr_tf[np.newaxis, :, :]
+ return arr_tf
+
+ out_dtype = np.uint8 if bps == 1 else _sample_numpy_dtype(endian, bps, sample_format)
+ page = np.zeros((height, width), dtype=out_dtype)
+
+ if 324 in tags: # Tiled TIFF
+ tw = int(tags[322][0])
+ th = int(tags[323][0])
+ t_offsets = tags[324]
+ t_counts = tags[325]
+ tiles_across = (width + tw - 1) // tw
+ tiles_down = (height + th - 1) // th
+ idx = 0
+ for ty in range(tiles_down):
+ for tx in range(tiles_across):
+ off = int(t_offsets[idx])
+ cnt = int(t_counts[idx])
+ idx += 1
+ tile = _decode_uncompressed_chunk(
+ data[off : off + cnt], th, tw, bps, fill_order, endian, sample_format
+ )
+ y0, x0 = ty * th, tx * tw
+ rh = min(th, height - y0)
+ rw = min(tw, width - x0)
+ page[y0 : y0 + rh, x0 : x0 + rw] = tile[:rh, :rw]
+ else: # Stripped TIFF
+ rps = int(tags.get(278, (height,))[0])
+ if rps <= 0 or rps > height:
+ rps = height
+ s_offsets = tags[273]
+ s_counts = tags[279]
+ for s_idx, (off, cnt) in enumerate(zip(s_offsets, s_counts)):
+ y0 = s_idx * rps
+ rows = min(rps, height - y0)
+ if rows <= 0:
+ break
+ strip = _decode_uncompressed_chunk(
+ data[int(off) : int(off) + int(cnt)],
+ rows,
+ width,
+ bps,
+ fill_order,
+ endian,
+ sample_format,
+ )
+ page[y0 : y0 + rows, :] = strip
+
+ pages.append(page)
+
+ if not pages:
+ raise ValueError(f"No image directories found in TIFF '{fpath}'.")
+ return np.stack(pages, axis=0)
+
+
+def read_hdf5_volume(path: str | os.PathLike, dataset: str = "/data") -> np.ndarray:
+ """Read a 3-D dataset from an HDF5 file into ``(Nz, Ny, Nx)`` order."""
+ try:
+ import h5py
+ except ImportError as exc:
+ raise RuntimeError(
+ "Reading HDF5 files in pure-Python mode requires 'h5py' (`pip install h5py`)."
+ ) from exc
+
+ with h5py.File(path, "r") as f:
+ if dataset not in f:
+ raise KeyError(
+ f"Dataset '{dataset}' not found in '{path}'. Available keys: {list(f.keys())}"
+ )
+ arr = np.asarray(f[dataset])
+ if arr.ndim != 3:
+ raise ValueError(f"Expected 3-D HDF5 dataset '{dataset}', got shape {arr.shape}")
+ return arr
+
+
+def read_dat_volume(path: str | os.PathLike) -> np.ndarray:
+ """Read a legacy OpenImpala ``.dat`` file (3x int32 LE header + uint16 LE data)."""
+ raw_bytes = Path(path).read_bytes()
+ if len(raw_bytes) < 12:
+ raise ValueError(f"DAT file '{path}' is too small for its 12-byte header.")
+ width, height, depth = struct.unpack_from(" np.dtype:
+ if raw_data_type is None:
+ return np.dtype(" np.ndarray:
+ """Read a flat binary ``.raw`` volume into ``(depth, height, width)`` order."""
+ if width <= 0 or height <= 0 or depth <= 0:
+ raise ValueError(
+ f"Positive (raw_width, raw_height, raw_depth) are required for RAW files, "
+ f"got ({width}, {height}, {depth})."
+ )
+ dt = _resolve_raw_dtype(raw_data_type)
+ expected = width * height * depth
+ needed_bytes = expected * dt.itemsize
+ raw_bytes = Path(path).read_bytes()
+ if len(raw_bytes) < needed_bytes:
+ raise ValueError(
+ f"RAW file '{path}' is smaller ({len(raw_bytes)} B) than expected ({needed_bytes} B)."
+ )
+ vox = np.frombuffer(raw_bytes, dtype=dt, count=expected, offset=0)
+ return vox.reshape((depth, height, width)).copy()
diff --git a/python/openimpala/datasets.py b/python/openimpala/datasets.py
new file mode 100644
index 00000000..bcf23318
--- /dev/null
+++ b/python/openimpala/datasets.py
@@ -0,0 +1,113 @@
+"""Built-in 3-D porous-media benchmark datasets for tutorials and testing.
+
+All dataset loaders return C-contiguous ``(Nz, Ny, Nx)`` ``int32`` NumPy arrays
+and do not require an active :class:`openimpala.Session`. When running from a
+repository checkout, files are read directly from ``data/``; in standalone wheel
+installations, files are downloaded once over HTTPS and cached under
+``$OPENIMPALA_DATA_DIR`` (default ``~/.cache/openimpala``).
+"""
+
+from __future__ import annotations
+
+import os
+import tempfile
+import urllib.request
+from pathlib import Path
+
+import numpy as np
+
+from ._io import read_tiff_volume
+
+_GITHUB_DATA_BASE = (
+ "https://raw.githubusercontent.com/BASE-Laboratory/OpenImpala/master/data"
+)
+
+__all__ = [
+ "fetch_path",
+ "two_phase_stack",
+ "two_phase_cubic",
+ "sphere_pack",
+]
+
+
+def _repo_data_dir() -> Path:
+ return Path(__file__).resolve().parents[2] / "data"
+
+
+def _cache_dir() -> Path:
+ env_dir = os.environ.get("OPENIMPALA_DATA_DIR")
+ if env_dir:
+ return Path(env_dir).expanduser().resolve()
+ return Path.home() / ".cache" / "openimpala"
+
+
+def fetch_path(filename: str) -> Path:
+ """Resolve *filename* in the repository ``data/`` folder or user cache.
+
+ Parameters
+ ----------
+ filename : str
+ Dataset file name under ``data/`` (e.g. ``'SampleData_2Phase_stack_3d_1bit.tif'``).
+
+ Returns
+ -------
+ pathlib.Path
+ Local filesystem path to the dataset file.
+ """
+ if "/" in filename or "\\" in filename or filename.startswith("."):
+ raise ValueError(f"Expected a plain dataset filename, got {filename!r}")
+
+ local_candidate = _repo_data_dir() / filename
+ if local_candidate.is_file():
+ return local_candidate
+
+ cache_target = _cache_dir() / filename
+ if cache_target.is_file() and cache_target.stat().st_size > 0:
+ return cache_target
+
+ cache_target.parent.mkdir(parents=True, exist_ok=True)
+ url = f"{_GITHUB_DATA_BASE}/{filename}"
+ fd, tmp_name = tempfile.mkstemp(
+ prefix=f".{filename}.", suffix=".part", dir=str(cache_target.parent)
+ )
+ os.close(fd)
+ tmp_path = Path(tmp_name)
+ try:
+ urllib.request.urlretrieve(url, str(tmp_path))
+ tmp_path.replace(cache_target)
+ except Exception:
+ tmp_path.unlink(missing_ok=True)
+ raise
+
+ return cache_target
+
+
+def two_phase_stack() -> np.ndarray:
+ """Return a ``(100, 100, 100)`` ``int32`` isotropic two-phase porous medium.
+
+ Phase ``1`` is the percolating pore network (:math:`\\varepsilon \\approx 0.3983`);
+ phase ``0`` is the solid matrix (:math:`1 - \\varepsilon \\approx 0.6017`).
+ """
+ path = fetch_path("SampleData_2Phase_stack_3d_1bit.tif")
+ return np.ascontiguousarray(read_tiff_volume(path), dtype=np.int32)
+
+
+def two_phase_cubic() -> np.ndarray:
+ """Return a ``(64, 64, 64)`` ``int32`` two-phase porous medium.
+
+ Phase ``1`` is the percolating pore network (:math:`\\varepsilon \\approx 0.3993`);
+ phase ``0`` is the solid matrix (:math:`1 - \\varepsilon \\approx 0.6007`).
+ """
+ path = fetch_path("SampleData_2Phase_squared.tif")
+ return np.ascontiguousarray(read_tiff_volume(path), dtype=np.int32)
+
+
+def sphere_pack() -> np.ndarray:
+ """Return a ``(100, 100, 100)`` ``int32`` regular 8-sphere benchmark volume.
+
+ Phase ``0`` consists of 8 non-overlapping spheres of radius :math:`R = 15`
+ voxels (:math:`\\phi_0 \\approx 0.1120`); phase ``1`` is the continuous
+ surrounding pore space (:math:`\\varepsilon \\approx 0.8880`).
+ """
+ path = fetch_path("spheres.tif")
+ return np.ascontiguousarray(read_tiff_volume(path), dtype=np.int32)
diff --git a/python/openimpala/facade.py b/python/openimpala/facade.py
index a847b13b..a438c234 100644
--- a/python/openimpala/facade.py
+++ b/python/openimpala/facade.py
@@ -11,6 +11,7 @@
import csv
import dataclasses
+import os
import tempfile
from pathlib import Path
from typing import Mapping, Optional, Sequence, Union
@@ -21,6 +22,7 @@
from .session import Session, _has_core
VoxelSizeArg = Union[float, int, Sequence[float]]
+DataInputArg = Union[np.ndarray, str, os.PathLike, "VoxelImage"]
# ---------------------------------------------------------------------------
@@ -55,6 +57,17 @@ class PercolationResult:
active_volume_fraction: float
direction: str
+ def _repr_html_(self) -> str:
+ status = "Yes" if self.percolates else "No"
+ return (
+ ""
+ "Metric Value "
+ f"Direction {self.direction} "
+ f"Percolates {status} "
+ f"Active VF {self.active_volume_fraction:.6f} "
+ "
"
+ )
+
@dataclasses.dataclass
class TortuosityResult:
@@ -145,6 +158,19 @@ class SpecificSurfaceAreaResult:
total_count: int
face_counts_xyz: tuple[int, int, int]
+ def _repr_html_(self) -> str:
+ fx, fy, fz = self.face_counts_xyz
+ return (
+ ""
+ "Metric Value "
+ f"SSA (raw) {self.ssa:.6e} "
+ f"SSA (2/3 Cauchy–Crofton) {self.ssa_corrected:.6e} "
+ f"SSA (voxel⁻¹) {self.ssa_voxel:.6f} "
+ f"Interfacial faces (x, y, z) {self.face_count:,} ({fx:,}, {fy:,}, {fz:,}) "
+ f"Evaluated voxels {self.total_count:,} "
+ "
"
+ )
+
@dataclasses.dataclass
class ConnectedComponentsResult:
@@ -154,6 +180,18 @@ class ConnectedComponentsResult:
volumes: np.ndarray
labels: Optional[np.ndarray] = None
+ def _repr_html_(self) -> str:
+ largest = int(np.max(self.volumes)) if self.volumes.size > 0 else 0
+ median = float(np.median(self.volumes)) if self.volumes.size > 0 else 0.0
+ return (
+ ""
+ "Metric Value "
+ f"Connected components {self.num_components:,} "
+ f"Largest volume (voxels) {largest:,} "
+ f"Median volume (voxels) {median:.1f} "
+ "
"
+ )
+
@dataclasses.dataclass
class ParticleSizeDistributionResult:
@@ -166,6 +204,24 @@ class ParticleSizeDistributionResult:
radii_voxels: np.ndarray
volumes_voxels: np.ndarray
+ def _repr_html_(self) -> str:
+ if self.radii.size > 0:
+ p10, p50, p90 = np.percentile(self.radii, [10, 50, 90])
+ pct_rows = (
+ f"R10 / R50 / R90 "
+ f"{p10:.4g} / {p50:.4g} / {p90:.4g} "
+ )
+ else:
+ pct_rows = ""
+ return (
+ ""
+ "Metric Value "
+ f"Particles {self.num_particles:,} "
+ f"Mean radius {self.mean_radius:.6g} "
+ f"{pct_rows}"
+ "
"
+ )
+
@dataclasses.dataclass
class ThroughThicknessResult:
@@ -176,6 +232,19 @@ class ThroughThicknessResult:
profile: np.ndarray
positions: np.ndarray
+ def _repr_html_(self) -> str:
+ p_min = float(np.min(self.profile)) if self.profile.size > 0 else 0.0
+ p_mean = float(np.mean(self.profile)) if self.profile.size > 0 else 0.0
+ p_max = float(np.max(self.profile)) if self.profile.size > 0 else 0.0
+ return (
+ ""
+ "Metric Value "
+ f"Direction {self.direction} "
+ f"Slices {self.num_slices} "
+ f"Profile (min / mean / max) {p_min:.4f} / {p_mean:.4f} / {p_max:.4f} "
+ "
"
+ )
+
@dataclasses.dataclass
class REVStudyResult:
@@ -187,6 +256,24 @@ class REVStudyResult:
std_diagonal: dict[int, np.ndarray]
csv_path: Optional[str] = None
+ def _repr_html_(self) -> str:
+ rows = [
+ "",
+ "Window L Mean D_xx Mean D_yy Mean D_zz Mean ± SD (trace/3) ",
+ ]
+ for sz in self.sizes:
+ m = self.mean_diagonal[sz]
+ s = self.std_diagonal[sz]
+ m_iso = float(np.mean(m))
+ s_iso = float(np.mean(s))
+ rows.append(
+ f"{sz} "
+ f"{m[0]:.5f} {m[1]:.5f} {m[2]:.5f} "
+ f"{m_iso:.5f} ± {s_iso:.5f} "
+ )
+ rows.append("
")
+ return "".join(rows)
+
# ---------------------------------------------------------------------------
# Backend detection & input normalisation helpers
@@ -280,19 +367,14 @@ def _parse_direction(d):
def _ensure_initialized():
- """Check that a Session is active."""
+ """Ensure a Session is active (auto-starting one for interactive/notebook use)."""
+ Session.ensure_active()
if _is_pure_python():
- if Session._depth == 0:
- raise RuntimeError(
- "OpenImpala is not initialized! Please wrap your code in a session block:\n\n"
- "with openimpala.Session():\n"
- " openimpala.volume_fraction(...)"
- )
return
_core = _get_core()
if not _core.amrex_initialized():
raise RuntimeError(
- "OpenImpala is not initialized! Please wrap your code in a session block:\n\n"
+ "OpenImpala AMReX runtime is not initialized. Wrap MPI scripts in:\n\n"
"with openimpala.Session():\n"
" openimpala.volume_fraction(...)"
)
@@ -387,12 +469,42 @@ def _auto_grid_size(shape: tuple[int, ...]) -> int:
return mgs
+def _resolve_pure_input(
+ data: DataInputArg,
+ voxel_size: Optional[VoxelSizeArg] = None,
+) -> tuple[np.ndarray, tuple[float, float, float]]:
+ """Resolve *data* into ``(arr_int32, (dz, dy, dx))`` for the pure-Python backend."""
+ from ._io import PureVoxelImage
+
+ if isinstance(data, (str, os.PathLike)):
+ p = Path(data)
+ if p.suffix.lower() == ".npy":
+ raw_arr = np.load(p)
+ if raw_arr.ndim != 3:
+ raise ValueError(f"Expected a 3-D array in '{p}', got shape {raw_arr.shape}")
+ return np.ascontiguousarray(raw_arr, dtype=np.int32), _normalize_voxel_size(voxel_size)
+ _, img = read_image(p, voxel_size=voxel_size)
+ return np.asarray(img, dtype=np.int32), img.voxel_size
+
+ if isinstance(data, PureVoxelImage):
+ vz = data.voxel_size if voxel_size is None else _normalize_voxel_size(voxel_size)
+ return np.asarray(data, dtype=np.int32), vz
+
+ if not isinstance(data, np.ndarray):
+ raise TypeError("data must be a 3-D NumPy array, VoxelImage, or file path")
+ if data.ndim != 3:
+ raise ValueError(f"Expected a 3-D array, got shape {data.shape}")
+ return np.ascontiguousarray(data, dtype=np.int32), _normalize_voxel_size(voxel_size)
+
+
def _numpy_to_voxelimage(
- data: np.ndarray,
+ data: DataInputArg,
max_grid_size: Union[int, str] = "auto",
voxel_size: Optional[VoxelSizeArg] = None,
):
- """Convert a 3-D int32 NumPy array (or VoxelImage) into a VoxelImage with physical cell sizes."""
+ """Convert a 3-D NumPy array, path, or VoxelImage into a C++ VoxelImage."""
+ from ._io import PureVoxelImage
+
_core = _get_core()
if isinstance(data, _core.VoxelImage):
@@ -401,8 +513,21 @@ def _numpy_to_voxelimage(
dz, dy, dx = _normalize_voxel_size(voxel_size)
return data.with_voxel_size(dx=dx, dy=dy, dz=dz)
+ if isinstance(data, (str, os.PathLike)):
+ p = Path(data)
+ if p.suffix.lower() == ".npy":
+ data = np.load(p)
+ else:
+ _, img = read_image(p, voxel_size=voxel_size, max_grid_size=max_grid_size)
+ return img
+
+ if isinstance(data, PureVoxelImage):
+ vz = data.voxel_size if voxel_size is None else _normalize_voxel_size(voxel_size)
+ data = data.to_numpy()
+ voxel_size = vz
+
if not isinstance(data, np.ndarray):
- raise TypeError("data must be a 3-D NumPy array or a VoxelImage")
+ raise TypeError("data must be a 3-D NumPy array, VoxelImage, or file path")
if data.ndim != 3:
raise ValueError(f"Expected a 3-D array, got shape {data.shape}")
@@ -420,18 +545,18 @@ def _numpy_to_voxelimage(
# ---------------------------------------------------------------------------
def volume_fraction(
- data: np.ndarray,
+ data: DataInputArg,
phase: int = 0,
*,
max_grid_size: Union[int, str] = "auto",
) -> VolumeFractionResult:
- """Compute the volume fraction of *phase* in a 3-D NumPy array or VoxelImage."""
+ """Compute the volume fraction of *phase* in a 3-D NumPy array, VoxelImage, or file."""
_ensure_initialized()
if _is_pure_python():
from . import _solver
- arr = np.ascontiguousarray(data, dtype=np.int32)
+ arr, _ = _resolve_pure_input(data)
pc, tc, frac = _solver.volume_fraction(arr, phase)
return VolumeFractionResult(phase_count=pc, total_count=tc, fraction=frac)
@@ -444,7 +569,7 @@ def volume_fraction(
def percolation_check(
- data: np.ndarray,
+ data: DataInputArg,
phase: int = 0,
direction: Union[str, "Direction"] = "x",
*,
@@ -457,13 +582,13 @@ def percolation_check(
if _is_pure_python():
from . import _solver
- arr = np.ascontiguousarray(data, dtype=np.int32)
+ arr, _ = _resolve_pure_input(data)
d = _parse_direction_int(direction)
percolates, active_vf, _ = _solver.percolation_check(arr, phase, 2 - d)
return PercolationResult(
percolates=percolates,
active_volume_fraction=active_vf,
- direction=_DIR_NAMES[d],
+ direction=_DIR_NAMES[d].upper(),
)
_core = _get_core()
@@ -478,7 +603,7 @@ def percolation_check(
def tortuosity(
- data: np.ndarray,
+ data: DataInputArg,
phase: int = 0,
direction: Union[str, "Direction"] = "x",
solver: Union[str, "SolverType"] = "auto",
@@ -498,8 +623,9 @@ def tortuosity(
Parameters
----------
- data : np.ndarray or VoxelImage
- 3-D integer array of phase IDs ``(Nz, Ny, Nx)`` or a ``VoxelImage`` handle.
+ data : np.ndarray, VoxelImage, or path-like
+ 3-D integer array of phase IDs ``(Nz, Ny, Nx)``, ``VoxelImage`` handle,
+ or path to a supported 3-D volume file.
phase : int
Conducting phase ID when *phase_diffusivities* is ``None``.
direction : str or Direction
@@ -526,8 +652,7 @@ def tortuosity(
if _is_pure_python():
from . import _solver
- arr = np.ascontiguousarray(data, dtype=np.int32)
- vz = _normalize_voxel_size(voxel_size)
+ arr, vz = _resolve_pure_input(data, voxel_size=voxel_size)
d = _parse_direction_int(direction)
result = _solver.solve_tortuosity(
arr,
@@ -651,8 +776,70 @@ def tortuosity(
)
+def tortuosity_all(
+ data: DataInputArg,
+ phase: int = 0,
+ solver: Union[str, "SolverType"] = "auto",
+ *,
+ directions: Sequence[Union[str, "Direction"]] = ("x", "y", "z"),
+ strict: bool = False,
+ voxel_size: Optional[VoxelSizeArg] = None,
+ phase_diffusivities: Optional[Mapping[int, float]] = None,
+ return_field: bool = False,
+ preconditioner: Union[str, "PrecondType"] = "smg",
+ max_grid_size: Union[int, str] = "auto",
+ results_path: str = ".",
+ verbose: int = 0,
+ mlmg_eps: Optional[float] = None,
+ mlmg_maxiter: Optional[int] = None,
+ mlmg_max_coarsening_level: Optional[int] = None,
+) -> dict[str, Optional[TortuosityResult]]:
+ """Compute steady-state tortuosity across cardinal directions ``('x', 'y', 'z')``.
+
+ Loads or stages *data* once, then solves each direction in *directions*.
+ When ``strict=False`` (default), directions that do not percolate map to
+ ``None`` instead of raising :class:`~openimpala.PercolationError`.
+ """
+ _ensure_initialized()
+
+ if _is_pure_python():
+ arr, vz = _resolve_pure_input(data, voxel_size=voxel_size)
+ staged: DataInputArg = arr
+ effective_vz: Optional[VoxelSizeArg] = vz
+ else:
+ staged = _numpy_to_voxelimage(data, max_grid_size, voxel_size=voxel_size)
+ effective_vz = None
+
+ results: dict[str, Optional[TortuosityResult]] = {}
+ for d in directions:
+ d_int = _parse_direction_int(d)
+ key = _DIR_NAMES[d_int]
+ try:
+ results[key] = tortuosity(
+ staged,
+ phase=phase,
+ direction=key,
+ solver=solver,
+ voxel_size=effective_vz,
+ phase_diffusivities=phase_diffusivities,
+ return_field=return_field,
+ preconditioner=preconditioner,
+ max_grid_size=max_grid_size,
+ results_path=results_path,
+ verbose=verbose,
+ mlmg_eps=mlmg_eps,
+ mlmg_maxiter=mlmg_maxiter,
+ mlmg_max_coarsening_level=mlmg_max_coarsening_level,
+ )
+ except PercolationError:
+ if strict:
+ raise
+ results[key] = None
+ return results
+
+
def effective_diffusivity(
- data: np.ndarray,
+ data: DataInputArg,
phase: int = 1,
*,
voxel_size: Optional[VoxelSizeArg] = None,
@@ -674,8 +861,7 @@ def effective_diffusivity(
if _is_pure_python():
from . import _solver
- arr = np.ascontiguousarray(data, dtype=np.int32)
- vz = _normalize_voxel_size(voxel_size)
+ arr, vz = _resolve_pure_input(data, voxel_size=voxel_size)
raw = _solver.solve_effective_diffusivity(
arr,
phase=phase,
@@ -726,7 +912,7 @@ def effective_diffusivity(
def specific_surface_area(
- data: np.ndarray,
+ data: DataInputArg,
phase_a: int = 0,
phase_b: int = 1,
*,
@@ -742,8 +928,7 @@ def specific_surface_area(
if _is_pure_python():
from . import _solver
- arr = np.ascontiguousarray(data, dtype=np.int32)
- vz = _normalize_voxel_size(voxel_size)
+ arr, vz = _resolve_pure_input(data, voxel_size=voxel_size)
raw = _solver.specific_surface_area(
arr, phase_a=phase_a, phase_b=phase_b, voxel_size=vz, boundary_padding=boundary_padding
)
@@ -786,7 +971,7 @@ def specific_surface_area(
def connected_components(
- data: np.ndarray,
+ data: DataInputArg,
phase: int = 1,
*,
return_labels: bool = False,
@@ -799,7 +984,7 @@ def connected_components(
if _is_pure_python():
from . import _solver
- arr = np.ascontiguousarray(data, dtype=np.int32)
+ arr, _ = _resolve_pure_input(data)
n_comp, vols, labels = _solver.connected_components(
arr, phase=phase, return_labels=return_labels
)
@@ -822,7 +1007,7 @@ def connected_components(
def particle_size_distribution(
- data: np.ndarray,
+ data: DataInputArg,
phase: int = 1,
*,
voxel_size: Optional[VoxelSizeArg] = None,
@@ -835,8 +1020,7 @@ def particle_size_distribution(
if _is_pure_python():
from . import _solver
- arr = np.ascontiguousarray(data, dtype=np.int32)
- vz = _normalize_voxel_size(voxel_size)
+ arr, vz = _resolve_pure_input(data, voxel_size=voxel_size)
raw = _solver.particle_size_distribution(arr, phase=phase, voxel_size=vz)
return ParticleSizeDistributionResult(
num_particles=raw["num_particles"],
@@ -871,7 +1055,7 @@ def particle_size_distribution(
def through_thickness_profile(
- data: np.ndarray,
+ data: DataInputArg,
phase: int = 1,
direction: Union[str, "Direction"] = "x",
*,
@@ -886,8 +1070,7 @@ def through_thickness_profile(
if _is_pure_python():
from . import _solver
- arr = np.ascontiguousarray(data, dtype=np.int32)
- vz = _normalize_voxel_size(voxel_size)
+ arr, vz = _resolve_pure_input(data, voxel_size=voxel_size)
prof, pos = _solver.through_thickness_profile(
arr, phase=phase, direction_xyz=d_int, voxel_size=vz
)
@@ -945,7 +1128,7 @@ def _summarize_rev_records(
def rev_study(
- data: np.ndarray,
+ data: DataInputArg,
sizes: Sequence[int],
*,
num_samples: int = 3,
@@ -967,8 +1150,7 @@ def rev_study(
if _is_pure_python():
from . import _solver
- arr = np.ascontiguousarray(data, dtype=np.int32)
- vz = _normalize_voxel_size(voxel_size)
+ arr, vz = _resolve_pure_input(data, voxel_size=voxel_size)
records = _solver.rev_study(
arr,
sizes=size_list,
@@ -1113,8 +1295,25 @@ def build_info() -> dict:
return info
+def _detect_file_format(path_str: str, file_format: Optional[str]) -> str:
+ if file_format is not None:
+ return file_format.strip().lower()
+ lower = path_str.lower()
+ if lower.endswith((".tif", ".tiff")):
+ return "tiff"
+ if lower.endswith((".h5", ".hdf5", ".hdf")):
+ return "hdf5"
+ if lower.endswith(".raw"):
+ return "raw"
+ if lower.endswith(".dat"):
+ return "dat"
+ if lower.endswith(".npy"):
+ return "npy"
+ raise ValueError(f"Cannot auto-detect format for '{path_str}'. Set file_format explicitly.")
+
+
def read_image(
- path: str,
+ path: Union[str, os.PathLike],
threshold: float = 0.5,
*,
voxel_size: Optional[VoxelSizeArg] = None,
@@ -1126,44 +1325,69 @@ def read_image(
raw_data_type=None,
max_grid_size: Union[int, str] = "auto",
) -> tuple:
- """Read a 3-D image file and threshold it into a VoxelImage."""
- _ensure_initialized()
+ """Read a 3-D image file and threshold it (`1` where `pixel > threshold`, else `0`).
- if _is_pure_python():
- raise NotImplementedError(
- "read_image() requires the compiled C++ backend (_core). "
- "In pure-Python mode, load your image with tifffile/h5py/numpy "
- "and pass the array directly to volume_fraction() or tortuosity()."
+ Works identically across compiled C++ and pure-Python backends.
+ """
+ _ensure_initialized()
+ path_str = os.fspath(path)
+ fmt = _detect_file_format(path_str, file_format)
+
+ if _is_pure_python() or fmt == "npy":
+ from ._io import (
+ PureReader,
+ read_dat_volume,
+ read_hdf5_volume,
+ read_raw_volume,
+ read_tiff_volume,
)
+ if fmt == "tiff":
+ raw_vol = read_tiff_volume(path_str)
+ reader = PureReader(raw_vol, kind="TiffReader")
+ elif fmt == "hdf5":
+ raw_vol = read_hdf5_volume(path_str, dataset=hdf5_dataset)
+ reader = PureReader(raw_vol, kind="HDF5Reader")
+ elif fmt == "raw":
+ raw_vol = read_raw_volume(
+ path_str, raw_width, raw_height, raw_depth, raw_data_type=raw_data_type
+ )
+ reader = PureReader(raw_vol, kind="RawReader")
+ elif fmt == "dat":
+ raw_vol = read_dat_volume(path_str)
+ reader = PureReader(raw_vol, kind="DatReader")
+ elif fmt == "npy":
+ raw_vol = np.load(path_str)
+ reader = PureReader(raw_vol, kind="NpyReader")
+ else:
+ raise ValueError(f"Unknown file_format '{fmt}'")
+
+ pure_img = reader.threshold(threshold)
+ if voxel_size is not None:
+ dz, dy, dx = _normalize_voxel_size(voxel_size)
+ pure_img = pure_img.with_voxel_size(dx=dx, dy=dy, dz=dz)
+
+ if not _is_pure_python():
+ # Convert .npy PureVoxelImage into native C++ VoxelImage
+ cpp_img = _numpy_to_voxelimage(pure_img, max_grid_size=max_grid_size)
+ return reader, cpp_img
+ return reader, pure_img
+
_core = _get_core()
if raw_data_type is None:
raw_data_type = _core.RawDataType.UINT8
- if file_format is None:
- lower = path.lower()
- if lower.endswith((".tif", ".tiff")):
- file_format = "tiff"
- elif lower.endswith((".h5", ".hdf5", ".hdf")):
- file_format = "hdf5"
- elif lower.endswith(".raw"):
- file_format = "raw"
- elif lower.endswith(".dat"):
- file_format = "dat"
- else:
- raise ValueError(f"Cannot auto-detect format for '{path}'. Set file_format explicitly.")
-
- if file_format == "tiff":
- reader = _core.TiffReader(path)
- elif file_format == "hdf5":
- reader = _core.HDF5Reader(path, hdf5_dataset)
- elif file_format == "raw":
- reader = _core.RawReader(path, raw_width, raw_height, raw_depth, raw_data_type)
- elif file_format == "dat":
- reader = _core.DatReader(path)
+ if fmt == "tiff":
+ reader = _core.TiffReader(path_str)
+ elif fmt == "hdf5":
+ reader = _core.HDF5Reader(path_str, hdf5_dataset)
+ elif fmt == "raw":
+ reader = _core.RawReader(path_str, raw_width, raw_height, raw_depth, raw_data_type)
+ elif fmt == "dat":
+ reader = _core.DatReader(path_str)
else:
- raise ValueError(f"Unknown file_format '{file_format}'")
+ raise ValueError(f"Unknown file_format '{fmt}'")
if isinstance(max_grid_size, str) and max_grid_size.lower() == "auto":
max_grid_size = 256 if _core.mpi_ranks() <= 1 else 64
diff --git a/python/openimpala/session.py b/python/openimpala/session.py
index 9106a128..ed983387 100644
--- a/python/openimpala/session.py
+++ b/python/openimpala/session.py
@@ -32,6 +32,7 @@ class Session:
_depth: int = 0 # nesting counter (class-level)
_pure_python: bool = False # True when _core is unavailable
+ _auto_session: "Session | None" = None
def __enter__(self) -> "Session":
if Session._depth == 0:
@@ -45,6 +46,23 @@ def __exit__(self, exc_type, exc_val, exc_tb) -> None: # noqa: ANN001
self._do_finalize()
return None # do not suppress exceptions
+ @classmethod
+ def ensure_active(cls) -> None:
+ """Lazily start a process-level session if not already inside ``with Session():``."""
+ if cls._depth == 0:
+ import atexit
+
+ cls._auto_session = cls()
+ cls._auto_session.__enter__()
+ atexit.register(cls._cleanup_auto)
+
+ @classmethod
+ def _cleanup_auto(cls) -> None:
+ if cls._auto_session is not None and cls._depth > 0:
+ sess = cls._auto_session
+ cls._auto_session = None
+ sess.__exit__(None, None, None)
+
# ------------------------------------------------------------------
@staticmethod
def _do_initialize() -> None:
@@ -79,11 +97,14 @@ def _do_initialize() -> None:
"the C++ backend."
)
+ import logging
+
from . import _solver
- backend = _solver.backend_name()
- import sys
- print(f"OpenImpala: using pure-Python solver backend ({backend})",
- file=sys.stderr)
+
+ logging.getLogger(__name__).debug(
+ "OpenImpala: using pure-Python solver backend (%s)",
+ _solver.backend_name(),
+ )
@staticmethod
def _do_finalize() -> None:
diff --git a/python/tests/test_config.py b/python/tests/test_config.py
index 6110de11..accfc535 100644
--- a/python/tests/test_config.py
+++ b/python/tests/test_config.py
@@ -2,7 +2,7 @@
import pytest
-from openimpala import _core
+_core = pytest.importorskip("openimpala._core")
class TestPhysicsConfig:
diff --git a/python/tests/test_datasets_and_io.py b/python/tests/test_datasets_and_io.py
new file mode 100644
index 00000000..f77a5088
--- /dev/null
+++ b/python/tests/test_datasets_and_io.py
@@ -0,0 +1,150 @@
+"""Tests for openimpala.datasets, pure-Python read_image(), tortuosity_all(), and HTML reprs."""
+
+from __future__ import annotations
+
+import struct
+from pathlib import Path
+
+import numpy as np
+import pytest
+
+import openimpala as oi
+from openimpala._io import read_tiff_volume
+from openimpala.exceptions import PercolationError
+
+
+class TestDatasets:
+ def test_loaders_shape_dtype_and_values(self):
+ stack = oi.datasets.two_phase_stack()
+ assert stack.shape == (100, 100, 100)
+ assert stack.dtype == np.int32
+ assert stack.flags["C_CONTIGUOUS"]
+ assert set(np.unique(stack)) == {0, 1}
+ assert np.mean(stack == 1) == pytest.approx(0.398309, rel=1e-6)
+
+ cubic = oi.datasets.two_phase_cubic()
+ assert cubic.shape == (64, 64, 64)
+ assert cubic.dtype == np.int32
+ assert np.mean(cubic == 1) == pytest.approx(0.3993263244628906, rel=1e-6)
+
+ spheres = oi.datasets.sphere_pack()
+ assert spheres.shape == (100, 100, 100)
+ assert spheres.dtype == np.int32
+ assert np.mean(spheres == 0) == pytest.approx(0.111976, rel=1e-6)
+
+ def test_stdlib_tiff_matches_tifffile(self, tmp_path):
+ tifffile = pytest.importorskip("tifffile")
+ for fn in (
+ "SampleData_2Phase_stack_3d_1bit.tif",
+ "SampleData_2Phase_squared.tif",
+ "spheres.tif",
+ ):
+ p = oi.datasets.fetch_path(fn)
+ expected = tifffile.imread(str(p)).astype(np.int32)
+ actual = read_tiff_volume(p).astype(np.int32)
+ np.testing.assert_array_equal(actual, expected)
+
+ # Also verify 16-bit big-endian and tiled uncompressed 3-D TIFF decoding
+ rng = np.random.default_rng(7)
+ vol_u16 = rng.integers(0, 1000, size=(6, 19, 23), dtype=np.uint16)
+ p_be = tmp_path / "u16_be.tif"
+ tifffile.imwrite(str(p_be), vol_u16.astype(">u2"))
+ np.testing.assert_array_equal(read_tiff_volume(p_be), vol_u16)
+
+ p_tiled = tmp_path / "u16_tiled.tif"
+ tifffile.imwrite(str(p_tiled), vol_u16, tile=(16, 16))
+ np.testing.assert_array_equal(read_tiff_volume(p_tiled), vol_u16)
+
+ def test_fetch_path_rejects_traversal(self):
+ with pytest.raises(ValueError):
+ oi.datasets.fetch_path("../README.md")
+
+
+class TestReadImageAndPathInputs:
+ def test_read_image_tiff_and_voxel_size(self):
+ path = oi.datasets.fetch_path("SampleData_2Phase_squared.tif")
+ reader, img = oi.read_image(path, threshold=0.5, voxel_size=(2.0, 1.5, 1.0))
+ assert reader.is_read
+ assert (reader.width, reader.height, reader.depth) == (64, 64, 64)
+ assert img.shape == (64, 64, 64)
+ assert img.voxel_size == pytest.approx((2.0, 1.5, 1.0))
+ assert img.cell_size_xyz == pytest.approx((1.0, 1.5, 2.0))
+
+ vf = oi.volume_fraction(img, phase=1)
+ assert vf.fraction == pytest.approx(0.3993263244628906, rel=1e-6)
+
+ # Direct path input to facade functions
+ vf_direct = oi.volume_fraction(path, phase=1)
+ assert vf_direct.phase_count == vf.phase_count
+
+ def test_read_image_dat_raw_npy_and_hdf5(self, tmp_path):
+ rng = np.random.default_rng(11)
+ vol = rng.integers(0, 2, size=(6, 8, 10), dtype=np.int32)
+
+ # .dat (3x int32 LE header W,H,D + uint16 LE voxels)
+ dat_path = tmp_path / "sample.dat"
+ header = struct.pack("") and html.endswith("")
diff --git a/python/tests/test_enums.py b/python/tests/test_enums.py
index 7b86b624..4f40ed6f 100644
--- a/python/tests/test_enums.py
+++ b/python/tests/test_enums.py
@@ -1,6 +1,8 @@
"""Tests for enum bindings."""
-from openimpala import _core
+import pytest
+
+_core = pytest.importorskip("openimpala._core")
def test_direction_values():
diff --git a/python/tests/test_facade_helpers.py b/python/tests/test_facade_helpers.py
index b5467861..d5491123 100644
--- a/python/tests/test_facade_helpers.py
+++ b/python/tests/test_facade_helpers.py
@@ -2,7 +2,7 @@
import pytest
-from openimpala import _core
+_core = pytest.importorskip("openimpala._core")
from openimpala.facade import _auto_grid_size, _parse_direction, _parse_solver
diff --git a/python/tests/test_percolation.py b/python/tests/test_percolation.py
index ccb36a71..b442047f 100644
--- a/python/tests/test_percolation.py
+++ b/python/tests/test_percolation.py
@@ -3,13 +3,17 @@
import numpy as np
import pytest
-from openimpala import _core
+try:
+ from openimpala import _core
+except ImportError:
+ _core = None
def _make_img(data: np.ndarray, max_grid_size: int = 32):
return _core.VoxelImage.from_numpy(np.ascontiguousarray(data, dtype=np.int32), max_grid_size)
+@pytest.mark.skipif(_core is None, reason="Requires compiled _core extension")
class TestPercolationCheckCore:
def test_connected_channel_percolates(self, connected_channel):
diff --git a/python/tests/test_plane_flux_diagnostic.py b/python/tests/test_plane_flux_diagnostic.py
index 66c819bf..354fbd71 100644
--- a/python/tests/test_plane_flux_diagnostic.py
+++ b/python/tests/test_plane_flux_diagnostic.py
@@ -11,7 +11,8 @@
import pytest
import openimpala as oi
-from openimpala import _core
+
+_core = pytest.importorskip("openimpala._core")
@pytest.fixture(scope="module")
diff --git a/python/tests/test_tortuosity.py b/python/tests/test_tortuosity.py
index cde9db5e..1d578699 100644
--- a/python/tests/test_tortuosity.py
+++ b/python/tests/test_tortuosity.py
@@ -8,7 +8,10 @@
import numpy as np
import pytest
-from openimpala import _core
+try:
+ from openimpala import _core
+except ImportError:
+ _core = None
from openimpala.exceptions import ConvergenceError, PercolationError
@@ -16,6 +19,7 @@ def _make_img(data: np.ndarray, max_grid_size: int = 32):
return _core.VoxelImage.from_numpy(np.ascontiguousarray(data, dtype=np.int32), max_grid_size)
+@pytest.mark.skipif(_core is None, reason="Requires compiled _core extension")
class TestTortuosityHypreCore:
"""Low-level TortuosityHypre tests."""
diff --git a/python/tests/test_volume_fraction.py b/python/tests/test_volume_fraction.py
index 30c40640..cdb5bd4b 100644
--- a/python/tests/test_volume_fraction.py
+++ b/python/tests/test_volume_fraction.py
@@ -3,7 +3,10 @@
import numpy as np
import pytest
-from openimpala import _core
+try:
+ from openimpala import _core
+except ImportError:
+ _core = None
def _make_img(data: np.ndarray, max_grid_size: int = 32):
@@ -11,6 +14,7 @@ def _make_img(data: np.ndarray, max_grid_size: int = 32):
return _core.VoxelImage.from_numpy(np.ascontiguousarray(data, dtype=np.int32), max_grid_size)
+@pytest.mark.skipif(_core is None, reason="Requires compiled _core extension")
class TestVolumeFractionCore:
"""Tests using the low-level _core.VolumeFraction class."""
diff --git a/tutorials/01_getting_started.ipynb b/tutorials/01_getting_started.ipynb
new file mode 100644
index 00000000..8bf06943
--- /dev/null
+++ b/tutorials/01_getting_started.ipynb
@@ -0,0 +1,469 @@
+{
+ "cells": [
+ {
+ "cell_type": "markdown",
+ "id": "01-getting-s-00",
+ "metadata": {},
+ "source": [
+ "[](https://colab.research.google.com/github/BASE-Laboratory/OpenImpala/blob/master/tutorials/01_getting_started.ipynb)\n",
+ "\n",
+ "# Steady-State Diffusion and 3D Field Inspection\n",
+ "\n",
+ "Steady-state diffusive or conductive transport through a porous phase $\\Omega_p \\subset [0, L_x] \\times [0, L_y] \\times [0, L_z]$ is governed by Laplace's equation with insulating pore–solid walls,\n",
+ "\n",
+ "$$\\nabla \\cdot (D_0 \\nabla \\phi) = 0 \\quad \\text{in } \\Omega_p, \\qquad \\nabla \\phi \\cdot \\mathbf{n} = 0 \\quad \\text{on } \\partial \\Omega_{ps},$$\n",
+ "\n",
+ "subject to fixed potentials $\\phi = 0$ and $\\phi = 1$ on opposing inlet and outlet planes and zero-flux conditions on the four lateral faces. From the integrated boundary flux $J$, the normalised effective diffusivity and tortuosity factor follow as\n",
+ "\n",
+ "$$\\frac{D_{\\text{eff}}}{D_0} = \\frac{|J|\\,L}{A\\,\\Delta \\phi} = \\frac{\\varepsilon}{\\tau},$$\n",
+ "\n",
+ "where $\\varepsilon = |\\Omega_p| / |\\Omega|$ is the conducting volume fraction."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": 1,
+ "id": "01-getting-s-01",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2026-11-18T09:43:39.099066Z",
+ "iopub.status.busy": "2026-11-18T09:43:39.098932Z",
+ "iopub.status.idle": "2026-11-18T09:43:39.105783Z",
+ "shell.execute_reply": "2026-11-18T09:43:39.104774Z"
+ },
+ "tags": [
+ "remove-cell"
+ ]
+ },
+ "outputs": [],
+ "source": [
+ "import sys\n",
+ "\n",
+ "if \"google.colab\" in sys.modules:\n",
+ " !pip install -q openimpala matplotlib"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": 2,
+ "id": "01-getting-s-02",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2026-11-18T09:43:39.107287Z",
+ "iopub.status.busy": "2026-11-18T09:43:39.107122Z",
+ "iopub.status.idle": "2026-11-18T09:43:39.454819Z",
+ "shell.execute_reply": "2026-11-18T09:43:39.454076Z"
+ }
+ },
+ "outputs": [],
+ "source": [
+ "import matplotlib.pyplot as plt\n",
+ "import numpy as np\n",
+ "import openimpala as oi\n",
+ "\n",
+ "plt.rcParams.update({\n",
+ " \"figure.dpi\": 120,\n",
+ " \"axes.spines.top\": False,\n",
+ " \"axes.spines.right\": False,\n",
+ " \"font.size\": 10,\n",
+ "})"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "01-getting-s-03",
+ "metadata": {},
+ "source": [
+ "## Analytical Verification on Parallel Slabs\n",
+ "\n",
+ "Before analysing tomographic data, verify the discretisation on a geometry with a closed-form solution: alternating conducting (`phase=1`) and insulating (`phase=0`) slabs aligned with the $z$-axis. Because every streamline runs straight from $z = 0$ to $z = L_z$ without lateral deflection, $\\varepsilon = 0.5$, $D_{\\text{eff}}/D_0 = 0.5$, and $\\tau = 1$ identically.\n",
+ "\n",
+ "In standalone MPI scripts, wrap solver calls in `with oi.Session():` to initialise and finalise the AMReX runtime deterministically (interactive notebooks also start a session automatically on first call)."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": 3,
+ "id": "01-getting-s-04",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2026-11-18T09:43:39.456917Z",
+ "iopub.status.busy": "2026-11-18T09:43:39.456715Z",
+ "iopub.status.idle": "2026-11-18T09:43:39.667495Z",
+ "shell.execute_reply": "2026-11-18T09:43:39.665445Z"
+ }
+ },
+ "outputs": [
+ {
+ "data": {
+ "text/html": [
+ "Metric Value Tortuosity 1.000000 Effective diffusivity 5.000000e-01 Solver status converged Iterations 0 Residual norm 0.00e+00 Flux in -1.600000e+01 Flux out -1.600000e+01 Active VF 0.500000
"
+ ],
+ "text/plain": [
+ "TortuosityResult(tortuosity=1.0, solver_converged=True, iterations=0, residual_norm=0.0, flux_in=-16.0, flux_out=-16.0, active_volume_fraction=0.5, solution_field=None, effective_diffusivity=0.5)"
+ ]
+ },
+ "execution_count": 3,
+ "metadata": {},
+ "output_type": "execute_result"
+ }
+ ],
+ "source": [
+ "slabs = np.zeros((32, 32, 32), dtype=np.int32)\n",
+ "slabs[:, :, :16] = 1 # conducting half-space spanning z (axis 0)\n",
+ "\n",
+ "with oi.Session():\n",
+ " slab_res = oi.tortuosity(slabs, phase=1, direction=\"z\")\n",
+ "\n",
+ "assert np.isclose(slab_res.tortuosity, 1.0, rtol=1e-6)\n",
+ "slab_res"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "01-getting-s-05",
+ "metadata": {},
+ "source": [
+ "## Loading Segmented Tomographic Data\n",
+ "\n",
+ "OpenImpala's 3D arrays follow `(Nz, Ny, Nx)` axis ordering (`z` = axis 0, `y` = axis 1, `x` = axis 2) to match TIFF page stacks and HDF5 hyperslabs. Here we load the $64^3$ two-phase porous ceramic/electrode subvolume shipped in `openimpala.datasets` via `oi.read_image()`, assigning a physical voxel pitch of $h = 0.5\\;\\mu\\mathrm{m}$ ($32 \\times 32 \\times 32\\;\\mu\\mathrm{m}^3$ domain)."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": 4,
+ "id": "01-getting-s-06",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2026-11-18T09:43:39.669294Z",
+ "iopub.status.busy": "2026-11-18T09:43:39.669089Z",
+ "iopub.status.idle": "2026-11-18T09:43:39.677553Z",
+ "shell.execute_reply": "2026-11-18T09:43:39.677106Z"
+ }
+ },
+ "outputs": [
+ {
+ "data": {
+ "text/html": [
+ "Metric Value Phase count 104,681 Total count 262,144 Volume fraction 0.399326 (39.93%)
"
+ ],
+ "text/plain": [
+ "VolumeFractionResult(phase_count=104681, total_count=262144, fraction=0.3993263244628906)"
+ ]
+ },
+ "execution_count": 4,
+ "metadata": {},
+ "output_type": "execute_result"
+ }
+ ],
+ "source": [
+ "tiff_path = oi.datasets.fetch_path(\"SampleData_2Phase_squared.tif\")\n",
+ "_, img = oi.read_image(tiff_path, voxel_size=0.5)\n",
+ "\n",
+ "vf = oi.volume_fraction(img, phase=1)\n",
+ "vf"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "01-getting-s-07",
+ "metadata": {},
+ "source": [
+ "Check whether `phase=1` forms a continuous face-connected pathway between the two $z$-boundaries before assembling the linear system:"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": 5,
+ "id": "01-getting-s-08",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2026-11-18T09:43:39.680791Z",
+ "iopub.status.busy": "2026-11-18T09:43:39.680638Z",
+ "iopub.status.idle": "2026-11-18T09:43:39.691719Z",
+ "shell.execute_reply": "2026-11-18T09:43:39.691309Z"
+ }
+ },
+ "outputs": [
+ {
+ "data": {
+ "text/html": [
+ "Metric Value Direction Z Percolates Yes Active VF 0.397034
"
+ ],
+ "text/plain": [
+ "PercolationResult(percolates=True, active_volume_fraction=0.39703369140625, direction='Z')"
+ ]
+ },
+ "execution_count": 5,
+ "metadata": {},
+ "output_type": "execute_result"
+ }
+ ],
+ "source": [
+ "perc = oi.percolation_check(img, phase=1, direction=\"z\")\n",
+ "perc"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "01-getting-s-09",
+ "metadata": {},
+ "source": [
+ "## Solving for Tortuosity and the 3D Potential Field\n",
+ "\n",
+ "Passing `return_field=True` returns the converged 3D cell-centred potential $\\phi \\in [0, 1]$ on `res.solution_field` alongside the scalar transport diagnostics. Inactive solid cells carry `0.0`."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": 6,
+ "id": "01-getting-s-10",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2026-11-18T09:43:39.693207Z",
+ "iopub.status.busy": "2026-11-18T09:43:39.693038Z",
+ "iopub.status.idle": "2026-11-18T09:43:42.199683Z",
+ "shell.execute_reply": "2026-11-18T09:43:42.199206Z"
+ }
+ },
+ "outputs": [
+ {
+ "data": {
+ "text/html": [
+ "Metric Value Tortuosity 3.397745 Effective diffusivity 1.168521e-01 Solver status converged Iterations 653 Residual norm 9.69e-10 Flux in -3.739268e+00 Flux out -3.739268e+00 Active VF 0.397034
"
+ ],
+ "text/plain": [
+ "TortuosityResult(tortuosity=3.3977451052914818, solver_converged=True, iterations=653, residual_norm=9.689535518940006e-10, flux_in=-3.739267715955876, flux_out=-3.7392677002427614, active_volume_fraction=0.39703369140625, solution_field=array([[[0.00000000e+00, 4.79049073e-03, 4.52709226e-03, ...,\n",
+ " 0.00000000e+00, 0.00000000e+00, 1.19576850e-04],\n",
+ " [0.00000000e+00, 4.37592810e-03, 4.06353700e-03, ...,\n",
+ " 5.23382137e-03, 1.31534546e-03, 3.58730571e-04],\n",
+ " [4.05593265e-04, 1.21677942e-03, 1.30237605e-03, ...,\n",
+ " 2.90466222e-03, 9.84175333e-04, 0.00000000e+00],\n",
+ " ...,\n",
+ " [0.00000000e+00, 0.00000000e+00, 6.77457188e-03, ...,\n",
+ " 0.00000000e+00, 0.00000000e+00, 5.11978672e-03],\n",
+ " [0.00000000e+00, 0.00000000e+00, 0.00000000e+00, ...,\n",
+ " 0.00000000e+00, 0.00000000e+00, 0.00000000e+00],\n",
+ " [0.00000000e+00, 0.00000000e+00, 0.00000000e+00, ...,\n",
+ " 0.00000000e+00, 0.00000000e+00, 0.00000000e+00]],\n",
+ "\n",
+ " [[0.00000000e+00, 1.50494334e-02, 1.40399028e-02, ...,\n",
+ " 2.12996081e-02, 0.00000000e+00, 0.00000000e+00],\n",
+ " [2.15729260e-02, 1.61847612e-02, 1.44280389e-02, ...,\n",
+ " 2.12520233e-02, 0.00000000e+00, 0.00000000e+00],\n",
+ " [0.00000000e+00, 0.00000000e+00, 0.00000000e+00, ...,\n",
+ " 9.63454341e-03, 0.00000000e+00, 0.00000000e+00],\n",
+ " ...,\n",
+ " [0.00000000e+00, 3.15275344e-02, 2.23737703e-02, ...,\n",
+ " 0.00000000e+00, 1.76918012e-02, 1.59835211e-02],\n",
+ " [3.77904192e-02, 3.44008421e-02, 2.94499783e-02, ...,\n",
+ " 0.00000000e+00, 0.00000000e+00, 2.06584436e-02],\n",
+ " [0.00000000e+00, 3.48801463e-02, 3.15410199e-02, ...,\n",
+ " 0.00000000e+00, 0.00000000e+00, 0.00000000e+00]],\n",
+ "\n",
+ " [[2.87871531e-02, 2.51825789e-02, 2.30411561e-02, ...,\n",
+ " 0.00000000e+00, 0.00000000e+00, 0.00000000e+00],\n",
+ " [2.69610905e-02, 2.54974798e-02, 2.43774399e-02, ...,\n",
+ " 4.86973660e-02, 0.00000000e+00, 0.00000000e+00],\n",
+ " [0.00000000e+00, 0.00000000e+00, 0.00000000e+00, ...,\n",
+ " 0.00000000e+00, 0.00000000e+00, 0.00000000e+00],\n",
+ " ...,\n",
+ " [4.21118005e-02, 3.78079914e-02, 3.14142700e-02, ...,\n",
+ " 0.00000000e+00, 2.36846239e-02, 2.29347372e-02],\n",
+ " [4.11799962e-02, 3.83561326e-02, 3.39158104e-02, ...,\n",
+ " 3.17787421e-02, 2.75729927e-02, 2.53333659e-02],\n",
+ " [4.17879025e-02, 3.86985769e-02, 3.48107890e-02, ...,\n",
+ " 3.57257060e-02, 0.00000000e+00, 2.70939210e-02]],\n",
+ "\n",
+ " ...,\n",
+ "\n",
+ " [[0.00000000e+00, 0.00000000e+00, 9.79869970e-01, ...,\n",
+ " 9.86869342e-01, 9.85090984e-01, 9.84395481e-01],\n",
+ " [0.00000000e+00, 9.91018515e-01, 9.85925865e-01, ...,\n",
+ " 9.86689095e-01, 9.85332045e-01, 9.84800956e-01],\n",
+ " [9.94134215e-01, 9.93000731e-01, 9.89788919e-01, ...,\n",
+ " 9.85839813e-01, 0.00000000e+00, 0.00000000e+00],\n",
+ " ...,\n",
+ " [0.00000000e+00, 0.00000000e+00, 0.00000000e+00, ...,\n",
+ " 0.00000000e+00, 9.96638660e-01, 9.96001191e-01],\n",
+ " [0.00000000e+00, 0.00000000e+00, 0.00000000e+00, ...,\n",
+ " 0.00000000e+00, 9.97638809e-01, 9.97143801e-01],\n",
+ " [9.63516203e-01, 9.64787328e-01, 0.00000000e+00, ...,\n",
+ " 9.98710073e-01, 9.98223030e-01, 9.97713866e-01]],\n",
+ "\n",
+ " [[9.96983202e-01, 9.95070566e-01, 9.90936386e-01, ...,\n",
+ " 9.89649597e-01, 9.88162758e-01, 9.87519018e-01],\n",
+ " [0.00000000e+00, 9.94128949e-01, 9.91522268e-01, ...,\n",
+ " 9.91194577e-01, 9.90391435e-01, 9.89998814e-01],\n",
+ " [0.00000000e+00, 9.94880179e-01, 9.93116445e-01, ...,\n",
+ " 9.91271576e-01, 0.00000000e+00, 0.00000000e+00],\n",
+ " ...,\n",
+ " [0.00000000e+00, 0.00000000e+00, 0.00000000e+00, ...,\n",
+ " 0.00000000e+00, 9.97862288e-01, 9.97635030e-01],\n",
+ " [0.00000000e+00, 9.92205875e-01, 9.94268123e-01, ...,\n",
+ " 9.99198740e-01, 9.98549746e-01, 9.98265614e-01],\n",
+ " [9.80945772e-01, 9.85179626e-01, 9.92338976e-01, ...,\n",
+ " 9.99197117e-01, 9.98829370e-01, 9.98581938e-01]],\n",
+ "\n",
+ " [[9.98895839e-01, 9.98233727e-01, 9.97282739e-01, ...,\n",
+ " 0.00000000e+00, 0.00000000e+00, 0.00000000e+00],\n",
+ " [9.99262264e-01, 9.98153219e-01, 9.97243584e-01, ...,\n",
+ " 9.97182374e-01, 9.97268978e-01, 9.97283847e-01],\n",
+ " [0.00000000e+00, 9.98204005e-01, 9.97629453e-01, ...,\n",
+ " 9.97360645e-01, 9.98756213e-01, 9.99151441e-01],\n",
+ " ...,\n",
+ " [0.00000000e+00, 0.00000000e+00, 9.99344453e-01, ...,\n",
+ " 0.00000000e+00, 9.99279160e-01, 9.99217166e-01],\n",
+ " [0.00000000e+00, 9.97169876e-01, 9.98023327e-01, ...,\n",
+ " 9.99684115e-01, 9.99503657e-01, 9.99417557e-01],\n",
+ " [9.94141488e-01, 9.95620179e-01, 9.97230082e-01, ...,\n",
+ " 9.99718179e-01, 9.99595018e-01, 9.99518903e-01]]],\n",
+ " shape=(64, 64, 64)), effective_diffusivity=0.11685211194563394)"
+ ]
+ },
+ "execution_count": 6,
+ "metadata": {},
+ "output_type": "execute_result"
+ }
+ ],
+ "source": [
+ "res = oi.tortuosity(img, phase=1, direction=\"z\", return_field=True)\n",
+ "res"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "01-getting-s-11",
+ "metadata": {},
+ "source": [
+ "At steady state, mass conservation requires the integrated inlet and outlet fluxes to balance up to the Krylov solver tolerance:"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": 7,
+ "id": "01-getting-s-12",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2026-11-18T09:43:42.201712Z",
+ "iopub.status.busy": "2026-11-18T09:43:42.201455Z",
+ "iopub.status.idle": "2026-11-18T09:43:42.205863Z",
+ "shell.execute_reply": "2026-11-18T09:43:42.205149Z"
+ }
+ },
+ "outputs": [
+ {
+ "name": "stdout",
+ "output_type": "stream",
+ "text": [
+ "Inlet / outlet flux imbalance: 4.20e-09\n"
+ ]
+ }
+ ],
+ "source": [
+ "rel_flux_imbalance = abs(abs(res.flux_in) - abs(res.flux_out)) / abs(res.flux_in)\n",
+ "print(f\"Inlet / outlet flux imbalance: {rel_flux_imbalance:.2e}\")"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "01-getting-s-13",
+ "metadata": {},
+ "source": [
+ "## Inspecting Local Potential Gradients and Bottlenecks\n",
+ "\n",
+ "Differentiating $\\phi$ inside the conducting phase highlights the contrast between narrow pore throats—where $|\\nabla \\phi|$ spikes and dominates macroscopic transport resistance—and dead-end pockets that sit at nearly uniform potential with negligible flux."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": 8,
+ "id": "01-getting-s-14",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2026-11-18T09:43:42.207184Z",
+ "iopub.status.busy": "2026-11-18T09:43:42.207022Z",
+ "iopub.status.idle": "2026-11-18T09:43:42.677540Z",
+ "shell.execute_reply": "2026-11-18T09:43:42.676929Z"
+ }
+ },
+ "outputs": [
+ {
+ "data": {
+ "image/png": "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8pa6Pih492gvs+vOr7nE5vO3hNLdh5YEuVqVOmt23WfC2ey6SuONro4MkZV1DTxm9jRzE1Pb9cmoErKyFIV1vf9aacX29QKuqOrXnPONza47qMIuq+eTpmLMWmvbkW0EB1cBMuyDhGByGrWKO+WRlT1IdVGsG6OJl5WV8WovK7sct159x3KRN3yGycpWPfnO5vOZFDBEsfzQA/kJ019xP9h8/rnNT/e+ze4uZA2h4s5awTtr7Y1nLUREREREREREREQOgHfWEhERERGRw0sfs5bDIBAREanFYRAcG4O1RERERETk8NLHrGWCMSIiItWYYMyhMVhLREREREQOT69izFo9x6wlIiKSaISKO2sF76y1NwZriSzAZGrkiLI7GRzR854JnWK5TiFzmFYjLzOVCEuxvSXZyFRSShpmSdIxtZpruyqWb9WvlpUprUNTQa4UIT8dXH6ptmJdpbsadTA/wZhWw5N7e6hW8kaWzWvuhUayMq3CV1YvbH9s0kOrmDzP3LaUfU6fPoWgoKDs7sZLpZiHfJtOjlPeHyfo5cdlrYbfCbWUkol9W3agrGz4pR/NnuYHxeRJyx4nK59X/RWXSxJh5TJuLiVlZa46eUJBAHiaeMb6GfHOWofGPTQRERERERERERGRA+CdtURERERE5PDSBJBm5R27aXwwhIiISKLRC6sThWn0PKjaG4O1RERERETk8PTQqkgwxgcKiYiIJELFMAiCwyDYG4O1RERERETk8PTQWp0ojMFaIiKiDPR6FWPWMgeBvTFYa0JwcHB2d8EsliT7ycokRFnJEZfLXp+LPepmZcIoR/ysiExx890K9yKOnwxl85VKsjKloESb0qezojsAgGcKCasAwFkjPyHUKeyDnE0koVJKmlW55E0Le5c1BhzraXbduSFLzaqnlEjMlPalI8yuq5RMzJK7F5NNJJRT0rvsYbPrUs6mlDyQiGynmEeqrOxhkolEVI/lCTLJPixJJqZk5i150jLKXZ4lR2V3F8gBMFhLREREREQOTw+NimEQ+IMxERGRROihEVbeIWttOzIbg7VEREREROTw0oRGRYIxBmuJiIgkehVj1lrbjszGYC0RERERETk8Aa3VY88KjllLRET0HyGsH3s2C4dSzK141kJERERERERERETkABisJSIiIiIih5cmtKpeRERE9C+9Xt3LSjExMRg1ahQC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Kpg6dSo++eQTfPvtt+jevTsAYNKkSfD09MSoUaMsWmZcXBwKFCiAyZMn44svvsDSpUvRp08fzJgxAwBw4MABJCYmWm0biIjIMnFxcWjXrh1atmyJH374AS4uLnj++efx4osv4rPPPsONGzdkLzMpKQnp6ek4cuQIRowYgeXLl2PSpEno0qULMjIycPv2bURHR1t/Y4iIiOzo2rVraNmyJQIDAxETEwNvb2+ULl0ab7/9Nn788UfExsbKXmbevLSpqano3bs3fvjhB0ybNg1NmjTBgwcPkJ2djWXLlll/Y4iIzORm7wSI8pv4+HjEx8dj6dKleP311w3xYsWKYc6cOdi8eTMuXbqEcuXKyV5u7dq18fHHH2PlypVwdXVFkyZNMH36dEyZMgWCIKBYsWIAAC8vL0RFRSE4ONhoGZ6enoiKikJISIhRvGDBgoiKihJNmk9ERPI8efIEixcvRu/evTFr1iy4uf39Uevzzz+Hi4sLdu/ejV69eslabt6vK7Zv347169dj27ZtCAkJwW+//Ya1a9fi6NGjRj/lbNGiBdzd3UXLad68ueTymzVrJrprl4iIyJ4EQcCCBQvQuHFjfPHFF0bzxo4bNw4XLlzAnj17UL9+fVnLPXnyJHJzc/H999/j1KlT2LZtG8qVK4fo6GicOHECmzZtQqFChQzt69evDy8vL9Fy6tWrJ3mtrVu3LvR6vayciIj+SSf8875/IrK76OhovPjii/j8889RsWJFtGzZEn5+fihdujQ6duyIRYsW2SSP3bt34+7duxg7diwqVKiAnTt32mS9RETOzs3NDZ07d0bv3r1RpUoVRERE4N1338WSJUtw//59m+SQnJyM48ePY+PGjfj++++Rmppq+EKQiIjIUURERMDT0xNjxoxBqVKl0LBhQ3z11VcYOnQobt++jYCAANVzuHnzJvbv34+jR49i2rRpOHToEJ577jnV10tEjot31hJpTKlSpRAVFYXY2FjExsaidu3ayMnJwbVr11C9enWb5bFjxw6cPXsWtWrVsul6iYicXVRUFHJzc7Fy5Uq8+OKLiIiIQHx8PKpVq2azHM6cOYOVK1ca8vHw8LDZuomIiKylTZs2uHz5MlauXIn69eujYcOGiI+PR/HixW0yUAs8ncrhn9dUf39/m6yXiBwX76wlcgDbt29H27ZtsXfvXjRp0sTe6RARkY35+/vj5Zdfxvz58+2dChERkUOrX78+/Pz8sG3bNnunQkQkiXfWEjmAnJwcREVF8Q5XIiIn9ODBAzRv3hwdO3a0dypEREQOr3LlyibncCci0gLeWUtERERERERERESkAS72ToCIiIiIiIiIiIiIOFhLREREREREREREpAkcrCUiIiIiIiIiIiLSAA7WEhEREREREREREWkAB2uJiIiIiIiIiIiINICDtUREREREREREREQawMFaIiIiIiIiIiIiIg3gYC0RERERERERERGRBnCwloiIiIiIiIiIiEgDOFhLREREREREREREpAEcrCUiIiIiIiIiIiLSgP8D3ZByAUsCQMcAAAAASUVORK5CYII=",
+ "text/plain": [
+ ""
+ ]
+ },
+ "metadata": {},
+ "output_type": "display_data"
+ }
+ ],
+ "source": [
+ "vol = oi.datasets.two_phase_cubic()\n",
+ "h_um = 0.5\n",
+ "phi = np.where(vol == 1, res.solution_field, np.nan)\n",
+ "\n",
+ "# Central differences inside interior pore cells (masked to NaN adjacent to solid walls)\n",
+ "gz, gy, gx = np.gradient(phi, h_um)\n",
+ "flux_mag = np.sqrt(gx**2 + gy**2 + gz**2)\n",
+ "\n",
+ "mid_y = vol.shape[1] // 2\n",
+ "extent_xz = [0.0, vol.shape[2] * h_um, 0.0, vol.shape[0] * h_um]\n",
+ "\n",
+ "fig, axes = plt.subplots(1, 3, figsize=(11.5, 3.6), sharey=True, constrained_layout=True)\n",
+ "\n",
+ "axes[0].imshow(vol[:, mid_y, :], origin=\"lower\", extent=extent_xz, cmap=\"binary_r\")\n",
+ "axes[0].set_title(rf\"Segmented pore phase ($y = {mid_y * h_um:.0f}\\;\\mu$m)\")\n",
+ "axes[0].set_xlabel(r\"$x\\;[\\mu\\mathrm{m}]$\")\n",
+ "axes[0].set_ylabel(r\"$z\\;[\\mu\\mathrm{m}]$ (transport axis)\")\n",
+ "\n",
+ "im_phi = axes[1].imshow(\n",
+ " phi[:, mid_y, :], origin=\"lower\", extent=extent_xz, cmap=\"viridis\", vmin=0.0, vmax=1.0\n",
+ ")\n",
+ "axes[1].set_title(r\"Steady-state potential $\\phi$\")\n",
+ "axes[1].set_xlabel(r\"$x\\;[\\mu\\mathrm{m}]$\")\n",
+ "fig.colorbar(im_phi, ax=axes[1], fraction=0.046, pad=0.04, label=r\"$\\phi\\;[-]$\")\n",
+ "\n",
+ "im_j = axes[2].imshow(flux_mag[:, mid_y, :], origin=\"lower\", extent=extent_xz, cmap=\"inferno\")\n",
+ "axes[2].set_title(r\"Local gradient magnitude $|\\nabla \\phi|$\")\n",
+ "axes[2].set_xlabel(r\"$x\\;[\\mu\\mathrm{m}]$\")\n",
+ "fig.colorbar(im_j, ax=axes[2], fraction=0.046, pad=0.04, label=r\"$|\\nabla \\phi|\\;[\\mu\\mathrm{m}^{-1}]$\")\n",
+ "\n",
+ "plt.show()"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "01-getting-s-15",
+ "metadata": {},
+ "source": [
+ "## References\n",
+ "\n",
+ "1. N. Epstein, *On tortuosity and the tortuosity factor in flow and diffusion through porous media*, Chem. Eng. Sci. **44**(3), 777–779 (1989).\n",
+ "2. B. Tjaden, S. J. Cooper, D. J. L. Brett, D. Kramer, and P. R. Shearing, *On the origin and application of the Bruggeman correlation for analysing transport phenomena in electrochemical systems*, Curr. Opin. Chem. Eng. **12**, 44–51 (2016)."
+ ]
+ }
+ ],
+ "metadata": {
+ "kernelspec": {
+ "display_name": "Python 3",
+ "language": "python",
+ "name": "python3"
+ },
+ "language_info": {
+ "codemirror_mode": {
+ "name": "ipython",
+ "version": 3
+ },
+ "file_extension": ".py",
+ "mimetype": "text/x-python",
+ "name": "python",
+ "nbconvert_exporter": "python",
+ "pygments_lexer": "ipython3",
+ "version": "3.11.2"
+ }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}
diff --git a/tutorials/01_hello_openimpala.ipynb b/tutorials/01_hello_openimpala.ipynb
deleted file mode 100644
index c8f95ab0..00000000
--- a/tutorials/01_hello_openimpala.ipynb
+++ /dev/null
@@ -1,116 +0,0 @@
-{
- "cells": [
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": " \n\n# Tutorial 1 of 7: Getting Started with OpenImpala\n\n*OpenImpala Tutorial Series — From first solve to HPC deployment*\n\n---\n\nOpenImpala computes effective transport properties (diffusivity, tortuosity, conductivity) directly on 3D voxel images of porous microstructures. It uses finite differences on the voxel grid — no mesh generation required — and is parallelised via MPI through AMReX and HYPRE.\n\nThis tutorial introduces the core workflow using a synthetic microstructure generated with [PoreSpy](https://porespy.org/), a widely used library for porous media analysis. No external data files are needed.\n\n**What you will learn:**\n1. Generate a random 3D porous microstructure with PoreSpy.\n2. Calculate volume fraction, check percolation, and compute tortuosity.\n3. Run a parametric sweep of porosity vs. tortuosity.\n\n**Prerequisites:** None — this is the starting point for the series."
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": "# Install OpenImpala, PoreSpy for structure generation, and Matplotlib for plots.\n!pip install -q openimpala porespy matplotlib"
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": "import time\nimport numpy as np\nimport matplotlib.pyplot as plt\nimport openimpala as oi\n\nprint(f\"OpenImpala version {oi.__version__} loaded and ready.\")\n\n# OpenImpala relies on AMReX and MPI under the hood. In a notebook we\n# need the runtime to stay alive across cells, so we open the session\n# manually. In a script, use the context manager instead:\n# with oi.Session():\n# ...\nsession = oi.Session()\nsession.__enter__()\n\n# Try importing PoreSpy for realistic structure generation.\n# If unavailable, we fall back to plain NumPy (see below).\ntry:\n import porespy as ps\n HAS_PORESPY = True\n print(\"PoreSpy available — will use blobs() for structure generation.\")\nexcept ImportError:\n HAS_PORESPY = False\n print(\"PoreSpy not found — using NumPy random generation instead.\")"
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": "## 1. Generating a Synthetic Microstructure\n\nIf PoreSpy is available, its `blobs` generator creates random two-phase structures that resemble real porous media (e.g. electrode microstructures from X-ray tomography). Otherwise we fall back to `np.random.choice`, which produces a simpler random structure but requires no extra dependencies.\n\nWe generate a $100^3$ voxel grid (~1 million voxels) with a target porosity of 0.40:\n- **Phase 0** — solid matrix\n- **Phase 1** — void / pore space\n\n**Phase convention:** OpenImpala labels each voxel with an integer phase ID. The `phase` parameter in functions like `oi.tortuosity(data, phase=1)` tells the solver which phase to treat as the transport medium. The default is `phase=0`, so **always pass `phase=` explicitly** to avoid silently computing the tortuosity of the wrong phase. There is no \"correct\" phase numbering — it depends on how your image was segmented."
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": "N = 100\nnp.random.seed(42) # For reproducibility\n\nif HAS_PORESPY:\n # PoreSpy blobs: spatially correlated random structure\n micro = ps.generators.blobs(\n shape=[N, N, N],\n porosity=0.40,\n blobiness=1.5,\n ).astype(np.int32)\nelse:\n # Pure NumPy fallback: uncorrelated random voxels\n micro = np.random.choice(\n [0, 1], size=(N, N, N), p=[0.60, 0.40]\n ).astype(np.int32)\n\nprint(f\"Microstructure shape: {micro.shape} ({micro.size / 1e6:.1f} million voxels)\")\nprint(f\"Measured porosity: {micro.mean():.4f}\")\nprint(f\"Unique phase IDs: {np.unique(micro)} (0=solid, 1=pore)\")"
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": "A mid-plane cross-section of the generated structure. Black = solid, white = pore. The random morphology is qualitatively similar to what you would see in a segmented tomography image."
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": "fig, ax = plt.subplots(figsize=(5, 5))\nax.imshow(micro[N // 2, :, :], cmap=\"gray\", interpolation=\"nearest\")\nax.set_title(f\"Mid-plane slice (z = {N // 2})\")\nax.axis('off')\nplt.tight_layout()\nplt.show()"
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": "## 2. Computing Transport Properties\n\nWe now pass the NumPy array directly into OpenImpala. The Python bindings transfer the array into an AMReX `iMultiFab`, formulate the steady-state diffusion problem, and solve it with HYPRE.\n\nWe set `max_grid_size=128` because our $100^3$ domain fits comfortably in memory on a single node. This avoids unnecessary domain decomposition overhead for small problems. For guidance on tuning this parameter at larger scales, see [Tutorial 7](07_hpc_scaling.ipynb)."
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": "print(\"Starting physics calculations...\")\n\n# 1. Volume fraction\nvf = oi.volume_fraction(micro, phase=1)\nprint(f\"\\nPorosity (phase 1 VF): {vf.fraction:.4f}\")\n\n# 2. Percolation check (does the pore space span the domain?)\nt0 = time.time()\nperc = oi.percolation_check(micro, phase=1, direction=\"z\")\nprint(f\"Percolates in Z: {perc.percolates} ({time.time()-t0:.3f}s)\")\n\n# 3. Solve for tortuosity\nif perc.percolates:\n t0 = time.time()\n result = oi.tortuosity(micro, phase=1, direction=\"z\", solver=\"mlmg\", max_grid_size=128)\n t_solve = time.time() - t0\n\n print(f\"\\nTortuosity (tau): {result.tortuosity:.4f}\")\n print(f\"Solver iterations: {result.iterations} (Residual: {result.residual_norm:.2e})\")\n print(f\"Wall time: {t_solve:.2f}s for {micro.size / 1e6:.1f}M voxels\")\nelse:\n print(\"Phase does not percolate -- tortuosity is undefined.\")"
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": "## 3. Parametric Sweep: Tortuosity vs. Porosity\n\nBecause OpenImpala operates directly on NumPy arrays, scripting parametric studies is straightforward. Below we sweep over a range of porosities. At low porosity the pore network may become disconnected and the phase will not percolate — in that case, tortuosity is undefined and we skip that point."
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": "porosities = [0.20, 0.30, 0.40, 0.50, 0.60, 0.70]\nresults = [] # (porosity, tau) pairs\n\nprint(\"Running parametric sweep...\")\nsweep_start = time.time()\n\nfor target in porosities:\n # Use a smaller grid (64^3) for the sweep to keep run times short\n if HAS_PORESPY:\n data = ps.generators.blobs(\n shape=[64, 64, 64], porosity=target, blobiness=1.5,\n ).astype(np.int32)\n else:\n # Seed per-porosity for reproducibility; uncorrelated voxels can\n # produce pathologically thin paths at low porosity, so we also\n # apply a mild dilation to improve connectivity.\n rng = np.random.default_rng(seed=int(target * 100))\n raw = rng.random(size=(64, 64, 64))\n data = (raw < target).astype(np.int32)\n\n perc = oi.percolation_check(data, phase=1, direction=\"z\")\n if not perc.percolates:\n print(f\" Porosity={target:.2f} -> Does not percolate (skipped)\")\n continue\n try:\n res = oi.tortuosity(data, phase=1, direction=\"z\", solver=\"mlmg\", max_grid_size=128)\n results.append((target, res.tortuosity))\n print(f\" Porosity={target:.2f} -> Tau={res.tortuosity:.4f}\")\n except oi.ConvergenceError:\n print(f\" Porosity={target:.2f} -> Solver did not converge (skipped)\")\n\nprint(f\"\\nEvaluated {len(porosities)} microstructures in {time.time() - sweep_start:.2f}s.\")\n\n# Plot the sweep results\nif results:\n phi_vals, tau_vals = zip(*results)\n\n fig, ax = plt.subplots(figsize=(6, 4), dpi=120)\n ax.plot(phi_vals, tau_vals, \"o-\", color=\"#d62728\", linewidth=2.5, markersize=8,\n markerfacecolor=\"white\", markeredgewidth=2)\n\n ax.set_xlabel(r\"Porosity ($\\varepsilon$)\", fontsize=12)\n ax.set_ylabel(r\"Tortuosity Factor ($\\tau$)\", fontsize=12)\n ax.set_title(\"Random Porous Media: Tortuosity vs. Porosity\")\n ax.grid(True, linestyle='--', alpha=0.6)\n ax.spines['top'].set_visible(False)\n ax.spines['right'].set_visible(False)\n\n plt.tight_layout()\n plt.show()"
- },
- {
- "cell_type": "markdown",
- "source": "## 4. Loading Your Own Data\n\nThe examples above used synthetic microstructures. When you have a real segmented 3D image (from X-ray CT, FIB-SEM, etc.), the workflow is the same — load it into a NumPy array, then pass it to OpenImpala.\n\n```python\n# TIFF stack (most common format from tomography)\nimport tifffile\ndata = tifffile.imread(\"my_scan.tif\").astype(np.int32)\nresult = oi.tortuosity(data, phase=1, direction=\"z\")\n\n# HDF5 dataset\nimport h5py\nwith h5py.File(\"my_scan.hdf5\", \"r\") as f:\n data = f[\"/exchange/data\"][:].astype(np.int32)\n\n# RAW binary (flat file, you must know the dimensions)\ndata = np.fromfile(\"my_scan.raw\", dtype=np.uint8).reshape((Nz, Ny, Nx))\ndata = (data > 128).astype(np.int32) # threshold to binary\n```\n\n**Key points:**\n- The array must be `int32` with integer phase labels (0, 1, 2, ...).\n- If your image is greyscale, **threshold it first** to produce a segmented phase map.\n- The array shape convention is **(Z, Y, X)** — the first axis is the stack direction.\n- For very large files that don't fit in RAM, use OpenImpala's built-in parallel C++ readers via `oi.read_image()` — see [Tutorial 7](07_hpc_scaling.ipynb).\n\n[Tutorial 2](02_digital_twin.ipynb) demonstrates a full worked example with a real TIFF stack.",
- "metadata": {}
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "## Next Steps\n",
- "\n",
- "In this tutorial we generated a microstructure, solved for its transport properties, and ran a parametric sweep — all from a single Python session, with no mesh generation or input files needed.\n",
- "\n",
- "**Up next in the series:**\n",
- "- [Tutorial 2: From 3D Image to Device Model](02_digital_twin.ipynb) — Load a real CT scan, measure anisotropy, and export parameters to PyBaMM.\n",
- "- [Tutorial 3: REV and Uncertainty](03_rev_and_uncertainty.ipynb) — Determine whether your sample volume is statistically representative.\n",
- "- [Tutorial 4: Effective Diffusivity and Field Visualisation](04_multiphase_and_fields.ipynb) — Use the cell-problem solver and visualise internal fields.\n",
- "- [Tutorial 5: Surrogate Modelling](05_surrogate_modelling.ipynb) — Generate training data for machine learning models.\n",
- "- [Tutorial 6: Topology Optimisation](06_topology_optimisation.ipynb) — Use OpenImpala inside an optimisation loop.\n",
- "- [Tutorial 7: Scaling to HPC](07_hpc_scaling.ipynb) — Deploy on clusters with MPI.\n",
- "\n",
- "---\n",
- "\n",
- "## References & Further Reading\n",
- "\n",
- "1. **OpenImpala:** J. Le Houx & D. Kramer, *OpenImpala: OPEN source IMage based PArallisable Linear Algebra solver*, SoftwareX 15, 100729 (2021). [doi:10.1016/j.softx.2021.100729](https://doi.org/10.1016/j.softx.2021.100729)\n",
- "2. **AMReX:** W. Zhang et al., *AMReX: a framework for block-structured adaptive mesh refinement*, J. Open Source Software 4(37), 1370 (2019). [doi:10.21105/joss.01370](https://doi.org/10.21105/joss.01370)\n",
- "3. **HYPRE:** R. D. Falgout & U. M. Yang, *hypre: A library of high performance preconditioners*, Computational Science — ICCS 2002, LNCS 2331, pp. 632–641 (2002). [doi:10.1007/3-540-47789-6_66](https://doi.org/10.1007/3-540-47789-6_66)\n",
- "4. **PoreSpy:** J. T. Gostick et al., *PoreSpy: A Python toolkit for quantitative analysis of porous media images*, J. Open Source Software 4(37), 1296 (2019). [doi:10.21105/joss.01296](https://doi.org/10.21105/joss.01296)\n",
- "5. **Tortuosity in porous media:** B. Tjaden et al., *On the origin and application of the Bruggeman correlation for analysing transport phenomena in electrochemical systems*, Current Opinion in Chemical Engineering 12, 44–51 (2016). [doi:10.1016/j.coche.2016.02.006](https://doi.org/10.1016/j.coche.2016.02.006)"
- ]
- }
- ],
- "metadata": {
- "kernelspec": {
- "display_name": "Python 3",
- "language": "python",
- "name": "python3"
- },
- "language_info": {
- "name": "python",
- "version": "3.10.0"
- }
- },
- "nbformat": 4,
- "nbformat_minor": 4
-}
diff --git a/tutorials/02_digital_twin.ipynb b/tutorials/02_digital_twin.ipynb
deleted file mode 100644
index a07e856c..00000000
--- a/tutorials/02_digital_twin.ipynb
+++ /dev/null
@@ -1,182 +0,0 @@
-{
- "cells": [
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": " \n\n# Tutorial 2 of 7: From 3D Image to Device Model\n\n*OpenImpala Tutorial Series — From first solve to HPC deployment*\n\n---\n\nA common workflow in electrochemical research is to characterise a 3D microstructure from X-ray tomography and feed the resulting transport parameters into a continuum device model such as [PyBaMM](https://pybamm.org/). This tutorial walks through that pipeline end-to-end.\n\n**What you will learn:**\n1. Load a real 3D TIFF image stack.\n2. Compute directional tortuosity (X, Y, Z) to quantify anisotropy.\n3. Visualise the 3D diffusion field using the C++ core API and `yt`.\n4. Export results to the BPX (Battery Parameter eXchange) JSON format.\n5. Import those parameters into PyBaMM and run a discharge simulation.\n\n**Prerequisites:** [Tutorial 1](01_hello_openimpala.ipynb) — basic OpenImpala workflow (volume fraction, percolation, tortuosity)."
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": "# Install OpenImpala and dependencies.\n# On GPU runtimes (T4, A100, etc.) we install the CUDA-accelerated wheel;\n# on CPU-only runtimes we fall back to the pure-Python/CPU package.\nimport subprocess, sys\n\ndef _has_gpu():\n try:\n subprocess.check_output([\"nvidia-smi\"], stderr=subprocess.DEVNULL)\n return True\n except (FileNotFoundError, subprocess.CalledProcessError):\n return False\n\n_common = \"pybamm bpx tifffile matplotlib yt\"\nif _has_gpu():\n print(\"GPU detected — installing openimpala-cuda\")\n !pip install -q openimpala-cuda {_common}\nelse:\n print(\"No GPU detected — installing openimpala (CPU)\")\n !pip install -q openimpala {_common}"
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": "import os\nimport time\nimport json\nimport urllib.request\nimport numpy as np\nimport matplotlib.pyplot as plt\nimport tifffile\n\nimport openimpala as oi\nfrom openimpala import core as oic # Low-level C++ API (pybind11 wrappers)\nimport pybamm\n\nprint(f\"OpenImpala version {oi.__version__} loaded.\")\n\n# In a notebook we open the session manually so it stays alive across\n# cells. In a script, use `with oi.Session():` instead (see Tutorial 1).\nsession = oi.Session()\nsession.__enter__()\n\n# Download the sample TIFF from the OpenImpala repository so that the\n# notebook works in ephemeral environments like Google Colab.\ndata_url = \"https://raw.githubusercontent.com/BASE-Laboratory/OpenImpala/master/data/SampleData_2Phase_stack_3d_1bit.tif\"\ndata_path = \"SampleData_2Phase_stack_3d_1bit.tif\"\n\nif not os.path.exists(data_path):\n print(\"Downloading sample data...\")\n urllib.request.urlretrieve(data_url, data_path)\n print(\"Download complete.\")"
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": "## 1. Loading Tomography Data\n\nOpenImpala's C++ backend includes readers for TIFF, RAW, and HDF5. When using the Python API, the most flexible approach is to load your data with a standard library (e.g. `tifffile`, `h5py`), apply any preprocessing you need (cropping, filtering, relabelling), and then hand the resulting NumPy array to OpenImpala."
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "# Read the TIFF stack into a 3D NumPy array (Z, Y, X)\n",
- "microstructure = tifffile.imread(data_path).astype(np.int32)\n",
- "\n",
- "print(f\"Loaded image shape (Z, Y, X): {microstructure.shape} ({microstructure.size / 1e6:.1f}M voxels)\")\n",
- "print(f\"Unique phases present: {np.unique(microstructure)}\")\n",
- "\n",
- "# Visualize the middle slice\n",
- "z_mid = microstructure.shape[0] // 2\n",
- "plt.figure(figsize=(5, 5), dpi=100)\n",
- "plt.imshow(microstructure[z_mid, :, :], cmap='gray')\n",
- "plt.title(f\"Microstructure Slice at Z = {z_mid}\", fontweight='bold')\n",
- "plt.axis('off')\n",
- "plt.tight_layout()\n",
- "plt.show()"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": "## 2. Directional Tortuosity and Anisotropy\n\nWe treat **Phase 1 as the pore space** (electrolyte). Manufactured electrodes are often calendered (compressed), which preferentially restricts transport in the through-thickness direction. Computing the tortuosity along all three cardinal directions reveals the extent of this anisotropy."
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": "directions = ['x', 'y', 'z']\ntau_results = {}\n\nprint(\"Computing directional tortuosity...\")\nt_start_all = time.time()\n\n# 1. Volume fraction\nvf = oi.volume_fraction(microstructure, phase=1)\nprint(f\"Pore volume fraction (porosity): {vf.fraction:.4f}\\n\")\n\n# 2. Tortuosity for each direction\nfor d in directions:\n t0 = time.time()\n perc = oi.percolation_check(microstructure, phase=1, direction=d)\n\n if perc.percolates:\n res = oi.tortuosity(microstructure, phase=1, direction=d, solver=\"mlmg\", max_grid_size=128)\n tau_results[d.upper()] = res.tortuosity\n t_solve = time.time() - t0\n print(f\" {d.upper()}-direction: tau = {res.tortuosity:.4f} ({t_solve:.2f}s)\")\n else:\n tau_results[d.upper()] = None\n print(f\" {d.upper()}-direction: does not percolate.\")\n\nt_total = time.time() - t_start_all\nprint(f\"\\nAll three directions solved in {t_total:.2f}s ({microstructure.size / 1e6:.1f}M voxels).\")"
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": "The bar chart below compares the tortuosity across directions. A value closer to 1.0 indicates less resistance to transport. Differences between directions reflect structural anisotropy in the material."
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "dirs = list(tau_results.keys())\n",
- "taus = [v for v in tau_results.values() if v is not None]\n",
- "\n",
- "fig, ax = plt.subplots(figsize=(6, 4), dpi=120)\n",
- "bars = ax.bar(dirs, taus, color=['#1f77b4', '#ff7f0e', '#2ca02c'], width=0.5)\n",
- "ax.axhline(y=1.0, color='r', linestyle='--', label='Ideal limit (Tau=1.0)')\n",
- "\n",
- "ax.set_ylabel(r\"Tortuosity Factor ($\\tau$)\", fontweight='bold')\n",
- "ax.set_title(\"Directional Tortuosity (Anisotropy)\", fontweight='bold')\n",
- "ax.set_ylim(1.0, max(taus) * 1.15)\n",
- "ax.legend()\n",
- "\n",
- "for bar in bars:\n",
- " yval = bar.get_height()\n",
- " ax.text(bar.get_x() + bar.get_width()/2, yval + 0.02,\n",
- " f'{yval:.3f}', ha='center', va='bottom', fontweight='bold')\n",
- "\n",
- "ax.spines['top'].set_visible(False)\n",
- "ax.spines['right'].set_visible(False)\n",
- "plt.show()"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": "## 3. Visualising the 3D Diffusion Field\n\nThe high-level `oi.tortuosity()` function skips field output by default to save time and disk space. To inspect the solved potential field, we can use the `openimpala.core` API with `write_plotfile=True`. The resulting AMReX plotfile can then be visualised with [yt](https://yt-project.org/), which has native support for AMReX data."
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": "import glob\nimport yt\n\n# Create a directory for AMReX plotfiles\nout_dir = \"./plotfiles\"\nos.makedirs(out_dir, exist_ok=True)\n\nprint(\"Running core solver to generate 3D plotfile...\")\n\n# Convert the NumPy array into an OpenImpala VoxelImage\nimg = oi.VoxelImage.from_numpy(microstructure.copy(), max_grid_size=128)\n\n# Instantiate the AMReX MLMG solver with plotfile output enabled.\n# MLMG is the matrix-free geometric multigrid path — typically 2-10x\n# faster than HYPRE on GPU hardware because it skips matrix assembly\n# and runs entirely in AMReX device kernels.\n#\n# eps=1e-11 matches the C++ default. MLMG references its relative\n# residual against ||r_initial|| (rhs=0 for the steady-state Laplacian)\n# rather than against ||b|| as HYPRE does, so it needs a tighter\n# relative tolerance to give the same effective absolute residual\n# on heterogeneous porous media.\nsolver = oic.TortuosityMLMG(\n img,\n vf.fraction, # Volume fraction (calculated earlier)\n 1, # Phase ID\n oic.Direction.Z,\n out_dir, # Output directory\n 0.0, 1.0, # Boundary conditions (V_lo, V_hi)\n 1, # Verbose level\n True, # Write plotfile\n 1e-11, # Convergence tolerance (matches C++ default)\n 200, # Max iterations\n 30 # Max coarsening level\n)\n\n# Execute the solve\nsolver.value()\nprint(\"Plotfile generation complete.\")"
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": "# Find the generated AMReX plotfile directory\nplotfile_dirs = [d for d in glob.glob(f\"{out_dir}/*\") if os.path.isdir(d)]\nlatest_plotfile = sorted(plotfile_dirs)[-1]\n\nprint(f\"Loading AMReX data from: {latest_plotfile}\")\n\n# Load the data into yt (suppress verbose logging)\nyt.funcs.mylog.setLevel(40)\nds = yt.load(latest_plotfile)\n\n# The C++ solver names the field 'solution_potential'\nfield_name = ('boxlib', 'solution_potential')\n\n# Slice through the middle of the Y-axis\nslc = yt.SlicePlot(ds, normal='y', fields=field_name)\n\n# Use a linear scale (the potential ranges from 0 to 1)\nslc.set_log(field_name, False)\nslc.set_zlim(field_name, 0.0, 1.0)\nslc.set_cmap(field_name, 'magma')\nslc.annotate_title(\"Steady-State Diffusion Potential (Z-Direction)\")\n\nslc.show()"
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "## 4. Exporting to BPX Format\n",
- "\n",
- "OpenImpala includes a `ResultsJSON` builder that produces files compliant with the [Battery Parameter eXchange (BPX)](https://github.com/FaradayInstitution/BPX) standard.\n",
- "\n",
- "Recall that the effective diffusivity is defined as $D_\\text{eff} = D_\\text{bulk}\\,\\varepsilon / \\tau$, so the transport efficiency (the ratio $D_\\text{eff}/D_\\text{bulk}$) is $\\varepsilon/\\tau$."
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": "# Access the low-level C++ bindings via openimpala.core\nrj = oic.ResultsJSON()\n\n# Define the physics we just solved (Diffusion)\nphysics_cfg = oic.PhysicsConfig.from_type_string(\"diffusion\")\nrj.set_physics_config(physics_cfg)\n\n# Set metadata\nrj.set_input_file(data_path)\nrj.set_phase_id(1)\nrj.set_volume_fraction(vf.fraction)\n\n# Add our directional results\nfor d, tau in tau_results.items():\n if tau is not None:\n transport_efficiency = vf.fraction / tau\n rj.add_direction_result(d, transport_efficiency)\n\n# Enable BPX fragment generation for the Positive Electrode\nrj.set_bpx_electrode(\"positive\")\nrj.set_provenance(sample_id=\"SampleData_2Phase\", provenance_uri=\"https://github.com/BASE-Laboratory/OpenImpala\")\n\n# Build the JSON string and save to disk\nbpx_json_string = rj.build_json_string()\nbpx_filepath = \"openimpala_cathode.json\"\n\nwith open(bpx_filepath, \"w\") as f:\n f.write(bpx_json_string)\n\nprint(f\"Exported BPX data to {bpx_filepath}\")"
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": "## 5. Running a Device Simulation in PyBaMM\n\nWith the BPX JSON file in hand, we can feed the microstructure-derived parameters into PyBaMM and simulate a discharge curve. This closes the loop from 3D imaging to device-level prediction."
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": "print(\"Loading PyBaMM DFN model...\")\nmodel = pybamm.lithium_ion.DFN()\n\n# Start from the Chen 2020 parameter set as a baseline\nparam = pybamm.ParameterValues(\"Chen2020\")\n\n# Read the BPX JSON we just exported\nwith open(bpx_filepath, \"r\") as f:\n oi_data = json.load(f)\n\n# Extract the parameters OpenImpala calculated\ncathode_params = oi_data[\"bpx\"][\"Parameterisation\"][\"Positive electrode\"]\noi_porosity = cathode_params[\"Porosity\"]\noi_bruggeman = cathode_params[\"Bruggeman coefficient (electrolyte)\"]\n\nprint(f\"Overriding defaults with OpenImpala results:\")\nprint(f\" Positive electrode porosity: {oi_porosity:.4f}\")\nprint(f\" Positive electrode Bruggeman exp: {oi_bruggeman:.4f}\")\n\n# Inject our measured parameters\nparam.update({\n \"Positive electrode porosity\": oi_porosity,\n \"Positive electrode Bruggeman coefficient (electrolyte)\": oi_bruggeman\n}, check_already_exists=False)\n\nprint(\"\\nRunning 1C discharge simulation...\")\nsim = pybamm.Simulation(model, parameter_values=param)\nsolution = sim.solve([0, 3600])\n\n# Plot the discharge curve\nt = solution[\"Time [s]\"].entries\nV = solution[\"Terminal voltage [V]\"].entries\n\nfig, ax = plt.subplots(figsize=(6, 4), dpi=120)\nax.plot(t, V, lw=2.5, color=\"#d62728\")\nax.set_xlabel(\"Time (s)\")\nax.set_ylabel(\"Terminal Voltage (V)\")\nax.set_title(\"PyBaMM Discharge Curve with OpenImpala Parameters\")\nax.grid(True, linestyle=\"--\", alpha=0.6)\nax.spines['top'].set_visible(False)\nax.spines['right'].set_visible(False)\nplt.tight_layout()\nplt.show()"
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "## Next Steps\n",
- "\n",
- "This tutorial demonstrated the full pipeline from a 3D tomography image to a device-level simulation, with BPX as the interchange format.\n",
- "\n",
- "**Continue the series:**\n",
- "- [Tutorial 3: REV and Uncertainty](03_rev_and_uncertainty.ipynb) — How large does your sample need to be for statistically representative results?\n",
- "- [Tutorial 4: Effective Diffusivity and Field Visualisation](04_multiphase_and_fields.ipynb) — Extend to the cell-problem solver and multi-phase composites.\n",
- "- [Tutorial 7: Scaling to HPC](07_hpc_scaling.ipynb) — Analyse full-resolution synchrotron datasets with MPI.\n",
- "\n",
- "---\n",
- "\n",
- "## References & Further Reading\n",
- "\n",
- "1. **OpenImpala:** J. Le Houx & D. Kramer, *OpenImpala: OPEN source IMage based PArallisable Linear Algebra solver*, SoftwareX 15, 100729 (2021). [doi:10.1016/j.softx.2021.100729](https://doi.org/10.1016/j.softx.2021.100729)\n",
- "2. **PyBaMM:** V. Sulzer et al., *Python Battery Mathematical Modelling (PyBaMM)*, J. Open Research Software 9(1), 14 (2021). [doi:10.5334/jors.309](https://doi.org/10.5334/jors.309)\n",
- "3. **BPX standard:** *Battery Parameter eXchange (BPX)*, an open standard for lithium-ion battery parameterisation. [GitHub](https://github.com/FaradayInstitution/BPX)\n",
- "4. **Electrode tortuosity & anisotropy:** M. Ebner et al., *Tortuosity anisotropy in lithium-ion battery electrodes*, Advanced Energy Materials 4(5), 1301278 (2014). [doi:10.1002/aenm.201301278](https://doi.org/10.1002/aenm.201301278)\n",
- "5. **yt visualisation:** M. J. Turk et al., *yt: A multi-code analysis toolkit for astrophysical simulation data*, Astrophys. J. Suppl. 192, 9 (2011). [doi:10.1088/0067-0049/192/1/9](https://doi.org/10.1088/0067-0049/192/1/9)\n",
- "6. **Digital twin concept for batteries:** A. A. Franco et al., *Boosting rechargeable batteries R&D by multiscale modeling: myth or reality?*, Chemical Reviews 119(7), 4569–4627 (2019). [doi:10.1021/acs.chemrev.8b00239](https://doi.org/10.1021/acs.chemrev.8b00239)"
- ]
- }
- ],
- "metadata": {
- "kernelspec": {
- "display_name": "Python 3",
- "language": "python",
- "name": "python3"
- },
- "language_info": {
- "name": "python",
- "version": "3.10.0"
- }
- },
- "nbformat": 4,
- "nbformat_minor": 4
-}
diff --git a/tutorials/02_microstructure_and_anisotropy.ipynb b/tutorials/02_microstructure_and_anisotropy.ipynb
new file mode 100644
index 00000000..35bd8660
--- /dev/null
+++ b/tutorials/02_microstructure_and_anisotropy.ipynb
@@ -0,0 +1,438 @@
+{
+ "cells": [
+ {
+ "cell_type": "markdown",
+ "id": "02-microstru-00",
+ "metadata": {},
+ "source": [
+ "[](https://colab.research.google.com/github/BASE-Laboratory/OpenImpala/blob/master/tutorials/02_microstructure_and_anisotropy.ipynb)\n",
+ "\n",
+ "# Microstructural Metrics, Anisotropy, and Non-Cubic Voxels\n",
+ "\n",
+ "Effective transport coefficients depend on three geometric features beyond bulk porosity: interfacial surface area per unit volume $S_V$, phase connectivity (percolating backbone versus isolated inclusions), and directional anisotropy arising either from material processing (e.g. electrode calendering or sedimentary bedding) or from non-cubic voxel spacing $(h_z, h_y, h_x)$ in serial-sectioning tomography."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": 1,
+ "id": "02-microstru-01",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2026-11-18T09:55:10.182643Z",
+ "iopub.status.busy": "2026-11-18T09:55:10.182412Z",
+ "iopub.status.idle": "2026-11-18T09:55:10.190496Z",
+ "shell.execute_reply": "2026-11-18T09:55:10.189693Z"
+ },
+ "tags": [
+ "remove-cell"
+ ]
+ },
+ "outputs": [],
+ "source": [
+ "import sys\n",
+ "\n",
+ "if \"google.colab\" in sys.modules:\n",
+ " !pip install -q openimpala matplotlib"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": 2,
+ "id": "02-microstru-02",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2026-11-18T09:55:10.192887Z",
+ "iopub.status.busy": "2026-11-18T09:55:10.192719Z",
+ "iopub.status.idle": "2026-11-18T09:55:10.972330Z",
+ "shell.execute_reply": "2026-11-18T09:55:10.970726Z"
+ }
+ },
+ "outputs": [],
+ "source": [
+ "import matplotlib.pyplot as plt\n",
+ "import numpy as np\n",
+ "import openimpala as oi\n",
+ "\n",
+ "plt.rcParams.update({\n",
+ " \"figure.dpi\": 120,\n",
+ " \"axes.spines.top\": False,\n",
+ " \"axes.spines.right\": False,\n",
+ " \"font.size\": 10,\n",
+ "})"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "02-microstru-03",
+ "metadata": {},
+ "source": [
+ "## Cauchy–Crofton Specific Surface Area and Particle Sizing\n",
+ "\n",
+ "Counting raw Cartesian voxel faces between two phases overestimates the area of smooth curved interfaces by a factor of $3/2$ in 3D (the ratio of the $\\ell_1$ to $\\ell_2$ sphere projection). OpenImpala's `specific_surface_area()` reports both the raw face-area density (`ssa`) and the isotropic Cauchy–Crofton stereological estimate (`ssa_corrected` $= \\frac{2}{3} S_V^{\\text{raw}}$).\n",
+ "\n",
+ "We verify both estimators on `oi.datasets.sphere_pack()`, a $100^3$ volume ($h = 1.0\\;\\mu\\mathrm{m}$) containing $N = 8$ non-overlapping solid spheres (`phase=0`) of radius $R = 15\\;\\mu\\mathrm{m}$, where the exact interfacial area density is\n",
+ "\n",
+ "$$S_V^{\\text{exact}} = \\frac{N \\cdot 4\\pi R^2}{L^3} = \\frac{8 \\times 4\\pi (15)^2}{100^3} = 0.022619\\;\\mu\\mathrm{m}^{-1}.$$"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": 3,
+ "id": "02-microstru-04",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2026-11-18T09:55:10.974560Z",
+ "iopub.status.busy": "2026-11-18T09:55:10.974277Z",
+ "iopub.status.idle": "2026-11-18T09:55:11.531170Z",
+ "shell.execute_reply": "2026-11-18T09:55:11.530620Z"
+ }
+ },
+ "outputs": [
+ {
+ "name": "stdout",
+ "output_type": "stream",
+ "text": [
+ "Analytical S_V: 0.02262 um^-1\n",
+ "Raw voxel face S_V: 0.03346 um^-1 (+47.9%)\n",
+ "Cauchy-Crofton S_V: 0.02230 um^-1 (-1.39%)\n"
+ ]
+ },
+ {
+ "data": {
+ "text/html": [
+ "Metric Value SSA (raw) 3.345600e-02 SSA (2/3 Cauchy–Crofton) 2.230400e-02 SSA (voxel⁻¹) 0.033456 Interfacial faces (x, y, z) 33,456 (11,152, 11,152, 11,152) Evaluated voxels 1,000,000
"
+ ],
+ "text/plain": [
+ "SpecificSurfaceAreaResult(ssa=0.033456, ssa_corrected=0.022303999999999997, ssa_voxel=0.033456, ssa_voxel_corrected=0.022303999999999997, face_count=33456, total_count=1000000, face_counts_xyz=(11152, 11152, 11152))"
+ ]
+ },
+ "execution_count": 3,
+ "metadata": {},
+ "output_type": "execute_result"
+ }
+ ],
+ "source": [
+ "spheres = oi.datasets.sphere_pack()\n",
+ "ssa = oi.specific_surface_area(spheres, phase_a=0, phase_b=1, voxel_size=1.0)\n",
+ "sv_exact = 8.0 * 4.0 * np.pi * (15.0**2) / spheres.size\n",
+ "\n",
+ "print(f\"Analytical S_V: {sv_exact:.5f} um^-1\")\n",
+ "print(f\"Raw voxel face S_V: {ssa.ssa:.5f} um^-1 ({(ssa.ssa / sv_exact - 1)*100:+.1f}%)\")\n",
+ "print(f\"Cauchy-Crofton S_V: {ssa.ssa_corrected:.5f} um^-1 ({(ssa.ssa_corrected / sv_exact - 1)*100:+.2f}%)\")\n",
+ "ssa"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "02-microstru-05",
+ "metadata": {},
+ "source": [
+ "6-connected component labelling (`connected_components`) and equivalent-sphere sizing (`particle_size_distribution`) recover the individual particles and their radii $R_{\\text{eq}} = (3V / 4\\pi)^{1/3}$:"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": 4,
+ "id": "02-microstru-06",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2026-11-18T09:55:11.533786Z",
+ "iopub.status.busy": "2026-11-18T09:55:11.533457Z",
+ "iopub.status.idle": "2026-11-18T09:55:11.612971Z",
+ "shell.execute_reply": "2026-11-18T09:55:11.611828Z"
+ }
+ },
+ "outputs": [
+ {
+ "data": {
+ "text/html": [
+ "Metric Value Particles 8 Mean radius 14.9503 R10 / R50 / R90 14.95 / 14.95 / 14.95
"
+ ],
+ "text/plain": [
+ "ParticleSizeDistributionResult(num_particles=8, mean_radius=14.95026133879592, radii=array([14.95026134, 14.95026134, 14.95026134, 14.95026134, 14.95026134,\n",
+ " 14.95026134, 14.95026134, 14.95026134]), volumes=array([13997., 13997., 13997., 13997., 13997., 13997., 13997., 13997.]), radii_voxels=array([14.95026134, 14.95026134, 14.95026134, 14.95026134, 14.95026134,\n",
+ " 14.95026134, 14.95026134, 14.95026134]), volumes_voxels=array([13997, 13997, 13997, 13997, 13997, 13997, 13997, 13997]))"
+ ]
+ },
+ "execution_count": 4,
+ "metadata": {},
+ "output_type": "execute_result"
+ }
+ ],
+ "source": [
+ "ccl_spheres = oi.connected_components(spheres, phase=0, return_labels=True)\n",
+ "psd = oi.particle_size_distribution(spheres, phase=0, voxel_size=1.0)\n",
+ "psd"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": 5,
+ "id": "02-microstru-07",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2026-11-18T09:55:11.615617Z",
+ "iopub.status.busy": "2026-11-18T09:55:11.615417Z",
+ "iopub.status.idle": "2026-11-18T09:55:12.022205Z",
+ "shell.execute_reply": "2026-11-18T09:55:12.021273Z"
+ }
+ },
+ "outputs": [
+ {
+ "data": {
+ "image/png": "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UBqinoiIMtauXTvs3r0be/fuhZ+fn7bDITX17t0bGzZswJMnT3J0BBwiyjytdOBLRAVP1apV0bt3byxdulTjnQrmZ2/fvsWrV69QuXJlrcZx9epVxMbGpjuMekH3/v17rFy5EoMGDWIihogoDZ07d8auXbvw4sULxMXF4e7duxg4cCB2794Na2trNGnSRNshkhoSExOxbds2bNy4Eb6+vkzEEOUhetoOgIgKjqVLl2Lw4MFqjcpV0MmH29Z2MqZ8+fK4efNmhkNQF2S6uro4efIkXF1dtR0KEVGedenSJfzzzz9K03V0dPDbb7/B2NhYC1FRVjRr1gxHjx6V3k+ePFmL0RDR19hMiQqF6OhoBAUFwc7ODqVKldJ2OFSIvHv3Dk+fPkXp0qVRrFgxbYdDRESUritXrmDx4sW4evUqXr58CXNzc9SsWRPjx49H/fr1tR0eqaFZs2Y4duwYSpcujSlTpuD777/XdkhElAqTMUREREREREREuYh9xhARERERERER5SImY4iIiIiIiIiIchGTMUREREREREREuYjJGCIiIiIiIiKiXMRkzFfi4+MRGBiI+Ph4bYdCRERE+QDPHYiIiEhdTMZ85fHjx3B3d8fjx4+1HQoRERHlAzx3ICIiInUxGUNERERERERElIuYjCEiIiIiIiIiykVMxhARERERERER5SImY4iIiIiIiIiIchGTMUREREREREREuYjJGCIiIiIiIiKiXMRkDBERERERERFRLmIyhoiIiIiIiIgoFzEZQ0RERERERESUi5iMISIiIiIiIiLKRUzGEBERERERERHlIiZjiIiIiIiIiIhyEZMxRERERERERES5iMkYIiIiIiIiIqJcxGQMEREREREREVEuYjKGiIiIiIiIiCgXMRlDRERERERERJSLmIwhIiIiIiIiIspFTMYQEREREREREeUiJmOIiIiIiIiIiHIRkzFERERERERERLmIyRgiIiIiIiIiolzEZAwRERERERERUS5iMoaIiIiIiIiIKBcxGUNERERERERElIuYjCEiIiIiIiIiykVMxhARERERERER5SImY4iIiIiIiIiIchGTMUREREREREREuYjJGCIiIiIiIiKiXMRkDBERERERERFRLtLTdgBERERU8AkhIJPJcqV+RmUTExORnJysNF0mk8HQ0DDLMRIREWlTYGAgNm3ahPDw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IiLKC0qXLo07d+7g/PnzePfuHebMmQNXV1elcgsXLoS5ubnadcuVK4ezZ8/iwYMHuH//PooUKQJXV1fY29tnqVyZMmVw9uxZ3L9/Hw8ePICNjQ3c3d1hZWWloT2S9zEZU8jkx6ZJmfH1drHZUv6W35olqSP1trHJEmmTvr6+9BRKZslHXMisqlWr4ty5c5gyZQqqVKkCXV1d1K9fHxcuXICjo6NCWQMDAxgaGio87ZLZ+hUqVMDYsWPx22+/4dq1a3j37h1sbW1Rr149/PLLL3B3d5fKlitXDuPHj8eqVatw7do1vH//Hg4ODujYsSMmTpzIJkhERJRv6evrZ3ijpVWrVlmuCwCurq4qkzxZLVexYkWlkZgKC5lQNUxBIRYYGAh3d3fcvXs3U4815zcFNRnzNSZj8reCnIxJjckY0paUlBTIZLJMjWakiXoFXUE/dyAiIiLN45MxREREhYy6T7hktx4RERERKeJZFRERERERERFRLuKTMQVQYWmKlJ709gGbMOUNhaUpUno4BDblJYMHD4aPjw969+6t7VCIiIiICjwmY4iIiAqBpKQkJCUlpTk/Pj4+3flEREREpDlMxhARERUCgwYNwp9//plumTp16uRSNERERESFG5MxBQSbJmVe6n3FJku5i02TMo9DYFNOmDNnDjp27Khy3o8//pjL0RAREREVXkzGEBERFRLFihWDs7OzynlFihTJ5WiIiIgKn4e9dbUdQqHmsi5Z2yFImIwhIiIqBMaNG5duwmXZsmXQ19fPxYiIiIiICi8mY4iIiAqBChUqpDvfzMwslyIhIiIiIh1tB0BERETacezYMdy5c0fbYRAREREVOkzGEBERFVL//vsvLl++rO0wiIiIiAodJmOIiIiIiIiIiHIR+4zJpziUtWZwmOucx+Gss+/rfcihromIiIiI8jc+GUNERERERERElIvy9JMxcXFxePr0KZKSklC6dGlYWFikWTYpKQkPHjxAUlISXF1dYWRklIuREhERERERERFlTp5MxsTExGDs2LFYv349nJycoK+vj6CgIPj5+WHlypUoXry4Qvldu3ZhyJAhMDY2homJCV68eIHZs2dj+PDhWtqCnMGmSTnr6/3LZktZw2ZJOS/1PmaTJSIiIiKi/CdPNlMaM2YM1q5di127duHBgwe4c+cOrly5gqNHj6Jbt24KZa9cuYJOnTqhb9++CAkJQWBgIFauXIkRI0bg33//1dIWEBERERERERGplieTMadOnUKFChXQvHlzaZqHhwd8fX1x+vRpCCGk6bNmzYKVlRVmzJghTevZsydq1qyJadOm5WrcRERE+cmKFSvQs2dPbYdBREREVOjkyWSMi4sLwsPD8fnzZ4XpL168gLOzM2QyGQAgOTkZx48fR/369aGvr69Q9ttvv8WDBw8QEhKSa3ETERHlJ8bGxjAwMNB2GERERESFTp7sM2bp0qXw8/ODn58fBg8eDAMDA2zduhUvX77Ezp07pXLPnj1DfHw8ypYtq7SMMmXKAACCgoKk/3/t7du3CA8PV5gWHByswS0hIiLKP54/f47AwECEh4cjJSVFYV7Tpk1RokQJLUVGREREVLDkyWSMs7MzhgwZgmnTpuHJkycwMDBASEgIRo0ahWrVqknloqKiAABmZmZKyzA3NwcAREZGprmeVatWKTRvIiIiKozi4uLQr18//PPPP0pJGLnjx48zGUNERESkIXkyGTNo0CCsW7cOBw4cwLfffgsACAwMROPGjXH58mX4+/sDgNQ0KTk5WWkZSUlJAJDu49dDhgxBx44dFaYFBwejTZs2mtgMIiKifGHhwoU4ePAg5s+fj1q1asHa2lpqEizn6OiopeiIiIiICp48l4yJjIzE2rVr0alTJykRAwBubm4YMWIEpkyZgoCAAFSvXl0a4vrrpkapp309DHZqtra2sLW11fAWaA6Hstau1Pufw1ynj8NZa8/X+55DXVNWXLlyBfPmzcPgwYO1HQoRERFRoZDnOvANDw+HEAJ2dnZK8+SJk7dv3wIAihYtijJlyuDWrVtKZW/evAlDQ0NUrlw5ZwMmIiLK5xwcHGBhYaHtMIiIiIgKjTyXjCldujSsrKxw6tQppeZHx44dg46ODqpUqSJN69GjBy5duoQHDx5I0z5+/Ihdu3ahffv2KvuTISIiov8zbNgwrF+/HgkJCdoOhYiIiKhQyHPNlPT19bF48WL0798fLVu2RP/+/WFgYICdO3dix44dmDJlCkqVKiWVHzduHPbv349WrVph1qxZMDExwbx582BqaooFCxZocUuIiIjyh8qVK2PmzJlo3bo1fHx8ULp0aalfNjlfX990m/4SERERUebluWQMAPTp0we1atXCmjVrsH79eiQmJqJMmTK4dOkSfHx8FMqa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K7F3716sX79eqekSKRu2ZC+KFLumMG3FaD842lniedhHDF+6T2W9vfN6AgAu3H6KBVvOKs0vZWuJlWP8AABbj9/CNv9bSmVqu5fGhO5fht6dv+kM/rv7TKlM52+qokuTqv8/1n148fajUpnxXeujThUnAEDriRtUxstt4jZxm7hN3KbsbdPhlDo4ImorlakqC0JfnS/L/yvFD7eE8o2QZrL/8D+dCwCAOcl9EYaiSmV66+yDpywIADAyeZzKeCfq/IUSsvd4LYpiXkpflWWW634ZEOeGqIB1KX5K8+3wHj/q/pWvtunw//83p7578u9BZqiVjNm3bx86duyoThVJ+/btsWPHjizVJSIiopxjYmKCkydPYsiQIfjjjz+QkpKCoKAgFCtWDGvXrkXPnpk/saCc4d5jWbrzH4d+wMajN9ItM3vDKczecCrdMgMX7skwluY/rMuwTGbizU/bVM7eOsNlEBERqUOt0ZR27NiBmTNnqn1SdufOHcTGxuaLZAxHRCAiosLs48ePCAkJgZGREVxcXKCry1EfMpIb5w4ZJS4oZ93dOErbIRBRAcHRlLQrX4+m5OLigh9++EGtOjt27MC2bdvUXRURERHlgmbNmsHOzg5r166FpaUlPD09tR0SERERUYGmVjLGw8MDxsbGaq8kq/WIiIgo5xUtWhQtW7aEvr6+tkMhokKs7qJz2g6hUDv/Qz1th0BUqKg1mpKzszNatGih9kqyWo+IiIhyXpcuXbBvn+oOCYmIiIhI89RupkREREQFS/369XHjxg307t0bvXv3RpkyZWBqaqpQxsLCgk/OEBEREWlItpMxycnJ2LFjBw4fPoyXL18iPj5eYX6jRo3w888/Z3c1RERElEPatWsHf39/AMD69etVljl+/Dh8fX1zMywiIiKiAitbyRghBFq0aIGjR4+iZMmSsLe3h4GBgaZiIyIiolwwcOBANGvWLN0yLi4uuRQNERERUcGXrWTM5cuXcebMGRw+fDjDkzgiIiLKmzp27KjtEIiIiIgKFbU68P1aREQE6taty0QMEREREREREVEmZevJmGrVquHNmzcQQkAmk2kqJiIiIsplMTExWLNmDQIDAxETE6M0f8qUKXB3d9dCZEREREQFT7aSMXZ2dhgyZAhGjRqF2bNnw8zMTFNxERERUS758OEDatSogRcvXkBHRwdmZmaIjIxEYmIibGxsYGpqisjISG2HSURERFRgZKuZEgAMHjwYFhYWKF68ODw9PdGwYUOF17Rp0zQRJxEREeWQ1atXw9TUFGFhYahTpw62bt2KT58+4ejRo/D09MS2bdtQp04dbYdJREREVGBke2jrvn374u+//4adnR1kMpnS0NaJiYnZXQURERHloICAAAwbNgyWlpYAvoyWqKuri2+//RZVq1ZF/fr1ERgYCD29bJ82EBERERGymYy5desWtm7dioMHD6J58+aaiomIiIhyUVRUFBwdHQEABgYGiIqKkubZ2dnBxsYGt2/fRrVq1bQVIhEREVGBkq1mSqGhoahTpw4TMURERPmY/EkYAHB0dMTly5eleQkJCQgJCYEQQlvhERERERU42R5NKSwsjKMpERERFRCtWrVC27Ztoa+vDxcXF2zbtg2JiYmoVKmStkMjIiIiKjCylYwpXrw4Ro4ciQkTJmDatGkwNTXVVFxERESUS7p3744yZcoAAFq0aIFBgwZh7ty5EELA2toamzdvhrGxcZaWnZycjF27duHy5cvQ1dVF/fr10aJFixypf+HCBfz33394/fo1SpcujWbNmqFChQo5EhcRERFRdmSrmdK5c+ewbds2/PvvvyhZsiSqV68OX19fhdfMmTM1FSsRERHlgN69e6NcuXLS+19++QVv3rzBvXv38Pr1azRr1ixLy42Li0Pjxo0xatQoWFlZwcjICL169UL79u2RnJyssfrv379HpUqV0LRpUwQHB8PBwQEXL15E5cqVMWnSJI3HRURERJRd2XoyJjExER8/foSNjQ1sbGwghMDHjx8VysTGxmZnFURERKQFtra2sLW1zdYyZsyYgUuXLuHu3bsoX748AKB58+aoWbMmVq1aheHDh2ukfnR0NExNTXHnzh3pCR8AmD17NqZMmYL69evjf//7n8biIiIiIsoumWCPfAoCAwPh7u6Ou3fvws3NTdvhEBER5UtJSUmws7ND3bp1sXfvXoV5Pj4+iIqKwv379zVSPzY2FkIImJmZKZR79OgRXFxcMGbMGCxevFgjcamSG+cO7j2W5chyKXPubhyl7RAKhbqLzmk7hELt/A/1tB1CofCwt662QyjUXNblnSdgs9VM6fPnz0hJSdFULERERFRAPHjwAB8+fED16tWV5vn4+EjzNVHf1NRUKREDAM+fPwcAmJiYaCwuIiIi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hoiIqJCLiopCcnJymvOTkpLw4cOHXIyIiIiIqGBjMoaIiKiQc3V1xa5du1TOu3fvHh4+fIjy5cvnclREREREBReTMURERIVcr169sG/fPgwePBghISEQQiAuLg4HDx6En58fmjVrBltbW22HSURERFRgMBlDRERUyLm7u2PFihVYvXo1ypYtCyMjI5iamqJly5YwMjLCmjVrtB0iERERUYHCYRGIiIgIgwcPRoMGDbBlyxaEhITA2NgYderUQdeuXWFoaKjt8IiIiIgKFCZjiIiICABQqVIlzJo1S9thEBERERV4bKZERERERERERJSLmIwhIiIqZLp06QIHBwecP39e4X16L3lZIiIiIso+NlMiIiIqZKpVqwZDQ0NYW1srvE+PvGxWvH//Hjdu3ICuri68vb1hbm6eY/VjYmJw7tw5fP78GS1atIC+vn6OxUVERESUVUzGEBERFTKtW7fGoEGDpOTDuHHjcmxdP//8M2bPno3q1asjISEBd+/exdKlSzFgwACN1j9//jyWLVuGs2fPQldXF2/evEFERAQsLS1zJC4iIiKi7GAzJSIiokJmyJAhuHz5svR+6NChuHLlisbXs27dOvz000/YtGkTzp07h8uXL2P+/PkYNGgQTpw4odH6oaGh6NKlC549e4YWLVrkaFxERERE2cVkDBERUSFjYmKCuLg46X1QUBCioqI0vp65c+fCx8cHHTp0kKYNHToUTk5OmD17tkbrd+rUCe3bt4exsXGOx0VERESUXWymREREVMi4u7vj559/RkxMDKytrfH+/XtcvXoVSUlJadapXr06ihYtmul1PHv2DA8fPsSECRMUpstkMjRs2BAbNmxAfHw8jIyMcqR+TsVFREREpAlMxhARERUyY8aMwZEjR9CtWzdp2s2bN9Otc/z4cfj6+mZ6HY8ePQIAODk5Kc1zcnJCcnIynjx5gkqVKuVI/ZyK6+3btwgPD1eYFhwcrFYMREREREzGEBERFTI2Nja4du0agoODERoaijFjxqBLly7w9PRMs061atXUWkdMTAyAL02ivmZmZgYAiI6OzrH6ObXcVatWYcaMGWqvl4iIiCg1JmOIiIgKIZlMhvLly6N8+fJo2rQpmjRpAg8PD40t38DAAABUNn1KTEwEgHSH085u/Zxa7pAhQ9CxY0eFacHBwWjTpo3asRAREVHhxWQMERFR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7rvvIjg4GPv370fXrl1RoUIFTJgwQa/tF198gerVqyM6OjpPx+e07Z07d+Dt7Y2ffvoJf//9N44dO4ZZs2ahZ8+e8Pb2xrhx4wr2ohARERGB05RKtFdxC2xORyqZspva87JOX+JUJKLHqlSpgpCQEHz77bcYOXIkVCoVmjdvjrFjx6JMmTJ6bcuVKwdPT09oNJo8HZ/Ttq6urtiwYQMWL16MwMBAxMbGokKFCvjqq68wZMgQWFhYFOxFISIiIgKTMURERFSAKlasiIULFz633cyZMzFz5sw8H5+btu7u7pg9e3aO+iQiIiIqCJymRERERERERERUiJiMISIiIiIiIiIqRJymREZxbRZ6FXBtFiIiIiIiehVxZAwRERERERERUSFiMoaIiIiIiIiIqBAxGUNEREREREREVIiYjCEiIiIiIiIiKkRMxhARERERERERFSImY4iIiIiIiIiIChGTMUREREREREREhYjJGCIiIiIiIiKiQsRkDBERERERERFRIWIyhoiIiIiIiIioEDEZQ0RERERERERUiJiMISIiIiIiIiIqREzGEBEREREREREVIiZjiIiIiIiIiIgKEZMxRERERERERESFiMkYIiIiIiIiIqJCxGQMEREREREREVEhYjKGiIiIiIiIiKgQMRlDRERERERERFSImIwhIiIiIiIiIipETMYQERERERERERUiJmOIiIiIiIiIiAoRkzFERERERERERIWIyRgiIiIiIiIiokLEZAwRERERERERUSFSF3UA+SEjIwNLly7FgQMHkJmZiddffx3Dhw+HnZ1dUYdGRERERERERKTnlR8Z8+jRI7z99tv49ttv0bp1a/j5+WHt2rV4/fXXcf/+/aIOj4iIiIiIiIhIzyufjJk3bx6Cg4OxZcsWDBo0CL1798auXbtw7949jBkzpqjDIyIiKtGOHj0KHx8fWFpawtraGu3atcP58+cL5PiCaktERESU3175ZMzy5cvRsGFDeHt7K2Vly5ZFt27d8McffyA1NbUIoyMiIiq5QkJC8Pbbb8PT0xNRUVEIDw+HjY0NmjVrhvDw8Hw9vqDaEhERERWEVzoZ8+DBA1y9ehX16tUzqKtXrx4ePnyIc+fOFUFkRERENGbMGDg6OmLhwoVwcHCAo6Mjli1bhqysLEyePDlfjy+otkREREQF4ZVOxkRGRgIAnJycDOqcnZ312hhz7949nD9/Xu8nLCysYIIlIiIqQR48eID9+/ejQ4cOUKv/t1+Ara0tWrdujQ0bNkCr1ebL8QXVloiIiKigvNLJmIyMDADQ+zClo9FoAADp6enZHr9w4ULUqlVL76dr164FEisREVFJcuHCBWi1Wnh5eRnUeXl5ISkp6ZlTgnJzfEG1JSIiIioor/TW1ra2tgCAlJQUg7rk5GQAeOb21sOHD0f37t31yi5cuIAePXpwhAwRUT5yc3ODhYVFUYdBhSg2NhYA4ODgYFBXqlQppU3VqlVf+PiCamvMvXv3DHZrvHDhAgAU6GeHR/FRBdY3PR8Xdy4cqdE3ijqEEu38+dJFHUKJEP5AijqEEi2jEN7Pc/q595VOxri6usLMzMzoN1g3bjx+M/fw8Mj2eCcnJ4MpTroPUhwhQ0SUf/7991/UrFmzqMOgIiBi+KFTV2ZiYpKvxxdU2yctXLgQU6dONVrHzw7FV62tM4s6BKICV2tOUUdAVAg21yrwU+T0c+8rnYxRq9Vo2bIl/v77b2RlZUGlUil1e/fuhZubG9zc3HLVp4+PDzZu3Ij09HT06NEDGzduhLu7e36H/soJCwtD165deT3+i9dDH6+HIV4Tfbl9L6ZXX9myZQEA8fHxBnW6sjJlyuTL8QXV1hhjo2oTExNx5coV1K5dG+bm5tkeW1Lx/ZBKAt7nVBLwPs+ZnH7ufaWTMQDw5ZdfomXLlvjuu+8wfvx4AMC6detw+PBhLFu2LNf9OTg4oEuXLspwVHd3d36b+wReD328Hvp4PQzxmlBJVaNGDZiamuLSpUsGdRcuXICdnR1cXV3z5fiCamuMsVG1ANC4ceNsj6HH+H5IJQHvcyoJeJ/nj1c+GePj44MVK1bg448/xh9//AErKyucPXsWX331Ffr371/U4REREZVIDg4OaNWqFbZu3YqMjAxlYf2EhATs27cPfn5+MDX93z4CWq0WWq1WWZQ/N8cXVFsiIiKiglIsPm307dsX0dHR+OWXXzB79mxER0djwoQJRR0WERFRiTZjxgzExcVh8ODBuHv3Lm7fvo2+ffvCzMwMU6ZM0Wvbt29faDQaRERE5On4gmpLREREVBCKRTIGACwtLdG4cWM0a9YM9vb2RR0OERFRiVevXj0cPHgQkZGR8PDwQJ06dWBiYoLDhw8bTAVSqVRQqVR6i+fm5viCaktERERUEF75aUoFxdHREZMnT4ajo2NRh/JS4PXQx+uhj9fDEK8J0WMNGzbE7t27n9tu5cqVWLlyZZ6PL8i29GL4fkglAe9zKgl4n+cvEzG2tyMRERERERERERWIYjNNiYiIiIiIiIjoVcBkDBERERERERFRIWIyhoiIiIiIiIioEDEZQ5QDWq0WmZmZ4BJLRERERERE9KKYjHnK0aNH4ePjA0tLS1hbW6Ndu3Y4f/58UYdVoBITE7Fo0SI0a9YMpUqVgr29PRo1aoTVq1cbTT5otVrMmjULbm5uUKvVKFeuHEaPHo2HDx8WQfQFLzw8HA4ODtBoNFi6dKnRNsuXL0fNmjWh0WhQtmxZDBkyBHFxcYUcacFKTU3F1KlT4enpCTMzM1StWhVTpkxBSkqKQdvt27ejUaNGMDc3h52dHbp3746bN28WQdQFIzMzE/Pnz4e3tzdsbGxga2uL+vXrY8mSJUZfM8ePH0fLli2V95W2bdvi3LlzRRA5EVHBEBFkZma+Mv0WVv/0ctFqtcjKyirqMApdSX3c9HLJy31Y3N+jmYx5QkhICN5++214enoiKioK4eHhsLGxQbNmzRAeHl7U4RWYuXPnYvTo0ejWrRvCwsJw69YtBAQEoG/fvhg1apRB+zFjxmDy5MmYM2cOHj16hPXr12PVqlUICAgogugLllarxQcffABbW9ts2/z0008YOHAgPvnkE6SkpODvv//G4cOH8c477xSbN4+UlBS8/fbb2LJlC5YvX47U1FQcO3YMGo0GO3bs0Gu7Y8cOdOrUCW3btsWDBw9w/vx53L9/H82bN8eDBw+K6BHkr5EjR+LTTz/F0KFDER0djYiICPj7+2PIkCGYMmWKXtvTp0+jZcuWqFq1KqKionDz5k2UKlUKzZs3x7Vr14rmARBRsZaZmVnof3itXLkSGo0GYWFhuT72WR+2X6TfnCjo/unlMnz4cJQpU6aowygUIoKJEyeiQoUKMDMzwxtvvAEAHOn9gjIzM5UfJrhyZ/To0bC2ts5R2z179qBu3bqwtLSEhYUFLl++XMDRFREhRatWraRixYqSkZGhlCUmJoqdnZ307du3CCMrWMuWLZOLFy8alPfu3VtMTU3l/v37StmNGzdEpVLJl19+qdd25cqVAkCCgoIKPN7CNHPmTHFwcJDly5cLAFmyZIlefXJystjZ2Unv3r31yg8ePCgAZNmyZYUZboH59NNPpUyZMhITE/Pctp6entKwYUO9slu3bolKpZJx48YVVIiFysbGRpo2bWpQXrNmTalcubJeWdu2baVcuXKSnp6ulCUnJ4uDg4MEBAQUeKxEVLKsXbtWAIidnZ2kpKQU2nl1vyevXr2a62MXLVokAOTGjRsGdStXrhSVSiVhYWH5EKWhF4mbDIWEhEifPn2kYsWKolarxd7eXry9veWzzz6TK1euFHV4MnToULG3ty+y8xfm9fnzzz8FgOzZs0e0Wq2IiBw9elQAyIYNG/L1XCVFVFSUABATExNRqVRiamoqVlZW8uabb8qaNWuKOryX3meffSbm5ubPbZeQkCAODg7y4YcfSlpaWiFEVnQ4Mua/Hjx4gP3796NDhw5Qq9VKua2tLVq3bo0NGzZAq9UWYYQFp3///vDy8jIod3Nzg1arxe3bt5WyzZs3IysrC126dNFr26VLF5iammLdunUFHm9h+ffffzFx4kTMmTMHr732mtE2+/btQ2JiosH1aNasGcqUKVMsrkdqaip++eUX9O7d+7nfJl24cAGXL182uB4VK1ZEgwYNisX1AAAHBwej7wdarRalSpVS/p+YmIi9e/eiffv20Gg0Srm1tTXatGmDjRs38lsVIspXS5YsQcWKFZGYmIi//vqrqMN5YX379kVmZibc3NyKOhR6jvnz56Nhw4bQarXYuHEjUlJSEBERgenTp2P//v3o3r17UYdYpAr7+hw6dAhlypRB69atYWJikq99l3TDhw9XRsZcvHgRFSpUQO/evfH7778XdWjFwrlz5xAfH493330XZmZmRR1OgWIy5r8uXLgArVZrNCnh5eWFpKSkYj1V6Wkigq1btyprg+jo1rl4+jrZ29vjtddew9mzZws1zoKSnp6OPn36oGnTphgwYEC27bK7HiYmJvD09CwW1yMkJAQpKSlwdHREjx49YGdnB41GA29vb6xcuVKvbXbXQ1d29epVPHr0qFDiLkgzZszAP//8gzlz5iAmJgb37t3DpEmTcP36dXz99ddKu4sXLyIrKyvb65GamsqpSkSUb27evIm9e/diwoQJaNGiBX799Vej7SQXc/B1bXM7JP9558jMzIRWq1V+ACArK0s5l/x3GkVuYs2PuClv9u7di08//RQjRozAb7/9hvr168PMzAw2Njbo0KEDjh8/jl69eint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fvst2zatW7fGiRMn8NFHH8HV1TUXj5Ty4scff0RwcDCysrKUaQxUvKSkpGDFihVGpwbSy+mzzz6Dl5cXEhISjK7lUhhUKhV27NihLCpc0pmI/Hd1JiIqcuvXr1dWwffy8kKtWrXg7e0NNzc3bNiwoVBiuHLlit5Cjl26dIFGoymUcxMRUfFz//593Lt3D56enkYTMC9qxYoVGDJkCGJiYp65UwyVDCdOnMCMGTOe2Ub3hRcRUVHiyBiil8i7776r9/+0tDRcvHgR3bp1K7QYPDw84OHhUWjnIyKi4s3R0RGOjo4F1v/Jkyfh7+/PRAwBAMqXL49evXo9s42Xl1chRUNElD2OjCF6iaWkpGDHjh14/fXXUbly5aIOh4iIiIiIiPIBkzFERERERERERIXItKgDICIiIiIiIiIqSZiMISIiIiIiIiIqREzGEBEREREREREVIiZjiIiIiIiIiIgKEZMxRERERERERESFiMkYIiIiIiIiIqJCxGQMEREREREREVEhYjKGiIiIiIiIiKgQMRlDRERERERERFSImIwhIiIiIiIiIipETMYQERERERERERUiJmOIiIiIiIiIiAoRkzFERERERERERIWIyRgiIiIiIiIiokL0/3Bc3qlsSdOcAAAAAElFTkSuQmCC",
+ "text/plain": [
+ ""
+ ]
+ },
+ "metadata": {},
+ "output_type": "display_data"
+ }
+ ],
+ "source": [
+ "z_cut = 25 # plane intersecting four sphere centres\n",
+ "fig, axes = plt.subplots(1, 2, figsize=(9.5, 3.6), constrained_layout=True)\n",
+ "\n",
+ "masked_labels = np.ma.masked_where(ccl_spheres.labels[z_cut] == 0, ccl_spheres.labels[z_cut])\n",
+ "axes[0].imshow(spheres[z_cut], origin=\"lower\", cmap=\"Greys_r\", alpha=0.25)\n",
+ "axes[0].imshow(masked_labels, origin=\"lower\", cmap=\"tab10\", interpolation=\"nearest\")\n",
+ "axes[0].set_title(rf\"Connected components ($z = {z_cut}\\;\\mu$m, $N = {psd.num_particles}$)\")\n",
+ "axes[0].set_xlabel(r\"$x\\;[\\mu\\mathrm{m}]$\")\n",
+ "axes[0].set_ylabel(r\"$y\\;[\\mu\\mathrm{m}]$\")\n",
+ "\n",
+ "methods = [\n",
+ " \"Analytical\\n\" + r\"$8 \\cdot 4\\pi R^2 / V$\",\n",
+ " \"Cauchy–Crofton\\n(ssa_corrected)\",\n",
+ " \"Raw voxel faces\\n(ssa)\",\n",
+ "]\n",
+ "values = [sv_exact, ssa.ssa_corrected, ssa.ssa]\n",
+ "colors = [\"#2b5c8f\", \"#3b8bc2\", \"#d95f02\"]\n",
+ "bars = axes[1].bar(methods, values, color=colors, width=0.52)\n",
+ "axes[1].axhline(sv_exact, color=\"#2b5c8f\", ls=\"--\", lw=1.0)\n",
+ "axes[1].set_ylabel(r\"Specific surface area $S_V\\;[\\mu\\mathrm{m}^{-1}]$\")\n",
+ "axes[1].set_title(\"Voxel staircasing vs. Cauchy–Crofton correction\")\n",
+ "axes[1].bar_label(bars, fmt=\"%.4f\", padding=3, fontsize=9)\n",
+ "axes[1].set_ylim(0, max(values) * 1.18)\n",
+ "\n",
+ "plt.show()"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "02-microstru-08",
+ "metadata": {},
+ "source": [
+ "## Percolating Backbone and Through-Thickness Porosity Profiles\n",
+ "\n",
+ "In heterogeneous porous media, part of the void space can be trapped in disconnected cavities that contribute to bulk porosity $\\varepsilon$ without carrying steady-state flux. Combining `connected_components()` with `through_thickness_profile()` separates dead-end volume from slice-to-slice porosity variations."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": 6,
+ "id": "02-microstru-09",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2026-11-18T09:55:12.024411Z",
+ "iopub.status.busy": "2026-11-18T09:55:12.024225Z",
+ "iopub.status.idle": "2026-11-18T09:55:12.040113Z",
+ "shell.execute_reply": "2026-11-18T09:55:12.039433Z"
+ }
+ },
+ "outputs": [
+ {
+ "name": "stdout",
+ "output_type": "stream",
+ "text": [
+ "Pore components: 120 (largest spanning network holds 99.43% of pore volume)\n"
+ ]
+ },
+ {
+ "data": {
+ "text/html": [
+ "Metric Value Direction z Slices 64 Profile (min / mean / max) 0.3450 / 0.3993 / 0.4399
"
+ ],
+ "text/plain": [
+ "ThroughThicknessResult(direction='z', num_slices=64, profile=array([0.43994141, 0.40380859, 0.39990234, 0.41723633, 0.41894531,\n",
+ " 0.39331055, 0.40087891, 0.42407227, 0.42993164, 0.43652344,\n",
+ " 0.4206543 , 0.40917969, 0.39599609, 0.39379883, 0.3918457 ,\n",
+ " 0.38110352, 0.3996582 , 0.40527344, 0.40576172, 0.40600586,\n",
+ " 0.40014648, 0.41064453, 0.40600586, 0.40014648, 0.38232422,\n",
+ " 0.36767578, 0.36694336, 0.38378906, 0.37915039, 0.38745117,\n",
+ " 0.40283203, 0.42529297, 0.43286133, 0.42480469, 0.40087891,\n",
+ " 0.3918457 , 0.40356445, 0.39868164, 0.40185547, 0.39013672,\n",
+ " 0.37451172, 0.38793945, 0.38476562, 0.37036133, 0.3449707 ,\n",
+ " 0.37182617, 0.4050293 , 0.42578125, 0.43041992, 0.43164062,\n",
+ " 0.40234375, 0.39501953, 0.38916016, 0.39428711, 0.38964844,\n",
+ " 0.37939453, 0.37182617, 0.37133789, 0.39477539, 0.40649414,\n",
+ " 0.40576172, 0.38842773, 0.40478516, 0.40551758]), positions=array([ 0.25, 0.75, 1.25, 1.75, 2.25, 2.75, 3.25, 3.75, 4.25,\n",
+ " 4.75, 5.25, 5.75, 6.25, 6.75, 7.25, 7.75, 8.25, 8.75,\n",
+ " 9.25, 9.75, 10.25, 10.75, 11.25, 11.75, 12.25, 12.75, 13.25,\n",
+ " 13.75, 14.25, 14.75, 15.25, 15.75, 16.25, 16.75, 17.25, 17.75,\n",
+ " 18.25, 18.75, 19.25, 19.75, 20.25, 20.75, 21.25, 21.75, 22.25,\n",
+ " 22.75, 23.25, 23.75, 24.25, 24.75, 25.25, 25.75, 26.25, 26.75,\n",
+ " 27.25, 27.75, 28.25, 28.75, 29.25, 29.75, 30.25, 30.75, 31.25,\n",
+ " 31.75]))"
+ ]
+ },
+ "execution_count": 6,
+ "metadata": {},
+ "output_type": "execute_result"
+ }
+ ],
+ "source": [
+ "cubic = oi.datasets.two_phase_cubic()\n",
+ "h_um = 0.5\n",
+ "\n",
+ "pore_ccl = oi.connected_components(cubic, phase=1)\n",
+ "largest_share = pore_ccl.volumes.max() / pore_ccl.volumes.sum()\n",
+ "print(\n",
+ " f\"Pore components: {pore_ccl.num_components} \"\n",
+ " f\"(largest spanning network holds {largest_share:.2%} of pore volume)\"\n",
+ ")\n",
+ "\n",
+ "prof_z = oi.through_thickness_profile(cubic, phase=1, direction=\"z\", voxel_size=h_um)\n",
+ "prof_z"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "02-microstru-10",
+ "metadata": {},
+ "source": [
+ "## Directional Tortuosity and Non-Cubic FIB-SEM Voxels\n",
+ "\n",
+ "`oi.tortuosity_all()` evaluates steady-state transport across $(x, y, z)$ in a single call, returning `None` for any non-percolating axis when `strict=False` (the default).\n",
+ "\n",
+ "Tomographic instruments such as focused-ion-beam SEM (FIB-SEM) frequently acquire images with coarser slice milling spacing $h_z$ than in-plane pixel pitch $(h_x, h_y)$. Passing a 3-tuple `voxel_size=(dz, dy, dx)` scales the finite-volume face conductances $A_d / h_d$ properly: doubling $h_z$ from $0.5\\;\\mu\\mathrm{m}$ to $1.0\\;\\mu\\mathrm{m}$ elongates the sample along $z$, reducing relative lateral detour cost for $z$-transport ($\\tau_z$ drops) while penalising $z$-plane detours during $x$- and $y$-transport ($\\tau_x, \\tau_y$ increase)."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": 7,
+ "id": "02-microstru-11",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2026-11-18T09:55:12.042280Z",
+ "iopub.status.busy": "2026-11-18T09:55:12.042101Z",
+ "iopub.status.idle": "2026-11-18T09:55:34.899741Z",
+ "shell.execute_reply": "2026-11-18T09:55:34.899192Z"
+ }
+ },
+ "outputs": [
+ {
+ "name": "stdout",
+ "output_type": "stream",
+ "text": [
+ "Direction X: tau_iso = 3.3103, tau_aniso(dz=2*dx) = 4.4490\n",
+ "Direction Y: tau_iso = 3.3684, tau_aniso(dz=2*dx) = 4.5367\n",
+ "Direction Z: tau_iso = 3.3977, tau_aniso(dz=2*dx) = 2.2957\n"
+ ]
+ }
+ ],
+ "source": [
+ "tau_iso = oi.tortuosity_all(cubic, phase=1, voxel_size=(0.5, 0.5, 0.5))\n",
+ "tau_fib = oi.tortuosity_all(cubic, phase=1, voxel_size=(1.0, 0.5, 0.5))\n",
+ "\n",
+ "for d in (\"x\", \"y\", \"z\"):\n",
+ " print(\n",
+ " f\"Direction {d.upper()}: tau_iso = {tau_iso[d].tortuosity:.4f}, \"\n",
+ " f\"tau_aniso(dz=2*dx) = {tau_fib[d].tortuosity:.4f}\"\n",
+ " )"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": 8,
+ "id": "02-microstru-12",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2026-11-18T09:55:34.902434Z",
+ "iopub.status.busy": "2026-11-18T09:55:34.902258Z",
+ "iopub.status.idle": "2026-11-18T09:55:35.178564Z",
+ "shell.execute_reply": "2026-11-18T09:55:35.177317Z"
+ }
+ },
+ "outputs": [
+ {
+ "data": {
+ "image/png": "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onNTB22HSVrkZFVaqZWcXVC9pFdJK6SDhUm1KsOIiIiIiKhhqFXSa8OGDXjxxRchCILi2KZNm7B//35WeBFRvfGwM8e0EF9MC/FFTkExDA1EMBUbajss0iJHpfbEpKxC+DtXfR35To8O3LmRiIiIiEiv1DhDlZeXh9dffx39+vXDvn37cOLECbz11ls4cuQIdu3aVQchEhFVzcLEiAkvUk16VWOYvSAISMkpqfTiPC8iIiIiIr1S40qvy5cvw9LSErt374apqSkAoHv37khNTcWxY8cQGhqq8SCJiIiqQ6W9MavqpFduoQT5RbKdPx25cyMRERERkV6pcaVXYmIi2rVrp0h4yYWEhCAxMVFjgREREdWUcqVXcjUqvVJKWhsBtjcSEREREembGie9JBJJmYQXAJiamqK4uFgjQREREdWGk8pMr6qTXsk5pWvY3khEREREpF9qNcg+KSkJx44dUzkWFhZW7nEnJye0atWqtvERERFVm7WZEYwNDVAokda80ovtjUREREREeqVWSa8TJ06gd+/e5V725PERI0bg999/r83NEBER1YhIJIKjpTEeZuQrdmWsTIpSYsyRlV5ERERERHqlxkmvdu3a4euvv672en9//5reBBERUa05WpngYUZ+tdobU3I404uIiIiISF/VOOnl5+eHuXPn1kUsREREapPP9UrJKYAgCBCJRBWuVW6B5EwvIiIiIiL9UuNB9kRERLpM3qZYJBGQkVdU6VrO9CIiIiIi0l9MehERkV5xtCpNXlXV4phSsnujlYkRTMWGdRoXERERERHVLya9iIhIrzgptSkmVbGDo7zSi/O8iIiIiIj0D5NeRESkVxytSpNeVe3gmKxIenGeFxERERGRvmHSi4iI9IqjcqVXJe2NUqmA1JL2Rs7zIiIiIiLSP0x6ERGRXnFSqfSqOOmVnlcEqSD7npVeRERERET6h0kvIiLSK8qVXsmVVHqlKCXEHDnTi4iIiIhI7+hs0ismJgYTJ06Eh4cHXF1dMXjwYFy9erVa183IyMCXX36JHj16wNXVFf7+/hg+fDiOHTtW4XX+/PNPPPvss2jSpAkCAgLw2muvISUlRTN3hoiI6o21qRGMDWX/vFVW6aU85J7tjURERERE+kcnk16PHj1C165d8ejRIxw5cgQXLlyAo6MjQkJCcP369Sqvv3TpUqSmpuLjjz/GjRs38Mcff0AsFqN379749ddfy6xfvHgxpk2bhjFjxuDSpUs4duwY/Pz88Omnn9bF3SMiojokEokULY6V7d6YojTknu2NRERERET6x0jbAZRn5cqVSE1NxdatW+Hs7AwA+OGHH3Ds2DEsXLgQhw4dqvT6X3/9tcrPTk5O+PXXX3Ho0CF88803GD9+vOKyv//+G6tWrcKhQ4fwzDPPKI7PnTtXg/eIiIjqk6OlMeLT85CcVfHujcrtjQ5sbyQiIiIi0js6Wem1Y8cO9OjRQ5HwAgCxWIxhw4bhn3/+qVXboZGREUxMTCAWi1WOf/rpp2jVqpVKwouIiBo2+VyvlJwCSOXT6p+QklNYZj0REREREekPnUt6PXz4EElJSQgMDCxzWcuWLSGVSnHjxo0anTMtLQ2LFy9GRkYG3nrrLcXxoqIinDp1Cu3atcO7776LwMBA2Nvbo02bNvjss88glUrVvj9ERFT/5O2NRRIBGXlF5a5JVm5v5EwvIiIiIiK9o3PtjcnJyQAAOzu7MpfJj8nXVKV58+aIjY1FXl4e7OzssGPHDvTv319xeWJiIgoKCrB9+3a0aNECP/74I7y8vLB9+3a88cYbuHXrFjZs2FDh+RMTE5GUlKRyLCIiolqxERFR3VHZwTG7AHblJLXk7Y0GIsDWnEkvouooKirCw4cPYWZmplKRT0RERKSLdK7SS04kElV4TBDKb1V50pUrV/Do0SNcvXoVgwYNQmhoKLZs2aK4XCKRAJD9Abdt2zZ07doV7u7ueO211zBt2jT8+OOPuH37doXnX7t2LYKCglS+hg0bVoN7SUREdcFRaUZXRcPs5e2N9hbGMDQo+28OEZU6fPgwpk+fDk9PT/j4+GDmzJnaDomIiIioSjqX9JJXc2VkZJS5LD09HQBgb29frXOZm5vDxsYGbdq0webNm9GuXTvMnTtX0bYoP4+rq2uZdsq+ffsCAM6dO1fh+efMmYObN2+qfO3atatasRERUd1xsjJVfJ+UVUHSqyQZ5mDBeV5EVfn222/RrVs3hIeHw9DQUNvhEBEREVWLzrU3enh4wNbWFnfu3ClzmfxYq1atanxekUiE9u3b48KFC0hKSoKLiwssLS3RtGlTFBaW3d3LyEj20FQ218vZ2Zml/UREOki50kt5dpeylJLj3LmRqGp//PGHtkMgIiIiqjGdq/QSiUQYOnQojh8/jszMTMVxqVSKPXv2oFu3bnB1da3Vua9evQo7Ozs4Ojoqjo0YMQIPHz5ETEyMytr//vsPANCpU6da3RYREWmPo5XqTK8n5RdJkFVQDABw4M6NRERERER6SeeSXgDw9ttvw8jICNOmTUNaWhry8/OxePFiREVF4eOPP1ZZ+95778HS0hJnzpwBABQUFGDo0KE4ceIEMjMzIZVKcf/+fcycORPnzp3DypUrVcryFy1aBDc3N0yZMgXR0dEoKirC9u3bsW7dOkycOBFBQUH1et+JiEh9TkpJr/LaG1NzuHMjEREREZG+07n2RgDw8/PDsWPH8Prrr8PFxQUAEBwcjH379iEkJERlbUFBAXJychRD6U1MTPDSSy/h448/xtmzZ5GZmQkTExM89dRT2L17N4YMGaJyfUdHR5w8eRILFixAy5YtUVBQgCZNmmDx4sVYunRp/dxhIiLSKCsTIxgbGaCwWFpupVeKUsujcoKMiDSPu10TERGRtuhk0gsA2rZti3///RdSqRSCIFQ4NHXZsmV48803YW5urjg2YMAADBgwAIAsKWZiUvkbGh8fH+zcuRMAUFhYCGNjfupPRNSQiUQiOFmaID49r9ykV3JO6TFWehHVrbVr1+Ldd9/VdhhERETUCOlke6MyAwODSncJMjY2hqWlJQwMyr8rVSW8yjsf1Y/Fixfj/fffV/wcGxuLkSNH4tSpU1qMquG4dOkSRo4ciXv37mk7FBULFy7Eli1banSdt99+Gxs2bKijiKixks/1Kq+9UbnSizO9iOoWd7smIiIibdHZSi9quIqLi7Fjxw5cvHgRiYmJ8PT0ROfOnTFo0CDFrpgA8M8//6hsKpCRkYGdO3di5MiR2gi7wXn06BF27tyJhQsXolmzZgCAVatWIT4+Hl999ZVWYtq3bx++/vpr3L17t0bXCw4OxrRp0/Dcc8+hSZMmdRQdNTZOJbsypmQXQioVYGAgUlyWolT9xd0bieoWd7smIiIibdH5Si9qWGJiYtCqVSu8/vrrsLS0xLPPPgtjY2PMmjUL3t7eSE9Pr/C6Xl5e2LFjR5m5bVS+jh07YseOHQgICFAcO336NA4ePKi1mJYsWYKxY8fC29u7RtcbNWoUXFxcVCr/iNTlWFLBVSwVkJFXpHJZitIge0cLVnoREREREekjVnqRRsl32bx9+zb8/PwUx+fNm4cxY8YgPz+/wutaW1uzyqsGXF1dderxOnXqFK5du4bPP/+8xtcViUSYMGECvvzyS3z00UewtLSsgwipsVHZwTG7AHZKs7uSWelFVCMJCQnIy8tT/Jybm4vo6GgAgIODA6ysrLQUGREREVHFmPQijbp69Sp8fHxUEl6A7A/iffv2QSQSVXBN2Uyv1157Da+99hqefvppxfHi4mL88ccfOH78OLKyshAYGIhp06YpdvaUO3jwIPbv34+kpCS4ublh3Lhx6NChQ5Uxz5kzBwEBAZg5cya+++47XL58GS4uLpg6dSpatWqlslYQBOzevRuHDh1CWloavLy8MH78eLRu3VqxJj09HTNmzMDUqVPRsWNHfPfdd7h9+zZefvllxf36+++/sX//fqSkpMDDwwNjxowpE+vDhw/x008/4d69ezA1NUX79u0xadIkxZy6S5cu4cMPP8SHH36IZs2a4Y033sCFCxeQlZWlkgxbv349XnzxRQwfPhzjx48vc3+mTZuGli1b4o033qj0cbp//z527tyJO3fuICcnB7a2tvD398frr78OANi2bRusrKzQq1cvlevFx8dj/vz5FZ533bp1cHR0xPPPP4/33nsP+/btw5gxYyqNhag6HJVmdSVnFSDApfRNuXyml6nYAObGFc+NJCKZRYsW4fjx4wAADw8P3L17V/F6v2LFCkyePFmL0RERERGVj+2NpFFNmzZFbGys4tNfZSYmJpVuFCCf6RUbG6s4lpKSgi5dumD27Nmws7NDnz59kJ2dje7du+PRo0cAZEmxESNGYPjw4TAxMcGzzz6L/Px8dOnSBevWrasy5v379+O///5DaGgoMjIy0KNHD1y/fh3t27fH33//rVgnkUgQGhqKMWPGwMrKCn379kVkZCTatWuncjv5+fnYuXMnjh8/jpEjR8Lc3BwtWrTA48ePIQgCJk6ciOeffx7Gxsbo168f4uPj0alTJ3z22WeKc4SHhyMwMBDHjx9Ht27d0L59e1y8eBFdu3ZVrJHP9EpJSQEA9O/fH+7u7rCyssLYsWMVX7a2tkhOTsbbb78NQRBU7vvBgwexadMmuLm5VfoYbd++Hc2bN8eFCxfQtWtXPPfcc3B3d1eZ3XXs2DF06tSpzKYSRkZGKvGMHTsWnTp1wq5du3Dq1Ck4ODgAANq0aQMzMzMcPXq0yv9nRNWhnPRKemIHx5SS3RsdLEwqTcYTkcxPP/2E6Ojocr+Y8CIiIiJdxUov0qgVK1bg5MmTaNu2LcaOHYvu3bujffv2CAwMrNX5XnrpJYSHh+PGjRto2rSp4vibb76p2NVz1apV+PPPP3Hs2DH06NEDAPDCCy/Aw8MDr7zyCp577jl4eXlVejv79u3Dvn370KdPHwDA9OnT0bdvX0ydOhXR0dEwNTXF999/j127dmHHjh2KSqrp06dj6tSpmDdvHp555hmVCreNGzfi5s2bioq0/Px8/PLLL9iyZQs2btyIF154AQAwbdo02NvbY9GiRXj22WcRHByMn3/+GSKRCPv371ckkWbMmIHHjx9XeB/69euHNWvWIDMzs0zb45w5czB69GgcOHAAAwcOVBxfu3YtbG1tERoaWunj88MPP6Bly5b47bffyr1cEATcvn0bXbp0KXOZi4uLSjy3bt3C/Pnz4eLigsOHDysSDmKxGJ6enggLC6s0FqLqUmlvfGIHx+QsWaWXI1sbiYiIiIj0FpNeOmTGTxcQk5Kr7TAUvB3MsX5Kpxpdp2PHjrhz5w5+/PFHHD16FH/88QeSkpLg5eWF5cuXY9q0adU+V0ZGBv744w9Mnz5dJeEFQGV2yIYNG9ClSxdFwktuxowZeOutt/DXX39h3rx5ld5W06ZNFQkvADAwMMDcuXMxcuRIHDt2DAMGDMC2bdvg4eGBESNGqFz39ddfx6ZNm7Bjxw68+eabiuODBg1SacE0NTXFtm3bYG9vj0mTJpU5x5o1a/Dbb78hODgYpqamyM7Oxt9//41BgwYp1rm6ulZ6PyoyfPhwuLm54dtvv1UkvR48eID9+/dj1qxZMDMzq/T6H330EWbMmIGgoCA0a9YMwcHBWLFiheLyjIwMFBcXw97evtLzXL58Gf3794elpSX++eefMv9fHRwckJSUVKv7SPQk5YRWcnbp4HpBEEorvSw5xJ6IiIiISF8x6aVDYlJycS8xW9thqM3NzQ1Lly7F0qVLAQDXrl3DggULMH36dBgYGCgqnKoSFRUFiURSaZVYcXExoqKiIJVKMXbsWEX7niAIEAQBIpEIDx48qPK2npxBBgD+/v4AZLOsACA6Ohr+/v5lWqGaNWumsq6yc0ZHR6Np06aKKjU5Hx8fGBsbK84xd+5cHDx4EIMHD4a7uzt69uyJZ555BmPHjoWpqWmV9+dJRkZGePHFF/Hee+8hJiYG3t7e+O677yCRSDB9+vRKr5uXl4f3338fmZmZmD17Nry9veHr66uyRt62WlBQUN4pAMgG3Q8aNAhNmjTBkSNH4O7uXmZNQUFBre4fUXkclSq9lAfXZ+YXo0gie61wsGClFxERERGRvmLSS4d4O5hrOwQVmoqnTZs22LlzJxwcHLB58+ZqJ73kA9tzcnIqXGNgYABDQ0P4+vqWu5PhmDFjFEmpyuTmlq2wkx+Tx2FsbKyyc1VF6+TK28mqonMUFhaiqKhIcQ57e3ucOnUK169fx7Fjx3Ds2DHMnj0bK1euxPnz56usqCrPzJkz8f777+P777/HO++8gw0bNqBt27Zo3759pddbvnw5Tpw4gRs3bqBJkyblrjE3N4eVlZVivtiTjhw5gmHDhqFZs2Y4dOgQnJycyl2XkpKCFi1a1OyOEVXAysQIJkYGKCiWqrQ3pqjs3MhKLyIiIiIifcWklw6paSuhLvr3339V2gTlLCwsIBaLkZ1d/Uq2gIAA2NnZ4eTJkxWuMTAwQKdOnZCYmIgRI0bUeiD1jRs3UFhYqDJo/8KFCwCAdu3aKf574MABZGdnw9LSUrHu3LlzKusq065dO2zduhUpKSmKAe4AcP78eQiCUOYcrVu3RuvWrfHKK69gz549eP7557Fnzx5MmTKl3PMbGRlBKpWWe5mbmxuGDRuG9evXo3nz5khISFBU41Xm4MGD6NatW4UJL7lOnTrhxo0bZY7/9ddfGDNmDNq3b4/9+/fD1ta23OunpaXhwYMHHIhMGiMSieBoaYL49DyVSq+UnNJWR870IiIiIiLSX9y9kTRq/vz5mD17tkrFj1QqxQcffID8/HwMGzas2ucyMjLC//73Pxw8eLDMLox79uxBYmIiAOCdd95BeHg4lixZgqKiIsUaiUSC3377DVFRUVXelqWlJVauXKn4OTo6Gp988gm6d++uSES98soryMnJweLFixWJpeTkZPzvf/+Dh4cHRo8eXeXtzJ07F8XFxVi4cCEkEgkAID09HYsWLYKzszMmTpwIANi6davKzohAacWbo6Njhef39PTE48ePK2wzfPnll5GYmIh58+bBxMQEEyZMqDJmKysrXL58GQkJCSrH4+PjVX7u168fbt68iczMTMWxrVu3YuTIkQgJCcHhw4crTHgBwOnTpyEIAp555pkqYyKqLnmLo0rSS6XSi0kvIiIiIiJ9xUov0qhXXnkFa9asgbu7O7p06QIzMzOEhYUhOTkZCxcuxKJFi2p0voULF6KwsBALFizAZ599Bn9/f9y7dw+tWrVCr169AAD9+/fHjh078Oqrr2LTpk0IDg5Gbm4uIiIi0Lt373Irz57UqVMnmJqaIigoCK6urjh//jyaNWuGrVu3KtaEhIRg48aNmD9/Pg4cOAA/Pz9cvHgRbm5u+Pvvv2FhYVHl7bRv3x6//vor5syZAz8/PzRv3hyXL1+Gvb099u/fDzs7OwCyoffDhw+HVCpF06ZNkZaWhhs3buCNN95QGWz/pJkzZyraFgMDA2FgYIDff/9dcXmvXr3QqlUrhIWFYdy4cYrbq8xnn32maE3s3LkzjIyMFLPJ9u3bp1g3ZcoULFu2DL///rtiw4J58+ZBIpHAzMysTHVav379MHv2bMXPv/32GwICAhASElJlTETV5WQpT3oVQioVYGAgUhlq72DB9kYiIiIiIn3FpBdp1IsvvogXX3wRcXFxiIiIQEZGBpydndGmTRuYm6vOCFu1apVKO6GXlxd27NiBLl26qKz73//+h1deeQUXLlxAfn4+AgMD4ePjo7ImNDQUQ4cOxbVr1xAfHw8HBwcEBgZWK6mjfDsTJ07E9evX4ezsjI4dO8LAQLUYcvLkyRg5ciQuXLiAjIwMeHp6om3btiptlXZ2dtixYwfatm1b7u2MGjUKQ4YMwcWLF5Gamgp3d3e0a9dO5baGDx+OYcOG4e7du4iMjIS1tTWCgoJUKqU6duyIHTt2ICAgQHEsMDAQcXFxOH/+PDIyMhSD/ZX16dMHYWFhVQ6wl+vcuTMePHiAS5cu4fHjxzAzM4OXl1eZWWlubm4YM2YM1q9fj2nTpqGoqKhMhZ6yVq1aKb5PT0/Hn3/+iY8//rjWLapE5XGykr3GSKQC0vOKYG9hjBTlpBcrvYiIiIiI9BaTXlQnPDw84OHhUemaJyuwrK2tyx1GD8jaD3v37l3p+QwNDdG+ffsqB7NXxsvLC15eXpWuMTc3R8+ePSu83MTEpML7IWdqalplRZNIJELz5s3RvHnzci93dXUt93asra3Rr1+/Cs+7d+9e+Pj4VKsCTk4sFpdJRpbn/fffR4sWLXDo0CE8++yzVT4Ocp999hk8PDwwc+bMasdEVB2Olqo7ONpbGCMlp6Dcy4mIiIiISL9wphdRI3LkyBHcv38f8+fPr5OKKm9vbxw+fFhlSH91hISE4M8//4SREfPwpFlOVkpJr5IdHJUrvezMWelFRERERKSv+A6TqBH4559/sHr1ahw9ehTdunXDnDlz6uy2ajOTq3///nUQCZFqJVdSyQB7+VB7GzMxjI342Q8RERERkb5i0osavW+//Rb29vbaDqNO+fn5YfLkyXjjjTfQrVu3MrPKiPSVStJLXumVU1hyGau8iIiIiIj0GZNe1OgNHDhQ2yHUOR8fnzLD/4kaA5X2xpK2xpSSSi8HzvMiIiIiItJrLPcgIiK9pVzNlZRVgGKJFGm5RWUuIyIiIiIi/cOkFxER6S1LEyOYlMztSs4uQGpu6RB7BwtWehERERER6TMmvYiISG+JRCJFi2NydoHKzo0OrPQiIiIiItJrTHoREZFekw+zT8p6MunFSi8iIiIiIn3GpBcREek1edIrJacQSdn5pcctWOlFRERERKTPmPQiIiK9Jm9vlEgFRCbmKI6z0ouIiIiISL8x6UVERHrNSWl21+3HmYrvOdOLiIiIiEi/MelFRER6zdGqtKIr/FFW6XHu3khEREREpNeY9CKN+v333yESiSASibBly5Zy14wYMUKxpjHJy8vD4sWL4enpCRMTE7Ro0QKrV6+u1nWLioqwdetWPPvss3B2doaNjQ3atGmDTz75BHl5eWXW37x5E8OGDYOdnR3MzMzQoUMHbN26tdxz12QtUUPkpNTGGJ8u+30xMhDB2sxIWyEREREREVE9YNKL6oSFhQU2bdpU5nhKSgr27t0LCwuL+g9Ky0aPHo3Nmzdj27ZtyMjIwHvvvYdFixbhnXfeqfK6Bw4cwNGjR7FkyRLcvXsXUVFRmDdvHpYsWYKRI0eqrL116xa6du2KzMxMnD17Fg8fPsTEiRMxYcIEfPfdd7VeS9RQKVd6yTlYGje6xDsRERERUWPDpBfVidDQUPz777+IjY1VOb5lyxaIxWIMGDBAS5Fpx6FDh7B371588sknePrpp2FqaopRo0Zh7ty5+PDDD/Ho0aNKrz9kyBB8//336NmzJ2xtbeHg4IAZM2Zg0qRJ2L9/P+Li4hRrV6xYgeLiYmzduhXNmzeHnZ0dXnvtNYwaNQqLFi1CdnZ2rdYSNVSO5QysdyVHV8sAACweSURBVGBrIxERERGR3mPSi+rE0KFDYWNjg82bN6sc37hxI0aNGgVLS8tyrxcXF4fp06fDzc0NxsbG8PX1xdtvv43CwkLFmr179yraI0UiESwsLNCpUyf89NNPKuf69NNPIRKJ8PjxYyxevBjOzs6wsLDA4MGDVZJE9WHnzp0wMDDA888/r3I8NDQUhYWF+Ouvv2p1XrFYDJFIBDMzM8Wxs2fPonnz5nBxcVFZ26tXL2RmZuLvv/+u1VqihsqxnIH1HGJPRERERKT/mPSiOmFiYoJx48apJKKuXr2Kq1ev4oUXXij3OjExMejYsSPCw8Oxe/dupKWlYcOGDdi0aRPGjx+vWDd48GAIggBBECCVShEZGYmRI0di2rRp+PPPP8ucd+nSpQgKCsK9e/dw7NgxXLt2rcIYlF28eFEluVbZ15dfflnpua5fv44mTZrA2tpa5XhgYCAA4MaNG1XGoywjIwNbt27F5s2b8cYbb8DBwUFxmVQqLfc6giAAAK5du1artUQNlaWJEUzFqv/clVf9RURERERE+oVTfHVMv379yj3eokULrFmzBgBw7tw5LFmypNx1kyZNwpQpUwAA33zzTblJIAD4+uuvFQmXKVOmID4+XuXyI0eO1Cp+ZS+88ALWrl2LU6dO4emnn8bGjRvRtGlT9OjRAxs3biyz/q233kJBQQF2794NR0dHAECfPn2wZs0aDBs2DGfPnkWXLl1UriMSieDq6orFixfjyJEj+P777zF8+HCVNX5+fpg0aRIAoFOnTnjjjTcwf/58REVFoWnTpmrfz+pISUmBra1tmePyY8nJydU6z6uvvoqvvvoKgOy+z58/Hx988IHKmg4dOuDAgQNITEyEs7Oz4viJEycAAElJSbVaS9RQiUQiOFqaIC6tdNMHBwtWehERERER6TtWelGd6dSpE1q1aoVNmzahsLAQv/76K1544YUKh0fv2bMHvXr1UiS85Pr27QsAOH78OABAIpHg008/Rbt27WBhYaGotjpy5AgiIiLKnHfQoEEqPwcFBQEAoqKiKo2/Y8eOioqyqr5effXVKh+PyoZmV3eg9pdffglBEJCQkIANGzZg/fr1GDp0qKIyCwCWLFkCqVSKCRMm4N69e0hPT8dXX32lSIAaGhrWai1RQ/ZkZZcDK72IiIiIiPQeK710THUqrDp37lytdS+//DJefvnlKtc9OQtLk6ZMmYKVK1eiR48eSElJweTJk8tdl5OTg+zsbPz1118wMjJSJHHkSSVAVi0FAIsXL8bq1auxbt06DBo0CI6OjjA0NMTw4cNx5cqVMudu0qSJys/yFsP09HRN3c0qOTg4lBnqrxyDvb19jc7n7OyMqVOnIi0tDQsWLMCBAwcwcOBAALJk3fHjx7Fs2TK0b98eEokEnTp1wo4dOzB06FC4u7srzlOTtUQNmZPVk0kvVnoREREREek7VnpRnZo0aRJycnIwf/589OnTB97e3uWuMzc3h5mZGSZMmIDi4mJIJBJIJBJIpVJF4mvVqlUAgM2bNytmeLm4uCiqke7fv1/uuatbRfUkTc70Cg4OxqNHj5CZmalyPDw8HADQunXrWsUov96TVWtdunTBoUOHkJWVhdzcXBw/flyxGUCPHj1qvZaooXqy0qu84fZERERERKRfmPSiOuXq6ooBAwYgLS2t0uHxIpEIgwcPxuHDh5GWllbleU1MVN/AXr9+HdevX1c33DoTGhoKqVSK3bt3qxz/448/IBaLy+zqWF3nz58HUDoQvzLffPMNOnTogO7du2t0LVFD4PREkouD7ImIiIiI9B+TXlTn9u7dC0EQMHHixErXrVq1CgYGBhg0aBBOnjyJrKwsJCQk4MiRIxgxYoSidfH555/H9u3bcfDgQeTk5ODkyZOYOXMmevbsqdG4NTnTa8CAARg4cCAWLVqEU6dOIT8/Hzt27MCaNWvw5ptvws3NTbH26tWrEIlEKuecO3cu1q5di7t37yI/Px9xcXH46quvsGLFCgwePBi9e/dWrH3w4AGmTJmCa9euoaCgAHfu3MGECRNw69Yt/Pzzzypx1WQtUUNWtr2RSS8iIiIiIn3HmV6kM3x8fHD58mWsXLkSkydPRnx8PJycnNC6dWvMmjULbdq0AQB88cUXMDIywpQpU5CdnY3OnTvjhx9+wPvvv19hi6Mu+P3337F8+XKMGTMGiYmJ8PX1xUcffYT58+dXed0333wTa9asQWhoKCIjIyEWi9GyZUusWrUKL730kkoLp6enJwYMGIDp06cjLCwMDg4OGDhwIC5dugQPDw+V89ZkLVFDVmaQPXdvJCIiIiLSeyJBeds3UltYWBiCgoJw8+ZNtGrVStvhEBERgAvRqRi17gwAwNLECDff7a/liIgat/r4eylo0pd1cl5dts97u7ZDqHfeK09rO4Q6x+dy49AYnssAn8+NhS49n9neSEREes9JqdKLOzcSERERETUOTHoREZHec1Sa6cXWRiIiIiKixoFJLyIi0nsWxoZwLkl8+TpaajkaIiIiIiKqDxxkT0REek8kEuHrce1w6FYCpj7to+1wiIiIiIioHjDpRUREjULnpg7o3NRB22EQEREREVE9YXsjERERERERERHpHSa9iIiIiIiIiIhI7zDpRUREREREREREeodJLyIiIiIiIiIi0jtMehERERERERERkd5h0ouIiIiIiIiIiPQOk15ERERERERERKR3jLQdABERERHpvnv37mHTpk2Ijo6Gi4sLxo8fj44dO2o7LCIiIqIKsdKLiIiIiCp14MABBAcHIyoqCgMHDoRUKkXXrl3x3XffaTs0IiIiogqx0ouIiIiIKpSTk4MXXngBzzzzDLZu3QoAmDhxIsRiMebPn48BAwbA29tby1ESERERlcVKLyIiIiKq0N69e5GQkIBZs2apHJ89ezYKCgqwefNmLUVGREREVDkmvYiIiIioQufOnQMAdOjQQeW4n58fbG1tcfbsWW2ERURERFQltjdqWEFBAQAgIiJCy5EQERFRQ+Tn5wdTU1Nth6EQFxcHAHB2di5zmYuLC+Lj4yu9fmJiIpKSklSO3bp1C0Dd/r2Un/6ozs6tq+6a52o7hHqXHRam7RDqHJ/LjUNjeC4DfD43FvXxfK7u30tMemlYbGwsAGDYsGHaDYSIiIgapJs3b6JVq1baDkOhsLAQIpEIhoaGZS4Ti8XIz8+v9Ppr167Fu+++W+5l/HtJs57VdgDa8H2QtiOgOsDnMukTPp/rRnX/XmLSS8N69uyJXbt2wdPTEyYmJho5Z0REBIYNG4Zdu3bB399fI+fUZ3y8aoaPV83xMasZPl41w8er5vTtMfPz89N2CCosLS0hCALy8/PLfKKak5MDBweHSq8/Z84cjBo1SuVYZmYm7t69i+DgYI39vdTY6dvvATVefC6TPuHzue5U9+8lJr00zNbWFkOHDq2Tc/v7++vUJ7+6jo9XzfDxqjk+ZjXDx6tm+HjVHB+zutGsWTMAQExMDJo3b644XlxcjIcPH6JLly6VXt/Z2bnc1siuXbtqNlACwN8D0h98LpM+4fNZezjInoiIiIgq1LdvXwDAsWPHVI6fOnUKBQUFeOaZZ7QQFREREVHVmPQiIiIiogqFhITg6aefxqpVq5CSkgJAtnHP8uXL4e3tjXHjxmk5QiIiIqLyMelFRERERJXasWMHXFxc0Lx5cwwZMgTNmzfHo0ePsG/fPp3aaZKIiIhIGWd6NQBOTk5Yvnw5nJyctB1Kg8DHq2b4eNUcH7Oa4eNVM3y8ao6PWd1r0qQJTp8+jevXryMmJgbOzs7o1KkTDAz4+amu4O8B6Qs+l0mf8PmsfSJBEARtB0FERERERERERKRJ/HiOiIiIiIiIiIj0DpNeRERERERERESkd5j0IiIiIiIiIiIivcOkFxERERERERER6R3u3qjDrl+/jl9++QXx8fHw9PTEpEmT0KpVK22HpZNWrFiB69evlznepEkTfP3111qISLdER0djx44dOH/+PJo2bYqPP/64wrXx8fHYsGED7t69Czs7O4SGhqJ37971GK325eTkYN++fdi3bx9ycnKwevVquLm5lVm3ZcsW/Pnnn+WeY/PmzTA3N6/rUHVCREQE/vzzT9y+fRvm5uYIDg7G5MmTYWpqWu76c+fOYdu2bUhMTISvry+mTp0KPz+/eo5ae3JycrBz505cvnwZGRkZaNq0KcaPH1/uY/DGG2/g/v37ZY4HBATggw8+qI9wdcK9e/ewc+dO3LlzB+bm5mjZsiUmTZoEa2vrMmsFQcD27dtx5MgRFBYWol27dpgxYwYsLS21EDlR3Vm6dCmio6Oxbt26Ms/v69evY8WKFQgNDcX48eO1FCFR9Rw7dgxr1qzBjBkzMGDAgDKXR0dH44033kDfvn0xe/ZsLURIVD1JSUl46aWXqlzXr18/PpfrESu9dNQvv/yCDh06ICMjAwMHDkRSUhLatWuHnTt3ajs0nXTixAlcunQJY8eOVfkaNGiQtkPTuuHDh6NPnz5ISkrCsWPH8M8//1S49uLFi2jVqhVOnz6N/v37w9bWFgMGDMDy5cvrMWLt+vnnn+Hr64udO3ciKSkJO3fuRGZmZrlrb9y4gZ07d2L06NFlnntisbieI9eORYsWISAgAMePH0e3bt3g7++Pzz77DM2aNcPNmzfLrF+9ejWefvppAMDAgQNx7949BAcHV/q81CenT59GkyZNsGLFCri5uaFHjx64fv06AgMD8cUXX5RZf/jwYdy9e7fM8+uZZ57RQvTasXLlSowdOxY5OTno3bs3mjZtitWrV8PHxwfnz59XWSuRSDBs2DDMnTsXLVq0QI8ePbBp0ya0b98eCQkJWroHRHXj+eefx7Zt2/D666+rHM/Ly8O4ceNw6dIlDB48WEvREVVf9+7dER8fjylTpiAxMVHlMqlUiilTpuDo0aMYOnSoliIkqh4LC4syf7Mpf4WHh2Pnzp2IiIjQdqiNi0A65/Hjx4KFhYUwY8YMleMTJ04UbG1thdTUVC1Fprv69u0rtGnTRtth6KTw8HDF997e3kKHDh3KXSeVSoWWLVsKHTp0ECQSieL4l19+KYhEIuH8+fN1HqsuiImJEXJycgRBEIQlS5YIAFQeQ2WLFy8WAAhFRUX1GaJOmTJlirBz506VYykpKYKzs7PQrVs3leP37t0TxGKx8Oabb6ocHzBggODu7i7k5eXVebza9ueffwovvvhimfv6wgsvCAYGBsK9e/dUjrdp00bo27dvfYaoc+Li4socS05OFiwtLYWePXuqHF+3bp0AQDh27JjiWEpKimBvby9MmDChrkMlqndLly4VAAj79u1THJszZ45gaGgo/Pfff1qMjKhm7t27J1hYWAhDhgxROf7xxx8LAITff/9dS5ERacZXX30lABACAwOFzMxMbYfTqLDSSwdt27YNOTk5mDVrlsrx2bNnIz09Hb///ruWIqOGqEWLFtVad/r0ady6dQszZsyAgUHpS8P06dNhZGSE9evX11WIOsXLy6vRtCVqwldffYXQ0FCVY/b29ujWrRvOnDmD4uJixfGffvoJRUVF5b62xcfH4++//66XmLWpd+/e+P7778u0fg4ePBhSqRSnTp3SUmS6y93dvcwxBwcHeHl5laneWr9+PZo3b46ePXsqjtnb22P06NHYsWMHMjIy6jxeovq0bNkytGvXDtOnT0dKSgr27duHtWvXYsmSJYqqWqKGQF4pvmfPHvzwww8AZBX1b7/9Nl544QWMGDFCyxES1d6xY8ewYMEC2NjYYNeuXbCystJ2SI0Kk1466Ny5czA0NESbNm1Ujnfo0AEikQhnz57VUmS67fHjx3jxxRcxfvx4LFq0iG8ea+jcuXMAZM8zZZaWlmjevDmfd5V45ZVXMG7cOMybNw+7du2CVCrVdkj1xsbGptzjd+/ehaWlJYyMSkdHnjt3Dvb29vDx8VFZ27FjRwBoFM+xih6vO3fuAABsbW3LXBYZGYnp06djwoQJWLJkCS5dulSXITYIp0+fxt27d1XeBBUWFuLq1atlXsMA2XOssLAQly9frs8wieqcWCzG5s2bkZaWhsmTJ2PatGno0qUL3n77bW2HRlRjs2bNwuDBg/H6668jPDwcEydOhJubG1avXq3t0IhqLSYmBqNHj4ZUKsWvv/6KgIAAbYfU6DDppYPi4uJgb29fZiaQqakprK2tER8fr6XIdJdYLEbv3r3Rrl07hISE4M6dOwgJCcHLL7+s7dAajLi4OACAi4tLmctcXFz4vCuHSCRC37590bRpUzzzzDMoKCjAyJEj0bdvX+Tk5Gg7PK356aefcOvWLUyYMEHleFxcXIXPLwCN9jmWkJCAzz//HC4uLmVmdZmamqJnz5546qmn0KVLF5w/fx4dO3ZslG9o58+fjxEjRqBbt24YNGgQPvvsM7z33nuKyx8/fozi4mI+x6jRCQoKwnvvvYf9+/cjLy8PW7ZsUfnAgaghWb9+PczMzPDUU0/h5s2b+Pnnn1kVQw1WXl4ehg8fjqSkJKxcuRLPPfectkNqlPgvog4qLCys8I8VsViM/Pz8eo5I923evBlOTk6Kn+fMmYOlS5fi/fffR/fu3TF27FgtRtcwFBYWAkC5zz0+78r3+uuvqzzvpk2bhoEDByI0NBTLly/Hp59+qsXotOPKlSt4+eWX4e3tXWZ3wcLCwnJbR42MjCASiRrlc6ygoACjRo1Camoq/vzzzzKPz549e1SeY/PmzcPs2bOxcuVK9OzZE/369avvkLVm0KBBSE9Px4MHD7B+/Xp88cUX6Natm6JSsKrXMACN8jlGjYO8ZVosFsPMzEzL0RDVnouLCz777DNMnjwZc+bMQUhIiLZDIqq16dOn48qVKxg1ahTeeustbYfTaLHSSwdZWloiNze33Mtyc3P5aUc5lN8Uyi1evBgikYg7XlaTfLvz8p57OTk5fN6Vo7zn3fDhw9G8efNG+by7ffs2BgwYAEtLSxw8eBB2dnYql1f02pabmwtBEBrdc6y4uBijR4/GyZMnsXr16nJ3pSrvOfbmm28CQKN7jj377LMYPXo0Fi5ciEuXLsHIyEjRLgBU/RoGoNE9x6hxuHnzJhYtWoT+/fujqKgIM2bM0HZIRGrx9fVV+S9RQ/TJJ59g69ataN26NTZu3KjtcBo1Jr10ULNmzZCRkVFm4G5SUhJyc3PRrFkzLUXWsFhZWcHCwgKpqanaDqVBkD+vYmJiylwWExPD510NuLq6NrrnXWRkJPr27QsA+Pfff9G8efMya5o1a4b4+HhIJBKV4/LnXGN6jkkkEkyYMAG7d+/G559/jrlz51b7uq6urgDQ6J5jyiwsLDBo0CDcv38fDx48ACCrDrCysqrwNQxoXM8xahwKCgowfvx4ODo6YuvWrfj888+xf/9+fP/999oOjYio0Tp8+DDeeust2NvbY9euXbCwsNB2SI0ak146SP7G8dixYyrH//33XwAoM/OFynf37l1kZ2fD399f26E0CBU97yIjI/HgwQM+76qpoKAAYWFhjep5FxMTgz59+qCoqAj//PMPWrZsWe66vn37Ij8/v8zA+sb22iaVSjF16lRs374dn376KV577bUaXV8+jL0xPcfKk5ycDAMDA8XmACKRCH369MHp06cVrY5y//77L5ycnMpsEEPU0C1atAhhYWH4+eefYWdnhxkzZmDQoEFYsGABoqKitB0eEVGjExkZiTFjxgAAfvvtN1Ys6gKBdE5hYaHQokULoX379kJ2drYgCIKQkZEhBAcHC+3atRMkEomWI9Qtt2/fFv766y9BKpUqjiUlJQk9evQQjI2NhatXr2oxOt3i7e0tdOjQocLLR48eLTg4OAj3798XBEEQJBKJMHr0aMHW1lZITEyspyh1x5IlSwQAQnh4eJnL8vPzhW+//VbIz89XOfbiiy8KAISff/65PkPVmocPHwp+fn6Ck5OTcOPGjUrXZmdnC+7u7kLv3r2FgoICQRAEITExUfDx8RH69u1bH+HqhJkzZwoAhE8//bTSdZcvXxYOHTqkciwuLk5o166dYGlpqfg91Xdff/21kJubq3Js//79grGxsTBy5EiV4//9959gYGAgrFixQnHs2LFjgqGhofDJJ5/US7xE9eXAgQOCSCQSFi9erHL80aNHgoODgxASEsK/GalBOnnypACAr9vU4GRlZQlBQUECAOGzzz7TdjhUgoPsdZBYLMbu3bsRGhqKgIAAtG/fHhcvXkSTJk3w559/wsCABXrKbGxs8Msvv+Dll19Gs2bNIJVKcfnyZTg5OWHv3r2N/pP9devW4ciRIwBkLbKZmZkYOXIkANn8KeUd9n744QeMHTsWrVu3Rvfu3REREYGcnJwyw7T1WVhYGJYvX674HpDtGmdlZQUHBwd89913AABDQ0OEhYXBz88PXl5esLKywrVr11BUVIS1a9di4sSJWrsP9WnmzJmIjIxE27Zt8c4775S5/Pvvv4e9vT0AWUva3r17MXLkSAQEBCAoKAhnz55FYGAgtm7dWs+Ra8dvv/2G77//HnZ2djhz5ozid1Fu4sSJGDZsGADA1tYWy5Ytw4wZMxAQEID8/HxcvnwZPj4+OHToEHx8fOr/DmhBbGwsWrRogSZNmsDR0RFRUVGIjIzEpEmT8NVXX6msffrpp7FhwwbMmzcPu3fvhq2tLU6ePImXX34ZCxYs0NI9INK8pKQkvPDCC2jfvr3KLqaArAX622+/xejRo/Hpp59i0aJFWoqSiKhx+eeff3Dz5k2YmJjg9OnTOH36dLnr/Pz88PHHH9dzdI2XSBAEQdtBUPkEQcClS5fw8OFDeHh4oF27dhCJRNoOS2clJyfj5s2byMrKgo+PD4KCgvh4Abh06RLu379f7mUtWrRAUFBQmeN37tzB3bt3YWdnh86dOyt2PmsMkpKScPz48XIvMzc3L7PVcHZ2Nm7evInExES4uLigXbt2MDY2ro9QdcLx48eRlJRU4eWDBg0qs5OYRCLBhQsXkJiYCF9fXwQHB9d1mDojOjoaFy9erPDy4ODgMvPQEhISEBYWhtzcXPj5+SEwMLCuw9Q5eXl5uHXrFuLj42Fra4s2bdoo2hrLk5WVhXPnzqGwsBBt27aFm5tbPUZLVPfu3r2L69evo3PnzvD09Cx3zd9//w2JRILBgwfXc3RE6klJScHRo0fRunVrBAQEaDscomp7+PBhhYkuZfb29ujTp089REQAk15ERERERERERKSH2CdHRERERERERER6h0kvIiIiIiIiIiLSO0x6ERERERERERGR3mHSi4iIiIiIiIiI9A6TXkREREREREREpHeY9CIiIiIiIiIiIr3DpBcREREREREREekdJr2IiIiIiIiIiEjvGGk7ACKi+nbz5k3cvXsXoaGhVa598OABzp8/j/79+8PKyqoeolPPjRs3cOfOHQCAoaEhhg8frpU4fv/9d8X3gYGBaNWqlVbiICIiIiKixotJLyLSqqioKFy+fFnxs5GREZycnNC+fXuYmZnVyW3+8ssv+PTTT1FcXKw4tnv3bnh6eqJdu3Yqa0+cOIFJkyYhPDwcLVq0qJN4NOmnn37CF198geHDh8PY2FhrSa9t27ZBEAT88ccfWLJkCVauXKmVOIiIiIjq0+DBgxEXF4erV69qOxQiApNeRKRlhw4dwksvvYTu3bvD2dkZ+fn5uHLlCrKzs/HJJ59g5syZGr/N4OBgjBgxQuXY5MmTMXbsWKxbt07luLe3N0aMGAFra2uNx1FXxGKxSqWVNvz+++8oLi6GWCzWahxERET6wtXVFQkJCVWue/nll7FmzZp6iEg39evXD+np6bh48aK2QyEiHcCkFxHphGXLlqFfv34AgPz8fAwdOhSzZs1CmzZt0LlzZ43e1oQJEzBhwoRqre3evTu6d++u0dsnIiIiqqnHjx+r/Lx06VK8//77uHHjBoKCgrQUFT1p79692g6BiJQw6UVEOsfU1BQLFizAoUOHsHv3bpWkV1paGi5duoT8/Hy0aNEC/v7+Za4vCAKuX7+O+Ph4ODk5oVWrVjA3N1dcrjzTq6ioCH/99ReKiooQFRWlqJBycnJCz549K53pFRkZidu3b8PExATt27eHvb29yuVXrlxBbGwsnn/+eeTm5uL06dMAgC5dusDS0rLKxyE2Nhbnzp0r9zITExMMGTKkynMoS0xMxIkTJ9CjRw84OzsrjsvbEFu0aIFWrVop7vOzzz4LCwsLnD17Fnl5eejatSssLCwAABKJBOfOnUN6ejq6du0KOzu7GsVCRERERERU17h7IxHpJHmCKScnR3Hs3XffRZMmTbBgwQJ8+umnaN26NQYMGIDk5GTFmqioKLRq1QoDBgzAmjVrMH/+fAQGBuLnn39WrPnll18wevRoAEBRURG2bduGoqIiREZGYtu2bdi2bRv+/fdfALKZXqNGjUJ8fLzi+ikpKXjuuecQFBSEVatWYeHChXBzc8OyZcsgCIJi3XfffYfJkyfjwoUL6NKlCz755BNMmTIFvr6+KnPMKnLp0iVFPPKvb775BqNGjcL7779f48f0r7/+wqhRo1QeUwC4d+8eRo4cifPnz6vc57Nnz6JHjx5Yvnw5XnzxRQQEBODOnTuIjY1FSEgI3n77bcydOxe+vr44e/ZsjeMhIiIizQoJCUFISAiioqIwaNAgWFlZYeTIkQCAGTNmQCQSQSQSwcDAAA4ODhgyZAiuXLlS7jliY2MxePBgWFhYwMXFBYsWLYJEIlFZe+7cOQwcOBDOzs6wsrJCx44dsX79epV18vPdu3cPzzzzDCwsLODm5obFixejsLCwzH34+eef0aFDB5iZmcHa2hrPPvsszpw5U6376e/vj3/++QeXLl1S3NeqPmiszuNy8+ZNWFhYYMyYMSrXvXz5MkxNTTFlyhTFscGDB6Nt27Y1fpyIqI4IRERa9O233woAhMOHD6scX7ZsmQBA2Lx5s8q6NWvWKNbcvHlTcHR0FPr06aM4Nnz4cKFVq1ZCfn6+4lhKSoqwfft2xc+LFy8WDA0NVW7PxsZGmDVrVpn4fv75ZwGAEB4erjjWv39/wd7eXrh+/bri2HfffScAEFavXq04NmvWLMHc3FyYPHmykJWVJQiCIGRkZAgBAQFC9+7dq/cAKYmPjxdatmwpWFlZCcePHy93zYIFCwQTE5NyL3vppZcEOzu7Msd//fVXAYBw7do1lfvcp08fISYmRhAEQcjNzRWCg4OFvn37CqNHjxbu378vCIIg5OXlCW3bthW6dOlS5rxFRUUCAGHJkiU1vq9ERERUuSVLlggAhBs3biiOPf3000Lbtm2FgQMHCqdPnxaSkpKEX3/9tcx1CwsLhbCwMGHYsGGCk5OTkJCQoHKOdu3aCaGhocLZs2eFzMxMYcOGDYJIJBK+/vprxbrExETB2tpamDJlivDgwQMhNzdXuHLlijBz5kzhwoULZWIaMGCAcO7cOSEjI0PYtm2bYGlpKYwfP14lro8//lgQiUTCO++8IyQkJAiRkZHCyJEjBbFYLBw9erRa97Nv375Chw4davWYVva4bN68WQAgfPnll4IgCEJqaqrg6+srBAcHCzk5OYp1gwYNEtq0aVPjx4mI6gaTXkSkVfJk1rJly4QdO3YIv/zyi/Dyyy8LRkZGQu/evYXCwkJBEAShWbNmKn9AyL3//vsCAOHKlSuCIAjCU089JXTr1q3S21Qn6RUWFiYAEJYvX15mbadOnQRvb2/Fz7NmzRIACJcuXVJZ99577wkAFImw6rh//77g5+cn2NvbC+fPn69wXWVJry5dugj9+vUr9zpmZmZCUVGRIAil91k5gScIgvDBBx8IAITPP/9c5fiqVasEAEJaWprKcSa9iIiI6k5FSS8AwsWLF6t1jszMTMHAwEBYt26dyjlEIpFw8+ZNlbW9e/cWgoODFT8fOHBAACCcO3eu0tuQxyT/W03uo48+EgAIly9fFgRBENLS0gRzc3MhNDRUZV1BQYHg6empksiq7H6qk/SSK+9xEQRBmDlzpiAWi4X//vtPGDx4sGBlZSXcuXNHZc2TSa/qPk5EVDfY3khEOuHo0aPYtm0bdu/eDQD49ddfcfjwYYjFYuTk5ODevXvlDrTv0qULACjaBSdNmoTTp0+jbdu2eO+993DixAkUFRVpLE55qXtFscTExCA1NVVxzMjICK1bt1ZZ5+XlBQCIi4ur1m3euXMH3bt3R05ODo4fP45OnTrVOG6JRILr16+jQ4cOZS67fPky2rRpAyMj1TGP7du3V/nZ3d290uPVvT9ERERUd9zd3cv99/7x48eYPXs2fHx8YGxsDJFIBGtra0ilUkRERKis9fHxQatWrVSOBQUFISoqSvFzixYtYGxsjFdeeQW7d+9GVlZWhTF5enqWafkbNmwYAChGSpw9exa5ubkIDQ1VWWdsbIznn38ely5dQnp6epX3s6Zq8risXr0awcHB6NevH/bu3Ysff/wRAQEBlZ6/Jo8TEWkek15EpBOWLVuG33//Hb/99hvWrFmDUaNGwdDQEAAU8x7kQ9SVyY8VFBQAAObOnYsTJ06gW7du+O2339CrVy+4urpi8+bNGomzJrHIjz2ZTDI2NgYg26WyKteuXUOPHj1gYGCAkydP1np3pjt37iA3N7fMH4eCIODy5cvl/tFoY2NTbtwVHa/O/SEiIqK6Jf8wSllxcTF69+6No0eP4qeffkJycjKkUimKi4thaGhY5gPCJk2alDmHtbU1cnJyUFxcDADw9vbGvn37IBaLERoaCltbW3Tu3Bnff/89pFKpynVdXFzKnE9+TD6bNSUlBQDg6upaZq38mHxNRfezpmr6uJiYmGDixP+3d28hUbVtGMevwWbMTDMmETUzNROlpGlDtBG1rMBA0LHsQI0QEqkTaZ9EkRodiIJGHQSBkqOR7ZDICFJGK0vIsonCiCIrkIhQEgWlvoMXh3fUaPyUjHn/v7N51j1r3es5WtzPLltDQ0OKiYkZV6CbyGT6CcD0o+gF4K8XEBCgefPm6c2bN+OujbZFREQ42xISEnT+/Hk5HA59/PhRFotFeXl5Lh9KYxkMBrdyWbx4sctzx+bi6+vrcjLiVLS3tyspKUkBAQFqa2ub8KRKd43OUBs7ytrR0aG+vr5pGSkFAAAzz2g0jmt78uSJXr9+reLiYiUmJsrf318Gg0E9PT0Tbqbu7ndRSkqKWltb9e3bN925c0dRUVHKz89XZWWlS1xvb++4/462mc1mSXKegu1O7K/ec7Im2y9dXV0qKirSmjVr1N3drZMnT7r1HHf7CcD0o+gF4K9nMBi0Y8cONTU1qbu729k+MjKic+fOKSgoSElJSZKkDx8+uPw3JCREqampGhkZcVl2OJbZbFZfX99vc9mwYYNCQ0N14cIFl9G/t2/fqrGxUZmZmc4ZalPR3NysLVu2aNGiRbLb7QoLC5vS/UaLXmNHLM+cOSNp/JJFAADgeby9vV1+T9dMeD8/P23dulU2m00LFiyQ3W53ud7T06Pnz5+7tN26dUuStHnzZknSunXr5OPjoxs3brjEDQ8Pq7GxUatWrVJAQMBvc/H19XWZde8Od/qlv79fmZmZCg8P1/3793X06FGVlpaqqanJ7ef8rp8ATL9Zvw8BgJl39uxZtbe3KyEhQYWFhZo/f75qa2vlcDh08+ZNzZ49W5K0a9cumc1mJSQkKDQ0VO/evVN5ebkyMjIUHR39y/uPfoBUVVUpODhYgYGBSkxMHBdnMplUU1OjtLQ0JScnKzs7W/39/aqoqFB0dLTKysqm/K5fvnxRamqqZs2apf3796u1tdXl+sqVKxUZGTmpez59+lRz5sxRdna29u3bp+HhYV25ckUOh0OSVFdXp8jISPn5+U05fwAA8HexWCwKCwtTSUmJYmNjFRgYqKtXr6qrq2tcwcddNptNdrtdu3fvVlxcnAwGg65du6avX78qOTnZJXbFihU6fvy4Tp06pZiYGDU1NamkpERZWVmyWCyS/pnZf+LECRUVFam0tFR79+7VwMCAjhw5ok+fPunSpUtu5bVs2TLdu3dPL1++dOY1Hf2yZ88eff78WY8fP9bcuXNVXFys9vZ2ZWdnq7Oz85cDlJPpJwDTj6IXgBkVFRUlq9U64V4P/2Y2m9XR0aHa2lo9fPhQQ0NDSklJ0eXLl50bw0vSgwcP1NTUpJaWFnV1dSkoKEg2m03btm1zxixfvlxWq9Xl/mVlZVqyZIk6Ojo0ODiouLg4JSYmKjw8XFarVf7+/s7YTZs26dWrV6qurlZbW5tMJpNOnz6tnJwcZ/FN+qc4NTg4OO5dwsLCZLVafzla2dvbq+3bt0uS7t69O+76v5dyuuvZs2cqKChQbGysWlpaZDabdfjwYYWEhKiqqkpGo9FZ8Bp957F7d/0q74ULF8pqtTqXJQAAgL+Lj4+Pbt++rcLCQq1evVre3t7KyMhQdXW1y5LBycjIyNDAwIAOHTokh8Mhg8GgpUuX6uLFi8rLy3OJ9fX1VUVFhQoKCvTo0SP5+/srPz9fJSUlLnHHjh1TcHCwKisrVVxcLKPRqLVr16q5uVkbN250K68DBw7oxYsXWr9+vfr7++Xr66vv379PqV/Ky8t1/fp11dbWOjf49/LyUl1dnSwWi3bu3Cm73T7hksvJ9BOA6Wf4+fPnz5lOAgAwPQ4ePKjKykrZbDZ5eXkpPT1d79+/V0REhGpqapSTk/NH8mhoaNCPHz+UlZWloqKicR+1AADgv2G0WNXW1jbDmQD4L2KmFwB4kPj4eKWlpam+vl4mk0np6enO/bzi4+P/WB719fWSJKvV+n+fOAkAAAAAU0HRCwA8SG5urnJzc13aOjs7ZTQaFRsb+8fyaGho+GPPAgAAAICJcHojAHi4efPmKT8/XyaTaaZTAQAAAIA/hj29AAAAAAAA4HGY6QUAAAAAAACPQ9ELAAAAAAAAHoeiFwAAAAAAADwORS8AAAAAAAB4HIpeAAAAAAAA8DgUvQAAAAAAAOBxKHoBAAAAAADA41D0AgAAAAAAgMeh6AUAAAAAAACPQ9ELAAAAAAAAHoeiFwAAAAAAADzO/wBtQraxiARb9gAAAABJRU5ErkJggg==",
+ "text/plain": [
+ ""
+ ]
+ },
+ "metadata": {},
+ "output_type": "display_data"
+ }
+ ],
+ "source": [
+ "fig, axes = plt.subplots(1, 2, figsize=(10.0, 3.6), constrained_layout=True)\n",
+ "\n",
+ "mean_eps = float(prof_z.profile.mean())\n",
+ "axes[0].plot(prof_z.positions, prof_z.profile, color=\"#1f77b4\", lw=1.6, label=r\"Slice porosity $\\varepsilon(z)$\")\n",
+ "axes[0].axhline(mean_eps, color=\"#333333\", ls=\"--\", lw=1.1, label=f\"Mean = {mean_eps:.3f}\")\n",
+ "axes[0].set_xlabel(r\"Position $z\\;[\\mu\\mathrm{m}]$\")\n",
+ "axes[0].set_ylabel(r\"Pore volume fraction $\\varepsilon$\")\n",
+ "axes[0].set_title(\"Through-thickness porosity profile\")\n",
+ "axes[0].legend(frameon=False)\n",
+ "\n",
+ "dirs = [\"x\", \"y\", \"z\"]\n",
+ "xpos = np.arange(len(dirs))\n",
+ "w = 0.34\n",
+ "axes[1].bar(\n",
+ " xpos - w / 2,\n",
+ " [tau_iso[d].tortuosity for d in dirs],\n",
+ " width=w,\n",
+ " color=\"#2b5c8f\",\n",
+ " label=r\"Cubic $(0.5, 0.5, 0.5)\\;\\mu$m\",\n",
+ ")\n",
+ "axes[1].bar(\n",
+ " xpos + w / 2,\n",
+ " [tau_fib[d].tortuosity for d in dirs],\n",
+ " width=w,\n",
+ " color=\"#e07b39\",\n",
+ " label=r\"FIB-SEM $(1.0, 0.5, 0.5)\\;\\mu$m\",\n",
+ ")\n",
+ "axes[1].set_xticks(xpos, [d.upper() for d in dirs])\n",
+ "axes[1].set_xlabel(\"Transport axis\")\n",
+ "axes[1].set_ylabel(r\"Tortuosity factor $\\tau$\")\n",
+ "axes[1].set_title(\"Sensitivity to non-cubic voxel pitch\")\n",
+ "axes[1].set_ylim(0, 5.8)\n",
+ "axes[1].legend(frameon=False, loc=\"upper right\")\n",
+ "\n",
+ "plt.show()"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "02-microstru-13",
+ "metadata": {},
+ "source": [
+ "## References\n",
+ "\n",
+ "1. J. Ohser and F. Mücklich, *Statistical Analysis of Microstructures in Materials Science*, Wiley (2000)."
+ ]
+ }
+ ],
+ "metadata": {
+ "kernelspec": {
+ "display_name": "Python 3",
+ "language": "python",
+ "name": "python3"
+ },
+ "language_info": {
+ "codemirror_mode": {
+ "name": "ipython",
+ "version": 3
+ },
+ "file_extension": ".py",
+ "mimetype": "text/x-python",
+ "name": "python",
+ "nbconvert_exporter": "python",
+ "pygments_lexer": "ipython3",
+ "version": "3.11.2"
+ }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}
diff --git a/tutorials/03_homogenisation_tensor.ipynb b/tutorials/03_homogenisation_tensor.ipynb
new file mode 100644
index 00000000..e105c7f7
--- /dev/null
+++ b/tutorials/03_homogenisation_tensor.ipynb
@@ -0,0 +1,555 @@
+{
+ "cells": [
+ {
+ "cell_type": "markdown",
+ "id": "03-homogenis-00",
+ "metadata": {},
+ "source": [
+ "[](https://colab.research.google.com/github/BASE-Laboratory/OpenImpala/blob/master/tutorials/03_homogenisation_tensor.ipynb)\n",
+ "\n",
+ "# Periodic Homogenisation and the $3\\times 3$ Effective Diffusivity Tensor\n",
+ "\n",
+ "Directional flow-through solves measure only the diagonal responses along the image axes $(x, y, z)$. When a material's principal transport axes are tilted relative to the tomography frame—such as cross-bedded sandstones, woven fibrous gas-diffusion layers, or obliquely aligned flake graphite—an applied gradient along $z$ induces a transverse flux along $x$ or $y$.\n",
+ "\n",
+ "Two-scale periodic homogenisation captures the full symmetric positive semi-definite tensor $\\mathbf{D}_{\\text{eff}} \\in \\mathbb{R}^{3\\times 3}$ by solving three periodic corrector cell problems on the unit cell $Y$:\n",
+ "\n",
+ "$$-\\nabla \\cdot \\Bigl(D(\\mathbf{x})\\bigl(\\mathbf{e}_k + \\nabla \\chi_k\\bigr)\\Bigr) = 0 \\quad \\text{in } Y, \\qquad D_{\\text{eff},ij} = \\frac{1}{|Y|} \\int_Y D(\\mathbf{x})\\left(\\delta_{ij} + \\frac{\\partial \\chi_j}{\\partial x_i}\\right)\\mathrm{d}V.$$"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": 1,
+ "id": "03-homogenis-01",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2026-11-18T09:55:36.106388Z",
+ "iopub.status.busy": "2026-11-18T09:55:36.106058Z",
+ "iopub.status.idle": "2026-11-18T09:55:36.113915Z",
+ "shell.execute_reply": "2026-11-18T09:55:36.112200Z"
+ },
+ "tags": [
+ "remove-cell"
+ ]
+ },
+ "outputs": [],
+ "source": [
+ "import sys\n",
+ "\n",
+ "if \"google.colab\" in sys.modules:\n",
+ " !pip install -q openimpala matplotlib"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": 2,
+ "id": "03-homogenis-02",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2026-11-18T09:55:36.116356Z",
+ "iopub.status.busy": "2026-11-18T09:55:36.116187Z",
+ "iopub.status.idle": "2026-11-18T09:55:36.541117Z",
+ "shell.execute_reply": "2026-11-18T09:55:36.540002Z"
+ }
+ },
+ "outputs": [],
+ "source": [
+ "import matplotlib.pyplot as plt\n",
+ "import numpy as np\n",
+ "import openimpala as oi\n",
+ "\n",
+ "plt.rcParams.update({\n",
+ " \"figure.dpi\": 120,\n",
+ " \"axes.spines.top\": False,\n",
+ " \"axes.spines.right\": False,\n",
+ " \"font.size\": 10,\n",
+ "})"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "03-homogenis-03",
+ "metadata": {},
+ "source": [
+ "## Recovering Principal Axes on a Tilted Periodic Laminate\n",
+ "\n",
+ "Construct a $48^3$ periodic two-phase laminate (`phase=1` with $D_1 = 1.0$, `phase=0` with $D_0 = 0.1$) whose layers are tilted in the $(x, z)$ plane with rational wavevector $\\mathbf{q} = (1, 0, -2)$ so that the structure wraps compatibly across all periodic boundaries. Because the sheets tilt at $\\theta = \\arctan(1/2) \\approx 26.6^\\circ$ from the $x$-axis toward $+z$, we expect:\n",
+ "\n",
+ "- Onsager reciprocity $D_{xz} = D_{zx} > 0$,\n",
+ "- decoupled out-of-plane Voigt transport $D_{yy} = \\frac{1}{2}(D_1 + D_0) = 0.55$,\n",
+ "- two in-plane eigenvalues bounded between the Reuss harmonic mean $D_\\perp = \\frac{2 D_0 D_1}{D_0 + D_1} = 0.1818$ and Voigt arithmetic mean $D_\\parallel = 0.55$."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": 3,
+ "id": "03-homogenis-04",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2026-11-18T09:55:36.543847Z",
+ "iopub.status.busy": "2026-11-18T09:55:36.543558Z",
+ "iopub.status.idle": "2026-11-18T09:55:38.275578Z",
+ "shell.execute_reply": "2026-11-18T09:55:38.274797Z"
+ }
+ },
+ "outputs": [
+ {
+ "data": {
+ "text/html": [
+ "Component Value D_xx 4.104837e-01 D_yy 5.500000e-01 D_zz 2.395923e-01 D_xy 0.000000e+00 D_xz 1.082553e-01 D_yz -5.534882e-28 Active VF 1.000000
"
+ ],
+ "text/plain": [
+ "EffectiveDiffusivityResult(tensor=array([[ 4.10483667e-01, 0.00000000e+00, 1.08255254e-01],\n",
+ " [-4.03896783e-28, 5.50000000e-01, -5.53488185e-28],\n",
+ " [ 1.08255254e-01, 0.00000000e+00, 2.39592302e-01]]), active_volume_fraction=1.0, solver_converged=True, iterations=(308, 0, 308), residuals=(9.620890300439452e-10, 0.0, 9.354431052231513e-10), corrector_fields={'x': array([[[ 0.00000000e+00, -3.37047331e-01, -4.22891842e-01, ...,\n",
+ " -4.39604929e-01, -2.36768772e-01, -8.35654376e-02],\n",
+ " [ 2.15136013e-08, -3.37047327e-01, -4.22891841e-01, ...,\n",
+ " -4.39604928e-01, -2.36768770e-01, -8.35654321e-02],\n",
+ " [ 2.90703153e-08, -3.37047323e-01, -4.22891839e-01, ...,\n",
+ " -4.39604928e-01, -2.36768769e-01, -8.35654283e-02],\n",
+ " ...,\n",
+ " [ 3.24874448e-08, -3.37047321e-01, -4.22891837e-01, ...,\n",
+ " -4.39604927e-01, -2.36768767e-01, -8.35654262e-02],\n",
+ " [ 2.90703152e-08, -3.37047323e-01, -4.22891839e-01, ...,\n",
+ " -4.39604928e-01, -2.36768769e-01, -8.35654283e-02],\n",
+ " [ 2.15136015e-08, -3.37047327e-01, -4.22891841e-01, ...,\n",
+ " -4.39604928e-01, -2.36768770e-01, -8.35654321e-02]],\n",
+ "\n",
+ " [[-2.36768781e-01, -8.35654319e-02, 3.13136149e-08, ...,\n",
+ " -8.20460841e-01, -6.17624682e-01, -4.39604935e-01],\n",
+ " [-2.36768775e-01, -8.35654300e-02, 3.18582476e-08, ...,\n",
+ " -8.20460840e-01, -6.17624681e-01, -4.39604932e-01],\n",
+ " [-2.36768771e-01, -8.35654277e-02, 3.30670493e-08, ...,\n",
+ " -8.20460839e-01, -6.17624680e-01, -4.39604930e-01],\n",
+ " ...,\n",
+ " [-2.36768769e-01, -8.35654258e-02, 3.44736034e-08, ...,\n",
+ " -8.20460839e-01, -6.17624679e-01, -4.39604928e-01],\n",
+ " [-2.36768771e-01, -8.35654277e-02, 3.30670495e-08, ...,\n",
+ " -8.20460839e-01, -6.17624680e-01, -4.39604930e-01],\n",
+ " [-2.36768775e-01, -8.35654300e-02, 3.18582471e-08, ...,\n",
+ " -8.20460840e-01, -6.17624681e-01, -4.39604932e-01]],\n",
+ "\n",
+ " [[-6.17624683e-01, -4.39604931e-01, -2.36768770e-01, ...,\n",
+ " -1.05722964e+00, -9.73664182e-01, -8.20460841e-01],\n",
+ " [-6.17624682e-01, -4.39604931e-01, -2.36768769e-01, ...,\n",
+ " -1.05722964e+00, -9.73664182e-01, -8.20460841e-01],\n",
+ " [-6.17624681e-01, -4.39604929e-01, -2.36768768e-01, ...,\n",
+ " -1.05722964e+00, -9.73664182e-01, -8.20460840e-01],\n",
+ " ...,\n",
+ " [-6.17624680e-01, -4.39604928e-01, -2.36768767e-01, ...,\n",
+ " -1.05722964e+00, -9.73664181e-01, -8.20460840e-01],\n",
+ " [-6.17624681e-01, -4.39604929e-01, -2.36768768e-01, ...,\n",
+ " -1.05722964e+00, -9.73664182e-01, -8.20460840e-01],\n",
+ " [-6.17624682e-01, -4.39604931e-01, -2.36768769e-01, ...,\n",
+ " -1.05722964e+00, -9.73664182e-01, -8.20460841e-01]],\n",
+ "\n",
+ " ...,\n",
+ "\n",
+ " [[-9.73664187e-01, -8.20460843e-01, -6.17624680e-01, ...,\n",
+ " -6.34337774e-01, -7.20182292e-01, -1.05722965e+00],\n",
+ " [-9.73664186e-01, -8.20460843e-01, -6.17624680e-01, ...,\n",
+ " -6.34337773e-01, -7.20182291e-01, -1.05722965e+00],\n",
+ " [-9.73664185e-01, -8.20460842e-01, -6.17624680e-01, ...,\n",
+ " -6.34337773e-01, -7.20182291e-01, -1.05722964e+00],\n",
+ " ...,\n",
+ " [-9.73664184e-01, -8.20460841e-01, -6.17624679e-01, ...,\n",
+ " -6.34337772e-01, -7.20182290e-01, -1.05722964e+00],\n",
+ " [-9.73664185e-01, -8.20460842e-01, -6.17624680e-01, ...,\n",
+ " -6.34337773e-01, -7.20182291e-01, -1.05722964e+00],\n",
+ " [-9.73664186e-01, -8.20460843e-01, -6.17624680e-01, ...,\n",
+ " -6.34337773e-01, -7.20182291e-01, -1.05722965e+00]],\n",
+ "\n",
+ " [[-7.20182296e-01, -1.05722965e+00, -9.73664187e-01, ...,\n",
+ " -3.37047321e-01, -4.22891839e-01, -6.34337776e-01],\n",
+ " [-7.20182294e-01, -1.05722965e+00, -9.73664186e-01, ...,\n",
+ " -3.37047320e-01, -4.22891839e-01, -6.34337775e-01],\n",
+ " [-7.20182293e-01, -1.05722965e+00, -9.73664186e-01, ...,\n",
+ " -3.37047320e-01, -4.22891838e-01, -6.34337774e-01],\n",
+ " ...,\n",
+ " [-7.20182291e-01, -1.05722964e+00, -9.73664184e-01, ...,\n",
+ " -3.37047319e-01, -4.22891837e-01, -6.34337773e-01],\n",
+ " [-7.20182293e-01, -1.05722965e+00, -9.73664186e-01, ...,\n",
+ " -3.37047320e-01, -4.22891838e-01, -6.34337774e-01],\n",
+ " [-7.20182294e-01, -1.05722965e+00, -9.73664186e-01, ...,\n",
+ " -3.37047320e-01, -4.22891839e-01, -6.34337775e-01]],\n",
+ "\n",
+ " [[-4.22891848e-01, -6.34337780e-01, -7.20182294e-01, ...,\n",
+ " -8.35654263e-02, 3.13136150e-08, -3.37047325e-01],\n",
+ " [-4.22891844e-01, -6.34337778e-01, -7.20182294e-01, ...,\n",
+ " -8.35654260e-02, 3.18582472e-08, -3.37047323e-01],\n",
+ " [-4.22891841e-01, -6.34337776e-01, -7.20182292e-01, ...,\n",
+ " -8.35654254e-02, 3.30670494e-08, -3.37047322e-01],\n",
+ " ...,\n",
+ " [-4.22891838e-01, -6.34337774e-01, -7.20182291e-01, ...,\n",
+ " -8.35654245e-02, 3.44736035e-08, -3.37047320e-01],\n",
+ " [-4.22891841e-01, -6.34337776e-01, -7.20182292e-01, ...,\n",
+ " -8.35654254e-02, 3.30670496e-08, -3.37047322e-01],\n",
+ " [-4.22891844e-01, -6.34337778e-01, -7.20182294e-01, ...,\n",
+ " -8.35654260e-02, 3.18582471e-08, -3.37047323e-01]]],\n",
+ " shape=(48, 48, 48)), 'y': array([[[0., 0., 0., ..., 0., 0., 0.],\n",
+ " [0., 0., 0., ..., 0., 0., 0.],\n",
+ " [0., 0., 0., ..., 0., 0., 0.],\n",
+ " ...,\n",
+ " [0., 0., 0., ..., 0., 0., 0.],\n",
+ " [0., 0., 0., ..., 0., 0., 0.],\n",
+ " [0., 0., 0., ..., 0., 0., 0.]],\n",
+ "\n",
+ " [[0., 0., 0., ..., 0., 0., 0.],\n",
+ " [0., 0., 0., ..., 0., 0., 0.],\n",
+ " [0., 0., 0., ..., 0., 0., 0.],\n",
+ " ...,\n",
+ " [0., 0., 0., ..., 0., 0., 0.],\n",
+ " [0., 0., 0., ..., 0., 0., 0.],\n",
+ " [0., 0., 0., ..., 0., 0., 0.]],\n",
+ "\n",
+ " [[0., 0., 0., ..., 0., 0., 0.],\n",
+ " [0., 0., 0., ..., 0., 0., 0.],\n",
+ " [0., 0., 0., ..., 0., 0., 0.],\n",
+ " ...,\n",
+ " [0., 0., 0., ..., 0., 0., 0.],\n",
+ " [0., 0., 0., ..., 0., 0., 0.],\n",
+ " [0., 0., 0., ..., 0., 0., 0.]],\n",
+ "\n",
+ " ...,\n",
+ "\n",
+ " [[0., 0., 0., ..., 0., 0., 0.],\n",
+ " [0., 0., 0., ..., 0., 0., 0.],\n",
+ " [0., 0., 0., ..., 0., 0., 0.],\n",
+ " ...,\n",
+ " [0., 0., 0., ..., 0., 0., 0.],\n",
+ " [0., 0., 0., ..., 0., 0., 0.],\n",
+ " [0., 0., 0., ..., 0., 0., 0.]],\n",
+ "\n",
+ " [[0., 0., 0., ..., 0., 0., 0.],\n",
+ " [0., 0., 0., ..., 0., 0., 0.],\n",
+ " [0., 0., 0., ..., 0., 0., 0.],\n",
+ " ...,\n",
+ " [0., 0., 0., ..., 0., 0., 0.],\n",
+ " [0., 0., 0., ..., 0., 0., 0.],\n",
+ " [0., 0., 0., ..., 0., 0., 0.]],\n",
+ "\n",
+ " [[0., 0., 0., ..., 0., 0., 0.],\n",
+ " [0., 0., 0., ..., 0., 0., 0.],\n",
+ " [0., 0., 0., ..., 0., 0., 0.],\n",
+ " ...,\n",
+ " [0., 0., 0., ..., 0., 0., 0.],\n",
+ " [0., 0., 0., ..., 0., 0., 0.],\n",
+ " [0., 0., 0., ..., 0., 0., 0.]]], shape=(48, 48, 48)), 'z': array([[[ 0.00000000e+00, 2.02228382e-01, 5.81007809e-01, ...,\n",
+ " 5.91035658e-01, 1.42061239e-01, 5.01392457e-02],\n",
+ " [-2.93961853e-08, 2.02228375e-01, 5.81007808e-01, ...,\n",
+ " 5.91035657e-01, 1.42061238e-01, 5.01392381e-02],\n",
+ " [-3.99726113e-08, 2.02228370e-01, 5.81007806e-01, ...,\n",
+ " 5.91035657e-01, 1.42061235e-01, 5.01392327e-02],\n",
+ " ...,\n",
+ " [-4.46779389e-08, 2.02228367e-01, 5.81007804e-01, ...,\n",
+ " 5.91035656e-01, 1.42061234e-01, 5.01392299e-02],\n",
+ " [-3.99726113e-08, 2.02228370e-01, 5.81007806e-01, ...,\n",
+ " 5.91035657e-01, 1.42061235e-01, 5.01392327e-02],\n",
+ " [-2.93961853e-08, 2.02228375e-01, 5.81007808e-01, ...,\n",
+ " 5.91035657e-01, 1.42061238e-01, 5.01392381e-02]],\n",
+ "\n",
+ " [[ 1.42061253e-01, 5.01392379e-02, -4.30836935e-08, ...,\n",
+ " 1.31045830e+00, 8.61483874e-01, 5.91035666e-01],\n",
+ " [ 1.42061244e-01, 5.01392352e-02, -4.37985079e-08, ...,\n",
+ " 1.31045829e+00, 8.61483874e-01, 5.91035663e-01],\n",
+ " [ 1.42061238e-01, 5.01392319e-02, -4.54834607e-08, ...,\n",
+ " 1.31045829e+00, 8.61483872e-01, 5.91035659e-01],\n",
+ " ...,\n",
+ " [ 1.42061235e-01, 5.01392294e-02, -4.73222464e-08, ...,\n",
+ " 1.31045829e+00, 8.61483870e-01, 5.91035657e-01],\n",
+ " [ 1.42061238e-01, 5.01392319e-02, -4.54834609e-08, ...,\n",
+ " 1.31045829e+00, 8.61483872e-01, 5.91035659e-01],\n",
+ " [ 1.42061244e-01, 5.01392352e-02, -4.37985081e-08, ...,\n",
+ " 1.31045829e+00, 8.61483874e-01, 5.91035663e-01]],\n",
+ "\n",
+ " [[ 8.61483876e-01, 5.91035661e-01, 1.42061237e-01, ...,\n",
+ " 1.45251957e+00, 1.40238030e+00, 1.31045830e+00],\n",
+ " [ 8.61483874e-01, 5.91035660e-01, 1.42061236e-01, ...,\n",
+ " 1.45251957e+00, 1.40238030e+00, 1.31045829e+00],\n",
+ " [ 8.61483873e-01, 5.91035658e-01, 1.42061235e-01, ...,\n",
+ " 1.45251957e+00, 1.40238030e+00, 1.31045829e+00],\n",
+ " ...,\n",
+ " [ 8.61483871e-01, 5.91035657e-01, 1.42061233e-01, ...,\n",
+ " 1.45251957e+00, 1.40238030e+00, 1.31045829e+00],\n",
+ " [ 8.61483873e-01, 5.91035658e-01, 1.42061235e-01, ...,\n",
+ " 1.45251957e+00, 1.40238030e+00, 1.31045829e+00],\n",
+ " [ 8.61483874e-01, 5.91035660e-01, 1.42061236e-01, ...,\n",
+ " 1.45251957e+00, 1.40238030e+00, 1.31045829e+00]],\n",
+ "\n",
+ " ...,\n",
+ "\n",
+ " [[ 1.40238031e+00, 1.31045830e+00, 8.61483872e-01, ...,\n",
+ " 8.71511730e-01, 1.25029117e+00, 1.45251958e+00],\n",
+ " [ 1.40238030e+00, 1.31045830e+00, 8.61483872e-01, ...,\n",
+ " 8.71511729e-01, 1.25029117e+00, 1.45251958e+00],\n",
+ " [ 1.40238030e+00, 1.31045830e+00, 8.61483871e-01, ...,\n",
+ " 8.71511728e-01, 1.25029117e+00, 1.45251958e+00],\n",
+ " ...,\n",
+ " [ 1.40238030e+00, 1.31045830e+00, 8.61483870e-01, ...,\n",
+ " 8.71511727e-01, 1.25029117e+00, 1.45251958e+00],\n",
+ " [ 1.40238030e+00, 1.31045830e+00, 8.61483871e-01, ...,\n",
+ " 8.71511728e-01, 1.25029117e+00, 1.45251958e+00],\n",
+ " [ 1.40238030e+00, 1.31045830e+00, 8.61483872e-01, ...,\n",
+ " 8.71511729e-01, 1.25029117e+00, 1.45251958e+00]],\n",
+ "\n",
+ " [[ 1.25029117e+00, 1.45251958e+00, 1.40238031e+00, ...,\n",
+ " 2.02228367e-01, 5.81007806e-01, 8.71511732e-01],\n",
+ " [ 1.25029117e+00, 1.45251958e+00, 1.40238030e+00, ...,\n",
+ " 2.02228366e-01, 5.81007805e-01, 8.71511732e-01],\n",
+ " [ 1.25029117e+00, 1.45251958e+00, 1.40238030e+00, ...,\n",
+ " 2.02228365e-01, 5.81007804e-01, 8.71511730e-01],\n",
+ " ...,\n",
+ " [ 1.25029117e+00, 1.45251958e+00, 1.40238030e+00, ...,\n",
+ " 2.02228364e-01, 5.81007803e-01, 8.71511728e-01],\n",
+ " [ 1.25029117e+00, 1.45251958e+00, 1.40238030e+00, ...,\n",
+ " 2.02228365e-01, 5.81007804e-01, 8.71511730e-01],\n",
+ " [ 1.25029117e+00, 1.45251958e+00, 1.40238030e+00, ...,\n",
+ " 2.02228366e-01, 5.81007805e-01, 8.71511732e-01]],\n",
+ "\n",
+ " [[ 5.81007818e-01, 8.71511737e-01, 1.25029117e+00, ...,\n",
+ " 5.01392298e-02, -4.30836935e-08, 2.02228372e-01],\n",
+ " [ 5.81007812e-01, 8.71511735e-01, 1.25029117e+00, ...,\n",
+ " 5.01392296e-02, -4.37985084e-08, 2.02228371e-01],\n",
+ " [ 5.81007808e-01, 8.71511732e-01, 1.25029117e+00, ...,\n",
+ " 5.01392287e-02, -4.54834599e-08, 2.02228368e-01],\n",
+ " ...,\n",
+ " [ 5.81007805e-01, 8.71511729e-01, 1.25029117e+00, ...,\n",
+ " 5.01392276e-02, -4.73222468e-08, 2.02228366e-01],\n",
+ " [ 5.81007808e-01, 8.71511732e-01, 1.25029117e+00, ...,\n",
+ " 5.01392287e-02, -4.54834607e-08, 2.02228368e-01],\n",
+ " [ 5.81007812e-01, 8.71511735e-01, 1.25029117e+00, ...,\n",
+ " 5.01392296e-02, -4.37985078e-08, 2.02228371e-01]]],\n",
+ " shape=(48, 48, 48))})"
+ ]
+ },
+ "execution_count": 3,
+ "metadata": {},
+ "output_type": "execute_result"
+ }
+ ],
+ "source": [
+ "n = 48\n",
+ "iz, iy, ix = np.meshgrid(np.arange(n), np.arange(n), np.arange(n), indexing=\"ij\")\n",
+ "# Period-12 bands along (ix - 2*iz), compatible with n = 48 on the 3-torus\n",
+ "lam = (((ix - 2 * iz) % 12) < 6).astype(np.int32)\n",
+ "\n",
+ "tilted = oi.effective_diffusivity(\n",
+ " lam,\n",
+ " phase_diffusivities={0: 0.1, 1: 1.0},\n",
+ " return_fields=True,\n",
+ ")\n",
+ "tilted"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "03-homogenis-05",
+ "metadata": {},
+ "source": [
+ "Diagonalise $\\mathbf{D}_{\\text{eff}}$ via `np.linalg.eigh` to extract the principal diffusivities and compare the recovered fast eigenvector orientation in $(x, z)$ with the imposed $26.6^\\circ$ sheet angle:"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": 4,
+ "id": "03-homogenis-06",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2026-11-18T09:55:38.278940Z",
+ "iopub.status.busy": "2026-11-18T09:55:38.278630Z",
+ "iopub.status.idle": "2026-11-18T09:55:38.293720Z",
+ "shell.execute_reply": "2026-11-18T09:55:38.292874Z"
+ }
+ },
+ "outputs": [
+ {
+ "name": "stdout",
+ "output_type": "stream",
+ "text": [
+ "Max |D - D^T|: 1.02e-13\n",
+ "Principal eigenvalues: [0.1871 0.463 0.55 ]\n",
+ "Recovered sheet angle: 25.86 deg (imposed arctan(1/2) = 26.57 deg)\n"
+ ]
+ }
+ ],
+ "source": [
+ "D = tilted.tensor\n",
+ "symmetry_err = np.max(np.abs(D - D.T))\n",
+ "\n",
+ "eigvals, eigvecs = np.linalg.eigh(D)\n",
+ "xz_weights = eigvecs[0, :] ** 2 + eigvecs[2, :] ** 2\n",
+ "fast_idx = int(np.argmax(xz_weights * eigvals))\n",
+ "v_fast = eigvecs[:, fast_idx]\n",
+ "if v_fast[0] < 0:\n",
+ " v_fast = -v_fast\n",
+ "theta_recovered = np.degrees(np.arctan2(v_fast[2], v_fast[0]))\n",
+ "\n",
+ "print(f\"Max |D - D^T|: {symmetry_err:.2e}\")\n",
+ "print(f\"Principal eigenvalues: {np.round(eigvals, 4)}\")\n",
+ "print(f\"Recovered sheet angle: {theta_recovered:.2f} deg (imposed arctan(1/2) = {np.degrees(np.arctan(0.5)):.2f} deg)\")"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": 5,
+ "id": "03-homogenis-07",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2026-11-18T09:55:38.295284Z",
+ "iopub.status.busy": "2026-11-18T09:55:38.295126Z",
+ "iopub.status.idle": "2026-11-18T09:55:38.778693Z",
+ "shell.execute_reply": "2026-11-18T09:55:38.777289Z"
+ }
+ },
+ "outputs": [
+ {
+ "data": {
+ "image/png": "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zZs3x7FjxxAdHa21XaFQYO3atTh69CgePHiAzMxMCCGQkJAg+T6kHD16FACwYcMG7Ny5U/P7pP7devz4MYC836tatWrluy/1XGeurq75lpszZw42b96MUaNGITs7G2PHjsWcOXMMbnN+lEol3n//fUREROCff/7RLET3LBsbG5QqVUrv3GxEJc3z8006OTlh6NChmD9/PoD/fUao5zZ+9jMCAOLj4wHkfUa0b99ea19jxowxuB3qdRs++OADnc9NHx8f9OzZE9u2bcPJkyfRt29fhIeHIzs7G2+//bbec+jgwYM1617kJycnBydOnICdnR2mTZumt4wh5x71+WvatGmwt7fPdx/q9/rxxx9DLtdefqVz586oX78+Lly4gCtXrugsMPmiPh09erTOPtXts7a2xogRIwBA57M+KysLt27dQm5uLqysrAr1fKx+v5MnT9aJffzxx5g5cyZOnz4NpVIJhUKhidna2uqcYw1Vq1YtODg44OzZs7h37x6GDRsGZ2dnbNmyBdbW1ibtk4iosCxbtgwtWrTQG1u5cqXOGjnqz9F33nlH59rW3d0dw4YNw9KlS/HPP/+gcePGWvH33nsPMplMa1ujRo2wf/9+DBkyROczsXHjxli/fj3u3bunc/yJEyfqnGO6du2KunXr4sqVK7h+/Trq1KmDkydPAgBGjhypc0709/dHmzZtNNcXaup/f//99/jpp590zlPqdTiuX7+OcuXKadWVuo86dOiQzn3U8+rWrYty5crhjz/+QFBQENq2bQtbW1tN/NlrEnUbv/32W6xatUqnjffu3YNKpcLNmzfRuHFjTT+MGTNGa58A0KpVKwQGBuLMmTP5ts9Q6rbt27cP//77r871mvq+5/r165rch5pU/61YsUKr/9q1a4fg4GAsWrQIX3zxBXx8fDSxZ3/OV65cQXJyMho1aqRzLCsrK0yaNAkDBw7EP//8o3Nd06tXL733b4Xh2bUuDL1HV1u7di1+/vln/PTTTyhdujSsra3x9ddfY9euXVi9ejWcnJwKu7lEWpi8LsHUSbmYmBi9C06pqRdeSElJQVZWFurWrav3xrBmzZomtcPb21vv9ho1agD434lG3d74+HhNsiC/9j7r+Rv7/KiPpz7+89QnqWcTf/Hx8ahWrRpsbGx0yhvTL+qfQ926dQ2uY6ikpCS0adMm34U+9fWdq6ur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vw+lUgk7OzvMnz/f0k0kAgCMHTsWycnJ6Nu3L5ydnSGXy6FQKLBo0SJLN41IgyOvyWI48ppeZXfu3MHTp08lH823hNjYWNy7dw/169fX++gcERG9nBYvXoxPP/0Ub7/9NrZu3arZLoTAm2++qUlIL1q0CJ988gni4uJw9+5dnf1ITT9HRETGefr0KT799FNs2LABqampmu1NmzbFsmXL0LRpUwu2jkiXemoXJycnVK5cWSv27HSdauppYJ4vS1QUmLwmizFkPmoiIiIikqZSqbB582bk5OSgV69eetcsOX/+PCIjI9GoUSOj1lYgIqKCUalUePjwIZKSkl64DgQREenH5DURERERERERERERFTv5Lx9LRERERERERERERGQBTF4TERERERERERERUbHD5DURERERERERERERFTtMXhMRERERERERERFRscPk9XMyMzNx+fJlZGZmWropREREJuG5jIiI6NXB8zoREZVkVpZuQHFz69Yt1KtXDza1+kNu72a24yaGrTTbsQrKpdE4SzfBYOzXosF+LRoloV8zzr487/Flpj6X/bdgDOpU8tCJ3z8SLlk3NOSGZCwiSfqm2UEhk4yVt8v/cqNbP1/JmGcrf8mYbdAwyZiwd5aMqazsJGPWT6IkYwCQeXybZIz9yn5lv5aMfrWqVCffOFFhU5/Xl8wbgsqeZS3dHCqgt+fetHQTqJD4V6tq6SZQITh3ZIWlm0AvwJHXRERERERERERERFTsMHlNRERERERERERERMUOk9dEREREREREREREVOwweU1ERERERERERERExQ4XbCQiIiIiIiIiIiJ6SVy7dg2PHz9GlSpV4O3tbXT93NxcXLp0CampqfDz84Ozs/RC15bG5DURERERERERERFRMXfnzh28/fbbiIqKgq+vL86dO4fAwEBs2bIFZcuWNWgfa9aswdSpU1G2bFlUqFABkZGR6NevH7766qsibr1pmLwuZIlhKy3dBIO5NBpn6SYYjP1aNNivRYP9SsXF3vl/4qzCVmd7RFKmZB0HhUwy5u1gLRnr1s9XMubZyl8yBgC2QcMkY8JeegSA0spOMmb9JEoylnN8m2Qs6ki4ZAwAQkNuSMbYr+xX9mvJ6Nc66/7IN05ERERUFHJzc9G1a1fY2dnh1q1bKF26NOLi4tC0aVO8/fbbOHr06Av3sWTJEsycORO/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wRVaREREhidz2xApD6mioqLQt29f2NnZoVGjRrC1tcXIkSORlJT00bF3797F6NGj4eDggKpVq6Js2bIoX748fv31V4PeoozbhhAREREREelAQTuw8fr167h79y6srKzQvHlzWFtbZ2vcvn37EBUVpdFeunRpdO7cOa/TJCIi0gtd73ktCAK6deuGFy9e4M6dO3B1dcXt27fRqlUrxMXFYdu2bVmOX7RoEa5cuYKdO3eiVatWEAQBq1atwujRo/Hy5UssWLBAWmL5jMXrPBZ9dYW+U8g2G++x+k4h2ziv+YPzmj84r2Qojsw/iutyU432kJhk0TGWciPRmLuliWjMt4+naMzJp5ZoDABMOwwWjQnm4oUShbGZaMwkMlQ0lhawSzQWejpYNAYAgQceisY4r5xXzmvRmFePDQezjGeloBzYmJCQgB49euDvv/9G+/bt8fz5c3z66afYtGkTunbt+tHxM2bMQGxsLNq1a6fWXqlSJRaviYioUNHlLfrYsWM4f/48tm3bBldXVwBA9erVMWXKFHz99deYNGkSatasKTq+TZs2WLFiBYoXLw4AMDIywqhRo7B//34sX74cc+bMgbGx4ZWKDS8jIiIiIiKiQqigHNg4duxY/P3337h+/TpcXFwAAF9//TX8/f1x584duLu7f/Qanp6eWLt2bT5nSkREpD/C//8nZZwUhw4dAgB06NBBrb1jx474+uuvcfDgwSyL1wMGDNDabmdnh8TERCQkJKBkyZKScstP3POaiIiIiIiIAABv377F5s2bMXjwYFXhGgCmT58OhUKBZcuW6S85IiKiIuzevXuws7PTKDC7ublBJpPh7t27Ob5mVFQUjh07BldXV4MsXANceU1ERERERKQTSonbhkgZI9W5c+egVCrRrFkztXZbW1vUqFEDp06dytZ1oqOjsWvXLqSkpMDFxQUNGzaEiYn4tjNEREQFTW73vH78+LFGzMHBAY6OjlrHxcTEwMrKSqPd2NgY5ubmiImJyXEuo0aNQkxMDJYvX57jsbrC4jUREREREZEOCIIApYTDFzP3vM7pi9zdu3cjNjb2o9d3dHREly5dAABPnjwBAJQvX16jX/ny5XHs2LFs5fzq1Svs2LEDycnJCAoKQokSJbBx40a0atUqW+OJiIgMXW6L19rOkZg5cyZmzZqldZxcLodSqdQaUyqVkMvlOcpj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3BwNGzaEhYWFvlPSqfDwcFy4cEFrrESJEvjkk0802iMjI3H16lUYGRmhXr16hfaX2927d3H37l3ReP369VG+fHmN9nv37uHx48ewtbVFgwYNCvVpvQqFAvfv38fTp09hbm6O6tWro3Tp0qL909LScOXKFURHR6NSpUpF7mOCe/bsQbly5TQO/Mz0/v17XLt2DUZGRvD29i6UW/FQ3ktISMCVK1eQkpKCWrVqwcnJSd8p6dy+ffugVCq1xtq1a6dxWFxaWhouX76MmJgYVK5cWW07o8IkLi4OJ06cEI07OTmhUaNGGu1F7XfRy5cvce/ePaSmpsLV1RUeHh4ae4L/2927d/HkyRPY2dmhfv36hfo+/1+XL19W7YOtTVH52SIiKqoSEhJQoUIFODg44NatWzAxMdF3SkRUSLB4TUREREREREREks2cORNz587F2bNn4ePjo+90iKgQKTrLQYiIiIiIiIiIKM/MmzcPt2/fxu7du7FkyRIWrokoz3HlNRERERERERER5YggCPj5559hZmaGpk2bombNmvpOiYgKIRaviYiIiIiIiIiIiMjgyPSdABERERERERERERHRf7F4TUREREREREREREQGh8VrIiIiIiIiIiIiIjI4LF4TERERERERERERkcFh8ZqIiIiIiIiIiIiIDI6xvhMgKmpu376N+/fvAwBkMhm6d++u54yy7+LFi0hKSkKbNm0AAIIgYO/evap4tWrVUK1aNX2lR0REOhAVFYUzZ86o/ty0aVOULl1ajxllX1hYGK5evYoOHTrA0tISQMa97c2bNwCAkiVLqu5xRERERESkfyxeE+nYli1bsGjRInTv3h1yubxAFa8XLFiAly9f4saNGwAyitc7duyAUqnE/v37MXPmTMyaNUuvORIRUf56+PAhevXqhSZNmqB06dJwdXUtMMXrs2fPYvDgwXj06BEqVqwIAAgMDMS1a9dw4cIFlC5dWnWPIyIiIiIi/WPxmkgPZDIZ9uzZo+80ci3z60hOToa5ubm+0yEiIh2aNGkSOnfurO80cm3SpEkAgPbt2yM8PFzP2RARERER0b9xz2siIiIiIiIiIiIiMjgsXhNJEBYWhj179iAsLEytXalU4sCBA/jrr79yfM2DBw/i0qVLWmPXrl3D/v371doUCgWCg4Nx8OBBBAUFITU1VS1+9+5d7NmzR2MVmUKh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cOPGDbVV1wDQu3dvANAolG/YsAGxsbHw9/dXtR0/fhxz587FxIkTMXnyZKxYsQI7duxQ28+0f//+MDc3x/z587Xm8+LFi1x/TUREZFiCgoLg6+uL7t27Y9WqVfjxxx/x7Nkz/PLLL7m+dr9+/WBhYYF169Zhw4YNaNOmDSpUqKCK169fHy4uLvj9999Vq7AB4Pnz59i7dy+6du2qKqBHRkaiV69eqFatGlatWoXdu3cjISEBAwYMgFKpBABUrlwZPj4+WLlyJWJjYzXyef78ea6/JiIiIiIi0g+uvCbKofnz56u29ujVqxcAYNasWdi8eTPGjx+PI0eO5Or63bt3h62tLb777jtYWFioFaMBoG7dupg9ezZmzpyJiIgI+Pj44NatW1i+fDkGDRqk6v/ixQv0798fPj4+mDt3LoCMbUkuXLiAb775BvXr14e3tzecnJywc+dO9OvXD0+fPlU9/9OnT3Ho0CG0b98e8+bNy9XXREREhuPatWvo0KED2rVrh02bNkEmk6FFixbw9fXFvHnz8Nlnn6FUqVKSr1+iRAn07NkTq1evRnp6usY9RC6XY/PmzejUqRN8fHwwaNAgJCYm4pdffkH58uVVBXSlUokBAwYgPj4eAQEBMDMzg5ubGzZu3Ihu3bph7ty5qgOIt27dig4dOsDT0xPDhw+Hq6srwsPDcfnyZTx+/Bg3b96U/PUQEREREZH+sHhNlAPXr1/H9evXsWHDBgwcOFDVbm9vj6VLl+LIkSMICwtTW2GWU6amppg9ezYCAgJQv359rft0zpgxA23btsWePXtw4sQJ2NvbqwrNmXbs2IE2bdpg6dKlkMvlqvbMVdc7d+5EvXr1YGRkBF9fXzx58gRbt27FzZs3IQgCKlasiA0bNqBmzZqqsU2bNkVkZKTkr42IiPTrw4cPWL16NQYNGoQlS5ao3R8WLVqEadOm4ezZsxpvnObUF198gcTERBgbG2s9zLhp06a4d+8eNm7ciIsXL8LExATTpk3DwIEDYWFhAQAIDAyEpaUltm3bBjc3N9VYPz8//Pjjj7hy5QrevHmDMmXKoFy5cggJCcHevXsRGBiIBw8ewNnZGYMGDULnzp1VY11cXNCjRw8UL148V18fERERERHphpGQeSQ7EenEpEmTsHjxYiYSHBgAAAGFSURBVOzcuRMymQzdu3fXd0qSCYKAvXv3Ii0tDf369cPMmTMxa9YsfadFRET56PLly2jUqBEmTZqEunXromnTpihdurS+05Ls4sWLePPmDebNmwdBEHDjxg19p0RERERERP+PK6+JdKxGjRro1q0bduzYAblcXuCL1zt27AAA9OjRA9WqVdNzRkRElN/s7OzQo0cPPHr0CI8ePYKrq2uBLl4HBgbi2rVrcHd3h6urq77TISIiIiKif+HKayIiIiIiIiIiIiIyODJ9J0BERERERERERERE9F8sXhMRERERERERERGRwWHxmoiIiIiIiIiIiIgMDovXRERERERERERERGRwWLwmIiIiIiIiIiIiIoPD4jURERERERERERERGRwWr4mIiIiIiIiIiIjI4LB4TUREREREREREREQGh8VrIiIiIiIiIiIiIjI4LF4TERERERERERERkcFh8ZqIiIiIiIiIiIiIDA6L10RERERERERERERkcFi8JiIiIiIiIiIiIiKD839+yreKnMThgAAAAABJRU5ErkJggg==",
+ "text/plain": [
+ ""
+ ]
+ },
+ "metadata": {},
+ "output_type": "display_data"
+ }
+ ],
+ "source": [
+ "chi_z = tilted.corrector_fields[\"z\"]\n",
+ "mid_y = n // 2\n",
+ "\n",
+ "fig, axes = plt.subplots(1, 3, figsize=(12.2, 3.6), layout=\"constrained\")\n",
+ "fig.get_layout_engine().set(w_pad=0.14)\n",
+ "\n",
+ "axes[0].imshow(lam[:, mid_y, :], origin=\"lower\", cmap=\"Blues\")\n",
+ "c0 = n / 2.0\n",
+ "axes[0].annotate(\n",
+ " \"\",\n",
+ " xy=(c0 + 15 * v_fast[0], c0 + 15 * v_fast[2]),\n",
+ " xytext=(c0 - 15 * v_fast[0], c0 - 15 * v_fast[2]),\n",
+ " arrowprops={\"arrowstyle\": \"->\", \"color\": \"#d95f02\", \"lw\": 2.2},\n",
+ ")\n",
+ "axes[0].set_title(r\"Tilted periodic laminate ($x$–$z$)\")\n",
+ "axes[0].set_xlabel(r\"$x$ [voxel]\")\n",
+ "axes[0].set_ylabel(r\"$z$ [voxel]\")\n",
+ "\n",
+ "vmax = np.max(np.abs(chi_z[:, mid_y, :]))\n",
+ "im_chi = axes[1].imshow(\n",
+ " chi_z[:, mid_y, :], origin=\"lower\", cmap=\"RdBu_r\", vmin=-vmax, vmax=vmax\n",
+ ")\n",
+ "axes[1].set_title(r\"Periodic corrector $\\chi_z$\")\n",
+ "axes[1].set_xlabel(r\"$x$ [voxel]\")\n",
+ "axes[1].set_ylabel(r\"$z$ [voxel]\")\n",
+ "fig.colorbar(im_chi, ax=axes[1], fraction=0.046, pad=0.04, label=r\"$\\chi_z$ [voxel]\")\n",
+ "\n",
+ "im_D = axes[2].imshow(D, cmap=\"cividis\", vmin=0.0, vmax=0.6)\n",
+ "axes[2].set_xticks([0, 1, 2], [r\"$x$\", r\"$y$\", r\"$z$\"])\n",
+ "axes[2].set_yticks([0, 1, 2], [r\"$x$\", r\"$y$\", r\"$z$\"])\n",
+ "axes[2].set_title(r\"Homogenised tensor $\\mathbf{D}_{\\mathrm{eff}}$\")\n",
+ "for r_idx in range(3):\n",
+ " for c_idx in range(3):\n",
+ " val = 0.0 if abs(D[r_idx, c_idx]) < 5e-4 else D[r_idx, c_idx]\n",
+ " color = \"white\" if val < 0.3 else \"black\"\n",
+ " axes[2].text(c_idx, r_idx, f\"{val:.3f}\", ha=\"center\", va=\"center\", color=color, fontsize=9)\n",
+ "fig.colorbar(im_D, ax=axes[2], fraction=0.046, pad=0.04, label=r\"$D_{\\mathrm{eff},ij}\\;[-]$\")\n",
+ "\n",
+ "plt.show()"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "03-homogenis-08",
+ "metadata": {},
+ "source": [
+ "## Periodic Homogenisation vs. Dirichlet Flow-Through on Tomographic Data\n",
+ "\n",
+ "On a non-periodic finite subvolume cropped from a tomogram, periodic homogenisation wraps opposing faces onto the 3-torus whereas Dirichlet flow-through seals the four lateral faces ($\\nabla \\phi \\cdot \\mathbf{n} = 0$). On a sufficiently representative volume the two estimates agree closely along all three axes, with minor differences attributable to artificial boundary re-connections on the periodic wrap."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": 6,
+ "id": "03-homogenis-09",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2026-11-18T09:55:38.780971Z",
+ "iopub.status.busy": "2026-11-18T09:55:38.780785Z",
+ "iopub.status.idle": "2026-11-18T09:56:01.603907Z",
+ "shell.execute_reply": "2026-11-18T09:56:01.602343Z"
+ }
+ },
+ "outputs": [
+ {
+ "name": "stdout",
+ "output_type": "stream",
+ "text": [
+ "Axis | Periodic D_eff,ii | Flow-through D_eff\n",
+ "-----+-------------------+-------------------\n",
+ " X | 0.12062 | 0.11994\n",
+ " Y | 0.11723 | 0.11787\n",
+ " Z | 0.11702 | 0.11685\n"
+ ]
+ },
+ {
+ "data": {
+ "text/html": [
+ "Component Value D_xx 1.206226e-01 D_yy 1.172347e-01 D_zz 1.170170e-01 D_xy -3.815853e-06 D_xz 2.447695e-03 D_yz -5.905263e-04 Active VF 0.399326
"
+ ],
+ "text/plain": [
+ "EffectiveDiffusivityResult(tensor=array([[ 1.20622636e-01, -3.81585345e-06, 2.44769479e-03],\n",
+ " [-3.81584419e-06, 1.17234749e-01, -5.90526336e-04],\n",
+ " [ 2.44769479e-03, -5.90526356e-04, 1.17017009e-01]]), active_volume_fraction=0.3993263244628906, solver_converged=True, iterations=(743, 726, 748), residuals=(9.801346414369918e-10, 9.68621640123171e-10, 9.82067850394766e-10), corrector_fields=None)"
+ ]
+ },
+ "execution_count": 6,
+ "metadata": {},
+ "output_type": "execute_result"
+ }
+ ],
+ "source": [
+ "cubic = oi.datasets.two_phase_cubic()\n",
+ "deff_hom = oi.effective_diffusivity(cubic, phase=1)\n",
+ "flow = oi.tortuosity_all(cubic, phase=1)\n",
+ "\n",
+ "print(\"Axis | Periodic D_eff,ii | Flow-through D_eff\")\n",
+ "print(\"-----+-------------------+-------------------\")\n",
+ "for idx, axis in enumerate((\"x\", \"y\", \"z\")):\n",
+ " d_per = deff_hom.tensor[idx, idx]\n",
+ " d_dir = flow[axis].effective_diffusivity\n",
+ " print(f\" {axis.upper()} | {d_per:.5f} | {d_dir:.5f}\")\n",
+ "\n",
+ "deff_hom"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "03-homogenis-10",
+ "metadata": {},
+ "source": [
+ "## References\n",
+ "\n",
+ "1. G. Allaire, *Homogenization and two-scale convergence*, SIAM J. Math. Anal. **23**(6), 1482–1518 (1992).\n",
+ "2. J. Le Houx, M. Osenberg, I. Manke, and D. Kramer, *Statistical estimation of effective diffusivity in porous media*, Transp. Porous Media **150**, 71–88 (2023)."
+ ]
+ }
+ ],
+ "metadata": {
+ "kernelspec": {
+ "display_name": "Python 3",
+ "language": "python",
+ "name": "python3"
+ },
+ "language_info": {
+ "codemirror_mode": {
+ "name": "ipython",
+ "version": 3
+ },
+ "file_extension": ".py",
+ "mimetype": "text/x-python",
+ "name": "python",
+ "nbconvert_exporter": "python",
+ "pygments_lexer": "ipython3",
+ "version": "3.11.2"
+ }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}
diff --git a/tutorials/03_rev_and_uncertainty.ipynb b/tutorials/03_rev_and_uncertainty.ipynb
deleted file mode 100644
index a803ff37..00000000
--- a/tutorials/03_rev_and_uncertainty.ipynb
+++ /dev/null
@@ -1,247 +0,0 @@
-{
- "cells": [
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": " \n\n# Tutorial 3 of 7: Representative Elementary Volume (REV) and Uncertainty\n\n*OpenImpala Tutorial Series — From first solve to HPC deployment*\n\n---\n\nWhen you compute the tortuosity of a single crop from a micro-CT scan, the result depends on where and how large that crop is. A natural question is: *at what sample size do the computed properties stabilise?* This is the concept of the **Representative Elementary Volume (REV)**.\n\nIn this tutorial we take a rigorous statistical approach — computing the tortuosity of many random sub-volumes at different sizes — to identify the REV, quantify uncertainty, and understand when common assumptions (like normality) break down.\n\n**What you will learn:**\n1. Extract random sub-volumes of varying sizes from a 3D image.\n2. Solve the transport problem for each crop (over 100 simulations).\n3. Plot a violin-style REV diagram showing the full distribution at each scale.\n4. Use the Coefficient of Variation (CV) to define the REV threshold.\n5. Track **percolation probability** — how often sub-volumes fail to span the domain.\n6. Compute **bootstrap confidence intervals** for the mean tortuosity at each scale.\n7. **Test normality** with Q-Q plots and the Shapiro-Wilk test to know when Gaussian error bars are valid.\n8. Compare the REV across **different transport directions** (anisotropic REV).\n9. Produce a **publication-ready uncertainty summary** — what to report in a paper.\n\n**Prerequisites:** [Tutorial 1](01_hello_openimpala.ipynb) — core OpenImpala workflow. Familiarity with [Tutorial 2](02_digital_twin.ipynb) (loading real images, directional tortuosity) is helpful but not required."
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": "# Install OpenImpala and utilities\n!pip install -q openimpala tifffile matplotlib"
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": "import os\nimport time\nimport urllib.request\nimport numpy as np\nimport matplotlib.pyplot as plt\nimport tifffile\nimport openimpala as oi\n\nprint(f\"OpenImpala version {oi.__version__} loaded.\")\n\n# In a notebook we open the session manually so it stays alive across\n# cells. In a script, use `with oi.Session():` instead (see Tutorial 1).\nsession = oi.Session()\nsession.__enter__()\n\n# Download the sample TIFF so the notebook works on Colab.\ndata_url = \"https://raw.githubusercontent.com/BASE-Laboratory/OpenImpala/master/data/SampleData_2Phase_stack_3d_1bit.tif\"\ndata_path = \"SampleData_2Phase_stack_3d_1bit.tif\"\n\nif not os.path.exists(data_path):\n print(\"Downloading sample data...\")\n urllib.request.urlretrieve(data_url, data_path)\n print(\"Download complete.\")\n\n# Load the scan into memory\nmicrostructure = tifffile.imread(data_path).astype(np.int32)\nprint(f\"Base microstructure loaded: {microstructure.shape}\")"
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": "## 1. Setting Up the Statistical Sampling\n\nIf you pick a small sub-volume (say $16^3$), the tortuosity will vary substantially depending on whether you happen to sample a region with large pores or dense solid. As the sub-volume size increases, these fluctuations should average out and the computed properties should converge.\n\nWe define a set of window sizes. For each size, we randomly crop the microstructure 20 times and record:\n- Whether the pore phase **percolates** (spans inlet to outlet).\n- The **local porosity** and **tortuosity** for every percolating crop.\n\nTracking percolation failures is important — at small scales, a sub-volume may contain an isolated pore cluster that never connects to the boundary, making the tortuosity undefined. The fraction of samples that percolate is itself a meaningful statistic."
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": "window_sizes = [16, 24, 32, 40, 48, 64, 80]\nn_samples_per_size = 20 # 140 simulations in total\ntotal_evals = len(window_sizes) * n_samples_per_size\n\nrev_results = {w: {'tau': [], 'vf': [], 'n_total': 0, 'n_percolating': 0} for w in window_sizes}\n\nprint(f\"Running {total_evals} simulations (this may take a few minutes)...\")\nt_start = time.time()\ntotal_solves = 0\neval_count = 0\n\nfor w in window_sizes:\n max_start_idx = microstructure.shape[0] - w\n\n for _ in range(n_samples_per_size):\n eval_count += 1\n\n # 1. Random crop origin\n z = np.random.randint(0, max_start_idx + 1)\n y = np.random.randint(0, max_start_idx + 1)\n x = np.random.randint(0, max_start_idx + 1)\n\n # 2. Extract the sub-volume\n crop = microstructure[z:z+w, y:y+w, x:x+w]\n\n # 3. Local porosity\n vf = oi.volume_fraction(crop, phase=1).fraction\n\n # 4. Percolation check\n rev_results[w]['n_total'] += 1\n perc = oi.percolation_check(crop, phase=1, direction=\"z\")\n\n # 5. Solve if percolating\n if perc.percolates:\n rev_results[w]['n_percolating'] += 1\n res = oi.tortuosity(crop, phase=1, direction=\"z\", solver=\"mlmg\")\n rev_results[w]['tau'].append(res.tortuosity)\n rev_results[w]['vf'].append(vf)\n total_solves += 1\n\n # Progress indicator every 20 evaluations\n if eval_count % 20 == 0:\n elapsed = time.time() - t_start\n rate = eval_count / elapsed\n remaining = (total_evals - eval_count) / rate\n print(f\" [{eval_count}/{total_evals}] {elapsed:.0f}s elapsed, \"\n f\"~{remaining:.0f}s remaining ({total_solves} solves so far)\")\n\nt_end = time.time()\nprint(f\"\\nCompleted {total_solves} solves in {t_end - t_start:.1f}s.\")\n\n# Quick summary of percolation rates\nfor w in window_sizes:\n r = rev_results[w]\n perc_pct = 100 * r['n_percolating'] / r['n_total']\n n_tau = len(r['tau'])\n print(f\" {w:3d}^3: {r['n_percolating']}/{r['n_total']} percolated ({perc_pct:.0f}%), \"\n f\"{n_tau} tortuosity values\")"
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": "## 2. REV Violin Diagram\n\nA mean and standard deviation assume the data are normally distributed. A **violin plot** shows the full probability density at each scale, which is more informative — particularly at small sizes where the distribution can be strongly skewed (long tails of high-tortuosity bottleneck regions)."
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "means = []\n",
- "stds = []\n",
- "valid_sizes = []\n",
- "plot_data = []\n",
- "\n",
- "# Extract data, ignoring sizes where nothing percolated\n",
- "for w in window_sizes:\n",
- " taus = rev_results[w]['tau']\n",
- " if len(taus) > 0:\n",
- " means.append(np.mean(taus))\n",
- " stds.append(np.std(taus))\n",
- " valid_sizes.append(w)\n",
- " plot_data.append(taus)\n",
- "\n",
- "means = np.array(means)\n",
- "stds = np.array(stds)\n",
- "valid_sizes = np.array(valid_sizes)\n",
- "\n",
- "fig, ax = plt.subplots(figsize=(9, 5), dpi=150)\n",
- "\n",
- "# Render the Violin Plot\n",
- "parts = ax.violinplot(plot_data, positions=valid_sizes, widths=5,\n",
- " showmeans=False, showextrema=False)\n",
- "\n",
- "# Style the violins\n",
- "for pc in parts['bodies']:\n",
- " pc.set_facecolor('#1f77b4')\n",
- " pc.set_edgecolor('black')\n",
- " pc.set_alpha(0.5)\n",
- "\n",
- "# Plot the Mean trend line\n",
- "ax.plot(valid_sizes, means, color='#d62728', linewidth=2.5, marker='o', markersize=6, label='Mean Tortuosity')\n",
- "\n",
- "ax.set_xlabel(\"Window Size (Voxels)\", fontsize=12, fontweight='bold')\n",
- "ax.set_ylabel(r\"Tortuosity Factor ($\\tau$)\", fontsize=12, fontweight='bold')\n",
- "ax.set_title(\"Probability Density of Microstructural Transport (REV)\", fontsize=14, fontweight='bold')\n",
- "ax.grid(True, linestyle='--', alpha=0.5)\n",
- "ax.spines['top'].set_visible(False)\n",
- "ax.spines['right'].set_visible(False)\n",
- "ax.legend()\n",
- "\n",
- "plt.tight_layout()\n",
- "plt.show()"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": "## 3. Quantifying Uncertainty with the Coefficient of Variation\n\nTo determine whether a given sample size is representative, we use the **Coefficient of Variation**: $\\mathrm{CV} = \\sigma / \\mu \\times 100\\%$. A common practical threshold is CV < 5%.\n\nThe right-hand plot below examines *why* the variance is large at small scales: it shows the correlation between local porosity and local tortuosity for the $32^3$ sub-volumes. In a small crop, the porosity itself fluctuates, and tortuosity responds accordingly."
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "fig, (ax1, ax2) = plt.subplots(1, 2, figsize=(12, 5), dpi=150)\n",
- "\n",
- "# --- SUBPLOT 1: Coefficient of Variation ---\n",
- "cvs = (stds / means) * 100\n",
- "ax1.plot(valid_sizes, cvs, color='#2ca02c', linewidth=2.5, marker='s', markersize=7)\n",
- "ax1.axhline(y=5.0, color='r', linestyle='--', linewidth=2, label='5% Threshold (REV Limit)')\n",
- "\n",
- "ax1.set_xlabel(\"Window Size (Voxels)\", fontweight='bold')\n",
- "ax1.set_ylabel(\"Coefficient of Variation (%)\", fontweight='bold')\n",
- "ax1.set_title(\"Defining the REV Threshold\", fontweight='bold')\n",
- "ax1.grid(True, linestyle='--', alpha=0.5)\n",
- "ax1.legend()\n",
- "ax1.spines['top'].set_visible(False)\n",
- "ax1.spines['right'].set_visible(False)\n",
- "\n",
- "# --- SUBPLOT 2: The Physical Origin of Variance ---\n",
- "# Let's look at the sub-volumes from the W=32 window size\n",
- "w_small = 32\n",
- "local_vfs = np.array(rev_results[w_small]['vf']) * 100 # Convert to percentage\n",
- "local_taus = np.array(rev_results[w_small]['tau'])\n",
- "\n",
- "ax2.scatter(local_vfs, local_taus, color='#ff7f0e', edgecolor='black', s=60, alpha=0.8)\n",
- "\n",
- "# Add a linear trendline\n",
- "if len(local_vfs) > 1:\n",
- " z = np.polyfit(local_vfs, local_taus, 1)\n",
- " p = np.poly1d(z)\n",
- " ax2.plot(local_vfs, p(local_vfs), \"k-\", alpha=0.6, linewidth=2)\n",
- "\n",
- "ax2.set_xlabel(\"Local Porosity (%)\", fontweight='bold')\n",
- "ax2.set_ylabel(r\"Local Tortuosity ($\\tau$)\", fontweight='bold')\n",
- "ax2.set_title(f\"Physical Correlation (Scale: {w_small}^3)\", fontweight='bold')\n",
- "ax2.grid(True, linestyle='--', alpha=0.5)\n",
- "ax2.spines['top'].set_visible(False)\n",
- "ax2.spines['right'].set_visible(False)\n",
- "\n",
- "plt.tight_layout()\n",
- "plt.show()"
- ]
- },
- {
- "cell_type": "markdown",
- "source": "## 4. Percolation Probability\n\nBefore a sub-volume can have a well-defined tortuosity, the transport phase must percolate — it must form a connected path from the inlet face to the outlet face. At small scales, some crops will contain isolated pore clusters that do not span the domain.\n\nThe **percolation probability** $P_\\text{perc}(L)$ — the fraction of sub-volumes of side length $L$ that percolate — is itself a scale-dependent property. It should converge to 1.0 (or 0.0 for non-percolating phases) as $L$ approaches the REV. If $P_\\text{perc} < 1$ at your chosen sample size, your tortuosity statistics are conditioned on percolation and may be biased (you are missing the hardest-to-transport regions).",
- "metadata": {}
- },
- {
- "cell_type": "code",
- "source": "perc_probs = []\nperc_sizes = []\n\nfor w in window_sizes:\n r = rev_results[w]\n if r['n_total'] > 0:\n perc_probs.append(100 * r['n_percolating'] / r['n_total'])\n perc_sizes.append(w)\n\nfig, ax = plt.subplots(figsize=(7, 4), dpi=150)\nax.plot(perc_sizes, perc_probs, 'o-', color='#9467bd', linewidth=2.5, markersize=8,\n markerfacecolor='white', markeredgewidth=2)\nax.axhline(y=100, color='gray', linestyle=':', linewidth=1)\nax.set_xlabel(\"Window Size (Voxels)\", fontweight='bold')\nax.set_ylabel(\"Percolation Probability (%)\", fontweight='bold')\nax.set_title(\"Fraction of Sub-Volumes with Connected Pore Phase\", fontweight='bold')\nax.set_ylim(0, 105)\nax.grid(True, linestyle='--', alpha=0.5)\nax.spines['top'].set_visible(False)\nax.spines['right'].set_visible(False)\n\n# Annotate the first size where percolation reaches 100%\nfor i, (s, p) in enumerate(zip(perc_sizes, perc_probs)):\n if p >= 100:\n ax.annotate(f'100% at L={s}', xy=(s, p), xytext=(s + 5, p - 10),\n fontsize=10, fontweight='bold', color='#9467bd',\n arrowprops=dict(arrowstyle='->', color='#9467bd'))\n break\n\nplt.tight_layout()\nplt.show()\n\n# Warn the user about conditioning bias\nfor w in window_sizes:\n r = rev_results[w]\n if r['n_percolating'] < r['n_total']:\n pct = 100 * r['n_percolating'] / r['n_total']\n print(f\" Warning: At L={w}, only {pct:.0f}% of sub-volumes percolate. \"\n f\"Tortuosity statistics at this scale are conditioned on percolation.\")",
- "metadata": {},
- "execution_count": null,
- "outputs": []
- },
- {
- "cell_type": "markdown",
- "source": "## 5. Bootstrap Confidence Intervals\n\nThe Coefficient of Variation gives a single-number summary of spread, but for publication you typically need **confidence intervals** for the mean. The bootstrap is ideal here because it makes no assumption about the underlying distribution — it works whether the data are Gaussian, skewed, or heavy-tailed.\n\nThe procedure:\n1. From the $n$ tortuosity values at a given window size, draw $B = 10{,}000$ bootstrap samples (sampling with replacement).\n2. Compute the mean of each bootstrap sample.\n3. Take the 2.5th and 97.5th percentiles of the bootstrap means as the 95% CI.\n\nThis is a **nonparametric** interval — unlike $\\bar{\\tau} \\pm 1.96\\,\\sigma/\\sqrt{n}$, it does not assume normality.",
- "metadata": {}
- },
- {
- "cell_type": "code",
- "source": "B = 10_000 # Number of bootstrap resamples\nrng = np.random.default_rng(42)\n\nboot_ci_lo = []\nboot_ci_hi = []\nboot_means = []\ngaussian_ci_lo = []\ngaussian_ci_hi = []\n\nfor i, w in enumerate(valid_sizes):\n taus = np.array(plot_data[i])\n n = len(taus)\n\n # Bootstrap 95% CI for the mean\n boot_samples = rng.choice(taus, size=(B, n), replace=True)\n boot_sample_means = boot_samples.mean(axis=1)\n ci_lo, ci_hi = np.percentile(boot_sample_means, [2.5, 97.5])\n boot_ci_lo.append(ci_lo)\n boot_ci_hi.append(ci_hi)\n boot_means.append(np.mean(taus))\n\n # Gaussian CI for comparison: mean +/- 1.96 * SEM\n sem = np.std(taus, ddof=1) / np.sqrt(n)\n gaussian_ci_lo.append(np.mean(taus) - 1.96 * sem)\n gaussian_ci_hi.append(np.mean(taus) + 1.96 * sem)\n\nboot_means = np.array(boot_means)\nboot_ci_lo = np.array(boot_ci_lo)\nboot_ci_hi = np.array(boot_ci_hi)\ngaussian_ci_lo = np.array(gaussian_ci_lo)\ngaussian_ci_hi = np.array(gaussian_ci_hi)\n\n# --- Plot: Bootstrap vs Gaussian CIs ---\nfig, ax = plt.subplots(figsize=(9, 5), dpi=150)\n\n# Bootstrap CI (shaded band)\nax.fill_between(valid_sizes, boot_ci_lo, boot_ci_hi,\n alpha=0.3, color='#1f77b4', label='Bootstrap 95% CI')\n\n# Gaussian CI (dashed lines)\nax.plot(valid_sizes, gaussian_ci_lo, '--', color='#ff7f0e', linewidth=1.5)\nax.plot(valid_sizes, gaussian_ci_hi, '--', color='#ff7f0e', linewidth=1.5,\n label=r'Gaussian 95% CI ($\\bar{\\tau} \\pm 1.96\\,\\mathrm{SEM}$)')\n\n# Mean\nax.plot(valid_sizes, boot_means, 'o-', color='#d62728', linewidth=2.5,\n markersize=7, label='Sample Mean')\n\nax.set_xlabel(\"Window Size (Voxels)\", fontweight='bold')\nax.set_ylabel(r\"Tortuosity Factor ($\\tau$)\", fontweight='bold')\nax.set_title(\"Confidence Intervals for the Mean Tortuosity\", fontweight='bold')\nax.legend(fontsize=9)\nax.grid(True, linestyle='--', alpha=0.5)\nax.spines['top'].set_visible(False)\nax.spines['right'].set_visible(False)\nplt.tight_layout()\nplt.show()\n\n# Print the CI widths\nprint(\"CI width comparison (Bootstrap vs Gaussian):\")\nprint(f\"{'Size':>6s} {'Mean':>7s} {'Boot CI':>18s} {'Boot Width':>10s} {'Gauss Width':>11s}\")\nfor i, w in enumerate(valid_sizes):\n bw = boot_ci_hi[i] - boot_ci_lo[i]\n gw = gaussian_ci_hi[i] - gaussian_ci_lo[i]\n print(f\"{int(w):6d} {boot_means[i]:7.4f} \"\n f\"[{boot_ci_lo[i]:.4f}, {boot_ci_hi[i]:.4f}] \"\n f\"{bw:10.4f} {gw:11.4f}\")",
- "metadata": {},
- "execution_count": null,
- "outputs": []
- },
- {
- "cell_type": "markdown",
- "source": "## 6. Testing Distributional Assumptions\n\nMany experimentalists report tortuosity as $\\bar{\\tau} \\pm \\sigma$ and implicitly assume the data are normally distributed. But is that assumption valid?\n\nAt small scales the tortuosity distribution is often **right-skewed**: most sub-volumes have moderate tortuosity, but a few contain bottleneck regions with very high values. As the window size increases and the distribution converges, it typically becomes more symmetric and better approximated by a Gaussian.\n\nWe test this in two ways:\n- **Q-Q plot** — plots the sample quantiles against the theoretical quantiles of a normal distribution. If the data are Gaussian, the points fall on the diagonal.\n- **Shapiro-Wilk test** — a formal hypothesis test for normality. A p-value below 0.05 rejects the null hypothesis that the data are normally distributed.\n\nUnderstanding when normality holds (and when it doesn't) tells you whether standard error bars ($\\pm 1.96\\,\\sigma/\\sqrt{n}$) are appropriate, or whether you need the bootstrap CIs from Section 5.",
- "metadata": {}
- },
- {
- "cell_type": "code",
- "source": "from scipy import stats\n\n# Pick two contrasting scales: the smallest and largest with enough data\nsmall_idx = 0 # smallest valid window size\nlarge_idx = -1 # largest valid window size\n\nfig, axes = plt.subplots(1, 2, figsize=(12, 5), dpi=150)\n\nfor ax, idx, color in zip(axes, [small_idx, large_idx], ['#ff7f0e', '#1f77b4']):\n taus = np.array(plot_data[idx])\n w = int(valid_sizes[idx])\n\n # Q-Q plot\n (osm, osr), (slope, intercept, r) = stats.probplot(taus, dist=\"norm\")\n ax.scatter(osm, osr, color=color, edgecolor='black', s=50, alpha=0.8, zorder=3)\n qq_line_x = np.array([osm.min(), osm.max()])\n ax.plot(qq_line_x, slope * qq_line_x + intercept, 'r--', lw=2)\n\n # Shapiro-Wilk test\n if len(taus) >= 3:\n stat_sw, p_sw = stats.shapiro(taus)\n verdict = \"Cannot reject normality\" if p_sw >= 0.05 else \"Normality rejected\"\n ax.set_title(f\"Q-Q Plot: L = {w}$^3$\\nShapiro-Wilk p = {p_sw:.3f} ({verdict})\",\n fontweight='bold', fontsize=11)\n else:\n ax.set_title(f\"Q-Q Plot: L = {w}$^3$ (too few samples)\", fontweight='bold')\n\n ax.set_xlabel(\"Theoretical Quantiles (Normal)\", fontweight='bold')\n ax.set_ylabel(\"Sample Quantiles (Tortuosity)\", fontweight='bold')\n ax.grid(True, linestyle='--', alpha=0.5)\n ax.spines['top'].set_visible(False)\n ax.spines['right'].set_visible(False)\n\nplt.tight_layout()\nplt.show()\n\n# Run Shapiro-Wilk for all window sizes and print a summary table\nprint(\"\\nShapiro-Wilk normality test across all scales:\")\nprint(f\"{'Size':>6s} {'N':>4s} {'W-stat':>8s} {'p-value':>8s} {'Skewness':>9s} {'Normal?':>10s}\")\nprint(\"-\" * 55)\nfor i, w in enumerate(valid_sizes):\n taus = np.array(plot_data[i])\n n = len(taus)\n if n >= 3:\n stat_sw, p_sw = stats.shapiro(taus)\n skew = stats.skew(taus)\n normal = \"Yes\" if p_sw >= 0.05 else \"No\"\n print(f\"{int(w):6d} {n:4d} {stat_sw:8.4f} {p_sw:8.4f} {skew:9.3f} {normal:>10s}\")\n else:\n print(f\"{int(w):6d} {n:4d} {'N/A':>8s} {'N/A':>8s} {'N/A':>9s} {'too few':>10s}\")",
- "metadata": {},
- "execution_count": null,
- "outputs": []
- },
- {
- "cell_type": "markdown",
- "source": "## 7. Directional REV: Does the REV Size Depend on Direction?\n\nIn [Tutorial 2](02_digital_twin.ipynb) we saw that tortuosity can be anisotropic — different in X, Y, and Z. A less obvious but equally important question is whether the **REV size itself** is anisotropic. A material that is calendered (compressed) in the Z-direction may have a larger REV for Z-transport than for X- or Y-transport, because the critical pore bottlenecks that dominate Z-tortuosity are rarer and require a larger sample to average over.\n\nBelow we repeat the REV analysis for a subset of window sizes in all three directions and compare the CV convergence curves.",
- "metadata": {}
- },
- {
- "cell_type": "code",
- "source": "# Use a subset of sizes to keep runtime manageable\ndir_sizes = [24, 40, 64, 80]\nn_dir_samples = 15\ndirections = ['x', 'y', 'z']\ndir_colors = {'x': '#1f77b4', 'y': '#ff7f0e', 'z': '#2ca02c'}\n\ndir_results = {d: {w: [] for w in dir_sizes} for d in directions}\n\nprint(f\"Directional REV sweep: {len(dir_sizes)} sizes x {len(directions)} directions \"\n f\"x {n_dir_samples} samples = {len(dir_sizes) * len(directions) * n_dir_samples} evaluations...\")\n\nt0 = time.time()\nfor d in directions:\n for w in dir_sizes:\n max_idx = microstructure.shape[0] - w\n for _ in range(n_dir_samples):\n z = np.random.randint(0, max_idx + 1)\n y = np.random.randint(0, max_idx + 1)\n x = np.random.randint(0, max_idx + 1)\n crop = microstructure[z:z+w, y:y+w, x:x+w]\n\n perc = oi.percolation_check(crop, phase=1, direction=d)\n if perc.percolates:\n res = oi.tortuosity(crop, phase=1, direction=d, solver=\"mlmg\")\n dir_results[d][w].append(res.tortuosity)\n\nprint(f\"Completed in {time.time() - t0:.1f}s.\")\n\n# --- Plot: CV vs window size for each direction ---\nfig, ax = plt.subplots(figsize=(8, 5), dpi=150)\n\nfor d in directions:\n cv_vals = []\n sz_vals = []\n for w in dir_sizes:\n taus = dir_results[d][w]\n if len(taus) >= 3:\n cv = (np.std(taus) / np.mean(taus)) * 100\n cv_vals.append(cv)\n sz_vals.append(w)\n if sz_vals:\n ax.plot(sz_vals, cv_vals, 'o-', color=dir_colors[d], linewidth=2.5,\n markersize=8, markerfacecolor='white', markeredgewidth=2,\n label=f'{d.upper()}-direction')\n\nax.axhline(y=5.0, color='r', linestyle='--', linewidth=2, label='5% REV threshold')\nax.set_xlabel(\"Window Size (Voxels)\", fontweight='bold')\nax.set_ylabel(\"Coefficient of Variation (%)\", fontweight='bold')\nax.set_title(\"Directional REV: Does the REV Size Depend on Transport Direction?\", fontweight='bold')\nax.legend()\nax.grid(True, linestyle='--', alpha=0.5)\nax.spines['top'].set_visible(False)\nax.spines['right'].set_visible(False)\nplt.tight_layout()\nplt.show()\n\n# Print a summary\nprint(\"\\nDirectional mean tortuosity at the largest window size:\")\nfor d in directions:\n taus = dir_results[d][dir_sizes[-1]]\n if len(taus) >= 2:\n print(f\" {d.upper()}: tau = {np.mean(taus):.4f} +/- {np.std(taus):.4f} \"\n f\"(n={len(taus)}, CV={100*np.std(taus)/np.mean(taus):.1f}%)\")\n else:\n print(f\" {d.upper()}: insufficient data\")",
- "metadata": {},
- "execution_count": null,
- "outputs": []
- },
- {
- "cell_type": "markdown",
- "source": "## 8. Reporting Uncertainty in Practice\n\nWhen publishing tortuosity measurements, a bare number like \"$\\tau = 2.14$\" is incomplete. The analysis in this tutorial gives you the tools to report uncertainty rigorously. Below we generate a publication-ready summary table that includes everything a reader needs to evaluate the measurement.\n\n**What to report:**\n- **Sample size** (voxels and physical units if the voxel size is known).\n- **Number of sub-volumes** evaluated and percolation rate.\n- **Mean and 95% bootstrap CI** for the tortuosity in each direction.\n- **CV** to indicate whether the sample is above the REV threshold.\n- **Normality test result** to justify the choice of error bars (Gaussian vs. bootstrap).",
- "metadata": {}
- },
- {
- "cell_type": "code",
- "source": "# --- Publication-ready summary table ---\nprint(\"=\" * 80)\nprint(\"UNCERTAINTY SUMMARY — TORTUOSITY MEASUREMENTS\")\nprint(\"=\" * 80)\nprint(f\"{'Image:':<20s} {data_path}\")\nprint(f\"{'Domain size:':<20s} {microstructure.shape}\")\nprint(f\"{'Transport phase:':<20s} Phase 1\")\nprint()\n\n# Use the Z-direction results from Section 1 for the main table\nprint(f\"{'Window':>8s} {'N':>4s} {'Perc%':>6s} {'Mean tau':>9s} \"\n f\"{'95% Boot CI':>18s} {'CV%':>6s} {'Normal?':>8s} {'REV?':>5s}\")\nprint(\"-\" * 80)\n\nfor i, w in enumerate(valid_sizes):\n taus = np.array(plot_data[i])\n n = len(taus)\n r = rev_results[int(w)]\n perc_pct = 100 * r['n_percolating'] / r['n_total'] if r['n_total'] > 0 else 0\n\n # Bootstrap CI\n boot_samples = rng.choice(taus, size=(B, n), replace=True)\n ci_lo, ci_hi = np.percentile(boot_samples.mean(axis=1), [2.5, 97.5])\n\n # CV and normality\n cv = 100 * np.std(taus) / np.mean(taus)\n is_rev = \"Yes\" if cv < 5 else \"No\"\n\n if n >= 3:\n _, p_sw = stats.shapiro(taus)\n normal = \"Yes\" if p_sw >= 0.05 else \"No\"\n else:\n normal = \"N/A\"\n\n print(f\"{int(w):>6d}^3 {n:4d} {perc_pct:5.0f}% {np.mean(taus):9.4f} \"\n f\"[{ci_lo:.4f}, {ci_hi:.4f}] {cv:5.1f}% {normal:>8s} {is_rev:>5s}\")\n\nprint()\nprint(\"Recommended reporting format for the largest REV-valid window size:\")\nprint()\n\n# Find the largest window where CV < 5%\nrev_idx = None\nfor i in range(len(valid_sizes) - 1, -1, -1):\n taus = np.array(plot_data[i])\n cv = 100 * np.std(taus) / np.mean(taus)\n if cv < 5:\n rev_idx = i\n break\n\nif rev_idx is not None:\n w = int(valid_sizes[rev_idx])\n taus = np.array(plot_data[rev_idx])\n boot_samples = rng.choice(taus, size=(B, len(taus)), replace=True)\n ci_lo, ci_hi = np.percentile(boot_samples.mean(axis=1), [2.5, 97.5])\n print(f' \"The Z-direction tortuosity was tau = {np.mean(taus):.3f} '\n f'(95% CI: [{ci_lo:.3f}, {ci_hi:.3f}]),')\n print(f' measured on {len(taus)} random {w}^3 sub-volumes '\n f'(CV = {100*np.std(taus)/np.mean(taus):.1f}%, '\n f'bootstrap CI, n = {len(taus)}).\"')\nelse:\n print(\" No window size reached CV < 5%. Consider using a larger sample volume.\")",
- "metadata": {},
- "execution_count": null,
- "outputs": []
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "## 9. From Uncertainty to Training Data\n",
- "\n",
- "The scatter plot in Section 3 revealed a clear physical trend: local geometry (porosity, pore connectivity) controls transport resistance. At small scales, the variation across crops captures a wide range of structure–property relationships.\n",
- "\n",
- "This observation has a practical implication for machine learning. The same sub-volume sampling strategy used here to quantify uncertainty can also generate labelled training data for surrogate models. Each (morphology, tortuosity) pair is a training sample, and the spread across scales provides natural coverage of the feature space.\n",
- "\n",
- "This idea is developed further in [Tutorial 5: Surrogate Modelling](05_surrogate_modelling.ipynb), where we train a regression model on OpenImpala-generated data. The REV analysis from this tutorial provides a useful reference: a well-calibrated surrogate should produce prediction intervals that narrow with increasing sample size, mirroring the convergence we observed above.\n",
- "\n",
- "**Continue the series:**\n",
- "- [Tutorial 4: Effective Diffusivity and Field Visualisation](04_multiphase_and_fields.ipynb) — Use the cell-problem solver and visualise internal fields.\n",
- "- [Tutorial 5: Surrogate Modelling](05_surrogate_modelling.ipynb) — Use this sampling approach to train ML models.\n",
- "\n",
- "---\n",
- "\n",
- "## References & Further Reading\n",
- "\n",
- "1. **OpenImpala:** J. Le Houx & D. Kramer, *OpenImpala: OPEN source IMage based PArallisable Linear Algebra solver*, SoftwareX 15, 100729 (2021). [doi:10.1016/j.softx.2021.100729](https://doi.org/10.1016/j.softx.2021.100729)\n",
- "2. **REV concept:** J. Bear, *Dynamics of Fluids in Porous Media*, Dover Publications (1972). The classical introduction to REV in the context of porous media transport.\n",
- "3. **REV for electrodes:** J. R. Wilson et al., *Three-dimensional reconstruction of a solid-oxide fuel-cell anode*, Nature Materials 5, 541–544 (2006). [doi:10.1038/nmat1668](https://doi.org/10.1038/nmat1668)\n",
- "4. **Statistical REV analysis:** P. R. Shearing et al., *Characterization of the 3-dimensional microstructure of a graphite negative electrode from a Li-ion battery*, Electrochemistry Communications 12(3), 374–377 (2010). [doi:10.1016/j.elecom.2009.12.038](https://doi.org/10.1016/j.elecom.2009.12.038)\n",
- "5. **Coefficient of Variation for REV:** S. J. Cooper et al., *TauFactor: An open-source application for calculating tortuosity factors from tomographic data*, SoftwareX 5, 203–210 (2016). [doi:10.1016/j.softx.2016.09.002](https://doi.org/10.1016/j.softx.2016.09.002)\n",
- "6. **Bootstrap methods:** B. Efron & R. J. Tibshirani, *An Introduction to the Bootstrap*, Chapman & Hall/CRC (1993). The standard reference for nonparametric confidence intervals.\n",
- "7. **Normality testing:** S. S. Shapiro & M. B. Wilk, *An analysis of variance test for normality (complete samples)*, Biometrika 52(3–4), 591–611 (1965). [doi:10.1093/biomet/52.3-4.591](https://doi.org/10.1093/biomet/52.3-4.591)\n",
- "8. **Uncertainty in microstructure characterisation:** P. R. Shearing et al., *3D reconstruction of SOFC anodes using a focused ion beam lift-out technique*, Chemical Engineering Science 64(17), 3928–3933 (2009). [doi:10.1016/j.ces.2009.05.038](https://doi.org/10.1016/j.ces.2009.05.038)\n",
- "9. **Integral range and geostatistics:** D. Jeulin, *Random Texture Models for Material Structures*, Statistics and Computing 10, 121–132 (2000). [doi:10.1023/A:1008942325749](https://doi.org/10.1023/A:1008942325749). Relates the REV to the integral range of the underlying random field.\n",
- "10. **Statistical synchrotron diffusivity workflow:** J. Le Houx et al., *Statistical Effective Diffusivity Estimation in Porous Media Using an Integrated On-site Imaging Workflow for Synchrotron Users*, Transport in Porous Media 150, 71–88 (2023). [doi:10.1007/s11242-023-01993-7](https://doi.org/10.1007/s11242-023-01993-7)"
- ]
- }
- ],
- "metadata": {
- "kernelspec": {
- "display_name": "Python 3",
- "language": "python",
- "name": "python3"
- },
- "language_info": {
- "name": "python",
- "version": "3.10.0"
- }
- },
- "nbformat": 4,
- "nbformat_minor": 4
-}
diff --git a/tutorials/04_multiphase_and_fields.ipynb b/tutorials/04_multiphase_and_fields.ipynb
deleted file mode 100644
index 801ad5ba..00000000
--- a/tutorials/04_multiphase_and_fields.ipynb
+++ /dev/null
@@ -1,153 +0,0 @@
-{
- "cells": [
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": " \n\n# Tutorial 4 of 7: Multi-Phase Transport and Field Visualisation\n\n*OpenImpala Tutorial Series — From first solve to HPC deployment*\n\n---\n\nOpenImpala provides two approaches to computing transport properties:\n\n1. **Tortuosity solver** (`TortuosityHypre`) — Solves $\\nabla \\cdot (D\\,\\nabla\\varphi) = 0$ with Dirichlet boundary conditions and computes $\\tau$ from the resulting flux. This is what the high-level `oi.tortuosity()` function uses.\n2. **Effective diffusivity solver** (`EffectiveDiffusivityHypre`) — Solves the periodic cell problem $\\nabla \\cdot (D\\,\\nabla\\chi) = -\\nabla \\cdot (D\\,\\hat{e})$ to compute the effective diffusivity tensor via homogenisation.\n\nBoth give consistent results on binary structures, but the cell-problem approach generalises naturally to multi-phase composites with spatially varying $D(\\mathbf{x})$.\n\nThis tutorial covers both the effective diffusivity solver *and* multi-phase transport — the ability to assign different diffusion coefficients to different material phases, which is essential for real composite materials like battery electrodes with a carbon-binder domain (CBD).\n\n**What you will learn:**\n1. Use the `openimpala.core` module directly (lower-level than `oi.tortuosity()`).\n2. Solve the effective diffusivity cell problem on a binary structure.\n3. Visualise the corrector field using AMReX plotfiles and `yt`.\n4. Build and run a multi-phase transport problem with analytically known results.\n5. Construct a 3-phase battery electrode geometry and configure per-phase diffusivities.\n\n**Prerequisites:** [Tutorial 1](01_hello_openimpala.ipynb) for the high-level API. [Tutorial 2](02_digital_twin.ipynb) introduced `openimpala.core` and `yt` visualisation — we build on that here."
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": "# Install OpenImpala (compiled C++ backend needed for low-level API in this tutorial).\n# Auto-detect GPU vs CPU runtime.\nimport subprocess, sys\n\ndef _has_gpu():\n try:\n subprocess.check_output([\"nvidia-smi\"], stderr=subprocess.DEVNULL)\n return True\n except (FileNotFoundError, subprocess.CalledProcessError):\n return False\n\n_common = \"porespy yt matplotlib\"\nif _has_gpu():\n print(\"GPU detected — installing openimpala-cuda\")\n !pip install -q openimpala-cuda {_common}\nelse:\n print(\"No GPU detected — installing openimpala (CPU)\")\n !pip install -q openimpala {_common}"
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": "import os\nimport glob\nimport numpy as np\nimport matplotlib.pyplot as plt\nimport porespy as ps\nimport yt\n\nimport openimpala as oi\nfrom openimpala import core as oic # Low-level C++ API (pybind11 wrappers)\n\nprint(f\"OpenImpala version {oi.__version__} loaded.\")"
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": "## 1. Generating a Test Microstructure\n\nWe use PoreSpy to create a random porous structure with an anisotropic pore network. The structure is elongated in the Z-direction, so we expect lower tortuosity (easier transport) along Z than along X or Y."
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": "N = 64\nnp.random.seed(42)\n\nmicro = ps.generators.blobs(\n shape=[N, N, N],\n porosity=0.50,\n blobiness=1.5,\n).astype(np.int32)\n\nprint(f\"Microstructure: {micro.shape}, porosity = {micro.mean():.4f}\")\n\nfig, axes = plt.subplots(1, 3, figsize=(12, 4))\nfor ax, axis, label in zip(axes, [0, 1, 2], [\"X\", \"Y\", \"Z\"]):\n slc = np.take(micro, N // 2, axis=axis)\n ax.imshow(slc, cmap=\"gray\", interpolation=\"nearest\")\n ax.set_title(f\"Mid-plane slice ({label})\")\n ax.axis(\"off\")\nplt.tight_layout()\nplt.show()"
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": "## 2. Solving with the Core API\n\nThe high-level `oi.tortuosity()` function wraps several steps (VoxelImage creation, percolation check, volume fraction, solver construction). Here we perform those steps explicitly using `openimpala.core`, which gives more control — for example, enabling plotfile output.\n\nWe solve the **effective diffusivity cell problem** in the Z-direction with `write_plotfile=True` so we can visualise the corrector field afterwards.\n\n**Note on solver choice**: `EffectiveDiffusivityHypre` uses the HYPRE backend because there is no matrix-free MLMG variant for the homogenisation cell problem yet — that's a planned extension. For the scalar tortuosity comparison below we also use `TortuosityHypre` to keep the two solves on the same backend; in production code prefer `oi.tortuosity(..., solver='mlmg')` on GPU, which is typically 2-10× faster (see [Tutorial 1](01_hello_openimpala.ipynb))."
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": "out_dir = \"./effdiff_plotfiles\"\nos.makedirs(out_dir, exist_ok=True)\n\nwith oi.Session():\n # 1. Convert NumPy array to VoxelImage\n img = oic.VoxelImage.from_numpy(\n np.ascontiguousarray(micro, dtype=np.int32), max_grid_size=32\n )\n\n # 2. Compute volume fraction for reference\n vf_calc = oic.VolumeFraction(img, 1, 0)\n vf = vf_calc.value_vf()\n print(f\"Volume fraction (phase 1): {vf:.4f}\")\n\n # 3. Solve the effective diffusivity cell problem (Z-direction)\n print(\"\\nSolving cell problem (EffectiveDiffusivityHypre, Z-direction)...\")\n eff_solver = oic.EffectiveDiffusivityHypre(\n img,\n phase_id=1,\n dir=oic.Direction.Z,\n solver_type=oic.EffDiffSolverType.FlexGMRES,\n results_path=out_dir,\n verbose=1,\n write_plotfile=True,\n )\n converged = eff_solver.solve()\n print(f\"Converged: {converged} ({eff_solver.iterations} iterations, \"\n f\"residual = {eff_solver.residual_norm:.2e})\")\n\n # 4. For comparison, also solve with TortuosityHypre\n print(\"\\nSolving with TortuosityHypre for comparison...\")\n tau_solver = oic.TortuosityHypre(\n img, vf, 1, oic.Direction.Z, oic.SolverType.FlexGMRES,\n out_dir, 0.0, 1.0, 1, False,\n )\n tau = tau_solver.value()\n print(f\"Tortuosity (TortuosityHypre): {tau:.4f}\")"
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": "## 3. Visualising the Corrector Field\n\nThe effective diffusivity solver writes the corrector field $\\chi_z$ to an AMReX plotfile. We load it with [yt](https://yt-project.org/) and plot a slice. Regions where the field deviates strongly from zero indicate where the microstructure forces the diffusion flux to deviate from the imposed direction — this is the physical origin of tortuosity."
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": "# Find the generated plotfile directory\nplotfile_dirs = [d for d in glob.glob(f\"{out_dir}/*\") if os.path.isdir(d)]\nif plotfile_dirs:\n latest_plotfile = sorted(plotfile_dirs)[-1]\n print(f\"Loading plotfile: {latest_plotfile}\")\n\n yt.funcs.mylog.setLevel(40) # Suppress verbose yt logging\n ds = yt.load(latest_plotfile)\n\n # List available fields to find the corrector field name\n field_list = [f for f in ds.field_list if f[0] == \"boxlib\"]\n print(f\"Available fields: {field_list}\")\n\n # Plot a slice through the Y-midplane\n field_name = field_list[0] # Use the first available boxlib field\n slc = yt.SlicePlot(ds, normal=\"y\", fields=field_name)\n slc.set_log(field_name, False)\n slc.set_cmap(field_name, \"RdBu_r\")\n slc.annotate_title(f\"Corrector Field (Z-direction)\")\n slc.show()\nelse:\n print(\"No plotfile found — check that write_plotfile=True was set.\")"
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": "## 4. Multi-Phase Transport: Worked Example\n\nReal microstructures often contain more than two phases. A lithium-ion battery cathode, for example, has:\n- **Pore** ($D = D_\\text{bulk}$) — the electrolyte-filled void\n- **Carbon-binder domain (CBD)** ($D \\approx 0.1\\,D_\\text{bulk}$) — partially conducting\n- **Active material** ($D = 0$) — impermeable solid\n\nOpenImpala's multi-phase mode assigns a different diffusion coefficient to each phase via the `tortuosity.active_phases` and `tortuosity.phase_diffusivities` parameters. The HYPRE matrix fill then uses the harmonic mean of adjacent cell coefficients at each face:\n\n$$D_\\text{face} = \\frac{2\\,D_\\text{left}\\,D_\\text{right}}{D_\\text{left} + D_\\text{right}}$$\n\nThis is physically correct (series resistance across an interface) and ensures that a zero-diffusivity phase creates an impermeable boundary.\n\n### Analytical Benchmarks\n\nWe validate multi-phase transport using two classic composite geometries with known analytical solutions on a discrete $N$-cell grid:\n\n**Series layers** (layers perpendicular to flow) — the Reuss / harmonic bound:\n$$\\tau_\\text{series} = \\frac{(N-1)(D_0 + D_1)}{2N \\cdot D_0 \\cdot D_1}$$\n\n**Parallel layers** (layers parallel to flow) — the Voigt / arithmetic bound:\n$$\\tau_\\text{parallel} = \\frac{2(N-1)}{N(D_0 + D_1)}$$\n\nThese provide exact targets for validating the multi-phase solver."
- },
- {
- "cell_type": "code",
- "source": "# --- Build synthetic multi-phase structures ---\n# Alternating layers of phase 0 (D=1.0) and phase 1 (D=0.5)\n\nN_mp = 32\nD0, D1 = 1.0, 0.5\n\n# Series: layers perpendicular to flow (X-direction)\nseries = np.zeros((N_mp, N_mp, N_mp), dtype=np.int32)\nfor i in range(N_mp):\n series[:, :, i] = i % 2 # alternating layers along X\n\n# Parallel: layers parallel to flow (Y-direction layering, X flow)\nparallel = np.zeros((N_mp, N_mp, N_mp), dtype=np.int32)\nfor j in range(N_mp):\n parallel[:, j, :] = j % 2 # alternating layers along Y\n\n# Visualise both geometries\nfig, axes = plt.subplots(1, 2, figsize=(10, 4), dpi=120)\ncmap = plt.cm.colors.ListedColormap(['#4ECDC4', '#FF6B6B'])\n\nax = axes[0]\nax.imshow(series[N_mp//2, :, :], cmap=cmap, interpolation='nearest')\nax.set_title(\"Series layers\\n(perpendicular to X flow)\")\nax.set_xlabel(\"X (flow direction) →\")\nax.set_ylabel(\"Y\")\nax.set_aspect('equal')\n\nax = axes[1]\nax.imshow(parallel[N_mp//2, :, :], cmap=cmap, interpolation='nearest')\nax.set_title(\"Parallel layers\\n(parallel to X flow)\")\nax.set_xlabel(\"X (flow direction) →\")\nax.set_ylabel(\"Y\")\nax.set_aspect('equal')\n\n# Legend\nfrom matplotlib.patches import Patch\nlegend_elements = [Patch(facecolor='#4ECDC4', label=f'Phase 0 (D={D0})'),\n Patch(facecolor='#FF6B6B', label=f'Phase 1 (D={D1})')]\nfig.legend(handles=legend_elements, loc='lower center', ncol=2, fontsize=10,\n bbox_to_anchor=(0.5, -0.02))\nplt.tight_layout()\nplt.show()\n\nprint(f\"Grid size: {N_mp}^3\")\nprint(f\"Phase diffusivities: D0={D0}, D1={D1}\")",
- "metadata": {},
- "execution_count": null,
- "outputs": []
- },
- {
- "cell_type": "markdown",
- "source": "### Running the Multi-Phase Solver\n\nMulti-phase transport is configured via AMReX's `ParmParse` parameter database. When using the C++ executable (or the `openimpala.core` API), you specify which phases are active and their diffusion coefficients in an **inputs file**:\n\n```\ntortuosity.active_phases = 0 1\ntortuosity.phase_diffusivities = 1.0 0.5\n```\n\nBelow we generate inputs files for both the series and parallel geometries, write the phase data as a RAW binary file, and run the solver. This is the same workflow you would use on an HPC cluster — the only difference is the `mpirun` prefix.",
- "metadata": {}
- },
- {
- "cell_type": "code",
- "source": "# --- Solve both geometries with multi-phase coefficients ---\n# The multi-phase solver reads per-phase D values from ParmParse.\n# Here we use the core API with TortuosityHypre, which picks up\n# tortuosity.active_phases / phase_diffusivities automatically.\n\n# Analytical expectations for N=32, D0=1.0, D1=0.5:\ntau_series_exact = (N_mp - 1) * (D0 + D1) / (2 * N_mp * D0 * D1)\ntau_parallel_exact = 2 * (N_mp - 1) / (N_mp * (D0 + D1))\nprint(f\"Analytical targets (N={N_mp}, D0={D0}, D1={D1}):\")\nprint(f\" Series (Reuss/harmonic): tau = {tau_series_exact:.6f}\")\nprint(f\" Parallel (Voigt/arithmetic): tau = {tau_parallel_exact:.6f}\")\nprint()\n\n# Since multi-phase requires ParmParse configuration, we write inputs files\n# and show what the C++ executable would receive. The Python API solves\n# with the same underlying TortuosityHypre class.\n\nINPUTS_TEMPLATE = \"\"\"\\\n# Multi-phase transport: {geometry} layers\n# D0={D0}, D1={D1}, N={N}\n\ndomain_size = {N}\nbox_size = 16\nverbose = 1\nnum_phases_fill = 2\ndirection = X\n{layer_axis_line}\nsolver = FlexGMRES\n\nexpected_tau = {expected_tau}\ntau_tolerance = 0.001\n\nresultsdir = ./{geometry}_results\n\nhypre.maxiter = 500\nhypre.eps = 1e-9\n\ntortuosity.active_phases = 0 1\ntortuosity.phase_diffusivities = {D0} {D1}\ntortuosity.remspot_passes = 0\n\"\"\"\n\n# Generate and display inputs for both geometries\nfor geometry, layer_axis, expected_tau in [\n (\"series\", \"X\", tau_series_exact),\n (\"parallel\", \"Y\", tau_parallel_exact),\n]:\n layer_axis_line = f\"layer_axis = {layer_axis}\" if layer_axis != \"X\" else \"\"\n inputs_content = INPUTS_TEMPLATE.format(\n geometry=geometry, D0=D0, D1=D1, N=N_mp,\n layer_axis_line=layer_axis_line,\n expected_tau=f\"{expected_tau:.6f}\",\n )\n \n fname = f\"multiphase_{geometry}.inputs\"\n with open(fname, \"w\") as f:\n f.write(inputs_content)\n print(f\"Wrote {fname}\")\n\nprint(\"\\nTo run on an HPC cluster:\")\nprint(\" mpirun -np 16 ./Diffusion multiphase_series.inputs\")\nprint(\" mpirun -np 16 ./Diffusion multiphase_parallel.inputs\")",
- "metadata": {},
- "execution_count": null,
- "outputs": []
- },
- {
- "cell_type": "markdown",
- "source": "### Physical Interpretation\n\nThe series and parallel bounds bracket the effective transport for *any* composite of two materials with diffusivities $D_0$ and $D_1$:\n\n| Geometry | Physical analogy | Bound type | Tortuosity |\n|----------|-----------------|------------|------------|\n| **Series** (layers $\\perp$ flow) | Resistors in series | Reuss (harmonic) | Higher $\\tau$ (harder transport) |\n| **Parallel** (layers $\\parallel$ flow) | Resistors in parallel | Voigt (arithmetic) | Lower $\\tau$ (easier transport) |\n\nAny real microstructure's tortuosity must fall between these two extremes. The plot below shows where the bounds sit relative to a uniform material ($\\tau = (N-1)/N$).",
- "metadata": {}
- },
- {
- "cell_type": "code",
- "source": "# --- Visualise the bounds as a function of D1/D0 ratio ---\nratios = np.linspace(0.01, 1.0, 200)\ntau_uniform = (N_mp - 1) / N_mp\n\ntau_s = (N_mp - 1) * (1.0 + ratios) / (2 * N_mp * 1.0 * ratios)\ntau_p = 2 * (N_mp - 1) / (N_mp * (1.0 + ratios))\n\nfig, ax = plt.subplots(figsize=(8, 5), dpi=120)\nax.fill_between(ratios, tau_p, tau_s, alpha=0.15, color='#1f77b4',\n label='Feasible region')\nax.plot(ratios, tau_s, '-', color='#d62728', lw=2, label='Series (Reuss bound)')\nax.plot(ratios, tau_p, '-', color='#2ca02c', lw=2, label='Parallel (Voigt bound)')\nax.axhline(tau_uniform, color='gray', ls=':', lw=1, label=f'Uniform (tau={(N_mp-1)/N_mp:.4f})')\n\n# Mark the specific case D1/D0 = 0.5\nax.plot(D1/D0, tau_series_exact, 'o', color='#d62728', ms=10, zorder=5)\nax.plot(D1/D0, tau_parallel_exact, 'o', color='#2ca02c', ms=10, zorder=5)\nax.annotate(f'Series: tau={tau_series_exact:.4f}',\n xy=(D1/D0, tau_series_exact), xytext=(0.3, tau_series_exact + 0.15),\n arrowprops=dict(arrowstyle='->', color='#d62728'), fontsize=9, color='#d62728')\nax.annotate(f'Parallel: tau={tau_parallel_exact:.4f}',\n xy=(D1/D0, tau_parallel_exact), xytext=(0.3, tau_parallel_exact - 0.12),\n arrowprops=dict(arrowstyle='->', color='#2ca02c'), fontsize=9, color='#2ca02c')\n\nax.set_xlabel(r'$D_1 / D_0$', fontsize=12)\nax.set_ylabel(r'Tortuosity $\\tau$', fontsize=12)\nax.set_title(f'Reuss–Voigt Bounds for Two-Phase Composite (N={N_mp})', fontweight='bold')\nax.legend(loc='upper right', fontsize=9)\nax.set_xlim(0, 1.05)\nax.set_ylim(0, max(tau_s) * 1.1)\nax.grid(True, alpha=0.3)\nax.spines['top'].set_visible(False)\nax.spines['right'].set_visible(False)\nplt.tight_layout()\nplt.show()\n\nprint(f\"\\nFor D1/D0 = {D1/D0}:\")\nprint(f\" Series bound: tau = {tau_series_exact:.6f}\")\nprint(f\" Parallel bound: tau = {tau_parallel_exact:.6f}\")\nprint(f\" Ratio (series/parallel): {tau_series_exact/tau_parallel_exact:.2f}x\")",
- "metadata": {},
- "execution_count": null,
- "outputs": []
- },
- {
- "cell_type": "markdown",
- "source": "### Extension: Three-Phase Battery Electrode\n\nA realistic battery electrode has three phases. Below we construct a synthetic 3-phase microstructure and write the corresponding inputs file. The key insight is that phases with $D = 0$ are automatically excluded from the linear system — their matrix rows become $A_{ii} = 1$, $\\text{rhs}_i = 0$, decoupling them completely.\n\nThis means you can model:\n- **Pore** (phase 0): $D = 1.0$ — full electrolyte diffusivity\n- **CBD** (phase 1): $D = 0.1$ — reduced diffusivity through carbon-binder\n- **Active material** (phase 2): $D = 0$ — impermeable solid particle",
- "metadata": {}
- },
- {
- "cell_type": "code",
- "source": "# --- Synthetic 3-phase electrode microstructure ---\nN_3p = 48\nnp.random.seed(123)\n\n# Generate a pore/solid structure first\npore_solid = ps.generators.blobs(\n shape=[N_3p, N_3p, N_3p], porosity=0.35, blobiness=1.5\n).astype(np.int32)\n\n# Split the solid phase into CBD (phase 1) and active material (phase 2)\n# CBD forms a thin coating around the pore-solid interface\nfrom scipy.ndimage import binary_dilation, binary_erosion\nsolid_mask = (pore_solid == 0)\n# Erode the solid: the outer layer becomes CBD\neroded = binary_erosion(solid_mask, iterations=1)\ncbd_mask = solid_mask & ~eroded\n\nelectrode = np.zeros_like(pore_solid)\nelectrode[pore_solid == 1] = 0 # Pore\nelectrode[cbd_mask] = 1 # CBD (thin layer)\nelectrode[eroded] = 2 # Active material (bulk solid)\n\n# Phase fractions\nfor phase_id, name in [(0, \"Pore\"), (1, \"CBD\"), (2, \"Active material\")]:\n frac = (electrode == phase_id).mean()\n print(f\" Phase {phase_id} ({name:17s}): {frac:.4f} ({frac*100:.1f}%)\")\n\n# Visualise\nfig, axes = plt.subplots(1, 3, figsize=(14, 4), dpi=120)\ncmap_3p = plt.cm.colors.ListedColormap(['#4ECDC4', '#FFD93D', '#6C5B7B'])\n\nfor ax, axis, label in zip(axes, [0, 1, 2], [\"X\", \"Y\", \"Z\"]):\n slc = np.take(electrode, N_3p // 2, axis=axis)\n im = ax.imshow(slc, cmap=cmap_3p, interpolation='nearest', vmin=0, vmax=2)\n ax.set_title(f\"Mid-plane ({label})\")\n ax.axis(\"off\")\n\nlegend_elements = [\n Patch(facecolor='#4ECDC4', label='Phase 0: Pore (D=1.0)'),\n Patch(facecolor='#FFD93D', label='Phase 1: CBD (D=0.1)'),\n Patch(facecolor='#6C5B7B', label='Phase 2: Active (D=0)'),\n]\nfig.legend(handles=legend_elements, loc='lower center', ncol=3, fontsize=9,\n bbox_to_anchor=(0.5, -0.02))\nplt.suptitle(\"Synthetic 3-Phase Battery Electrode\", fontweight='bold')\nplt.tight_layout()\nplt.show()\n\n# Write the corresponding inputs file\ninputs_3phase = f\"\"\"\\\n# Three-phase battery electrode example\n# Pore (D=1.0), CBD (D=0.1), Active material (D=0, impermeable)\n\n# Image configuration (for use with RawReader or NumPy input)\ndomain_size = {N_3p}\nbox_size = 16\nverbose = 1\ndirection = Z\nsolver = FlexGMRES\n\nresultsdir = ./electrode_3phase_results\n\nhypre.maxiter = 1000\nhypre.eps = 1e-9\n\n# --- Three-phase configuration ---\n# Phase 0 = pore, Phase 1 = CBD, Phase 2 = active material\n# Only phases with D > 0 participate in transport\ntortuosity.active_phases = 0 1\ntortuosity.phase_diffusivities = 1.0 0.1\ntortuosity.remspot_passes = 0\n\"\"\"\n\nwith open(\"electrode_3phase.inputs\", \"w\") as f:\n f.write(inputs_3phase)\nprint(\"\\nWrote electrode_3phase.inputs\")\nprint(\"Note: Phase 2 (active material) is NOT listed in active_phases,\")\nprint(\"so it is automatically treated as impermeable (D=0).\")",
- "metadata": {},
- "execution_count": null,
- "outputs": []
- },
- {
- "cell_type": "markdown",
- "source": [
- "## Next Steps\n",
- "\n",
- "This tutorial demonstrated the effective diffusivity cell-problem solver, field visualisation, and multi-phase transport with analytically validated benchmarks. The key points:\n",
- "\n",
- "- **Effective diffusivity** via homogenisation gives the full $D_\\text{eff}$ tensor, not just scalar tortuosity.\n",
- "- **Multi-phase transport** assigns per-phase diffusion coefficients via `tortuosity.active_phases` and `tortuosity.phase_diffusivities` in the inputs file.\n",
- "- **Analytical validation** against Reuss (series) and Voigt (parallel) bounds confirms the harmonic mean face coefficient implementation.\n",
- "- **Three-phase structures** (pore/CBD/solid) are handled naturally — phases with $D=0$ are decoupled automatically.\n",
- "\n",
- "For the test inputs used in OpenImpala's CI/CD regression suite, see `tests/inputs/tMultiPhaseTransport*.inputs`.\n",
- "\n",
- "**Continue the series:**\n",
- "- [Tutorial 5: Surrogate Modelling](05_surrogate_modelling.ipynb) — Generate labelled datasets for machine learning.\n",
- "- [Tutorial 6: Topology Optimisation](06_topology_optimisation.ipynb) — Use OpenImpala as a cost-function evaluator in an optimisation loop.\n",
- "- [Tutorial 7: Scaling to HPC](07_hpc_scaling.ipynb) — Run on larger datasets with MPI.\n",
- "\n",
- "---\n",
- "\n",
- "## References & Further Reading\n",
- "\n",
- "1. **OpenImpala:** J. Le Houx & D. Kramer, *OpenImpala: OPEN source IMage based PArallisable Linear Algebra solver*, SoftwareX 15, 100729 (2021). [doi:10.1016/j.softx.2021.100729](https://doi.org/10.1016/j.softx.2021.100729)\n",
- "2. **Homogenisation theory:** S. Torquato, *Random Heterogeneous Materials: Microstructure and Macroscopic Properties*, Springer (2002). Chapter 17 covers the cell problem for effective conductivity.\n",
- "3. **Reuss and Voigt bounds:** W. Voigt, *Lehrbuch der Kristallphysik*, Teubner (1928); A. Reuss, *Berechnung der Fliessgrenze von Mischkristallen*, Z. Angew. Math. Mech. 9, 49–58 (1929). The harmonic (Reuss) and arithmetic (Voigt) means give the tightest possible bounds without geometric information.\n",
- "4. **Effective diffusivity in electrodes:** L. Holzer et al., *Microstructure–property relationships in a gas diffusion layer (GDL) for Polymer Electrolyte Fuel Cells, Part I: effect of compression and anisotropy of dry GDL*, Electrochimica Acta 227, 419–434 (2017). [doi:10.1016/j.electacta.2017.01.030](https://doi.org/10.1016/j.electacta.2017.01.030)\n",
- "5. **Carbon-binder domain modelling:** F. L. E. Usseglio-Viretta et al., *Resolving the discrepancy in tortuosity factor estimation for Li-ion battery electrodes through micro-macro modeling and experiment*, J. Electrochem. Soc. 165(14), A3403 (2018). [doi:10.1149/2.0731814jes](https://doi.org/10.1149/2.0731814jes)\n",
- "6. **yt for AMReX data:** M. J. Turk et al., *yt: A multi-code analysis toolkit for astrophysical simulation data*, Astrophys. J. Suppl. 192, 9 (2011). [doi:10.1088/0067-0049/192/1/9](https://doi.org/10.1088/0067-0049/192/1/9)\n",
- "7. **Statistical synchrotron diffusivity workflow:** J. Le Houx et al., *Statistical Effective Diffusivity Estimation in Porous Media Using an Integrated On-site Imaging Workflow for Synchrotron Users*, Transport in Porous Media 150, 71–88 (2023). [doi:10.1007/s11242-023-01993-7](https://doi.org/10.1007/s11242-023-01993-7)"
- ],
- "metadata": {}
- }
- ],
- "metadata": {
- "kernelspec": {
- "display_name": "Python 3",
- "language": "python",
- "name": "python3"
- },
- "language_info": {
- "name": "python",
- "version": "3.10.0"
- }
- },
- "nbformat": 4,
- "nbformat_minor": 4
-}
diff --git a/tutorials/04_multiphase_transport.ipynb b/tutorials/04_multiphase_transport.ipynb
new file mode 100644
index 00000000..9011ca74
--- /dev/null
+++ b/tutorials/04_multiphase_transport.ipynb
@@ -0,0 +1,447 @@
+{
+ "cells": [
+ {
+ "cell_type": "markdown",
+ "id": "04-multiphas-00",
+ "metadata": {},
+ "source": [
+ "[](https://colab.research.google.com/github/BASE-Laboratory/OpenImpala/blob/master/tutorials/04_multiphase_transport.ipynb)\n",
+ "\n",
+ "# Multi-Phase Transport in Composite Media\n",
+ "\n",
+ "Composite porous materials—such as lithium-ion battery cathodes (liquid electrolyte pore + nanoporous carbon-binder domain + active oxide), solid-state composite electrolytes, and partially saturated rocks—contain multiple phases with distinct finite transport coefficients $D_p \\ge 0$. OpenImpala solves the variable-coefficient conservation law\n",
+ "\n",
+ "$$-\\nabla \\cdot \\bigl(D(\\mathbf{x})\\,\\nabla \\phi\\bigr) = 0, \\qquad D_{i+1/2} = \\frac{2 D_i D_j}{D_i + D_j},$$\n",
+ "\n",
+ "using harmonic-mean face conductances across phase interfaces so normal flux continuity is satisfied exactly on the voxel grid."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": 1,
+ "id": "04-multiphas-01",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2026-11-18T09:44:29.757040Z",
+ "iopub.status.busy": "2026-11-18T09:44:29.756881Z",
+ "iopub.status.idle": "2026-11-18T09:44:29.763301Z",
+ "shell.execute_reply": "2026-11-18T09:44:29.762553Z"
+ },
+ "tags": [
+ "remove-cell"
+ ]
+ },
+ "outputs": [],
+ "source": [
+ "import sys\n",
+ "\n",
+ "if \"google.colab\" in sys.modules:\n",
+ " !pip install -q openimpala matplotlib scipy"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": 2,
+ "id": "04-multiphas-02",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2026-11-18T09:44:29.765842Z",
+ "iopub.status.busy": "2026-11-18T09:44:29.765655Z",
+ "iopub.status.idle": "2026-11-18T09:44:30.307620Z",
+ "shell.execute_reply": "2026-11-18T09:44:30.307129Z"
+ }
+ },
+ "outputs": [],
+ "source": [
+ "import matplotlib.pyplot as plt\n",
+ "import numpy as np\n",
+ "from scipy import ndimage\n",
+ "import openimpala as oi\n",
+ "\n",
+ "plt.rcParams.update({\n",
+ " \"figure.dpi\": 120,\n",
+ " \"axes.spines.top\": False,\n",
+ " \"axes.spines.right\": False,\n",
+ " \"font.size\": 10,\n",
+ "})"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "04-multiphas-03",
+ "metadata": {},
+ "source": [
+ "## Verification Against Exact Wiener (Voigt and Reuss) Bounds\n",
+ "\n",
+ "For an equal-volume two-phase laminate with phase diffusivities $D_1 = 1$ and $D_2 = \\kappa \\in (0, 1]$, transport parallel to the layers follows the arithmetic Voigt bound and transport normal to the layers follows the harmonic Reuss bound:\n",
+ "\n",
+ "$$D_{\\parallel}(\\kappa) = \\frac{1 + \\kappa}{2}, \\qquad D_{\\perp}(\\kappa) = \\frac{2\\kappa}{1 + \\kappa}.$$"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": 3,
+ "id": "04-multiphas-04",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2026-11-18T09:44:30.310674Z",
+ "iopub.status.busy": "2026-11-18T09:44:30.310377Z",
+ "iopub.status.idle": "2026-11-18T09:44:30.439542Z",
+ "shell.execute_reply": "2026-11-18T09:44:30.438658Z"
+ }
+ },
+ "outputs": [],
+ "source": [
+ "slab = np.zeros((16, 16, 16), dtype=np.int32)\n",
+ "slab[:, :, :8] = 1 # interface normal to X (axis 2)\n",
+ "\n",
+ "ratios = np.logspace(-3, 0, 7)\n",
+ "d_voigt_num, d_reuss_num = [], []\n",
+ "\n",
+ "for kappa in ratios:\n",
+ " coeffs = {0: float(kappa), 1: 1.0}\n",
+ " d_voigt_num.append(oi.tortuosity(slab, direction=\"z\", phase_diffusivities=coeffs).effective_diffusivity)\n",
+ " d_reuss_num.append(oi.tortuosity(slab, direction=\"x\", phase_diffusivities=coeffs).effective_diffusivity)\n",
+ "\n",
+ "d_voigt_exact = 0.5 * (1.0 + ratios)\n",
+ "d_reuss_exact = 2.0 * ratios / (1.0 + ratios)\n",
+ "assert np.allclose(d_voigt_num, d_voigt_exact, rtol=1e-5)\n",
+ "assert np.allclose(d_reuss_num, d_reuss_exact, rtol=1e-5)"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": 4,
+ "id": "04-multiphas-05",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2026-11-18T09:44:30.441937Z",
+ "iopub.status.busy": "2026-11-18T09:44:30.441734Z",
+ "iopub.status.idle": "2026-11-18T09:44:30.790548Z",
+ "shell.execute_reply": "2026-11-18T09:44:30.787130Z"
+ }
+ },
+ "outputs": [
+ {
+ "data": {
+ "image/png": "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tRe1devWQPJEq9QURSEqKnO947nln3/+ITAwkCJFigDJqz94eXnRoEEDILm3u1KlSlrJ2M6dO9M9p7e3N4mJibRp00Yte/z4MRcvXqRcuXLptq1ZsyY3b9582dvJkqdPnxIdHU3r1q3VhDgkJITjx49To0YNrbrDhw9n3rx5vP/++9y+fVtr2EuZMmVwcXGhb9++zJihPQM5JiYmw5U6wsPDsba2xtnZGWdnZwYMGICFhQVHjhzRSopv3rxJly5dsnnXQgghsuKRXwhfbTqBM49pZHAZAJOSblg37JfPkeUOSYpfETaWZozoVI9lW0+nWWdEp3rYWObex+vTp0/n+vXrtGrViqlTp9KgQQOCgoJYtWoV586d448//sDOzk6rzZkzZxg2bBg9evTg+vXrzJkzh7lz52JrawvAkiVLaNy4Mf369aNHjx5YWVlx69YtVq9ezbJly9RxqPlBURTatWvH9OnTiY2NZe7cuXh4eNC5c2cA2rZty8qVK/n000+pW7cup0+f5uuvv073nNWrV8fJyYnRo0czYcIEAgICWLBgQaY2Pmnbti3vvvsuMTExuT6MomzZsri4uDB58mQ++ugjIiMj+fzzz/XukFekSBF69+7Nd999R6NGjdThEClWrVpF586def78OS1atECj0XDp0iXWrFnD2bNnKVy4cJpx9OjRgwoVKtCsWTPs7OzYvXs3xsbGNG3aVK1z48YNnj9/rvVGQwghRO5KSlKYveog0XEJDDDYq5YX6bEQjUH6HR6vK0mKXyGjOieP131xnWJTY0N1neLcZGhoyK+//sq+ffvYvHkzR44cwcLCgqZNm7JhwwYcHR112vzvf//D39+flStXEh8fz/LlyxkyZIh6vEyZMly+fJkVK1awevVqEhMTqVy5Mr/88gtVq1YFkodaNGrUCFNT7Y9i3NzctBIqFxcXrRUr7O3tadSokU5vZKNGjXRirVKlik69Tp060bVrV7Zv346vry+9e/dm2rRpas9ply5d2LRpE7/++iuHDx/GxcWFAwcOMGnSJK03Bw0bNlQnyFlbW3Ps2DG++OILlixZQuHChfn444+5cOECVlZW6T7/3bp1Y8KECWzfvp2+ffumW/dluLu7q2s4GxoacvjwYRYvXszSpUspVKgQY8eOJSAgAD8/P522gwcP5ueff9a7gUvTpk25cOECP/zwA99+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",
+ "text/plain": [
+ ""
+ ]
+ },
+ "metadata": {},
+ "output_type": "display_data"
+ }
+ ],
+ "source": [
+ "k_fine = np.logspace(-3, 0, 200)\n",
+ "fig, ax = plt.subplots(figsize=(5.8, 3.6), constrained_layout=True)\n",
+ "\n",
+ "ax.semilogx(k_fine, 0.5 * (1.0 + k_fine), color=\"#2b5c8f\", lw=1.6, label=r\"Voigt bound $(1 + \\kappa)/2$\")\n",
+ "ax.semilogx(ratios, d_voigt_num, \"o\", color=\"#2b5c8f\", ms=5, label=r\"OpenImpala ($\\parallel$ layers)\")\n",
+ "ax.semilogx(k_fine, 2.0 * k_fine / (1.0 + k_fine), color=\"#d95f02\", lw=1.6, label=r\"Reuss bound $2\\kappa/(1 + \\kappa)$\")\n",
+ "ax.semilogx(ratios, d_reuss_num, \"s\", color=\"#d95f02\", ms=5, label=r\"OpenImpala ($\\perp$ layers)\")\n",
+ "\n",
+ "ax.set_xlabel(r\"Diffusivity contrast $\\kappa = D_2 / D_1$\")\n",
+ "ax.set_ylabel(r\"Effective diffusivity $D_{\\mathrm{eff}} / D_1$\")\n",
+ "ax.set_title(\"Multi-phase Voigt and Reuss verification\")\n",
+ "ax.legend(frameon=False, fontsize=9)\n",
+ "plt.show()"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "04-multiphas-06",
+ "metadata": {},
+ "source": [
+ "## Bridging Across Pinched Pore Throats in a 3-Phase Electrode\n",
+ "\n",
+ "In composite electrodes, a nanoporous binder or interphase layer (`phase=2`) coats the insulating solid matrix (`phase=0`) and narrows or closes off the primary macropore network (`phase=1`). We construct such a 3-phase volume from `two_phase_cubic()` by assigning a 1-voxel interfacial shell of the pore space to `phase=2`:"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": 5,
+ "id": "04-multiphas-07",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2026-11-18T09:44:30.796210Z",
+ "iopub.status.busy": "2026-11-18T09:44:30.795844Z",
+ "iopub.status.idle": "2026-11-18T09:44:30.813868Z",
+ "shell.execute_reply": "2026-11-18T09:44:30.813423Z"
+ }
+ },
+ "outputs": [
+ {
+ "name": "stdout",
+ "output_type": "stream",
+ "text": [
+ "Phase 0 (Insulating solid ): 0.601\n",
+ "Phase 1 (Open macropore ): 0.105\n",
+ "Phase 2 (Nanoporous binder ): 0.294\n"
+ ]
+ },
+ {
+ "data": {
+ "text/html": [
+ "Metric Value Direction Z Percolates No Active VF 0.000000
"
+ ],
+ "text/plain": [
+ "PercolationResult(percolates=False, active_volume_fraction=0.0, direction='Z')"
+ ]
+ },
+ "execution_count": 5,
+ "metadata": {},
+ "output_type": "execute_result"
+ }
+ ],
+ "source": [
+ "base = oi.datasets.two_phase_cubic()\n",
+ "pore = base == 1\n",
+ "macropore = ndimage.binary_erosion(pore, iterations=1)\n",
+ "\n",
+ "composite = np.zeros_like(base) # phase 0: insulating active particles (D = 0)\n",
+ "composite[pore & ~macropore] = 2 # phase 2: nanoporous binder shell\n",
+ "composite[macropore] = 1 # phase 1: open electrolyte macropores\n",
+ "\n",
+ "for pid, label in ((0, \"Insulating solid\"), (1, \"Open macropore\"), (2, \"Nanoporous binder\")):\n",
+ " print(f\"Phase {pid} ({label:18s}): {np.mean(composite == pid):.3f}\")\n",
+ "\n",
+ "oi.percolation_check(composite, phase=1, direction=\"z\")"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "04-multiphas-08",
+ "metadata": {},
+ "source": [
+ "Because the eroded macropores (`phase=1`) no longer percolate on their own, a single-phase pore solve would predict zero macroscopic transport. Including physical SI ionic diffusivities (`phase 1`: $D_{\\text{pore}} = 3.0 \\times 10^{-10}\\;\\mathrm{m^2\\,s^{-1}}$, `phase 2`: $D_{\\text{binder}} = 3.0 \\times 10^{-11}\\;\\mathrm{m^2\\,s^{-1}}$, `phase 0`: $0$) restores conduction via series bridges across the binder necks:"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": 6,
+ "id": "04-multiphas-09",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2026-11-18T09:44:30.816103Z",
+ "iopub.status.busy": "2026-11-18T09:44:30.815934Z",
+ "iopub.status.idle": "2026-11-18T09:44:35.104397Z",
+ "shell.execute_reply": "2026-11-18T09:44:35.103172Z"
+ }
+ },
+ "outputs": [
+ {
+ "data": {
+ "text/html": [
+ "Metric Value Tortuosity 59966706832.893494 Effective diffusivity 6.620902e-12 Solver status converged Iterations 871 Residual norm 9.83e-10 Flux in -2.118689e-16 Flux out -2.118689e-16 Active VF 0.397034
"
+ ],
+ "text/plain": [
+ "TortuosityResult(tortuosity=59966706832.89349, solver_converged=True, iterations=871, residual_norm=9.82977250015211e-10, flux_in=-2.118688663350456e-16, flux_out=-2.1186886594703712e-16, active_volume_fraction=0.39703369140625, solution_field=array([[[0.00000000e+00, 9.32664655e-03, 8.97316794e-03, ...,\n",
+ " 0.00000000e+00, 0.00000000e+00, 1.29005846e-04],\n",
+ " [0.00000000e+00, 8.53029865e-03, 8.12404091e-03, ...,\n",
+ " 5.64410085e-03, 1.41906447e-03, 3.87017561e-04],\n",
+ " [7.94832351e-04, 2.38449694e-03, 2.59735367e-03, ...,\n",
+ " 3.13665658e-03, 1.06420395e-03, 0.00000000e+00],\n",
+ " ...,\n",
+ " [0.00000000e+00, 0.00000000e+00, 1.48947448e-02, ...,\n",
+ " 0.00000000e+00, 0.00000000e+00, 5.79952386e-03],\n",
+ " [0.00000000e+00, 0.00000000e+00, 0.00000000e+00, ...,\n",
+ " 0.00000000e+00, 0.00000000e+00, 0.00000000e+00],\n",
+ " [0.00000000e+00, 0.00000000e+00, 0.00000000e+00, ...,\n",
+ " 0.00000000e+00, 0.00000000e+00, 0.00000000e+00]],\n",
+ "\n",
+ " [[0.00000000e+00, 2.91297663e-02, 2.78691977e-02, ...,\n",
+ " 2.29644025e-02, 0.00000000e+00, 0.00000000e+00],\n",
+ " [4.10490769e-02, 3.13466075e-02, 2.90616051e-02, ...,\n",
+ " 2.29117708e-02, 0.00000000e+00, 0.00000000e+00],\n",
+ " [0.00000000e+00, 0.00000000e+00, 0.00000000e+00, ...,\n",
+ " 1.03946120e-02, 0.00000000e+00, 0.00000000e+00],\n",
+ " ...,\n",
+ " [0.00000000e+00, 3.96388327e-02, 3.47597951e-02, ...,\n",
+ " 0.00000000e+00, 2.00226307e-02, 1.80750606e-02],\n",
+ " [4.32664949e-02, 4.17705582e-02, 3.86857913e-02, ...,\n",
+ " 0.00000000e+00, 0.00000000e+00, 2.31718608e-02],\n",
+ " [0.00000000e+00, 4.18032111e-02, 3.98144908e-02, ...,\n",
+ " 0.00000000e+00, 0.00000000e+00, 0.00000000e+00]],\n",
+ "\n",
+ " [[5.37730681e-02, 4.79766136e-02, 4.57973338e-02, ...,\n",
+ " 0.00000000e+00, 0.00000000e+00, 0.00000000e+00],\n",
+ " [5.07515464e-02, 4.89622908e-02, 5.04140280e-02, ...,\n",
+ " 5.24860729e-02, 0.00000000e+00, 0.00000000e+00],\n",
+ " [0.00000000e+00, 0.00000000e+00, 0.00000000e+00, ...,\n",
+ " 0.00000000e+00, 0.00000000e+00, 0.00000000e+00],\n",
+ " ...,\n",
+ " [4.49822644e-02, 4.33454213e-02, 3.97409833e-02, ...,\n",
+ " 0.00000000e+00, 2.67171323e-02, 2.59681744e-02],\n",
+ " [4.47624316e-02, 4.37989046e-02, 4.18195741e-02, ...,\n",
+ " 3.39139650e-02, 3.03418160e-02, 2.82686609e-02],\n",
+ " [4.52984844e-02, 4.38245844e-02, 4.18448847e-02, ...,\n",
+ " 3.71125603e-02, 0.00000000e+00, 3.00426400e-02]],\n",
+ "\n",
+ " ...,\n",
+ "\n",
+ " [[0.00000000e+00, 0.00000000e+00, 9.77279124e-01, ...,\n",
+ " 9.82703985e-01, 9.81176440e-01, 9.80793597e-01],\n",
+ " [0.00000000e+00, 9.88011882e-01, 9.81706236e-01, ...,\n",
+ " 9.83297041e-01, 9.81266400e-01, 9.81323860e-01],\n",
+ " [9.90474574e-01, 9.89970241e-01, 9.86537990e-01, ...,\n",
+ " 9.81613712e-01, 0.00000000e+00, 0.00000000e+00],\n",
+ " ...,\n",
+ " [0.00000000e+00, 0.00000000e+00, 0.00000000e+00, ...,\n",
+ " 0.00000000e+00, 9.96080387e-01, 9.95773383e-01],\n",
+ " [0.00000000e+00, 0.00000000e+00, 0.00000000e+00, ...,\n",
+ " 0.00000000e+00, 9.97560599e-01, 9.97015554e-01],\n",
+ " [9.49580991e-01, 9.51367692e-01, 0.00000000e+00, ...,\n",
+ " 9.98571487e-01, 9.98095391e-01, 9.97592433e-01]],\n",
+ "\n",
+ " [[9.95727688e-01, 9.93068068e-01, 9.88388421e-01, ...,\n",
+ " 9.84634988e-01, 9.84014260e-01, 9.83923068e-01],\n",
+ " [0.00000000e+00, 9.90756875e-01, 9.87689172e-01, ...,\n",
+ " 9.84878700e-01, 9.86322543e-01, 9.86961346e-01],\n",
+ " [0.00000000e+00, 9.90674267e-01, 9.87916781e-01, ...,\n",
+ " 9.85441378e-01, 0.00000000e+00, 0.00000000e+00],\n",
+ " ...,\n",
+ " [0.00000000e+00, 0.00000000e+00, 0.00000000e+00, ...,\n",
+ " 0.00000000e+00, 9.97643101e-01, 9.97457661e-01],\n",
+ " [0.00000000e+00, 9.89321980e-01, 9.92245200e-01, ...,\n",
+ " 9.98933378e-01, 9.98380355e-01, 9.98169445e-01],\n",
+ " [9.73698579e-01, 9.79594853e-01, 9.89605020e-01, ...,\n",
+ " 9.99047583e-01, 9.98657044e-01, 9.98471618e-01]],\n",
+ "\n",
+ " [[9.98387307e-01, 9.97399289e-01, 9.96089431e-01, ...,\n",
+ " 0.00000000e+00, 0.00000000e+00, 0.00000000e+00],\n",
+ " [9.98809559e-01, 9.96850927e-01, 9.94659447e-01, ...,\n",
+ " 9.93574651e-01, 9.95673337e-01, 9.96275915e-01],\n",
+ " [0.00000000e+00, 9.96331323e-01, 9.94511582e-01, ...,\n",
+ " 9.94916345e-01, 9.97866915e-01, 9.98744892e-01],\n",
+ " ...,\n",
+ " [0.00000000e+00, 0.00000000e+00, 9.99117838e-01, ...,\n",
+ " 0.00000000e+00, 9.99169329e-01, 9.99141284e-01],\n",
+ " [0.00000000e+00, 9.96125888e-01, 9.97326466e-01, ...,\n",
+ " 9.99581744e-01, 9.99318562e-01, 9.99349473e-01],\n",
+ " [9.91919893e-01, 9.93980994e-01, 9.96245331e-01, ...,\n",
+ " 9.99656779e-01, 9.99516656e-01, 9.99467549e-01]]],\n",
+ " shape=(64, 64, 64)), effective_diffusivity=6.620902036735914e-12)"
+ ]
+ },
+ "execution_count": 6,
+ "metadata": {},
+ "output_type": "execute_result"
+ }
+ ],
+ "source": [
+ "d_pore = 3.0e-10 # m^2/s\n",
+ "res_comp = oi.tortuosity(\n",
+ " composite,\n",
+ " direction=\"z\",\n",
+ " voxel_size=0.5e-6,\n",
+ " phase_diffusivities={0: 0.0, 1: d_pore, 2: 0.1 * d_pore},\n",
+ " return_field=True,\n",
+ ")\n",
+ "res_comp"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "04-multiphas-10",
+ "metadata": {},
+ "source": [
+ "Sweeping $D_{\\text{binder}} / D_{\\text{pore}} \\in [0.01, 1]$ across the typical nanoporous binder range quantifies the transition from binder-limited choke points ($D_{\\text{eff}} \\propto D_{\\text{binder}}$) to open two-phase conduction:"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": 7,
+ "id": "04-multiphas-11",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2026-11-18T09:44:35.106354Z",
+ "iopub.status.busy": "2026-11-18T09:44:35.106172Z",
+ "iopub.status.idle": "2026-11-18T09:45:13.953969Z",
+ "shell.execute_reply": "2026-11-18T09:45:13.953500Z"
+ }
+ },
+ "outputs": [
+ {
+ "data": {
+ "image/png": "iVBORw0KGgoAAAANSUhEUgAABW0AAAG9CAYAAABu5lSPAAAAOnRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjExLjIsIGh0dHBzOi8vbWF0cGxvdGxpYi5vcmcvgI3uAAAAAAlwSFlzAAASdAAAEnQB3mYfeAABAABJREFUeJzsnXd4FFX3x7/b0wmBkA4JAUIHJSDSe3ktIIioiIKgIqKIoIgNEBVEXywoKEUFsQAvXaQKKIpApElokkoSUgnpydb7+yO/GXezs5vZlt0k58Ozz0PuPefee2bOtDN37pEwxhgIgiAIgiAIgiAIgiAIgiAIj0Dq7gEQBEEQBEEQBEEQBEEQBEEQ/0JBW4IgCIIgCIIgCIIgCIIgCA+CgrYEQRAEQRAEQRAEQRAEQRAeBAVtCYIgCIIgCIIgCIIgCIIgPAgK2hIEQRAEQRAEQRAEQRAEQXgQFLQlCIIgCIIgCIIgCIIgCILwIChoSxAEQRAEQRAEQRAEQRAE4UFQ0JYgCIIgCIIgCIIgCIIgCMKDoKAtQRAEQRAEQRAEQRAEQRCEB0FBW4IgCIIgCIIgCIIgCIIgCA+iUQdt9Xo99u/fj+effx6jR49G3759MXHiRKxfvx4ajcbl/f/000+Ij4/HDz/84PK+6jOTJk1C79693T0MwoN58cUXMWbMGDDG3D2UWvnnn3/wySefYPTo0YiPj8cLL7wgSu/atWt49dVXMXLkSAwZMgSzZ8/GxYsXXTxa51BYWIi7774bq1evdvdQ3EpZWRnWr1+Pxx57DIMHD8agQYPwyCOP4LXXXsOpU6fcPTyP5cKFC4iPj8eKFSvcPZRGzQcffID4+HgkJiY61M706dMRHx/v0H3WwYMHIZFI8NZbbzk0jkmTJpmVFxcXIz4+3uR39913Y9SoUZg9ezZ27doFnU5nd7/GLF++HL169UJRURFftnbtWpO+e/bsiYEDB+LBBx/Eu+++i3/++ccpfbua5ORkzJkzB4MHD8bQoUMxf/58ZGZm2tyOVqvFsWPH8Morr6BPnz6Ij4/Hvn37LMpb2q8EQRAEQRD1EtaIufPOOxkAwV+XLl1Ybm6uS/v/+uuvGQD20UcfubSf+k63bt2YTCZz9zDsYtu2baxHjx5s586d7h6KIK+88grr0aMHu3nzpruHYjenTp1iEomEffbZZ+4eSq089NBDZueakSNH1qr36aefMqVSaaYrkUjYkSNH6mDkjvPkk0+ywMBAduvWLXcPxS1s376dBQcHW7zmAGATJ0509zA9kuPHjzMAbPbs2SblL774IuvRowcrKChwz8CcyKlTp1iPHj3YypUr3TaG77//nvXo0YP9/PPPgvXPPfccA8D+/PNPh/rp27cvA8AqKyvtbmPp0qUMANu+fbtd+gcPHmQA2KZNm8zqjh07ZvU4BcDatWvH/vrrL7vHz9G6dWvWs2dPk7IHH3yw1v6nT5/O1Gq1w/27isOHDzMfHx+zcQcGBrKEhATR7RQUFLCAgACzdr799luLOtu3b2cA2K5du5xhCkE0ehYuXGh2DHp7e7P27duzefPm1dv7uqFDhzIA7Pbt2w2iH1vo1q0bc3YYyB47586dywCwo0ePuqV/Qhh7t6Wz9gHtS3Ma9UxbtVqNCRMmYPXq1Th8+DAOHTqE5cuXIyQkBBcvXsTLL7/s7iESAL7//vt6OwstLy8PZ86cQX5+vruHIkhycjLOnDkDtVrt7qHYzfz58xESEoKnnnrK3UOplcLCQrRt2xYvvPAC3nvvPVE6mzdvxgsvvACNRoMHH3wQu3btwh9//IE1a9agW7duKC8vd/GoncNrr72G4uJiLF261N1DqXO2bNmC8ePHIz8/H3feeSc++eQTHDlyBL/99ht+/PFHLFu2DHfffTeKi4vdPVSPpHv37khISMDcuXNNyq9fv44zZ85Aq9W6aWTOo6SkBGfOnLFrJqKzyM3NxZkzZ3Dr1i3B+ldeeQUJCQno0qVLHY/MnLNnzwIA7rjjDrv058+fj9jYWDzyyCNmdefOnQMAjB8/HgkJCUhISMCJEyewa9cuvPbaawgJCcE///yDESNG4MaNG3bbcOHCBaSkpOCBBx4Q7H/z5s18/8eOHcPXX3+N8ePHQyKRYN26dXj66aft7tuVlJSU4OGHH0ZFRQXGjRuHQ4cOYd++fRg1ahSKioowYcIE0bOstVotKisrMXDgQLz//vu49957a9UZO3YsOnXqhAULFtSLr28Ioj5SWVmJq1ev4sMPP0R8fDwKCgrcPSS30a9fP0gkElRVVbl7KAThUtzt6+7u353I3T0Ad3Ly5En4+fmZlA0bNgx9+vRBv379cPDgQTeNjDCmY8eO7h4C4aEkJibi2LFjeOmll6BUKt09nFrZvHkzgoKCAAC///57rfJVVVV4/vnnAQALFiwwCfT26dMHTz31FCorK10zWCcTGxuLfv364auvvsKSJUvg5eXl7iHVCfn5+Zg+fToYY5g7dy4++OADSCQSM7n58+dT0NYCfn5+iI+Pd/cwGj0tW7ZEy5Yt3T0MAMCZM2fQtGlTREdH26x7/PhxnDt3Dm+//TakUvO5C+fPnwcADB061Mzv7r//fsybNw8DBgxAYmIi3n33XXz55Zf2mIAdO3YAAMaNG8eXlZaWIiUlBSqVCg888AAUCgVfN3DgQEyZMgU7duzAuHHjsGHDBrz00kvo2rWrXf27ivXr16OgoACDBg3C//73P/58N2zYMNx11104e/YstmzZgscee6zWtpo3b46CggIEBAQAAFJSUmrVkUgkePzxxzF//nwcPXoUQ4YMccwggiAAAEuXLsWrr74KALh16xYOHjyIWbNmITU1FcuXL8fy5cvdPELP5PDhw+4eQp3gbjvd3X9Dwt5t6ax9QPvSnEY907ZmwJajbdu2AAAfHx/RbXFroD333HPQ6XT47LPP8J///Af9+/fHs88+i6tXr1rVLywsxJtvvomhQ4di8ODBeO211yzOdjl79ixeeeUV3H///ejbty8eeughbNiwweIaaydPnsQzzzyDESNGYOjQoXjqqaewZ88ewRkIFRUV+PzzzzFu3Dj06dMHo0ePxrvvvmtxLEIYr9Wbk5OD+fPnY/DgwRg1ahQ+//xzGAwGAEBRURHefvttjBgxAoMHD8Z7770n+ObE2pq2N27cwMKFCzF69Gj0798fjz/+OLZs2cL3AQBHjhxBfHw8vvrqKxQWFmLx4sUYMWIEevbsaRIkSU1Nxfz58zFs2DD069cPkydPxu7duwX7raysxOrVqzFx4kT0798fDzzwAN544w2kp6fzMs899xw/q/Cdd94xWaOO255c+ZUrV3Dx4kU8++yzGDhwIB5//HEAwJo1axAfHy8Y4MvMzER8fDxef/11wTHu378f06dPx6BBgzBixAjMmTPHxA/j4+Nx5MgRANUPotzYHn74YV6md+/eFteGW7x4MeLj45GcnMyXXblyBfHx8XjnnXdQWVmJ//73v/jPf/6DXr164cqVK7xcVVUVvvzySzz44IPo27cvRo4cicWLFyMvL0+wL0twD8uPPvqoWd3jjz9u9e3/zp07ER8fj/Xr19vUpyNwAVuxbN++Hfn5+YiIiMCiRYsEZby9vUW19dVXXyE+Ph5Hjx41q8vNzUV8fLzJ1wWffPIJ4uPjcfr0aVy9ehXPPvssBgwYgDFjxmD79u283I0bNzB37lwMHjwYI0eOxNq1ay3Obpo0aRIKCwuxbds2UWNuCKxevRqlpaXo06ePxYAtR5MmTczKfv31V0yfPh0DBgzA4MGD8cILL+Dvv/82k+POB/Pnz4dGo8GKFSswatQoDB48GK+//jq/ZqZer8e6detw//33o1+/fnj++eeRnZ1t1t7rr7+O+Ph4pKen49SpU5gyZQr69euHsWPHYtOmTRb3cX5+PpYsWYJRo0ahb9++mDBhAjZu3Ai9Xm8mq9frsXnzZjz22GMYOHAg7r33Xrz00ktm9tVc01aj0ZicF0eNGsWfv7hzJ4dOp8OGDRswceJE9OvXD8OHD8frr79u04zWM2fO8P0XFxdj8eLFGD58OAYNGoT58+cjNzdXUI8xhm3btmHSpEl836+99ppZ30uXLsVzzz0HANiwYYPJteLChQsmsn///TdeeumlWq9TycnJiI+Px1tvvQWtVouVK1di9OjR6NevH2bMmIHr16+byE+fPp3fvm+99ZbJGMrKygBYXtNWrVbjhx9+wLRp0zB48GAMHjwYs2bN4meMOovTp09j/PjxCA8PR0pKCoqLixEdHY05c+bwYxTDmjVrAAhfN4B/Z7paelHQtGlTLFu2DACwd+9eW0wwYceOHejQoQPi4uL4svPnz4Mxhm7dupkEbI154IEHMGrUKADAzz//bHf/ruKnn34CUL3WvPH5Ti6X8y8h9+zZI6otuVzOB2xtgdu3a9eutVmXIIjaadasGR555BH+OefQoUNuHhFBEEQDxo1LM3gkJSUlbNq0aQwAW7BggWi9/Px8BoANHjyYjRw50mztHy8vL3bo0CETHW5N21deeYVFR0eb6cTFxbGysjITnffff9/iGmfDhw9nWq3WRP7dd9+1KD937lwT2WvXrrHWrVsLyoaFhbFLly6J2hacXXPnzmXh4eFmbT3zzDMsOzubtW3b1qzuwQcfNGvP0pq23333HVOpVILjfeGFF3i5rVu3MgBs1qxZrFWrViZy+fn5jDHGdu/ezby8vATbevTRR5ler+fbKy4uZu3btxeUlcvl7Pr164yxf9djEfplZ2czxhjva++8846JLT169GCM/buO1J49e8zsv379uuA6mFVVVWzs2LGC/UqlUnb+/HnGGLM4tk6dOvFtyWQy1q1bN8H9/MQTTzAA7OLFi3xZQkICA8AeeeQRszWjuXXsUlNTLW6/4OBgdubMGcH+hIiJiWH+/v4m+4djxowZDADbu3evWV15eTmLiopiUVFRZsdYXcGt02ltTdvp06czAOzFF190uD9uPd3k5GSzul27djEAbPHixXwZt87U22+/zXx9fc321cqVK9nZs2dZUFCQWd2iRYsEx3D16lXePxoLvXv3ZoDw2pm1MX/+fIvH8Zdffmkiy50P7r//fjZw4EAznTvuuINVVFSwe++916wuJiaGVVRUmLQ3ceJE/twkl8vNdB555BFmMBhMdBISElizZs0Exzxw4ECTY02v17Nhw4ZZPA8Zr6tac03byspKi3rcuZMxxnJycliPHj0E5QICAtixY8dE7YejR48yAGzKlCmC566QkBB29epVEx2tVmvxPOzn52dyP/DMM89YtOf48eO83Pvvv88kEomg3BNPPGGyPy5evMgAsAkTJrBBgwaZyTdp0sRkzNw6s0I/bk0xS2vaCl3LATCZTMY2bNhgtj3tWdP2k08+YVKplAUEBPBr8cXFxbEWLVowAGz06NGi2jEYDKxZs2YsIiJCsF6tVjOFQsEUCgWrqqqy2E5hYSFvp0ajEW0HR3JyMgPAXnvtNZPyTz/9lAFgzz77rFX9t99+mwHV91OeRvPmzRkAwbWmufNUhw4d7GqbO1asrWnL0aZNGxYYGCh4f0AQhHi4Z5GlS5ea1Z08eZIBYJGRkSbl27ZtY0OHDmVNmzZlSqWSxcbGsrlz57LCwkITOeP8LidPnmQjR45kgYGBJteIgoICtmDBAtaxY0fm7e3NgoOD2dChQwXXrb569Sp77LHHWFhYGFMoFCwsLIxNnjyZ/fPPP2ayltbNLCgoYB999BHr27cvCw4OZiqVisXFxbFXX32VlZaW8nLZ2dkWr5tDhw6ttR9bx8td+wwGA1uxYgVr164dUyqVLCoqir366qs2XYu4trRaLVu8eDFr3bo1U6lULDY2li1ZskSwLU5Hp9OxZcuWsbi4OKZUKvnrkDU7T548yYYNG8Z8fX1ZkyZN2L333ssSExOtrml74sQJNmTIEBOdS5cuWdSx1L+9283W/i2RlpbGnn32WdamTRvm7e3NwsPD2dChQ9nmzZuZTqczkS0oKGCvvPIKi4uLY15eXszf358NGDBAcP1+e+wSO5aa29IRX4+Li2MKhYKPudSEy1FgnJvGnv67dOnCFAoFy8nJEeznnXfeYQDYmjVrBOs9HQraMsamTJnCevTowR8gKpWKzZo1y6aTHxe0lclkTKlUsjfeeIMdOnSIbdmyhQ0ePJh/sCspKeF1uAuVXC5nbdu2ZevWrWO//vor++qrr1hERAQDwD7++GOTft544w3Wv39/9vnnn7MDBw6wY8eOsdWrV7O4uDgzh6+qqmLe3t5MJpOx+fPns4MHD7Jff/2VrV+/no0ZM8bkoUCj0fAPo5MmTWL/+9//2O+//8527drFHnnkEQaAdevWzewhXQjOLplMxjp27Mg2bNjAfv31V/bBBx8wLy8vJpFIWHx8PGvdujVbu3Yt+/XXX9lnn33GJ5uoGbQTCtr+9ddffCBhxIgR7Ntvv2W//vor+/bbb9lDDz3Enn76aV6WC9rKZDIWFRXFVq9ezY4fP84SEhKYVqtlN2/eZP7+/gyoDqBt2bKFHTp0iL3xxhtMoVAwAGzFihV8e59//jkDwNq3b8++/vprdvz4cbZnzx62dOlSFh0dzQcxr127xhYsWMAAsDfeeIMlJCTwPy64zgVtZTIZGzhwIPvxxx/ZqVOn2OXLlxlj9gVtZ82axYDqJAGvvvoq2717Nzt8+DD76KOPWPv27fkH7oSEBDZkyBAGgO3evZsfW2JiIt+WvUFbmUzGmjZtyj788EN29OhRlpCQwMrLy5ler2d33HEHH0zYsmUL+/3339mePXvYlClTGADWtm1bs4uYEJmZmQyoflEixLfffssAsDfffNOsjtsv1hLEffPNN6xHjx42/WoGvqwhJmjLBd9+/PFHlpiYyJ588knWp08fds8997APP/yQFRcXi+4vNjaWNWvWTLDu9ddfZwDYvn37+DLupkQmk7HBgwezrVu3sqNHj7KXX36ZAdUJZdq1a8d69erFfvjhB3bs2DG2aNEiJpPJmJ+fn9mNOWPVAZPAwEAWHh4uetz1He7cwr3MEcuOHTsYUB2gff7559m+ffvYzp07+WCqXC5nZ8+e5eW584FMJmPNmjVjK1asYEePHmUbN25kkZGRDADr1asX8/f3Z++99x47cuQI27x5Mx9w+/TTT0365/rh9v/mzZvZ4cOH2ZtvvsknxVu/fj0vX1VVxVq2bMmA6sDppk2b2JEjR9gHH3zAn9tnzpzJy//yyy8MAGvRogX77LPP2LFjx9jBgwfZJ598wrp168a2bt3Ky9YM2hoMBpaQkMD69evHALD9+/fz5y/u3MkY489v99xzD/v+++/Z8ePH2c8//8xmzpzJpFIpCw0NZeXl5bXuCy5oy53XuG27YcMG1qFDB37bGrNkyRL+PPz222+zw4cPsx9//JENGDCAAWBBQUF8UCs9PZ2/rjzxxBMm1wruAXH37t0MAIuIiGDLli1jBw4cYL/++itbtWoV/7L1q6++4vvngrZyuZwFBQWx5cuXsyNHjvDJMQGwxx57jJe/evUqe+mllxhQ/aLGeAzc+dhS0DY2NpbNmDGDbdq0id/G8+bNY0qlkvn4+JglqbE1aLtz504mkUjYHXfcwbKystiHH37IALDvv/+eZWdn8y+HT58+XWtbiYmJDAB74IEHBOvPnDnDALDu3btbbaesrIx/YLAnIdgHH3zAAJgl5Zo6dSoDwNatW2dVf9myZQyAyb2OvYwcOdKm69ySJUsstqVWqxkA5uPjY7U+ICDArrHaErSdNGkSA2ByniQIwnasBW2//PJLs3Pm888/bzHA0q5dO5NrAvfM+PDDD5sl3K2srGRJSUksKirKYnupqal8W3/++Sd/z1XzFxAQYHa+tRTk455vhH7x8fH8Cz1Hg7a2jpcL0ll60fvUU0+J2p/GbU2ePFmwrfHjx1vUqbl9agvaHj16VHCSVUBAABszZgwDzAOghw8fFkzAHBAQwL8QtzVoa8t2s6d/IfLz8/mXy0I/4xfzKSkpZpPLjH81r7222mXLWJwZtH3vvfcYYP6cwdGhQwemVCpNXvTa0/+qVassnqcMBgOLiYlhgYGBou77PREK2jLG7rrrLpOd37FjR5OHHzFwQVvAfEaVXq9nffr0YYDpjTh3oYqIiDA7wRw4cIABYGPHjjUptzQrMC8vj8nlcpMA1u3btxkA9p///EdQx7it7777jgHCAS7G/r35FZMtmbMrKirKJEjNGGPz5s1jQPUDa25urkkd9xDz0UcfmZQLBW0nTJjAAMuzUYwPSC5o6+vryzIzM81kuYfr//znP2ZB6R9++IG3paa8UIZtrVZrMjtn9erVDABbu3at4Di5oG2fPn0EA+K2Bm3z8/OZQqFgMpmMnTp1ykxHr9ebPCiPHz/e7KbHGHuDtlKpVPBBiZvROWfOHME2uQuPmBlwXPbvJ598UrA+JSWFAdVBfWP++ecfplQq2ZgxY6y2z735s+Vn/Aa+NsQEbbt3784AsPfff595e3ub9RcTE8PS0tJq7au4uJhJJBI2atQowfrhw4czwHRmFBe07d+/v5lvjho1igFgXbp0MXu5xflFzS8LatpUVFRU67jrOzqdjt9XtmZA5QL2//3vf83quPPG1KlT+TLufCCXy9m5c+dM5Hfu3MmP48iRIyZ1f/75JwPMb9C5oG3fvn3NZqpt2rSJAaYPady5slOnTmY+cerUKSaRSJhKpeJfNHDnZeMXYsYYn8NrBm057rnnHgb8++WCMX/88QcDqh9IhOBeVPzvf/8TrDeGC9oKnddKSkpYWFgYA8BOnjzJGKu+OQwODmYA2IEDB0zkdTodfz9gvG8PHTrEALD58+cLjqFnz57M29ubZWRkmNVlZWUxhULB+vXrx5dxQVuFQsEuXLhgIp+dnc2USqXZzKiPPvqIAZYDYpaCtpbuS7hr+nfffWdSbkvQVqvVsqioKObl5cXPDH700UcZAP5vLtj8+eef19reli1bGAD20ksvCdavX7+eAWDTpk2z2k56ejoDql9e2UOfPn1M7is4uJeaNY/hmnAvz9544w27+jcmJCTEpuuctW3D3XcGBwdblJHL5YJfT4nBlqDtG2+8IXhPThCEbQgFbW/dusU2b97Mf13z8ssvM8b+vbZ369aN/fTTTyw/P59VVlayCxcu8M8cs2bN4tvhnhkBsFGjRrGzZ8+aPEf16tWLAWBdu3ZlP//8M8vLy2MFBQXs8OHD7L777uPvgfV6Pf8SesSIEezs2bOstLSUnTlzhr+fiouLM7mfsRTke/nll9lbb73Fzp49y4qLi1lRURH77bff+BfFNWfq1XZNE+rHnvFyQTo/Pz/2+eefs6ysLFZUVMS++eYbJpfLmVwuZ3l5eaL2KdeWUqlkH374IcvKymJ5eXls3bp1fCB5y5Ytgjo+Pj7sk08+MXumtmQn92J53Lhx7NKlS6y0tJQdP36cde3ald/3xgFQnU7Hf4E8ceJEdvnyZVZaWsr++OMPk684bQ3ait1u9vYvxJo1axgANmDAAHbu3DlWUVHB8vLy2NGjR9nEiRNN7qc4P5ozZw67dOkSq6ioYAUFBWzLli0sJCSESaVSdu3aNbvtsmUslralPb6emZnJpFKpyZdwHKdPn+Z9o7Z2auu/tLSU+fv7s9jYWLPn1v379zPAOV+uuotGnYiM45tvvkFZWRlu376N8+fP45NPPsGTTz6J69ev84l/srOzcd9995np7tmzB2FhYfzfISEhZuukSaVSzJ49GydOnMCJEycwbdo0k/qHHnoIgYGBJmV9+vQBAOTk5JiU+/r64uzZs/juu+9w8eJFFBcX82sFSqVSk/VFAwMDcccdd+DEiRPYvHkz7rnnHpN1fH19ffn/c2ubbt++HQcPHuTXK2TVgX1+zb5r166hR48eljalmV3+/v4mZT179gQA3HfffWjRooVJXa9evQBAVDZmbl3Od955R7BeaD3isWPHIiIiwqz8xIkTAIC5c+earTf58MMP49VXX0V6ejoyMjIQFRWFwYMHAwA+++wzhIWFoVu3bryeXC6HXG77YfXss89aXetSLH/88Qe0Wi3GjRvHb09jpFJpnSSAuvvuuwWzenN+tm/fPpw4ccLEz4Dq9TCBaj8bOHCg1T44WUvrxMbExCA8PBynT58GY4zfvrNnz4ZCocDKlSuttj9lyhQMGzbMqkxNbFkHWwycLy1atAg9e/bErFmzEBoaiitXrmDZsmVITU3F1KlT+e1qibNnz4IxJugTjDH89ddfaN26NZo1a2ZW/+STT5r5Zs+ePbF//348/vjjZusu9urVCxs2bLB4HHP7Kz8/X3AN14aETCaDUqmERqOxKdMpYwwnT56ESqXi14A0Zv78+Vi/fj3++OMPs7oePXqge/fuJmXceTc2NpY/fxnLS6VSi/tr9uzZZsmaHn30Ubz00ku4cOECysvL4evry59HX3jhBUGfGDx4MI4cOYIzZ85g8ODB6N27N7y9vbFp0ybEx8fj7rvvNjl3OnosccfEn3/+id69e5uda27fvg2g+lwjlkGDBpmd1/z9/TF9+nQsWbIEJ06cwF133YXr168jPz8fXbp0wYgRI0zkZTIZ5s2bh3HjxuGPP/7ASy+9VGu/paWl+Ouvv+Dj44MHH3yQt8PYJolEImhL7969zRJVhYaGIiYmxuR+wRFUKhW+/fZbHDx4EOnp6aisrARjDCUlJQDgUD979+5FRkYGJk+ezK/9evbsWfj5+fH5B7h7Ca1WW2t7tV03alvPluPMmTMAYOIPpaWlWLNmDY4dOwa1Wo2ePXtizpw5aN68uYluTk4OTp48iVmzZpmUa7VaXLp0CV5eXujcubPN/Ws0Gvzvf//DN998g/LycsHzgxAHDhwQte04goODLdZxx76l9hhj0Ov1dXIfYnytIQjCcRYsWIAFCxaYlcfExOCVV14BUJ0PQaVS4fDhwybnvq5du2LLli2Ijo7Gtm3bzO7BW7dujZ07d0KlUvFlp06dwunTpxEeHo5ff/3V5Fl56NChGDp0KP/38ePHcf36dcTGxmLPnj18cuI777wT+/btQ1xcHK5du4bff/8dAwYMsGqnUEK1/v37Y+vWrQgLC8OBAwfw1FNPWW2jNhwZ74oVK0z6f+KJJ/DLL7/g22+/xdmzZzFy5EjR41iwYAHmzp3L/z1t2jQYDAY8/fTT+OqrrzBhwgQzncWLF+OFF14Q1f5vv/2GlJQUdO3aFVu3buXvJ/v164d9+/ahXbt2KC8vN9NJS0vDnXfeiR9++IF/BunTpw9+/vlntG3bFqWlpaJt5BC73VzR/7PPPsvfm3t7e2PQoEEYNGgQX3/mzBn88ccfmDZtGp9fgJOdMGECJBIJJkyYgJ07d/LHmq12iR2Ls4mIiMDQoUNx6NAhXLp0CZ06deLrNmzYwI/ZUfz8/DB58mSsWrUKR44cMTk/rF27FhKJBDNnznS4H3dBQVsA7du35/8/fPhwTJw4EV26dMGHH36IF198ES1atIBareZvko1Rq9Umf7du3Vow+NamTRsAwjePQtmYueBqzRvfFStWYN68eRaTwFRUVJj8/b///Q+zZs3CpEmTIJFI0KFDB/Tr1w+PPvoo+vXrx8txiWguXbok2K6l9q0RGRlpVsY9iFurq60PvV6PgoIChIaG2pTYqXXr1oLl3D7h9lFN2rZti/T0dOTn5yMqKgp9+/bFhg0b8MYbb+COO+5A06ZN0aNHDwwfPhxPPvmk2QOaI2OzFS643rFjR6e0Zy+W7OH8rLbEfGL8jDv2uBsdIfr27YutW7fin3/+QVxcHHbu3Il9+/bhv//9L6Kioqy2HxoaitDQ0FrH4Uo4/27Tpg0OHz7MPxD3798fI0eORIcOHXD06FFkZ2ebvDyqydmzZwFAMGh7/fp13L592+JNnrOPY+6G3JYgZn0mIiICqampuHr1qmh/KikpgVqtRtu2bQWTEcXGxkImkwleT2zdXwqFAgqFwuL+io2NNSuTSCSIjY1FXl4ebt26BV9f31rPo+3atcORI0d4ucjISOzevRsvvvgiBgwYAF9fX3Tv3h1DhgzB1KlTERMTI9iOWLhzTVJSEpKSkizK2XJNE9oWgPn1Xcy2MJarjZycHDDGUF5ejlOnTlmUE7JF6P4CqL7HsJS81BbKy8sxZMgQnD592qZxieXAgQMAwL80r6iowD///IM+ffrwD3/cvq7tnA7Uft04f/48ANT6cppLpmh83hwyZAgGDRqEZ555BnK5HEuXLsXmzZtx5swZkxdUu3btgsFgwAMPPGDS5uXLl6HRaNCrVy+rL39zcnLwxx9/QC6XY8iQIXz5gAEDEBMTg9jYWHz99ddWx29Mt27dRMvWho+PD5RKJUpKSqDRaMy2c35+PhhjaNq0qdP6tERju9YQRF2iUqkQHR2Ne++9FwsWLECzZs1gMBhw6tQpaLVa/n6n5iQgjprnh/vvv98kYAtUJ9IGqpPY1pzcVBPuPvfhhx82O+94e3vjkUcewfLly3Hu3Llag7ZqtRqff/45tmzZgqtXr6KkpMRk7LYkMnXFeMeOHWvWHveir7Cw0KZxTJ482azssccewzPPPGMxmahQINcSXBuPPvqo2QSA8PBwDBs2DLt27RLUmThxollMJSQkBEOHDsXOnTtFj4FD7HZzZv+jR4+Gv78/XnvtNdy+fRtDhgxBu3btzNr9888/AQBff/01vvnmGwDmL+cBIC0tzW67xI7FFUyZMgWHDh3Chg0b+JciGo0GP/74I4KDg/Gf//zHKf3MnDkTq1atwpo1a/igbW5uLnbv3o0RI0bwL/vrIxS0FaBly5bo1asXDh8+jMuXL6NFixYIDw9HQkKCmWx4eLjJ35ZOlrdu3QIgPtO7ELm5uZg/fz4UCgXmzJmDPn36oHnz5vzJftSoUWbB3NatW+Pnn39GYWEhTpw4gb/++gs//fQTVq9ejbfeeguLFy8GAH7Ww5dffok777zT4hiio6PtHr+zkMlkUKlUKCwshF6vh0wmE6Vn6SGN2yeFhYWCD7hC++7xxx/H448/jsTERCQkJODEiRNYunQp3n//fZw4ccIkG7QjY+NOpAaDwaxO6C0fF5zJy8uzqX9LSCQSwb4t9c9hyR7Ozz7++GP07dvXor6lQIMxXHDc2g0KF7Q9deoUWrZsiZdeegndunXD7Nmza21/w4YNtc7Grcnx48cdOsZr0r59exw8eBDDhw83C961atUKnTt3RkJCAtLS0kQFbYUCEdyMRKGArivg9pe12VoNif79+yM1NRXbt28X/Sbb+JwkBPeFhTN9zRJir2m1jVnoPDps2DAkJiYiJSUFp06dwqlTp/DVV19h+fLl2LNnD4YPH273uLlzzaJFi3DPPfdYlKt5DbeGK7eFNThb4uLisGnTJotyYq+FzuTzzz/H6dOn0b59e7zwwgto164d/P39IZVK8fvvv2POnDkWXzKLgXuRzAXAz58/D4PBYDLD9ODBgwCqv/CoDWvXDcYYLly4AIVCYTY72Zhz585h8+bN8Pb2xpNPPsmX//rrryYzxHv37o3mzZvjp59+wqRJk/jy7du3o3nz5ujfv79Zu0DtAeOFCxdCrVbjiSeeMAlkHDp0CP7+/li3bp1NQdtRo0ahoKBAtPzYsWPxxhtvCNZJJBLExcXh4sWLSExMNLufvHjxIgDYfI9kD43tWkMQrmbp0qV49dVXLdaXlpbyk424r0AtUTNoK/TSraioCIC4Z8/i4mIAEPyiEvj3pTXXpiUYY7j//vv564oQzngR5Mh4hc5p3LasbbvXRKh/b29vNG3alB9jTcS8IOWozU6hcu4rHUv3Z7bctxkjdrs5s//IyEicPHkSixcvxquvvoqSkhI0adIEgwcPxgsvvMB//cbdF1p65ubQaDRmZWLtEjsWV/DAAw8gICAAmzZtwtKlSyGTyfDTTz/h1q1bePHFF+36SlmITp06YcCAAdi5cyfy8/MRHByMr7/+GlqtFs8995xT+nAXFLQVwGAw8J/zcQ9VSqWy1s/lgOrPAJOTk81m5HCzRTp06GD3uM6fPw+dTodZs2Zh2bJlJnXp6em4deuW4OfNQPWMvXvvvRf33nsvFi5ciF69euGdd97BvHnz4O/vj65du2L79u24evUqnn76abvHWFd07doVCQkJ2LVrF8aNG+dQWx06dMDx48exd+9es8+K09LScOnSJahUKsHZo507d0bnzp0xdepUTJs2DXfffTfef/99fPXVVwD+fYi2d0YTt7xEenq6Wd3x48fNyrgHzf3796OsrMxkOQwhahufv78/MjIyYDAYTN6QqtVqwZcYtcGN79KlS6ICp9bgbmi42cVCcLPJT506heTkZKSnp+PEiROighvZ2dmCs+utYevNUm0MHjwYn376KTIyMszqDAYDbt68CQAICAiw2g4XtK15ftDr9byvcp/Qu5rc3Fx4eXnZNSO9PjJt2jRs3LgRa9aswZQpU6y+FONQKpVo3bo1H8y86667TOp/+uknAHUzo/7AgQNmy4QkJSUhJSUFzZs3528WuWvb3r17+U/4OcrKyvDbb79ZHHPr1q3RunVrPPLII3jjjTcQGhqKhQsX1hq0tXb+4s41Fy5cwMKFC8WYWiu///47vxyEMTWv7+3atYNMJsNff/2F3NxchISEmMjv3bsXgOm2sGZLREQEmjVrhqSkJAQFBTnty4ya2HO94q4DP/74o9mMzZqzZ+yBeznIBa65cxl3HJ07dw5XrlzBgAEDrL644rB23UhKSkJpaSnuuOMOsxlfHNeuXcMDDzwAnU6H+fPnmzws1VzSQ6lUQiaTmXwxVVxcjKNHj2Ly5Mlm1yExSzP897//xZo1a+Dr62sWOK25HJVYzp8/b/U6WpOa90k1GTBgAC5evIgtW7aYne+2bNkCAC79FJODs0noCwOCIJyPn58fpFIpgoKCkJeXZ9MMvpqzMAHwL6WEZhfWhPuaISsrS7Cemx1b27Jcv/76Kw4ePIjY2FisXLkSPXr0QNOmTfkvkmp7rhKLs8brKFlZWWYxi8rKSty+fdtsGUMOoX1lidrsFCrnnmm4Z5yaWCp3Fs7uv2PHjti8eTP0ej2uXbuGkydP4osvvsCQIUOwbds2jBs3jt9Ob7/9Nt58803HDHBwLK7A29sbDz30ENatW4dDhw5h1KhRTl0awZiZM2fit99+wzfffIN58+Zh3bp1iI6OtjqBoz4g/qhrYJw6dQoffPCB2eyCzMxMPPHEE0hNTUXz5s1FPWAbo9PpMHnyZJNPJ7Zs2YLPPvuMX4/EXriHg5MnT5rMErl8+TLGjx9vJp+UlIRXX33V7FP01NRU3Lx5EwaDgX+zw61N+fHHH2Pp0qUm68tw6yvOmDHD7rE7m6lTpwIAZsyYgR07dpjUHTt2DOvWrRPd1kMPPQQAWLZsmUlbmZmZePTRR6HRaDBmzBj+IW7VqlXYsGEDysrKeFmDwcB/2mA8y5X7BNDSJya1wQUeVq5caeJT+/fvx1tvvSUof+edd+LGjRt48MEHTW50ysvL8dFHH+HKlSuix9e1a1cUFRWZvCQoKirCtGnTBAOJtfHoo4/C29sba9euxcKFC/m3mcC/a6vOnDlT8E2i0Nj8/PysBla7desGX19f/Pzzz1i+fDmeeeYZswCYJaZMmYKEhASbfs5e03bUqFGIiIjAtm3bsHHjRn7GWmVlJV588UVkZWUhIiLC6sug8vJyfq1LLkALVK/pOW3aND7oEhMT4/Sgc01u3bqFtLQ03HXXXW6ZFegOBgwYgIkTJ0KtVmPo0KFYu3at2efiJSUl+Pbbb/Huu+/yZdx5aerUqbh8+TJf/ttvv2HevHkmMq5k5cqV2Lx5M/93VlYWHn/8ceh0OpPr2fjx4yGVSrFx40asWrWK99WioiJMnjwZubm5uPPOO/mHg+3bt+PTTz81WyLg1KlT0Ov1or4WsHb+euCBBxAUFIQdO3bgxRdf5K91HBcvXsScOXNsWu8yNzcXTz75JB9INBgMWLZsGQ4cOICAgAD+U3k/Pz+MHj0a5eXlmDRpkklA7Pvvv8cnn3wCwHT/cbZcuHDBbGaqVCrF1KlTodfrce+99+L33383qS8pKcH69ev5T+rsxZ7rFXdfsn//fn7cBoMBGzduFFwX0Fa4WTiczcZBW61Wy79kFvuQwy09IHTdsLY0QkpKChYuXIiePXsiPT0dAwcOxKJFi6z2tXz5cigUCpMlFH766SdotVqzpRGs9a/RaPDLL79g1KhRmDdvHiQSCdasWWNx+Q1bOXDggE3Xudq2NbcO+scff2wyW23btm1Yv349FAoFHnvsMaeM3RpnzpyBVCpF7969Xd4XQRDVL/569uyJgoICbN261eH2uGP3u+++q3WGLPf1xY8//mj2DFFVVYUff/wRAGp9rueWU5o5cyZGjx6NFi1a8F+67d27V/DLEW6WYM0lE+tivI7y3XffmZV9//33YIwJ5iaxFa6NH374wWwWaXZ2Ng4fPmymw70Y3LJli9n2zsvLwy+//OLwuKzhqv5lMhk6duyIJ598kl9e4csvvwTwr69v2rTJJL7gKqyNxRr2+DrHlClTAFR/yVpQUIB9+/aha9eutb4ItrX/cePGITQ0FGvXrsUvv/yC5ORkPPvssza9bPBIXJfjzLPZs2cPn/2vefPmrHPnziwiIoJJpVIGgMlkMrZ161bR7eXn5zMArEOHDiwwMJBJpVLWpk0bPqsmamTLZOzfjJkfffSRYJsATDLtaTQa1r59ewaAqVQq1rFjRxYZGckkEgmLi4tjLVq0YM2aNePlz507x/ft5+fHOnXqxGJjY5lEImEAWK9evUz6++KLL/g6pVLJYmNjWdu2bZlKpeK3iRis2cVt99dff92sLiEhgQFgzzzzjEl5t27dzPrW6XRs5MiRvH3+/v6sY8eOzM/Pzyy7MZfJdMmSJRbH/PDDD/NtNWvWjLVp04b3hWbNmvHZSRn7N3O7RCJh4eHhrEuXLiwoKIjX37hxIy+bkZHBt9OqVSvWo0cP1qNHD1ZQUGDSVkJCguC4dDodn11UqVSy9u3b81nJBw0axGe2NObChQssICCAH2NERARr06YNk8lkDDUyf2/cuJHh/7Oid+jQgfXo0cOkve+++463q0WLFiwuLo4plUrm4+PDevbsyQCwixcvmu1Da9mlN27cyG8ThULBWrduzeLi4piXlxffl5is4owxNmrUKAaAZWVlWZQZMmQIA8BCQ0NZUVGRqHZdxbfffsv7QFxcHAPAAgIC+LJBgwaZ6ezevdvEFzt27Mh8fX35/btt2zarff7+++8MAOvYsSMDwCIjI/n9GBsby0JDQ/lzhLFvzJ07lwFghw4dMmtz6dKlDAD74YcfzOq443/lypVmdXv37mUA2KJFi8RsrgZDaWkp76vcsRwXF8c6derEmjZtypePHDmS1ykqKmJt2rTh61q1asXCw8P5v/v168e0Wi0vf/36dQaAjR8/3qx/LqP7wIEDBcenUqlYp06dTMomTpzIALA+ffoInhdDQkJYTk6OiQ6XrZ3z67i4OKZQKBgA5uXlxU6ePMnLfvDBB7xscHAw69KlC++LANhrr73Gyx4/fpwBYLNnzzbpj8uEK5PJ+PPX5MmT+fo9e/bw/ctkMtaqVSvWvn175uPjw/eTkZFhecf9P0ePHmUA2F133cVkMhl/LuauNwDYF198YaJz7do11qRJE77vtm3bmlwnpk+fbiKvVqtZYGAgf6668847WY8ePdj58+cZY4yVlZWx+Ph4Xj8oKIh17tyZhYSE8GVz587l27t48SIDwCZNmiRoU48ePVjNW8Dk5GT+HiA6Opo/L5WWljLGGHvuuefMriFHjhzhdYKDg1nnzp3568+AAQMYADZ//nyTfmrLPmwMd41q1qwZ27p1K+vUqROTyWRs586drHfv3gz4N2u5WHr37s1kMhkrKSkxKV+wYAEDwMLDw3nbO3XqxF9zud/kyZNrHfvWrVuZTCZjmzZtMikfP3488/PzE9Tn/KV79+6sR48e7M4772Rt2rQxuTYGBgayXbt2We177dq1TKVSidwarmHmzJn8mGNjY/lM3ADYwoULzeRXrVrFevTowT7++GOzukcffZTfH9y+iImJ4cuWL19uplNVVcW8vLxYfHy8K8wjiEbFwoULGQC2dOnSWmU3b97MADAfHx+2ZMkS9s8//7DKykp28+ZNdvz4cTZnzhyTDO61PQv36tWLAWBdu3ZlP//8M8vPz2e3bt1iv/zyC7v//vv55zO9Xs/fM40YMYKdO3eOlZWVsbNnz/LPAe3atWN6vZ5vWyhD/cGDB/n+EhISWFVVFcvKymKff/45f47u1q2byRgfeughBoB9+eWXgud2oX7sGW+3bt3MrtscH330EQPAvv32W0u7xgSuLZVKxVasWMFu3rzJ8vPz2VdffcVfwzdv3iyoYwlLdsbExDAAbMKECezy5cusrKyM/f7776x79+78deHo0aO8jk6nYy1btmQA2KOPPsquXLnCysrK2J9//sk/e9bUsdS/PdvN3v6FePvtt9nTTz/NfvnlF5aZmcnUajVLS0tjL7zwAgPAhg0bxsvefffdDADr2bMn++mnn1hOTg6rqKhgV69eZd9//z0bMWIEO3v2rN122TIWS9vSHl83pm3btszb25u9/fbbDABbsWKFoJy9/XNwzyPt2rVjXl5efNylPtNog7YFBQXsrbfe4k8k3E8ul7Phw4ez33//3ab2uKDt0KFD2cmTJ/ngKnfhmj9/PtPpdCY6tgZtGWPsypUr/EHNBW1GjhzJ0tPTWatWrUyCtmVlZWzZsmV8sIb7+fr6shkzZrD8/HyzPg8cOMB69+7NP4QB1QG9vn37svXr14vaFnURtGWs+iH3zTffNAmMSyQSNnToUHbq1CleTkzQVqvVsjfeeIN/aObsHjlyJPvnn39MZM+ePcumTJnC/P39TbZrx44d2YYNG8za/vTTT00e7gGw7OxsxljtQVvGqvf5nXfeyeuqVCo2a9YsdunSJQaYB205nXvuuYfJ5XJez9/fn82dO5cVFxeb2P3YY4/xgRgAZsGbJUuWmAQ52rVrx44fP86eeOIJBtgetGWMsWPHjrH+/fub9CuRSNhdd93FVq9ezQwGg1V9jh9++IEBYJ9++qlFmZdeeokBwgHGusY4UCX0a9KkiaDe3r17+SAv9+vSpQv7+eefa+3z008/ZQDYjh072Pjx40328+XLl9mMGTMYABYREWES1HZF0Hbq1KlMIpGw5OTkWsfd0NDpdGz9+vXszjvvNDm/AmBNmzZlU6ZMYcePHzfRyc7OZg899BAfeOSuJzNnzmRlZWUmsq4K2p49e5ZNnTrV5FzSp08fdvXqVcG2Vq5cycLCwkzs6927t0nAljHGUlJS2OzZs1mLFi1MZCMjI9ny5ctNHlQsBW3VajWbOHGiyXmk5jXz9OnTbPjw4Sbjl0gkrHv37uzjjz9marVa0A5juKDt7Nmz2datW03sa9asGVu9erWgXmJiIhsyZIjJ+Jo1a8beeecdE/s4tm/fbhYgNPaJiooKtmDBAjOZwMBA9vTTT7NLly7xsvYEbRmrPkdxL4W4H3fTLBS0Zaw6eG788qFJkyZs8eLF7MCBAwxwLGhrMBjYlClTBM+XPj4+ggG72li9ejUDTF+wMsbY6NGjLZ6bY2Ji2NSpU9mZM2dqbX/Xrl1MqVSa+UVFRQXz9fVlEyZMMNNJTk622LdKpWJ9+vRh77//vsn12xKeELTVarXszTff5B/+Od//4IMPBK/vr7/+OgNMXzxwcA+mln7PPfecmc62bdtqvTcgCEIctgRtGWPs5ZdftnrMGl+XansWTkpKYpGRkRbbSk1N5WX/+OMPs+uX8TNQzfsQocCQWq1mXbt2FWzjiSeeYDKZzCxo+80335jJDh061Go/9ozXFUHbxx57TLD/cePGWdSxhCU7jxw5wk8Aq2njmDFjGGAeAD1w4IDJvS/3CwgIYPfddx8DYBarcVbQ1t7+heCepYR+MpmM7dmzh5dNT083mawh9DOOF9hqly1jsbQt7fV1jiVLljCgetKWXC43m/zhaP8cGRkZ/GS1KVOmCPZR32i0QVtjioqK2N9//82uXr0qeoZfTYyDthxpaWns4sWLrLy8XFCnoKCAJSQksNzcXMH6hIQEdvnyZYv9Xbx4kd26dYsv+/vvv/lZOTUpLS1liYmJ7MaNGyazsyxx+/ZtdvHiRZaUlCTqodYYa3YVFRWxhIQEwZmR5eXlLCEhgaWnp5uUX7p0if31118W+9Pr9SwpKYklJiYKbuvCwkKWkJDAbt68WevYdTod++eff9jff/9d66xMg8HAMjMzWWJiIissLLQqq1ar2ZUrV9hff/3FEhIS+H2QlpbGEhISLPqIMenp6ezixYv87KCqqiqWkJBgNQBWUlLCEhMTWWpqqmCQgKO4uJj9/fffLCEhgSUmJprVV1RUsIsXL7KUlBS+LDU1lSUkJJgcM9w+NJ6ZbI3i4mKWmJjIrl+/brOfMVa9XVu0aGE2a5yjpKSERUREmLw9dCc5OTksISHB4u/cuXNW9W/cuMEuXLjAB/3FwAU8uOMqLS2NJSUl8Q/OOp2OXb161Wz7Z2RksISEBLPZaIxVBxMTEhIE/Z47/vPy8kzKKysrWZMmTdjw4cNFj72hUlRUxK5cucKuXLkiavZ3WVkZS0xMZFeuXGFVVVWCMtbOBzqdjiUkJFgMtJ45c8bsuOeCtleuXOHHfPHiRauz2jkMBgNLSUlhFy5cMPMDIfLy8tjFixdZbm6uYECntLSUJSQksBs3bgjqFxUVsQsXLli9ZpaWlrJLly6xa9eu2XydNw7aMvbvdeLy5cuirqeFhYXs77//ZtevX7d6Hubavn79On+t4Ga5GmMwGFhqaqrV7VtZWckSEhJMztnGXL582eLLwqqqKnb58mV+DNwL5/T0dJaQkGD2woAbd3JyMrt27Rp/LikpKWEJCQksMzPTRPbq1assISFB9Ms5xhg7efIk/wJu0KBB7IcffrB75kRJSQnz9/dnI0aMMCm/dOmSyfn47NmzLDk52aYvNHbv3s1UKhX7/PPPzep27tzJAOGXXZyPG/8uXrzIMjMzmUajsck+TwjaclRVVbGrV6+ya9euWbUjKyuLJSQkCM58r7lfav5q3jMyxti4ceOYt7e3xQdHgiDEY2vQlrHqoNf999/PQkJCmEKhYBEREWzAgAHsk08+MTl31xa0Zaz6HmHevHmsXbt2TKVSsZCQEDZ8+HC2e/duM9nLly+zRx99lIWGhjK5XM5CQ0PZpEmTBO9/LAWGbt68yZ544gkWERHBvLy8WIcOHdjy5cuZTqcTDNrq9Xq2ePFiFhsbywf6xAaybBmvK4K2Go2Gvfnmmyw6OpoplUoWExPD3n77bcHztb1BW8aqr+FDhw5lvr6+LCAggI0ePZr9/ffffCBRaNbq8ePH2eDBg5mPjw8LCAhg99xzD7t06RIbN24cA2B2v+fMoK09/QtRXFzM1qxZw4YNG8b7U3R0NHv44YdNJpgZyy9ZsoTdcccdzNfXl/n6+rIOHTqwxx57jB06dMjkvslWu2wZi6Vt6YivM1Z9H8lNZLj33nstbjd7+zdmxIgRZoHu+gwFbZ2EUNCWIAjXs2LFCgaAnThxwqS8uLiYjRgxgslkMpPZwI2Nrl27WpzBW5d8/vnnDAD77bff3D0UQgQ1g7aNmZpBW8I9rF27lgHmS1HYw1tvvcWkUqngS0p7+emnnywGbBn7NzBp7+QAsXhS0NYdJCcnM7lczl555RV3D4UgCIJwIvn5+SwoKIh5e3uLemne0PonxFFWVsZatGjBevbs6e6hOI16viIvQRCNnVmzZqFNmzZ8Uphly5bhjjvuQEREBA4ePIh58+ahc+fO7h2km1Cr1bh8+bLb7ddoNFi2bBnGjh2L/v37u3UsBEHUT7gEac5IzPLKK68gJCQEb7/9tsNtcUyePBkymQxfffUV4uPj+d/q1asBAOHh4YiPj4eXl5fT+jTm9ddfR3x8PN555x1oNBq+/8TERJf056m88847CAwMxGuvvebuoRAEQRB2cP78eUyfPh0nTpxAUVERbt26hcOHD2P06NEoLCzEgw8+yCelaoj9E/ZTVFSEWbNmIS8vD9OnT3f3cJwGeRtBEPUahUKBo0ePIjc3F4wxHDlyBOfPn+czri9ZssTdQ3Qbf//9N3Q6Hbp06eLWcWi1Wmzfvh2tW7d26zgIgqi/nDt3DnK5HF27dnW4LV9fX/z5558oLCx0wsiq+eWXX6DX683Kw8PDndaHNaZNm4YHHnjArDwmJqZO+vcUZs+ejTfffBNNmjRx91AIgiAIO9DpdFi/fj3Wr19vVhcREYGlS5c26P4J2ykrK4O/vz//d8uWLfH444+7cUTORcIYY+4eRENAp9Ph/PnzCAgIQLt27dw9HIJotFy+fBlqtRotW7ZEs2bN3D0ct1JUVISkpCREREQgLCzM3cMh6hEpKSkoLCxE586dXTYzsL5QWlqKa9euISQkBFFRUe4eTqNl27ZtkMlkGDt2rLuHQhAEQRCEi9Dr9di4cSO++eYbXLt2Dbdv30Z4eDj+85//4PXXX3f5y1B390/YDhe0ValU6NGjB1atWoVu3bq5e1hOg4K2BEEQBEEQBEEQdYzBYMBvv/2Gbdu2ITs7G9OnT8eoUaNsauPo0aPYvn07bt++jbi4ODz55JOIiIhw0YgJgiAIgqhLaE1bgiAIgiAIgiCIOuTatWto2bIlFi1aBJ1Oh23btiEpKcmmNl5//XWMGjUKTZo0wciRI3HixAl07tyZXwOaIAiCIIj6Dc20JQiCIAiCIAiCqEOKiopQVVWF0NBQHDt2DIMHD8bKlSsxa9YsUfonT57E3XffjY8//hizZ88GUD1zt1evXlCr1fj7778hkUhcaQJBEARBEC6GZtoSBEEQBEEQBEHUIYGBgQgNDbVbf/369ZDL5Zg2bRpfJpVK8dRTTyExMREnT550xjAJgiAIgnAjFLQlCIIgCIIgCIKoR5w6dQrt2rWDn5+fSXl8fDwAUNCWIAiCIBoAcncPwNOoqqpCcnIyYmNjG33GbIIgCMJ10PWGIAjC/dy8eRO3b992qA29Xg+ZTGZWHhwcjBYtWjjUtiUyMzPRvXt3s/KQkBAAQFZWlkv6JVwP3R8QBEEQHBS0rUFycjI6d+6Mg093Q7tgH5f3d8/OElFye8cGuLX/+o4t28/RbSK2r4a47V3lp0K4YvvV5fiFaIg+kZiY6O4heCzc9ebvY1HoFKdyaV/S0OuiZbXZsU7vXxGW7PQ2PRFDTlvRsrbsE0f6crQfT8SSjxpgnqZBCvFresok5h+guWL72eInrqAh+oS93Lx5E+3jolBaZnCoHaVSCY1GY1a+cOFCLFq0yKG2LaHRaCCXmz/KKRQKANWBP6J+wt0fnD9/Ht26dROU0el0KCoqQmBgoKAf1FZfn3CXLa7q19F27dW3RU+srBi5xuSrQMPyV2e0aU8btuo4y1891Vfr/1FBEARBEARBEARhI7dv30ZpmQHbvg5FbIzCrjaSU7UYPzUHO3fuRJs2bUzqgoODnTFMQfz8/FBRUWFWXl5eDgDw9/d3Wd9E3WAtkZxEIoFKpbIoU1t9fcJdtriqX0fbtVffFj2xsmLkGpOvAg3LX53Rpj1t2KrjLH/1VF+loC1BEARBEARBEI2W2BgFOsUpHWqjTZs26NSpk5NGVDtt27ZFWlqaWXl6ejpfT9RvhJbcMK6zFpivrb4+4S5bXNWvo+3aq2+LnlhZMXKNyVeBhuWvzmjTnjZs1XGWv3qqr1IiMoIgCIIgCIIgGi0GZoDezp+BOba0gr0MHToUmZmZSE42XX7myJEjkEgkGDZsmFvGRTgPnU5nta6goMCiTG319Ql32eKqfh1t1159W/TEyoqRa0y+CjQsf3VGm/a0YauOs/zVU32VgrYEQRAEQRAEQTRaDGAO/VzN+fPn8eCDD2Lnzp182bPPPouAgAAsWLAABkN14Dg9PR2rV6/Go48+ipYtW7p8XIRrYcyybxkMBpSUlPD73tb6+oS7bHFVv462a6++LXpiZcXINSZfBRqWvzqjTXvasFXHWf7qqb5KyyPYQOCCo6LkipYOFix3RZIhR8fUEBFKJiW0ndy9TSwlvWqIyag88dgRi9ixA8Ljd/f+dDS5mrvH3xjQMwa90UwtRwMAqrAUh/R10JuV6a08OIrBvpUiPRtbErYJJbiqKywlvarPyagqmXnCJ0tIBeYnyCysRaYIrZuEeXoLMzPFHvtCydXcneyv7GYrwXJL27om3mFpThyN7Rj+/5+9uvYyceJE6PV65OfnAwDWr1+PY8eOAQA+/fRThIeHAwBycnKwbds2xMfH87ohISHYs2cPHnnkEXTo0AFt2rTB8ePHMWDAAHzxxRd2j4nwHLikckIolUq0bt3a7vr6hLtscVW/jrZrr74temJlxcg1Jl8FGpa/OqNNe9qwVcdZ/uqpvkpBW4IgCIIgCIIgiDpm4sSJ/Iyd559/3qTOeN28O+64A1u3bkWXLl1MZAYMGIC0tDScPHkSRUVFWLFiBeLi4lw/cIIgCIIg6gQK2hIEQRAEQRAE0WgxMPu/KDA48CHCuHHjRMmFhITgwQcfFKxTKBTo37+//YMgPBaNxvJXBWq1GmlpaYiOjoZKpbK5vj7hLltc1a+j7dqrb4ueWFkxco3JV4GG5a/OaNOeNmzVcZa/eqqvUtCWIAiCIAiCIIhGiyNr09bFmrZE40Qmk1msk8vlCA0NhVwu/DhfW319wl22uKpfR9u1V98WPbGyYuQak68CDctfndGmPW3YquMsf/VUX20YRwZBEARBEARBEIQdGMCgp6At4WFYC9rKZDI0adLE7vr6hLtscVW/jrZrr74temJlxcg1Jl8FGpa/OqNNe9qwVcdZ/uqpvuq+zBgEQRAEQRAEQRAEQZih0+ms1hUWFlqUqa2+PuEuW1zVr6Pt2qtvi55YWTFyjclXgYblr85o0542bNVxlr9aqy8ur8LmXy7gox+OYfMvF1BcXiVqbM6AZto2EgIXHBUs3wvPy3Yvlr1jAzyyf7Hbz5K+ULmj+0TstqrLfV+01L2+J7RNLB0nnogj/m/JTqF9Qrge5sBnua5Ay/RmZVIb3vEKZVIvuRllVhYQnmHbwNyINjvWIX09M98mtrw1N+S0NdcPvW63rqNtWmJ/SkfRsqNaX7a7nwoBHwUAlcR8q+phLusXlml337Yi5DuOHu91eb4QOnZtOR/UF2h5BMIT4ZLUCaHX61FYWAhfX1/BT3Vrq69PuMsWV/XraLv26tuiJ1ZWjFxj8lWgYfmrM9q0pw1bdZzlr0L1jDF8ues01u4+DbX233vK5d/9hqfu74VnxvSCRCIRZZe91P+jgiAIgiAIgiAIwk4MjDmQiIyCtoRrUCqVFutUKhXatGljd319wl22uKpfR9u1V98WPbGyYuQak68CDctfndGmPW3YquMsfxWq/3LXaXy27U8zWbVWz5fPGHuX6LHaQ8N7VU4QBEEQBEEQBCESg4M/giAIgiAaFsXlVViz67RVmbW7T7t8qQQK2hIEQRAEQRAEQRCEB6HRaCzWqdVqJCUlQa1W21Vfn3CXLa7q19F27dW3RU+srBi5xuSrQMPyV2e0aU8btuo4y19r1h86fR0anfCSXLyOVo9DCUmixmkvHrs8glarxZ9//ol//vkHfn5+6Ny5Mzp37mxRPiUlBb/99ht0Oh3i4+PRvXv3uhssQRAEUS9hjOHMmTNITEyETCZD27Zt0bt3b4vyeXl5OHz4MEpLS9GxY0f069fP5esYEQRBEK5FDwa9nWvT2qtHELUhlVqeXyWTyRAUFASZTGZXfX3CXba4ql9H27VX3xY9sbJi5BqTrwINy1+d0aY9bdiq4yx/rVlfUFwhqv9bReWi5OzFI4O233zzDZYsWYLo6Gi0adMG2dnZ2L9/PwYOHIgffvgBzZs3N5FfuHAhli1bhvvuuw++vr6YM2cOxo0bh6+++sotB78tSb8cbVNs4iBL+kLl9SU5mS1jErLJ0f3k6DaxpO/uBGtisSWRl7uTjgkh1L8tflJX2OIPopPgOXAuakgcOXIEzz//PJo0aYKOHTuitLQU+/btQ0xMDH788Ud06NDBRP7bb7/FM888g379+qFVq1ZYuHAh4uLisGfPHgQE1P1xK5TwCwDKbrYSJWtboMH5HwDfvhkpWN40vO6SRIlFEZYsSs5SwjKhREXq7Nai+1eFpYiWrYml5GKWEpR5GmfTW5qV+ViIY/hIzGdDtIzMdvaQbELId2zZ93VFTla4YLnQpm4RIT6JYGV2tH0DqmMMDNDbGXs1UMyWcBHWEurI5XIEBQXZXV+fcJctrurX0Xbt1bdFT6ysGLnG5KtAw/JXZ7RpTxu26jjLX2vWN2/iI6r/ZoG+ouTsxSODtlFRUTh79iyaNGnCl508eRJ9+vTByy+/jK+//pov37ZtG95++21s2rQJkyZNAgA899xz6NOnDzp06IBXX321zsdPEARBeD5+fn44cOAAIiP/DR5mZGSge/fuePzxx5GQkMCXX7p0CU8++STmzZuHpUuXAgBu3ryJrl27YubMmdi0aVOdj58gCIJwDo6sTUtr2hKuQq+3/FmuXq9HWVkZ/Pz8BCcp1VZfn3CXLa7q19F27dW3RU+srBi5xuSrQMPyV2e0aU8btuo4y19r1reNbFZr3yqFDMN7ujbxnEeuaTt06FCTgC0A9O7dG1FRUbhw4YJJ+UcffYTWrVvzAVsA6NWrF0aOHIlPPvkEBgPdShEEQRDm9OrVyyRgC1S/NOzdu7fZtWblypWQSCQmLwLDw8Mxbdo0/PDDD8jOdu9sPoIgCIIgGhbWgrY6nQ45OTnQ6XR21dcn3GWLq/p1tF179W3REysrRq4x+SrQsPzVGW3a04atOs7yV+P6i8k5mLlid619P3V/LzTx9RI1TnvxyKCtEDdu3EB2djbuuusuvqyqqgonT55E3759zeT79++PnJwcXLlypS6HSRAEQdRjysvLkZiYaHKtAYCjR4+ic+fOZi8U+/fvD4PBgN9++60uh0kQBEE4EQMk0Nv5M4DWNSdcg1KptFinUqkQFxcHlUplV319wl22uKpfR9u1V98WPbGyYuQak68CDctfndGmPW3YquMsf+XqzyflYdqybSguqwIABPp5QSk3nZmrUsgwa/zdeGZML1FjdASPXB6BY/369SguLkZWVha2bduGRx55BO+//z5ff+PGDej1erOZUkD1bCmgOkFZp06dBNvPy8tDfn6+SVlSkmszvxEEQRCexc6dO5GWloaCggLs2LEDHTp0wJo1a0xkUlNTMWrUKDNd42uNNeh6QxAE4bkYmP1r09KatgRBEATRMPjlryTM+3wftLrqLx06RrfAFy+PhUwmxaGEJNwqKkezQF8M79nG5TNsOTw6aJuRkYFbt24hLS0NRUVFkEqlYOzfO6Py8uosbd7e3ma6XBknI8SqVauwePFi0eMRSqbkaJIisfqWEo45mnjI3UmW6gqxSads0a/viE1CZwuO+qm7cdRP6gv1ZX/UFbm5uUhNTcXNmzeRnZ2NmJgYk6V1tFottFqt3dcawLbrjaUEY2IRm3TMwIQjDVKJ+ayxgHDxiYcsJRhrDFhKWCY28ZQjCcfqG/tTOpqVySTmviuD+XFXxbSCbbaPrh/bz9J+Fusnjp4jhNBYOB84indYmkvadTbcTFt7dQni+vXruHXrFgCgRYsWaN3a8YSDWq3wuQ4ANBoNMjMzERkZKTgjt7b6+oS7bHFVv462a6++LXpiZcXINSZfBRqWvzqjTXvasFXHWf667ejfWPz1Ef5lbHxcBD6bez/8vKtn5t7fp51b9q1HB20XLVrE///ixYvo06cPcnJysG/fPgD/Piyr1WozXa5M6CGbY+bMmZgwYYJJWVJSEsaOHevgyAmCIIj6wjPPPMP/Py8vD71798awYcNw6dIlqFQqKBQKyGQyu681AF1vCIIgCKIh8/XXX+PIkSNIT0/HPffcg3Xr1jncpkTgJSqHVCpFQEAApFLh1Q5rq69PuMsWV/XraLv26tuiJ1ZWjFxj8lWgYfmrM9q0pw1bdZzhr98eOIf3N/3K/z2wewz++/w98FLKRem7Eo8O2hrTpUsX3H///fj+++9RUlKCgIAAREZGQiKR4ObNm2byXFnLli0tttmiRQu0aNHCZWMmCIIg6hctWrTAU089hddeew1nz57F3XffDaB6GQR7rzVcu3S9IQiC8Ez0Dsy0tVePaFi89957AIAXX3wRZWVlTmlTLrf8qC6Xy9G8eXO76+sT7rLFVf062q69+rboiZUVI9eYfBVoWP7qjDbtacNWHUf8lTGGz7efxBc7T/Fl9/Rpj3eeGg5FjXVs3bVv69XrDC6izS2R4Ofnh27duuH06dNmsidPnkRgYCA6d+5cp2MkCIIg6jc1rzUA0K9fP1y8eBGVlZUmsidPngQAwYSYBEEQRP3AAAkMzM4fBW0JF6HX663WlZaWWpSprb4+4S5bXNWvo+3aq2+LnlhZMXKNyVeBhuWvzmjTnjZs1bHXXw0GhqXf/moSsH1wYEe8M32YWcDWXlucgccFbfV6Pf7++2+z8pSUFPz0008YOHCgSfbuGTNm4NKlSzh8+DBflpycjD179mD69OlQKBR1Mm6CIAiifnHu3DmzspKSEnzzzTcIDw9HfHw8Xz5jxgxUVVXhyy+/5MtKS0uxfv16jBo1yilr1xEEQRDugVvT1p4fBW09D51OhyNHjuDHH39EamqqVdmMjAzs2bMHBw8eREmJZ635by0woNPpkJWVBZ1OZ1d9fcJdtriqX0fbtVffFj2xsmLkGpOvAg3LX53Rpj1t2Kpjj79qdXq8tuYAvj90nq9/6r4emNg3CgaD8LnXXfvW45ZHYIxh+vTpCAwMRPfu3dG0aVMkJSVh8+bNaNeuHTZu3Ggi/9RTT+H48eMYN24cnnnmGfj4+GDdunW46667bEoyRhAEQTQuPvzwQyQnJ6N3794IDQ1FVlYWtmzZApVKhR07dpgsMN+3b18sWbIEL7/8Mq5cuYJWrVrh+++/h0qlwtq1a91oBUEQBEEQQPWSRYsXL8bu3bsRGBiIq1ev4uuvv0ZMTIyZrMFgwPPPP4/169dj8ODBKCoqwsWLF7Fq1So8/vjjvFxmZiYyMzMt9tm7d2+X2ALA6uQjpVKJdu3aWVz3trb6+oS7bHFVv462a6++LXpiZcXINSZfBRqWvzqjTXvasFXHVn9Va/WY++leHDv3b2LY+ZMG4LGRd4Ax5nG+6nFBW7lcjtOnT+PPP//EyZMncfPmTbRp0wa7d+/GoEGDzBb9lUql2LRpE44cOYJff/0VOp0On332GcaMGePQAsHP/lIGL6/aI+iuyCxftNS8TUezvVvSd8X4BfsZG+CQviuy3buiTWfgznEFLjgqWC7kk40FT/UTwnG+++47XLlyBUePHkVaWhqCg4Oxdu1ajBw5EiqVykz+jTfewL333ou9e/eipKQEL7/8MiZMmAAfHx+HxqEMPgBVWCerMpXZ0WZlehdle28abvnh1F792zcjzcq0zOBQP0KkZYY5pB8dme2kkZiiCkupXaiOkYZed/cQzNAz8/s2obkOGmb+yVpDwJ1+Yulo1LvmNONxVM+ate+5gda09RyKi4vRo0cPvPvuuzh58iTuu+8+i7Lvv/8+vvzySxw9ehT9+/cHACxduhRTp05FXFwc7rrrLgDA/v37rSYV++OPPyCTueacZC0wIJFIHKqvT7jLFlf162i79urboidWVoxcY/JVoGH5qzPatKcNW3Vs8dfyKg1mrdiNv65mAQCkEgnenj4MYwd04mWcNS5n4XFBW467776bTwAjhiFDhmDIkCEuHBFBEATR0OjQoQM6dOggWr579+7o3r276wZEEARB1Dns/9entVeX8AzEXtN1Oh3++9//4j//+Q8fsAWAefPmYcWKFVi+fDm2bdsGAJg+fTqmT5/usjFbQ6vVWqzTaDTIzs5GWFiYyZdBYuvrE+6yxVX9Otquvfq26ImVFSPXmHwVaFj+6ow27WnDVh2x8rm3ivHM8h1IulkEAFDIZfjwudEYGt9GVDvu2rcet6YtQRAEQRAEQRBEXWHverbcj6hfnD9/Hrdu3cKgQYNMyhUKBfr27YtDhw7Z3GZmZiZOnjyJnJwc5Ofn4+TJk7hx40atenl5ebh06ZLJLykpCYBp0FatVvNr3Op0Omi1Wnh5eUEikUCtVvNrLOr1eqjVakgkEnh5eUGr1ZrVcYlWNRoN34fBYDCp02q1ZnUGg8GsjjFmVqfRaEzqjMfN1QnZpFarTeq4cRsMBshkMn6Gm0ajqRObGGPw8vKCXq93qk0SiQRKpdJEzxabNBoNVCoVJBKJTTZpNBoolUpez5pNNf3Lkk1arRYKhQISiYQfd02bjO0VsokxZjJb3ZN8z5JN1vaTkL11YZPx/nWWTTqdjt+/9h5PACCTyUz0arOJO39pNBqnnSOyC0ow/f2dfMDWW6XA5y/dj35dokzslcvlJvYa26TT6eDl5cX3b6/v2QoFbQmCIAiCIAiCIIhGARcUbdmypVldq1atUFpaitzcXJva3L9/P1588UWkpaUhNzcXL774Inbt2lWr3qpVq9C5c2eT39ixYwEAt27d4uXS0tJQVlYGoDppanZ2NkJCQqBQKJCRkcEnUSsrK0NaWhoUCgVCQkKQm5uLoqIiAEBFRQVSU1P5AEV2djYKCwsBAFVVVUhNTeUDHbm5ucjPzwdQHZBITU3lgzD5+fn89tHpdEhNTUVVVRUAoLCwENnZ1UsNMcaQmpqKiooKAEBRUZHJ+sA1bcrIyODrjG1Sq9UoLy/n1/jNzMysE5v0ej1CQkL47e0smxQKBXx8fJCVlcXX2WJTZmYmmjVrBoVCYZNNmZmZaNKkCRQKRa37KTc3l/cvazZlZ2fDy8sLCoWC972aNikUCvj5+SEzM1PQJr1ej7KyMj7g5km+Z8kma/tJoVCgSZMmyMzMrNPjKSsrCz4+PlAoFE6zKT8/HzKZDAqFwu7jSSKRoKysjA9iirGJO39lZWU55Rzxx1+JmLxkC1KzbwMA/H2U+GrBeHSPDTaxqbCwEBKJBAqFQtCmwsJChISEQCKROOR7tuKxyyMQBEEQBEEQBEG4GgOTCq6pLFaXqF9wQQBfX1+zOq6stLQUISEhotu0dxmFmTNnYsKECSZlSUlJGDt2LFq0aMGXRUdHQy6vfnQPCAiAt7c3Kioq4OXlhaioKH6mop+fH6Kjo2EwGFBVVYXw8HBez8fHBzExMXxwLCwsjP+/l5cXYmJieFlj2xUKBWJiYviASHBwMF8nl8tN6oKCgviAj0QiMWkzMDAQAQH/5jmpaZPx/jC2ycfHByEhITAYDJBKpYiMjORz17jSJplMhoqKCjRt2pSvc4ZNnB3GLw1ssalVq1bQaDSQyWQ22dSqVSvo9XoYDIZa95Ofnx/vX9ZsioiIgE6ng8Fg4H2vpk0GgwESiQStWrUStEmpVCI0NJS335N8z5JN1vaTwWCAwWBAq1at6vR4atmyJb8vnGVTSEgINBoNDAaD3ceTVCpFaGgov5yAGJu481fLli15PXvPEen55Vj4XQJul1YHWJs38cHqufejQ0woDAaDSf/BwcH8DFohmwwGAyoqKqBSqRzyPVuhoK0FVg/1Q7tg0+QyQgmJHE1SVFeJwCwhNH5bkoaJlbWU4Ep0PwLbiRJEmeNowjdLCcdc4Se0/xxD6Jii46R+UpU/HJXZ/66L5B2WZiYjVGYLt7IiHNJ3FKHkZDlZ4aL1bwgkGHN+GjPLicxclaCsPvNzSmeBUvHBK6nAHhzV+rJZ2c7kbqLb3J58h1nZuNhzovUbM1oLCceEPv2/dMP8fNKpZZZZWX3CAAkMdn6AaKDlEeodXBDA+JNVDq6M+wTW1bRo0cIkOGuMccIb4wSpcrkcer0eqampiImJMamTyWSQyWRQq9W4ceOGSfCAq+MwXpNRKpWatMMFI2qrk0gkouu4cViyybjeuM5gMCAnJwfe3t5QqVQm43alTcbbkJN1hk1qtRpZWVmIiYkRHHdtNkmlUqSnp5vt+9pssqQnZJNerzezXcgmqVTK26JSqQTHrVarkZmZaRIMNLZJr9fz+5eb1SnWJlf7nrV9YalOyN66sKnmvnCGTRKJBDdv3uTbtOd40ul0yMnJ4c9FYmwyPva48dhzjjhzLQvP/XcXyiqrz+uRwQFY8FB3tA5vKjhuAFbtFTon1LTXFt8TCwVtCYIgCIIgCIJotBgcWJuWgrb1j8jISAAQXAIhJycHcrncYiC1LjEOBNREqVQiNjbWLCAgtr4+4S5bXNWvo+3aq2+LnlhZMXKNyVeBhuWvzmjTnjZs1RGS/+18KuZ8+hPU2uplGdpGNceXL49FUz+V3b7orn3bMI4MgiAIgiAIgiAIO9A7sDyCvXqE+7jzzjuhUChw5swZs7q//voLPXr08Igs9sYzbYXqrAV1a6uvT7jLFlf162i79urboidWVoxcY/JVoGH5qzPatKcNW3Vqyv/851W89uVB6PTVX3V1axOGVfPGoImv9S8oPNVX6S6DIAiCIAiCIAiCaBQEBgZi/Pjx2Lp1q0myr6NHj+LatWt2rU3rCoyzrwvVZWZmWpSprb4+4S5bXNWvo+3aq2+LnlhZMXKNyVeBhuWvzmjTnjZs1TGW//HwBcxfvZ8P2Pbp0hJr549DE18vh33RXfuWZtoSBEEQBEEQBNFoqV7TlpZHqO8YDAZs2bIFAHDuXPV61qdOneLXpx0zZgy8vb0BAB999BH69++PQYMGYdasWSguLsb777+PBx54AE8++aR7DLARLtGOvfX1CXfZ4qp+HW3XXn1b9MTKipFrTL4KNCx/dUab9rRhq45EIsH6n/7CZ9tP8WUje7XF0hkjoVSYrsPsSL/u2LcSxqU5IwAAly5dQufOnXHw6W5miciEoCQ/5gglnXI0EZkQtiTNchRbkm650ycsjVNo+wttP1vG7uh+drT/xo4jSeccTqBoQ9+t3jnhUF8NGe5689fRMHSMs/4ZpqOJyBoiyRnCScPEInMwzuKK5GRP/fW4aNm18Rud3r8t7Enp4pD+fa0vipLbmtTDoX6EmNDG/JNoQhihpGNagQ/1qpjMrAwAerdKc6j/Dy+PFCU3r+MBu9rnzsOr9seiVTv7Ek+l/1OFmaOSkZiYiE6dOtnVBuEctFotJk+ebLF+1apVCAoK4v8uKyvD119/jXPnzkGpVGLYsGEYP3681WUJ6gLOL8mnCIIgaocxhv/++Du++fnf+7vxgzrjralDIGsALwRopi1BEARBEARBEI0WgwNr2hpoTVuPQaFQ4McffxQt7+fnh+eff96FI3IMg8FgtU6r1UKhUAjO/Kqtvj7hLltc1a+j7dqrb4ueWFkxco3JV4GG5a/OaNOeNmzR0RsMWLT+MHb8dpkve/KeHpgzsZ/ZCzhHfdFd+7b+HxUEQRAEQRAEQRAE0YCorKzk/69Wq6HXV2dB1+l0KC8vR2pqKrRaLdRqNXQ6HQBAr9dDrVZDq9UiNTUV5eXlZnXch7YajYZfm9FgMJjUabVaszouiGxcxxgzq9NoNCZ1xuPm6oRsUqvVJnXcuKuqqnD9+nW+T41GUyc2qdVqpKamorKy0qk2abVaJCcno7y8nK+zxaaysjKkpKTwYxZrU009azbV9C9LNpWXlyM5ORlarZYfd02bOHvLysoEbVKr1bh+/To/Hk/yPUs2WdtPWq0WKSkpJvbWhU3G+8JZNlVUVPBt2ns8aTQaXL9+ne9TjE3G5y9r+6miUo15n/1sErCdM7EvZo27i9cztkmr1SIpKYk/t9a0qaKiAklJSSb2GttUUVGB1NRUaDQah3zPVihoSxAEQRAEQRBEo8UAqUM/gnAGixYtgkQiQefOnQHAJElaWloaysrKAAAlJSXIyclBTEwMFAoFMjIyUFJSvfRVWVkZ0tLSoFAoEBMTg7y8PBQVFQEAH3DgAhTZ2dkoLCwEUB0YTU1N5YM3ubm5yM/PBwA+gMIFYfLz85GbmwugOiCRmpqKqqoqAEBhYSGys6uXD2KMITU1FRUVFQCAoqIiZGZmWrQpIyODrzO2Sa1WQyqV8lnbMzMz68QmvV6PmJgYlJSUONUmhUKB4OBgZGVl8XW22JSVlYWWLVtCoVDYZFNWVhbCwsKgUChq3U95eXm8f1mzKScnB82aNYNCoeB9r6ZNCoUCISEhyMrKErSJC25xMxc9yfcs2WRtPykUCoSFhSErK6tOj6esrCwEBwdDoVA4zaaCggIEBARAoVDYfTxx+5Xbz2Js4s5fWVlZFvfTP8mpmPnfnTiUkAQAkAB4a8oQTLu3p0WbFAoFvLy8+G1R06bCwkL4+/tDoVAI2lRYWIiYmBhIpVKHfM9WaHkEgiAIgiAIgiAaLXoG6Jl965jqKTsI4SQWLVqERYsW8WvahoX9u3Z7dHQ05PLqR/eAgAD4+vpCpVIBAKKioiCTVa8r7efnh+joaEilUqhUKkRFRfFBEx8fH8TExPCfDIeFhfH/9/LyQkxMDN9HSEgI3zcXQOGCpsHBwXydXC43qQsKCuIDPhKJxKTNwMBABAT8mxdByCYOY5sCAgLg4+PD2xEZGVlnNkmlUjRv3typNkmlUgQFBZno2WJT69atoVQqIZFIbLKpdevWvE1i9pNSqazVppYtW/I2cb5X0yapVIrAwED4+fkJ2uTj44O2bdvy4/Yk37Nkk7X9JJVKERAQAG9v7zo9nrg6rn9n2BQeHs7bZO/xpFAoTPavGJu485dxnbFNxWVVeG/zOVxMqQ4My2VSLJk2FPf172TVJolEgqioKIvnCO6cy70kErJJoVCAMeaQ79kKBW0JQgRCiZscSQRlK0J92ZJMSijpl1DSsL0QTu4mhKNJxwjHqKukbbYknKP9TNQlWoGM7TIIR0+E5sEJBVocTU7mKJaSi9mSoMwRhksnmJUdMmwVrS+0JqiWCd9q/pgUL7JV8fuZcD6dWmbVLuQExCYccxUGSKG3c8YszbQl6gIuQAtUB3YYY7h58yaCg4NN6mQyGWQyGbRaLfLz8xEcHMwHD7g6Di4oB4APknBwwYja6iQSieg6bhyWbDKuN64zGAy4desWP4vQeNyutEmr1SInJwfBwcF8u86wyXjfCI27NpukUimys7P57SHWJqlUyttT237SarWC/lXTJqlUiry8PL5NoXEb28sFy4xt0uv1JvvXk3zP2r6wVCdkb13YJJVKkZuby29HZ9gkkUh4WxQKhV3Hk06n4/ev8Yx5azYZb0NuPNx+yi8qx9Pvb8f1zOovEbyUcnz43Ci0C/Xh15u1ZJNWq0VBQQF/7NUcNwCr9lo6Luz1PbHQXQZBEARBEARBEARB1COsJSoTU1+fcJctrurX0Xbt1bdFT6ysGLnG5KtAw/JXZ7RpTxtCOhl5xZi8ZAsfsPX3UWLN/HHo26WV0/zVE32VZtoSBEEQBEEQBNFoMUAKg8BMcbG6BOEKjGdvCdVFRkbaXV+fcJctrurX0Xbt1bdFT6ysGLnG5KtAw/JXZ7RpTxtCOtczCvD08h3IL6pO4BcU4IM1rzyA9q2qZ806w1891VfpLoMgCIIgCIIgiEaLARLo/3+JBFt/BoElPAjCGXBrJFqq02q1FmVqq69PuMsWV/XraLv26tuiJ1ZWjFxj8lWgYfmrM9q0p42aOheSsvHEu1v5gG14c398++YEPmDrLH/1VF+loC1BEARBEARBEI0WPZM49CMIV8BlLRdCo9EgOTkZGo3Grvr6hLtscVW/jrZrr74temJlxcg1Jl8FGpa/OqNNe9ow1vkz8QamL9uOknI1AKB1eBA2vvkQWoU2tbkPR33RXfuWlkcgCIIgCIIgCIIgCA+iZgIbYxQKBVq2bGlxCYXa6usT7rLFVf062q69+rboiZUVI9eYfBVoWP7qjDbtaYPT+fVCOuavPgCtTg8A6BQTgi9eHoum/t529eGoL7pr31LQ1gLP/lIGLy+du4dRK0KZ3YWoq0zzzkBsBnpPtckV+0SsrC1t7oW47WwJsfsJ8Nx9RdiHLfueqB2v4EPwDuvk7mFY5eeUzmZlegufBN/X+qKrhwMAqDCY38L4SC1dt80/YxL61Ehv4Wun2Khs8QOrI2acmSxK7ose34pu85Bhq2hZsfv5x6R40W2KXlNUIpwE4uE2f4nui/AspBb2qb3rzNoKg9TutWkZfbhIuAip1LJvSaVS+Pj42F1fn3CXLa7q19F27dW3RU+srBi5xuSrQMPyV2e0aU8bUqkU+xNSsWj9YRj+fymCnh0isXLOffDzVtndh6O+6LZ9W+c9EgRBEARBEARBeAh6JnXoRxCuwNryCFqtFrm5uRZlaquvT7jLFlf162i79urboidWVoxcY/JVoGH5qzPatKeNr35KwFvrDvEB28F3tsYX88YKBmxt6cNRX3TXvqWZtgRBEARBEARBNFoMgN0JxYTnCBOEa2GMoaqqymrCHGv19Ql32eKqfh1t1159W/TEyoqRa0y+CjQsf3VGm7b63cr//Yk1u0/zZff364C3pw+HXGb5Bamz/NVTfZVeDRMEQRAEQRAEQRCEh6JWq6HXV6/rqNPpwBhDq1atoFQqoVarodNVLw+k1+uhVquhVCrRqlUrXt64jgs4aDQafsaYwWAwqdNqtWZ1BoPBrI4xZlbHJenh6ozHbZzAp2adWq02qePGLZPJEBoaCqVSyY+7LmySy+Vo1aoVJBKJU21SKpWIjIw0CfzYYhNjDC1btoRSqbTJJsYYoqKieD1rNgEw8S9LNjHGEBERAaVSyY+7pk3G9grZJJfLERoayq8T6km+Z8kma/tJqVQiKirKxN66sIkxhsjISCiVSqfZBADh4eFQKpV2H08KhQKhoaH8Gt2WbDIYGJZ8c8QkYPvw0C5Y/ORQyGVSp5wjlEolwsLCIJFITMbN2SSRSMzsNbZJIpGgVatWUCgUDvmerVDQliAIgiAIgiCIRovBgaUR6mrdXaLhs2jRIkgkEnTuXL2OfE5ODl+XlpaGsrIyAEBJSQlu3LjBB/AyMjJQUlKdP6KsrAxpaWlgjMFgMCAzMxNFRUUAgIqKCqSmpvIBiuzsbBQWFgIAqqqqkJqaygc6cnNzkZ+fD6A6IJGamsoHYfLz85GbmwugOiCRmpqKqqoqAEBhYSGys6vXgWeMITU1FRUVFQCAoqIiZGZmWrQpIyODrzO2qbS01GTcdWVTZWUlDAYDbt265VSbGGMoKSlBWloaX2eLTSkpKdBqtWCM2WRTSkoKKioqwBgTtZ84/7Jm040bN1BcXAzGGO97NW1ijKG8vBwpKSmCNlVWViIlJcUjfc+STdb2E2MMFRUVbrHJ2L+cZVNBQQE/w9Te4yklJQWVlZUWbSopLcOCL/Zjy5F/8yXMfOAuPNg7AhUV5bXuJ7HnCMYYbt68iVu3bgEwP0fk5OQgLy8PjDFBm3JycmAwGBzeT7YiYQ1lHrqTuHTpEjp37ozY2Fh4eXm5ezi1IpT0KnDBUbMyS4mDHE0Q5Wj/Ysck1I8rxu4MxNpPybmI+oCjx0mrd044aSQND+56k5iYiE6dPDsR2Z6ULmZlltZxFErmMy72nNP795dWmZUFSITfXqskerOyTi2zzMquZ4QJ6rd1MBHZoyefMitTSM3HJLeQjEkoSZNMIpRczbxsVY9NYoZIEG5lxZXhomWFgqTzOh6wq1/uPPz6np4Ib+trVxs3r5fj3fsS6sW5nKgfcH556tQp9OrVCwD4mZ8ymQw6nQ6VlZXIyspCTEwMgOqZZnK5HHq9ng9ApKamIiIiAt7e3iZ1SqWSnz0qkUigUChgMBj4WYISicRklhxXp1AoIJVKTeoYY9BoNCZ13Iw2rs543AaDgZ8NV9MmvV4PlUrF13E2cQGwtm3bQqVSQaPRQCqVutwmg8GA9PR0REVFQaFQOM0mvV6P5ORkREVFwd/fHwBssqmsrAxZWVlo3bo1n6xOjE2lpaUmetb2U03/smRTaWkpMjIyEBsbC7lcDp1Ox9dxNnH2RkZGwt/f38ymyspKJCcno02bNvDy8vIo3+P2RU2brO0ng8GAlJQURERE8PbWhU3G+4LzM0dtKisrw40bNxAbGwuFQmHX8VRVVYWkpCTExsbC29vbzKbi0nIsWHMYxy+k8efAeQ/3Re9Yf0RERMDHx8dp5wiNRoOkpCRER0fD19fX7BxRVlaG9PR0tGnThrfX2Ca1Wo3MzExER0fz/muP73E2iIXWtCUIgiAIgiAIotHCmAQGZt+atsxOPYKoDeMJRMYP+XK5HD4+PoiIiOADAxwymYwP2BgHPIzrOLggAlCdFd24D+5T9drqJBKJ6Dru82hLNhnXG9epVCq0atWKrzcetytt4rahl5cX34czbJJIJIiKijLJQm+LTb6+voiMjDTb97XZZElPyCZL/lXTJh8fH0RFRfFyQuM2tpf7LN3YJm4pD268nuR71vaFpTq9Xo/IyEgTe+vCppr7whk2eXt7823aezwpFAp+qY2adWWVGsz+dB/OXKueSCGTSrDkqRG45+52qKioMDl/OeMcIZfL0bJlS/7cWnPc3t7eaNmypUV7pVIpIiIioFAoTLaTvb4nFgraEgRBEARBEARBEIQHYRwUEKrjZmnaU1+fcJctrurX0Xbt1bdFT6ysGLnG5KtAw/JXZ7RpqY1bxRWY8cEOXEmvXmJBqZDhv7P+g8F3xgKATf06y1891VdpESaCIAiCIAiCIBotekigh9TOH820JVwDt8yBpbqCggKLMrXV1yfcZYur+nW0XXv1bdETKytGrjH5KtCw/NUZbQq1kV1Qgife2coHbH28FPhi3lg+YGtrv87yV0/1VQraEgRBEARBEATRaGH/n1DMnh+jRGSEi7CWesZgMKCkpITPXm5rfX3CXba4ql9H27VX3xY9sbJi5BqTrwINy1+d0WbNNlJuFuKxJVuQlnMbABDo54WvFjyIXh2j7O7XWf7qqb5KyyM0EoSSYwHAXohPECa23caedKu+2O+K5G629GULnrj9GgtiEwMSDRstE3+7IJSg7MekeLMySxnX9YLvk80TBAn1Myj2eu0DdAM6gbEqYJ6IzBb0AutofhH/rUNtuoIZZyYLln/Rw/lj/fDySLOyKoPCrEzLhD85Xtxll9PHRIjjpQ6HBMttSVDmCNUzbe2bMUszbQlXYbxOYk2USiVat25td319wl22uKpfR9u1V98WPbGyYuQak68CDctfHW2zuLwKh05fR0FxBZqnlyMqJBDzPvsZt0srAQAhTf2wZv44xEYEOdSvs/zVU32VgrYEQRAEQRAEQRAEQRAEQTgEYwxf7jqNtbtPQ60VnqTQMiQQ614dh/DmNBmoNuh7HoIgCIIgCIIgGi0GSOxeHsFAM20JF6HRaCzWqdVqXLt2DWq12q76+oS7bHFVv462a6++LXpiZcXINSZfBRqWv9rb5pe7TuOzbX9aDNg2a+KDjW9OsBiwtbVfZ/mrp/oqzbQlCIIgCIIgCKLRYnBgeQQK2hKuQiYTXsoFAORyOUJDQyGXCz/O11Zfn3CXLa7q19F27dW3RU+srBi5xuSrQMPyV3vaLC6vwppdp63KlFaooZDbf36zV95RX3Tbvq3T3giCIAiCIAiCIDwIbtasvbqOsGPHDmzfvh23b99GXFwcZsyYgbZt24rSLSkpwfr163H27FkUFRUhMjISY8aMwahRoxwaE+EZWAvaymQyNGnSxO76+oS7bHFVv462a6++LXpiZcXINSZfBRqWv9rT5qHT16HRWc/boNHqcSghCQ8O6uyUfp3lr57qq7Q8AkEQBEEQBEEQRB0za9YsPPbYY+jWrRueeeYZZGZmonv37jhx4kStumlpaYiLi8Nnn32G/v3746mnnoK/vz/uvfdeTJ4snACQqF9UVlby/1er1dDrqwMhOp0OFRUVKCwshE6ng1qthk6nAwDo9Xr+78LCQlRUVJjVMcYAVC+/oNVqAVRnRTeu02q1ZnVcxnTjOsaYWR23rANXZzxu4yUfatYZf3JsbJNarUZOTg7/t0ajqRObNBoNCgsLUVVV5VSbdDodCgoKUF5eztfZYlN5eTlu3boFnU5nk03l5eUoKCjg9azZVNO/LNlUUVGB/Px86HQ6ftw1bTK2V8gmjUaDnJwc/m9P8j1LNlnbT0L21oVNxvvXWTZVVlYiLy8POp1O9PFUUFwBMdwqKrdoE3f+Ki8vd+o5QqfTITc3F1VVVSbjtmav8b6orKxEYWEhtFqtQ75nKzTTtpETuOCou4cgCqEM9rZgS7Z7R/tyJ7bYWZcIbVNPHStRO7YcI4nvuHAgRJ2hd3AmmdBMNA0TnkFkEPk+uVDv59CYhGgble2Q/vCjcwTLZVIvs7ItA790qC93My1hilmZVGIQkKy7T8fndTxgVvZ24n1mZVoLvkd4Hi91OFQn/RiY1O7znL0zbX/99Vd8/vnn+PLLL/H0008DAO69917069cPU6dOxZUrVyCVWm575cqVyMnJwV9//YUePXoAAO6//35UVFTg888/x+uvv4727dvbNTbCPSxatAiLFy/m/87NzeX/n5aWhtDQUDRp0gQlJSXIy8uDXC6Hr68vMjIyEBQUhKCgIJSVlSEnJwfR0dEoLCyEwWBAUFAQmjdvjoqKCmRlZaFdu3aQSCTIzs6Gl5cXQkJCUFVVhRs3biA2NhYKhQK5ubmQSqUIDw+HVqtFamoqYmJioFKpkJ+fD4PBgMjISOh0OqSmpqJly5bw8fHhg5ytWrUCYwypqamIiIiAv78/ioqKUFJSwmdfr2lTYWEh2rRpAwAmNpWUlCA1NRVNmzaFXC5HZmYmAgICXG5TaGgoH/jW6/VOs8nX1xc5OTmQSqXo2LEjANhkU2pqKhQKBfz8/JCfn2+TTVKplB+3tf1UWFgIqVQKX19fqzbduHEDGo0GAQEBqKqqQk5ODuLi4kxs8vf3R25uLhhj6Nixo5lNFRUVSElJgb+/v8f5Hnc81bTJ2n4KDAxEXl4eDAYD4uLi6sym9PR0GAwG+Pv7o7y83Ck23bx5EyUlJWjSpAk0Go2o46lZgI+o812zQF+LNkVERKCwsBAajQYRERFOO0fo9XrcuHEDYWFhiIyMNDtH5OTk4Pbt22jSpAn0er3ZfuKCsSqVChkZGXb7HrftxUJBW4IgCIIgCIIgGi0G2L82rdCrCjF8/fXXUCgUeOyxx/gyiUSCadOmYdq0afjjjz/Qv39/i/rcLD3uQZCD+7usrMzOkRHuYtGiRVi0aBEuXbqEzp07IyIigq+Ljo7m11EMCAiAr68vVCoVACAqKopfSsHPzw/R0dFQqVRo06YNNBoNH/z38fFBTEwMJJJqXw8LC+P/7+XlhZiYGL6PkJAQvm+FQoGYmBgoFAoAQHBwMF8nl8tN6oKCgvhZaxKJxKTNwMBABAT8O2lDyCYOY5uCgoJw55138vZGRkbWmU2BgYHQarVOtUkul6NDhw78TEBbbWrbti2USiUkEolNNrVt2xYKhQJSqVTUflIqlbXaFBMTw9skl8sRHR1tZpNcLkf79u2h0+kEbQoICECPHj34/jzJ97jjyZb9pFAo0L59e2i12jo9nmJjYyGXyyGTySCTyZxiU1RUFG+TwWCo9XiSSGX462oWakOpkGF4zzZWfa9NmzZQq9VOPUeoVCp069bN4jkiMjISkZGRJvbW3E8KhQKMMYd8z1YoaEsQBEEQBEEQRKPFHTNtExISEBcXBx8f01lJd9xxBwDg1KlTVoO2kyZNwrp167Bq1Sq8/vrrAICioiJs2rQJXbt2Rffu3e0aF+E5cAEBAHwwAgAfIBOq4wI2HFwgrLY6qVRq0o5x39bquECImLqayXvIJrKJbGo4NkmkMryyaj8O/5WE2nj6/l5o4uslOG5PssnV+0kstKYtQRAEQRAEQRCEAyQlJeHSpUsmv7y8PIvyN2/eNJlhxdGiRQsAQHa29eVa+vfvj19//RUbN25EbGws+vbti1atWqFjx444duxYg8nE3pgxXgexJmq1GklJSRbXR6ytvj7hLltc1a+j7dqrb4ueWFkxco3JV4GG5a9i26yo0uK5FbtNAraD7mgNlcJ0OSqVQoZZ4+/GM2N6OaVfW+Ud9UV37VuPvZqr1WpcvHgRN27cQHh4OLp06WIyHZrj77//xt9//y3YxoMPPggvL/N15AiCIAgCqF6A/tKlS0hOTkZQUBA6d+6MoKAgM7kbN27gt99+E2xj2LBhCA0NdfVQCYIgCBdhYBIYmJ3LI/y/3tixY83qFi5ciEWLFgnqGX86aww3Y8dawA6oDurOmTMHOp0OL7/8MsLCwnDixAmsXLkSrVq1wrvvvmubIYTHYW1NY5lMhqCgIJMZZLbU1yfcZYur+nW0XXv1bdETKytGrjH5KtCw/FVMm8XlVZj54S5cSKp+0SiXSbF0xkiM7h2H4vIqHDh5DVl5txHRoilG9o7jZ9g60xZn+aun+qpHBm1feuklbNy4EQEBAejevTuuXr2K/Px8LF26FNOnTzeR3b59OxYvXoyJEyea3fjcd999jTJoW7R0sEP6jiYnE9LfC+ExuSLpl1CCK1tsEhqru5OTOZq0S8h+R/3EUSg5GeFuPv30U6xYsQKVlZXo06cPbt68iYsXL2Lu3LlYvHixycPS6dOnMXnyZIwcORLNmzc3aeeOO+5o8EFbvQ1rPQp9KqwX+LDHUsIxsZ8oC7W54spwQVlXJDOylHRMCL3BfKxC+ocGf+TQmBxFKLmYLQjte+HkZHXHW533mJW9cO4RN4yE8GT0kAqeU8TqAsDOnTv5BCkcQjNpOQICAkyyx3OUlpby9daYM2cOLl68iGvXrqFly5YAgDFjxiAkJARz587FwIEDMWLECJtsITwLa7Ol5XK54EtmsfX1CXfZ4qp+HW3XXn1b9MTKipFrTL4KNCx/ra3NgqJyPLV8B65nFAAAvJRyfDz7XvTrGg0AaOLrhYeGdnN6v/bKO+qLbtu3dd6jCL744gt8/PHHmD59OqRSKRhjeOWVV/DUU08hLCwM99xzj5nOunXr4Ofn/EzSBEEQRMNk3bp1mDRpEt566y1+faFvvvkGU6dOhZ+fH+bPn2+ms2jRIvTu3buuh0oQBEG4EMZg90zb/889gjZt2qBTp06i9dq2bYvr16+blaempgIA2rVrZ1X/+PHj6NixIx+w5Rg9ejTmzp2L3377jYK29Ry9Xm+1rqysDH5+foKzvmqrr0+4yxZX9etou/bq26InVlaMXGPyVaBh+au1NrPyizF92XZk5BUDAPy8lVg1dwzujIsQ3YazbHGWv3qqr3rkmra//PILnn76aX6Wk0QiwZtvvgmJRIIffvjBzaMjCIIgGgJffvkl3n33XZMF4adMmYJWrVrRtYYgCIJwKSNHjkR2djauXLliUn748GFIpVIMHy785QCHn58fbt26ZVZeUFA948nf3995gyXcgrWgrU6nQ05ODnQ6nV319Ql32eKqfh1t1159W/TEyoqRa0y+CjQsf7XUZnLWLUxesoUP2Ab5e+Pr1x40C9jaOy5bdZzlr57qqx4ZtL377rvNyrRaLRhjqKqqEtQ5evQoNm/ejF9++QUlJe79lJ0gCILwfISuNYwxaLVai9eaM2fOYPPmzfj555+tJpghCIIg6g8GSB362cOMGTPQvHlzzJs3j1+/9sqVK1i9ejWmTZuG8PBwXvavv/7CsGHD8OOPP/Jljz76KNLT0/Hxxx/zZUVFRXjzzTehVCoxfvx4+zYG4TEYZzmviUqlQlxcnMVM5LXV1yfcZYur+nW0XXv1bdETKytGrjH5KtCw/FWozYspOXjina3Iu129vE9oM39sfPMhdIhu4bRx2arjLH/1VF/1yOURhFi5ciUACL51VqlUWLp0KYKDg3Hu3DkUFhbijTfewKuvvmq1zby8POTn55uUJSUlWZAmCIIgGjrbtm3DzZs3MWvWLLM6qVSKr776Ci1btsTVq1eRlJSE6dOn49NPP+UTx1iCrjcEQRCeiwES6O1NRGbDmt/GBAUFYd++fZg0aRKio6MRExODs2fPYvz48fj0009NZAsKCvDLL79g2LBhfNkbb7wBnU6HN998E5988glCQ0Nx+fJlREVF4eeffzZbX5cgCIIgHOH0lQzMWrEbFVVaAEBMWFOsmT8OYc3oyw5XUi+Ctr///jvee+89dO3aFVOnTjWpGzp0KJ599lmEhIQAqJ6R+/LLL2PBggVo2rQpnnnmGYvtrlq1CosXL3bp2F2N2ARZdZngyZYEV0LjcnfSLyFs2X6uGH9jT9ol1lZHt7279zPhXtLT0/Hss8+iefPmeP31103q2rdvj8uXLyMuLo4v++KLL/Dss89CLpfzLxYtUd+vNw+3+Uu07LfXzdf8FQqGWEo4JjYZkNpgHigv0wsnH335wgSzsg+6bRXVjyXsDdRwSMHMymxJbuaKpGXre35jVuaK5GTupljrLVj+n99eMCsr05jPpvht2AcO9T/wl3mC5d5yrVnZ/oGfONQXIQ4Dk9i9pq29egAQHx+Pq1evIjExEUVFRWjTpg3CwsLM5Hr27IlDhw6hbdu2fJlMJsOSJUvw2muvITU1FUVFRYiKikJkZCQkEsfOT4RnoNWanxM4NBoNMjMzERkZKTgjt7b6+oS7bHFVv462a6++LXpiZcXINSZfBRqWvxq3eSIxEy99thcabfWyLR1aBeOLlx9AsyY+Th+XrTrO8ldP9VWPD9omJiZizJgxCA4Oxo4dO8w2Tv/+/U3+VigU+PDDD7Ft2zZ88sknVoO2M2fOxIQJpg9ySUlJGDt2rNPGTxAEQXg++fn5GDVqFMrLy7F//36Ehoaa1Hfu3NlMZ8aMGdi2bRvWrl2L5cuXw9tbOBAE0PWGIAiCEEYikaBLly5WZZo1a2Yyy9YYb29vdOzY0RVDI9yMteC7VCpFQEAAnwPG1vr6hLtscVW/jrZrr74temJlxcg1Jl8FGpa/cm3uO3kdb60/DL2hesJBj7gIfPbS/fD3qX2ZAHvGZauOs/zVU33Vo4O2165dw7Bhw6BUKnHkyBG0bt1alJ5cLkfnzp1x5MgRq3ItWrRAixbCa28QBEEQjYPCwkIMHz4caWlp2LNnDwYMGCBat3v37jh8+DAyMzNNZkDVhK43BEEQnkv1TFv7HsIcmWlLENaQyy0/qsvlcjRv3tzu+vqEu2xxVb+Otmuvvi16YmXFyDUmXwUalr/K5XIcPJeJ9zYe48v6d4vGiufvgbfK+tJwjozLVh1n+aun+qrHvs5ISUnB0KFDAQBHjhwx+SRVDFlZWWjWrJkrhkYQBEE0EIqLizFy5Ehcu3YNu3btsjiTyRJZWVkAqtcmJAiCIOonBkigt/Pn6FIpBGEJvV5vta60tNSiTG319Ql32eKqfh1t1159W/TEyoqRa0y+CjQcf2WMYfWOkyYB29G92+HTF+8THbC1d1y26jjLXz3VVz0yaJuRkYEhQ4ZAq9XiyJEj6NChg6AcYwxpaWlm5Xv27MHFixfx4IMPunikBEEQRH2lrKwMo0ePRmJiInbu3IkRI0ZYlE1NTTUru3LlCnbs2IHBgwfTS0KCIIh6DLemrb0/gnAFVVVV/P/VajUfKNDpdKioqEBWVhZ0Oh3UajV0Oh2A6qAC93dWVhYqKirM6hir/sRZo9Hw6+YaDAaTOq1Wa1ZnMBjM6hhjZnUajcakznjcXJ2QTWq12qSOG7darUZ6ejr/t0ajqRObNBoNsrKyUFVV5VSbdDodMjIyUFFRwdfZYlN5eTkyMzOh0+lssqmmnjWbavqXJZsqKiqQkZEBnU7Hj7umTZy95eXlgjZpNBqkp6fzf3uS71myydp+0ul0yMzMNLG3Lmwy3heO2mQwGPDhD8fx+faTvNyEwV2w+MnBkMukNtmk1WqRnp7Oj1WMTcbnL2eeI3Q6HW7cuMGfW2ueIyorK3Hjxg3odDpBmyorK5GVlQWtVuuQ79mKxwVtq6qqMHToUKSnp2PatGk4e/YsNm3axP8OHDjAyzLGMHr0aEycOBHvv/8+vvjiC0ybNg3jxo3D4MGD8d5777nREoIgCMKTeeihh/Dnn39iwoQJyM/PN7nWbN682UR29uzZGDVqFJYsWYI1a9Zg7ty56NWrF6Kjo/H111+7yQKCIAiCIBoKixYtgkQi4dfRLyws5OvS0tJQVlYGACgpKUFOTg7atWsHpVKJjIwMlJRUJ8gtKytDWloalEol2rVrh/z8fBQVFQGoDuqkpqbyAYrs7Gy+j6qqKqSmpvKBjtzcXOTn5wOoDkikpqbyQZj8/Hzk5uYCqA5IpKam8kGQwsJCZGdnA6h+Vk9NTeWDk0VFRcjMzLRoU0ZGBl9nbJNGo4FcLudz22RmZtaJTQaDAe3atUNpaalTbVIqlQgLC8PNmzf5OltsysrKQmxsLJRKpU02ZWVlISoqCkqlstb9lJ+fz/uXNZtycnIQEhICpVLJ+15Nm5RKJSIjI5GVlSVok8FggEwmg0wms2s/udL3LNlkbT8plUpERUXxQe+6sunmzZsICwuDUql0yKak5GS8te4wNuw7y8tMvy8e8yb2xg2jwKhYm7h9ywU4xdjEnb9u3rzp1HOEUqmEr68vSktLAZifI27fvo3AwEAolUpBm27fvo127dpBJpM55Hu2ImGcl3kIZWVlmDFjhsX6Nm3aYNGiRfzfBoMBe/fuxZ9//omcnBy0aNECQ4YMwfDhw+3KnHrp0iV07twZsbGx8PIyzUJtS2Z5IepLtvm6tFNsX462GbjgqGj9oqWDRclZalOsfl36gyu2c10idp+K3fa24Kjveeo2rSsSExPdPQSLzJo1i7+g18TLywvr1q0zKTt+/DiOHDmC9PR0NGnSBH369MGYMWPszh7KXW8SExPRqVMnvrzt1iVmshKJ+Ev1Pw++Zdd46ppVVwcJlusF3icLrTU5u8Nh0X3NPPOYWZnaYL5W4Pqe34huc+jRl0TLikUK8ftZyCekAmX7B37i0Jhs4YnTT5qVWbLp616e97Jj4C/zzMo0eplZmVagDAD0BnH3nQqZQbD89KilovRfOPeIWdmnd/wgSpcwhTsPj//xfgTFBtrVRmFyEbY9vNvsXE4Q9sL55blz59C9e3cA1bOz5HI5ZDIZP6tRpVLxdTKZDHK5HHq9Hjqdjq/TaDSQSqUmdUqlEhKJBBqNBhKJBAqFAgaDAVqtlq/jAhXGdQqFAlKp1KSOMQaNRmNSxwVHuDrjcRsMBv6+iWwim8gmz7KpskqD+av34cjZf78wnD3hbjx1/1311iZP3E/cOMXicYnI/Pz8sGnTJtHyUqkU9913H+677z4XjoogCIJoaHz22Wc2yffv3x/9+/d30WgIgiAId8EAu9em9ajZL0SDxfghXy6Xw2AwID09HWFhYSZ13Kw2jUaD7OxshIWF8QnNjGczAjB56SyVSk3aUSgUouokEonoupqJ1WrWGdcb1+n1euTk5PCzCI3H7UqbjLch164zbDJuV2jctdkkkUhw48YNk3GJsUkikSAjI8NMT8gmbsmCmv5V0yaJRIKsrCy+TaFxG9vLTaoz7l+n05nsX0/yPWv7wlKdkL11YZNEIkFmZia/HW21qaJKg9mf/IQ/E2/8f3vA65MH4e52TaHRaKBUKu06nrRarcX9a8km423IjdUZ54iax17NcTPGTI75mjZZOi7s9T2xeFzQliAIgiAIgiAIoq7QMwn0dq5Na68eQTiCRCKBl5eXxS9La6uvT7jLFlf162i79urboidWVoxcY/JVoH76a3F5FWZ+uBMXknIAAHKZFMueHYWhd8agsLDQIVvsGZetOs7yV0/1VQraEgRBEARBEARBEIQHYTx7S6guJCTE7vr6hLtscVW/jrZrr74temJlxcg1Jl8F6p+/FhSV46nlO3A9owAA4KWU4+PZ96Jf12gAcNgWe8Zlq46z/NVTfdXjEpERBEEQBEEQBEHUFQxSGJh9P0aPU05hz5496N27N5o0aYKNGzdi3759+Oijj9w9LLfCJe6xVFdRUWFRprb6+oS7bHFVv462a6++LXpiZcXINSZfBeqXv2bmFWPyki18wNbfR4k1rzzAB2ydYYs9bdiq4yx/9VRfpZm2Flg91A/tgn1qlbMlwdVemCdJ8sQkRXU5Jk+035Z9KhZPtLM+IbT9hI4nR/edo4nMGuJ+tiUxYUO0vy4YfeALqC63sCrDBD6/tZScrN3/3jYr88TkZDPbH6uzvlb1EL9WvlgMAvtEKBGYTW1aWFNTKJmXkE/sH/SxQ/07SqXefFaYXFJ/HsJ+HfqhWVmPn183KzPYsJuF9pNW71iQryEmHWv9w3uiZVMeec3p/RuYRPCYFqtLOMYff/yBGTNm4IsvvsCGDRtgMBgwfPhwPP/88xg/fjxatmzp7iG6BS6juRBarRY3btxATEyM4BqJtdXXJ9xli6v6dbRde/Vt0RMrK0auMfkqUH/8NTnrFp56fzvybpcDAIL8vbFm/gNo3+rfZxJn2GJPG7bqOMtfPdVX6dUwQRAEQRAEQRCNFgMkDv0Ix9ixYwfmzJmD++67D/7+/gCqk7d069YNf/75p5tH5z6sLY+gVCoRGxtrknDHlvr6hLtscVW/jrZrr74temJlxcg1Jl8F6oe/XkzJwRPvbOUDtqHN/LHxzYdMAra2tumMcdmr4yx/9VRfpZm2BEEQBEEQBEEQhFvw8vJCeXl18MA4wUt2djbCw8PdNSy3U1tyJ2tB3drq6xPussVV/Trarr36tuiJlRUj15h8FfB8fz19OQOzPtqNiiotACAmrCnWzB+HsGb+drfpjHE5ouMsf/VUX6WZtgRBEARBEARBNFoY+3eJBFt/zLFVUQgA48ePx6pVq7Bt2zZUVlaipKQEH330EW7duoVevXq5e3huQ6vVWq3LzMy0KFNbfX3CXba4ql9H27VX3xY9sbJi5BqTrwKe7a9HzyZjxoc7+YBth1bB+Ob1CYIBW7FtOmNcjuo4y1891Vdppi1BEARBEARBEI0WLqmYvbqEY9xxxx1Yu3YtXn75Zfzzzz/YunUr+vbti927dzeINS5dhVRq3fdqq69PuMsWV/XraLv26tuiJ1ZWjFxj8lXAM/11zx9X8Maag9D//8L8PeIi8NlL98Pfx/o51hm22NOGrTrO8ldP9FUK2hJEDYSSUbkiOZklxCZ+EkzOZUFXaPyOJt1qiAhtJ6GEZ4BnJt2yJWmYWMh36gAGk5laVr6GNFWzkPzGUoIywrk4mnzIlqRlrlgzc+Av80TJCSXnAoB7jz9vViaXyMzKDNL6vd6nUNIxS8eeWCzpd//pDbOy8/e+41BfrqD1j++KF64nSbooEZl7+f3339GxY0dcu3YNZWVlUCgUFKyF9TVtFQqF1aUjaquvT7jLFlf162i79urboidWVoxcY/JVwDP99ftD5/HexmP83/27RWPF8/fAW2X9U39n2GJPG7bqOMtfPdVXG9YrDYIgCIIgCIIgCKLesG3bNhw9Wv2S2M/PjwK2/4/BYLBap1arLcrUVl+fcJctrurX0Xbt1bdFT6ysGLnG5KuAZ/krYwxf7jxlErAd3bsdPn3xvloDtpbadMa4nK3jLH/1VF+loC1BEARBEARBEI0WBgkMdv6YC2bCNzaGDRuGn3/+GYwWCDZBp9NZrNNqtUhNTbW69qK1+vqEu2xxVb+Otmuvvi16YmXFyDUmXwU8x18ZY/jg+9+wctufvMxDQ7pg2bOjoJCbfxklpk1njMsVOs7yV0/1VVoegSAIgiAIgiCIRgstj+Be8vLy8Pvvv6Nz587o0aMHlEolX/fkk0+iT58+bhyd+5DLLT+qKxQKxMTEWFxCobb6+oS7bHFVv462a6++LXpiZcXINSZfBTzDX3V6AxZ9dRg7f7vM10+/rydmT+gDidh12OAcW+xpw1YdZ/mrp/oqBW0JgiAIgiAIgmi0GGB/8LVhfNDrXlq0aIG5c+cK1vn7C2c1bwxYS3gjlUqtLiNRW319wl22uKpfR9u1V98WPbGyYuQak68C7vdXjVaHV1btx+G/kvi6lyb2w5P3xtvdpjPG5UodZ/mrp/oqBW0JgiAIgiAIgiAIt3DPPffgnnvucfcwPI6Kigr+/2q1GnK5HDKZDDqdDmq1GsXFxQgODobBYIBMJoNcLoder4dOp4NUKkV+fj6aNGkClUplUqdUKiGRSKDRaCCRSKBQKGAwGKDVavk67vNf4zqFQgGpVGpSxxiDRqMxqWOMQalU8nXG4zYYDPxM6po26fV6PiCiVqt5m6qqqpCbm4vw8HAoFApoNBpIpVKX2wQAt27dQtOmTSGTyZxmE2MMubm5CAwMhJ+fHwDYZFNFRQWKi4vRokUL3j/E2FReXo6ioiKEhIQAgNX9VNO/LNlUXl6OwsJChIaGQiqVQqfT8XWcTcb2+vr6mtmkVquRk5ODsLAwKJVKj/I9bl/UtMnafgJgZm9d2FRWVobs3AK8v/UMTl7KAFCd3Hjh1KG4r0876HQ6m22qqKjArVu3EBoaCplMZtfxpNFokJ2djdDQUKhUKlE2SSQS5OfnIyAgAN7e3k47R+h0OmRnZyM4OBje3t5m5wghe41t0mq1KCoqQvPmzcEYs9v3bA38UtDWBVjKrO6J2ebdjdhs945uO1uy3Qv1tRfm+oELjopuU6ydtrRry5iE7Cd/FIelbSq0/d29TQV9V8D3bPFdW7DFzwnLCC3pZ8OXTPjnwbecN5gGQvef3jArUynM1wo8NXKZ6DY1evP1wBRS4Tl3Eon5Tj065L9mZYOPCM80E8vAX+Y5pC/E0KMvCZbLJOb2G6Tmjrqz36dOH1Ndwtz86fsde183Kzt3z7tuGMm/pDxsPqbWP7xXZ/0L9ZXyyGsOtckcWB7B3T7SUDh8+DDefvttXLp0CV5eXujbty+WLl2K2NhYdw+tzli0aBEWL17M/52fn8//Py0tDaGhoWjSpAlKSkqQn58PX19fAEBGRgaCgoIQFBSEsrIy5OTkoHXr1jAYDLh58yaaNm2K5s2bo6KiAllZWWjXrh0kEgmys7Ph5eWFkJAQVFVV4caNG4iNjYVCoUBubi6kUinCw8P5dRxjYmKgUqmQn58Pg8GAyMhI6HQ6pKamomXLlvDx8UFhYSGqqqrQqlUrMMaQmpqKiIgI+Pv7o6ioCCUlJWjdurWgTYWFhWjTpo2ZTeXl5cjLy+OztmdmZiIgIMDlNoWHh8NgMKCwsBA6nc5pNvn7+6OiogKlpaXo0KGDzTalp6fzwV5bbEpPT4e3tzcA1Lqfbt++zctasykzM5Nfi5rzvbi4OBObmjRpwo+7Q4cOZjap1Wrk5ubyQWhP8j1LNlnbT0FBQdBoNEhPT0e7du3q7Hi68k8Klm45i3+yigAAcqkEy2aOxqi72iEpKckum3JyclBZWYnQ0FC7jye9Xo/c3Fw0bdoUKpVKlE1RUVEwGAzIyMhAeHi4084RnO/LZDJERESY2ZSXl4fS0lKEhoYK2sQFY/V6PdLT0+32PW7bi4WCtgRBEARBEARBNFpoTVv3cvbsWYwbNw5vvfUWVqxYgaqqKmzcuBHDhw/H33//zQeoGjqLFi3CokWLcOnSJXTu3JkPQABAdHQ0v8ZtQEAAfH19+dlaUVFRkMmqX6T5+fkhOjoaCoUCkZGR/IwzAPDx8UFMTAw/GzAsLIz/v5eXF2JiYvg+uNmYgPk6jsHBwXydXC43qQsKCuKDeBKJxKTNwMBABAT8+4JfyCYOY5sCAwPRtWtXvo/IyMg6sykgIICfRecsm+RyOWJjY00SzdliU5s2bfiZgbbY1KZNG35moJj9xM0MtGZTdHQ0bxPnezVt4ranTqcTtMnPzw/dunXj+/Mk37Nkk7X9pFAoEB0dDa1WW2fHU35ROd7dch5J/x+w9VLK8cHMkRjco61DNkVGRvI2yWQyu44nLy8vdOvWzSabuPMXNyO6tv0k9hyhUCjQsWNHi+eIiIgI3h6DwSBoEzcj2hHfsxUK2hIEQRAEQRAE0WgxQAID7F3TloK2jrJ161a8+OKLmDfv368F+vXrh/79++PEiRMYMWKEG0fnPowTkRl/Tst9dssFhYzrZDIZ/wm+TqeDQqHgAxRcHYdxwreaazUaJ9qxVieRSETX1UysVrPOkr1SqZT/zF4ikZiM25U2Mcb4bcxtQ2fYxBgz+Vy65rhrs4n7zFsul9tkE6fHBa9q2ms8bmPbrdnEtckYszhuY3u57Whsk0QiMVm/2ZN8z9q+sGavXq83sdeVNmXmFeOp97cjI68YAODvo8TnL43BnXERDtukUCj4/Wvv8cTVC20LSzZx5y/jbeiMcwRXz7VTc9xyudyqvZaOC3t9TyyWVzcnCIIgCIIgCIIgCBei1+sFs3GrVCro9Xo3jMgz4NaFFEKj0SA5OZlfe9XW+vqEu2xxVb+Otmuvvi16YmXFyDUmXwXq1p7krFt4/J0tfMA2wEeJL+eZBmwdwRm22NOGrTrO8ldP9VWaaUsQBEEQBEEQRKOF1rR1L2PGjME999yDiIgIDBgwAGq1Gt999x0uX76MPn36uHt4bqPmDC1jFAoFWrZsKRjsFlNfn3CXLa7q19F27dW3RU+srBi5xuSrQN3ZczElBzM+2InisioAQFgzf3w6ezTiWoU6rQ9n2GJPG7bqOMtfPdVXKWhrA0LJeyjBkzhsSVAkdvtZatMV+0lscjJb2nU0aZNYOwnHaOyJBR09dhLfceZoGibMIAEz/Pvhi1DSKqHkZEkTzZNrNXbitr0tWC6XmyfNOn+veOfstGuhWZlCZn7DZhBIbgaIT3AmlJwMAAYcftms7LdhH4hq09HkZDqDhY+yhIqF87DVa1wRkBM6xi3h7qRjYhE6R1nClsSKjiYYEwutaete+vbti3Xr1mHx4sV45plnoFQqcffdd2Pfvn1o0qSJu4fnNow/GReq8/Hxsbu+PuEuW1zVr6Pt2qtvi55YWTFyjclXgbqx5/TlDMz6aDcqqqpn48eENcX/sXfe4VGU2x//bk82lQSSkEISCKAQAUGwN7BQpCiiXhty7VzxoiIqWIJXAbErotgVewURRSmKDaVbUMCEVFIIhCSkbJ/fH/ntmM3ObqbuzO6ez/Pso8wp7zkzZ2aTN++858W7LkLv1ARZx5EjFzE+hNrIVa9arVXaHoEgCIIgCIIgiKjFw/wzcSv8o3b0kcHFF1+M33//HTabDa2trVi/fj2GDh2qdliqEmx7BKfTibq6uoA63cnDCbVyUWpcqX7F2gux46vLRy+aahVQPp9vdpTgpsdWshO2g/LS8Ma909AzMUb2ceXIRYwPoTZy1atWa5UmbQmCIAiCIAiCiFoYiJ2w1YGhRmSysHPnTlx11VUYOXIkTjnlFNxxxx2oq6tTOyzNwjAMbDYb27FcqDycUCsXpcaV6lesvRA7vrp89KKpVgFl8/nsh78w++nP4XB27PU9YmAWXrlnKlISrYqMK4dPMT6E2shVr1qtVdoegSAIgiAIgiAIglCFnTt34owzzsCNN96IqVOnwm6345133sEZZ5yB7du3Iz4+Xu0QVSHYvolmsxm5ubmi5eGEWrkoNa5Uv2Lthdjx1eWjF021CiiXz9tf78KiFd+y/z59aB6emDUBsRaTYuPK4VOMD6E2ctWrVmuVJm0JgiAIgiAIgohaGEYnev9iakQmnbfffhs333wzlixZwh675JJLMGrUKGzatAkTJkxQMTr16G71IsMw0Ol00HFsFN2dPJxQKxelxpXqV6y9EDu+unz0oqlWAfnzYRgGy1dtwdKPN7PHxp88EA/fcB5MnXo2KHEe5fApxodQG7nqVau1SpO2AqCmY/xQoumYEOg6aQ+umtDiNYnE2hHSRI+vPSEvHkYHj+efL36uHwJC1YwnnMh/Z6HfMb3ev+EYAOyder+ksdxu/92kuCZqhDQ3E4LNJf7HtUATSkKaYXHB3XxJ3V23jvvM/zr/Pom7OZ2aBLomv078X4gjkY/Sy7mfUVz3Kdc8VCD7UOGBDh6R2xyItSP+ITExERaLxeeYTqdDamoqEhOlNe4NZ4Ltm+hwOFBaWor8/Hy/c8dHHk6olYtS40r1K9ZeiB1fXT560VSrgLz5eDwMHnv3O7y5did77JLRx2H+9LNh6NKoUInzKIdPMT6E2shVr1qtVZq0JQiCIAiCIAgiamH+f39asbaENC677DJMmjQJ+fn5OPXUU2G32/Huu+/i6NGjOPbYY9HY2AgAsFqtMJvN6gYbQgwG7j9EAoDRaERWVhaMRu5f57uThxNq5aLUuFL9irUXYsdXl49eNNUqIF8+LrcHRa+sx8rv/2SPXTdxJP477RTOBR5KnEc5fIrxIdRGrnrVaq1Gxp1BEARBEARBEARBhB0LFy7E3r17cemll/rJevXqxf7/a6+9hmuuuSaEkalLsElbg8GAhIQE0fJwQq1clBpXql+x9kLs+Ory0YumWgXkycfhdGHusrVYv62YPXb7Zafh3xNOUHRcJXyK8SHURq561WqtqvseG0EQBEEQBEEQhIp497QV+yGk8eqrr8LpdHb7mT59utqhhhSXyxVUdujQoYA63cnDCbVyUWpcqX7F2gux46vLRy+aahWQnk+bzYH/PPEZO2Gr0wFF/x4TdMJWjnGV8inGh1AbuepVq7VKk7YEQRAEQRAEQUQtHub/9xcX9VE7+vDC5XJhy5YtWL16Nb7//ns0NDRAr9fDaDR2+4mEJkVCCNaIzOPxoLm5GR6PR5Q8nFArF6XGlepXrL0QO766fPSiqVYBafk0tdhw/SOfYPMfFQAAo0GPR/8zHheffZyi4yrpU4wPoTZy1atWa5W2RwhztNjgSe3xlUBIczWpcDXDkooWr4kWazeUhKqmuM5pNJ3ncIBx68C4//lFVIu//5+rn+Z3bJ3nQxUi+YdQNi5yODh+XFJgdR1XIy0AMARosCYFrtWBQpqTce3/+c3oxyXFJBU9R/xSm5OJ3edUK+S+vMT/oJCHDM/0y6+by3lc7QZjfJGyYpZW2vLn888/xw033ICamhr2mMFgwJlnnon58+dj9OjRKkanPUwmU0CZ2WxG3759RcvDCbVyUWpcqX7F2gux46vLRy+aahUQn099YytueOQT/F11GAAQYzbiqf9egNOG5Ck6rtI+xfgQaiNXvWq1VmnSliAIgiAIgiAIglCMnTt34sILL0RmZiZuuukm5OXlobW1Fbt378Y333yDMWPGYM6cOXj00UfVDpUgCCKkVB1swvWPfILKg00AgASrGc/dPhnDB2apHBmhBWh7BIIgCIIgCIIgohYGYrdG0IHhuxw5ylm0aBHGjBmD3bt34/nnn8ddd92FBx98EB9//DGqqqqwYMECPPXUUzRp2wmHwxFQZrfbsXfvXtjtdlHycEKtXJQaV6pfsfZC7Pjq8tGLploFhOdTXHUYVz/0ATthm5JoxWvzLhY8YavEeZTDpxgfQm3kqlet1iqttCUIgiAIgiAIImphmI6PWFuie9avX49NmzYhPj7eT2a1WnH//fcjNzcXM2fOxLXXXouUlBQVotQWBkPgrXGMRiMyMjJgNHL/Ot+dPJxQKxelxpXqV6y9EDu+unz0oqlWAWH5/L6/Fjc9uhJNLTYAQO/UBLx010XI691D0XFD6VOMD6E2ctWrVmuVVtoSBEEQBEEQBBG1eKCT9CGC09DQAJfLheOOC95MZ/r06TjllFPw3nvvhSgybRNs0tZgMCApKSmgTnfycEKtXJQaV6pfsfZC7Pjq8tGLploF+Oez5c9KXLvoY3bCNr93D7x53yWiJmyFjBtqn2J8CLWRq161Wqs0aUsQBEEQBEEQBEEoQktLC3r04DcRceWVV+KHH35QOKLwwOVyBZV5J8PFyMMJtXJRalypfsXaC7Hjq8tHL5pqFeCXz8btJbjpsZVoszkBAIPy0vDGvdPQOzVB0XHV8CnGh1AbuepVq7UaGWvQo4BQdZoPJyasbOY8LvVccdkn3/MNf3uc7XeMK9ZA8atJuNdZ4yL/cx/o2nHpqn1NhNQZX7jqMRBq5x+tMIwOjKfTSi2VO5Gfq5+m6vhaZP9l8/2O5b7+iCSfg1c9wHGU+9p73P5/0R+0ssjv2J9T/I99d44294c8fo3/OWUk176/vV4XunfXuUbiymn35AXKB8MGwFcv0Lnn5yD3pSXcAg635dfN5RdTCGEYnej6k163kY/H44FOx+88DRkyBMuWLVM4ovCg876JdrsdRqMRBoMBLpcL7e3taGhoQFxcHNxuNwwGA4xGI9xuNzuh0NDQAJPJhNjYWB+Z2WyGTqeDw+GATqeDyWSCx+OB0+lkZU5nx2RSZ5nJZIJer/eRMQwDh8PhI2MYBmazmZV1jtvj8cBsNnPm5Ha7YbFYWJk3J4fDgYMHDyIuLo79t16vVzwnj8eDhoYGWCwWNm45cnK73Th06BBMJhMSEjom6YTk1NbWhsOHDyMuLg7M/+/PwientrY2HDp0iLULdp261legnNrb21mfOp0OLpeLlXlz8uZrNBqRkJDgl5PT6cTBgwdhtVphNBo1VXvea9E1p2DXyePx+OXbOe5V3+/G/S+vh9vTce2GD8jEU7eOR0qiVVJOna8FAFlystlsqK+vR1xcHBuP0PvJ5XLh4MGD7HOIT04Mw7DPL6vVKtszwu12o76+HhaLBUaj0e8ZwZVv55zsdjsaGhpgtVrhdrtF1543B77QSluCIAiCIAiCIKIWRmQTMo+Eyd5oo62tDVu2bEF7e3tQveTkZDQ2NoYmKI1RVFQEnU6HwsJCAB2Trl7KysrQ0tICAGhubkZdXR0KCgpgsVhQWVmJ5uaOP7y3tLSgrKwMFosFBQUFqK+vZ89nW1sbSktL2Ym+mpoadgybzYbS0lJ2wreurg719fUAAKfTidLSUnYipr6+HnV1dQA6Vp6VlpbCZrOxMdfU1AAAGIZBaWkp2traAACNjY2oqqoKmFNlZSUr65yT0+mETqdjJzqqqqpCkhPDMCgoKEBLS4usOVksFqSnp6O6upqVCcmpuroaeXl5sFgsgnKqrq5GdnY2LBZLt9epvr6era9gOdXV1aFnz56wWCxs7XXNyWKxoHfv3qiurubMyXvM+8q5lmovUE7BrpPFYkF2djaqq6v9au/tr3dh/ovr2AnbM4blY8HVJ6HtaKPknKqrq5Geng6LxSJbTocPH0ZycjIsFovo+8l7Xb0++eTkfX5VV1fL+oywWCyIiYlhfXbNqbGxEQkJCbBYLJw5NTY2oqCgAAaDQVLtCYVW2hIEQRAEQRAEEbVQIzLlqa+vx4knngiDwYABAwZg6NChGDZsGPvfjIwMAIBOp4uYLvJCKSoqQlFREXbv3o3CwkL2nABAXl4e2/wmMTGRXU0HADk5OezESHx8PPLy8lhZdnY29PqOdVpWqxX5+fnsqufevXuz/x8TE4P8/Hx2jPT0dNaHyWRCfn4+TCYTAKBXr16szGg0+shSUlLYyRmdTufjMzk5GYmJ/7zVRzlRTtGSU1paGl5avQ3Pr9zC+hp30gAsvPF8gPGEZU6ReJ1ClZNQaNKWIAiCIAiCIAiCUIQ+ffpgy5Yt2L59O7Zt24Zt27bho48+8mk4lp6ejqFDhyI3N1fFSLUF0+kvAp1fp/W+8ltcXIycnBwfmcFggMFggN1uR2VlJXJyctjJA6/Mi/d1XQDQ6/U+fryTEd3JOq9u607WteN6V1lneWeZy+Vic7FYLD5xK5lT53Po1ZUjp85+ueLuLicAKCkp8bv23eUEAPv37/ez48rJbrdz1lfXnICOlYNePa64O+frjaNzTk6n0+c8a6n2gl2LQLKu+Xo8DJ78YDNWfLWT1b1k9HGYP/1sGPR6AP/4kJITAJSWlrLnUY6cGIZBRUUF61PM/eRwOAJe30A5dT6H3njkeEZ0vfe6xu3xeHz8dM0p0H0htvb4otlJW4/Hg/3796OiogKZmZno16+fz8noSltbG3bs2AGXy4WhQ4fy3uyeIAiCiG4qKytRUlKClJQU9O/fH7GxsQF1XS4XduzYgaNHj+KYY45BVlZWCCMlCIIglICB+L1paaFt9+j1eowcORIjR45kj9lsNvz666/Ytm0bO5m7YcMGuN1umrj9f7wTdFwYDAakpKQE7XIeTB5OqJWLUuNK9SvWXogdX10+etFUq4BvPi63B0WvrMfK7/9k5ddNHIn/TjuF9z7fYsbVkk8xPoTayFWvWq1VTU7aPvjgg3jllVfQ3t6OwsJC/P3339Dr9XjssccwbZp/g5Q33ngDs2bNQt++fREXF4ft27dj/vz5uO+++0THcPOGFsTEhGcHQ65mUlIbDAlpUBXuzYy44hfSzCmcUaq5m5Cx5LaPlmsXCCWa6EUKr732Gp588kmUlZVhxIgRqK6uxsGDB3Hvvffijjvu8NP/5ptvcNVVVyEmJgY5OTn4+eefcdlll+HFF18M+kfF7lg/+ToMHjxYSiqqEKhh2TrPh5L85i7n1zir/MY7JY0jGZe0H7a5mlEd+2mRJJ/hxM4JD/sdG/b5vZJ86jiaju264CFJPn+f9CBv3YEf++u63Rrc71TI5KTk/Vr9rwlX07Ly69VtTkaNyJSlawMZoOO11BNPPBEnnngie6y9vR27du1CSUmJGmFqDq6VdJ1lKSkpouXhhFq5KDWuVL9i7YXY8dXloxdNtdrUasO6LX/jUFMbkuNj8P2vZdi0q5SV337Zafj3hBMUGVuJ8yiHTzE+hNrIVa9arVVNTto+9NBDeOihhzB79myYzWa4XC7ccsstuPTSS5GSkoIxY8awups2bcKMGTOwcOFC3H333QCAVatWYcqUKcjOzsaMGTPUSoMgCILQME888QTOOOMM/PDDD+xeQ0899RRuu+02mM1mzJo1i9WtrKzEpEmTcOGFF+KNN96ATqfD77//jpNOOgkpKSl4/PHH1UqDIAiCkIi3qZhYWyI4VVVVGDJkCMaOHYvJkydj/PjxnG9FxsbG4uSTT8bJJ5+sQpTaw+12B5W1tLQgPj6ec9VXd/JwQq1clBpXql+x9kLs+Ory0YuGWmUYBstXbcFLn22B3cl93xb9ewwuPvs4xWJQ4jzK4VOMD6E2ctWrVms18DsXKrJmzRrMnTuX3YvCaDRi8eLFYBgGb775po/uokWLkJGRgTvv/GfFzeTJk3H66afjoYekra4gCIIgIpcnnngCzz33nM/m8LNnz0Z2djZef/11H92nn34abW1tWLJkCfs603HHHYfp06dj6dKlUdvpmiAIgiC6IyMjAwsWLMDBgwcxffp0pKWlYcyYMXjmmWdQXl6udniaJdikrcvlQm1tLdv1XKg8nFArF6XGlepXrL0QO766fPSioVaXr9qCpR9vDjhhO/bE/opO2ALKnEc5fIrxIdRGrnrVaq1qctL23HPP9Tvm/SX56NGj7DGXy4VvvvkGp59+ut9M9znnnIP9+/ejuLhY2WAJgiCIsITruwbo+L7p/F0DAF9//TWOOeYYn07OQMd3jcPhwLfffqtUmARBEITSMAAj8kOb2nZPTEwMbrvtNnz77beoq6vDK6+8guTkZMybNw95eXkYNmwYioqKsHPnzu6dRRGdm+l0xWKxYODAgQGb2nQnDyfUykWpcaX6FWsvxI6vLh+9SK/VplYbXly1JajONzv2o6nVpmgcSpxHOXyK8SHURq561WqtanJ7BC6WL18OADjrrLPYY+Xl5XA4HMjLy/PT9x7bt28fCgoKOH0ePHgQ9fX1PsdokpcgCCJ6+eKLL1BZWYnrr7/e5/jff/+N0aNH++l3/q4JBn3fEARBaBfa0zZ0pKam4uqrr8bVV18Nm82GDRs24LPPPsOLL76IBQsWICcnB5MnT8bkyZNx5plnStozniAIQmnWbfkbDlfgVfEAYHe6sW5rMS4+qzBEURGRRFhM2u7YsQMPPPAABgwY4POLtHclVFxcnJ9NfHy8jw4Xy5Ytw4IF/o1AtEgomwFxNZ2S2swoEFLyCtQciyvWUMUkh70WicScQlUngeqUb8M7IfceXxoXcecZiddZCLW1tbj++uuRlJSEe+/9pyGSy+WCzWYT/V0DhNf3jdRGYnzJfYFfwzEAAMecCGfDsgAr3spvkta0LPdFrlj9g+LW46b8Bv+YXC7u/bH0ev/E9k69n/dY4YLUpmFq43RyXD+OCb38dxby9ll6+TxeennLHuM8Xj7Tv8EX32Z/AREyR8mRP1ftqw1N2qpDTEwMJkyYgAkTJuCFF17Ali1bsGrVKqxatQpLly7FoEGDsHv3brXDVA2n0xlQ5nA4UFVVhezsbM4Vud3Jwwm1clFqXKl+xdoLseOry0cv0mv1UFMbL73Dja2KxqHEeZTDpxgfQm3kqlet1qrmJ21LSkowYcIExMXF4dNPP0VsbCwr854orj0lvF9ywU7mzJkzMW2ab/fr4uJiTJkyRYbICYIgiHChqakJ48ePx6FDh7By5Ur06dOHlRmNRuj1etHfNQB93xAEQRBEZ3bs2IGePXuiT58+cDqd0Ov1OPHEE3HiiSdi4cKFKC4uxg8//KB2mKri3R6QC71ej8TEROj13LsddicPJ9TKRalxpfoVay/Ejq8uH71Ir9WjbXZeeqnJ/os/5ESJ8yiHTzE+hNrIVa9arVVNT9pWVFRgzJgxsNvt2LhxIwYNGuQjz8zMBNDx2mlX6urqfHS4SEtLQ1pamowREwRBEOFGS0sLxo4diz/++AMffPABxo0b56fTu3dv0d81AH3fEARBaBkpW9PSlrbiWLp0KU4//XTMmDED119/Pc466yxcc801rLygoCDgFnfRgtEY+Fd1o9GInj17ipaHE2rlotS4Uv2KtRdix1eXj14k1+q6rcV4Z92ubvUsJgPOHans80yJ8yiHTzE+hNrIVa9arVXNTtpWV1dj9OjRaGpqwvr16zFs2DA/neTkZPTv3x87duzwk23fvh2xsbE47jhlu/QRBEEQ4UtbWxsmTJiAbdu24f333w+48nXUqFHYsGEDXC6Xzy9R27dvBwCceOKJoQiXIAiCUAAGErZHELRfRBdbhsHrr7+OTz75BEeOHMHAgQMxa9Yszt97AlFfX4/nnnsOmzdvhtvtxmmnnYbZs2cjOTlZdFyhoKCgAB9++CGys7NRW1uLPXv2cDb15GoCGi243YH3yXS73Whra4PVavVryM1HHk6olYtS40r1K9ZeiB1fXT56kVqrH33zOx58bSM8TPd/urt+0igkxcUoGo8S51EOn2J8CLWRq161WquaXIN+8OBBjB49GocPH8a6deswYsSIgLozZszAtm3bsGvXLvZYfX09Vq5ciX/961+wWq0hiJggCIIIN+x2OyZPnoyffvoJ7777Li666KKAujNmzEBzczPef/999pjL5cLrr7+OUaNGobCQGgsQBEGELYzEj0imT5+O2267DZMnT8aiRYtgMBgwatQorF+/npf9L7/8gmOOOQZ//vknZs2ahQULFsBisWDq1KnigwoRs2bNQt++fTF//nz88ssveOutt3DLLbf4fX755Re1Q1WNYJO2LpcLBw4c4Ny6iY88nFArF6XGlepXrL0QO766fPQirVYZhsGLn21B0asb2AnbM4fl46YpJ8Ji8p3Is5gMuGXqybhx8ijF41LiPMrhU4wPoTZy1atWa1VzK20dDgfOPfdc7N27Fw888ABqa2vx+eefs/IePXrg1FNPZf9922234YsvvsDEiRNx7733wmq14vHHH0d6ejoWL16sRgoEQRBEGHDllVdi/fr1mDFjBmJiYny+a4xGI8aOHcv+e+LEibjmmmtw0003obq6Grm5uXjllVdQU1ODTZs2qRE+QRAEEcZ89dVXWLFiBd58801cddVVAIDTTz8dJSUluO6661BSUhJ0JU9TUxMuuugiTJkyBa+88gp7/NRTT8Xs2bOVDl8yBw8exAMPPIBevXrhrrvuwoknnhj0j6fRiMlkCigzm80YMGBAwH1vu5OHE2rlotS4Uv2KtRdix1eXj14k1arHw+CRtzfh7a93scemnD4IRdeeA6NBj6vGHo91W/7GocZW9EyOw7mj+iu+wtaLEudRDp9ifAi1katetVqrmpu0tdlsyMnJQU5ODrZt24Zt27b5yI855hifSduYmBhs3LgRr732GjZt2gSXy4UrrrgCN910ExISEkIdftjB1dleiW71Qsbni5A4uXQbF50tKaYJK5t5j0+EBqn1LKRO+I4vRFeJe48rfqrdDrxdqw8ePIgXXnjBRxYbG+szaQsAr732GiZOnIjVq1fjl19+wahRo/Dq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",
+ "text/plain": [
+ ""
+ ]
+ },
+ "metadata": {},
+ "output_type": "display_data"
+ }
+ ],
+ "source": [
+ "contrast = np.array([0.01, 0.02, 0.05, 0.1, 0.2, 0.5, 1.0])\n",
+ "deff_ratio = [\n",
+ " oi.tortuosity(\n",
+ " composite,\n",
+ " direction=\"z\",\n",
+ " phase_diffusivities={0: 0.0, 1: 1.0, 2: float(c)},\n",
+ " ).effective_diffusivity\n",
+ " for c in contrast\n",
+ "]\n",
+ "\n",
+ "mid_y = composite.shape[1] // 2\n",
+ "extent_um = [0.0, composite.shape[2] * 0.5, 0.0, composite.shape[0] * 0.5]\n",
+ "phi_masked = np.where(composite > 0, res_comp.solution_field, np.nan)\n",
+ "\n",
+ "fig, axes = plt.subplots(1, 3, figsize=(11.5, 3.6), constrained_layout=True)\n",
+ "\n",
+ "cmap_phases = plt.matplotlib.colors.ListedColormap([\"#2b2b2b\", \"#f0f4f8\", \"#e07b39\"])\n",
+ "axes[0].imshow(composite[:, mid_y, :], origin=\"lower\", extent=extent_um, cmap=cmap_phases, vmin=0, vmax=2)\n",
+ "axes[0].set_title(r\"3-phase microstructure ($y = 16\\;\\mu$m)\")\n",
+ "axes[0].set_xlabel(r\"$x\\;[\\mu\\mathrm{m}]$\")\n",
+ "axes[0].set_ylabel(r\"$z\\;[\\mu\\mathrm{m}]$\")\n",
+ "\n",
+ "im_phi = axes[1].imshow(phi_masked[:, mid_y, :], origin=\"lower\", extent=extent_um, cmap=\"viridis\", vmin=0, vmax=1)\n",
+ "axes[1].set_title(r\"Composite potential $\\phi$ ($D_2 / D_1 = 0.1$)\")\n",
+ "axes[1].set_xlabel(r\"$x\\;[\\mu\\mathrm{m}]$\")\n",
+ "fig.colorbar(im_phi, ax=axes[1], fraction=0.046, pad=0.04, label=r\"$\\phi\\;[-]$\")\n",
+ "\n",
+ "axes[2].loglog(contrast, deff_ratio, \"o-\", color=\"#2b5c8f\", lw=1.7, ms=5)\n",
+ "axes[2].set_xlabel(r\"Binder diffusivity ratio $D_{\\mathrm{binder}} / D_{\\mathrm{pore}}$\")\n",
+ "axes[2].set_ylabel(r\"Normalised $D_{\\mathrm{eff}} / D_{\\mathrm{pore}}$\")\n",
+ "axes[2].set_title(\"Percolation bridging sensitivity\")\n",
+ "axes[2].grid(True, which=\"both\", ls=\":\", alpha=0.5)\n",
+ "\n",
+ "plt.show()"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "04-multiphas-12",
+ "metadata": {},
+ "source": [
+ "## References\n",
+ "\n",
+ "1. Z. Hashin and S. Shtrikman, *A variational approach to the theory of the effective magnetic permeability of multiphase materials*, J. Appl. Phys. **33**(10), 3125–3131 (1962).\n",
+ "2. J. Landesfeind, J. Hattendorff, A. Ehrl, W. A. Wall, and H. A. Gasteiger, *Tortuosity determination of battery electrodes and separators by impedance spectroscopy*, J. Electrochem. Soc. **163**(7), A1373–A1387 (2016)."
+ ]
+ }
+ ],
+ "metadata": {
+ "kernelspec": {
+ "display_name": "Python 3",
+ "language": "python",
+ "name": "python3"
+ },
+ "language_info": {
+ "codemirror_mode": {
+ "name": "ipython",
+ "version": 3
+ },
+ "file_extension": ".py",
+ "mimetype": "text/x-python",
+ "name": "python",
+ "nbconvert_exporter": "python",
+ "pygments_lexer": "ipython3",
+ "version": "3.11.2"
+ }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}
diff --git a/tutorials/05_rev_and_uncertainty.ipynb b/tutorials/05_rev_and_uncertainty.ipynb
new file mode 100644
index 00000000..a9bf3ba3
--- /dev/null
+++ b/tutorials/05_rev_and_uncertainty.ipynb
@@ -0,0 +1,334 @@
+{
+ "cells": [
+ {
+ "cell_type": "markdown",
+ "id": "05-rev-and-u-00",
+ "metadata": {},
+ "source": [
+ "[](https://colab.research.google.com/github/BASE-Laboratory/OpenImpala/blob/master/tutorials/05_rev_and_uncertainty.ipynb)\n",
+ "\n",
+ "# Representative Elementary Volume (REV) Convergence\n",
+ "\n",
+ "Tomographic fields of view are finite, so effective transport properties estimated on small subvolumes exhibit both sample-to-sample scatter and systematic finite-size bias. A subvolume of edge length $L$ qualifies as a Representative Elementary Volume (REV) once the ensemble mean $\\langle D_{\\text{eff},ii}(L) \\rangle$ stabilises and the coefficient of variation\n",
+ "\n",
+ "$$\\mathrm{CV}_i(L) = \\frac{\\sigma_{D_{ii}}(L)}{\\mu_{D_{ii}}(L)}$$\n",
+ "\n",
+ "falls below an engineering threshold (typically $5\\%$)."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": 1,
+ "id": "05-rev-and-u-01",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2026-11-18T09:45:14.718799Z",
+ "iopub.status.busy": "2026-11-18T09:45:14.718645Z",
+ "iopub.status.idle": "2026-11-18T09:45:14.724806Z",
+ "shell.execute_reply": "2026-11-18T09:45:14.724063Z"
+ },
+ "tags": [
+ "remove-cell"
+ ]
+ },
+ "outputs": [],
+ "source": [
+ "import sys\n",
+ "\n",
+ "if \"google.colab\" in sys.modules:\n",
+ " !pip install -q openimpala matplotlib"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": 2,
+ "id": "05-rev-and-u-02",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2026-11-18T09:45:14.726588Z",
+ "iopub.status.busy": "2026-11-18T09:45:14.726391Z",
+ "iopub.status.idle": "2026-11-18T09:45:15.105942Z",
+ "shell.execute_reply": "2026-11-18T09:45:15.104447Z"
+ }
+ },
+ "outputs": [],
+ "source": [
+ "import matplotlib.pyplot as plt\n",
+ "import numpy as np\n",
+ "import openimpala as oi\n",
+ "\n",
+ "plt.rcParams.update({\n",
+ " \"figure.dpi\": 120,\n",
+ " \"axes.spines.top\": False,\n",
+ " \"axes.spines.right\": False,\n",
+ " \"font.size\": 10,\n",
+ "})"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "05-rev-and-u-03",
+ "metadata": {},
+ "source": [
+ "## Multi-Scale Subvolume Sampling with `rev_study`\n",
+ "\n",
+ "`oi.rev_study()` draws random cubic subvolumes of edge lengths `sizes` from a parent volume, solves the periodic homogenisation cell problem in $(x, y, z)$ on every realisation, and aggregates directional means and standard deviations. Here we sample $N_s = 5$ realisations at each window size $L \\in \\{16, 24, 36, 48, 64\\}$ voxels across the $100^3$ dataset `oi.datasets.two_phase_stack()` ($h = 0.5\\;\\mu\\mathrm{m}$, $50\\;\\mu\\mathrm{m}$ cube):"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": 3,
+ "id": "05-rev-and-u-04",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2026-11-18T09:45:15.108125Z",
+ "iopub.status.busy": "2026-11-18T09:45:15.107897Z",
+ "iopub.status.idle": "2026-11-18T09:46:40.823986Z",
+ "shell.execute_reply": "2026-11-18T09:46:40.823617Z"
+ }
+ },
+ "outputs": [
+ {
+ "data": {
+ "text/html": [
+ "Window L Mean D_xx Mean D_yy Mean D_zz Mean ± SD (trace/3) 16 0.14990 0.13849 0.11782 0.13540 ± 0.04306 24 0.19976 0.19891 0.16474 0.18780 ± 0.04939 36 0.13647 0.13674 0.14701 0.14007 ± 0.02414 48 0.12502 0.11160 0.11626 0.11763 ± 0.00810 64 0.13051 0.12933 0.12883 0.12956 ± 0.00593
"
+ ],
+ "text/plain": [
+ "REVStudyResult(sizes=[16, 24, 36, 48, 64], samples=[{'sample': 1, 'seed_xyz': (7, 65, 55), 'target_size': 16, 'actual_size_xyz': (16, 16, 16), 'D_xx': 0.2230916048051344, 'D_yy': 0.19256097076182105, 'D_zz': 0.13609705752116472, 'D_xy': 0.005527355163582339, 'D_xz': 0.001871097381033712, 'D_yz': -0.03026016399004299, 'tensor': array([[ 0.2230916 , 0.00552736, 0.0018711 ],\n",
+ " [ 0.00552736, 0.19256097, -0.03026016],\n",
+ " [ 0.0018711 , -0.03026016, 0.13609706]])}, {'sample': 2, 'seed_xyz': (37, 36, 72), 'target_size': 16, 'actual_size_xyz': (16, 16, 16), 'D_xx': 0.11067661667282075, 'D_yy': 0.12583709352341943, 'D_zz': 0.10326057374854597, 'D_xy': 0.022086646131608312, 'D_xz': 0.015164568476918022, 'D_yz': -0.013217254688780995, 'tensor': array([[ 0.11067662, 0.02208665, 0.01516457],\n",
+ " [ 0.02208665, 0.12583709, -0.01321725],\n",
+ " [ 0.01516457, -0.01321725, 0.10326057]])}, {'sample': 3, 'seed_xyz': (7, 59, 17), 'target_size': 16, 'actual_size_xyz': (16, 16, 16), 'D_xx': 0.16705078257645256, 'D_yy': 0.10176698306295516, 'D_zz': 0.13783214946016326, 'D_xy': -0.00727959265281008, 'D_xz': -0.019111656908429614, 'D_yz': 0.018917332237575104, 'tensor': array([[ 0.16705078, -0.00727959, -0.01911166],\n",
+ " [-0.00727959, 0.10176698, 0.01891733],\n",
+ " [-0.01911166, 0.01891733, 0.13783215]])}, {'sample': 4, 'seed_xyz': (8, 44, 82), 'target_size': 16, 'actual_size_xyz': (16, 16, 16), 'D_xx': 0.04894590331723535, 'D_yy': 0.09462730826178216, 'D_zz': 0.07233525152682689, 'D_xy': -0.0033451350239455087, 'D_xz': 0.007640165910019923, 'D_yz': -0.014594427208232067, 'tensor': array([[ 0.0489459 , -0.00334514, 0.00764017],\n",
+ " [-0.00334514, 0.09462731, -0.01459443],\n",
+ " [ 0.00764017, -0.01459443, 0.07233525]])}, {'sample': 5, 'seed_xyz': (62, 64, 60), 'target_size': 16, 'actual_size_xyz': (16, 16, 16), 'D_xx': 0.1997163518723129, 'D_yy': 0.1776573762226478, 'D_zz': 0.1395700099759134, 'D_xy': 0.0034606465906930357, 'D_xz': 0.02849682154440672, 'D_yz': -0.002242662302658212, 'tensor': array([[ 0.19971635, 0.00346065, 0.02849682],\n",
+ " [ 0.00346065, 0.17765738, -0.00224266],\n",
+ " [ 0.02849682, -0.00224266, 0.13957001]])}, {'sample': 1, 'seed_xyz': (60, 39, 9), 'target_size': 24, 'actual_size_xyz': (24, 24, 24), 'D_xx': 0.28922762971058597, 'D_yy': 0.27479461498915714, 'D_zz': 0.27289710419101404, 'D_xy': -0.017750129395707717, 'D_xz': -0.01035108639853242, 'D_yz': -0.009556689065655299, 'tensor': array([[ 0.28922763, -0.01775013, -0.01035109],\n",
+ " [-0.01775013, 0.27479461, -0.00955669],\n",
+ " [-0.01035109, -0.00955669, 0.2728971 ]])}, {'sample': 2, 'seed_xyz': (64, 34, 38), 'target_size': 24, 'actual_size_xyz': (24, 24, 24), 'D_xx': 0.14299111338747614, 'D_yy': 0.147846228658548, 'D_zz': 0.13890698286849146, 'D_xy': 0.014679136699528313, 'D_xz': -0.012773840408866052, 'D_yz': -0.0019050987718681528, 'tensor': array([[ 0.14299111, 0.01467914, -0.01277384],\n",
+ " [ 0.01467914, 0.14784623, -0.0019051 ],\n",
+ " [-0.01277384, -0.0019051 , 0.13890698]])}, {'sample': 3, 'seed_xyz': (28, 14, 71), 'target_size': 24, 'actual_size_xyz': (24, 24, 24), 'D_xx': 0.1886703666486103, 'D_yy': 0.17967115829886643, 'D_zz': 0.14719069892186784, 'D_xy': 0.024541093009634404, 'D_xz': -0.007329607289687278, 'D_yz': 5.562760173598046e-06, 'tensor': array([[ 1.88670367e-01, 2.45410930e-02, -7.32960729e-03],\n",
+ " [ 2.45410930e-02, 1.79671158e-01, 5.56276017e-06],\n",
+ " [-7.32960727e-03, 5.56274003e-06, 1.47190699e-01]])}, {'sample': 4, 'seed_xyz': (60, 49, 30), 'target_size': 24, 'actual_size_xyz': (24, 24, 24), 'D_xx': 0.20820799347830263, 'D_yy': 0.21842352813163893, 'D_zz': 0.13088198815957708, 'D_xy': -0.0013938944088630982, 'D_xz': 0.0010286081358233238, 'D_yz': -0.006782937266103386, 'tensor': array([[ 0.20820799, -0.00139389, 0.00102861],\n",
+ " [-0.00139389, 0.21842353, -0.00678294],\n",
+ " [ 0.00102861, -0.00678294, 0.13088199]])}, {'sample': 5, 'seed_xyz': (63, 41, 34), 'target_size': 24, 'actual_size_xyz': (24, 24, 24), 'D_xx': 0.16970427292795806, 'D_yy': 0.17379192249180087, 'D_zz': 0.13380720893645107, 'D_xy': 0.013431454552453714, 'D_xz': -0.009638506405630607, 'D_yz': 0.0013247073714909765, 'tensor': array([[ 0.16970427, 0.01343145, -0.00963851],\n",
+ " [ 0.01343145, 0.17379192, 0.00132471],\n",
+ " [-0.00963851, 0.00132471, 0.13380721]])}, {'sample': 1, 'seed_xyz': (29, 14, 5), 'target_size': 36, 'actual_size_xyz': (36, 36, 36), 'D_xx': 0.10770251508097384, 'D_yy': 0.11572551839062527, 'D_zz': 0.12280413007552077, 'D_xy': -0.005929059498124448, 'D_xz': 0.008870983673081364, 'D_yz': 0.0006748072282039689, 'tensor': array([[ 0.10770252, -0.00592906, 0.00887098],\n",
+ " [-0.00592906, 0.11572552, 0.00067481],\n",
+ " [ 0.00887098, 0.00067481, 0.12280413]])}, {'sample': 2, 'seed_xyz': (36, 57, 4), 'target_size': 36, 'actual_size_xyz': (36, 36, 36), 'D_xx': 0.17011218135847717, 'D_yy': 0.1870153649932728, 'D_zz': 0.17790505535741213, 'D_xy': -0.014043568431901436, 'D_xz': -0.0015305273674802652, 'D_yz': 0.0026896234890195856, 'tensor': array([[ 0.17011218, -0.01404357, -0.00153053],\n",
+ " [-0.01404357, 0.18701536, 0.00268962],\n",
+ " [-0.00153053, 0.00268962, 0.17790506]])}, {'sample': 3, 'seed_xyz': (55, 53, 17), 'target_size': 36, 'actual_size_xyz': (36, 36, 36), 'D_xx': 0.12375018213279171, 'D_yy': 0.11934607683045893, 'D_zz': 0.1375672326654043, 'D_xy': -0.003294421877882829, 'D_xz': 0.0062667664608270085, 'D_yz': 0.0019700336525971442, 'tensor': array([[ 0.12375018, -0.00329442, 0.00626677],\n",
+ " [-0.00329442, 0.11934608, 0.00197003],\n",
+ " [ 0.00626677, 0.00197003, 0.13756723]])}, {'sample': 4, 'seed_xyz': (41, 10, 49), 'target_size': 36, 'actual_size_xyz': (36, 36, 36), 'D_xx': 0.13637645128143608, 'D_yy': 0.11709655696597614, 'D_zz': 0.12280673245888592, 'D_xy': 0.0026697710443178858, 'D_xz': 0.00170406250481552, 'D_yz': -0.013035409291780615, 'tensor': array([[ 0.13637645, 0.00266977, 0.00170406],\n",
+ " [ 0.00266977, 0.11709656, -0.01303541],\n",
+ " [ 0.00170406, -0.01303541, 0.12280673]])}, {'sample': 5, 'seed_xyz': (45, 23, 4), 'target_size': 36, 'actual_size_xyz': (36, 36, 36), 'D_xx': 0.14439386342579955, 'D_yy': 0.14450994526318847, 'D_zz': 0.173991841694531, 'D_xy': -0.017183232802958495, 'D_xz': 0.0006993247355937845, 'D_yz': -0.0020536946021581714, 'tensor': array([[ 0.14439386, -0.01718323, 0.00069932],\n",
+ " [-0.01718323, 0.14450995, -0.00205369],\n",
+ " [ 0.00069932, -0.00205369, 0.17399184]])}, {'sample': 1, 'seed_xyz': (51, 23, 47), 'target_size': 48, 'actual_size_xyz': (48, 48, 48), 'D_xx': 0.12825799048233738, 'D_yy': 0.10749697565114776, 'D_zz': 0.11425124718110313, 'D_xy': 0.003985343015156264, 'D_xz': -0.007829237944137193, 'D_yz': 0.00045333700025403925, 'tensor': array([[ 0.12825799, 0.00398534, -0.00782924],\n",
+ " [ 0.00398534, 0.10749698, 0.00045334],\n",
+ " [-0.00782924, 0.00045334, 0.11425125]])}, {'sample': 2, 'seed_xyz': (35, 41, 40), 'target_size': 48, 'actual_size_xyz': (48, 48, 48), 'D_xx': 0.11123568717357282, 'D_yy': 0.1141493276449976, 'D_zz': 0.12235397940198205, 'D_xy': -0.00027761420421156365, 'D_xz': -0.010792290853621067, 'D_yz': 0.0012315942049355392, 'tensor': array([[ 0.11123569, -0.00027761, -0.01079229],\n",
+ " [-0.00027761, 0.11414933, 0.00123159],\n",
+ " [-0.01079229, 0.00123159, 0.12235398]])}, {'sample': 3, 'seed_xyz': (10, 19, 24), 'target_size': 48, 'actual_size_xyz': (48, 48, 48), 'D_xx': 0.11395944360006147, 'D_yy': 0.10646416489545261, 'D_zz': 0.10140870014811088, 'D_xy': 0.0029189360932658447, 'D_xz': -0.004577703851375702, 'D_yz': -0.009330001046104423, 'tensor': array([[ 0.11395944, 0.00291894, -0.0045777 ],\n",
+ " [ 0.00291894, 0.10646416, -0.00933 ],\n",
+ " [-0.0045777 , -0.00933 , 0.1014087 ]])}, {'sample': 4, 'seed_xyz': (26, 2, 28), 'target_size': 48, 'actual_size_xyz': (48, 48, 48), 'D_xx': 0.12983873719500771, 'D_yy': 0.11979280484428319, 'D_zz': 0.12457759181134102, 'D_xy': 0.002855129148454056, 'D_xz': 0.0037709927567522766, 'D_yz': -0.009493335178183586, 'tensor': array([[ 0.12983874, 0.00285513, 0.00377099],\n",
+ " [ 0.00285513, 0.1197928 , -0.00949334],\n",
+ " [ 0.00377099, -0.00949334, 0.12457759]])}, {'sample': 5, 'seed_xyz': (8, 39, 36), 'target_size': 48, 'actual_size_xyz': (48, 48, 48), 'D_xx': 0.14179314288793513, 'D_yy': 0.11010663100537729, 'D_zz': 0.11871366267695685, 'D_xy': 0.004041206348691333, 'D_xz': -0.007308894293749962, 'D_yz': -0.0105944747386914, 'tensor': array([[ 0.14179314, 0.00404121, -0.00730889],\n",
+ " [ 0.00404121, 0.11010663, -0.01059447],\n",
+ " [-0.00730889, -0.01059447, 0.11871366]])}, {'sample': 1, 'seed_xyz': (34, 27, 13), 'target_size': 64, 'actual_size_xyz': (64, 64, 64), 'D_xx': 0.13171098903031309, 'D_yy': 0.12599438110237643, 'D_zz': 0.12664494644949276, 'D_xy': -0.005326768706209045, 'D_xz': -0.003199711191228441, 'D_yz': -0.0025313173071756616, 'tensor': array([[ 0.13171099, -0.00532677, -0.00319971],\n",
+ " [-0.00532677, 0.12599438, -0.00253132],\n",
+ " [-0.00319971, -0.00253132, 0.12664495]])}, {'sample': 2, 'seed_xyz': (35, 15, 12), 'target_size': 64, 'actual_size_xyz': (64, 64, 64), 'D_xx': 0.1347161309144364, 'D_yy': 0.13550643975748577, 'D_zz': 0.13598416969607213, 'D_xy': -0.001116468868162701, 'D_xz': -0.005485513550246785, 'D_yz': -0.001998280540014404, 'tensor': array([[ 0.13471613, -0.00111647, -0.00548551],\n",
+ " [-0.00111647, 0.13550644, -0.00199828],\n",
+ " [-0.00548551, -0.00199828, 0.13598417]])}, {'sample': 3, 'seed_xyz': (33, 13, 2), 'target_size': 64, 'actual_size_xyz': (64, 64, 64), 'D_xx': 0.13748566449750604, 'D_yy': 0.13623258141582084, 'D_zz': 0.1340273923773137, 'D_xy': -0.0018495640209770972, 'D_xz': -0.005619868545776433, 'D_yz': -0.003677955538809937, 'tensor': array([[ 0.13748566, -0.00184956, -0.00561987],\n",
+ " [-0.00184956, 0.13623258, -0.00367796],\n",
+ " [-0.00561987, -0.00367796, 0.13402739]])}, {'sample': 4, 'seed_xyz': (17, 29, 7), 'target_size': 64, 'actual_size_xyz': (64, 64, 64), 'D_xx': 0.12301172732342336, 'D_yy': 0.1303101748025831, 'D_zz': 0.12794578672942813, 'D_xy': -0.004710197975548135, 'D_xz': -0.001311697050597375, 'D_yz': -0.007841340738458942, 'tensor': array([[ 0.12301173, -0.0047102 , -0.0013117 ],\n",
+ " [-0.0047102 , 0.13031017, -0.00784134],\n",
+ " [-0.0013117 , -0.00784134, 0.12794579]])}, {'sample': 5, 'seed_xyz': (17, 4, 25), 'target_size': 64, 'actual_size_xyz': (64, 64, 64), 'D_xx': 0.125648501121696, 'D_yy': 0.11858900164497654, 'D_zz': 0.11957006338590613, 'D_xy': 0.004267051256278746, 'D_xz': 0.00219187630668281, 'D_yz': -0.01166337347454615, 'tensor': array([[ 0.1256485 , 0.00426705, 0.00219188],\n",
+ " [ 0.00426705, 0.118589 , -0.01166337],\n",
+ " [ 0.00219188, -0.01166337, 0.11957006]])}], mean_diagonal={16: array([0.14989625, 0.13848995, 0.11781901]), 24: array([0.19976028, 0.19890549, 0.1647368 ]), 36: array([0.13646704, 0.13673869, 0.147015 ]), 48: array([0.125017 , 0.11160198, 0.11626104]), 64: array([0.1305146 , 0.12932652, 0.12883447])}, std_diagonal={16: array([0.06302862, 0.03972497, 0.02641378]), 24: array([0.04964848, 0.04415385, 0.05436264]), 36: array([0.02089954, 0.02726905, 0.02426278]), 48: array([0.01120166, 0.00487981, 0.00820897]), 64: array([0.00543419, 0.0065307 , 0.00582233])}, csv_path=None)"
+ ]
+ },
+ "execution_count": 3,
+ "metadata": {},
+ "output_type": "execute_result"
+ }
+ ],
+ "source": [
+ "stack = oi.datasets.two_phase_stack()\n",
+ "h_um = 0.5\n",
+ "window_vox = [16, 24, 36, 48, 64]\n",
+ "\n",
+ "rev = oi.rev_study(stack, sizes=window_vox, num_samples=5, phase=1)\n",
+ "rev"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "05-rev-and-u-05",
+ "metadata": {},
+ "source": [
+ "## Nonparametric Bootstrap Confidence Intervals and CV Decay\n",
+ "\n",
+ "Each sample record in `rev.samples` stores `target_size`, seed coordinates, and the full $3\\times 3$ `tensor`. From these realisations we compute nonparametric percentile bootstrap 95% confidence intervals on $\\mu_{D_{zz}}(L)$ and evaluate $\\mathrm{CV}_i(L)$ along all three Cartesian directions:"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": 4,
+ "id": "05-rev-and-u-06",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2026-11-18T09:46:40.827821Z",
+ "iopub.status.busy": "2026-11-18T09:46:40.827553Z",
+ "iopub.status.idle": "2026-11-18T09:46:40.836592Z",
+ "shell.execute_reply": "2026-11-18T09:46:40.835830Z"
+ }
+ },
+ "outputs": [
+ {
+ "name": "stdout",
+ "output_type": "stream",
+ "text": [
+ "L = 8.0 um (16^3): mean diag = [0.1499 0.1385 0.1178], CV(%) = [42. 28.7 22.4]\n",
+ "L = 12.0 um (24^3): mean diag = [0.1998 0.1989 0.1647], CV(%) = [24.9 22.2 33. ]\n",
+ "L = 18.0 um (36^3): mean diag = [0.1365 0.1367 0.147 ], CV(%) = [15.3 19.9 16.5]\n",
+ "L = 24.0 um (48^3): mean diag = [0.125 0.1116 0.1163], CV(%) = [9. 4.4 7.1]\n",
+ "L = 32.0 um (64^3): mean diag = [0.1305 0.1293 0.1288], CV(%) = [4.2 5. 4.5]\n"
+ ]
+ }
+ ],
+ "source": [
+ "rng = np.random.default_rng(2026)\n",
+ "window_um = np.array(window_vox, dtype=float) * h_um\n",
+ "\n",
+ "dzz_samples = {\n",
+ " sz: np.array([s[\"D_zz\"] for s in rev.samples if s[\"target_size\"] == sz])\n",
+ " for sz in window_vox\n",
+ "}\n",
+ "\n",
+ "ci_lo, ci_hi = [], []\n",
+ "for sz in window_vox:\n",
+ " vals = dzz_samples[sz]\n",
+ " boots = rng.choice(vals, size=(2000, len(vals)), replace=True).mean(axis=1)\n",
+ " lo, hi = np.percentile(boots, [2.5, 97.5])\n",
+ " ci_lo.append(lo)\n",
+ " ci_hi.append(hi)\n",
+ "\n",
+ "for sz in window_vox:\n",
+ " m = rev.mean_diagonal[sz]\n",
+ " cv = 100.0 * rev.std_diagonal[sz] / m\n",
+ " print(f\"L = {sz * h_um:4.1f} um ({sz:2d}^3): mean diag = {np.round(m, 4)}, CV(%) = {np.round(cv, 1)}\")"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": 5,
+ "id": "05-rev-and-u-07",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2026-11-18T09:46:40.837911Z",
+ "iopub.status.busy": "2026-11-18T09:46:40.837767Z",
+ "iopub.status.idle": "2026-11-18T09:46:41.283313Z",
+ "shell.execute_reply": "2026-11-18T09:46:41.281545Z"
+ }
+ },
+ "outputs": [
+ {
+ "data": {
+ "image/png": "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",
+ "text/plain": [
+ ""
+ ]
+ },
+ "metadata": {},
+ "output_type": "display_data"
+ }
+ ],
+ "source": [
+ "fig, axes = plt.subplots(1, 2, figsize=(10.5, 3.8), constrained_layout=True)\n",
+ "\n",
+ "for sz in window_vox:\n",
+ " x_um = sz * h_um\n",
+ " vals = dzz_samples[sz]\n",
+ " axes[0].scatter(\n",
+ " np.full_like(vals, x_um), vals, color=\"#2b5c8f\", alpha=0.35, s=24, zorder=2\n",
+ " )\n",
+ "\n",
+ "colors = {\"x\": \"#7570b3\", \"y\": \"#d95f02\", \"z\": \"#2b5c8f\"}\n",
+ "for idx, axis in enumerate((\"x\", \"y\", \"z\")):\n",
+ " means = [rev.mean_diagonal[sz][idx] for sz in window_vox]\n",
+ " axes[0].plot(\n",
+ " window_um,\n",
+ " means,\n",
+ " \"o-\",\n",
+ " color=colors[axis],\n",
+ " lw=1.6,\n",
+ " ms=4.5,\n",
+ " label=rf\"$\\langle D_{{{axis}{axis}}}\\rangle$\",\n",
+ " )\n",
+ "\n",
+ "axes[0].fill_between(\n",
+ " window_um, ci_lo, ci_hi, color=\"#2b5c8f\", alpha=0.16, label=r\"95% bootstrap CI ($D_{zz}$)\"\n",
+ ")\n",
+ "axes[0].set_xlabel(r\"Subvolume edge length $L\\;[\\mu\\mathrm{m}]$\")\n",
+ "axes[0].set_ylabel(r\"Normalised effective diffusivity $D_{\\mathrm{eff}} / D_0$\")\n",
+ "axes[0].set_title(r\"Scale convergence of $\\mathbf{D}_{\\mathrm{eff}}(L)$\")\n",
+ "axes[0].legend(frameon=False, fontsize=8.5, ncol=2)\n",
+ "\n",
+ "for idx, axis in enumerate((\"x\", \"y\", \"z\")):\n",
+ " cvs = [100.0 * rev.std_diagonal[sz][idx] / rev.mean_diagonal[sz][idx] for sz in window_vox]\n",
+ " axes[1].plot(\n",
+ " window_um,\n",
+ " cvs,\n",
+ " \"s-\",\n",
+ " color=colors[axis],\n",
+ " lw=1.6,\n",
+ " ms=4.5,\n",
+ " label=rf\"$\\mathrm{{CV}}_{axis}$\",\n",
+ " )\n",
+ "\n",
+ "axes[1].axhline(5.0, color=\"#333333\", ls=\"--\", lw=1.1, label=\"5% REV threshold\")\n",
+ "axes[1].set_xlabel(r\"Subvolume edge length $L\\;[\\mu\\mathrm{m}]$\")\n",
+ "axes[1].set_ylabel(r\"Coefficient of variation $\\mathrm{CV}(L)\\;[\\%]$\")\n",
+ "axes[1].set_title(\"Dispersion decay across window sizes\")\n",
+ "axes[1].legend(frameon=False, fontsize=9)\n",
+ "\n",
+ "plt.show()"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "05-rev-and-u-08",
+ "metadata": {},
+ "source": [
+ "Above $L = 32\\;\\mu\\mathrm{m}$ ($64^3$ voxels), all three directional coefficients of variation reach $\\le 5\\%$ and the three diagonal components agree within $0.002$, confirming statistical isotropy and REV convergence for this microstructure.\n",
+ "\n",
+ "## References\n",
+ "\n",
+ "1. J. Bear, *Dynamics of Fluids in Porous Media*, Elsevier (1972).\n",
+ "2. T. Kanit, S. Forest, I. Galliet, V. Mounoury, and D. Jeulin, *Determination of the size of the representative volume element for random composites: statistical and numerical approach*, Int. J. Solids Struct. **40**(13–14), 3647–3679 (2003).\n",
+ "3. J. Le Houx, M. Osenberg, I. Manke, and D. Kramer, *Statistical estimation of effective diffusivity in porous media*, Transp. Porous Media **150**, 71–88 (2023)."
+ ]
+ }
+ ],
+ "metadata": {
+ "kernelspec": {
+ "display_name": "Python 3",
+ "language": "python",
+ "name": "python3"
+ },
+ "language_info": {
+ "codemirror_mode": {
+ "name": "ipython",
+ "version": 3
+ },
+ "file_extension": ".py",
+ "mimetype": "text/x-python",
+ "name": "python",
+ "nbconvert_exporter": "python",
+ "pygments_lexer": "ipython3",
+ "version": "3.11.2"
+ }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}
diff --git a/tutorials/05_surrogate_modelling.ipynb b/tutorials/05_surrogate_modelling.ipynb
deleted file mode 100644
index 1d0bae53..00000000
--- a/tutorials/05_surrogate_modelling.ipynb
+++ /dev/null
@@ -1,140 +0,0 @@
-{
- "cells": [
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": " \n\n# Tutorial 5 of 7: Surrogate Modelling with OpenImpala-Generated Data\n\n*OpenImpala Tutorial Series — From first solve to HPC deployment*\n\n---\n\nA surrogate model approximates an expensive computation — in our case, a 3D PDE solve — with a fast statistical or machine learning model trained on labelled examples. The bottleneck is always the labelled data: you need many (structure, property) pairs, each requiring a full physics solve.\n\n**This is where OpenImpala's HPC capabilities become a decisive advantage.** Because OpenImpala scales across hundreds of MPI ranks (see [Tutorial 7](07_hpc_scaling.ipynb)), you can generate labelled datasets that would be infeasible with serial solvers:\n\n| Campaign size | Serial solver (1 core) | OpenImpala (128 cores) |\n|--------------|----------------------|----------------------|\n| 200 samples @ $32^3$ | ~30 min | ~15 sec |\n| 2,000 samples @ $64^3$ | ~days | ~1 hour |\n| 10,000 samples @ $128^3$ | infeasible | overnight batch job |\n\nThe ML model itself (Random Forest, neural network, etc.) is generic — any solver could provide the labels. **OpenImpala's USP is the throughput**: the ability to churn through thousands of full 3D PDE solves fast enough to make large surrogate campaigns practical. On a cluster, you can parallelise both across samples (trivially, via job arrays) and within each sample (via MPI domain decomposition).\n\nThis tutorial demonstrates the workflow at small scale (200 samples on $32^3$ grids, runnable on Colab). The same script scales to production campaigns by increasing `N_SAMPLES`, `SIZE`, and launching with `mpirun`.\n\n**What you will learn:**\n1. Generate randomised microstructures with PoreSpy and label them with OpenImpala.\n2. Explore the structure-property relationships in the dataset.\n3. Train a Random Forest regressor and evaluate it on held-out data.\n4. Use feature importance to identify which geometric descriptors control tortuosity.\n\n**Prerequisites:** [Tutorial 1](01_hello_openimpala.ipynb) for the OpenImpala API. [Tutorial 3](03_rev_and_uncertainty.ipynb) motivates the sampling strategy. Basic familiarity with scikit-learn is helpful."
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": "# Install OpenImpala and ML libraries\n!pip install -q openimpala porespy scikit-learn matplotlib"
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": "import time\nimport numpy as np\nimport matplotlib.pyplot as plt\nimport porespy as ps\nfrom scipy import ndimage\nfrom sklearn.ensemble import RandomForestRegressor\nfrom sklearn.model_selection import train_test_split\nfrom sklearn.metrics import r2_score, mean_absolute_error\nimport openimpala as oi\n\nprint(f\"OpenImpala version {oi.__version__} loaded.\")\n\n# Dataset parameters. 200 samples on 32^3 grids runs in a few minutes\n# on Colab. For a production surrogate, increase both.\nN_SAMPLES = 200\nSIZE = 32\nnp.random.seed(42)"
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": "## 1. Generating the Labelled Dataset\n\nFor each sample we:\n1. Generate a random structure with PoreSpy (`blobs`), varying both the target porosity and the characteristic feature size (`blobiness`).\n2. Compute three morphological features that are easy to measure on any segmented image:\n - **Porosity** ($\\varepsilon$) — volume fraction of the pore phase.\n - **Specific surface area** ($S_v$) — interfacial area per unit volume (units: 1/voxel).\n - **Hydraulic diameter estimate** ($d_h = 4\\varepsilon / S_v$) — a classical proxy for mean pore size. It introduces a nonlinear combination of $\\varepsilon$ and $S_v$ that captures how \"open\" the pore space is.\n3. Use OpenImpala to check percolation and, if the phase is connected, solve for the ground-truth tortuosity."
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": "print(\"Step 1: Generating labelled data with OpenImpala...\")\n\nfeature_names = [\"Porosity\", \"Surface Area\", \"Hydraulic Diameter\"]\nX_features = []\ny_target = []\nn_no_percolation = 0\n\nt_start = time.time()\n\nwith oi.Session():\n for i in range(N_SAMPLES):\n # Vary both porosity and feature size\n target_porosity = np.random.uniform(0.25, 0.75)\n blobiness = np.random.uniform(0.8, 3.0)\n micro = ps.generators.blobs(\n shape=[SIZE, SIZE, SIZE],\n porosity=target_porosity,\n blobiness=blobiness,\n ).astype(np.int32)\n\n # Morphological features\n porosity = oi.volume_fraction(micro, phase=1).fraction\n surface_area = ps.metrics.specific_surface_area(micro)\n hydraulic_diam = 4.0 * porosity / surface_area if surface_area > 0 else 0.0\n\n # Ground-truth tortuosity\n perc = oi.percolation_check(micro, phase=1, direction=\"z\")\n if perc.percolates:\n tau = oi.tortuosity(micro, phase=1, direction=\"z\", solver=\"mlmg\").tortuosity\n X_features.append([porosity, surface_area, hydraulic_diam])\n y_target.append(tau)\n else:\n n_no_percolation += 1\n\n if (i + 1) % 50 == 0:\n print(f\" {i+1}/{N_SAMPLES} structures processed...\")\n\nX_features = np.array(X_features)\ny_target = np.array(y_target)\n\nt_data = time.time() - t_start\nprint(f\"\\nGenerated {len(y_target)} valid samples in {t_data:.1f}s \"\n f\"({n_no_percolation} structures did not percolate).\")"
- },
- {
- "cell_type": "markdown",
- "source": "## 2. Exploring the Dataset\n\nBefore training a model, it is worth looking at the data. The scatter plots below show how each morphological feature relates to the ground-truth tortuosity. This helps us understand what the model will have to work with and whether the features carry useful information.",
- "metadata": {}
- },
- {
- "cell_type": "code",
- "source": "fig, axes = plt.subplots(1, 3, figsize=(14, 4), dpi=120)\ncolors = ['#1f77b4', '#ff7f0e', '#2ca02c']\n\nfor ax, col, name, c in zip(axes, range(3), feature_names, colors):\n ax.scatter(X_features[:, col], y_target, s=15, alpha=0.6, color=c, edgecolor='none')\n ax.set_xlabel(name)\n ax.set_ylabel(r\"Tortuosity ($\\tau$)\")\n ax.grid(True, alpha=0.3)\n ax.spines['top'].set_visible(False)\n ax.spines['right'].set_visible(False)\n\n # Pearson correlation\n corr = np.corrcoef(X_features[:, col], y_target)[0, 1]\n ax.set_title(f\"{name} (r = {corr:.2f})\")\n\nplt.suptitle(f\"Feature–Tortuosity Relationships (N = {len(y_target)})\", fontweight='bold', y=1.02)\nplt.tight_layout()\nplt.show()",
- "metadata": {},
- "execution_count": null,
- "outputs": []
- },
- {
- "cell_type": "markdown",
- "source": "## 3. Training and Evaluating the Surrogate\n\nWe hold out 20% of the data for testing. A Random Forest with 100 trees is a reasonable default — it handles nonlinear relationships, requires minimal tuning, and provides built-in feature importance estimates.",
- "metadata": {}
- },
- {
- "cell_type": "code",
- "source": "X_train, X_test, y_train, y_test = train_test_split(\n X_features, y_target, test_size=0.2, random_state=42\n)\n\nmodel = RandomForestRegressor(n_estimators=100, random_state=42)\nmodel.fit(X_train, y_train)\n\ny_pred = model.predict(X_test)\nr2 = r2_score(y_test, y_pred)\nmae = mean_absolute_error(y_test, y_pred)\n\nprint(f\"Test set size: {len(y_test)} samples\")\nprint(f\"R² score: {r2:.3f}\")\nprint(f\"MAE: {mae:.4f}\")\n\n# --- Evaluation plots ---\nfig, (ax1, ax2) = plt.subplots(1, 2, figsize=(12, 5), dpi=120)\n\n# Left: True vs. Predicted\nax1.scatter(y_test, y_pred, color='#1f77b4', s=40, alpha=0.7, edgecolor='black', linewidth=0.5)\nlims = [min(y_test.min(), y_pred.min()) * 0.95, max(y_test.max(), y_pred.max()) * 1.05]\nax1.plot(lims, lims, 'r--', lw=2, label=\"Perfect prediction\")\nax1.set_xlim(lims)\nax1.set_ylim(lims)\nax1.set_xlabel(\"True Tortuosity (OpenImpala)\")\nax1.set_ylabel(\"Predicted Tortuosity (Random Forest)\")\nax1.set_title(f\"True vs. Predicted (R² = {r2:.2f})\")\nax1.set_aspect('equal')\nax1.legend()\nax1.grid(True, alpha=0.3)\nax1.spines['top'].set_visible(False)\nax1.spines['right'].set_visible(False)\n\n# Right: Residuals\nresiduals = y_test - y_pred\nax2.scatter(y_test, residuals, color='#ff7f0e', s=40, alpha=0.7, edgecolor='black', linewidth=0.5)\nax2.axhline(0, color='r', linestyle='--', lw=2)\nax2.set_xlabel(\"True Tortuosity\")\nax2.set_ylabel(\"Residual (True - Predicted)\")\nax2.set_title(f\"Residuals (MAE = {mae:.3f})\")\nax2.grid(True, alpha=0.3)\nax2.spines['top'].set_visible(False)\nax2.spines['right'].set_visible(False)\n\nplt.tight_layout()\nplt.show()",
- "metadata": {},
- "execution_count": null,
- "outputs": []
- },
- {
- "cell_type": "markdown",
- "source": "## 4. Feature Importance\n\nRandom Forest models provide a built-in measure of feature importance (mean decrease in impurity). This tells us which geometric descriptors the model relied on most heavily when predicting tortuosity. For a materials scientist, this is arguably the most interesting output: it quantifies which aspects of the microstructure actually control transport.",
- "metadata": {}
- },
- {
- "cell_type": "code",
- "source": "importances = model.feature_importances_\nsorted_idx = np.argsort(importances)\n\nfig, ax = plt.subplots(figsize=(7, 3.5), dpi=120)\nax.barh(\n [feature_names[i] for i in sorted_idx],\n importances[sorted_idx],\n color=['#1f77b4', '#ff7f0e', '#2ca02c'],\n edgecolor='black', linewidth=0.5,\n)\nax.set_xlabel(\"Feature Importance (mean decrease in impurity)\")\nax.set_title(\"What Controls Tortuosity?\")\nax.spines['top'].set_visible(False)\nax.spines['right'].set_visible(False)\nplt.tight_layout()\nplt.show()\n\n# Print the values\nfor i in sorted_idx[::-1]:\n print(f\" {feature_names[i]:22s} {importances[i]:.3f}\")",
- "metadata": {},
- "execution_count": null,
- "outputs": []
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "## Scaling Up: From Colab to HPC\n",
- "\n",
- "This tutorial ran 200 samples on $32^3$ grids — a toy dataset to demonstrate the workflow. For a production surrogate, you need larger datasets on larger domains. This is where OpenImpala's exascale architecture pays off.\n",
- "\n",
- "### Parallelisation Strategy\n",
- "\n",
- "There are two levels of parallelism you can exploit:\n",
- "\n",
- "1. **Within each sample** — `mpirun -np 32 python label_one_sample.py` uses 32 cores to solve one structure faster. Essential for large domains ($128^3$+).\n",
- "2. **Across samples** — SLURM job arrays run many independent solves simultaneously. This is embarrassingly parallel and scales linearly with cluster size.\n",
- "\n",
- "```bash\n",
- "#!/bin/bash\n",
- "#SBATCH --job-name=surrogate_campaign\n",
- "#SBATCH --array=0-999 # 1000 independent samples\n",
- "#SBATCH --ntasks-per-node=16\n",
- "#SBATCH --time=00:30:00\n",
- "\n",
- "# Each array task generates and solves one structure\n",
- "mpirun -np $SLURM_NTASKS python generate_and_label.py \\\n",
- " --sample-id $SLURM_ARRAY_TASK_ID \\\n",
- " --size 128 \\\n",
- " --output-dir ./dataset/\n",
- "```\n",
- "\n",
- "With 1000 array tasks on a 64-node cluster, you can label 1000 structures at $128^3$ resolution in a single batch submission — a dataset that would take weeks with a serial solver.\n",
- "\n",
- "### What to do with a bigger dataset\n",
- "\n",
- "- **Increase sample count** (500-5000+) for better generalisation.\n",
- "- **Use richer features** — two-point correlation functions, chord-length distributions, Minkowski functionals, or learned CNN embeddings capture geometry more completely than porosity and surface area alone.\n",
- "- **Use larger domains** ($64^3$-$128^3$) to reduce finite-size noise (see [Tutorial 3](03_rev_and_uncertainty.ipynb) on REV).\n",
- "- **Train on the full D_eff tensor** — OpenImpala can solve all three directions, giving you $D_{xx}$, $D_{yy}$, $D_{zz}$ per sample for anisotropy-aware surrogates.\n",
- "\n",
- "**Continue the series:**\n",
- "- [Tutorial 6: Topology Optimisation](06_topology_optimisation.ipynb) — Put OpenImpala inside a design loop to optimise microstructure geometry.\n",
- "- [Tutorial 7: Scaling to HPC](07_hpc_scaling.ipynb) — Run production-scale campaigns on a cluster with MPI.\n",
- "\n",
- "---\n",
- "\n",
- "## References & Further Reading\n",
- "\n",
- "1. **OpenImpala:** J. Le Houx & D. Kramer, *OpenImpala: OPEN source IMage based PArallisable Linear Algebra solver*, SoftwareX 15, 100729 (2021). [doi:10.1016/j.softx.2021.100729](https://doi.org/10.1016/j.softx.2021.100729)\n",
- "2. **Surrogate models for porous media:** S. Kench & S. J. Cooper, *Generating three-dimensional structures from a two-dimensional slice with generative adversarial network-based dimensionality reduction*, Nature Machine Intelligence 3, 299-305 (2021). [doi:10.1038/s42256-021-00322-1](https://doi.org/10.1038/s42256-021-00322-1)\n",
- "3. **ML for structure-property linkages:** R. Cang et al., *Microstructure representation and reconstruction of heterogeneous materials via deep belief network for computational material design*, J. Mech. Design 139(7), 071404 (2017). [doi:10.1115/1.4036649](https://doi.org/10.1115/1.4036649)\n",
- "4. **Random Forests:** L. Breiman, *Random Forests*, Machine Learning 45(1), 5-32 (2001). [doi:10.1023/A:1010933404324](https://doi.org/10.1023/A:1010933404324)\n",
- "5. **PoreSpy morphological descriptors:** J. T. Gostick et al., *PoreSpy: A Python toolkit for quantitative analysis of porous media images*, J. Open Source Software 4(37), 1296 (2019). [doi:10.21105/joss.01296](https://doi.org/10.21105/joss.01296)\n",
- "6. **Feature importance interpretation:** C. Molnar, *Interpretable Machine Learning*, 2nd ed. (2022). Available at [christophm.github.io/interpretable-ml-book](https://christophm.github.io/interpretable-ml-book/)"
- ]
- }
- ],
- "metadata": {
- "kernelspec": {
- "display_name": "Python 3",
- "language": "python",
- "name": "python3"
- },
- "language_info": {
- "name": "python",
- "version": "3.10.0"
- }
- },
- "nbformat": 4,
- "nbformat_minor": 4
-}
diff --git a/tutorials/06_topology_optimisation.ipynb b/tutorials/06_topology_optimisation.ipynb
deleted file mode 100644
index b89455e4..00000000
--- a/tutorials/06_topology_optimisation.ipynb
+++ /dev/null
@@ -1,136 +0,0 @@
-{
- "cells": [
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": " \n\n# Tutorial 6 of 7: Topology Optimisation\n\n*OpenImpala Tutorial Series — From first solve to HPC deployment*\n\n---\n\nCan we rearrange voxels to minimise tortuosity at a fixed porosity? This tutorial uses OpenImpala as the cost-function evaluator inside two different optimisation strategies and compares their results.\n\n**Why OpenImpala for optimisation?** Each iteration requires a full 3D PDE solve to evaluate the objective function. A typical optimisation campaign needs hundreds to thousands of evaluations. With a serial solver, this is painfully slow — a 100-iteration loop on a $64^3$ grid might take hours. OpenImpala's MPI-parallel solver makes each evaluation fast enough that meaningful optimisation becomes practical:\n\n| Grid size | Evaluations | Serial solver | OpenImpala (32 cores) |\n|-----------|------------|--------------|----------------------|\n| $24^3$ | 100 | ~10 min | ~30 sec |\n| $64^3$ | 500 | ~12 hours | ~20 min |\n| $128^3$ | 1000 | days | ~3 hours |\n\nOn HPC, you can also run **population-based** optimisers (genetic algorithms, particle swarm) where each member of the population is evaluated independently — scaling linearly with cluster size via job arrays or MPI task farming.\n\nBoth algorithms below use the same mutation operator — swap a random solid voxel with a random pore voxel, so porosity stays exactly fixed — but differ in their acceptance rule:\n\n- **Greedy hill-climbing**: accept a swap only if it improves (lowers) the tortuosity. Simple, but gets trapped in local optima.\n- **Simulated annealing (SA)**: sometimes accept worsening swaps early on (controlled by a \"temperature\" that cools over time), allowing the search to escape local optima before converging.\n\nBy running both on the same starting structure, we can see the practical difference.\n\n**What you will learn:**\n1. Use OpenImpala as a physics evaluator inside an optimisation loop.\n2. Implement greedy and simulated annealing acceptance rules.\n3. Compare convergence behaviour and final structures.\n4. Analyse what the optimiser found relative to the theoretical bound.\n\n**Prerequisites:** [Tutorial 1](01_hello_openimpala.ipynb) for the core API. [Tutorial 5](05_surrogate_modelling.ipynb) introduced the idea of using OpenImpala in automated pipelines — here we close the loop with an optimiser."
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": "!pip install -q openimpala matplotlib"
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": "import time\nimport numpy as np\nimport matplotlib.pyplot as plt\nimport openimpala as oi\n\nprint(f\"OpenImpala version {oi.__version__} loaded.\")\n\nSIZE = 24 # Domain side length (24^3 = 13,824 voxels)\nN_ITERATIONS = 100 # Swap attempts per algorithm run\nPOROSITY = 0.50 # Fixed porosity for all experiments\n\nnp.random.seed(42)\ninitial_micro = np.random.choice([0, 1], size=(SIZE, SIZE, SIZE), p=[1-POROSITY, POROSITY]).astype(np.int32)\nprint(f\"Initial structure: {SIZE}^3, porosity = {initial_micro.mean():.4f}\")"
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": "def propose_swap(micro):\n \"\"\"Pick one random pore voxel and one random solid voxel.\"\"\"\n pore_coords = np.argwhere(micro == 1)\n solid_coords = np.argwhere(micro == 0)\n p = pore_coords[np.random.choice(len(pore_coords))]\n s = solid_coords[np.random.choice(len(solid_coords))]\n return tuple(p), tuple(s)\n\n\ndef run_optimisation(micro_start, n_iter, method=\"greedy\", T_init=0.15, cooling=0.97):\n \"\"\"Run optimisation and return (final_micro, tau_history, best_history, n_accepted).\n\n method: \"greedy\" or \"sa\" (simulated annealing).\n \"\"\"\n micro = micro_start.copy()\n best_micro = micro.copy()\n\n # Evaluate starting point\n perc = oi.percolation_check(micro, phase=1, direction=\"z\")\n current_tau = oi.tortuosity(micro, phase=1, direction=\"z\", solver=\"mlmg\").tortuosity if perc.percolates else np.inf\n best_tau = current_tau\n\n tau_history = [current_tau] # tracks current state (SA may go up)\n best_history = [best_tau] # tracks best-so-far\n T = T_init\n accepted = 0\n\n for i in range(n_iter):\n p_idx, s_idx = propose_swap(micro)\n\n # Apply swap\n micro[p_idx] = 0\n micro[s_idx] = 1\n\n # Evaluate\n perc = oi.percolation_check(micro, phase=1, direction=\"z\")\n new_tau = oi.tortuosity(micro, phase=1, direction=\"z\", solver=\"mlmg\").tortuosity if perc.percolates else np.inf\n\n # Acceptance rule\n delta = new_tau - current_tau\n if method == \"greedy\":\n accept = delta < 0\n else: # simulated annealing\n accept = delta < 0 or (T > 0 and np.random.random() < np.exp(-delta / T))\n T *= cooling\n\n if accept:\n current_tau = new_tau\n accepted += 1\n if new_tau < best_tau:\n best_tau = new_tau\n best_micro = micro.copy()\n else:\n # Revert\n micro[p_idx] = 1\n micro[s_idx] = 0\n\n tau_history.append(current_tau)\n best_history.append(best_tau)\n\n return best_micro, tau_history, best_history, accepted"
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": "print(\"Running both optimisation strategies on the same starting structure...\\n\")\n\nwith oi.Session():\n # --- Greedy hill-climbing ---\n t0 = time.time()\n greedy_micro, greedy_tau, greedy_best, greedy_acc = run_optimisation(\n initial_micro, N_ITERATIONS, method=\"greedy\"\n )\n t_greedy = time.time() - t0\n print(f\"Greedy: tau {greedy_tau[0]:.4f} -> {greedy_best[-1]:.4f} \"\n f\"({greedy_acc}/{N_ITERATIONS} accepted, {t_greedy:.1f}s)\")\n\n # --- Simulated annealing ---\n t0 = time.time()\n sa_micro, sa_tau, sa_best, sa_acc = run_optimisation(\n initial_micro, N_ITERATIONS, method=\"sa\", T_init=0.15, cooling=0.97\n )\n t_sa = time.time() - t0\n print(f\"SA: tau {sa_tau[0]:.4f} -> {sa_best[-1]:.4f} \"\n f\"({sa_acc}/{N_ITERATIONS} accepted, {t_sa:.1f}s)\")"
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": "## 1. Convergence Comparison\n\nThe plot below shows both the \"current state\" tortuosity (which can go up for SA) and the \"best found so far\" for each method. Notice that SA's current state wanders upward early on — it is intentionally exploring worse configurations — but its best-so-far can ultimately surpass the greedy result by escaping local optima."
- },
- {
- "cell_type": "code",
- "source": "fig, (ax1, ax2) = plt.subplots(1, 2, figsize=(13, 5), dpi=120)\niters = range(N_ITERATIONS + 1)\n\n# Left: current state (SA can go up, greedy only goes down)\nax1.plot(iters, greedy_tau, '-', color='#d62728', lw=1.5, alpha=0.8, label='Greedy (current)')\nax1.plot(iters, sa_tau, '-', color='#1f77b4', lw=1.5, alpha=0.8, label='SA (current)')\nax1.set_xlabel(\"Iteration\")\nax1.set_ylabel(r\"Current Tortuosity ($\\tau$)\")\nax1.set_title(\"Current State\")\nax1.legend()\nax1.grid(True, alpha=0.3)\nax1.spines['top'].set_visible(False)\nax1.spines['right'].set_visible(False)\n\n# Right: best-so-far (monotonically decreasing for both)\nax2.plot(iters, greedy_best, '-', color='#d62728', lw=2.5, label=f'Greedy (final: {greedy_best[-1]:.4f})')\nax2.plot(iters, sa_best, '-', color='#1f77b4', lw=2.5, label=f'SA (final: {sa_best[-1]:.4f})')\nax2.axhline(1.0, color='gray', ls=':', lw=1, label='Theoretical min (straight channel)')\nax2.set_xlabel(\"Iteration\")\nax2.set_ylabel(r\"Best Tortuosity ($\\tau$)\")\nax2.set_title(\"Best Found So Far\")\nax2.legend(fontsize=9)\nax2.grid(True, alpha=0.3)\nax2.spines['top'].set_visible(False)\nax2.spines['right'].set_visible(False)\n\nplt.tight_layout()\nplt.show()",
- "metadata": {},
- "execution_count": null,
- "outputs": []
- },
- {
- "cell_type": "markdown",
- "source": "## 2. Comparing the Structures\n\nHow do the optimised structures differ from the random starting point? The slices below show the initial configuration alongside both optimised results. Look for the emergence of more connected, channel-like pore pathways in the optimised versions.",
- "metadata": {}
- },
- {
- "cell_type": "code",
- "source": "fig, axes = plt.subplots(1, 3, figsize=(14, 4.5), dpi=120)\nmid = SIZE // 2\n\nfor ax, micro, title in zip(axes,\n [initial_micro, greedy_micro, sa_micro],\n [\"Initial (random)\", \"Greedy result\", \"SA result\"]):\n ax.imshow(micro[mid, :, :], cmap=\"gray\", interpolation=\"nearest\")\n ax.set_title(title)\n ax.axis(\"off\")\n\nplt.suptitle(f\"Mid-plane slices (z = {mid}), porosity = {POROSITY:.2f}\",\n fontweight=\"bold\", y=1.02)\nplt.tight_layout()\nplt.show()",
- "metadata": {},
- "execution_count": null,
- "outputs": []
- },
- {
- "cell_type": "markdown",
- "source": "## 3. How Close to the Theoretical Bound?\n\nFor a structure with porosity $\\varepsilon$ and no obstacles, the theoretical minimum tortuosity is $\\tau = 1$ (a straight channel). No rearrangement of voxels at fixed porosity can beat this. Below we quantify how far each method got from the starting point and from the bound, and verify that porosity was preserved exactly throughout.",
- "metadata": {}
- },
- {
- "cell_type": "code",
- "source": "tau_initial = greedy_tau[0] # both methods started from the same structure\ntau_min = 1.0 # theoretical lower bound (straight channel)\n\nprint(\"=== Summary ===\\n\")\nprint(f\"{'':22s} {'Greedy':>10s} {'SA':>10s}\")\nprint(f\"{'-'*46}\")\nprint(f\"{'Initial tau':22s} {tau_initial:10.4f} {tau_initial:10.4f}\")\nprint(f\"{'Final best tau':22s} {greedy_best[-1]:10.4f} {sa_best[-1]:10.4f}\")\nprint(f\"{'Reduction':22s} {(1 - greedy_best[-1]/tau_initial)*100:9.1f}% {(1 - sa_best[-1]/tau_initial)*100:9.1f}%\")\nprint(f\"{'Distance from bound':22s} {greedy_best[-1] - tau_min:10.4f} {sa_best[-1] - tau_min:10.4f}\")\nprint(f\"{'Accepted / total':22s} {greedy_acc:>4d}/{N_ITERATIONS:<4d} {sa_acc:>4d}/{N_ITERATIONS:<4d}\")\nprint()\n\n# Verify porosity conservation\nfor name, micro in [(\"Initial\", initial_micro), (\"Greedy\", greedy_micro), (\"SA\", sa_micro)]:\n print(f\" {name:8s} porosity = {micro.mean():.6f}\")\n\nprint(f\"\\nPorosity is conserved by construction: every swap exchanges one pore \"\n f\"voxel for one solid voxel.\")",
- "metadata": {},
- "execution_count": null,
- "outputs": []
- },
- {
- "cell_type": "markdown",
- "source": [
- "## Scaling Up: From Toy Demo to Production Optimisation\n",
- "\n",
- "This tutorial is a **toy demonstration** — 100 iterations on a $24^3$ grid with single-voxel swaps. But the same pattern scales directly to production runs on HPC, where OpenImpala's throughput transforms what is feasible:\n",
- "\n",
- "### Scaling the inner loop (faster evaluations)\n",
- "\n",
- "Launch the same script with MPI to speed up each PDE solve:\n",
- "```bash\n",
- "mpirun -np 64 python topology_opt.py --size 128 --iterations 5000\n",
- "```\n",
- "\n",
- "### Scaling the outer loop (more parallel searches)\n",
- "\n",
- "Run many independent SA trajectories simultaneously via SLURM job arrays, then pick the best:\n",
- "```bash\n",
- "#SBATCH --array=0-31 # 32 independent SA runs with different random seeds\n",
- "mpirun -np 16 python topology_opt.py --seed $SLURM_ARRAY_TASK_ID\n",
- "```\n",
- "\n",
- "This \"multi-start\" strategy is embarrassingly parallel and particularly effective for SA, where different random seeds explore different regions of configuration space.\n",
- "\n",
- "### Production-grade improvements\n",
- "\n",
- "- **Increase iterations** (1,000-10,000+) and domain size ($64^3$-$128^3$) for meaningful results.\n",
- "- **Use smarter moves** — swap clusters of voxels, or use gradient-based sensitivity information to guide which voxels to swap.\n",
- "- **Tune SA parameters** — the initial temperature and cooling schedule strongly affect performance. Adaptive schemes (e.g., reheating when the acceptance rate drops too low) are common in practice.\n",
- "- **Optimise in multiple directions** — minimise the maximum tortuosity across X, Y, and Z for isotropic transport.\n",
- "- **Add constraints** — in battery electrode design, for example, you may need to maintain mechanical connectivity of the solid phase while optimising ionic transport through the pore phase.\n",
- "- **Combine with surrogates** — use the surrogate from [Tutorial 5](05_surrogate_modelling.ipynb) to pre-screen candidates cheaply, then validate the best ones with full OpenImpala solves.\n",
- "\n",
- "**Continue the series:**\n",
- "- [Tutorial 5: Surrogate Modelling](05_surrogate_modelling.ipynb) — Train a fast surrogate to replace the PDE solve, enabling much larger optimisation campaigns.\n",
- "- [Tutorial 7: Scaling to HPC](07_hpc_scaling.ipynb) — Deploy production-scale optimisation campaigns on a cluster.\n",
- "\n",
- "---\n",
- "\n",
- "## References & Further Reading\n",
- "\n",
- "1. **OpenImpala:** J. Le Houx & D. Kramer, *OpenImpala: OPEN source IMage based PArallisable Linear Algebra solver*, SoftwareX 15, 100729 (2021). [doi:10.1016/j.softx.2021.100729](https://doi.org/10.1016/j.softx.2021.100729)\n",
- "2. **Topology optimisation for transport:** J. K. Guest & J. H. Prevost, *Topology optimization of creeping fluid flows using a Darcy-Stokes finite element*, Int. J. Numer. Methods Eng. 66(3), 461-484 (2006). [doi:10.1002/nme.1560](https://doi.org/10.1002/nme.1560)\n",
- "3. **Simulated annealing:** S. Kirkpatrick, C. D. Gelatt Jr., & M. P. Vecchi, *Optimization by simulated annealing*, Science 220(4598), 671-680 (1983). [doi:10.1126/science.220.4598.671](https://doi.org/10.1126/science.220.4598.671)\n",
- "4. **Electrode microstructure design:** G. M. Goldin et al., *Three-dimensional particle-resolved models of Li-ion batteries to assist the evaluation of empirical parameters in one-dimensional models*, Electrochimica Acta 64, 118-129 (2012). [doi:10.1016/j.electacta.2011.12.119](https://doi.org/10.1016/j.electacta.2011.12.119)\n",
- "5. **Voxel-based topology optimisation:** O. Sigmund, *A 99 line topology optimization code written in Matlab*, Structural and Multidisciplinary Optimization 21(2), 120-127 (2001). [doi:10.1007/s001580050176](https://doi.org/10.1007/s001580050176)\n",
- "6. **Hashin-Shtrikman bounds:** Z. Hashin & S. Shtrikman, *A variational approach to the theory of the effective magnetic permeability of multiphase materials*, J. Applied Physics 33(10), 3125-3131 (1962). [doi:10.1063/1.1728579](https://doi.org/10.1063/1.1728579)"
- ],
- "metadata": {}
- }
- ],
- "metadata": {
- "kernelspec": {
- "display_name": "Python 3",
- "language": "python",
- "name": "python3"
- },
- "language_info": {
- "name": "python",
- "version": "3.10.0"
- }
- },
- "nbformat": 4,
- "nbformat_minor": 4
-}
diff --git a/tutorials/07_hpc_scaling.ipynb b/tutorials/07_hpc_scaling.ipynb
deleted file mode 100644
index 080443e4..00000000
--- a/tutorials/07_hpc_scaling.ipynb
+++ /dev/null
@@ -1,367 +0,0 @@
-{
- "cells": [
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": " \n\n# Tutorial 7 of 7: Scaling from Laptop to HPC\n\n*OpenImpala Tutorial Series — From first solve to HPC deployment*\n\n---\n\nThe previous tutorials all ran on a single machine. Real synchrotron datasets, however, can be $2000^3$ voxels or larger — too big to fit in a single node's memory, let alone solve interactively.\n\nOpenImpala is built on AMReX and MPI, so the same Python script you wrote in earlier tutorials can be launched with `mpirun` across many nodes. For very large files, OpenImpala's C++ readers can also bypass Python entirely, reading TIFF and HDF5 data in parallel directly from disk.\n\nThis tutorial combines **reference material** (MPI scripts, SLURM templates, reader tables) with **executable benchmarks** you can run right now — a problem-size scaling study and a solver comparison that produces real timing data.\n\n**What you will learn:**\n1. How OpenImpala distributes work across MPI ranks.\n2. The role of `max_grid_size` in domain decomposition.\n3. A complete MPI-ready Python script.\n4. How to use the C++ parallel readers for out-of-core I/O.\n5. A ready-to-use SLURM batch submission script.\n6. How solve time scales with problem size (executable benchmark).\n7. Which HYPRE solver to choose for your problem (executable comparison).\n\n**Prerequisites:** Familiarity with the OpenImpala Python API ([Tutorials 1-2](01_hello_openimpala.ipynb)) and access to a multi-core machine or HPC cluster. All earlier tutorials in the series can inform what scripts you deploy at scale."
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "## 1. How OpenImpala Distributes Work\n",
- "\n",
- "When you call `oi.tortuosity(data, ...)`, here's what happens under the hood:\n",
- "\n",
- "1. **Domain Decomposition:** The 3D voxel grid is split into boxes of size `max_grid_size^3`. AMReX distributes these boxes across MPI ranks.\n",
- "2. **HYPRE Setup:** Each rank fills its local portion of the HYPRE matrix (7-point stencil, harmonic mean face coefficients).\n",
- "3. **Parallel Solve:** HYPRE solves the global system using its own MPI-aware algorithms (FlexGMRES, PCG, etc.).\n",
- "4. **Flux Integration:** Each rank computes its local flux contribution, then MPI reduces to a global sum.\n",
- "\n",
- "The key tuning parameter is **`max_grid_size`**:\n",
- "- Too small (e.g., 16): many tiny boxes = high MPI communication overhead.\n",
- "- Too large (e.g., 512): few huge boxes = poor load balancing, high memory per rank.\n",
- "- Sweet spot: typically **32--128** for most workloads.\n",
- "\n",
- "```\n",
- "Domain: 256^3 voxels, max_grid_size=64\n",
- "-> 64 boxes of 64^3 each\n",
- "-> On 16 MPI ranks: 4 boxes per rank\n",
- "-> On 64 MPI ranks: 1 box per rank (ideal)\n",
- "```"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": "## 2. An MPI-Ready Python Script\n\nThe script below is a complete standalone Python script that can be launched with MPI. The key point: you do not need to change any OpenImpala API calls when going from 1 core to 128. MPI parallelism is handled internally by AMReX and HYPRE."
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "# === hpc_tortuosity.py ===\n",
- "# Run with: mpirun -np 128 python hpc_tortuosity.py\n",
- "#\n",
- "# This script is identical to what you would run on a laptop,\n",
- "# but MPI distributes the work automatically.\n",
- "\n",
- "SCRIPT = '''\n",
- "import time\n",
- "import numpy as np\n",
- "import openimpala as oi\n",
- "\n",
- "# For large files, use OpenImpala's built-in parallel readers\n",
- "# instead of loading everything into NumPy first.\n",
- "IMAGE_PATH = \"/path/to/synchrotron_scan.hdf5\"\n",
- "HDF5_DATASET = \"/exchange/data\"\n",
- "PHASE_ID = 1\n",
- "MAX_GRID_SIZE = 64 # Tune this for your cluster\n",
- "\n",
- "with oi.Session():\n",
- " t0 = time.time()\n",
- "\n",
- " # --- Option A: NumPy workflow (for datasets that fit in RAM) ---\n",
- " # import tifffile\n",
- " # data = tifffile.imread(\"my_scan.tif\").astype(np.int32)\n",
- " # vf = oi.volume_fraction(data, phase=PHASE_ID)\n",
- " # tau = oi.tortuosity(data, phase=PHASE_ID, direction=\"z\",\n",
- " # max_grid_size=MAX_GRID_SIZE)\n",
- "\n",
- " # --- Option B: C++ parallel reader (for massive datasets) ---\n",
- " # The C++ reader distributes the file read across MPI ranks,\n",
- " # so no single node needs to hold the full dataset in memory.\n",
- " reader, img = oi.read_image(\n",
- " IMAGE_PATH,\n",
- " threshold=0.5,\n",
- " file_format=\"hdf5\",\n",
- " hdf5_dataset=HDF5_DATASET,\n",
- " max_grid_size=MAX_GRID_SIZE,\n",
- " )\n",
- "\n",
- " # Volume fraction (works on the distributed VoxelImage directly)\n",
- " vf = oi.volume_fraction(img, phase=PHASE_ID)\n",
- " print(f\"Volume Fraction: {vf.fraction:.6f}\")\n",
- "\n",
- " # Percolation check\n",
- " for direction in [\"x\", \"y\", \"z\"]:\n",
- " perc = oi.percolation_check(img, phase=PHASE_ID, direction=direction)\n",
- " print(f\"Percolates in {direction.upper()}: {perc.percolates}\")\n",
- "\n",
- " if perc.percolates:\n",
- " result = oi.tortuosity(\n",
- " img,\n",
- " phase=PHASE_ID,\n",
- " direction=direction,\n",
- " solver=\"auto\",\n",
- " max_grid_size=MAX_GRID_SIZE,\n",
- " )\n",
- " print(f\" Tau_{direction.upper()} = {result.tortuosity:.6f}\")\n",
- " print(f\" Iterations: {result.iterations}, Residual: {result.residual_norm:.2e}\")\n",
- "\n",
- " t_total = time.time() - t0\n",
- " print(f\"Total wall time: {t_total:.2f} seconds\")\n",
- "'''\n",
- "\n",
- "print(\"=== HPC Python Script ===\")\n",
- "print(SCRIPT)"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "## 3. Using the C++ Parallel Readers\n",
- "\n",
- "For datasets that exceed available RAM (common with synchrotron data), OpenImpala provides C++ readers that perform distributed I/O:\n",
- "\n",
- "| Reader | File Types | Key Benefit |\n",
- "|--------|------------|-------------|\n",
- "| `TiffReader` | `.tif`, `.tiff` | Reads multi-page TIFF stacks or TIFF sequences |\n",
- "| `HDF5Reader` | `.h5`, `.hdf5` | Parallel HDF5 I/O (requires parallel HDF5 build) |\n",
- "| `RawReader` | `.raw` | Flat binary files (specify dimensions and data type) |\n",
- "| `DatReader` | `.dat` | Legacy binary format |\n",
- "\n",
- "The `oi.read_image()` function auto-detects the format from the file extension:\n",
- "\n",
- "```python\n",
- "# TIFF (auto-detected)\n",
- "reader, img = oi.read_image(\"scan.tif\", threshold=0.5)\n",
- "\n",
- "# HDF5 with custom dataset path\n",
- "reader, img = oi.read_image(\"scan.hdf5\", threshold=0.5,\n",
- " hdf5_dataset=\"/exchange/data\")\n",
- "\n",
- "# RAW binary (must specify dimensions and type)\n",
- "reader, img = oi.read_image(\"scan.raw\", threshold=128,\n",
- " raw_width=2000, raw_height=2000, raw_depth=2000)\n",
- "```\n",
- "\n",
- "The returned `img` (a `VoxelImage`) can be passed directly to `oi.volume_fraction()`, `oi.percolation_check()`, and `oi.tortuosity()` -- exactly the same API as a NumPy array."
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "## 4. SLURM Batch Script\n",
- "\n",
- "Below is a ready-to-use SLURM submission script. Adjust the paths and resource requests for your specific cluster."
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": "SLURM_SCRIPT = '''\n#!/bin/bash\n#SBATCH --job-name=openimpala\n#SBATCH --nodes=4\n#SBATCH --ntasks-per-node=32\n#SBATCH --time=02:00:00\n#SBATCH --output=openimpala_%j.log\n\n# Load required modules (adjust for your cluster)\nmodule load python/3.10\nmodule load openmpi/4.1\n\n# Ensure one MPI rank per core (no OpenMP threading)\nexport OMP_NUM_THREADS=1\n\n# Activate your virtual environment\nsource ~/venvs/openimpala/bin/activate\n\n# Run the analysis script with 128 MPI ranks across 4 nodes\nmpirun -np $SLURM_NTASKS python hpc_tortuosity.py\n\necho \"Job finished at $(date)\"\n'''\n\nprint(\"=== SLURM Submission Script ===\")\nprint(SLURM_SCRIPT)\nprint(\"Save as 'submit.sh' and run with: sbatch submit.sh\")"
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "## 5. Performance Tips\n",
- "\n",
- "### Choosing `max_grid_size`\n",
- "\n",
- "| Dataset Size | Recommended `max_grid_size` | Reasoning |\n",
- "|-------------|---------------------------|----------|\n",
- "| $100^3$ | 64--128 | Few ranks, minimize box overhead |\n",
- "| $500^3$ | 32--64 | Balance boxes across 16--64 ranks |\n",
- "| $1000^3$+ | 32 | Many boxes for good load distribution |\n",
- "\n",
- "### Memory Estimation\n",
- "\n",
- "Each MPI rank needs memory for:\n",
- "- The local portion of the voxel grid (int32: 4 bytes/voxel)\n",
- "- The HYPRE matrix (sparse, ~56 bytes/voxel for 7-pt stencil)\n",
- "- The solution vector and work arrays (~16 bytes/voxel)\n",
- "\n",
- "**Rule of thumb:** ~80 bytes per active voxel per rank. A $1000^3$ dataset with 50% porosity on 64 ranks needs approximately:\n",
- "```\n",
- "500M active voxels * 80 bytes / 64 ranks = ~625 MB per rank\n",
- "```\n",
- "\n",
- "### Using the Container on HPC\n",
- "\n",
- "If your cluster does not have OpenImpala's dependencies installed, you can use the pre-built Apptainer/Singularity container:\n",
- "\n",
- "```bash\n",
- "# Download the container from GitHub Releases\n",
- "wget https://github.com/BASE-Laboratory/OpenImpala/releases/download/vX.Y.Z/openimpala-vX.Y.Z.sif\n",
- "\n",
- "# Run the C++ application directly\n",
- "mpirun -np 128 apptainer exec \\\n",
- " -B \"$(pwd):$(pwd)\" openimpala-vX.Y.Z.sif \\\n",
- " /usr/local/bin/Diffusion ./inputs\n",
- "\n",
- "# Or run a Python script inside the container\n",
- "mpirun -np 128 apptainer exec \\\n",
- " -B \"$(pwd):$(pwd)\" openimpala-vX.Y.Z.sif \\\n",
- " python hpc_tortuosity.py\n",
- "```"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": "## 6. Executable Scaling Study: Problem Size vs. Wall Time\n\nEven on a single machine, we can measure how solve time scales with problem size. This is a **weak-scaling proxy** — we increase the domain while keeping one rank, which shows the computational complexity of the solver. On a real cluster with proportionally more MPI ranks, wall time would stay roughly constant (ideal weak scaling).\n\nThis cell actually runs and produces real timing data."
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": "# Install OpenImpala (compiled C++ backend needed for HPC features in this tutorial).\n# Auto-detect GPU vs CPU runtime.\nimport subprocess, sys\n\ndef _has_gpu():\n try:\n subprocess.check_output([\"nvidia-smi\"], stderr=subprocess.DEVNULL)\n return True\n except (FileNotFoundError, subprocess.CalledProcessError):\n return False\n\n_common = \"porespy matplotlib\"\nif _has_gpu():\n print(\"GPU detected — installing openimpala-cuda\")\n !pip install -q openimpala-cuda {_common}\nelse:\n print(\"No GPU detected — installing openimpala (CPU)\")\n !pip install -q openimpala {_common}"
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": "import time\nimport numpy as np\nimport matplotlib.pyplot as plt\nimport openimpala as oi\n\n# --- Weak-scaling proxy: increasing problem size on 1 rank ---\n# On HPC, you would add proportionally more ranks to keep time constant.\ngrid_sizes = [16, 24, 32, 48, 64]\nnp.random.seed(42)\n\nresults = []\n\nwith oi.Session():\n for N in grid_sizes:\n # Generate random porous structure at this size\n data = np.random.choice([0, 1], size=(N, N, N), p=[0.4, 0.6]).astype(np.int32)\n n_voxels = N ** 3\n\n # Time the full pipeline: percolation check + tortuosity solve\n t0 = time.time()\n try:\n perc = oi.percolation_check(data, phase=1, direction=\"z\")\n if perc.percolates:\n result = oi.tortuosity(data, phase=1, direction=\"z\",\n solver=\"mlmg\", max_grid_size=min(N, 32))\n t_elapsed = time.time() - t0\n results.append({\n \"N\": N, \"voxels\": n_voxels, \"time\": t_elapsed,\n \"tau\": result.tortuosity, \"iters\": result.iterations,\n \"residual\": result.residual_norm,\n })\n print(f\" N={N:3d} ({n_voxels:>8,} voxels) \"\n f\"tau={result.tortuosity:.4f} \"\n f\"iters={result.iterations:4d} \"\n f\"time={t_elapsed:.3f}s\")\n else:\n print(f\" N={N:3d} did not percolate, skipping\")\n except Exception as e:\n print(f\" N={N:3d} failed: {e}\")\n\n# --- Plot: wall time vs. problem size ---\nif results:\n fig, (ax1, ax2) = plt.subplots(1, 2, figsize=(13, 5), dpi=120)\n\n ns = [r[\"N\"] for r in results]\n voxels = [r[\"voxels\"] for r in results]\n times = [r[\"time\"] for r in results]\n iters = [r[\"iters\"] for r in results]\n\n # Left: Wall time vs. voxel count (log-log)\n ax1.loglog(voxels, times, 'o-', color='#1f77b4', lw=2, ms=8)\n # Reference line: linear scaling\n v0, t0_ref = voxels[0], times[0]\n ref_times = [t0_ref * (v / v0) for v in voxels]\n ax1.loglog(voxels, ref_times, '--', color='gray', lw=1, label='Linear scaling (O(N))')\n ax1.set_xlabel(\"Total Voxels\", fontweight='bold')\n ax1.set_ylabel(\"Wall Time (seconds)\", fontweight='bold')\n ax1.set_title(\"Solve Time vs. Problem Size (1 rank)\")\n ax1.legend()\n ax1.grid(True, alpha=0.3, which='both')\n ax1.spines['top'].set_visible(False)\n ax1.spines['right'].set_visible(False)\n\n # Right: Solver iterations vs. grid size\n ax2.bar([str(n) for n in ns], iters, color='#ff7f0e', edgecolor='black', linewidth=0.5)\n ax2.set_xlabel(\"Grid Size (N)\", fontweight='bold')\n ax2.set_ylabel(\"HYPRE Iterations\", fontweight='bold')\n ax2.set_title(\"Solver Iterations vs. Grid Size\")\n ax2.grid(True, alpha=0.3, axis='y')\n ax2.spines['top'].set_visible(False)\n ax2.spines['right'].set_visible(False)\n\n plt.tight_layout()\n plt.show()\n\n # --- Summary table ---\n print(\"\\n--- Scaling Summary ---\")\n print(f\"{'N':>5s} {'Voxels':>10s} {'Time (s)':>10s} {'Iters':>6s} {'Tau':>8s}\")\n for r in results:\n print(f\"{r['N']:5d} {r['voxels']:10,} {r['time']:10.3f} \"\n f\"{r['iters']:6d} {r['tau']:8.4f}\")"
- },
- {
- "cell_type": "markdown",
- "source": "## 7. Solver Comparison: Which HYPRE Algorithm to Use?\n\nOpenImpala supports several HYPRE solvers. The best choice depends on your problem size and structure. Below we time each solver on the same structure to provide practical guidance.",
- "metadata": {}
- },
- {
- "cell_type": "code",
- "source": [
- "# --- Compare HYPRE solvers on a fixed problem ---\n",
- "N_cmp = 48\n",
- "np.random.seed(42)\n",
- "import porespy as ps\n",
- "\n",
- "# Use a structured porous medium (more realistic than pure random)\n",
- "test_micro = ps.generators.blobs(\n",
- " shape=[N_cmp, N_cmp, N_cmp], porosity=0.45, blobiness=1.5\n",
- ").astype(np.int32)\n",
- "\n",
- "solvers_to_test = [\"flexgmres\", \"pcg\", \"gmres\", \"bicgstab\", \"pfmg\", \"smg\", \"mlmg\"]\n",
- "solver_results = []\n",
- "\n",
- "with oi.Session():\n",
- " for solver_name in solvers_to_test:\n",
- " t0 = time.time()\n",
- " try:\n",
- " result = oi.tortuosity(test_micro, phase=1, direction=\"z\",\n",
- " solver=solver_name, max_grid_size=32)\n",
- " t_elapsed = time.time() - t0\n",
- " solver_results.append({\n",
- " \"solver\": solver_name, \"time\": t_elapsed,\n",
- " \"tau\": result.tortuosity, \"iters\": result.iterations,\n",
- " \"residual\": result.residual_norm, \"converged\": result.solver_converged,\n",
- " })\n",
- " status = \"OK\" if result.solver_converged else \"DID NOT CONVERGE\"\n",
- " print(f\" {solver_name:12s} tau={result.tortuosity:.4f} \"\n",
- " f\"iters={result.iterations:5d} \"\n",
- " f\"residual={result.residual_norm:.2e} \"\n",
- " f\"time={t_elapsed:.3f}s [{status}]\")\n",
- " except Exception as e:\n",
- " solver_results.append({\n",
- " \"solver\": solver_name, \"time\": None, \"tau\": None,\n",
- " \"iters\": None, \"residual\": None, \"converged\": False,\n",
- " })\n",
- " print(f\" {solver_name:12s} FAILED: {e}\")\n",
- "\n",
- "# --- Plot solver comparison ---\n",
- "valid = [r for r in solver_results if r[\"time\"] is not None and r[\"converged\"]]\n",
- "if valid:\n",
- " fig, (ax1, ax2) = plt.subplots(1, 2, figsize=(13, 5), dpi=120)\n",
- "\n",
- " names = [r[\"solver\"] for r in valid]\n",
- " times_s = [r[\"time\"] for r in valid]\n",
- " iters_s = [r[\"iters\"] for r in valid]\n",
- "\n",
- " colors = ['#1f77b4', '#ff7f0e', '#2ca02c', '#d62728', '#9467bd', '#8c564b', '#e377c2']\n",
- "\n",
- " ax1.barh(names, times_s, color=colors[:len(names)], edgecolor='black', linewidth=0.5)\n",
- " ax1.set_xlabel(\"Wall Time (seconds)\", fontweight='bold')\n",
- " ax1.set_title(f\"Solver Wall Time ({N_cmp}^3 grid)\")\n",
- " ax1.spines['top'].set_visible(False)\n",
- " ax1.spines['right'].set_visible(False)\n",
- "\n",
- " ax2.barh(names, iters_s, color=colors[:len(names)], edgecolor='black', linewidth=0.5)\n",
- " ax2.set_xlabel(\"Iterations to Converge\", fontweight='bold')\n",
- " ax2.set_title(f\"Solver Iterations ({N_cmp}^3 grid)\")\n",
- " ax2.spines['top'].set_visible(False)\n",
- " ax2.spines['right'].set_visible(False)\n",
- "\n",
- " plt.tight_layout()\n",
- " plt.show()\n",
- "\n",
- " # Verify all solvers agree on tau\n",
- " taus = [r[\"tau\"] for r in valid]\n",
- " print(f\"\\nAll converged solvers agree on tau: \"\n",
- " f\"max spread = {max(taus) - min(taus):.2e}\")\n",
- " print(\"\\nRecommendations:\")\n",
- " print(\" - MLMG (default / auto): matrix-free geometric multigrid (~3x lower RAM, fastest on CPU & GPU)\")\n",
- " print(\" - PCG: fast HYPRE Krylov alternative for symmetric positive definite problems\")\n",
- " print(\" - FlexGMRES: robust HYPRE fallback, handles non-symmetric systems\")\n",
- " print(\" - SMG/PFMG & BiCGSTAB: standalone HYPRE multigrid / Krylov alternatives\")"
- ],
- "metadata": {},
- "execution_count": null,
- "outputs": []
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "## Summary\n",
- "\n",
- "| Scenario | Approach |\n",
- "|----------|----------|\n",
- "| **Laptop / Colab** | `pip install openimpala`, use NumPy arrays directly |\n",
- "| **Small cluster (1-16 cores)** | `mpirun -np 16 python script.py` with NumPy loading |\n",
- "| **Large cluster (16-128+ cores)** | `mpirun -np 128 python script.py` with `oi.read_image()` for parallel I/O |\n",
- "| **HPC without Python** | `mpirun -np 128 Diffusion ./inputs` (pure C++ application) |\n",
- "\n",
- "### Solver Quick Reference\n",
- "\n",
- "| Solver | Best For | Notes |\n",
- "|--------|----------|-------|\n",
- "| **MLMG** (`auto` / `mlmg`) | Default on CPU & GPU | Matrix-free AMReX geometric multigrid (~3× lower memory, fastest) |\n",
- "| **PCG** | Symmetric problems | Fast HYPRE Krylov solver with SMG/PFMG preconditioning |\n",
- "| **FlexGMRES** | General / fallback | Robust HYPRE Krylov solver, handles non-symmetric systems |\n",
- "| **SMG / PFMG** | Structured grids | Standalone HYPRE semicoarsening / pointwise multigrid |\n",
- "| **BiCGSTAB** | Non-symmetric | Low-memory Krylov alternative to GMRES |\n",
- "\n",
- "The API is the same at every scale — only the launch command changes. The scaling study and solver comparison in Sections 6-7 provide concrete data to guide your deployment decisions.\n",
- "\n",
- "**Back to the beginning:**\n",
- "- [Tutorial 1: Getting Started](01_hello_openimpala.ipynb) — Core workflow with synthetic microstructures.\n",
- "- [Tutorial 2: From 3D Image to Device Model](02_digital_twin.ipynb) — Load real CT scans and export to PyBaMM.\n",
- "\n",
- "---\n",
- "\n",
- "## References & Further Reading\n",
- "\n",
- "1. **OpenImpala:** J. Le Houx & D. Kramer, *OpenImpala: OPEN source IMage based PArallisable Linear Algebra solver*, SoftwareX 15, 100729 (2021). [doi:10.1016/j.softx.2021.100729](https://doi.org/10.1016/j.softx.2021.100729)\n",
- "2. **AMReX:** W. Zhang et al., *AMReX: a framework for block-structured adaptive mesh refinement*, J. Open Source Software 4(37), 1370 (2019). [doi:10.21105/joss.01370](https://doi.org/10.21105/joss.01370)\n",
- "3. **AMReX scaling:** W. Zhang et al., *AMReX: Block-structured adaptive mesh refinement for multiphysics applications*, Int. J. High Perform. Comput. Appl. 35(6), 508-526 (2021). [doi:10.1177/10943420211022811](https://doi.org/10.1177/10943420211022811)\n",
- "4. **HYPRE:** R. D. Falgout & U. M. Yang, *hypre: A library of high performance preconditioners*, Computational Science — ICCS 2002, LNCS 2331, pp. 632-641 (2002). [doi:10.1007/3-540-47789-6_66](https://doi.org/10.1007/3-540-47789-6_66)\n",
- "5. **Parallel HDF5:** The HDF Group, *HDF5 — Parallel I/O*, [hdfgroup.org](https://www.hdfgroup.org/solutions/hdf5/)\n",
- "6. **Apptainer/Singularity for HPC:** G. M. Kurtzer et al., *Singularity: Scientific containers for mobility of compute*, PLoS ONE 12(5), e0177459 (2017). [doi:10.1371/journal.pone.0177459](https://doi.org/10.1371/journal.pone.0177459)\n",
- "7. **MPI standard:** Message Passing Interface Forum, *MPI: A Message-Passing Interface Standard, Version 4.0* (2021). [mpi-forum.org](https://www.mpi-forum.org/docs/mpi-4.0/mpi40-report.pdf)"
- ]
- }
- ],
- "metadata": {
- "kernelspec": {
- "display_name": "Python 3",
- "language": "python",
- "name": "python3"
- },
- "language_info": {
- "name": "python",
- "version": "3.10.0"
- }
- },
- "nbformat": 4,
- "nbformat_minor": 4
-}
From 6bcdda643811fa136ede8b685d2e068e90826cc4 Mon Sep 17 00:00:00 2001
From: James Le Houx <37665786+jameslehoux@users.noreply.github.com>
Date: Wed, 18 Nov 2026 10:17:18 +0000
Subject: [PATCH 3/5] docs,ci: migrate Sphinx to pydata-sphinx-theme + myst-nb
and add CITATION.cff & pure-Python CI
---
.github/workflows/build-test.yml | 26 ++++++
.github/workflows/docs.yml | 31 +++++--
.gitignore | 9 ++
CITATION.cff | 57 ++++++++++++
CONTRIBUTING.md | 18 ++--
README.md | 21 ++++-
docs/api/cpp.md | 58 ++++++++----
docs/api/index.rst | 26 ++++++
docs/api/python.rst | 71 +++++++++++++--
docs/changelog.md | 36 ++++++--
docs/conf.py | 139 ++++++++++++++++++++++-------
docs/contributing.md | 90 +++++++++++--------
docs/getting-started.md | 147 +++++++++++++------------------
docs/index.rst | 110 ++++++++++++-----------
docs/requirements.txt | 13 ++-
docs/tutorials/index.md | 96 ++++++++++++++++----
docs/user-guide/concepts.md | 81 ++++++-----------
docs/user-guide/gpu.md | 79 +++++------------
docs/user-guide/hpc.md | 90 +++++++++----------
docs/user-guide/index.md | 62 +++++++++++++
docs/user-guide/input-files.md | 100 +++++++++------------
docs/user-guide/solvers.md | 88 ++++++++----------
docs/user-guide/yt-plotfiles.md | 73 +++++++++++++++
paper.md | 2 +-
pyproject.toml | 20 +++--
25 files changed, 991 insertions(+), 552 deletions(-)
create mode 100644 CITATION.cff
create mode 100644 docs/api/index.rst
create mode 100644 docs/user-guide/index.md
create mode 100644 docs/user-guide/yt-plotfiles.md
diff --git a/.github/workflows/build-test.yml b/.github/workflows/build-test.yml
index 703460bc..f5564acb 100644
--- a/.github/workflows/build-test.yml
+++ b/.github/workflows/build-test.yml
@@ -51,6 +51,32 @@ jobs:
echo ' */'
fi
+ pure-python-test:
+ name: Pure-Python Solver & API (${{ matrix.python-version }})
+ runs-on: ubuntu-latest
+ strategy:
+ fail-fast: false
+ matrix:
+ python-version: ["3.9", "3.11", "3.13"]
+ steps:
+ - name: Checkout repository
+ uses: actions/checkout@v4
+
+ - name: Set up Python ${{ matrix.python-version }}
+ uses: actions/setup-python@v5
+ with:
+ python-version: ${{ matrix.python-version }}
+
+ - name: Install Python test dependencies
+ run: |
+ python -m pip install --upgrade pip
+ python -m pip install pytest numpy "scipy>=1.7" tifffile h5py
+
+ - name: Run pure-Python test suite
+ env:
+ PYTHONPATH: ${{ github.workspace }}/python
+ run: pytest python/tests/ -v --tb=short
+
static-analysis:
name: Static Analysis (clang-tidy)
runs-on: ubuntu-latest
diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
index 0f45bb0c..61ff0b5f 100644
--- a/.github/workflows/docs.yml
+++ b/.github/workflows/docs.yml
@@ -7,21 +7,23 @@ on:
paths:
- 'src/**'
- 'python/**'
+ - 'tutorials/**'
+ - 'Doxyfile'
+ - 'docs/**'
+ - '.github/workflows/docs.yml'
+ pull_request:
+ branches: [master]
+ paths:
+ - 'src/**'
+ - 'python/**'
+ - 'tutorials/**'
- 'Doxyfile'
- 'docs/**'
- '.github/workflows/docs.yml'
workflow_dispatch: # Allow manual triggering
-# Sets permissions for GitHub Pages deployment
permissions:
contents: read
- pages: write
- id-token: write
-
-# Only allow one deployment at a time
-concurrency:
- group: "pages"
- cancel-in-progress: true
jobs:
build-docs:
@@ -49,20 +51,31 @@ jobs:
run: doxygen Doxyfile
- name: Build Sphinx documentation
- run: sphinx-build -b html docs/ docs/_build/html
+ env:
+ PYTHONPATH: ${{ github.workspace }}/python
+ OPENIMPALA_REQUIRE_DOXYGEN: "1"
+ run: sphinx-build -W --keep-going -b html docs/ docs/_build/html
- name: Copy Doxygen HTML into Sphinx output
run: cp -r docs/doxygen/html docs/_build/html/doxygen
- name: Upload Pages artifact
+ if: github.event_name != 'pull_request'
uses: actions/upload-pages-artifact@v3
with:
path: docs/_build/html
deploy:
name: Deploy to GitHub Pages
+ if: github.event_name != 'pull_request'
needs: build-docs
runs-on: ubuntu-latest
+ permissions:
+ pages: write
+ id-token: write
+ concurrency:
+ group: "pages"
+ cancel-in-progress: true
environment:
name: github-pages
url: ${{ steps.deployment.outputs.page_url }}
diff --git a/.gitignore b/.gitignore
index 6b133aa8..989c44d8 100644
--- a/.gitignore
+++ b/.gitignore
@@ -10,6 +10,15 @@ Backtrace*
# Python
__pycache__/
*.pyc
+.venv/
+.pytest_cache/
+
+# Docs
+docs/_build/
+docs/xml/
+docs/doxygen/
+docs/jupyter_execute/
+docs/tutorials/*.ipynb
# CMake
CMakeCache.txt
diff --git a/CITATION.cff b/CITATION.cff
new file mode 100644
index 00000000..82d55021
--- /dev/null
+++ b/CITATION.cff
@@ -0,0 +1,57 @@
+cff-version: 1.2.0
+title: "OpenImpala: Scalable Transport Property Computation on 3D Voxel Images of Porous Media"
+message: "If you use OpenImpala in published work, please cite the software and associated publications below."
+type: software
+authors:
+ - family-names: "Le Houx"
+ given-names: "James"
+ orcid: "https://orcid.org/0000-0002-1576-0673"
+ affiliation: "University of Greenwich"
+ email: "james.le-houx@gre.ac.uk"
+repository-code: "https://github.com/BASE-Laboratory/OpenImpala"
+url: "https://base-laboratory.github.io/OpenImpala/"
+license: BSD-3-Clause
+keywords:
+ - porous media
+ - tortuosity
+ - effective diffusivity
+ - homogenisation
+ - tomography
+ - battery modelling
+ - AMReX
+ - high-performance computing
+preferred-citation:
+ type: article
+ title: "OpenImpala: OPEN source IMage based PArallisable Linear Algebra solver"
+ authors:
+ - family-names: "Le Houx"
+ given-names: "James"
+ orcid: "https://orcid.org/0000-0002-1576-0673"
+ - family-names: "Kramer"
+ given-names: "Denis"
+ journal: "SoftwareX"
+ volume: 15
+ start: 100729
+ year: 2021
+ doi: "10.1016/j.softx.2021.100729"
+references:
+ - type: article
+ title: "Statistical Effective Diffusivity Estimation in Porous Media Using an Integrated On-site Imaging Workflow for Synchrotron Users"
+ authors:
+ - family-names: "Le Houx"
+ given-names: "James"
+ - family-names: "Ruiz"
+ given-names: "Siul"
+ - family-names: "McKay Fletcher"
+ given-names: "Daniel"
+ - family-names: "Ahmed"
+ given-names: "Sharif"
+ - family-names: "Roose"
+ given-names: "Tiina"
+ journal: "Transport in Porous Media"
+ volume: 150
+ issue: 1
+ start: 71
+ end: 88
+ year: 2023
+ doi: "10.1007/s11242-023-01993-7"
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 6087d710..f292e85c 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -39,7 +39,7 @@ your local builds will behave identically to the CI build.
git clone https://github.com/BASE-Laboratory/OpenImpala.git
cd OpenImpala
# Build the container (one-off, ~20 min)
-sudo apptainer build dependency_image.sif containers/dependency.def
+sudo apptainer build dependency_image.sif containers/Singularity.deps.def
# Configure and build
apptainer exec --bind "$(pwd):/src" dependency_image.sif \
bash -c "cd /src && mkdir -p build && cd build && cmake .. && make -j"
@@ -74,10 +74,8 @@ that fail either check.
* **C++**: clang-tidy with the rules in `.clang-tidy` (bugprone-*,
performance-*, modernize-use-nullptr). CI runs this against every
changed file.
-* **Python**: PEP 8 via `ruff` is recommended but not enforced. Public
- API functions in `python/openimpala/facade.py` should have NumPy-style
- docstrings.
-* **Fortran files** are not processed by clang-format or clang-tidy.
+* **Python**: PEP 8 via `ruff` is recommended. Public API functions in
+ `python/openimpala/` should have NumPy-style docstrings.
All C++ code lives in `namespace OpenImpala`. Headers use `#ifndef`
include guards rather than `#pragma once`.
@@ -87,11 +85,12 @@ include guards rather than `#pragma once`.
The test suite has three layers:
1. **C++ unit and integration tests** (under `tests/`) — Catch2-based,
- register with CTest. Run with `ctest --output-on-failure`. Each test
+ registered with CTest. Run with `ctest --output-on-failure`. Each test
is a small standalone solve with an analytical solution or a tightly
bounded numerical reference.
-2. **Python tests** (under `python/tests/`) — pytest-based, exercise the
- facade and binding layers. Run with `pytest python/tests/`.
+2. **Python tests** (under `python/tests/`) — pytest-based, exercising both
+ the pure-Python solver and C++ bindings. Run without compiling C++ via
+ `PYTHONPATH=python pytest python/tests/`.
3. **Regression benchmarks** (under `tests/benchmarks/`) — Python scripts
generating synthetic datasets with known analytical tortuosity values
(uniform block, series layers, parallel layers).
@@ -107,10 +106,11 @@ and passes on your fix.
3. Run the local CI loop:
```bash
clang-format -i src/**/*.{cpp,H} python/bindings/*.cpp
+ PYTHONPATH=python pytest python/tests/
apptainer exec --bind "$(pwd):/src" dependency_image.sif \
bash -c "cd /src/build && make -j && ctest --output-on-failure"
```
-4. Open a pull request against `main`. The PR description should explain
+4. Open a pull request against `master`. The PR description should explain
*why* the change is needed, not just *what* it changes.
5. CI runs clang-format check, clang-tidy static analysis, the C++ test
suite, Python tests, code-coverage reporting (via Codecov), and wheel
diff --git a/README.md b/README.md
index bae1a6b2..425521da 100644
--- a/README.md
+++ b/README.md
@@ -4,7 +4,7 @@
-[](https://colab.research.google.com/github/BASE-Laboratory/OpenImpala/blob/master/tutorials/01_hello_openimpala.ipynb)
+[](https://colab.research.google.com/github/BASE-Laboratory/OpenImpala/blob/master/tutorials/01_getting_started.ipynb)
[](https://pypi.org/project/openimpala/)
[](https://opensource.org/licenses/BSD-3-Clause)
[](https://doi.org/10.1016/j.softx.2021.100729)
@@ -24,7 +24,7 @@ Outputs parameterise continuum-scale models such as
[PyBaMM](https://github.com/pybamm-team/PyBaMM).
📖 **Documentation:**
-📓 **Tutorials:** [`tutorials/`](tutorials/) (runnable on Google Colab)
+📓 **Tutorials:**
## Quick example
@@ -33,7 +33,7 @@ import numpy as np
import openimpala as oi
image = np.zeros((64, 64, 64), dtype=np.int32)
-image[:, :, 16:48] = 1 # solid slab through the middle
+image[16:48, 16:48, 16:48] = 1 # central solid obstacle
with oi.Session():
vf = oi.volume_fraction(image, phase=0)
@@ -42,6 +42,18 @@ with oi.Session():
print(f"Tortuosity: {tau.tortuosity:.4f}")
```
+## Tutorials
+
+All tutorials are pre-rendered in the [online documentation](https://base-laboratory.github.io/OpenImpala/tutorials/index.html) and runnable on Google Colab:
+
+| # | Tutorial | Launch |
+| :- | :--- | :--- |
+| 01 | [First Transport Solve & Analytical Verification](https://base-laboratory.github.io/OpenImpala/tutorials/01_getting_started.html) | [](https://colab.research.google.com/github/BASE-Laboratory/OpenImpala/blob/master/tutorials/01_getting_started.ipynb) |
+| 02 | [Microstructural Metrics & Directional Anisotropy](https://base-laboratory.github.io/OpenImpala/tutorials/02_microstructure_and_anisotropy.html) | [](https://colab.research.google.com/github/BASE-Laboratory/OpenImpala/blob/master/tutorials/02_microstructure_and_anisotropy.ipynb) |
+| 03 | [Periodic Homogenisation & the 3×3 Effective Diffusivity Tensor](https://base-laboratory.github.io/OpenImpala/tutorials/03_homogenisation_tensor.html) | [](https://colab.research.google.com/github/BASE-Laboratory/OpenImpala/blob/master/tutorials/03_homogenisation_tensor.ipynb) |
+| 04 | [Multi-Phase Transport in Composite Media](https://base-laboratory.github.io/OpenImpala/tutorials/04_multiphase_transport.html) | [](https://colab.research.google.com/github/BASE-Laboratory/OpenImpala/blob/master/tutorials/04_multiphase_transport.ipynb) |
+| 05 | [Representative Elementary Volume (REV) & Subvolume Uncertainty](https://base-laboratory.github.io/OpenImpala/tutorials/05_rev_and_uncertainty.html) | [](https://colab.research.google.com/github/BASE-Laboratory/OpenImpala/blob/master/tutorials/05_rev_and_uncertainty.ipynb) |
+
## Install
### Python (recommended)
@@ -55,7 +67,8 @@ On Linux `x86_64`, `openimpala` installs pre-built AMReX/HYPRE C++ bindings —
install an MPI runtime (`libopenmpi-dev`, `openmpi`, or
`conda install -c conda-forge openmpi`) to enable multi-rank C++ execution. On
macOS, Windows, and ARM64 (or when MPI is absent), `openimpala` automatically
-uses its pure-Python SciPy/CuPy solver with the same API. See
+uses its pure-Python SciPy solver (with optional CuPy acceleration) under the
+same API. See
[Getting Started](https://base-laboratory.github.io/OpenImpala/getting-started.html)
for full details.
diff --git a/docs/api/cpp.md b/docs/api/cpp.md
index ef7be91d..5d75d6dd 100644
--- a/docs/api/cpp.md
+++ b/docs/api/cpp.md
@@ -1,15 +1,10 @@
# C++ API Reference
-The C++ API reference is generated from Doxygen comments in the source code
-using [Breathe](https://breathe.readthedocs.io/).
+The C++ API reference is generated from Doxygen comments in `src/` via
+[Breathe](https://breathe.readthedocs.io/). All public symbols live in
+`namespace OpenImpala`.
-## Namespace
-
-All OpenImpala classes live in the `OpenImpala` namespace.
-
-## Key classes
-
-### I/O Readers
+## I/O Readers
```{eval-rst}
.. doxygenclass:: OpenImpala::TiffReader
@@ -23,25 +18,37 @@ All OpenImpala classes live in the `OpenImpala` namespace.
.. doxygenclass:: OpenImpala::RawReader
:members:
:outline:
+
+.. doxygenclass:: OpenImpala::DatReader
+ :members:
+ :outline:
```
-### Transport Solvers
+## Transport Solvers
```{eval-rst}
-.. doxygenclass:: OpenImpala::TortuosityHypre
+.. doxygenclass:: OpenImpala::TortuosityMLMG
:members:
:outline:
-.. doxygenclass:: OpenImpala::TortuosityMLMG
+.. doxygenclass:: OpenImpala::TortuosityHypre
:members:
:outline:
.. doxygenclass:: OpenImpala::EffectiveDiffusivityHypre
:members:
:outline:
+
+.. doxygenclass:: OpenImpala::TortuositySolverBase
+ :members:
+ :outline:
+
+.. doxygenclass:: OpenImpala::HypreStructSolver
+ :members:
+ :outline:
```
-### Utilities
+## Microstructural Characterisation
```{eval-rst}
.. doxygenclass:: OpenImpala::VolumeFraction
@@ -52,16 +59,28 @@ All OpenImpala classes live in the `OpenImpala` namespace.
:members:
:outline:
-.. doxygenclass:: OpenImpala::TortuositySolverBase
+.. doxygenclass:: OpenImpala::SpecificSurfaceArea
:members:
:outline:
-.. doxygenclass:: OpenImpala::HypreStructSolver
+.. doxygenclass:: OpenImpala::ConnectedComponents
+ :members:
+ :outline:
+
+.. doxygenclass:: OpenImpala::ParticleSizeDistribution
+ :members:
+ :outline:
+
+.. doxygenclass:: OpenImpala::ThroughThicknessProfile
+ :members:
+ :outline:
+
+.. doxygenstruct:: OpenImpala::REVConfig
:members:
:outline:
```
-### Configuration
+## Configuration
```{eval-rst}
.. doxygenstruct:: OpenImpala::PhysicsConfig
@@ -69,7 +88,8 @@ All OpenImpala classes live in the `OpenImpala` namespace.
:outline:
```
-## Full Doxygen output
+## Full Doxygen Output
-For the complete class hierarchy, include dependency graphs, and file-level
-documentation, see the [Doxygen pages](../doxygen/html/index.html).
+For the complete C++ class hierarchy, include graphs, and file-level
+documentation, see the
+[standalone Doxygen reference](https://base-laboratory.github.io/OpenImpala/doxygen/index.html).
diff --git a/docs/api/index.rst b/docs/api/index.rst
new file mode 100644
index 00000000..b42d3bed
--- /dev/null
+++ b/docs/api/index.rst
@@ -0,0 +1,26 @@
+API Reference
+=============
+
+Complete reference documentation for OpenImpala's Python interface and C++ solver classes.
+
+.. grid:: 1 2 2 2
+ :gutter: 3
+
+ .. grid-item-card:: Python API Reference
+ :link: python
+ :link-type: doc
+
+ High-level functions in ``openimpala``, sample loaders in ``openimpala.datasets``, result dataclasses, ``Session``, and exceptions.
+
+ .. grid-item-card:: C++ API Reference
+ :link: cpp
+ :link-type: doc
+
+ Doxygen-generated documentation for ``TortuosityMLMG``, ``TortuosityHypre``, ``EffectiveDiffusivityHypre``, readers, and microstructural property classes.
+
+.. toctree::
+ :hidden:
+ :maxdepth: 2
+
+ python
+ cpp
diff --git a/docs/api/python.rst b/docs/api/python.rst
index 415e12f1..d71e9555 100644
--- a/docs/api/python.rst
+++ b/docs/api/python.rst
@@ -1,11 +1,15 @@
Python API Reference
====================
-High-level API
---------------
+High-level NumPy-native interface for computing transport and microstructural
+properties on segmented 3D voxel images. All functions listed below are
+re-exported at the top level of ``openimpala`` (e.g. ``oi.tortuosity(...)``)
+and operate identically across the compiled AMReX/HYPRE C++ backend (CPU and
+CUDA) and the pure-Python SciPy/CuPy solver.
-The recommended interface for most users. These functions accept NumPy arrays
-and return Python dataclasses.
+
+Transport & Phase Analysis
+--------------------------
.. autofunction:: openimpala.facade.volume_fraction
@@ -13,11 +17,46 @@ and return Python dataclasses.
.. autofunction:: openimpala.facade.tortuosity
+.. autofunction:: openimpala.facade.tortuosity_all
+
+.. autofunction:: openimpala.facade.effective_diffusivity
+
+
+Microstructural Characterisation
+--------------------------------
+
+.. autofunction:: openimpala.facade.specific_surface_area
+
+.. autofunction:: openimpala.facade.connected_components
+
+.. autofunction:: openimpala.facade.particle_size_distribution
+
+.. autofunction:: openimpala.facade.through_thickness_profile
+
+.. autofunction:: openimpala.facade.rev_study
+
+
+I/O, Diagnostics & Datasets
+---------------------------
+
.. autofunction:: openimpala.facade.read_image
+.. autofunction:: openimpala.facade.estimate_memory
+
+.. autofunction:: openimpala.facade.build_info
+
+Sample Datasets (``openimpala.datasets``)
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. automodule:: openimpala.datasets
+ :members: two_phase_stack, two_phase_cubic, sphere_pack, fetch_path
-Result types
-~~~~~~~~~~~~
+
+Result Dataclasses
+------------------
+
+All result objects are frozen Python dataclasses that render structured HTML
+summary tables automatically in Jupyter notebooks and MyST-NB documentation.
.. autoclass:: openimpala.facade.VolumeFractionResult
:members:
@@ -28,8 +67,26 @@ Result types
.. autoclass:: openimpala.facade.TortuosityResult
:members:
+.. autoclass:: openimpala.facade.EffectiveDiffusivityResult
+ :members:
+
+.. autoclass:: openimpala.facade.SpecificSurfaceAreaResult
+ :members:
+
+.. autoclass:: openimpala.facade.ConnectedComponentsResult
+ :members:
+
+.. autoclass:: openimpala.facade.ParticleSizeDistributionResult
+ :members:
+
+.. autoclass:: openimpala.facade.ThroughThicknessResult
+ :members:
+
+.. autoclass:: openimpala.facade.REVStudyResult
+ :members:
+
-Session management
+Session Management
------------------
.. autoclass:: openimpala.Session
diff --git a/docs/changelog.md b/docs/changelog.md
index 5727d94d..25305026 100644
--- a/docs/changelog.md
+++ b/docs/changelog.md
@@ -1,19 +1,39 @@
# Changelog
-## v4.0.0 (2026-03-29)
+## v4.6.0 (2026-04-17)
+
+Feature parity across the Python facade and C++ backends, full 3D field export,
+and multi-phase / non-cubic voxel support.
+
+- **3D solution and corrector fields** — `return_field=True` on `tortuosity()` (`result.solution_field`) and `return_fields=True` on `effective_diffusivity()` (`result.corrector_fields`)
+- **Python `effective_diffusivity()`** — full symmetric $3\times 3$ homogenisation tensor exposed in the high-level Python API across both C++ HYPRE and pure-Python solvers
+- **Multi-phase transport (`phase_diffusivities`)** — arbitrary per-phase conductivity/diffusivity dictionaries in `tortuosity()` and `effective_diffusivity()`
+- **Anisotropic & physical `voxel_size`** — scalar or `(dz, dy, dx)` voxel pitches propagated consistently through `tortuosity()`, `specific_surface_area()`, `particle_size_distribution()`, `through_thickness_profile()`, and `rev_study()`
+- **Complete microstructural suite in pure Python & C++** — `specific_surface_area` (with Cauchy–Crofton correction), `connected_components`, `particle_size_distribution`, `through_thickness_profile`, and `rev_study`
+
+See the [v4.6.0 release notes](https://github.com/BASE-Laboratory/OpenImpala/releases/tag/v4.6.0).
+
+## v4.5.0 (2026-04-17)
-Major release introducing GPU acceleration, a new matrix-free solver,
-comprehensive architectural refactoring, and expanded tutorials.
+Boundary-condition accuracy upgrade and universal PyPI wheel distribution.
+
+- **Exact half-cell harmonic Dirichlet BCs** — inlet and outlet boundary conditions enforced at outer voxel faces ($z = 0$ and $z = L$) across `TortuosityMLMG`, `TortuosityHypre`, and the pure-Python solver, eliminating the cell-centred $(N-1)/N$ discretisation offset and matching Voigt/Reuss laminates to machine precision
+- **`TortuosityMLMG` default fast path** — matrix-free AMReX geometric multigrid is now the default solver across CPU and CUDA backends
+- **Universal PyPI fallback wheel** — `pip install openimpala` provides pre-compiled AMReX/HYPRE wheels on Linux `x86_64` alongside a pure-Python SciPy/CuPy wheel for macOS, Windows, ARM64, and MPI-free environments
+
+See the [v4.5.0 release notes](https://github.com/BASE-Laboratory/OpenImpala/releases/tag/v4.5.0).
+
+## v4.0.0 (2026-03-29)
-### Highlights
+Major release introducing GPU acceleration, matrix-free geometric multigrid,
+and C++ kernel modernisation.
- **CUDA GPU acceleration** via `openimpala-cuda` PyPI package
-- **TortuosityMLMG solver** — matrix-free AMReX geometric multigrid
+- **`TortuosityMLMG` solver** — matrix-free AMReX geometric multigrid
- **Microstructural parameterisation engine** — SSA, REV study, PSD, connected components
-- **Fortran-to-C++ kernel migration** — all compute kernels now native C++ AMReX lambdas
-- **7-part tutorial series** with Google Colab support
+- **Fortran-to-C++ kernel migration** — all compute kernels native C++17 AMReX lambdas
-See the full [release notes on GitHub](https://github.com/BASE-Laboratory/OpenImpala/releases/tag/v4.0.0).
+See the [v4.0.0 release notes](https://github.com/BASE-Laboratory/OpenImpala/releases/tag/v4.0.0).
## v3.1.0 (2026-03-10)
diff --git a/docs/conf.py b/docs/conf.py
index 073bf280..545cade0 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -1,27 +1,43 @@
# Configuration file for the Sphinx documentation builder.
# https://www.sphinx-doc.org/en/master/usage/configuration.html
+from __future__ import annotations
+
import os
+from pathlib import Path
+import shutil
import sys
# -- Path setup ---------------------------------------------------------------
-# Add the Python package to sys.path so autodoc can find it.
-sys.path.insert(0, os.path.abspath(os.path.join("..", "python")))
+_DOCS_DIR = Path(__file__).resolve().parent
+_PYTHON_DIR = str((_DOCS_DIR.parent / "python").resolve())
+sys.path.insert(0, _PYTHON_DIR)
+os.environ["PYTHONPATH"] = (
+ f"{_PYTHON_DIR}{os.pathsep}{os.environ['PYTHONPATH']}"
+ if os.environ.get("PYTHONPATH")
+ else _PYTHON_DIR
+)
# -- Project information ------------------------------------------------------
project = "OpenImpala"
copyright = "2024-2026, BASE Laboratory, University of Greenwich"
author = "James Le Houx"
-# Version is read from pyproject.toml at build time; fallback for local builds.
try:
- from importlib.metadata import version as _version
+ from importlib.metadata import version as _pkg_version
- release = _version("openimpala")
+ release = _pkg_version("openimpala")
except Exception:
- release = "4.0.0"
+ release = "4.6.0"
version = ".".join(release.split(".")[:2])
+_DOXYGEN_XML_DIR = (_DOCS_DIR / "doxygen" / "xml").resolve()
+_HAS_DOXYGEN_XML = (_DOXYGEN_XML_DIR / "index.xml").is_file()
+if os.environ.get("OPENIMPALA_REQUIRE_DOXYGEN") == "1" and not _HAS_DOXYGEN_XML:
+ raise RuntimeError(
+ f"OPENIMPALA_REQUIRE_DOXYGEN=1, but Doxygen XML was not found at {_DOXYGEN_XML_DIR}"
+ )
+
# -- General configuration ----------------------------------------------------
extensions = [
"sphinx.ext.autodoc",
@@ -30,26 +46,43 @@
"sphinx.ext.intersphinx",
"sphinx.ext.viewcode",
"sphinx.ext.mathjax",
- "breathe",
- "myst_parser",
+ "myst_nb",
+ "sphinx_design",
+ "sphinx_copybutton",
]
+if _HAS_DOXYGEN_XML:
+ extensions.append("breathe")
-templates_path = ["_templates"]
-exclude_patterns = ["_build", "doxygen", "Thumbs.db", ".DS_Store"]
+templates_path = ["_templates"] if (_DOCS_DIR / "_templates").is_dir() else []
+exclude_patterns = [
+ "_build",
+ "doxygen",
+ "jupyter_execute",
+ "mainpage.md",
+ "Thumbs.db",
+ ".DS_Store",
+]
-# -- MyST (Markdown) settings -------------------------------------------------
+# -- MyST & MyST-NB settings --------------------------------------------------
myst_enable_extensions = [
+ "amsmath",
"colon_fence",
"deflist",
+ "dollarmath",
"fieldlist",
]
-source_suffix = {
- ".rst": "restructuredtext",
- ".md": "markdown",
-}
+
+nb_execution_mode = "cache"
+nb_execution_timeout = 180
+nb_execution_raise_on_error = True
+sd_card_legacy_separators = False
+
+# -- Copybutton settings ------------------------------------------------------
+copybutton_prompt_text = r">>> |\.\.\. |\$ "
+copybutton_prompt_is_regexp = True
# -- Breathe (Doxygen bridge) -------------------------------------------------
-breathe_projects = {"OpenImpala": os.path.abspath("doxygen/xml")}
+breathe_projects = {"OpenImpala": str(_DOXYGEN_XML_DIR)}
breathe_default_project = "OpenImpala"
# -- Autodoc settings ---------------------------------------------------------
@@ -57,31 +90,77 @@
autodoc_member_order = "bysource"
autodoc_typehints = "description"
-# -- Napoleon (Google/NumPy docstrings) ----------------------------------------
+# -- Napoleon (NumPy docstrings) ----------------------------------------------
napoleon_google_docstring = False
napoleon_numpy_docstring = True
napoleon_use_rtype = False
-# -- Intersphinx (cross-project links) ----------------------------------------
+# -- Intersphinx --------------------------------------------------------------
intersphinx_mapping = {
"python": ("https://docs.python.org/3", None),
"numpy": ("https://numpy.org/doc/stable/", None),
}
-# -- HTML output ---------------------------------------------------------------
-html_theme = "furo"
-html_title = "OpenImpala"
-html_static_path = ["_static"]
+# -- HTML output (PyData Sphinx Theme) ----------------------------------------
+html_theme = "pydata_sphinx_theme"
+html_title = f"OpenImpala {version}"
+html_static_path = ["_static"] if (_DOCS_DIR / "_static").is_dir() else []
html_theme_options = {
- "source_repository": "https://github.com/BASE-Laboratory/OpenImpala",
- "source_branch": "master",
- "source_directory": "docs/",
- "light_css_variables": {
- "color-brand-primary": "#2962FF",
- "color-brand-content": "#2962FF",
- },
+ "github_url": "https://github.com/BASE-Laboratory/OpenImpala",
+ "icon_links": [
+ {
+ "name": "PyPI",
+ "url": "https://pypi.org/project/openimpala/",
+ "icon": "fa-brands fa-python",
+ },
+ ],
+ "navbar_align": "left",
+ "header_links_before_dropdown": 6,
+ "show_toc_level": 2,
+ "navigation_with_keys": False,
}
-# -- Autosummary ---------------------------------------------------------------
+# -- Autosummary --------------------------------------------------------------
autosummary_generate = True
+
+
+def _sync_tutorials(_app) -> None:
+ """Copy canonical tutorials/*.ipynb into docs/tutorials/ before Sphinx reads sources."""
+ src_dir = _DOCS_DIR.parent / "tutorials"
+ dst_dir = _DOCS_DIR / "tutorials"
+ dst_dir.mkdir(parents=True, exist_ok=True)
+ for old_nb in dst_dir.glob("*.ipynb"):
+ old_nb.unlink()
+ for nb_path in sorted(src_dir.glob("0*.ipynb")):
+ shutil.copy2(nb_path, dst_dir / nb_path.name)
+
+
+def setup(app) -> None:
+ app.connect("builder-inited", _sync_tutorials)
+ if not _HAS_DOXYGEN_XML:
+ from docutils import nodes
+ from docutils.parsers.rst import Directive, directives
+
+ class _DoxygenPlaceholder(Directive):
+ required_arguments = 1
+ optional_arguments = 0
+ final_argument_whitespace = True
+ has_content = True
+ option_spec = {
+ "members": directives.flag,
+ "outline": directives.flag,
+ "project": directives.unchanged,
+ }
+
+ def run(self):
+ symbol = self.arguments[0]
+ para = nodes.paragraph()
+ para += nodes.literal(text=symbol)
+ para += nodes.Text(
+ " — run 'doxygen Doxyfile' before 'sphinx-build' to render full C++ signatures."
+ )
+ return [para]
+
+ app.add_directive("doxygenclass", _DoxygenPlaceholder)
+ app.add_directive("doxygenstruct", _DoxygenPlaceholder)
diff --git a/docs/contributing.md b/docs/contributing.md
index d1e6f2bd..8c4dd281 100644
--- a/docs/contributing.md
+++ b/docs/contributing.md
@@ -1,69 +1,81 @@
# Contributing
-Contributions to OpenImpala are welcome. This guide covers the development
-workflow and coding standards.
+Contributions to OpenImpala are welcome. This guide summarises the C++, Python,
+and documentation development workflows; see `CONTRIBUTING.md` in the
+repository root for issue reporting guidelines.
-## Development setup
+## Development Setup
+
+### Apptainer Container (C++ + MPI + HYPRE)
+
+The repository provides `containers/Singularity.deps.def` with all compiled
+dependencies pre-installed (AMReX, HYPRE, HDF5, libtiff, OpenMPI):
```bash
git clone https://github.com/BASE-Laboratory/OpenImpala.git
cd OpenImpala
git checkout -b my-feature
-# Build (inside the dependency container)
-apptainer exec --bind "$(pwd):/src" dependency_image.sif bash -c "cd /src && make all -j"
+# Build the dependency container once (~20 min)
+sudo apptainer build dependency_image.sif containers/Singularity.deps.def
-# Run tests
-apptainer exec --bind "$(pwd):/src" dependency_image.sif bash -c "cd /src && make test"
+# Configure and compile
+apptainer exec --bind "$(pwd):/src" dependency_image.sif \
+ bash -c "cd /src && cmake -B build && cmake --build build -j"
+
+# Run C++ Catch2 tests
+apptainer exec --bind "$(pwd):/src" dependency_image.sif \
+ bash -c "cd /src/build && ctest --output-on-failure"
```
-## Pull request workflow
+### Pure-Python Environment
-1. Fork the repository and create a feature branch
-2. Make your changes, ensuring tests pass
-3. Run `clang-format` on modified files
-4. Submit a pull request against `master`
+High-level Python API changes, solver tests, and documentation can be developed
+in a standard virtual environment without compiling C++ extensions:
-## Code style
+```bash
+python3 -m venv .venv
+source .venv/bin/activate
+pip install -e ".[docs]" pytest scipy tifffile h5py
+PYTHONPATH=python pytest python/tests/ -v
+```
+
+## Code Style
-- **C++17**, 100-column line limit, 4-space indentation
-- LLVM-based style enforced by `.clang-format`
-- All code in `namespace OpenImpala`
-- Headers use `#ifndef` include guards (not `#pragma once`)
-- Doxygen `@file` / `@brief` / `@param` comments on all public APIs
-- Fortran files are **not** processed by clang-format
+- **C++17**: 100-column line limit, 4-space indentation, enforced by `.clang-format` and `.clang-tidy`
+- All C++ declarations live in `namespace OpenImpala` and use `#ifndef` header guards
+- Doxygen `@file`, `@brief`, and `@param` comments on public C++ classes and functions
+- **Python**: PEP 8 with NumPy-style docstrings on all public functions in `python/openimpala/`
-### Formatting check
+### Formatting Check
```bash
-# Check formatting (CI runs this automatically)
find src/ tests/ python/bindings/ -type f \( -name "*.cpp" -o -name "*.H" \) \
| xargs clang-format --dry-run --Werror
-
-# Auto-format
-find src/ tests/ python/bindings/ -type f \( -name "*.cpp" -o -name "*.H" \) \
- | xargs clang-format -i
```
-## Testing
-
-- **C++ tests:** CTest with Catch2 (run via `ctest --output-on-failure`)
-- **Python tests:** pytest (`python -m pytest python/tests/`)
-- **Analytical benchmarks:** Uniform block, series layers, parallel layers with
- exact solutions
+## Building Documentation & Tutorials
-## Building documentation
+Tutorial notebooks in `tutorials/` are rendered directly into the Sphinx site
+via `myst-nb`:
```bash
-# Install doc dependencies
pip install -r docs/requirements.txt
-# Generate Doxygen XML (needed by Breathe)
-doxygen Doxyfile
+# Execute and refresh tutorial outputs in place
+PYTHONPATH="$(pwd)/python" jupyter nbconvert --to notebook --execute \
+ --ExecutePreprocessor.timeout=180 --inplace tutorials/0*.ipynb
-# Build Sphinx HTML
-sphinx-build -b html docs/ docs/_build/html
+# Generate Doxygen XML for C++ API pages
+doxygen Doxyfile
-# View locally
-open docs/_build/html/index.html
+# Build Sphinx HTML with warnings treated as errors
+PYTHONPATH="$(pwd)/python" sphinx-build -W --keep-going -b html docs/ docs/_build/html
```
+
+## Pull Request Workflow
+
+1. Fork the repository and create a feature branch from `master`.
+2. Add or update unit/analytical regression tests covering your change.
+3. Run `clang-format`, `pytest`, and `ctest` locally.
+4. Open a pull request against `master`.
diff --git a/docs/getting-started.md b/docs/getting-started.md
index 27ef3747..67db79ed 100644
--- a/docs/getting-started.md
+++ b/docs/getting-started.md
@@ -2,133 +2,106 @@
## Installation
-### Python (recommended)
-
-OpenImpala is available on PyPI — no compilation required.
+::::{tab-set}
+:::{tab-item} Linux (CPU + MPI)
```bash
pip install openimpala
```
-
-**GPU acceleration** is automatic. If you have an NVIDIA GPU and
-[CuPy](https://cupy.dev/) installed, OpenImpala detects it at runtime and
-offloads compute kernels to the GPU. No separate package is needed:
-
+On Linux `x86_64`, `openimpala` installs pre-built C++ bindings powered by AMReX and HYPRE. For multi-rank MPI execution from Python, also install an OpenMPI runtime and `mpi4py`:
```bash
-# Optional: install CuPy for automatic GPU acceleration
-pip install cupy-cuda12x # match your CUDA toolkit version
+pip install mpi4py
```
+:::
-If CuPy is not available, OpenImpala falls back to SciPy on the CPU.
-
-**Requirements:** Python 3.8+ and NumPy. Optional: `mpi4py` for MPI parallelism.
-
-#### Advanced / HPC: compiled HYPRE backend
-
-For HPC clusters that need the compiled C++ HYPRE solvers, a separate package
-is available:
-
+:::{tab-item} Linux (CUDA 12 GPU)
```bash
pip install openimpala-cuda
```
+`openimpala-cuda` is a drop-in replacement compiled with native CUDA 12 support for AMReX and HYPRE structured solvers (`sm_75` Turing or newer; pre-installed CUDA drivers on Google Colab and GPU cluster nodes work out of the box). Do not install `openimpala` and `openimpala-cuda` in the same virtual environment; both provide the `openimpala` import namespace.
+:::
-This package bundles AMReX + HYPRE compiled with CUDA and is a drop-in
-replacement for the pure-Python `openimpala` package. It requires a working
-NVIDIA CUDA 12 runtime (driver + toolkit) on the host, which is already
-present on Colab, Kaggle, and most GPU cluster nodes.
+:::{tab-item} macOS & Windows
+```bash
+pip install openimpala
+```
+On macOS (Apple Silicon and Intel), Windows, and Linux ARM64, `openimpala` installs a universal pure-Python wheel backed by NumPy and SciPy (with optional CuPy GPU acceleration if installed). Every function in the Python API accepts the same arguments and returns the same result dataclasses.
+:::
-### Container (HPC)
+:::{tab-item} HPC Container (Apptainer)
+Pre-built Apptainer (`.sif`) images are attached to each [GitHub Release](https://github.com/BASE-Laboratory/OpenImpala/releases):
+```bash
+wget https://github.com/BASE-Laboratory/OpenImpala/releases/download/v4.6.0/openimpala-v4.6.0.sif
-For HPC clusters, download the pre-built Apptainer/Singularity container from
-[GitHub Releases](https://github.com/BASE-Laboratory/OpenImpala/releases):
+apptainer exec -B "$(pwd):/data" openimpala-v4.6.0.sif \
+ /usr/bin/Diffusion /data/inputs
+```
+:::
-```bash
-# Download the latest .sif file (replace vX.Y.Z with the release tag)
-wget https://github.com/BASE-Laboratory/OpenImpala/releases/download/vX.Y.Z/openimpala-vX.Y.Z.sif
+:::{tab-item} From Source
+See {doc}`contributing` for containerised and native CMake builds against AMReX, HYPRE, HDF5, and `libtiff`.
+:::
-# Run interactively
-apptainer shell openimpala-vX.Y.Z.sif
+::::
-# Run a simulation
-apptainer exec openimpala-vX.Y.Z.sif /opt/OpenImpala/build/Diffusion3d inputs
-```
+Verify which backend is active at runtime with `oi.build_info()`:
-### From source (developers)
+```python
+import openimpala as oi
-```bash
-git clone https://github.com/BASE-Laboratory/OpenImpala.git
-cd OpenImpala
-mkdir build && cd build
-cmake .. -DCMAKE_BUILD_TYPE=Release \
- -DCMAKE_CXX_COMPILER=$(which mpicxx)
-make -j$(nproc)
-ctest --output-on-failure
+print(oi.build_info())
```
-Dependencies: AMReX, HYPRE, HDF5, LibTIFF. See the
-[README](https://github.com/BASE-Laboratory/OpenImpala#native-installation-advanced)
-for full details.
+## Five-Line Quickstart
-## Your first simulation
+OpenImpala ships sample segmented 3D datasets in `openimpala.datasets` so you can verify your installation immediately:
```python
-import numpy as np
import openimpala as oi
-# Create a simple porous medium (random 50/50 mix)
-data = np.random.choice([0, 1], size=(64, 64, 64), dtype=np.int32)
-
-with oi.Session():
- # Volume fraction
- vf = oi.volume_fraction(data, phase=1)
- print(f"Volume fraction: {vf.fraction:.4f}")
+vol = oi.datasets.two_phase_cubic() # (64, 64, 64) int32 array, (Nz, Ny, Nx)
+vf = oi.volume_fraction(vol, phase=1)
+perc = oi.percolation_check(vol, phase=1, direction="z")
+res = oi.tortuosity(vol, phase=1, direction="z", voxel_size=0.5e-6)
- # Percolation check
- perc = oi.percolation_check(data, phase=1, direction="z")
- print(f"Percolates: {perc.percolates}")
-
- # Tortuosity (only if phase percolates)
- if perc.percolates:
- result = oi.tortuosity(data, phase=1, direction="z")
- print(f"Tortuosity: {result.tortuosity:.4f}")
+print(f"eps = {vf.fraction:.4f}, tau_z = {res.tortuosity:.4f}, D_eff/D0 = {res.effective_diffusivity:.4f}")
```
-All computation happens inside the `oi.Session()` context manager, which
-manages the AMReX and MPI lifecycle.
+:::{note}
+**Session Lifecycle (`oi.Session`)**
+In interactive Python sessions and Jupyter notebooks, OpenImpala automatically starts a process-level session on the first API call and cleans up at interpreter exit. In multi-rank `mpirun` batch scripts, wrap your workflow in `with oi.Session():` so `AMReX::Finalize()` executes deterministically before `MPI_Finalize()`.
+:::
-## Working with real images
+## Reading 3D Image Files
-OpenImpala reads TIFF stacks, HDF5, and raw binary files:
+`oi.read_image()` reads 3D `.tif`/`.tiff` stacks, `.h5`/`.hdf5` datasets, `.raw` binary volumes, `.npy` arrays, and `.dat` grids—or you can pass a file path directly to any analysis function:
```python
import openimpala as oi
-with oi.Session():
- reader, img = oi.read_image("sample.tiff", threshold=128)
- result = oi.tortuosity(img, phase=1, direction="z")
-```
+tiff_path = oi.datasets.fetch_path("SampleData_2Phase_squared.tif")
-## Memory-safe workflows
+# Option 1: explicit reader handle (reusable across multiple analyses)
+_, img = oi.read_image(tiff_path, voxel_size=(0.5e-6, 0.5e-6, 0.5e-6))
+taus = oi.tortuosity_all(img, phase=1)
-For large datasets, free the Python array before solving:
+# Option 2: pass path directly
+ssa = oi.specific_surface_area(tiff_path, phase_a=0, phase_b=1, voxel_size=0.5e-6)
+```
-```python
-import gc
-import numpy as np
-import openimpala as oi
+For grayscale reconstructions, pass `threshold=128` to binarise (`pixel > threshold` maps to `1`, otherwise `0`).
-with oi.Session():
- arr = np.load("large_volume.npy")
- dataset = oi.core.VoxelImage.from_numpy(arr)
+## Estimating Memory Before Large Runs
- del arr
- gc.collect() # Free Python memory
+Before solving on large tomograms ($512^3$ and above), check peak host/device memory requirements with `oi.estimate_memory()`:
- result = oi.tortuosity(dataset, phase=1, direction="z")
+```python
+est = oi.estimate_memory((512, 512, 512), solver="mlmg", mpi_ranks=4)
+print(f"Estimated per-rank peak: {est['per_rank_gb']:.2f} GB")
```
-## Next steps
+## Next Steps
-- {doc}`user-guide/concepts` — Understand tortuosity, effective diffusivity, and the mathematics
-- {doc}`user-guide/solvers` — Choose the right solver for your problem
-- {doc}`tutorials/index` — Interactive Colab notebooks
+- {doc}`tutorials/index` — Work through the five executed tutorial notebooks
+- {doc}`user-guide/concepts` — Finite-volume discretisation, boundary conditions, and homogenisation theory
+- {doc}`user-guide/solvers` — Choosing between AMReX MLMG and HYPRE Krylov/multigrid solvers
diff --git a/docs/index.rst b/docs/index.rst
index d225d82f..b049a72e 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -1,76 +1,80 @@
-OpenImpala Documentation
-========================
+OpenImpala
+==========
-**OpenImpala** is a high-performance framework for computing effective transport
-properties (diffusivity, conductivity, tortuosity) directly on 3D voxel images
-of porous microstructures.
+**OpenImpala** computes effective transport properties—tortuosity factors, symmetric :math:`3 \times 3` effective diffusivity tensors, multi-phase effective conductivities, and stereological microstructure metrics—directly on 3D segmented voxel images from X-ray CT, FIB-SEM, or synthetic reconstructions.
-It solves steady-state transport equations on the voxel grid using finite
-differences, parallelised via MPI through the `AMReX `_
-library, with `HYPRE `_
-or AMReX MLMG for linear solves.
+Built on `AMReX `_ and `HYPRE `_, OpenImpala discretises steady-state conservation laws directly on the Cartesian voxel grid without unstructured mesh generation, scaling from interactive Python notebooks on a laptop to multi-node MPI + CUDA clusters.
-.. code-block:: python
+.. grid:: 1 2 2 2
+ :gutter: 3
- import numpy as np
- import openimpala as oi
+ .. grid-item-card:: Getting Started
+ :link: getting-started
+ :link-type: doc
- data = np.random.choice([0, 1], size=(64, 64, 64), dtype=np.int32)
+ Install pre-built wheels on Linux (CPU or CUDA 12), macOS, or Windows, load a 3D TIFF stack, and run your first tortuosity solve.
- with oi.Session():
- result = oi.tortuosity(data, phase=1, direction="z")
- print(f"Tortuosity: {result.tortuosity:.4f}")
+ .. grid-item-card:: Tutorials
+ :link: tutorials/index
+ :link-type: doc
-Install from PyPI
------------------
+ Five executed notebooks with full derivations, plots, and Google Colab launchers—from basic diffusion to :math:`3\times 3` homogenisation and REV convergence.
-.. code-block:: bash
+ .. grid-item-card:: User Guide
+ :link: user-guide/index
+ :link-type: doc
- pip install openimpala
+ Finite-volume discretisation, solver selection (AMReX MLMG vs. HYPRE), CUDA GPUs, MPI/SLURM clusters, ``ParmParse`` inputs, and ``yt`` plotfiles.
-GPU acceleration is automatic when `CuPy `_ is installed.
-For HPC clusters needing compiled HYPRE solvers, see ``openimpala-cuda`` in the
-:doc:`getting-started` guide.
+ .. grid-item-card:: API Reference
+ :link: api/index
+ :link-type: doc
-.. toctree::
- :maxdepth: 2
- :caption: Getting Started
+ Complete documentation for the ``openimpala`` Python facade, ``openimpala.datasets``, result dataclasses, and the underlying C++ classes.
- getting-started
+Quick Install & Example
+-----------------------
-.. toctree::
- :maxdepth: 2
- :caption: User Guide
+.. tab-set::
- user-guide/concepts
- user-guide/solvers
- user-guide/input-files
- user-guide/gpu
- user-guide/hpc
+ .. tab-item:: Linux / macOS / Windows (CPU)
-.. toctree::
- :maxdepth: 2
- :caption: Tutorials
+ .. code-block:: bash
- tutorials/index
+ pip install openimpala
-.. toctree::
- :maxdepth: 2
- :caption: API Reference
+ On Linux ``x86_64``, ``openimpala`` installs compiled AMReX + HYPRE C++ bindings (install OpenMPI for multi-rank execution). On macOS, Windows, and ARM64, it uses the built-in pure-Python SciPy solver with the identical API.
- api/python
- api/cpp
+ .. tab-item:: Linux (CUDA 12 GPU)
-.. toctree::
- :maxdepth: 1
- :caption: Development
+ .. code-block:: bash
- contributing
- changelog
+ pip install openimpala-cuda
+ Drop-in GPU package with AMReX ``ParallelFor`` and HYPRE structured multigrid compiled natively for NVIDIA Volta+ GPUs (``sm_75`` and newer).
-Indices and tables
-------------------
+ .. tab-item:: HPC Container (Apptainer)
-* :ref:`genindex`
-* :ref:`search`
+ .. code-block:: bash
+
+ apptainer exec -B "$(pwd):/data" openimpala-v4.6.0.sif \
+ /usr/bin/Diffusion /data/inputs
+
+.. code-block:: python
+
+ import openimpala as oi
+
+ vol = oi.datasets.two_phase_cubic() # (64, 64, 64) segmented porous medium
+ res = oi.tortuosity(vol, phase=1, direction="z")
+ print(f"Porosity: {res.active_volume_fraction:.4f}, Tortuosity: {res.tortuosity:.4f}")
+
+.. toctree::
+ :hidden:
+ :maxdepth: 2
+
+ getting-started
+ tutorials/index
+ user-guide/index
+ api/index
+ contributing
+ changelog
diff --git a/docs/requirements.txt b/docs/requirements.txt
index 07acf003..fdcdf7f7 100644
--- a/docs/requirements.txt
+++ b/docs/requirements.txt
@@ -1,5 +1,10 @@
sphinx>=7.0
-furo
-breathe
-myst-parser
-sphinx-autodoc-typehints
+pydata-sphinx-theme>=0.15
+myst-nb>=1.1
+sphinx-design>=0.5
+sphinx-copybutton>=0.5
+sphinx-autodoc-typehints>=2.0
+breathe>=4.35
+numpy>=1.22
+scipy>=1.9
+matplotlib>=3.7
diff --git a/docs/tutorials/index.md b/docs/tutorials/index.md
index 1dfdc108..d3780056 100644
--- a/docs/tutorials/index.md
+++ b/docs/tutorials/index.md
@@ -1,25 +1,91 @@
# Tutorials
-Interactive Jupyter notebooks that run directly in Google Colab — no local
-installation required.
+Each tutorial below is executed automatically during documentation builds—all tables, diagnostics, and Matplotlib figures reflect live `openimpala` outputs. Click any card to read the rendered notebook with full equations and outputs, or launch it interactively in Google Colab.
-## Tutorial series
+:::::{grid} 1 2 2 2
+:gutter: 3
-| # | Topic | Colab |
-|---|-------|-------|
-| 01 | [Hello OpenImpala](https://github.com/BASE-Laboratory/OpenImpala/blob/master/tutorials/01_hello_openimpala.ipynb) — Installation, first tortuosity calculation | [](https://colab.research.google.com/github/BASE-Laboratory/OpenImpala/blob/master/tutorials/01_hello_openimpala.ipynb) |
-| 02 | [Digital Twin with PyBaMM](https://github.com/BASE-Laboratory/OpenImpala/blob/master/tutorials/02_digital_twin.ipynb) — Battery electrode parameterisation | [](https://colab.research.google.com/github/BASE-Laboratory/OpenImpala/blob/master/tutorials/02_digital_twin.ipynb) |
-| 03 | [REV & Uncertainty](https://github.com/BASE-Laboratory/OpenImpala/blob/master/tutorials/03_rev_and_uncertainty.ipynb) — Representative volume element analysis | [](https://colab.research.google.com/github/BASE-Laboratory/OpenImpala/blob/master/tutorials/03_rev_and_uncertainty.ipynb) |
-| 04 | [Multi-Phase Transport](https://github.com/BASE-Laboratory/OpenImpala/blob/master/tutorials/04_multi_phase_transport.ipynb) — Heterogeneous media with multiple phases | [](https://colab.research.google.com/github/BASE-Laboratory/OpenImpala/blob/master/tutorials/04_multi_phase_transport.ipynb) |
-| 05 | [Surrogate Modelling](https://github.com/BASE-Laboratory/OpenImpala/blob/master/tutorials/05_surrogate_modelling.ipynb) — ML surrogates for transport properties | [](https://colab.research.google.com/github/BASE-Laboratory/OpenImpala/blob/master/tutorials/05_surrogate_modelling.ipynb) |
-| 06 | [Topology Optimisation](https://github.com/BASE-Laboratory/OpenImpala/blob/master/tutorials/06_topology_optimisation.ipynb) — Microstructure design | [](https://colab.research.google.com/github/BASE-Laboratory/OpenImpala/blob/master/tutorials/06_topology_optimisation.ipynb) |
-| 07 | [HPC Scaling](https://github.com/BASE-Laboratory/OpenImpala/blob/master/tutorials/07_hpc_scaling.ipynb) — Performance analysis and scaling behaviour | [](https://colab.research.google.com/github/BASE-Laboratory/OpenImpala/blob/master/tutorials/07_hpc_scaling.ipynb) |
+::::{grid-item-card} 01 — Steady-State Diffusion & 3D Fields
+:link: 01_getting_started
+:link-type: doc
-## Running locally
+Verify exact analytical slab transport ($\tau = 1$), load a 3D TIFF tomogram, check percolation, solve $\nabla \cdot (D_0 \nabla \phi) = 0$, and inspect 3D potential and local flux bottleneck maps.
-All tutorials can also run locally if you have OpenImpala installed:
+:::{card-footer}
+`tortuosity` · `volume_fraction` · `percolation_check` · `read_image`
+:::
+::::
+
+::::{grid-item-card} 02 — Microstructure Metrics & Non-Cubic Voxels
+:link: 02_microstructure_and_anisotropy
+:link-type: doc
+
+Verify the $2/3$ Cauchy–Crofton specific surface area correction against analytical spheres, extract connected components and particle radii, and evaluate directional tortuosity on non-cubic FIB-SEM voxels.
+
+:::{card-footer}
+`specific_surface_area` · `connected_components` · `particle_size_distribution` · `through_thickness_profile` · `tortuosity_all`
+:::
+::::
+
+::::{grid-item-card} 03 — Periodic Homogenisation & $3\times 3$ $\mathbf{D}_{\text{eff}}$
+:link: 03_homogenisation_tensor
+:link-type: doc
+
+Solve the periodic corrector cell problems on a tilted laminate to recover off-diagonal coupling ($D_{xz} = D_{zx}$) and principal transport axes, and compare periodic homogenisation with Dirichlet flow-through.
+
+:::{card-footer}
+`effective_diffusivity` · `corrector_fields` · `tortuosity_all`
+:::
+::::
+
+::::{grid-item-card} 04 — Multi-Phase Transport in Composite Media
+:link: 04_multiphase_transport
+:link-type: doc
+
+Benchmark harmonic interface conductances against exact Voigt and Reuss bounds, then model ionic bridging across nanoporous binder shells when primary macropores lose percolation.
+
+:::{card-footer}
+`phase_diffusivities` · `tortuosity` · `return_field=True`
+:::
+::::
+
+::::{grid-item-card} 05 — Representative Elementary Volume (REV)
+:link: 05_rev_and_uncertainty
+:link-type: doc
+
+Quantify scale convergence and spatial uncertainty across cubic subvolume windows $L \in [16, 64]$ voxels with bootstrap 95% confidence intervals and the 5% coefficient-of-variation criterion.
+
+:::{card-footer}
+`rev_study` · `REVStudyResult`
+:::
+::::
+
+:::::
+
+## Running Locally or on Google Colab
+
+| # | Notebook | Colab | Source |
+|---|----------|-------|--------|
+| 01 | {doc}`01_getting_started` | [](https://colab.research.google.com/github/BASE-Laboratory/OpenImpala/blob/master/tutorials/01_getting_started.ipynb) | [`01_getting_started.ipynb`](https://github.com/BASE-Laboratory/OpenImpala/blob/master/tutorials/01_getting_started.ipynb) |
+| 02 | {doc}`02_microstructure_and_anisotropy` | [](https://colab.research.google.com/github/BASE-Laboratory/OpenImpala/blob/master/tutorials/02_microstructure_and_anisotropy.ipynb) | [`02_microstructure_and_anisotropy.ipynb`](https://github.com/BASE-Laboratory/OpenImpala/blob/master/tutorials/02_microstructure_and_anisotropy.ipynb) |
+| 03 | {doc}`03_homogenisation_tensor` | [](https://colab.research.google.com/github/BASE-Laboratory/OpenImpala/blob/master/tutorials/03_homogenisation_tensor.ipynb) | [`03_homogenisation_tensor.ipynb`](https://github.com/BASE-Laboratory/OpenImpala/blob/master/tutorials/03_homogenisation_tensor.ipynb) |
+| 04 | {doc}`04_multiphase_transport` | [](https://colab.research.google.com/github/BASE-Laboratory/OpenImpala/blob/master/tutorials/04_multiphase_transport.ipynb) | [`04_multiphase_transport.ipynb`](https://github.com/BASE-Laboratory/OpenImpala/blob/master/tutorials/04_multiphase_transport.ipynb) |
+| 05 | {doc}`05_rev_and_uncertainty` | [](https://colab.research.google.com/github/BASE-Laboratory/OpenImpala/blob/master/tutorials/05_rev_and_uncertainty.ipynb) | [`05_rev_and_uncertainty.ipynb`](https://github.com/BASE-Laboratory/OpenImpala/blob/master/tutorials/05_rev_and_uncertainty.ipynb) |
+
+To run the notebooks locally:
```bash
pip install openimpala jupyter matplotlib
-jupyter notebook tutorials/01_hello_openimpala.ipynb
+jupyter lab tutorials/
+```
+
+```{toctree}
+:hidden:
+:maxdepth: 1
+
+01_getting_started
+02_microstructure_and_anisotropy
+03_homogenisation_tensor
+04_multiphase_transport
+05_rev_and_uncertainty
```
diff --git a/docs/user-guide/concepts.md b/docs/user-guide/concepts.md
index 9ad16478..66c3dd3a 100644
--- a/docs/user-guide/concepts.md
+++ b/docs/user-guide/concepts.md
@@ -1,77 +1,52 @@
-# Concepts
+# Mathematical Formulation
-## What OpenImpala computes
+OpenImpala discretises steady-state conservation equations directly on segmented 3D voxel grids using a cell-centred conservative finite-volume (7-point stencil) scheme.
-OpenImpala takes a **segmented 3D voxel image** (where each voxel is labelled
-with a phase ID) and computes **effective transport properties** by solving
-partial differential equations directly on the voxel grid.
+## Array and Coordinate Conventions
-### Phase data
+All 3D NumPy arrays ingested or returned by OpenImpala follow `(Nz, Ny, Nx)` memory layout (`z` = axis 0, `y` = axis 1, `x` = axis 2) to match multi-page TIFF stacks and HDF5 datasets:
-Images are segmented into integer phase IDs stored in an AMReX `iMultiFab`.
-Typically:
+- **Voxel spacing**: scalar `voxel_size=h` or anisotropic 3-tuple `voxel_size=(dz, dy, dx)`.
+- **Tensor and directional ordering**: `EffectiveDiffusivityResult.tensor` has rows and columns ordered `(x, y, z)`, i.e. index `(0, 1, 2)` corresponds to `(X, Y, Z)`.
-- **Phase 0** = pore / void
-- **Phase 1** = solid matrix
+## Steady-State Flow-Through Diffusion and Tortuosity
-This is configurable via the `phase` parameter. Multi-phase transport is
-supported: each phase can be assigned a different transport coefficient.
+Given a conducting domain $\Omega_p \subset [0, L_x] \times [0, L_y] \times [0, L_z]$ with local diffusivity $D(\mathbf{x}) > 0$ (and $D(\mathbf{x}) = 0$ in insulating solid cells), OpenImpala solves
-### Volume fraction
+$$-\nabla \cdot \bigl(D(\mathbf{x})\,\nabla \phi\bigr) = 0 \quad \text{in } \Omega_p,$$
-The simplest metric: the fraction of voxels belonging to a given phase.
+with zero-flux Neumann conditions ($\nabla \phi \cdot \mathbf{n} = 0$) on all internal solid walls and the four lateral domain faces. On the inlet and outlet faces normal to the transport direction $d \in \{x, y, z\}$, fixed potentials $\phi_{\text{lo}} = 0$ and $\phi_{\text{hi}} = 1$ are imposed at the **physical domain boundary** ($h_d / 2$ from the outermost cell centres), contributing half-cell boundary conductance $2 D_i A_d / h_d$.
-$$\varepsilon = \frac{N_{\text{phase}}}{N_{\text{total}}}$$
+:::{note}
+Because the Dirichlet potentials sit on the exterior cell faces rather than on the first and last cell centres, a uniform medium or straight parallel channel of arbitrary grid resolution $N$ yields the exact continuum values $D_{\text{eff}} / D_0 = \varepsilon$ and $\tau = 1$ to solver tolerance (prior to `v4.5.0`, cell-centred pinning introduced an $O(1/N)$ offset $\tau = (N-1)/N$).
+:::
-### Percolation
+Across interior faces separating cells $i$ and $j$, normal flux continuity requires the **harmonic-mean face diffusivity**
-Before solving transport equations, OpenImpala checks whether the target phase
-forms a **connected path** from inlet to outlet using a GPU-accelerated
-flood-fill algorithm. If the phase does not percolate, transport is zero.
+$$D_{i+1/2} = \begin{cases} \dfrac{2 D_i D_j}{D_i + D_j}, & D_i > 0 \text{ and } D_j > 0, \\[6pt] 0, & \text{otherwise.} \end{cases}$$
-### Tortuosity
+From the cross-sectionally averaged steady-state flux $J_d$, the effective diffusivity and tortuosity factor are
-Tortuosity quantifies how much a winding pore structure impedes transport
-compared to a straight channel. OpenImpala solves the steady-state diffusion
-equation:
+$$D_{\text{eff},d} = \frac{|J_d|\,L_d}{A_d\,|\phi_{\text{hi}} - \phi_{\text{lo}}|}, \qquad \tau_d = \frac{\varepsilon_{\text{active}}\,D_{\text{ref}}}{D_{\text{eff},d}},$$
-$$\nabla \cdot (D \nabla \phi) = 0$$
+where for single-phase runs $D_{\text{ref}} = 1$ so $\tau_d = \varepsilon / D_{\text{eff},d}$.
-with Dirichlet boundary conditions at inlet ($\phi = 0$) and outlet
-($\phi = 1$), and zero-flux Neumann conditions on lateral faces.
+## Periodic Homogenisation ($\mathbf{D}_{\text{eff}} \in \mathbb{R}^{3\times 3}$)
-The effective diffusivity is computed from the resulting flux:
+To capture full directional anisotropy—including off-diagonal cross-terms $D_{\text{eff},ij}$ when principal material axes are oblique to the image axes—`oi.effective_diffusivity()` solves three periodic unit-cell corrector problems on the 3-torus $Y$:
-$$D_{\text{eff}} = \frac{|\text{average flux}|}{\text{cross-section area} \times |\nabla\phi_{\text{imposed}}|}$$
+$$-\nabla \cdot \Bigl(D(\mathbf{x})\bigl(\mathbf{e}_k + \nabla \chi_k\bigr)\Bigr) = 0 \quad \text{in } Y, \qquad k \in \{x, y, z\}.$$
-Tortuosity is then:
+Using the same conservative harmonic face conductances $D_{i+1/2}^{(r)}$, the discrete cell-problem RHS at cell $\mathbf{i}$ is $(D_{\mathbf{i}+1/2}^{(k)} - D_{\mathbf{i}-1/2}^{(k)}) / h_k$, and the homogenised tensor is assembled from the periodic face fluxes:
-$$\tau = \frac{\varepsilon_{\text{active}}}{D_{\text{eff}}}$$
+$$D_{\text{eff},rc} = \frac{1}{N_{\text{total}}} \sum_{\mathbf{i} \in Y} D_{\mathbf{i}+1/2}^{(r)} \left(\delta_{rc} + \frac{\chi_c(\mathbf{i} + \mathbf{e}_r) - \chi_c(\mathbf{i})}{h_r}\right).$$
-where $\varepsilon_{\text{active}}$ is the volume fraction of the percolating
-(connected) phase.
+Because this discretisation corresponds to the inner product $\langle \mathbf{e}_r + \nabla_h \chi_r, \mathbf{e}_c + \nabla_h \chi_c \rangle_D$, the discrete tensor satisfies exact Onsager reciprocity ($D_{\text{eff},rc} = D_{\text{eff},cr}$), positive semi-definiteness, and discrete Wiener (Voigt/Reuss) bounds at every grid resolution.
-For a uniform medium on an $N$-cell grid, the discrete solution gives
-$D_{\text{eff}} = N/(N-1)$, so $\tau = (N-1)/N$.
+## Cauchy–Crofton Specific Surface Area
-### Effective diffusivity tensor
+Counting raw voxel faces between phase $a$ and phase $b$ yields the Manhattan surface area
-For anisotropic microstructures, the full effective diffusivity tensor
-$\mathbf{D}_{\text{eff}}$ is computed by solving the **cell problem** from
-homogenisation theory:
+$$S_V^{\text{raw}} = \frac{N_x h_y h_z + N_y h_x h_z + N_z h_x h_y}{N_{\text{total}}\,h_x h_y h_z}.$$
-$$\nabla_\xi \cdot \left( D \nabla_\xi \chi_k \right) = -\nabla_\xi \cdot \left( D \hat{e}_k \right)$$
-
-for corrector functions $\chi_k$ in each direction $k \in \{x, y, z\}$, with
-periodic boundary conditions. The tensor components are:
-
-$$D_{\text{eff},ij} = \frac{1}{|Y|} \int_Y D(\mathbf{x}) \left( \delta_{ij} + \frac{\partial \chi_j}{\partial x_i} \right) \, d\mathbf{x}$$
-
-### Face coefficients
-
-Inter-cell diffusivities use the **harmonic mean** of adjacent cell values:
-
-$$D_{\text{face}} = \frac{2 D_L D_R}{D_L + D_R}$$
-
-This is physically correct for resistances in series and ensures that a solid
-cell ($D = 0$) adjacent to a pore cell correctly blocks transport.
+For smooth isotropic interfaces, axis-aligned voxel staircasing inflates surface area by $3/2$. `oi.specific_surface_area()` returns both `ssa` ($S_V^{\text{raw}}$) and `ssa_corrected` ($\frac{2}{3} S_V^{\text{raw}}$, the three-line Cauchy–Crofton stereological estimator).
diff --git a/docs/user-guide/gpu.md b/docs/user-guide/gpu.md
index 525633e3..754ca815 100644
--- a/docs/user-guide/gpu.md
+++ b/docs/user-guide/gpu.md
@@ -1,78 +1,47 @@
-# GPU Acceleration
+# CUDA GPU Acceleration
-OpenImpala automatically accelerates computations on NVIDIA GPUs when
-[CuPy](https://cupy.dev/) is available. No code changes or separate packages
-are required for the default path.
+OpenImpala accelerates 3D PDE solves, percolation flood-fills, and microstructural reductions on NVIDIA GPUs primarily through the compiled **`openimpala-cuda`** wheel, which builds AMReX and HYPRE with native CUDA 12 device kernels.
-## Quick setup
+## Installing `openimpala-cuda` (Linux `x86_64`)
```bash
-pip install openimpala
-
-# Install CuPy for your CUDA toolkit version
-pip install cupy-cuda12x # CUDA 12.x
-# or
-pip install cupy-cuda11x # CUDA 11.x
+pip install openimpala-cuda
```
-When CuPy is detected, OpenImpala offloads solver kernels, flood fills, and
-flux integrations to the GPU. If CuPy is not installed, it falls back to
-SciPy on the CPU transparently.
+`openimpala-cuda` is a drop-in replacement for `openimpala` (both expose `import openimpala as oi`). Install **only one** of `openimpala` or `openimpala-cuda` in a given environment.
-## Verifying GPU support
-
-```python
-import openimpala as oi
-
-print(oi.backend()) # "cupy" if GPU is active, "scipy" otherwise
-```
+**Hardware & driver requirements:**
+- NVIDIA GPU with compute capability `sm_75` or newer (Turing T4/RTX 20-series, Ampere A100, Hopper H100, Ada L4/L40).
+- Linux `x86_64` with an NVIDIA driver supporting CUDA 12 (CUDA runtime libraries are pulled automatically via PyPI `nvidia-*-cu12` wheels).
-## Usage
+## Verifying GPU Detection
-No code changes are needed. The same Python scripts work on both CPU and GPU:
+Use `oi.build_info()` to confirm that the CUDA C++ backend is active and check how many GPU devices AMReX sees:
```python
import openimpala as oi
-import numpy as np
-
-data = np.random.choice([0, 1], size=(256, 256, 256), dtype=np.int32)
with oi.Session():
- result = oi.tortuosity(data, phase=1, direction="z")
+ info = oi.build_info()
+ print(info)
+ # {'backend': 'cpp', 'cuda_enabled': True, 'gpu_device_count': 1, ...}
```
-## What runs on GPU
-
-- Phase data lookup and coefficient field construction
-- Flood-fill percolation checks
-- Linear solver iterations
-- Solution extraction and flux integration
-- Through-thickness profile computation
-- Connected components labelling
-
-## Performance considerations
-
-- GPU acceleration provides the most benefit for large domains (>128^3)
-- For small problems, CPU may be faster due to kernel launch overhead
-- Data stays on the device throughout the solve to minimise transfers
+:::{note}
+`gpu_device_count` is queried from AMReX after runtime initialisation—call `oi.build_info()` inside `with oi.Session():` (or after your first solver call) to inspect the live device count.
+:::
-## Advanced / HPC: openimpala-cuda
+## GPU Memory Sizing
-For HPC clusters that need the compiled C++ HYPRE linear solvers with native
-CUDA support (AMReX + HYPRE compiled with CUDA), a separate package is
-available on PyPI:
+AMReX initializes its device arena lazily (`amrex.the_arena_init_size=0`) so OpenImpala coexists cleanly with other GPU libraries on shared GPUs (such as 15 GB Colab T4 instances). Use `oi.estimate_memory()` before running large volumes:
-```bash
-pip install openimpala-cuda
+```python
+est = oi.estimate_memory((512, 512, 512), solver="mlmg")
+print(f"Estimated peak memory: {est['total_gb']:.2f} GB")
```
-The `openimpala-cuda` package is a drop-in replacement for `openimpala` and
-provides:
+For single-GPU runs above $384^3$, prefer `solver="mlmg"` over HYPRE structured matrices—matrix-free geometric multigrid cuts device VRAM usage by roughly $3\times$.
-- HYPRE matrix assembly and linear solves on the GPU
-- AMReX `ParallelFor` kernel offloading
-- MPI + CUDA multi-GPU support
+## Pure-Python CuPy Fallback
-**Requirements for openimpala-cuda:**
-- NVIDIA GPU with compute capability 7.0+ (Volta or newer)
-- CUDA runtime libraries (typically provided by the NVIDIA driver)
+On platforms where `openimpala-cuda` is not installed and OpenImpala runs in pure-Python fallback mode (`info["backend"] == "pure-python"`), installing [CuPy](https://cupy.dev/) (`pip install cupy-cuda12x`) automatically offloads the pure-Python sparse Conjugate Gradient solver to the GPU. For production $256^3+$ workloads on Linux, `openimpala-cuda` is strongly preferred because multigrid preconditioning (`MLMG` / `PFMG`) scales as $O(N)$ iterations rather than $O(N^{4/3})$ for Jacobi-preconditioned CG.
diff --git a/docs/user-guide/hpc.md b/docs/user-guide/hpc.md
index 6b355d73..02d049d5 100644
--- a/docs/user-guide/hpc.md
+++ b/docs/user-guide/hpc.md
@@ -1,77 +1,69 @@
-# HPC Usage
+# MPI & HPC Clusters
-OpenImpala is designed for distributed-memory parallelism via MPI, making it
-suitable for large-scale simulations on HPC clusters.
+OpenImpala decomposes 3D voxel domains into distributed AMReX `BoxArray` patches across MPI ranks, combining MPI inter-rank halo exchanges with OpenMP host threading or multi-GPU CUDA execution.
-## Running with MPI
+## Multi-Rank Python Scripts (`mpi4py`)
-### Python
+Import and run the exact same `openimpala` facade under `mpirun` or `srun`. Always wrap multi-rank scripts in `with oi.Session():` so `amrex::Finalize()` runs cleanly before `MPI_Finalize()`, and guard console/file output on rank 0:
-```bash
-# Install mpi4py
-pip install openimpala mpi4py
+```python
+# hpc_tortuosity.py
+from mpi4py import MPI
+import openimpala as oi
-# Run on 4 MPI ranks
-mpirun -np 4 python my_script.py
-```
+comm = MPI.COMM_WORLD
-### C++ executable
+with oi.Session():
+ _, img = oi.read_image("electrode_1024cubed.tif", threshold=128, max_grid_size=128)
+ vf = oi.volume_fraction(img, phase=1)
+ res = oi.tortuosity(img, phase=1, direction="z", solver="mlmg")
-```bash
-mpirun -np 16 ./Diffusion3d inputs
+ if comm.Get_rank() == 0:
+ print(f"Porosity: {vf.fraction:.5f}")
+ print(f"Tortuosity: {res.tortuosity:.5f} ({res.iterations} MLMG iterations)")
```
-### Apptainer on a cluster
+Launch across MPI ranks:
```bash
-mpirun -np 16 apptainer exec openimpala-v4.0.0.sif /opt/OpenImpala/build/Diffusion3d inputs
+mpirun -np 16 python hpc_tortuosity.py
```
-## SLURM batch script
+:::{tip}
+Prefer `oi.read_image("volume.tif", ...)` over loading a full NumPy array on every rank—C++ `TiffReader` and `Hdf5Reader` populate distributed AMReX `iMultiFab` boxes without duplicating a multi-gigabyte Python array per rank.
+:::
+
+## Running the C++ Executable via Apptainer & SLURM
+
+Each GitHub Release provides a self-contained Apptainer image (`openimpala-v4.6.0.sif`) containing `/usr/bin/Diffusion` built with OpenMPI, OpenMP, AMReX, HYPRE, HDF5, and `libtiff`:
```bash
#!/bin/bash
#SBATCH --job-name=openimpala
#SBATCH --nodes=2
#SBATCH --ntasks-per-node=32
+#SBATCH --cpus-per-task=2
#SBATCH --time=02:00:00
#SBATCH --partition=compute
-module load mpi
-
-srun apptainer exec openimpala-v4.0.0.sif \
- /opt/OpenImpala/build/Diffusion3d inputs
-```
-
-## Domain decomposition
-
-AMReX decomposes the 3D domain into boxes distributed across MPI ranks. The
-`max_grid_size` parameter controls the maximum box size:
+module load openmpi apptainer
+export OMP_NUM_THREADS=${SLURM_CPUS_PER_TASK}
-```ini
-amr.max_grid_size = 64
+srun --mpi=pmix apptainer exec -B "${PWD}:/data" openimpala-v4.6.0.sif \
+ /usr/bin/Diffusion /data/inputs
```
-- **Smaller values** create more boxes, improving load balance across many ranks
-- **Larger values** reduce inter-rank communication but may cause load imbalance
-- Choose a power of 2 that evenly divides your domain dimensions
-
-## Scaling guidelines
-
-| Domain size | Recommended ranks | max_grid_size |
-|-------------|-------------------|---------------|
-| 128^3 | 1-4 | 64 |
-| 256^3 | 4-16 | 64 |
-| 512^3 | 16-64 | 64 |
-| 1024^3 | 64-256 | 128 |
-
-## Memory estimates
+## Tuning `max_grid_size`
-Approximate memory per rank for a tortuosity solve:
+AMReX subdivides an $(N_z, N_y, N_x)$ domain into cubic patches of at most `max_grid_size` voxels per side (`amr.max_grid_size` in input files, or `max_grid_size=` in Python):
-- Phase data: ~4 bytes/voxel (int32)
-- Solution field: ~8 bytes/voxel (float64)
-- HYPRE matrix: ~56 bytes/voxel (7-point stencil)
-- **Total: ~70 bytes/voxel**
+- **Too large** (e.g. `max_grid_size=512` on a $512^3$ volume with 16 ranks): produces only 1 box, leaving 15 MPI ranks idle.
+- **Too small** (e.g. `max_grid_size=16` on $512^3$): creates $32^3 = 32{,}768$ tiny boxes, inflating halo-exchange latency.
+- **Rule of thumb**: aim for 1–8 boxes per MPI rank (or 1–4 boxes per GPU), using powers of two that divide the domain size cleanly:
-For a 512^3 domain on 64 ranks: ~140 MB per rank.
+| Domain Size | Typical CPU Ranks | Recommended `max_grid_size` | Approx. Total Memory (`mlmg` / `hypre`) |
+|-------------|-------------------|-----------------------------|-----------------------------------------|
+| $128^3$ | 1–4 | `64` | 0.06 GB / 0.15 GB |
+| $256^3$ | 4–16 | `64` | 0.5 GB / 1.2 GB |
+| $512^3$ | 16–64 | `64` or `128` | 3.8 GB / 9.5 GB |
+| $1024^3$ | 64–256 | `128` | 30 GB / 75 GB |
diff --git a/docs/user-guide/index.md b/docs/user-guide/index.md
new file mode 100644
index 00000000..4c236c5b
--- /dev/null
+++ b/docs/user-guide/index.md
@@ -0,0 +1,62 @@
+# User Guide
+
+This section combines **Explanation** pages covering OpenImpala's mathematical discretisation and linear solvers with **How-To Guides** for GPU acceleration, distributed MPI/SLURM clusters, C++ `ParmParse` inputs, and out-of-core visualisation.
+
+::::{grid} 1 2 2 2
+:gutter: 3
+
+:::{grid-item-card} Mathematical Formulation
+:link: concepts
+:link-type: doc
+
+Voxel grid conventions `(Nz, Ny, Nx)`, half-cell harmonic Dirichlet BCs, periodic homogenisation cell problems, multi-phase conductances, and Cauchy–Crofton stereology.
+:::
+
+:::{grid-item-card} Linear Solvers
+:link: solvers
+:link-type: doc
+
+Memory and convergence trade-offs between matrix-free AMReX `MLMG` and HYPRE structured Krylov/multigrid solvers (`PCG`, `FlexGMRES`, `BiCGSTAB`, `SMG`, `PFMG`).
+:::
+
+:::{grid-item-card} CUDA GPU Acceleration
+:link: gpu
+:link-type: doc
+
+Running native AMReX + HYPRE CUDA kernels via `openimpala-cuda`, checking device visibility with `oi.build_info()`, and sizing GPU memory.
+:::
+
+:::{grid-item-card} MPI & HPC Clusters
+:link: hpc
+:link-type: doc
+
+Multi-rank Python (`mpi4py`) and C++ (`Diffusion`) execution, SLURM + Apptainer batch scripts, and `max_grid_size` domain decomposition tuning.
+:::
+
+:::{grid-item-card} C++ Input Files
+:link: input-files
+:link-type: doc
+
+Configuring standalone `/usr/bin/Diffusion` runs via AMReX `ParmParse` key-value files for batch HPC pipelines.
+:::
+
+:::{grid-item-card} Out-of-Core Plotfiles with `yt`
+:link: yt-plotfiles
+:link-type: doc
+
+Inspecting multi-gigabyte AMReX plotfiles (`plt_*`) lazily with `yt` when full 3D fields exceed workstation RAM.
+:::
+
+::::
+
+```{toctree}
+:hidden:
+:maxdepth: 2
+
+concepts
+solvers
+gpu
+hpc
+input-files
+yt-plotfiles
+```
diff --git a/docs/user-guide/input-files.md b/docs/user-guide/input-files.md
index 08465d56..68efa56d 100644
--- a/docs/user-guide/input-files.md
+++ b/docs/user-guide/input-files.md
@@ -1,79 +1,67 @@
-# Input Files
+# C++ Input Files
-When running OpenImpala from the command line (C++ executable), configuration
-is specified via AMReX `ParmParse` text files. The file is passed as the first
-argument:
+When running the standalone C++ driver (`Diffusion`, installed at `/usr/bin/Diffusion` inside the release container or `build/Diffusion` when built from source), simulation parameters are supplied via an AMReX `ParmParse` configuration file:
```bash
-./Diffusion3d inputs
+/usr/bin/Diffusion inputs
```
-## Example input file
+Any parameter can also be overridden on the command line after the filename:
+
+```bash
+/usr/bin/Diffusion inputs tortuosity.direction=2 amr.max_grid_size=128
+```
+
+## Example `inputs` File
```ini
# --- Image Input ---
-image.filename = microstructure.tiff
-image.threshold = 128
+image.filename = microstructure.tif
+image.threshold = 128
-# --- Solver Configuration ---
-tortuosity.direction = 2 # 0=X, 1=Y, 2=Z
-tortuosity.phase_id = 0 # Phase to solve for
-tortuosity.solver_type = PCG # PCG, FlexGMRES, GMRES, BiCGSTAB, SMG, PFMG
+# --- Transport Solver Configuration ---
+tortuosity.direction = 2 # 0 = X, 1 = Y, 2 = Z
+tortuosity.phase_id = 1 # Conducting phase label
+tortuosity.solver_type = PCG # PCG, FlexGMRES, GMRES, BiCGSTAB, SMG, PFMG
-# --- HYPRE Solver Parameters ---
-hypre.eps = 1.0e-9 # Convergence tolerance
-hypre.maxiter = 200 # Maximum iterations
+# --- HYPRE Convergence Controls ---
+hypre.eps = 1.0e-9
+hypre.maxiter = 500
-# --- AMReX Grid Configuration ---
-amr.max_grid_size = 64 # Box decomposition size
+# --- AMReX Domain Decomposition ---
+amr.max_grid_size = 64
# --- Output ---
-results.path = ./results # Output directory
-tortuosity.write_plotfile = false # Write AMReX plotfile of solution
-tortuosity.verbose = 1 # 0=silent, 1=basic, 2+=detailed
+results.path = ./results
+tortuosity.write_plotfile = false # Write AMReX plotfile directory (plt_*)
+tortuosity.verbose = 1 # 0 = silent, 1 = summary, 2 = detailed
```
-## Key parameters
-
-### Image input
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `image.filename` | string | Path to 3D image (TIFF, HDF5, RAW, DAT) |
-| `image.threshold` | float | Binarisation threshold value |
-| `image.hdf5_dataset` | string | HDF5 dataset path (default: `/data`) |
-
-### Solver
+## Multi-Phase Transport Parameters
-| Parameter | Type | Default | Description |
-|-----------|------|---------|-------------|
-| `tortuosity.direction` | int | 0 | Flow direction: 0=X, 1=Y, 2=Z |
-| `tortuosity.phase_id` | int | 0 | Phase ID of the conducting phase |
-| `tortuosity.solver_type` | string | PCG | HYPRE solver algorithm |
-| `tortuosity.vlo` | float | 0.0 | Dirichlet BC at inlet |
-| `tortuosity.vhi` | float | 1.0 | Dirichlet BC at outlet |
-
-### Multi-phase transport
+To solve composite conduction across multiple conducting phases, specify matching lists of phase IDs and diffusivities:
```ini
-tortuosity.active_phases = 0 2 # Phase IDs with non-zero D
-tortuosity.phase_diffusivities = 1.0 0.5 # Corresponding D values
+tortuosity.active_phases = 1 2
+tortuosity.phase_diffusivities = 1.0 0.15
```
-### Grid decomposition
+All unlisted phase IDs are treated as insulating ($D = 0$).
+
+## Key Parameter Reference
| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
-| `amr.max_grid_size` | int | 32 | Maximum box size for domain decomposition |
-
-Smaller values create more boxes (better MPI load balance); larger values
-reduce communication overhead. Powers of 2 that divide the domain dimensions
-evenly are recommended.
-
-## Output files
-
-| File | Description |
-|------|-------------|
-| `results.json` | Structured JSON with all computed properties |
-| `results.txt` | Human-readable summary |
-| `plt_*/` | AMReX plotfile (if `write_plotfile = true`) |
+| `image.filename` | string | — | Input volume path (`.tif`, `.tiff`, `.h5`, `.hdf5`, `.raw`, `.dat`) |
+| `image.threshold` | float | — | Optional grayscale binarisation threshold (`pixel > threshold` $\to 1$) |
+| `image.hdf5_dataset` | string | `/data` | Internal dataset path for HDF5 inputs |
+| `tortuosity.direction` | int | `0` | Transport direction (`0` = X, `1` = Y, `2` = Z) |
+| `tortuosity.phase_id` | int | `0` | Conducting phase ID (single-phase mode) |
+| `tortuosity.solver_type` | string | `PCG` | Linear solver (`PCG`, `FlexGMRES`, `GMRES`, `BiCGSTAB`, `SMG`, `PFMG`) |
+| `tortuosity.vlo` | float | `0.0` | Inlet face Dirichlet potential |
+| `tortuosity.vhi` | float | `1.0` | Outlet face Dirichlet potential |
+| `hypre.eps` | float | `1e-9` | Relative residual convergence tolerance |
+| `hypre.maxiter` | int | `200` | Maximum solver iterations |
+| `amr.max_grid_size` | int | `32` | Maximum AMReX patch edge length |
+| `results.path` | string | `.` | Output directory for JSON/text summaries and plotfiles |
+| `tortuosity.write_plotfile` | bool | `false` | Write distributed AMReX plotfile for `yt` / ParaView / VisIt |
diff --git a/docs/user-guide/solvers.md b/docs/user-guide/solvers.md
index b8f7825a..8fb83a69 100644
--- a/docs/user-guide/solvers.md
+++ b/docs/user-guide/solvers.md
@@ -1,71 +1,61 @@
-# Solvers
+# Linear Solvers
-OpenImpala provides two solver backends for computing tortuosity, plus a
-legacy solver retained for comparison.
+OpenImpala provides two compiled C++ multigrid solver families—matrix-free **AMReX MLMG** and **HYPRE** structured Krylov/multigrid solvers—plus a pure-Python **SciPy / CuPy** Jacobi-preconditioned Conjugate Gradient fallback for platforms without compiled C++ wheels.
-## HYPRE solvers (default)
+## AMReX MLMG (`solver="auto"` or `"mlmg"`)
-The primary backend uses [HYPRE](https://computing.llnl.gov/projects/hypre-scalable-linear-solvers-multigrid-methods)
-structured-grid solvers. Available algorithms:
+By default, `oi.tortuosity(..., solver="auto")` selects AMReX's matrix-free geometric multigrid solver (`MLABecLaplacian` + V-cycle multigrid):
-| Solver | Type | Best for | Python name |
-|--------|------|----------|-------------|
-| **PCG** | Krylov (CG) | Single-phase diffusion (SPD systems) | `"pcg"` or `"auto"` |
-| FlexGMRES | Krylov | Multi-phase, non-symmetric problems | `"flexgmres"` |
-| GMRES | Krylov | General sparse systems | `"gmres"` |
-| BiCGSTAB | Krylov | Non-symmetric, when GMRES stalls | `"bicgstab"` |
-| SMG | Multigrid | Small grids, direct-like convergence | `"smg"` |
-| PFMG | Multigrid | Large grids, low memory | `"pfmg"` |
-
-**Default:** `"auto"` selects PCG, which is optimal for the single-phase
-steady-state diffusion problem (the Laplacian with harmonic-mean face
-coefficients is symmetric positive-definite).
+- **Matrix-free**: evaluates the 7-point harmonic-face stencil on the fly without allocating a 7-band sparse matrix.
+- **~3x lower memory footprint**: requires roughly 24–30 bytes per voxel compared to ~70 bytes per voxel for HYPRE `StructMatrix`, enabling larger single-GPU and single-node volumes.
+- **CPU + CUDA native**: executes identical AMReX `ParallelFor` kernels across OpenMP threads and NVIDIA GPUs.
```python
-# Use the default (PCG)
-result = oi.tortuosity(data, phase=1, direction="z")
+import openimpala as oi
-# Explicitly choose a solver
-result = oi.tortuosity(data, phase=1, direction="z", solver="flexgmres")
+vol = oi.datasets.two_phase_cubic()
+res = oi.tortuosity(vol, phase=1, direction="z", solver="mlmg", mlmg_eps=1e-9)
```
-## AMReX MLMG solver
+## HYPRE Structured Solvers
-The matrix-free geometric multigrid solver uses AMReX's native
-`MLABecLaplacian` operator. Advantages:
+For extreme diffusivity contrasts ($\kappa \ll 10^{-2}$ in multi-phase media) or periodic homogenisation cell problems (`oi.effective_diffusivity()`), OpenImpala dispatches to [HYPRE](https://computing.llnl.gov/projects/hypre-scalable-linear-solvers-multigrid-methods)'s structured-grid Krylov solvers preconditioned by Semicoarsening Multigrid (`SMG`) or Pointwise Semicoarsening Multigrid (`PFMG`):
-- **No matrix assembly** — the operator is applied matrix-free
-- **Lower memory** — approximately 3x less than HYPRE's `StructMatrix`
-- **Faster setup** — no algebraic multigrid (AMG) construction
+| Python `solver=` | Algorithm | Preconditioner | Recommended Use Case |
+|------------------|-----------|----------------|----------------------|
+| `"mlmg"` / `"auto"` | AMReX geometric multigrid | Native V-cycle | Default fast path for `tortuosity()` (lowest memory) |
+| `"pcg"` | Conjugate Gradient | `"smg"` or `"pfmg"` | SPD flow-through diffusion on large MPI decompositions |
+| `"flexgmres"` | Flexible GMRES | `"smg"` or `"pfmg"` | Default for `effective_diffusivity()` and high-contrast multi-phase |
+| `"bicgstab"` | BiCGSTAB | `"smg"` or `"pfmg"` | Alternative Krylov solver when GMRES memory grows |
+| `"gmres"` | GMRES | `"smg"` or `"pfmg"` | General structured linear systems |
+| `"pfmg"` | Standalone PFMG | — | Fast pointwise multigrid on large regular grids |
+| `"smg"` | Standalone SMG | — | Highly anisotropic voxel aspect ratios ($h_z \gg h_x$) |
-Best for small-to-medium grids on shared-memory systems.
+Select the HYPRE preconditioner in `oi.tortuosity()` via `preconditioner="pfmg"` (lower memory, faster setup on GPUs) or `preconditioner="smg"` (stronger plane-smoothing on high-aspect-ratio grids):
```python
-result = oi.tortuosity(data, phase=1, direction="z", solver="mlmg")
+res = oi.tortuosity(
+ vol,
+ phase=1,
+ direction="z",
+ solver="pcg",
+ preconditioner="pfmg",
+)
```
-## When to use which
-
-| Scenario | Recommended solver |
-|----------|--------------------|
-| Quick desktop analysis (<256^3) | `"mlmg"` |
-| Single-phase, any size | `"auto"` (PCG) |
-| Multi-phase with varying D | `"flexgmres"` |
-| Large distributed MPI runs | `"pcg"` or `"pfmg"` |
-| Debugging / comparison | `"smg"` (most robust) |
+## Periodic Cell-Problem Solver (`oi.effective_diffusivity`)
-## Effective diffusivity tensor
+`oi.effective_diffusivity()` solves three periodic cell problems using HYPRE (`solver="flexgmres"` by default with `PFMG` preconditioning on the periodic structured grid):
-The `EffectiveDiffusivityHypre` solver uses the same HYPRE backends but solves
-the cell problem with periodic boundary conditions. This is accessed via the
-C++ API or the command-line interface, not yet exposed in the high-level
-Python facade.
+```python
+deff = oi.effective_diffusivity(vol, phase=1, solver="flexgmres")
+```
-## Solver parameters
+## Convergence Tolerances in C++ Input Files
-When using the C++ interface or input files, solver behaviour is controlled via:
+When running the standalone C++ `Diffusion` executable or tuning HYPRE via `ParmParse`:
-```
-hypre.eps = 1.0e-9 # Convergence tolerance
-hypre.maxiter = 200 # Maximum iterations
+```ini
+hypre.eps = 1.0e-9 # Relative residual convergence tolerance
+hypre.maxiter = 500 # Maximum Krylov iterations
```
diff --git a/docs/user-guide/yt-plotfiles.md b/docs/user-guide/yt-plotfiles.md
new file mode 100644
index 00000000..c4a77cdf
--- /dev/null
+++ b/docs/user-guide/yt-plotfiles.md
@@ -0,0 +1,73 @@
+# Out-of-Core Plotfiles with `yt`
+
+OpenImpala supports two ways to inspect 3D potential and corrector fields, depending on domain size:
+
+| Domain Scale | Recommended Approach | Memory Behaviour |
+|--------------|----------------------|------------------|
+| Up to ~$256^3$ ($\le 150\;\text{MB}$ per `float64` array) | `oi.tortuosity(..., return_field=True)` + NumPy / Matplotlib (see {doc}`../tutorials/01_getting_started`) | Materialises full `(Nz, Ny, Nx)` NumPy array on rank 0 |
+| $512^3$ to $2048^3+$ (multi-GB distributed HPC runs) | AMReX plotfiles (`write_plotfile = true`) + [`yt`](https://yt-project.org/) / ParaView | Parallel per-patch disk output; lazy out-of-core slice reading |
+
+## Writing an AMReX Plotfile
+
+In a C++ `Diffusion` input file, enable plotfile output:
+
+```ini
+results.path = ./results
+tortuosity.write_plotfile = true
+```
+
+Or from the low-level compiled C++ bindings in an MPI Python script without gathering the full 3D array onto rank 0:
+
+```python
+import openimpala as oi
+from openimpala import _core
+
+with oi.Session():
+ _, img = oi.read_image("large_tomogram.tif", max_grid_size=128)
+ solver = _core.TortuosityMLMG(
+ img,
+ phase_id=1,
+ direction=_core.Direction.Z,
+ results_path="./results",
+ verbose=1,
+ write_plotfile=True,
+ )
+ solver.solve()
+```
+
+AMReX writes a directory such as `./results/plt_tortuosity_z/` containing a `Header` file and per-rank binary `Level_0/Cell_D_*` patch files storing `"phi"` (potential) and `"phase"` (active mask).
+
+## Lazy Slicing and 1D Profiles with `yt`
+
+Install `yt` (`pip install openimpala[viz]`) to slice or profile multi-gigabyte AMReX plotfiles—`yt` reads only the `BoxArray` patches intersecting your slice plane:
+
+```python
+import yt
+
+ds = yt.load("results/plt_tortuosity_z")
+print("Available fields:", ds.field_list)
+
+# Render an out-of-core slice normal to Y through the domain centre
+slc = yt.SlicePlot(ds, "y", ("boxlib", "phi"))
+slc.set_cmap(("boxlib", "phi"), "viridis")
+slc.save("phi_slice_y.png")
+```
+
+To extract a fixed-resolution 2D NumPy buffer from an out-of-core slice for custom Matplotlib figures without loading the 3D grid:
+
+```python
+import matplotlib.pyplot as plt
+import numpy as np
+
+slice_obj = ds.slice("y", ds.domain_center[1])
+frb = slice_obj.to_frb(width=ds.domain_width[0], resolution=(512, 512))
+
+phi_2d = np.array(frb[("boxlib", "phi")])
+mask_2d = np.array(frb[("boxlib", "phase")])
+phi_masked = np.where(mask_2d > 0.5, phi_2d, np.nan)
+
+fig, ax = plt.subplots(figsize=(5, 4), dpi=120)
+im = ax.imshow(phi_masked, origin="lower", cmap="viridis", vmin=0.0, vmax=1.0)
+fig.colorbar(im, ax=ax, label=r"Potential $\phi$")
+plt.show()
+```
diff --git a/paper.md b/paper.md
index ed84bc68..d08e0746 100644
--- a/paper.md
+++ b/paper.md
@@ -59,7 +59,7 @@ with oi.Session():
print(f"Tortuosity: {result.tortuosity:.4f}")
```
-Compiled CPU wheels (`pip install openimpala`) and CUDA-accelerated GPU wheels (`pip install openimpala-cuda`) bundling the AMReX and HYPRE C++ solvers are distributed via PyPI. Interactive tutorial notebooks for Google Colab cover workflows from basic tortuosity computation to digital twin parameterisation with PyBaMM. Documentation is at . The test suite includes analytical regression benchmarks (uniform block, series layers / Reuss bound, parallel layers / Voigt bound) verified to machine precision, plus integration tests on real tomographic data via CTest; CI enforces `clang-format`, `clang-tidy`, and code coverage via Codecov.
+Compiled CPU wheels (`pip install openimpala`), CUDA-accelerated GPU wheels (`pip install openimpala-cuda`) bundling the AMReX and HYPRE C++ solvers, and a universal pure-Python fallback wheel are distributed via PyPI. Interactive tutorial notebooks rendered in the documentation and runnable on Google Colab cover workflows from basic tortuosity computation and analytical verification to full $3\times 3$ effective diffusivity tensors, multi-phase transport, and REV uncertainty analysis. Documentation is at . The test suite includes analytical regression benchmarks (uniform block, series layers / Reuss bound, parallel layers / Voigt bound) verified to machine precision, plus integration tests on real tomographic data via CTest; CI enforces `clang-format`, `clang-tidy`, and code coverage via Codecov.
# Acknowledgements
diff --git a/pyproject.toml b/pyproject.toml
index 8ad41057..725715df 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -12,7 +12,7 @@ dynamic = ["version"]
description = "Python bindings for OpenImpala — transport-property computation on 3-D voxel images"
readme = "README.md"
license = {text = "BSD-3-Clause"}
-requires-python = ">=3.8"
+requires-python = ">=3.9"
dependencies = [
"numpy",
"scipy>=1.7",
@@ -29,6 +29,13 @@ dependencies = [
# cuda-deps-end
]
+[project.urls]
+Homepage = "https://github.com/BASE-Laboratory/OpenImpala"
+Documentation = "https://base-laboratory.github.io/OpenImpala/"
+Repository = "https://github.com/BASE-Laboratory/OpenImpala"
+Issues = "https://github.com/BASE-Laboratory/OpenImpala/issues"
+Changelog = "https://base-laboratory.github.io/OpenImpala/changelog.html"
+
[project.optional-dependencies]
mpi = ["mpi4py"]
progress = ["tqdm"]
@@ -41,10 +48,13 @@ test = [
]
docs = [
"sphinx>=7.0",
- "furo",
- "breathe",
- "myst-parser",
- "sphinx-autodoc-typehints",
+ "pydata-sphinx-theme>=0.15",
+ "myst-nb>=1.1",
+ "sphinx-design>=0.5",
+ "sphinx-copybutton>=0.5",
+ "sphinx-autodoc-typehints>=2.0",
+ "breathe>=4.35",
+ "matplotlib>=3.7",
]
all = [
"mpi4py",
From 195b68df6ce3339d210a696e27617c141dc55474 Mon Sep 17 00:00:00 2001
From: James Le Houx <37665786+jameslehoux@users.noreply.github.com>
Date: Wed, 18 Nov 2026 10:24:10 +0000
Subject: [PATCH 4/5] style,ci: align clang-format with LLVM 21 and pure-Python
matrix with Ubuntu 26.04
---
.github/workflows/build-test.yml | 2 +-
src/props/DeffTensor.cpp | 4 ++--
src/props/TortuosityHypre.cpp | 4 ++--
src/props/TortuositySolverBase.cpp | 4 ++--
4 files changed, 7 insertions(+), 7 deletions(-)
diff --git a/.github/workflows/build-test.yml b/.github/workflows/build-test.yml
index f5564acb..38626e13 100644
--- a/.github/workflows/build-test.yml
+++ b/.github/workflows/build-test.yml
@@ -57,7 +57,7 @@ jobs:
strategy:
fail-fast: false
matrix:
- python-version: ["3.9", "3.11", "3.13"]
+ python-version: ["3.10", "3.11", "3.13"]
steps:
- name: Checkout repository
uses: actions/checkout@v4
diff --git a/src/props/DeffTensor.cpp b/src/props/DeffTensor.cpp
index 341681c2..22d919ff 100644
--- a/src/props/DeffTensor.cpp
+++ b/src/props/DeffTensor.cpp
@@ -85,8 +85,8 @@ void calculateDeffTensor(amrex::Real Deff_tensor[AMREX_SPACEDIM][AMREX_SPACEDIM]
reduce_op.eval(
bx, reduce_data,
[=] AMREX_GPU_DEVICE(int i, int j, int k) noexcept
- -> amrex::GpuTuple {
+ -> amrex::GpuTuple {
if (mask_arr(i, j, k, 0) != 1) {
return {0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0};
}
diff --git a/src/props/TortuosityHypre.cpp b/src/props/TortuosityHypre.cpp
index e818e11f..be9a0432 100644
--- a/src/props/TortuosityHypre.cpp
+++ b/src/props/TortuosityHypre.cpp
@@ -1307,7 +1307,7 @@ void OpenImpala::TortuosityHypre::global_fluxes() {
flux_reduce_op.eval(
lobox_face, flux_reduce_data,
[=] AMREX_GPU_DEVICE(int i, int j, int k) noexcept
- -> amrex::GpuTuple {
+ -> amrex::GpuTuple {
amrex::Real fxin = 0.0, cells_in = 0.0;
if (mask(i, j, k) == cell_active) {
cells_in = 1.0;
@@ -1332,7 +1332,7 @@ void OpenImpala::TortuosityHypre::global_fluxes() {
flux_reduce_op.eval(
hibox_face, flux_reduce_data,
[=] AMREX_GPU_DEVICE(int i, int j, int k) noexcept
- -> amrex::GpuTuple {
+ -> amrex::GpuTuple {
amrex::Real fxout = 0.0, cells_out = 0.0;
if (mask(i, j, k) == cell_active) {
cells_out = 1.0;
diff --git a/src/props/TortuositySolverBase.cpp b/src/props/TortuositySolverBase.cpp
index dfa21ef9..f7863235 100644
--- a/src/props/TortuositySolverBase.cpp
+++ b/src/props/TortuositySolverBase.cpp
@@ -346,7 +346,7 @@ void TortuositySolverBase::globalFluxes() {
if (!lobox_face.isEmpty()) {
flux_reduce_op.eval(lobox_face, flux_reduce_data,
[=] AMREX_GPU_DEVICE(int i, int j, int k) noexcept
- -> amrex::GpuTuple {
+ -> amrex::GpuTuple {
amrex::IntVect iv(i, j, k);
if (mask(iv) == cell_active) {
return {-2.0 * dc(iv) * (soln(iv) - vlo) / dxd, 0.0};
@@ -362,7 +362,7 @@ void TortuositySolverBase::globalFluxes() {
if (!hibox_face.isEmpty()) {
flux_reduce_op.eval(hibox_face, flux_reduce_data,
[=] AMREX_GPU_DEVICE(int i, int j, int k) noexcept
- -> amrex::GpuTuple {
+ -> amrex::GpuTuple {
amrex::IntVect iv(i, j, k);
if (mask(iv) == cell_active) {
return {0.0, -2.0 * dc(iv) * (vhi - soln(iv)) / dxd};
From 712fe9e5da5b4f8f00c6bb70da8ed41fa408ae96 Mon Sep 17 00:00:00 2001
From: James Le Houx <37665786+jameslehoux@users.noreply.github.com>
Date: Wed, 18 Nov 2026 10:46:46 +0000
Subject: [PATCH 5/5] ci,tests: unify C++ & Python Codecov reporting, fix wheel
install list, and expand I/O & CLI coverage
---
.github/workflows/build-test.yml | 78 ++++--
codecov.yml | 52 ++++
python/CMakeLists.txt | 6 +-
python/openimpala/facade.py | 52 +++-
python/tests/test_cli.py | 119 ++++++++-
python/tests/test_datasets_and_io.py | 355 +++++++++++++++++++++++++--
6 files changed, 620 insertions(+), 42 deletions(-)
create mode 100644 codecov.yml
diff --git a/.github/workflows/build-test.yml b/.github/workflows/build-test.yml
index 38626e13..d07a26b2 100644
--- a/.github/workflows/build-test.yml
+++ b/.github/workflows/build-test.yml
@@ -70,12 +70,26 @@ jobs:
- name: Install Python test dependencies
run: |
python -m pip install --upgrade pip
- python -m pip install pytest numpy "scipy>=1.7" tifffile h5py
+ python -m pip install pytest pytest-cov numpy "scipy>=1.7" tifffile h5py
- name: Run pure-Python test suite
env:
PYTHONPATH: ${{ github.workspace }}/python
- run: pytest python/tests/ -v --tb=short
+ run: |
+ pytest python/tests/ -v --tb=short \
+ --cov=openimpala \
+ --cov-report=xml:coverage-python-pure.xml \
+ --cov-report=term
+
+ - name: Upload pure-Python coverage to Codecov
+ if: matrix.python-version == '3.11'
+ uses: codecov/codecov-action@v5
+ with:
+ files: coverage-python-pure.xml
+ flags: python-pure
+ fail_ci_if_error: false
+ env:
+ CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}
static-analysis:
name: Static Analysis (clang-tidy)
@@ -287,8 +301,9 @@ jobs:
coverage:
name: Code Coverage
runs-on: ubuntu-latest
- if: github.event_name == 'pull_request'
+ if: github.event_name == 'pull_request' || (github.event_name == 'push' && github.ref == 'refs/heads/master') || github.event_name == 'workflow_dispatch'
permissions:
+ contents: read
pull-requests: write
steps:
@@ -314,57 +329,76 @@ jobs:
run: |
sudo apptainer build --force dependency_image.sif containers/Singularity.deps.def
- - name: Build with coverage and run tests
+ - name: Build with coverage and run C++ + Python tests
run: |
sudo apptainer exec \
--writable-tmpfs \
--bind $PWD:/src \
./dependency_image.sif \
bash -c '
+ set -euo pipefail
source /opt/rh/gcc-toolset-11/enable
+ export OMPI_ALLOW_RUN_AS_ROOT=1
+ export OMPI_ALLOW_RUN_AS_ROOT_CONFIRM=1
+
+ python3.11 -m pip install pytest-cov tifffile h5py
+
cd /src
- rm -rf cmake_build_cov && mkdir cmake_build_cov && cd cmake_build_cov
-
- # Changed cmake3 to cmake
+ rm -rf cmake_build_cov /src/python/openimpala/_core*.so
+ mkdir cmake_build_cov && cd cmake_build_cov
+
+ PYBIND11_DIR=$(python3.11 -m pybind11 --cmakedir)
cmake .. \
-DCMAKE_BUILD_TYPE=Debug \
-DCMAKE_C_COMPILER=$(which mpicc) \
-DCMAKE_CXX_COMPILER=$(which mpicxx) \
+ -DPython_EXECUTABLE=/usr/bin/python3.11 \
+ -Dpybind11_DIR=${PYBIND11_DIR} \
-DCMAKE_PREFIX_PATH="/opt/amrex/25.03;/opt/hypre/v2.32.0;/opt/hdf5/1.12.3;/opt/libtiff/4.6.0" \
-DBUILD_TESTING=ON \
+ -DOPENIMPALA_PYTHON=ON \
-DENABLE_COVERAGE=ON
-
+
make -j$(nproc)
- ctest --output-on-failure --timeout 300 || true
+ ctest --output-on-failure --timeout 300 -LE python
+
+ cd /src
+ PYTHONPATH=/src/python /usr/bin/python3.11 -m pytest python/tests/ \
+ -v --tb=short -p no:cacheprovider \
+ --cov=openimpala \
+ --cov-report=xml:/src/coverage-python-bindings.xml \
+ --cov-report=term
'
- - name: Generate coverage report
+ - name: Generate C++ coverage report
run: |
sudo apptainer exec \
--writable-tmpfs \
--bind $PWD:/src \
./dependency_image.sif \
bash -c '
+ set -euo pipefail
source /opt/rh/gcc-toolset-11/enable
-
- # Dropped the dnf install and used native python3.11 pip!
python3.11 -m pip install gcovr
-
+
cd /src
gcovr --root . \
--filter "src/" \
+ --filter "python/bindings/" \
--print-summary \
--gcov-ignore-parse-errors=suspicious_hits.warn_once_per_file \
--xml coverage.xml \
--txt coverage.txt \
cmake_build_cov/
+
+ rm -f /src/python/openimpala/_core*.so
'
- name: Generate summary
if: always()
run: |
if [ -f coverage.txt ]; then
- echo "## Code Coverage Report" >> $GITHUB_STEP_SUMMARY
+ echo "## Code Coverage Report (C++ Engine & Bindings)" >> $GITHUB_STEP_SUMMARY
echo "" >> $GITHUB_STEP_SUMMARY
echo '```' >> $GITHUB_STEP_SUMMARY
cat coverage.txt >> $GITHUB_STEP_SUMMARY
@@ -379,14 +413,26 @@ jobs:
path: |
coverage.xml
coverage.txt
+ coverage-python-bindings.xml
retention-days: 30
if-no-files-found: warn
- - name: Upload to Codecov
+ - name: Upload C++ coverage to Codecov
if: always()
uses: codecov/codecov-action@v5
with:
files: coverage.xml
+ flags: cpp
+ fail_ci_if_error: false
+ env:
+ CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}
+
+ - name: Upload Python (_core) coverage to Codecov
+ if: always()
+ uses: codecov/codecov-action@v5
+ with:
+ files: coverage-python-bindings.xml
+ flags: python-bindings
fail_ci_if_error: false
env:
CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}
@@ -414,7 +460,7 @@ jobs:
'```',
'',
'---',
- '*Generated by CI — coverage data from [gcovr](https://gcovr.com/)*',
+ '*Generated by CI — C++ & bindings coverage from [gcovr](https://gcovr.com/), Python coverage uploaded to [Codecov](https://codecov.io/gh/BASE-Laboratory/OpenImpala)*',
].join('\n');
const { data: comments } = await github.rest.issues.listComments({
diff --git a/codecov.yml b/codecov.yml
new file mode 100644
index 00000000..c7bd492f
--- /dev/null
+++ b/codecov.yml
@@ -0,0 +1,52 @@
+# Codecov configuration for OpenImpala (C++ engine, pybind11 bindings, and Python package)
+codecov:
+ require_ci_to_pass: true
+
+coverage:
+ precision: 1
+ round: down
+ range: "60...95"
+ status:
+ project:
+ default:
+ target: auto
+ threshold: 2%
+ patch:
+ default:
+ target: 70%
+ threshold: 5%
+ informational: true
+
+flags:
+ cpp:
+ paths:
+ - src/
+ - python/bindings/
+ carryforward: true
+ python-pure:
+ paths:
+ - python/openimpala/
+ carryforward: true
+ python-bindings:
+ paths:
+ - python/openimpala/
+ carryforward: true
+
+component_management:
+ individual_components:
+ - component_id: cpp_engine
+ name: C++ Engine & Bindings
+ paths:
+ - src/**
+ - python/bindings/**
+ - component_id: python_package
+ name: Python Package
+ paths:
+ - python/openimpala/**
+
+ignore:
+ - "tests/**"
+ - "python/tests/**"
+ - "benchmarks/**"
+ - "docs/**"
+ - "tutorials/**"
diff --git a/python/CMakeLists.txt b/python/CMakeLists.txt
index 7262846c..aaf38e62 100644
--- a/python/CMakeLists.txt
+++ b/python/CMakeLists.txt
@@ -89,6 +89,8 @@ install(FILES
openimpala/facade.py
openimpala/cli.py
openimpala/_solver.py
+ openimpala/_io.py
+ openimpala/datasets.py
DESTINATION openimpala
COMPONENT python
)
@@ -127,9 +129,11 @@ if(BUILD_TESTING)
)
endfunction()
- # --- Pure-Python tests (no compiled module needed) ---
+ # --- Dual-backend tests (run with either pure-Python or _core) ---
openimpala_add_pytest(pytest_cli
"${PYTHON_TEST_DIR}/test_cli.py")
+ openimpala_add_pytest(pytest_datasets_and_io
+ "${PYTHON_TEST_DIR}/test_datasets_and_io.py")
# --- Tests requiring _core module ---
openimpala_add_pytest(pytest_enums
diff --git a/python/openimpala/facade.py b/python/openimpala/facade.py
index a438c234..1b478ac8 100644
--- a/python/openimpala/facade.py
+++ b/python/openimpala/facade.py
@@ -1312,6 +1312,52 @@ def _detect_file_format(path_str: str, file_format: Optional[str]) -> str:
raise ValueError(f"Cannot auto-detect format for '{path_str}'. Set file_format explicitly.")
+_NUMPY_STR_TO_RAW_ENUM: dict[str, str] = {
+ "|u1": "UINT8",
+ "u1": "UINT8",
+ "|i1": "INT8",
+ "i1": "INT8",
+ "i2": "INT16_BE",
+ "u2": "UINT16_BE",
+ "i4": "INT32_BE",
+ "u4": "UINT32_BE",
+ "f4": "FLOAT32_BE",
+ "f8": "FLOAT64_BE",
+}
+
+
+def _coerce_core_raw_data_type(_core, raw_data_type):
+ """Map None, string names, or NumPy dtypes to ``_core.RawDataType``."""
+ if raw_data_type is None:
+ return _core.RawDataType.UINT8
+ if isinstance(raw_data_type, _core.RawDataType):
+ return raw_data_type
+ if isinstance(raw_data_type, str):
+ name = raw_data_type.strip().upper()
+ if name != "UNKNOWN" and hasattr(_core.RawDataType, name):
+ return getattr(_core.RawDataType, name)
+ try:
+ dt = np.dtype(raw_data_type)
+ except TypeError as exc:
+ raise ValueError(f"Unsupported raw_data_type: {raw_data_type!r}") from exc
+ enum_name = _NUMPY_STR_TO_RAW_ENUM.get(dt.str)
+ if enum_name is not None:
+ return getattr(_core.RawDataType, enum_name)
+ if isinstance(raw_data_type, np.dtype):
+ enum_name = _NUMPY_STR_TO_RAW_ENUM.get(raw_data_type.str)
+ if enum_name is not None:
+ return getattr(_core.RawDataType, enum_name)
+ raise ValueError(f"Unsupported raw_data_type: {raw_data_type!r}")
+
+
def read_image(
path: Union[str, os.PathLike],
threshold: float = 0.5,
@@ -1374,16 +1420,14 @@ def read_image(
return reader, pure_img
_core = _get_core()
-
- if raw_data_type is None:
- raw_data_type = _core.RawDataType.UINT8
+ core_raw_dt = _coerce_core_raw_data_type(_core, raw_data_type)
if fmt == "tiff":
reader = _core.TiffReader(path_str)
elif fmt == "hdf5":
reader = _core.HDF5Reader(path_str, hdf5_dataset)
elif fmt == "raw":
- reader = _core.RawReader(path_str, raw_width, raw_height, raw_depth, raw_data_type)
+ reader = _core.RawReader(path_str, raw_width, raw_height, raw_depth, core_raw_dt)
elif fmt == "dat":
reader = _core.DatReader(path_str)
else:
diff --git a/python/tests/test_cli.py b/python/tests/test_cli.py
index 4f7a0291..2fcad2b0 100644
--- a/python/tests/test_cli.py
+++ b/python/tests/test_cli.py
@@ -1,11 +1,46 @@
"""Tests for the CLI argument parser and command dispatch."""
import json
+import struct
+
+import numpy as np
import pytest
import openimpala as oi
-from openimpala.cli import _build_parser, _cmd_analyze
-from openimpala.facade import TortuosityResult, VolumeFractionResult
+from openimpala.cli import _build_parser, _cmd_analyze, main
+from openimpala.facade import PercolationResult, TortuosityResult, VolumeFractionResult
+
+
+def _write_tiny_tiff(path, vol: np.ndarray) -> None:
+ """Write a minimal uncompressed little-endian 3-D uint8 Classic TIFF."""
+ arr = np.ascontiguousarray(vol, dtype=" None:
+ """Write a dependency-free uncompressed little-endian 2-D or 3-D Classic TIFF."""
+ is_2d = vol.ndim == 2
+ arr = np.ascontiguousarray(vol[np.newaxis, :, :] if is_2d else vol)
+ dt = arr.dtype.newbyteorder("<")
+ arr = arr.astype(dt, copy=False)
+ nz, ny, nx = arr.shape
+ bps = dt.itemsize * 8
+ if dt.kind == "u":
+ sfmt = 1
+ elif dt.kind == "i":
+ sfmt = 2
+ elif dt.kind == "f":
+ sfmt = 3
+ else:
+ raise ValueError(f"Unsupported dtype {dt}")
+
+ chunks = [b"II" + struct.pack("i2"),
+ ("uint16_le", "u2"),
+ ("int32_le", "i4"),
+ ("uint32_le", "u4"),
+ ("float32_le", "f4"),
+ ("float64_le", "f8"),
+ ],
+ )
+ def test_read_image_raw_all_dtypes_and_endianness(self, tmp_path, raw_name, np_dt):
+ rng = np.random.default_rng(23)
+ mask = rng.integers(0, 2, size=(4, 6, 8), dtype=np.int32)
+ payload = (mask * 30 + 2).astype(np.dtype(np_dt))
+ raw_path = tmp_path / f"sample_{raw_name}.raw"
+ raw_path.write_bytes(payload.tobytes())
+
+ _, img = oi.read_image(
+ raw_path,
+ threshold=15.0,
+ raw_width=8,
+ raw_height=6,
+ raw_depth=4,
+ raw_data_type=raw_name,
+ )
+ np.testing.assert_array_equal(img.to_numpy(), mask)
+
+ def test_read_image_dat_npy_and_numpy_dtype_coercion(self, tmp_path):
rng = np.random.default_rng(11)
vol = rng.integers(0, 2, size=(6, 8, 10), dtype=np.int32)
@@ -88,34 +241,189 @@ def test_read_image_dat_raw_npy_and_hdf5(self, tmp_path):
_, img_dat = oi.read_image(dat_path, threshold=50)
np.testing.assert_array_equal(img_dat.to_numpy(), vol)
- # .raw (float32 LE)
- raw_path = tmp_path / "sample.raw"
+ # .raw with np.dtype object and explicit file_format override
+ raw_path = tmp_path / "sample.bin"
raw_path.write_bytes(vol.astype(" 1).astype(np.int32))
- # .hdf5
+ @pytest.mark.parametrize(
+ "dtype",
+ [np.uint8, np.int8, np.uint16, np.int16, np.uint32, np.int32, np.float32, np.float64],
+ )
+ def test_read_image_hdf5_all_numeric_dtypes(self, tmp_path, dtype):
h5py = pytest.importorskip("h5py")
- h5_path = oi.datasets.fetch_path("SampleData_2Phase_3d.hdf5")
- _, img_h5 = oi.read_image(h5_path, threshold=0.5, hdf5_dataset="image")
- assert img_h5.shape == (100, 100, 100)
+ rng = np.random.default_rng(31)
+ mask = rng.integers(0, 2, size=(5, 7, 9), dtype=np.int32)
+ scaled = (mask * 40 + 4).astype(dtype)
+
+ h5_path = tmp_path / f"vol_{np.dtype(dtype).name}.h5"
+ with h5py.File(h5_path, "w") as f:
+ ds = f.create_dataset("micro", data=scaled)
+ ds.attrs["material"] = "NMC811"
+ ds.attrs["porosity_target"] = float(0.4)
+ ds.attrs["scan_id"] = np.int32(42)
+
+ _, img = oi.read_image(h5_path, threshold=20.0, hdf5_dataset="micro")
+ np.testing.assert_array_equal(img.to_numpy(), mask)
+
+ # Canonical dataset check
+ canon_h5 = oi.datasets.fetch_path("SampleData_2Phase_3d.hdf5")
+ _, img_canon = oi.read_image(canon_h5, threshold=0.5, hdf5_dataset="image")
+ assert img_canon.shape == (100, 100, 100)
+
+ def test_core_cpp_readers_sequence_attributes_and_custom_thresholds(self, tmp_path):
+ """Exercise C++ pybind11 reader methods (sequence, attributes, custom threshold) when _core is built."""
+ if not _has_core():
+ pytest.skip("Compiled _core extension not present in pure-Python run")
+
+ Session.ensure_active()
+ import openimpala._core as _core
+
+ rng = np.random.default_rng(41)
+ mask = rng.integers(0, 2, size=(4, 6, 8), dtype=np.int32)
+
+ # 1. TiffReader: empty repr, 2-D slice sequence, metadata, and 4-arg custom threshold
+ empty_tiff = _core.TiffReader()
+ assert "no file loaded" in repr(empty_tiff)
+ for z in range(4):
+ _write_uncompressed_tiff(tmp_path / f"slice_{z:02d}.tif", (mask[z] * 100).astype(np.uint16))
+ seq_reader = _core.TiffReader(str(tmp_path / "slice_"), 4, 0, 2, ".tif")
+ assert seq_reader.is_read
+ assert (seq_reader.width, seq_reader.height, seq_reader.depth) == (8, 6, 4)
+ assert seq_reader.bits_per_sample == 16
+ assert seq_reader.samples_per_pixel == 1
+ assert "8x6x4" in repr(seq_reader)
+ custom_img = seq_reader.threshold(50.0, 7, 3, 16)
+ np.testing.assert_array_equal(custom_img.to_numpy(), np.where(mask == 1, 7, 3))
+ # 2. RawReader: empty repr, get_value(i, j, k), data_type, and 4-arg custom threshold
+ empty_raw = _core.RawReader()
+ assert "no file loaded" in repr(empty_raw)
+ raw_vals = np.arange(4 * 6 * 8, dtype=" 50.0, 9, 1))
-class TestTortuosityAllAndHtmlReprs:
+ # 3. DatReader: empty repr, get_raw_value(i, j, k), and 4-arg custom threshold
+ empty_dat = _core.DatReader()
+ assert "no file loaded" in repr(empty_dat)
+ dat_vals = np.arange(4 * 6 * 8, dtype=" 50, 5, 2))
+
+ # 4. HDF5Reader: attributes and 4-arg custom threshold (if h5py available to write fixture)
+ try:
+ import h5py
+ except ImportError:
+ return
+ h5_path = tmp_path / "attrs.h5"
+ with h5py.File(h5_path, "w") as f:
+ ds = f.create_dataset("vol", data=(mask * 20).astype(np.int16))
+ ds.attrs["sample"] = "electrode_A"
+ ds.attrs["voxel_um"] = np.float64(0.25)
+ ds.attrs["phase_id"] = np.int32(1)
+ empty_h5 = _core.HDF5Reader()
+ assert "no file loaded" in repr(empty_h5)
+ h5_reader = _core.HDF5Reader(str(h5_path), "vol")
+ assert "8x6x4" in repr(h5_reader)
+ assert h5_reader.get_attribute("sample") == "electrode_A"
+ assert "not found" in h5_reader.get_attribute("nonexistent").lower()
+ all_attrs = h5_reader.get_all_attributes()
+ assert all_attrs["sample"] == "electrode_A"
+ assert "voxel_um" in all_attrs and "phase_id" in all_attrs
+ h5_custom = h5_reader.threshold(10.0, 4, 0, 16)
+ np.testing.assert_array_equal(h5_custom.to_numpy(), np.where(mask == 1, 4, 0))
+
+ def test_pure_io_validation_and_helpers(self, tmp_path):
+ # PureVoxelImage & PureReader validation + protocol helpers
+ arr = np.ones((4, 5, 6), dtype=np.int32)
+ pimg = PureVoxelImage.from_numpy(arr, dx=0.5, dy=1.0, dz=2.0)
+ assert "6x5x4" in repr(pimg)
+ assert np.asarray(pimg, dtype=np.float32).dtype == np.float32
+ with pytest.raises(ValueError):
+ PureVoxelImage(np.ones((4, 5), dtype=np.int32))
+ with pytest.raises(ValueError):
+ PureVoxelImage(arr, dx=-1.0)
+
+ pread_2d = PureReader(np.array([[0, 10], [20, 30]], dtype=np.uint8), kind="SliceReader")
+ assert (pread_2d.depth, pread_2d.height, pread_2d.width) == (1, 2, 2)
+ assert "SliceReader 2x2x1" in repr(pread_2d)
+ np.testing.assert_array_equal(
+ pread_2d.threshold(15, 9, 2).to_numpy(),
+ np.array([[[2, 2], [9, 9]]], dtype=np.int32),
+ )
+ with pytest.raises(ValueError):
+ PureReader(np.ones((2, 2, 2, 2)))
+
+ # Malformed file errors in pure-Python readers
+ tiny = tmp_path / "tiny.tif"
+ tiny.write_bytes(b"short")
+ with pytest.raises(ValueError):
+ read_tiff_volume(tiny)
+
+ bad_hdr = tmp_path / "bad.tif"
+ bad_hdr.write_bytes(b"XX00112233")
+ with pytest.raises(ValueError):
+ read_tiff_volume(bad_hdr)
+
+ bad_dat = tmp_path / "short.dat"
+ bad_dat.write_bytes(b"1234")
+ with pytest.raises(ValueError):
+ read_dat_volume(bad_dat)
+
+ trunc_dat = tmp_path / "trunc.dat"
+ trunc_dat.write_bytes(struct.pack("") and html.endswith("")
+
+ mem = oi.estimate_memory((100, 100, 100), num_ranks=4)
+ assert mem["total_voxels"] == 1_000_000
+ assert mem["voxels_per_rank"] == 250_000
+ assert mem["num_ranks"] == 4
+
+ # Nested Session re-entrancy preserves active session state
+ with oi.Session():
+ with oi.Session():
+ assert oi.volume_fraction(vol, phase=1).fraction == pytest.approx(0.5)
+