Documentation

This is machine translation

Translated by Microsoft
Mouseover text to see original. Click the button below to return to the English verison of the page.

Note: This page has been translated by MathWorks. Please click here
To view all translated materals including this page, select Japan from the country navigator on the bottom of this page.

getpvec

Model parameters and associated uncertainty data

Syntax

pvec = getpvec(sys)
[pvec,pvec_sd] = getpvec(sys)
[___] = getpvec(sys,'free')

Description

pvec = getpvec(sys) returns a vector, pvec, containing the values of all the parameters of the identified model sys.

[pvec,pvec_sd] = getpvec(sys) also returns the 1 standard deviation value of the uncertainty associated with the parameters of sys. If the model covariance information for sys is not available, pvec_sd is [].

[___] = getpvec(sys,'free') returns data for only the free parameters of sys, using any of the output arguments in previous syntaxes. For idnlarx and idnlhw models, all parameters are treated as free.

Input Arguments

sys

Identified model.

Identified model, specified as an idtf, idss, idgrey, idpoly, idproc, idnlarx, idnlhw, or idnlgrey model or an array of such models.

Output Arguments

pvec

Values of the parameters of sys.

If sys is an array of models, then pvec is a cell array with parameter value vectors corresponding to each model in sys. pvec is [] for idnlarx and idnlhw models that have not been estimated.

pvec_sd

1 standard deviation value of the parameters of sys.

If the model covariance information for sys is not available, pvec_sd is []. Thus, pvec_sd is always [] for idnlarx and idnlhw models because these models do not store parameter covariance information.

If sys is an array of models, then pvec_sd is a cell array with standard deviation vectors corresponding to each model in sys.

Examples

collapse all

Load the estimation data.

load iddata1 z1;

Estimate a transfer function model.

sys = tfest(z1,3);

Retrieve the parameter values from the estimated model.

pvec = getpvec(sys);

Load the estimation data

load iddata2 z2;

Estimate a state-space model.

sys = ssest(z2,3);

Retrieve the model parameters, pvec, and associated standard deviations, pvec_sd, from the estimated model.

[pvec,pvec_sd] = getpvec(sys);

Load the estimation data.

load iddata2 z2;

Estimate a state-space model.

sys = ssest(z2,3);

Retrieve the values of the free parameters from the estimated model.

pvec = getpvec(sys,'free');

Introduced in R2012a

Was this topic helpful?