.TH "serif::solver::preconditioner::strategies::surface" 3 "Version v0.0.1a" "SERiF" \" -*- nroff -*- .ad l .nh .SH NAME serif::solver::preconditioner::strategies::surface .SH SYNOPSIS .br .PP .SS "Classes" .in +1c .ti -1c .RI "struct \fBCalibratedSurfaceMass\fP" .br .RI "Calibrate a signed multiple of the native reference mass diagonal with bounded deterministic probes\&. " .ti -1c .RI "struct \fBFittedSurfaceH1\fP" .br .RI "Fit a signed positive mass-plus-stiffness operator on a nodal stellar surface\&. " .ti -1c .RI "struct \fBReferenceSurfaceMass\fP" .br .RI "Use the native reference boundary mass without fitting candidate-dependent physical scales\&. " .ti -1c .RI "struct \fBSurfaceH1Fit\fP" .br .RI "Keep a positive backend operator while preserving the sign of the physical shape response\&. " .ti -1c .RI "struct \fBSurfaceH1Moments\fP" .br .RI "Accumulated inner products of mass, stiffness, and physical target actions\&. " .ti -1c .RI "struct \fBSurfaceMassFit\fP" .br .RI "Retain the scalar least-squares evidence and the signed surrogate and inverse multipliers\&. " .in -1c .SS "Enumerations" .in +1c .ti -1c .RI "enum class \fBCalibrationTarget\fP { \fBsurface_jacobian\fP, \fBmaterial_schur\fP }" .br .RI "Choose the physical shape response, with or without approximate material relaxation\&. " .ti -1c .RI "enum class \fBCalibrationObjective\fP { \fBoperator_action\fP, \fBright_preconditioned_action\fP }" .br .RI "Fit the shape operator itself, or its action after applying the reference mass inverse\&. " .in -1c .SS "Functions" .in +1c .ti -1c .RI "std::expected< \fBSurfaceMassFit\fP, \fBFailure\fP > \fBtry_fit_surface_mass\fP (double numerator, double denominator, \fBCalibrationObjective\fP objective)" .br .RI "Solve either scalar calibration objective without discarding the physical sign\&. " .ti -1c .RI "std::expected< \fBSurfaceH1Fit\fP, \fBFailure\fP > \fBtry_fit_surface_h1_coefficients\fP (const \fBSurfaceH1Moments\fP &moments, \fBFittedSurfaceH1\fP options={})" .br .RI "Solve the two signed constrained least-squares problems with positive mass and nonnegative stiffness\&. " .in -1c .SH "Enumeration Type Documentation" .PP .SS "enum class \fBserif::solver::preconditioner::strategies::surface::CalibrationObjective\fP\fR [strong]\fP" .PP Fit the shape operator itself, or its action after applying the reference mass inverse\&. .PP \fBEnumerator\fP .in +1c .TP \f(BIoperator_action \fP .TP \f(BIright_preconditioned_action \fP .SS "enum class \fBserif::solver::preconditioner::strategies::surface::CalibrationTarget\fP\fR [strong]\fP" .PP Choose the physical shape response, with or without approximate material relaxation\&. .PP \fBEnumerator\fP .in +1c .TP \f(BIsurface_jacobian \fP .TP \f(BImaterial_schur \fP .SH "Function Documentation" .PP .SS "std::expected< \fBSurfaceH1Fit\fP, \fBFailure\fP > serif::solver::preconditioner::strategies::surface::try_fit_surface_h1_coefficients (const \fBSurfaceH1Moments\fP & moments, \fBFittedSurfaceH1\fP options = \fR{}\fP)\fR [nodiscard]\fP" .PP Solve the two signed constrained least-squares problems with positive mass and nonnegative stiffness\&. Reject nonfinite moments before constructing the normalized Gram problem\&. .PP Compare a feasible positive backend operator against the signed physical target\&. .SS "std::expected< \fBSurfaceMassFit\fP, \fBFailure\fP > serif::solver::preconditioner::strategies::surface::try_fit_surface_mass (double numerator, double denominator, \fBCalibrationObjective\fP objective)\fR [nodiscard]\fP" .PP Solve either scalar calibration objective without discarding the physical sign\&. .SH "Author" .PP Generated automatically by Doxygen for SERiF from the source code\&.