LandSimulation{
    M <: ClimaLand.AbstractModel,
    T <: ClimaTimeSteppers.DistributedODEAlgorithm,
    UC,
    DI,
    RC,
    CA <: SciMLBase.CallbackSet,
    I <: SciMLBase.DEIntegrator,
}

the ClimaLand LandSimulation struct, which specifies

• the discrete set of equations to solve (defined by the model);
• the timestepping algorithm;
• user callbacks (passed as a tuple) to be executed at specific times in the simulations;
• the diagnostics to output (optional).

User callbacks are optional: examples currently include callbacks that estimate the time to solution and SYPD of the simulation as it runs, checkpoint the state, or check the solution for NaNs. Others can be added here.

Diagnostics are implemented as callbacks, and are also optional. However, a default is provided. diagnostics is expected to be a list of ClimaDiagnostics.ScheduledDiagnostics.

Finally, the private field requiredcallbacks consists of callbacks that are required for the simulation to run correctly. Currently, this includes the callbacks which update the atmospheric forcing and update the LAI using prescribed data.

step!(landsim::LandSimulation)

Advances the land simulation landsim forward in time by one step, updating landsim in place.

solve!(landsim::LandSimulation)

Advances the land simulation landsim forward from the initial to final time, updating landsim in place.