La función numpy.clip() “limita los valores en una matriz entre un valor mínimo y máximo especificado”.
Cualquier valor en la matriz por debajo del valor mínimo se reemplazará con el valor mínimo y cualquier valor por encima del valor máximo se reemplazará con el valor máximo.
Sintaxis de la función numpy.clip()
numpy.clip(arr, a_min, a_max, out=None, *, where=True, casting='same_kind',
order='K', dtype=None, subok=True, signature=None, extobj=None)
Parámetros
- arr: la matriz de entrada.
- a_min: El valor mínimo para recortar los elementos de la matriz de entrada. Puede ser un escalar o una matriz con la misma forma que a.
- a_max: el valor máximo para recortar los elementos de la matriz de entrada. Puede ser un escalar o una matriz con la misma forma que a.
- out: una matriz de salida opcional para almacenar el resultado.
Otros parámetros como where, casting, order, dtype, subok, signature y extobj son opciones avanzadas que controlan el rendimiento de la operación.
Ejemplo
import numpy as np
# Sample NumPy array
arr = np.array([1, 2, 3, 4, 5, 6, 7, 8, 9])
print("Original array:")
print(arr)
# Clip the values in the array between 3 and 7
clipped_arr = np.clip(arr, 3, 7)
print("\nClipped array:")
print(clipped_arr)
Producción
Original array:
[1 2 3 4 5 6 7 8 9]
Clipped array:
[3 3 3 4 5 6 7 7 7]
Puede ver que creamos una matriz NumPy de muestra con valores que van del 1 al 9.
En el siguiente paso, usamos la función numpy.clip() para limitar los valores en la matriz entre 3 y 7. La matriz recortada resultante tiene todos los valores por debajo de 3 reemplazados por 3 y todos los por encima de 7 reemplazados por 7.