get - Access model property values

Syntax

Description

Value = get(sys,'PropertyName') returns the current value of the property PropertyName of the model object sys. The string 'PropertyName' can be the full property name (for example, 'UserData') or any unambiguous case-insensitive abbreviation (for example, 'user'). See reference pages for the individual model object types for a list of properties available for that model.

Struct = get(sys) converts the TF, SS, or ZPK object sys into a standard MATLAB structure with the property names as field names and the property values as field values.

Without left-side argument,

get(sys)

displays all properties of sys and their values.

Examples

Consider the discrete-time SISO transfer function defined by

h = tf(1,[1 2],0.1,'inputname','voltage','user','hello')

You can display all properties of h with

get(h)
           num: {[0 1]}     
           den: {[1 2]}     
       ioDelay: 0           
      Variable: 'z'         
            Ts: 0.1         
    InputDelay: 0           
   OutputDelay: 0           
     InputName: {'voltage'} 
    OutputName: {''}        
    InputGroup: [1x1 struct]
   OutputGroup: [1x1 struct]
          Name: ''          
         Notes: {}          
      UserData: 'hello' 

or query only about the numerator and sample time values by

get(h,'num')

ans = 
    [1x2 double]

and

get(h,'ts')

ans =
    0.1000

Because the numerator data (num property) is always stored as a cell array, the first command evaluates to a cell array containing the row vector [0 1].

Tips

An alternative to the syntax

Value = get(sys,'PropertyName')

is the structure-like referencing

Value = sys.PropertyName

For example,

sys.Ts
sys.a
sys.user

return the values of the sample time, A matrix, and UserData property of the (state-space) model sys.

See Also

frdata | getcov | getpvec | idssdata | polydata | set | ssdata | tfdata

Free Control Systems Interactive Kit

Learn more about resources for designing, testing, and implementing control systems.

Get free kit

Trials Available

Try the latest control systems products.

Get trial software