any

Determinar si algún elemento de un arreglo es distinto a cero

Sintaxis

B = any(A)

B = any(A,'all')

B = any(A,dim)

B = any(A,vecdim)

Descripción

B = any(A) prueba en la primera dimensión del arreglo de A cuyo tamaño no es igual a 1 y determina si algún elemento es un número distinto de cero o 1 lógico (true). En la práctica, any es una extensión natural del operador lógico OR.

• Si A es un vector, B = any(A) devuelve 1 lógico (true) si cualquiera de los elementos de A es un número distinto de cero o es 1 lógico, y devuelve 0 lógico (false) si todos los elementos son cero.

• Si A es una matriz que no está vacía y no es un vector, B = any(A) trata las columnas de A como vectores y devuelve un vector fila de 1 y 0 lógicos.

• Si A es una matriz 0 por 0 vacía, any(A) devuelve 0 lógico (false).

• Si A es un arreglo multidimensional, any(A) actúa en la primera dimensión del arreglo cuyo tamaño no es igual a 1 y devuelve un arreglo de valores lógicos. El tamaño de esta dimensión se convierte en 1, mientras que los tamaños de todas las demás dimensiones se mantienen iguales.

B = any(A,'all') prueba todos los elementos de A. Esta sintaxis es válida para las versiones R2018b y posteriores de MATLAB^®.

B = any(A,dim) prueba todos los elementos de la dimensión dim. La entrada dim es un escalar entero positivo.

B = any(A,vecdim) prueba elementos basándose en las dimensiones especificadas en el vector vecdim. Por ejemplo, si A es una matriz, any(A,[1 2]) prueba todos los elementos de A, puesto que todos los elementos de una matriz están incluidos en la parte del arreglo que establecen las dimensiones 1 y 2.

Ejemplos

Probar columnas de matriz

Cree una matriz de 3 por 3.

A = [0 0 3;0 0 3;0 0 3]

A = 3×3

     0     0     3
     0     0     3
     0     0     3

Pruebe cada columna para hallar elementos distintos de cero.

B = any(A)

B = 1×3 logical array

   0   0   1

Reducir un vector lógico a una condición única

Cree un vector de valores decimales y pruebe qué valores son inferiores a 0.5.

A = [0.53 0.67 0.01 0.38 0.07 0.42 0.69];
B = (A < 0.5)

B = 1×7 logical array

   0   0   1   1   1   1   0

La salida es un vector de valores lógicos. La función any reduce este vector de valores lógicos a una condición única. En este caso, B = any(A < 0.5) produce un 1 lógico.

Esto hace que any sea particularmente útil en instrucciones if.

if any(A < 0.5)

%do something

else

%do something else

end

El código se ejecuta en función de una condición única en lugar de un vector de condiciones que pueden entrar en conflicto.

Probar arreglos de cualquier dimensión

Cree un arreglo multidimensional de 3 por 7 por 5 y pruébelo para ver si cualquiera de sus elementos es mayor que 3.

A = rand(3,7,5) * 5;
B = any(A(:) > 3)

B = logical
   1

También puede probar el arreglo para elementos que sean menores que cero.

B = any(A(:) < 0)

B = logical
   0

La sintaxis A(:) convierte los elementos de A en un vector columna único, así que puede utilizar este tipo de instrucción en un arreglo de cualquier tamaño.

Probar filas de matriz

Cree una matriz de 3 por 3.

A = [0 0 3;0 0 3;0 0 3]

A = 3×3

     0     0     3
     0     0     3
     0     0     3

Pruebe las filas de A para hallar elementos distintos de cero especificando dim = 2.

B = any(A,2)

B = 3×1 logical array

   1
   1
   1

Elementos distintos de cero en una página de arreglo

Cree un arreglo 3D y determine si hay elementos distintos de cero en cada página de datos (filas y columnas).

A(:,:,1) = [2 0; 0 0];
A(:,:,2) = [0 0; 0 0];
A(:,:,3) = [0 0; 0 1];
B = any(A,[1 2])

B = 1×1×3 logical array
B(:,:,1) =

   1


B(:,:,2) =

   0


B(:,:,3) =

   1

