getfis

(Removed) Get fuzzy system properties

getfis has been removed. Access fuzzy inference system properties using dot notation instead. For more information, see Version History.

Syntax

getfis(sys)

fisInfo = getfis(sys)

fisInfo = getfis(sys,fisProperty)

varInfo = getfis(sys,varType,varIndex)

varInfo = getfis(sys,varType,varIndex,varProperty)

mfInfo = getfis(sys,varType,varIndex,'mf',mfIndex)

mfInfo = getfis(sys,varType,varIndex,'mf',mfIndex,mfProperty)

Description

getfis(sys) prints the properties of the fuzzy inference system sys, to the Command Window.

example

fisInfo = getfis(sys) returns the properties of the specified fuzzy inference system.

example

fisInfo = getfis(sys,fisProperty) returns the value of the specified property of the fuzzy inference system.

example

varInfo = getfis(sys,varType,varIndex) returns the properties of the specified input or output variable of a fuzzy inference system.

example

varInfo = getfis(sys,varType,varIndex,varProperty) returns the value of the specified variable property.

example

mfInfo = getfis(sys,varType,varIndex,'mf',mfIndex) returns the properties of the specified membership function of an input or output variable.

example

mfInfo = getfis(sys,varType,varIndex,'mf',mfIndex,mfProperty) returns the value of the specified membership function property.

example

Examples

collapse all

Display Properties of Fuzzy Inference System

Load a fuzzy inference system.

sys = readfis('tipper');

Display the system properties.

getfis(sys)

      Name      = tipper
      Type      = mamdani
      NumInputs = 2
      InLabels  = 
            service
            food
      NumOutputs = 1
      OutLabels = 
            tip
      NumRules = 3
      AndMethod = min
      OrMethod = max
      ImpMethod = min
      AggMethod = max
      DefuzzMethod = centroid

Obtain Fuzzy Inference System Properties

Load fuzzy system.

sys = readfis('tipper');

Obtain the system properties.

prop = getfis(sys);

To obtain the value of a given property, specify the property name. For example, obtain the type of the fuzzy system.

type = getfis(sys,'type');

Obtain Variable Properties

Load fuzzy system.

sys = readfis('tipper');

Obtain the properties of the first input variable.

prop = getfis(sys,'input',1);

To obtain the value of a given property, specify the property name. For example, obtain the range of the output variable.

range = getfis(sys,'output',1,'range');

Obtain Membership Function Properties

Load fuzzy system.

sys = readfis('tipper');

For the second input variable, obtain the properties of its first membership function.

prop = getfis(sys,'input',2,'mf',1);

To obtain the value of a given property, specify the property name. For example, obtain the parameters of the second membership function of the output variable.

params = getfis(sys,'output',1,'mf',2,'params');

Input Arguments

collapse all

`sys` — Fuzzy inference system
FIS structure

Fuzzy inference system, specified as a FIS structure.

`fisProperty` — Fuzzy inference system property
`'name'` | `'type'` | `'numInputs'` | `'numOutputs'` | ...

Fuzzy inference system property, specified as one of the following:

'name' — FIS name
'type' — FIS type
'numInputs' — Number of inputs
'numOutputs'— Number of outputs
'numRules' — Number of fuzzy rules.
'andMethod' — And method
'orMethod' — Or method
'defuzzMethod' — Defuzzification method
'impMethod' — Implication method
'aggMethod' — Aggregation method
'ruleList' — List of fuzzy rules

`varType` — Variable type
`'input'` | `'output'`

Variable type, specified as either 'input' or 'output', for input and output variables, respectively.

`varIndex` — Variable index
positive integer

Variable index, specified as a positive integer.

`varProperty` — Variable property
`'name'` | `'range'` | `'nummfs'`

Variable property, specified as one of the following:

'name' — Variable name
'range' — Variable value range
'nummfs' — Number of membership functions

`mfIndex` — Membership function index
positive integer

Membership function index, specified as a positive integer.

`mfProperty` — Membership function property
`'name'` | `'type'` | `'params'`

Membership function property, specified as one of the following:

'name' — Membership function name
'type' — Membership function type
'params' — Membership function parameters

For more information on membership functions, see Membership Functions.

Output Arguments

collapse all

`fisInfo` — Fuzzy inference system information
structure | character vector | nonnegative integer | array

Fuzzy inference system information, returned as a structure, character vector, nonnegative integer, or array, depending on the value of fisProperty.

