API · NumPy

Python NumPy numpy.shape() Función

Usa numpy.shape() para obtener las dimensiones de un array como una tupla, o léelas desde su atributo .shape.

En esta página

Usa la función numpy.shape() de NumPy para conocer las dimensiones de un array. Devuelve una tupla de enteros, donde cada valor indica la longitud de una dimensión. Por ejemplo, (5, 3) significa cinco filas y tres columnas. La tupla describe la forma actual de la entrada; que la tupla sea inmutable no determina si el array puede cambiar de forma.

Sintaxis de numpy.shape()

Llama a numpy.shape(a) con el valor cuyas dimensiones quieras consultar. El argumento a es obligatorio y puede ser un array de NumPy u otro valor similar a un array, como una secuencia anidada. La función devuelve una tupla con un entero por cada dimensión, en orden. Una entrada unidimensional tiene un valor en la tupla; una bidimensional tiene las longitudes de las filas y las columnas; las entradas con más dimensiones añaden una longitud por cada eje adicional.

Ejemplos de numpy.shape()

El siguiente ejemplo crea un array bidimensional de NumPy e imprime las dimensiones que indica numpy.shape().

import numpy as np

array = np.array([[11, 12, 5], [15, 6, 10], [10, 8, 12], [12, 15, 8], [34, 78, 90]])
print(np.shape(array))
(5, 3)

El primer valor de una tupla describe el primer eje; el segundo, el segundo eje, y así sucesivamente. En un array bidimensional, esos ejes corresponden a las filas y las columnas. El resultado es útil para comprobar cómo están organizados los datos antes de seleccionar un eje o pasarlos a otra operación.

Si un array no contiene valores en su único eje, su forma es (0,). Un array unidimensional que contiene [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20] tiene forma (20,). Un array con cinco filas y tres columnas tiene forma (5, 3), mientras que un array tridimensional organizado en tres grupos de dos filas con tres valores por fila tiene forma (3, 2, 3). Estas tuplas describen las longitudes de los ejes en orden, no los valores almacenados en el array. La coma de (20,) forma parte de la sintaxis de Python y distingue una tupla de un entero entre paréntesis.

Este ejemplo de Python crea un array sin valores y obtiene su forma. No imprime nada porque asigna la forma a una variable sin llamar a print().

import numpy as np

empty_array = np.array([])
empty_shape = np.shape(empty_array)

La función informa las longitudes correspondientes a las dimensiones de la entrada. Si el resultado no coincide con lo que esperabas, comprueba cómo se creó la entrada y en qué orden están sus secuencias anidadas. Por ejemplo, en un array bidimensional regular, el primer valor de la forma es el número de filas y el segundo, el número de columnas. NumPy informa de la estructura presente en los datos; no deduce las etiquetas de fila o columna que se pretendían. En el caso de datos anidados irregulares, el comportamiento puede depender de la versión de NumPy y de las reglas de conversión. Si necesitas longitudes de eje uniformes, usa un array regular.

Uso del atributo .shape

Un array de NumPy también expone sus dimensiones mediante el atributo .shape. Para un array a, a.shape proporciona la misma tupla que numpy.shape(a). Usa la función cuando quieras pasar un valor a una operación general; usa el atributo cuando ya tengas un array y quieras consultar sus dimensiones directamente. El atributo se accede sin paréntesis, mientras que numpy.shape() se invoca como función.

Por ejemplo, a.shape indica (5, 3) para un array con cinco filas y tres columnas, igual que numpy.shape(a). Ninguna de las dos formas modifica el array: ambas informan de sus dimensiones. Si cambias la forma de un array, consultar cualquiera de las dos después devuelve sus dimensiones actualizadas. Esta distinción resulta útil al depurar la preparación de datos: consulta la forma antes de una operación para comprobar el número y el orden de los ejes, y luego usa la tupla resultante para localizar la dimensión que requiere atención. numpy.shape() es una función, mientras que .shape es un atributo del array.