¿Qué es el método numpy.clip()?

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

1. arr: la matriz de entrada.
2. 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.
3. 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.
4. 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.