Struct PounceOptions 

pub struct PounceOptions {
    pub universal: UniversalOptions,
    pub tol: Option<f64>,
    pub max_iter: Option<u32>,
    pub print_level: Option<u32>,
    pub mu_strategy: Option<MuStrategy>,
    pub algorithm: Option<PounceAlgorithm>,
    pub solver_selection: Option<PounceSolverSelection>,
    pub extra: Vec<(String, PounceOptionValue)>,
    /* private fields */
}

POUNCE-specific solver options.

For more information about POUNCE’s options, see the documented option reference.

Invalid option names or out-of-range values are reported by POUNCE and surface as a SolverError::Backend at solve time.

UniversalOptions mapping: time_limit -> max_cpu_time, verbose -> print_level 5 (else 0) and captures the iteration log into SolverResult::raw_log, threads is ignored.

Fields

universal: UniversalOptions

tol: Option<f64>

Desired convergence tolerance (tol).

max_iter: Option<u32>

Iteration limit (max_iter).

print_level: Option<u32>

Output verbosity 0–12 (print_level); overrides verbose.

mu_strategy: Option<MuStrategy>

Barrier parameter update strategy (mu_strategy).

algorithm: Option<PounceAlgorithm>

POUNCE’s general-NLP algorithm. Defaults to the interior-point method whenever structural routing selects the NLP engine.

solver_selection: Option<PounceSolverSelection>

Structural solver route. PounceSolverSelection::Auto is used when omitted and sends provably convex models to POUNCE’s specialized convex engines.

extra: Vec<(String, PounceOptionValue)>

Escape hatch: raw POUNCE options applied last.

Implementations

impl PounceOptions

pub fn mu_oracle(self, v: impl Into<String>) -> Self

Set the POUNCE mu_oracle option.

pub fn mu_init(self, v: f64) -> Self

Set the POUNCE mu_init option.

pub fn mu_min(self, v: f64) -> Self

Set the POUNCE mu_min option.

pub fn mu_max(self, v: f64) -> Self

Set the POUNCE mu_max option.

pub fn mu_max_fact(self, v: f64) -> Self

Set the POUNCE mu_max_fact option.

pub fn mu_target(self, v: f64) -> Self

Set the POUNCE mu_target option.

pub fn mu_linear_decrease_factor(self, v: f64) -> Self

Set the POUNCE mu_linear_decrease_factor option.

pub fn mu_superlinear_decrease_power(self, v: f64) -> Self

Set the POUNCE mu_superlinear_decrease_power option.

pub fn barrier_tol_factor(self, v: f64) -> Self

Set the POUNCE barrier_tol_factor option.

pub fn sigma_max(self, v: f64) -> Self

Set the POUNCE sigma_max option.

pub fn sigma_min(self, v: f64) -> Self

Set the POUNCE sigma_min option.

pub fn adaptive_mu_globalization(self, v: impl Into<String>) -> Self

Set the POUNCE adaptive_mu_globalization option.

pub fn quality_function_norm_type(self, v: impl Into<String>) -> Self

Set the POUNCE quality_function_norm_type option.

pub fn quality_function_centrality(self, v: impl Into<String>) -> Self

Set the POUNCE quality_function_centrality option.

pub fn quality_function_balancing_term(self, v: impl Into<String>) -> Self

Set the POUNCE quality_function_balancing_term option.

pub fn quality_function_max_section_steps(self, v: i32) -> Self

Set the POUNCE quality_function_max_section_steps option.

pub fn quality_function_section_sigma_tol(self, v: f64) -> Self

Set the POUNCE quality_function_section_sigma_tol option.

pub fn quality_function_section_qf_tol(self, v: f64) -> Self

Set the POUNCE quality_function_section_qf_tol option.

pub fn adaptive_mu_safeguard_factor(self, v: f64) -> Self

Set the POUNCE adaptive_mu_safeguard_factor option.

pub fn adaptive_mu_monotone_init_factor(self, v: f64) -> Self

Set the POUNCE adaptive_mu_monotone_init_factor option.

pub fn adaptive_mu_restore_previous_iterate(self, v: bool) -> Self

Set the POUNCE adaptive_mu_restore_previous_iterate option.

pub fn adaptive_mu_kkterror_red_iters(self, v: i32) -> Self

Set the POUNCE adaptive_mu_kkterror_red_iters option.

pub fn adaptive_mu_kkterror_red_fact(self, v: f64) -> Self

Set the POUNCE adaptive_mu_kkterror_red_fact option.

pub fn adaptive_mu_kkt_norm_type(self, v: impl Into<String>) -> Self