Argumentos de entrada

A — Arreglo de entrada

escalar | vector | matriz | arreglo multidimensional

Arreglo de entrada, especificado como escalar, vector, matriz o arreglo multidimensional. La función any ignora los elementos de A que son NaN (no es un número).

Tipos de datos: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | char
Soporte de números complejos: Sí

dim — Dimensión en la que operar

escalar entero positivo

Dimensión en la que operar, especificada como escalar entero positivo. Si no especifica la dimensión, el valor predeterminado es la primera dimensión del arreglo cuyo tamaño no es igual a 1.

Considere un arreglo de entrada bidimensional, A:

• any(A,1) opera en elementos sucesivos de las columnas de A y devuelve un vector fila de valores lógicos.

• any(A,2) opera en elementos sucesivos de las filas de A y devuelve un vector columna de valores lógicos.

Tipos de datos: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

vecdim — Vector de dimensiones

vector de enteros positivos

Vector de dimensiones, especificado como vector de enteros positivos. Cada elemento representa una dimensión del arreglo de entrada. Las longitudes de la salida en las dimensiones operativas especificadas son 1, mientras que las demás se mantienen iguales.

Considere un arreglo de entrada de 2 por 3 por 3, A. En ese caso, any(A,[1 2]) devuelve un arreglo de 1 por 1 por 3 cuyos elementos indican valores distintos de cero para cada página de A.

Tipos de datos: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Argumentos de salida

B — Arreglo lógico

escalar | vector | matriz | arreglo multidimensional

Arreglo lógico, devuelto como escalar, vector, matriz o arreglo multidimensional. La dimensión de A sobre la que actúa any tiene el tamaño 1 en B.

Capacidades ampliadas

Arreglos altos

Realice cálculos con arreglos que tienen más filas de las que caben en la memoria.

La función any es totalmente compatible con los arreglos altos. Para obtener más información, consulte Arreglos altos.

Generación de código C/C++

Genere código C y C++ mediante MATLAB® Coder™.

Notas y limitaciones de uso:

• Para el argumento de entrada A:

  • Si no especifica ninguna dimensión, el generador de código opera en la primera dimensión del arreglo de entrada que sea de tamaño variable o cuyo tamaño no sea igual a 1. Si esta dimensión es de tamaño variable en el tiempo de generación del código y tiene el valor 1 en el tiempo de ejecución, puede producirse un error en el tiempo de ejecución. Para evitar este error, especifique la dimensión.

  • Si todas las dimensiones del arreglo de entrada son de tamaño variable en el tiempo de generación del código, este arreglo no puede estar vacío en el tiempo de ejecución.

• Si se utiliza, el argumento dim debe ser una constante en el tiempo de generación del código.

Generación de código HDL

Genere código VHDL, Verilog y SystemVerilog para diseños FPGA y ASIC mediante HDL Coder™.

No se admiten tipos de datos dobles.

Entorno basado en subprocesos

Ejecute código en segundo plano con MATLAB® backgroundPool o acelere código con Parallel Computing Toolbox™ ThreadPool.

Esta función es totalmente compatible con entornos basados en subprocesos. Para obtener más información, consulte Ejecutar funciones de MATLAB en entornos basados en subprocesos.

Arreglos GPU

Acelere código mediante la ejecución en una unidad de procesamiento gráfico (GPU) mediante Parallel Computing Toolbox™.

La función any es totalmente compatible con los arreglos de GPU. Para ejecutar la función en una GPU, especifique los datos de entrada como un gpuArray (Parallel Computing Toolbox). Para obtener más información, consulte Run MATLAB Functions on a GPU (Parallel Computing Toolbox).

Arreglos distribuidos

Realice particiones de arreglos grandes por toda la memoria combinada de su cluster mediante Parallel Computing Toolbox™.

Esta función es totalmente compatible con los arreglos distribuidos. Para obtener más información, consulte Run MATLAB Functions with Distributed Arrays (Parallel Computing Toolbox).

Historial de versiones

Introducido antes de R2006a

Consulte también

all | colon | or | prod | sum | nnz

Temas

• Reduce Logical Arrays to Single Value