discreteTimeMss

Simulation object for a discrete-time mss model.

Source: src/simulator/@discreteTimeMss/discreteTimeMss.m

Description

discreteTimeMss is an mtiSimulator subclass that carries out the simulation of a discrete-time mss model (one with a non-zero timeStepSize). It is normally constructed by msim, which packs the model, the initial state, the input trajectory and the solver options into the object, runs the simulation in the constructor, and reads the results back from the time and variableTrajectory properties. Users are advised to call msim rather than build this object directly.

The model is the explicit multilinear state-space recursion

$$x_{k+1} = \Phi_F\, m(x_k, u_k), \qquad y_k = \Phi_G\, m(x_k, u_k),$$

with monomial vector $m$ over the signal vector $v=[x_k;\,u_k]$ and parameter split $\Phi=\Phi_c+\Phi_{+1}-\Phi_{-1}$. Since the successor state is given explicitly, each step is a single evaluation of the state equation — there is no implicit solve, no tearing and no binary enumeration. This is the structural difference to discreteTimeMdss, which must solve for $(x_{k+1}, y_k, z_k)$ at every sample and therefore carries the algebraic/binary guesses, the solving order and the event bookkeeping that have no counterpart in this case.

The constructor immediately calls simulate, which begins the recursion from $x_0$ over as many samples as inputTime has entries. Two evaluation paths exist:

• A CPNTensor model is compiled once into the MTISIM kernel form and the whole horizon is run inside the MEX kernel in a single call.
• Any other mtiTensor (e.g. TTTensor) is marched in a MATLAB loop, one call to computeFunctionValueMss per sample.

Both paths implement the same forward convention: input row $k$ drives the step from $x_k$ to $x_{k+1}$, so the last row of inputTrajectory is never used. The simulator does not resample: inputTime is expected to be spaced by the model’s timeStepSize, and it is copied to time unchanged.

Properties

Methods

See also

msim · mss · continuousTimeMss · discreteTimeMdss

MyToolbox Documentation | Generated automatically by CI/CD pipeline