Skip to main content

topp3_socp_expert

Function topp3_socp_expert 

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

Expert TOPP3-SOCP 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<Copp3Result>, DefaultSolution<f64>) for diagnostic pipelines.

§Errors

Returns CoppError only for true build/runtime failures.

§Contract

  • caller handles None profile when status is not accepted;
  • acceptance policy is controlled by options.is_allow.

§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.