@@ -76,14 +76,20 @@ order hold) between the samples, but linear interpolation will be added soon.
7676This transcription computes the predictions by calling the continuous-time model in the
7777equality constraint function and by using the implicit trapezoidal rule. It can handle
7878moderately stiff systems and is A-stable. However, it may not be as efficient as more
79- advanced collocation methods for highly stiff systems. Note that the stochastic model of the
80- unmeasured disturbances is strictly discrete-time, it is thus transcribed separately using
81- [`MultipleShooting`](@ref). Also note that the built-in [`StateEstimator`](@ref) will still
82- use the `solver` provided at the construction of the [`NonLinModel`](@ref) to estimate the
83- plant states, not the trapezoidal rule (see `supersample` option for stiff systems).
79+ advanced collocation methods for highly stiff systems. Note that the built-in [`StateEstimator`](@ref)
80+ will still use the `solver` provided at the construction of the [`NonLinModel`](@ref) to
81+ estimate the plant states, not the trapezoidal rule (see `supersample` option of
82+ [`RungeKutta`](@ref) for stiff systems). See Extended Help for more details.
8483
8584Sparse optimizers like `Ipopt` and sparse Jacobian computations are recommended for this
8685transcription method.
86+
87+ # Extended Help
88+ !!! details "Extended Help"
89+ Note that the stochastic model of the unmeasured disturbances is strictly discrete-time,
90+ as described in [`ModelPredictiveControl.init_estimstoch`](@ref). Collocation methods
91+ require continuous-time dynamics. Because of this, the stochastic states are transcribed
92+ separately using a [`MultipleShooting`](@ref) method.
8793"""
8894struct TrapezoidalCollocation <: CollocationMethod
8995 nc:: Int
0 commit comments