La traducción de esta página aún no se ha actualizado a la versión más reciente. Haga clic aquí para ver la última versión en inglés.

ind2sub

Convertir índices lineales a subíndices

Sintaxis

[row,col] = ind2sub(sz,ind)

[I1,I2,...,In] = ind2sub(sz,ind)

Descripción

[row,col] = ind2sub(sz,ind) devuelve los arreglos row y col que contienen los subíndices de fila y columna equivalentes correspondientes a los índices lineales ind para una matriz de sz. Aquí, sz es un vector con dos elementos, donde sz(1) especifica el número de filas y sz(2) especifica el número de columnas.

[I1,I2,...,In] = ind2sub(sz,ind) devuelve n arreglos I1,I2,...,In que contienen los subíndices multidimensionales equivalentes correspondientes a los índices lineales ind para un arreglo multidimensional de tamaño sz. Aquí, sz es un vector con n elementos que especifica el tamaño de cada dimensión del arreglo.

Ejemplos

Convertir índices lineales a subíndices para una matriz

Convierta los índices lineales [3 4 5 6] a subíndices de fila y columna en una matriz de 3 por 3. La asignación de índices lineales a subíndices (indexado por posición) se puede ilustrar de la siguiente manera.

Cree vectores de entrada y realice la conversión.

ind = [3 4 5 6];
sz = [3 3];
[row,col] = ind2sub(sz,ind)

row = 1×4

     3     1     2     3

col = 1×4

     1     2     2     2

Convertir índices lineales a subíndices para un arreglo tridimensional

Convierta los índices lineales [3 4 5 6] a subíndices en un arreglo de 2 por 2 por 2. La asignación de índices lineales a subíndices (indexado por posición) para un arreglo de 2 por 2 por 2 se puede ilustrar de la siguiente manera.

Cree vectores de entrada y realice la conversión.

ind = [3 4 5 6];
sz = [2 2 2];
[I1,I2,I3] = ind2sub(sz,ind)

I1 = 1×4

     1     2     1     2

I2 = 1×4

     2     2     1     1

I3 = 1×4

     1     1     2     2

Acceder a elementos de arreglos 3D

Convierta un índice lineal de un arreglo 3D a un índice de subíndice.

Cree un arreglo y encuentre el índice de subíndice correspondiente al 14-ésimo elemento del arreglo.

A = rand(3,4,2);
[row,col,page] = ind2sub(size(A),14)

row = 
2

col = 
1

page = 
2

Compruebe que ambas versiones del índice hacen referencia al mismo elemento del arreglo.

A(14)

ans = 
0.4854

A(row,col,page)

ans = 
0.4854

Utilizar ind2sub con menos argumentos de salida

Cuando se utiliza ind2sub para un arreglo de N dimensiones, normalmente se proporcionan N argumentos de salida para cada dimensión de la matriz. Este ejemplo muestra los diferentes resultados cuando devuelve menos argumentos de salida para un arreglo tridimensional.

Cree los argumentos de entrada necesarios para convertir los índices lineales 1 a 8 para un arreglo tridimensional de tamaño 2 por 2 por 2.

ind = 1:8;
sz = [2 2 2];

Especifique tres argumentos de salida cuando utilice ind2sub para devolver los subíndices de fila, columna y página para el arreglo de 2 por 2 por 2.

[row,col,page] = ind2sub(sz,ind)

row = 1×8

     1     2     1     2     1     2     1     2

col = 1×8

     1     1     2     2     1     1     2     2

page = 1×8

     1     1     1     1     2     2     2     2

Si especifica solo dos argumentos de salida, ind2sub ignora la tercera dimensión del arreglo y devuelve subíndices para un arreglo bidimensional de tamaño 2 por 4 en su lugar.

[row,col] = ind2sub(sz,ind)

row = 1×8

     1     2     1     2     1     2     1     2

col = 1×8

     1     1     2     2     3     3     4     4

Si especifica solo un argumento de salida, ind2sub ignora la segunda y la tercera dimensión del arreglo y devuelve subíndices para un arreglo unidimensional de tamaño 1 por 8 en su lugar.

row = ind2sub(sz,ind)

row = 1×8

     1     2     3     4     5     6     7     8

Convertir índices lineales fuera del tamaño de una matriz

Cuando se convierten índices lineales en índices de subíndice utilizando un tamaño de matriz objetivo inferior al requerido, la función ind2sub amplía automáticamente el tamaño de la matriz según sea necesario.

