setDistribution

Set distribution of parameter in sdo.ParameterSpace object

Syntax

ps = setDistribution(ps0,p,pdist)


Description

ps = setDistribution(ps0,p,pdist) updates the ParameterDistributions property of the sdo.ParameterSpace object, ps0, for the specified parameters, p, and returns the updated object, ps.

Input Arguments

ps0 — Parameter space

sdo.ParameterSpace object

ParameterDistributions property of the sdo.ParameterSpace object.

p — Parameter to be updated

vector of param.Continuous objects | parameter name

Parameters whose distributions are to be updated, specified as one of the following:

• Vector of param.Continuous objects — Parameter objects. For example, p = sdo.getParameterFromModel('sdoHydraulicCylinder','Ac').

• Parameter name, specified as a character vector or string. For example, 'Ac'.

pdist — Probability distribution

vector of univariate probability distribution objects

Probability distribution for model parameters, specified as a vector of univariate probability distribution objects.

• If pdist is the same size as p, the software specifies each entry of pdist as the probability distribution of the corresponding parameter in p.

• If pdist contains only one distribution, the software specifies this object as the probability distribution for all the parameters in p.

Use the makedist command to create a univariate probability distribution object. For example, makedist('Normal','mu',10,'sigma',3).

To check if pdist is a univariate distribution object, run isa(pdist,'prob.UnivariateDistribution').

Output Arguments

ps — Updated parameter space

sdo.ParameterSpace object

Updated parameter space returned as a sdo.ParameterSpace object.

Examples

Set Distribution of Parameters in Parameter Space

Create an sdo.ParameterSpace object for the Ac and K parameters of sdoHydraulicCylinder model.

load_system('sdoHydraulicCylinder');
p = sdo.getParameterFromModel('sdoHydraulicCylinder',{'Ac','K'});
ps = sdo.ParameterSpace(p);

By default, a uniform distribution is specified for all parameters in p.

ps.ParameterDistributions

ans = 
  1x2 

Specify a normal distribution for Ac and K.

pAcdist = makedist('Normal','mu',p(1).Value,'sigma',1);
pKdist = makedist('Normal','mu',p(2).Value,'sigma',3);
ps = setDistribution(ps,p,[pAcdist;pKdist]);