perts = perturbations(array)
returns a table of all allowed perturbations perts defined for the
array. This table contains a list of all properties that can be
perturbed, the probability type of applied perturbation, and the parameters of the
probability type.
perts = perturbations(array,prop)
lets you view the current perturbation defined for the array property
prop.
perts = perturbations(array,prop,'None')
specifies that the property prop is not perturbed.
perts = perturbations(array,prop,'Normal',mean,sigma)
specifies that the perturbation is drawn from a normal probability distribution defined by
its mean and standard deviation sigma. To use this
syntax, set prop to 'ElementPositions',
'TaperMagnitude', or 'TaperPhase'.
perts = perturbations(array,prop,'Uniform',minval,maxval)
specifies that the perturbation is drawn from a uniform probability distribution with a
range defined by the interval [minval,maxval]. To
use this syntax, set prop to 'ElementPositions',
'TaperMagnitude', or 'TaperPhase'.
perts = perturbations(array,prop,'RandomFail',failprob)
specifies that the perturbation is a mask indicating whether an element is functioning based
on the element fail property failprob. To use this syntax, set prop to
'ElementFailure'.
Perturbed property of array, specified as 'ElementPosition',
'TaperMagnitude', 'TaperPhase', or
'ElementFailure'.
Example: 'TaperPhase'
Data Types: string
mean — Mean value of normal distribution scalar
Mean value of normal distribution, specified as a scalar. Units depend on the
property prop.
'ElementPosition'
meters
'TaperMagnitude'
dimensionless
'TaperPhase'
radians
Example: 12
Dependencies
To enable this argument, set the perturbed array property
prop to 'ElementPosition',
'TaperMagnitude', or 'TaperPhase' and the
perturbation type to 'Normal'.
Data Types: double
sigma — Standard deviation of normal distribution positive scalar
Standard deviation of normal distribution, specified as a positive scalar. Units
depend on the property prop.
'ElementPosition'
meters
'TaperMagnitude'
dimensionless
'TaperPhase'
radians
Example: 1.0
Dependencies
To enable this argument, set the perturbed array property
prop to 'ElementPosition',
'TaperMagnitude', or 'TaperPhase' and the
perturbation type to 'Normal'.
Data Types: double
minval — Minimum value of range of uniform probability distribution scalar
Minimum value of range of uniform probability distribution, specified as a scalar.
When applied to the 'TaperPhase' property. the difference between
minval and maxval should be less than or
equal to 2π. Units depend on the property prop.
'ElementPosition'
meters
'TaperMagnitude'
dimensionless
'TaperPhase'
radians
Example: 0
Dependencies
To enable this argument, set the perturbed array property
prop to 'ElementPosition',
'TaperMagnitude', or 'TaperPhase' and the
perturbation type to 'Uniform'.
Data Types: double
maxval — Maximum value of range of uniform probability distribution scalar
Maximum value of range of uniform probability distribution
Example: 1
Dependencies
Maximum value of range of uniform probability distribution, specified as a scalar.
When applied to the 'TaperPhase' property. the difference between
minval and maxval should be less than or
equal to 2π. Units depend on the property prop.
'ElementPosition'
meters
'TaperMagnitude'
dimensionless
'TaperPhase'
radians
Data Types: double
failprob — Probability of failure positive scalar
Probability of failure, specified as a non-negative scalar greater than or equal to
zero and less than one. Zero means that the elements will never fail. Otherwise, there
is a some probability of failure.
Example: 0.01
Dependencies
To enable this argument, set the array property prop to
'ElementFailure' and the perturbation type to
'RandomFail'.
You can perturb the array by selecting one of the properties to be
perturbed and then applying the type of perturbation. Each type of perturbation has specific
arguments.
Property
Perturbation Type
Arguments
'ElementPosition'
'None'
'Normal'
'Uniform'
-
mean, sigma
minval, maxval
'TaperMagnitude'
'None'
'Normal'
'Uniform'
-
mean, sigma
minval, maxval
'TaperPhase'
'None'
'Normal'
'Uniform'
-
mean, sigma
minval, maxval
'ElementFailure'
'None'
'RandomFail'
-
probfail
Extended Capabilities
C/C++ Code Generation Generate C and C++ code using MATLAB® Coder™.
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.