numpy.ma.clip

numpy.ma.clip(a, a_min, a_max, out=None, **kwargs) [source]

Ограничение (лимитирование) значений в массиве.

При заданном интервале значения, выходящие за пределы интервала, обрезаются до границ интервала. Например, если задан интервал [0, 1], значения, меньшие 0, становятся равными 0, а значения, большие 1, становятся равными 1.

Эквивалентно, но быстрее, чем np.maximum(a_min, np.minimum(a, a_max)). Проверка на то, что a_min < a_max не выполняется.

Параметры

aarray_like

Массив, содержащий элементы для обрезки.

a_minscalar or array_like or None

Минимальное значение. Если None, обрезка не выполняется по нижней границе интервала. Не более одного из a_min и a_max может быть None.

a_maxscalar or array_like or None

Максимальное значение. Если None, обрезка не выполняется по верхней границе интервала. Не более одного из a_min и a_max может быть None. Если a_min или a_max являются массивоподобными, то три массива будут транслированы для соответствия своим формам.

outndarray, optional

Результаты будут размещены в этом массиве. Он может быть входным массивом для обрезки на месте. out должен иметь правильную форму для хранения выходных данных. Его тип сохраняется.

**kwargs

Для других ключевых аргументов см. документацию ufunc.

Введено в версии 1.17.0.

Возвращает

clipped_arrayndarray

Массив со значениями из a, но где значения < a_min заменены на a_min, а значения > a_max на a_max.

См. также

ufuncs-output-type

Примеры

>>> a = np.arange(10)
>>> np.clip(a, 1, 8)
array([1, 1, 2, 3, 4, 5, 6, 7, 8, 8])
>>> a
array([0, 1, 2, 3, 4, 5, 6, 7, 8, 9])
>>> np.clip(a, 3, 6, out=a)
array([3, 3, 3, 3, 4, 5, 6, 6, 6, 6])
>>> a = np.arange(10)
>>> a
array([0, 1, 2, 3, 4, 5, 6, 7, 8, 9])
>>> np.clip(a, [3, 4, 1, 1, 1, 4, 4, 4, 4, 4], 8)
array([3, 4, 2, 3, 4, 5, 6, 7, 8, 8])