Main Content

getData

Get current values of tunable-surface coefficients

Description

Kco = getData(K) extracts the current value of a tunable surface. K is a tunableSurface object that represents the parametric gain surface:

K(n(σ))=γ[K0+K1F1(n(σ))++KMFM(n(σ))],

where:

  • σ is a vector of scheduling variables.

  • n(σ) is a normalization function (see the Normalization property of tunableSurface).

  • γ is a scaling factor (see the Normalization property of tunableSurface).

  • F1,...,FM are basis functions.

  • K0,...,KM are tunable coefficients.

getData evaluates K at the current values of the coefficients K0,...,KM.

KcoJ = getData(K,J) extracts the current value of the coefficient of the Jth basis function FJ. Use J = 0 to get the constant coefficient K0.

Input Arguments

collapse all

Gain surface, specified as a tunableSurface object,

Index of basis function, specified as a nonnegative integer. To extract the constant coefficient K0, use J = 0.

Output Arguments

collapse all

Current coefficient values of the tunable surface, returned as an array.

If the tunable surface K is a scalar-valued gain, then the length of K is (M+1), where M is the number of basis functions in the parameterization. For example, if K represents the tunable gain surface:

K(α,V)=K0+K1α+K2V+K3αV,

then Kco is the 1-by-4 vector [K0,K1,K2,K3].

For array-valued gains, each coefficient expands to the I/O dimensions of the gain. These expanded coefficients are concatenated horizontally in Kco. (See tunableSurface.) For example, for a two-input, two-output gain surface, Kco has dimensions [2,2(M+1)].

Coefficient of the Jth basis function in the tunable surface parameterization, returned as a scalar or an array.

If the tunable surface K is a scalar-valued gain, then KcoJ is a scalar. If K is an array-valued gain, then KcoJ is an array that matches the I/O dimensions of the gain.

Introduced in R2015b