param.Continuous

Create continuous parameter

Description

A continuous parameter is a numeric parameter that can take any value in a specified interval. The parameter can be scalar-valued or matrix-valued.

Typically, you use continuous parameters to create parametric models and to estimate or optimize tunable parameters in such models.

Creation

Create a continuous parameter object in one of the following ways.

• param.Continuous function.

• sdo.getParameterFromModel to create objects for parameters in a Simulink^® model.

Syntax

p = param.Continuous(name)

p = param.Continuous(name,value)

Description

p = param.Continuous(name) creates a param.Continuous object and sets the Name property. The remaining properties of the object have default values.

p = param.Continuous(name,value) sets the Name and Value properties.

Properties

Free — Flag to make parameter tunable

true (1) (default) | false (0)

Flag to make the parameter tunable, specified as true (1) or false (0).

• Specify true (1) to make the parameter tunable.

• Specify false (0) to make the parameter nontunable.

The dimension of this property must match the dimension of the Value property.

For matrix-valued parameters, you can:

• Fix individual matrix elements. For example, p.Free = [true false; false true] or p.Free([2 3]) = false.

• Use scalar expansion to fix all matrix elements. For example, p.Free = false.

Info — Parameter units and labels

structure

Parameter units and labels, specified as a structure array with fields Label and Unit.

The array dimension must match the dimension of the Value property.

Use this property to store parameter units and labels that describe the parameter. For example, p.Info(1,1).Unit = 'N/m'; or p.Info(1,1).Label = 'spring constant'.

The default value for both the Label and Unit fields is ''.

Maximum — Upper bound for parameter value

Inf (default) | scalar | matrix

Upper bound for the parameter value, specified as a scalar or matrix.

The dimension of this property must match the dimension of the Value property.

For matrix-valued parameters, you can:

• Specify upper bounds on individual matrix elements. For example, p.Maximum([1 4]) = 5.

• Use scalar expansion to set the upper bound for all matrix elements. For example, p.Maximum = 5.

Minimum — Lower bound for parameter value

–Inf (default) | scalar | matrix

Lower bound for the parameter value, specified as a scalar or matrix.

The dimension of this property must match the dimension of the Value property.

For matrix-valued parameters, you can:

• Specify lower bounds on individual matrix elements, for example, p.Minimum([1 4]) = -5.

• Use scalar expansion to set the lower bound for all matrix elements. For example, p.Minimum = -5.

Name — Parameter name

'' (default) | character vector | string

This property is read-only.

Set this property at object creation.

Scale — Scaling factor

1 (default) | scalar | matrix

Scaling factor for normalizing the parameter value, specified as a scalar or matrix.

The dimension of this property must match the dimension of the Value property.

For matrix-valued parameters, you can:

• Specify scaling for individual matrix elements. For example, p.Scale([1 4]) = 1.

• Use scalar expansion to set the scaling for all matrix elements. For example, p.Scale = 1.

Value — Parameter value

0 (default) | scalar | matrix

Parameter value, specified as a scalar or matrix.

Set the dimension of this property at object creation.

Object Functions

isreal

Determine if parameter value, minimum, and maximum are real

Examples

Construct Continuous Parameter

Construct a param.Continuous object and specify the maximum value.

p = param.Continuous('K',eye(2));
p.Maximum = 5;