pub fn topp3_socp_expert(
problem: &Topp3Problem<'_>,
options: &ClarabelOptions,
) -> Result<(Option<Topp3Profile>, DefaultSolution<f64>), CoppError>Expand description
Expert TOPP3-SOCP API with full Clarabel solution exposure.
§Return contract
Ok((Some(result), solution)): status accepted byoptions.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 diagnostic pipelines.
§Errors
Returns CoppError only for true build/runtime failures.
§Contract
- caller handles
Noneprofile when status is not accepted; - acceptance policy is controlled by
options.is_allow. SeeClarabelOptions::is_allowfor a status-handling example.
§Verbosity behavior
Logging is layered by options.verbosity():