Documentation |
On this page… |
---|
Estimate Model With Selected Order in the App |
To estimate a state-space model, you must provide a value of its order, which represents the number of states. When you do not know the order, you can search and select an order using the following procedures.
You must have already imported your data into the app, as described in Represent Data.
To estimate model orders for a specific input delay:
In the System Identification app, select Estimate > State Space Models to open the State Space Models dialog box.
Select the Pick best value in the range option and specify a range in the adjacent field. The default range is 1:10.
(Optional) Expand Model Structure Configuration to specify additional attributes of the model structure when searching for best orders. Such attributes include disturbance component, input delays, presence of feedthrough, and parameterization.
Expand Estimation Options and verify that Subspace (N4SID) is selected as the Method.
Click Estimate.
This action opens the Model Order Selection window, which displays the relative measure of how much each state contributes to the input-output behavior of the model (log of singular values of the covariance matrix). The following figure shows an example plot.
Select the rectangle that represents the cutoff for the states on the left that provide a significant contribution to the input-output behavior.
In the previous figure, states 1 and 2 provide the most significant contribution. The contributions to the right of state 2 drop significantly. Click Insert to estimate a model with this order. Red indicates the recommended choice. For information about using the Model Order Selection window, see Using the Model Order Selection Window.
This action adds a new model to the Model Board in the System Identification app. The default name of the model is ss1. You can use this model as an initial guess for estimating other state-space models, as described in Estimate State-Space Models in System Identification App.
Click Close to close the window.
You can estimate a state-space model with selected order using n4sid, ssest or ssregest.
Use the following syntax to specify the range of model orders to try for a specific input delay:
m = n4sid(data,n1:n2);
where data is the estimation data set, n1 and n2 specify the range of orders.
The command opens the Model Order Selection window. For information about using this plot, see Using the Model Order Selection Window.
Alternatively, use ssest or ssregest:
m1 = ssest(data,nn) m2 = ssregest(data,nn)
where nn = [n1,n2,...,nN] specifies the vector or range of orders you want to try.
n4sid and ssregest estimate a model whose sample time matches that of data by default, hence a discrete-time model for time-domain data. ssest estimates a continuous-time model by default. You can change the default setting by including the Ts name-value pair input arguments in the estimation command. For example, to estimate a discrete-time model of optimal order, assuming Data.Ts>0, type:
model = ssest(data,nn,'Ts',data.Ts);
or
model = ssregest(data,nn,'Ts',data.Ts);
To automatically select the best order without opening the Model Order Selection window, type m = n4sid(data,'best'), m = ssest(data,'best') or m = ssregest(data,'best').
The following figure shows a sample Model Order Selection window.
You use this plot to decide which states provide a significant relative contribution to the input-output behavior, and which states provide the smallest contribution. Based on this plot, select the rectangle that represents the cutoff for the states on the left that provide a significant contribution to the input-output behavior. The recommended choice is shown in red. To learn how to generate this plot, see Estimate Model With Selected Order in the App or Estimate Model With Selected Order at the Command Line.
The horizontal axis corresponds to the model order n. The vertical axis, called Log of Singular values, shows the singular values of a covariance matrix constructed from the observed data.
For example, in the previous figure, states 1 and 2 provide the most significant contribution. However, the contributions of the states to the right of state 2 drop significantly. This sharp decrease in the log of the singular values after n=2 indicates that using two states is sufficient to get an accurate model.