Skip to main content

topp3_lp_expert

Function topp3_lp_expert 

Source
pub fn topp3_lp_expert(
    problem: &Topp3Problem<'_>,
    options: &ClarabelOptions,
) -> Result<(Option<Topp3Profile>, DefaultSolution<f64>), CoppError>
Expand description

Expert TOPP3-LP API with full Clarabel solution exposure.

§Return contract

  • Ok((Some(result), solution)): status accepted by options.is_allow(solution.status).
  • Ok((None, solution)): solve finished but status not accepted.
  • Err(...): input/model/solver-construction runtime failures.

§Returns

Returns tuple (Option<Topp3Profile>, DefaultSolution<f64>) for diagnostics.

§Errors

Returns CoppError only for real build/runtime failures.

§Contract

  • caller handles None profile when status is not accepted;
  • acceptance policy is fully defined by options.is_allow. See ClarabelOptions::is_allow for a status-handling example.

§Verbosity behavior

Logging is layered by options.verbosity():

  • Silent: no algorithm logs;
  • Summary: lifecycle milestones and elapsed time;
  • Debug: assembly-level counters and stage summaries;
  • Trace: fine-grained stage deltas and solver snapshot diagnostics.