feat: oscillation scaling

[paveltomin]

an option to scale the solution changes when oscillations (on Newton iteration level) are detected:
oscillationScaling - 0 or 1 - enables the feature
oscillationScalingFactor - between 0 and 1 - scaling factor to be applied when oscillations are detected
oscillationCheckDepth - 2 or larger - how many iterations down the solution change history will be checked
oscillationTolerance - check tolerance, used both to trim-out small solution changes and to check that oscillatory changes are close to each other in magnitude
oscillationFraction - between 0 and 1 - fraction of total cells that have oscillations

[dkachuma]

Suggested change

	[&] GEOS_HOST ( localIndex const dof )
	[=] GEOS_HOST_DEVICE ( localIndex const dof )

[dkachuma]

Should also be less than 1?

[dkachuma]

I think we should also mpi sum numDofs here.

[dkachuma]

No need to populate of m_nonlinearSolverParameters.m_oscillationScaling is false.

[paveltomin]

@dkachuma all your comments should be fixed now, thanks

[paveltomin]

@dkachuma example how it helps a bit for dome case:

                oscillationScalingFactor="0.66"
                oscillationCheckDepth="2"

[tjb-ltk]

A unit test or integrated test to exercise the detection logic would be good. Ideally this could be exercised in isolation from a full simulation run, but this isn't always possible..

[paveltomin]

i enabled it for one example from integrated tests

[Copilot]

Pull Request Overview

This PR introduces oscillation detection and scaling functionality for Newton iteration levels in physics solvers. The feature helps stabilize convergence by automatically scaling solution changes when oscillatory behavior is detected.

Key changes include:

• Addition of oscillation detection logic with configurable parameters for scaling factor, check depth, tolerance, and fraction thresholds
• Integration of oscillation scaling into the solver hierarchy through proper base class method calls
• Update of solver scaling methods to utilize the new oscillation detection framework

Reviewed Changes

Copilot reviewed 9 out of 9 changed files in this pull request and generated 5 comments.

Show a summary per file

File	Description
PhysicsSolverBase.hpp	Adds oscillation detection method declaration and solution history storage
PhysicsSolverBase.cpp	Implements oscillation detection algorithm and integrates scaling logic into solution methods
NonlinearSolverParameters.hpp	Defines new oscillation-related configuration parameters
NonlinearSolverParameters.cpp	Implements parameter registration, validation, and display for oscillation settings
CompositionalMultiphaseBase.cpp	Updates methods to call parent class for proper oscillation handling
CompositionalMultiphaseFVM.cpp	Modifies scaling method to use base class oscillation detection
CoupledSolver.hpp	Updates scaling method to use base class implementation
LinearSolverParameters.cpp	Refactors table formatting for consistency
lockExchange_rho.xml	Adds example configuration with oscillation detection enabled

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}