Por ejemplo, defina índices lineales que estén fuera del tamaño de la matriz de 3 por 1.

ind = [9 11 13 14]

ind = 1×4

     9    11    13    14

Convierta estos índices en índices de subíndice para una matriz de 3 por 1.

[row,col] = ind2sub([3 1],ind)

row = 1×4

     3     2     1     2

col = 1×4

     3     4     5     5

ind2sub no genera ningún error para esta operación. En cambio, ind2sub añade columnas automáticamente y amplía el tamaño de la matriz a 3 por 5 para acomodar la conversión de los índices lineales especificados a índices de subíndice.

Para realizar una comparación, convierta los mismos índices lineales en índices de subíndice para una matriz de 3 por 5. Los índices de subíndice resultantes para una matriz de 3 por 5 y para una matriz de 3 por 1 son los mismos.

[row,col] = ind2sub([3 5],ind)

row = 1×4

     3     2     1     2

col = 1×4

     3     4     5     5

Argumentos de entrada

sz — Tamaño de un arreglo

vector de enteros positivos

Tamaño de un arreglo, especificado como vector de enteros positivos. Cada elemento de este vector indica el tamaño de la dimensión correspondiente. Por ejemplo, [2 3 4] define un arreglo de 2 por 3 por 4.

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

ind — Índices lineales

escalar | vector | matriz | arreglo multidimensional

Índices lineales, especificados como escalar, vector, matriz o arreglo multidimensional.

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

Argumentos de salida

row — Subíndices de fila

escalar | vector | matriz | arreglo multidimensional

Subíndices de fila, devueltos como escalar, vector, matriz o arreglo multidimensional. El tamaño de row es igual que el tamaño de la entrada ind.

Tipos de datos: double

col — Subíndices de columna

escalar | vector | matriz | arreglo multidimensional

Subíndices de columna, devueltos como escalar, vector, matriz o arreglo multidimensional. El tamaño de col es igual que el tamaño de la entrada ind.

Tipos de datos: double

I1,I2,...,In — Subíndices multidimensionales

escalar | vector | matriz | arreglo multidimensional

Subíndices multidimensionales, devueltos como escalar, vector, matriz o arreglo multidimensional. El tamaño de cada arreglo I1,I2,…,In es igual que el tamaño de la entrada ind.

Tipos de datos: double

Sugerencias

• Para obtener los índices lineales de elementos de matriz que satisfagan una condición específica para la matriz A, puede utilizar la función find con un argumento de salida. Para obtener los índices de subíndice, utilice la función find con dos argumentos de salida. Por ejemplo, [row,col] = ind2sub(size(A),find(A>5)) proporciona el mismo resultado que [row,col] = find(A>5).

Algoritmos

Para un arreglo A, si [I1,…,In] = ind2sub(size(A),ind), A(I1(k),…,In(k)) = A(ind(k)) para todo k.

Capacidades ampliadas

Arreglos altos

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

La función ind2sub 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:

• Los vectores de entrada sz e ind solo pueden contener valores enteros finitos.

• El vector de tamaño sz debe tener un tamaño fijo en el tiempo de generación del código.

• En la generación de código, el número máximo de elementos en un arreglo está limitado por el generador de código y el hardware objetivo. Consulte Array Size Restrictions for Code Generation (MATLAB Coder).

  • No se admiten vectores de tamaño para arreglos con más del número máximo de elementos.

  • El vector índice ind no puede contener valores superiores al número máximo de elementos.

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 ind2sub 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

R2024b: No se admite una entrada escalar para definir el tamaño del arreglo

El argumento de entrada para el tamaño del arreglo debe ser un vector de enteros positivos con dos o más elementos. En versiones anteriores, ind2sub(sz,ind) trataba un tamaño de entrada escalar sz como el número de filas del arreglo y suponía que el tamaño de la otra dimensión era 1. Por ejemplo:

[row,col] = ind2sub(6,[2 3 4])

row =

     2     3     4


col =

     1     1     1

A partir de la versión R2024b, una entrada escalar para sz resulta en un error. En su lugar, debe especificar sz como vector de enteros positivos con dos o más elementos. Por ejemplo:

[row,col] = ind2sub([6 1],[2 3 4])

Consulte también

find | size | sub2ind

Temas

• Indexación de arreglos
• Arreglos multidimensionales