Documentation Center

  • Trial Software
  • Product Updates

any

Test whether at least one of equations and inequalities represented as elements of symbolic array is valid

Syntax


any(A)
any(A,dim)

Description

any(A) tests whether at least one element of A returns logical 1 (true). If A is a matrix, any tests elements of each column. If A is a multidimensional array, any tests elements along one dimension.

any(A,dim) tests along the dimension of A specified by dim.

Input Arguments

A

Symbolic vector, matrix, or multidimensional symbolic array. For example, it can be an array of symbolic equations, inequalities, or logical expressions with symbolic subexpressions.

dim

Integer. For example, if A is a matrix, any(A,1) tests elements of each column and returns a row vector of logical 1s and 0s. any(A,2) tests elements of each row and returns a column vector of logical 1s and 0s.

Default: The first dimension that is not equal to 1 (non-singleton dimension). For example, if A is a matrix, any(A) treats the columns of A as vectors.

Examples

Create vector V that contains the symbolic equation and inequalities as its elements:

syms x real
V = [x ~= x + 1, abs(x) >= 0, x == x];

Use any to test whether at least one of them is valid for all values of x:

any(V)
ans =
     1
 

Create this matrix of symbolic equations and inequalities:

syms x real
M = [x == 2*x, x == abs(x); abs(x) >= 0, x == 2*x]
M =
[    x == 2*x, x == abs(x)]
[ 0 <= abs(x),    x == 2*x]

Use any to test equations and inequalities of this matrix. By default, any tests whether any element of each column is valid for all possible values of variables. If at least one equation or inequality in the column is valid (returns logical 1), then any returns logical 1 for that column. Otherwise, it returns logical 0 for the column. Thus, it returns 1 for the first column and 0 for the second column:

any(M)
ans =
     1     0
 

Create this matrix of symbolic equations and inequalities:

syms x real
M = [x == 2*x, x == abs(x); abs(x) >= 0, x == 2*x]
M =
[    x == 2*x, x == abs(x)]
[ 0 <= abs(x),    x == 2*x]

For matrices and multidimensional arrays, any can test elements along the specified dimension. To specify the dimension, use the second argument of any. For example, to test elements of each column of a matrix, use the value 1 as the second argument:

any(M, 1)
ans =
     1     0

To test elements of each row, use the value 2 as the second argument:

any(M, 2)
ans =
     0
     1
 

Test whether any element of this vector returns logical 1. Note that any also converts all numeric values outside equations and inequalities to logical 1s and 0s. The numeric value 0 becomes logical 0:

syms x
any([0, x == x + 1])
ans =
     0

All nonzero numeric values, including negative and complex values, become logical 1s:

any([-4 + i, x == x + 1])
ans =
     1

More About

expand all

Tips

  • If A is an empty symbolic array, any(A) returns logical 0.

  • If some elements of A are just numeric values (not equations or inequalities), any converts these values as follows. All nonzero numeric values become logical 1. The value 0 becomes logical 0.

  • If A is a vector and any of its elements returns logical 1, any(A) returns logical 1. If all elements are zero, any(A) returns logical 0.

  • If A is a multidimensional array, any(A) treats the values along the first dimension that is not equal to 1 (non-singleton dimension) as vectors, returning logical 1 or 0 for each vector.

See Also

| | | | | |

Was this topic helpful?