Struct SolverBuilder

pub struct SolverBuilder { /* private fields */ }

Fluent builder for ThermalizationSolver.

Groups all configuration into a chainable API. The existing ThermalizationSolver::new() + manual field mutation still works; this is a convenience layer on top.

Implementations

impl SolverBuilder

pub fn grid(self, config: GridConfig) -> Self

Set the frequency grid configuration.

pub fn grid_fast(self) -> Self

Use the fast (500-point) grid for quick tests.

pub fn grid_production(self) -> Self

Use the production (4000-point) grid for high-accuracy runs.

pub fn injection(self, scenario: InjectionScenario) -> Self

Set the energy injection scenario.

pub fn initial_delta_n(self, delta_n: Vec<f64>) -> Self

Set an initial photon perturbation Δn(x).

pub fn z_range(self, z_start: f64, z_end: f64) -> Self

Set the redshift range (z_start, z_end).

pub fn solver_config(self, config: SolverConfig) -> Self

Set a complete solver config, overriding individual z/dy/dtau settings.

pub fn dy_max(self, val: f64) -> Self

Set the maximum Kompaneets step size.

pub fn dtau_max(self, val: f64) -> Self

Set the maximum Compton optical depth per step.

pub fn disable_dcbr(self) -> Self

Disable DC/BR processes (Kompaneets only).

pub fn split_dcbr(self) -> Self

Use operator-split DC/BR instead of coupled IMEX.

pub fn number_conserving(self) -> Self

Enable number-conserving T-shift subtraction (on by default).

pub fn no_number_conserving(self) -> Self

Disable number-conserving T-shift subtraction.

pub fn nc_z_min(self, val: f64) -> Self

Set the minimum redshift for number-conserving subtraction.

pub fn nc_stride(self, val: usize) -> Self

Set the NC stripping stride (strip every N steps).

pub fn dcbr_scale(self, val: f64) -> Self

Scale DC/BR emission rates by this factor (diagnostic).

pub fn max_newton_iter(self, val: usize) -> Self

Set the maximum number of Newton iterations per Kompaneets step.

pub fn no_auto_refine(self) -> Self

Disable automatic refinement zone insertion for photon injection scenarios.

pub fn build(self) -> Result<ThermalizationSolver, String>

Build the configured solver.

Validates all configuration (cosmology, grid, solver config, injection) before constructing the solver. Returns Err with a descriptive message if any parameter is invalid.