If you do not specify fisProperty, then fisInfo is returned as a structure with the following fields.

Field	Description
`name`	FIS name, returned as a character vector.
`type`	FIS type, returned as a character vector.
`andMethod`	AND fuzzy operator method, returned as a character vector.
`orMethod`	OR fuzzy operator method, returned as a character vector.
`defuzzMethod`	Defuzzification method, returned as a character vector.
`impMethod`	Implication method, returned as a character vector.
`aggMethod`	Aggregation method, returned as a character vector.
`input`	Input variable information, returned as a structure or structure array. Each input variable structure contains the following fields: `name` — Variable name `range` — Variable range `mf` — Membership function names
`output`	Output variable information, returned as a structure or structure array. Each output variable structure contains the following fields: `name` — Variable name `range` — Variable range `mf` — Membership function names
`rule`	Fuzzy rule list, returned as a structure or structure array. Each rule structure contains the following fields: `antecedent` — Input membership function indices `consequent` — Output membership function indices `weight` — Rule weight `connection` — Fuzzy operator: `1` (AND), `2` (OR)

Otherwise, the value of fisInfo depends on the value of fisProperty according to the following table.

`fisProperty`	`fisInfo`
`'name'`	FIS name, returned as a character vector.
`'type'`	FIS type, returned as one of the following: `'mamdani'` — Mamdani-type fuzzy system `'sugeno'` — Sugeno-type fuzzy system
`'numinputs'`	Number of input variables, returned as a nonnegative integer.
`'numiutputs'`	Number of output variables, returned as a nonnegative integer.
`'numrules'`	Number of fuzzy rules, returned as a nonnegative integer.
`'andmethod'`	AND fuzzy operator method, returned as one of the following: `'min'` — Minimum of fuzzified input values `'prod'` — Product of fuzzified input values Character vector — Name of a custom AND function in the current working folder or on the MATLAB^® path
`'ormethod'`	OR fuzzy operator method, returned as one of the following: `'max'` — Maximum of fuzzified input values `'probor'` — Probabilistic OR of fuzzified input values Character vector — Name of a custom OR function in the current working folder or on the MATLAB path
`'defuzzmethod'`	Defuzzification method for computing crisp output values, returned as one of the following for Mamdani systems: `'centroid'` — Centroid of the area under the output fuzzy set `'bisector'` — Bisector of the area under the output fuzzy set `'mom'` — Mean of the values for which the output fuzzy set is maximum `'lom'` — Largest value for which the output fuzzy set is maximum `'som'` — Smallest value for which the output fuzzy set is maximum For Sugeno systems, specify the defuzzification method as one of the following: `'wtaver'` — Weighted average of all rule outputs `'wtsum'` — Weighted sum of all rule outputs The defuzzification method can also be returned as a character vector that contains the name of a custom defuzzification function in the current working folder or on the MATLAB path.
`'impmethod'`	Implication method for computing consequent fuzzy set, returned as one of the following: `'min'` — Truncate the consequent membership function at the antecedent result value. `'prod'` — Scale the consequent membership function by the antecedent result value. Character vector — Name of a custom implication function in the current working folder or on the MATLAB path
`'aggmethod'`	Aggregation method for combining rule consequents, returned as one of the following: `'max'` — Maximum of consequent fuzzy sets `'sum'` — Sum of consequent fuzzy sets `'probor'` — Probabilistic OR of consequent fuzzy sets Character vector — Name of a custom aggregation function in the current working folder or on the MATLAB path.
`'rulelist'`	Fuzzy rule list, returned as an array. For each fuzzy rule, the rule list contains one row with the following columns: N_u columns of input membership function indices, where N_u is the number of inputs. If a given variable is not included in a rule, the corresponding column entry is `0`. Negative values indicate a NOT operation. N_y columns of output membership function indices, where N_y is the number of outputs. If a given variable is not included in a rule, the corresponding column entry is `0`. Negative values indicate a NOT operation. Rule weight Fuzzy operator: `1` (AND), `2` (OR)

`varInfo` — Variable information
structure | character vector | nonnegative integer | row vector of length 2

Variable information, returned as a structure, nonnegative integer, character vector, or row vector, depending on the value of varProperty.

If you do not specify varProperty, then varInfo is returned as a structure with the following fields.

Field	Description
`Name`	Variable name, returned as a character vector.
`NumMFs`	Number of membership functions, returned as a nonnegative integer.
`mf1`, `mf2`, ..., `mfN`	Membership function names, returned as character vectors. `mfInfo` contains one field for each membership function.
`range`	Variable range, returned as a row vector of length 2.

