imat_filt/imat_filt

Purpose

Create an imat_filt object which can be used to select elements of an imat_fn.

Syntax

z=imat_filt( attribute, relation, value )
z=imat_filt( { attrib1, rel1, val1 ; attrib2, rel2, val2 ; ... } )

Description

This function, the IMAT filter constructor, creates a function filter (imat_filt object) from one or more criteria.

An imat_filt variable consists of one or more criteria, each composed of an attribute, a relation, and a value.

The attribute of a criterion can be the name of any valid data attribute for an imat_fn, with the exception of Abscissa and Ordinate. The relation of a criterion can be any any of the following:

The last four relations are applicable only to numeric data attributes.

The value of a criterion should be a scalar (for numeric data attributes) or a string (for string attributes) suitable for the data attribute. String matching is case insensitive. Two special features should be noted:

• For the ReferenceCoord and ResponseCoord data attributes, you may specify a coordinate trace as the value of the criterion. In this case, equality is satisfied if the reference (or response) coordinate of a function is included in the coordinate trace.

• For string attributes, you may include wildcard characters: a question mark matches any single character, and an asterisk matches zero or more characters. (For example, 'ab?d*' matches the strings 'AbCd' and 'abxdefg', but not 'abccd'.) Wildcards cannot be used for list attributes such as FunctionType, which have a restricted list of possible values.

The first syntax creates an imat_filt with a single criterion. The second syntax (with a single Nx3 cell array) creates an imat_filt with multiple criteria, all of which must be satisfied.

To create more complicated filters, combine simple filters using and, or, and not logical operators.

Examples

>> imat_filt('AbscissaSpacing','==','Even');
>> imat_filt('AbscissaMin','>',0);
>> imat_filt('ResponseCoord','=',{'1x','2y-'})

See Also

User's Guide