Set the POUNCE adaptive_mu_kkt_norm_type option.

pub fn l1_exact_penalty_barrier(self, v: bool) -> Self

Set the POUNCE l1_exact_penalty_barrier option.

pub fn l1_fallback_on_restoration_failure(self, v: bool) -> Self

Set the POUNCE l1_fallback_on_restoration_failure option.

pub fn l1_penalty_init(self, v: f64) -> Self

Set the POUNCE l1_penalty_init option.

pub fn l1_penalty_max(self, v: f64) -> Self

Set the POUNCE l1_penalty_max option.

pub fn l1_penalty_increase_factor(self, v: f64) -> Self

Set the POUNCE l1_penalty_increase_factor option.

pub fn l1_penalty_max_outer_iter(self, v: i32) -> Self

Set the POUNCE l1_penalty_max_outer_iter option.

pub fn l1_slack_tol(self, v: f64) -> Self

Set the POUNCE l1_slack_tol option.

pub fn l1_steering_factor(self, v: f64) -> Self

Set the POUNCE l1_steering_factor option.

pub fn presolve(self, v: bool) -> Self

Set the POUNCE presolve option.

pub fn presolve_bound_tightening(self, v: bool) -> Self

Set the POUNCE presolve_bound_tightening option.

pub fn presolve_redundant_constraint_removal(self, v: bool) -> Self

Set the POUNCE presolve_redundant_constraint_removal option.

pub fn presolve_linear_eq_reduction(self, v: bool) -> Self

Set the POUNCE presolve_linear_eq_reduction option.

pub fn presolve_licq_check(self, v: bool) -> Self

Set the POUNCE presolve_licq_check option.

pub fn presolve_licq_action(self, v: impl Into<String>) -> Self

Set the POUNCE presolve_licq_action option.

pub fn presolve_warm_z_bounds(self, v: bool) -> Self

Set the POUNCE presolve_warm_z_bounds option.

pub fn presolve_bound_mult_init_val(self, v: f64) -> Self

Set the POUNCE presolve_bound_mult_init_val option.

pub fn presolve_max_passes(self, v: i32) -> Self

Set the POUNCE presolve_max_passes option.

pub fn presolve_print_level(self, v: i32) -> Self

Set the POUNCE presolve_print_level option.

pub fn presolve_fbbt(self, v: bool) -> Self

Set the POUNCE presolve_fbbt option.

pub fn fbbt_tol(self, v: f64) -> Self

Set the POUNCE fbbt_tol option.

pub fn fbbt_max_iter(self, v: i32) -> Self

Set the POUNCE fbbt_max_iter option.

pub fn fbbt_max_constraints(self, v: i32) -> Self

Set the POUNCE fbbt_max_constraints option.

pub fn presolve_auxiliary(self, v: bool) -> Self

Set the POUNCE presolve_auxiliary option.

pub fn presolve_auxiliary_coupling(self, v: impl Into<String>) -> Self

Set the POUNCE presolve_auxiliary_coupling option.

pub fn presolve_auxiliary_tol(self, v: f64) -> Self

Set the POUNCE presolve_auxiliary_tol option.

pub fn presolve_auxiliary_max_block_dim(self, v: i32) -> Self

Set the POUNCE presolve_auxiliary_max_block_dim option.

pub fn presolve_auxiliary_wall_time_fraction(self, v: f64) -> Self

Set the POUNCE presolve_auxiliary_wall_time_fraction option.

pub fn presolve_auxiliary_diagnostics(self, v: bool) -> Self

Set the POUNCE presolve_auxiliary_diagnostics option.

pub fn linear_solver(self, v: impl Into<String>) -> Self

Set the POUNCE linear_solver option.

pub fn feral_ordering(self, v: impl Into<String>) -> Self

Set the POUNCE feral_ordering option.

pub fn feral_scaling(self, v: impl Into<String>) -> Self

Set the POUNCE feral_scaling option.

pub fn feral_pivtol(self, v: f64) -> Self

Set the POUNCE feral_pivtol option.

pub fn feral_refine(self, v: bool) -> Self

Set the POUNCE feral_refine option.

pub fn feral_cascade_break(self, v: bool) -> Self

Set the POUNCE feral_cascade_break option.

pub fn feral_fma(self, v: bool) -> Self

Set the POUNCE feral_fma option.

pub fn feral_singular_pivot_floor(self, v: f64) -> Self

Set the POUNCE feral_singular_pivot_floor option.

pub fn acceptable_progress_kappa(self, v: f64) -> Self

Set the POUNCE acceptable_progress_kappa option.

