Stretch

Краткая информация

Улучшает внешний вид изображения путем изменения его свойств, таких как яркость, контрастность и гамма, посредством нескольких типов растяжки на основе статистики.

Обсуждение

Более подробную информацию о том, как работает эта функция, см. в растровой функции Растяжка.

Указанный набор растровых данных является временным для растрового объекта. Чтобы сделать его постоянным, вы можете вызвать метод растрового объекта save.

Синтаксис

Stretch (raster, stretch_type, min, max, num_stddev, statistics, dra, {min_percent}, max_percent, {gamma}, {compute_gamma}, sigmoid_strength_level)

Параметр	Описание	Тип данных
raster	The input raster.	Raster
stretch_type [stretch_type,...]	Укажите тип растяжки, который следует применить к изображению. None —К слою не будет применяться никакой метод растяжки, даже если есть статистика. StdDev —Использует для слияния данных алгоритм Brovey на основе спектральной модели. Требуется задать число стандартных отклонений (num_stddev), вычисляемую статистику, или установить значение DRA (dra) равным True. Histogram —Примените растяжку выравнивания гистограммы. Требуется, чтобы для исходного набора данных была вычислена гистограмма, или чтобы значение DRA было равно True. MinMax —Применяет линейную растяжку на основе значений пикселов выходного минимума и выходного максимума, которые играют роль конечных точек для гистограммы. Требуется, чтобы предварительно была вычислена статистика, или чтобы значение DRA (dra) было равно True. PercentClip —Применяется линейную растяжку между заданными значениями пикселов максимального и минимального процента отсечения. Sigmoid —Размещает все значения пикселов изображения вдоль сигмоидальной функции (кривая в виде буквы S). (Значение по умолчанию — 0)	String
min	Задает наименьшее значение пиксела для выходной гистограммы. Выходной минимум (min) и выходной максимум (max) зададут диапазон значений, который затем будет растянут. (Значение по умолчанию — None)	Double
max	Задает наибольшее значение пиксела для выходной гистограммы. Выходной максимум (max) и выходной минимум (min) зададут диапазон значений, который затем будет растянут. (Значение по умолчанию — None)	Double
num_stddev	Также можно указать значение n для числа используемых стандартных отклонений. Этот метод используется для определения числа значений объекта, отличающихся от среднего; лучше всего подходит для данных с нормальным распределением. (Значение по умолчанию — None)	Double
statistics [statistics,...]	По умолчанию, используемая статистика извлекается из данных; однако, вместо этого будут использоваться значения, которые вы вводите в этом параметре. Статистика указывается, как: [[<min>, <max>, <mean>, <standardDeviation>] [<min>, <max>, <mean>, <standardDeviation>] [<min>, <max>, <mean>, <standardDeviation>]] (Значение по умолчанию — None)	Double
dra	Вычислите статистику только на основе пикселов, отображаемых на вашем экране. Параметр статистики игнорируется, если значением DRA является True. True - настройка динамического диапазона (dra) будет вычислена. False - настройка динамического диапазона (dra) не будет вычислена. (Значение по умолчанию — None)	Boolean
min_percent	Укажите процент низких значений, которые следует исключить, когда выбрана растяжка PercentClip. Корректные значения находятся в диапазоне от 0 до 99. (Значение по умолчанию — None)	Double
max_percent	Укажите процент высоких значений, которые следует исключить, когда выбрана растяжка PercentClip. Корректные значения находятся в диапазоне от 0 до 99. (Значение по умолчанию — None)	Double
gamma	Укажите гамма-значения для каждого канала, которые следует применить к изображению. Например, трехканальное изображение должно иметь три значения, такие как [<gamma1>, <gamma2>, <gamma3>]. (Значение по умолчанию — None)	Double
compute_gamma	Вычисляет наилучшее значение гамма для отображения экспортированного изображения на основе эмпирической модели. True - гамма значения для изображения будут вычислены. False - гамма значения для изображения не будут вычислены. (Значение по умолчанию — None)	Boolean
sigmoid_strength_level	Определяет, насколько сильно будет использоваться сигмоидальная функция растяжки. При низком значении (например, 1) будет использоваться только средняя часть кривой, которая воспроизводит, главным образом, тусклые и слабые цвета. При высоком значении (например 6) будет использоваться вся кривая, что способствует воспроизведению сочных и ярких цветов. Допустимым является диапазон от 1 до 6. (Значение по умолчанию — None)	Integer

Возвращаемое значение

Тип данных	Описание
Raster	Выходной растр с растяжкой.

Пример кода

Пример Stretch

Улучшает внешний вид изображения путем изменения его свойств, таких как яркость, контрастность и гамма, посредством нескольких типов растяжки на основе статистики.

import arcpy

Stretch_raster = arcpy.ia.Stretch(imagePath1, "PercentClip", None, None, None, None, True, 0.25, 0.75, None, None, None)