Otherwise, the value of varInfo depends on the value of varProperty according to the following table.

`varProperty`	`varInfo`
`'name'`	Variable name, returned as a character vector.
`'nummfs'`	Number of membership functions, returned as a nonnegative integer.
`'range'`	Variable range, returned as a row vector of length 2.

`mfInfo` — Membership function information
structure | character vector | row vector

Membership function information, returned as a structure, character vector, or row vector, depending on the value of mfProperty.

If you do not specify mfProperty, then mfInfo is returned as a structure with the following fields.

Field	Description
`Name`	Membership function name, returned as a character vector.
`Type`	Membership function type, returned as a character vector.
`params`	Membership function parameters, returned as a row vector.

Otherwise, the value of mfInfo depends on the value of mfProperty according to the following table.

`mfProperty`	`mfInfo`
`'name'`	Membership function name, returned as a character vector.
`'type'`	Membership function type, returned as a character vector.
`'params'`	Membership function parameters, returned as a row vector.

For more information on membership function, see Membership Functions.

Version History

Introduced before R2006a

expand all

R2024b: Removed

getfis has been removed. Access fuzzy inference system properties using dot notation instead. For more information on fuzzy inference system objects, see mamfis and sugfis.

This table shows some typical usages of getfis for accessing fuzzy inference system properties and how to update your code to use dot notation instead.

If your code has this form:	Use this code instead:
get(fis,'andmethod')	fis.AndMethod
getfis(fis,'input',1)	fis.Inputs(1)
getfis(fis,'input',1,'name')	fis.Inputs(1).Name
getfis(fis,'input',2,'mf',1)	fis.Inputs(2).MembershipFunctions(1)
getfis(fis,'input',2,'mf',1,... params)	fis.Inputs(2).MembershipFunctions(1).Parameters

R2019b: Warns

getfis issues a warning that it will be removed in a future release.

R2018b: To be removed

getfis runs without warning, but Code Analyzer indicates that getfis will be removed in a future release.

R2017a: Returns FIS properties in a structure

Starting in R2017a, the following getfis syntaxes have a new behavior.

Syntax	Previous Behavior	New Behavior
`getfis(fis)`	Print formatted list of FIS properties to Command Window, and return FIS name.	Print formatted list of FIS properties to Command Window.
`getfis(fis,varType,varIndex)`	Print formatted list variable properties to Command Window, and return structure that contains variable properties.	Return structure that contains variable properties.
`getfis(fis,varType,varIndex,'mf',mfIndex)`	Print formatted list membership function properties to Command Window, and return structure that contains membership function properties.	Return structure that contains membership function properties.

getfis

Syntax

Description

Examples

Display Properties of Fuzzy Inference System

Obtain Fuzzy Inference System Properties

Obtain Variable Properties

Obtain Membership Function Properties

Input Arguments

sys — Fuzzy inference system FIS structure

fisProperty — Fuzzy inference system property 'name' | 'type' | 'numInputs' | 'numOutputs' | ...

varType — Variable type 'input' | 'output'

varIndex — Variable index positive integer

varProperty — Variable property 'name' | 'range' | 'nummfs'

mfIndex — Membership function index positive integer

mfProperty — Membership function property 'name' | 'type' | 'params'

Output Arguments

fisInfo — Fuzzy inference system information structure | character vector | nonnegative integer | array

varInfo — Variable information structure | character vector | nonnegative integer | row vector of length 2

mfInfo — Membership function information structure | character vector | row vector

Version History

R2024b: Removed

R2019b: Warns

R2018b: To be removed

R2017a: Returns FIS properties in a structure

See Also

`sys` — Fuzzy inference system
FIS structure

`fisProperty` — Fuzzy inference system property
`'name'` | `'type'` | `'numInputs'` | `'numOutputs'` | ...

`varType` — Variable type
`'input'` | `'output'`

`varIndex` — Variable index
positive integer

`varProperty` — Variable property
`'name'` | `'range'` | `'nummfs'`

`mfIndex` — Membership function index
positive integer

`mfProperty` — Membership function property
`'name'` | `'type'` | `'params'`

`fisInfo` — Fuzzy inference system information
structure | character vector | nonnegative integer | array

`varInfo` — Variable information
structure | character vector | nonnegative integer | row vector of length 2

`mfInfo` — Membership function information
structure | character vector | row vector