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)