numpy.asarray(a, dtype = None, order = None)
La función numpy.asarray convierte una estructura de datos en un array NumPy.
Esta función es semejante a np.array (aunque con menos opciones), siendo la mayor diferencia el hecho de que np.array genera -por defecto- una copia independiente de la estructura pasada como argumento, mientras que numpy.asarray no.
- a: Estructura a convertir en array NumPy. La función admite gran número de tipos, incluyendo listas, tuplas, listas de tuplas, tuplas de tupas, tuplas de listas o arrays NumPy. En este último caso, el resultado de la función no es una copia independiente del array.
- dtype: Tipo a asignar al resultado devuelto por la función. Si no se especifica, este tipo se infiere de la estructura de entrada.
- order: {"C", "F"} Representación en memoria del array. Puede ser "C" (C-Style) o "F" (Fortran-Style).
La función numpy.asarray devuelve un array NumPy.
Podemos convertir una lista a array NumPy con el siguiente código:
a = [2, 5, 1, 4]
np.asarray(a)
array([2, 5, 1, 4])
Si no se especifica, el tipo del array devuelto se infiere de la estructura de entrada. En el siguiente ejemplo la lista a convertir incluye números y textos, por lo que el array devuelto se genera con un tipo de texto también:
a = [2, 5, 1, "a"]
np.asarray(a)
array(['2', '5', '1', 'a'], dtype='<U11')
Si la estructura a convertir es un array NumPy, el resultado devuelto por la función no es una copia independiente de ella:
a = np.array([1, 2])
b = np.asarray(a)
a is b
True
Podemos convertir una estructura especificando el tipo del array generado:
a = [2, 5, 1, 4]
np.asarray(a, dtype = str)
array(['2', '5', '1', '4'], dtype='<U1')