pub fn dual_inf_scale_kappa(self, v: f64) -> Self

Set the POUNCE dual_inf_scale_kappa option.

pub fn feral_inertia_pivot_floor(self, v: f64) -> Self

Set the POUNCE feral_inertia_pivot_floor option.

pub fn infeasibility_mu_strategy_retry(self, v: bool) -> Self

Set the POUNCE infeasibility_mu_strategy_retry option.

pub fn primal_noise_floor_kappa(self, v: f64) -> Self

Set the POUNCE primal_noise_floor_kappa option.

pub fn qp_tau_max(self, v: f64) -> Self

Set the POUNCE qp_tau_max option.

pub fn resto_decline_deferrals(self, v: i32) -> Self

Set the POUNCE resto_decline_deferrals option.

pub fn resto_decline_progress_ratio(self, v: f64) -> Self

Set the POUNCE resto_decline_progress_ratio option.

pub fn sqp_qp_max_schur_updates_before_refactor(self, v: i32) -> Self

Set the POUNCE sqp_qp_max_schur_updates_before_refactor option.

pub fn sqp_qp_use_homotopy(self, v: bool) -> Self

Set the POUNCE sqp_qp_use_homotopy option.

pub fn sqp_qp_use_schur_updates(self, v: bool) -> Self

Set the POUNCE sqp_qp_use_schur_updates option.

pub fn theta_max_adaptive_factor(self, v: f64) -> Self

Set the POUNCE theta_max_adaptive_factor option.

pub fn theta_max_adaptive_max_raises(self, v: i32) -> Self

Set the POUNCE theta_max_adaptive_max_raises option.

pub fn theta_max_adaptive_trigger(self, v: i32) -> Self

Set the POUNCE theta_max_adaptive_trigger option.

pub fn theta_max_row_scale_kappa(self, v: f64) -> Self

Set the POUNCE theta_max_row_scale_kappa option.

pub fn qp_presolve(self, v: bool) -> Self

Set the POUNCE qp_presolve option.

pub fn qp_tau(self, v: f64) -> Self

Set the POUNCE qp_tau option.

pub fn qp_reg(self, v: f64) -> Self

Set the POUNCE qp_reg option.

pub fn qp_infeas_tol(self, v: f64) -> Self

Set the POUNCE qp_infeas_tol option.

pub fn qp_hsde(self, v: bool) -> Self

Set the POUNCE qp_hsde option.

pub fn qp_equilibrate(self, v: bool) -> Self

Set the POUNCE qp_equilibrate option.

pub fn qp_crossover(self, v: bool) -> Self

Set the POUNCE qp_crossover option.

pub fn feral_infeasibility_scaling_retry(self, v: bool) -> Self

Set the POUNCE feral_infeasibility_scaling_retry option.

pub fn sqp_qp_max_iter(self, v: i32) -> Self

Set the POUNCE sqp_qp_max_iter option.

pub fn sqp_qp_feas_tol(self, v: f64) -> Self

Set the POUNCE sqp_qp_feas_tol option.

pub fn sqp_qp_opt_tol(self, v: f64) -> Self

Set the POUNCE sqp_qp_opt_tol option.

pub fn sqp_qp_elastic_gamma(self, v: f64) -> Self

Set the POUNCE sqp_qp_elastic_gamma option.

pub fn sqp_qp_anti_cycling(self, v: impl Into<String>) -> Self

Set the POUNCE sqp_qp_anti_cycling option.

pub fn tol(self, tol: f64) -> Self

pub fn max_iter(self, n: u32) -> Self

pub fn print_level(self, level: u32) -> Self

pub fn mu_strategy(self, s: MuStrategy) -> Self

pub fn algorithm(self, algorithm: PounceAlgorithm) -> Self

Select POUNCE’s top-level algorithm.

pub fn solver_selection(self, selection: PounceSolverSelection) -> Self

Select POUNCE’s structural solver route.

pub fn set( self, name: impl Into<String>, value: impl Into<PounceOptionValue>, ) -> Self

Set a raw POUNCE option by name (the escape hatch for anything not covered by a typed setter). Applied last, so it overrides the typed options. An unknown name or invalid value fails the solve.

Trait Implementations

impl Clone for PounceOptions

fn clone(&self) -> PounceOptions

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for PounceOptions

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for PounceOptions

fn default() -> PounceOptions

Returns the “default value” for a type.

impl HasUniversal for PounceOptions

fn universal(&self) -> &UniversalOptions

fn universal_mut(&mut self) -> &mut UniversalOptions

impl PartialEq for PounceOptions

fn eq(&self, other: &PounceOptions) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for PounceOptions