ArcMap

Построить область исключения

Сводка

Скрывает пикселы на основе их цвета или посредством вырезания диапазона значений. Выходные данные этого инструмента используются для инструмента Цветовой баланс набора данных мозаики, чтобы убрать такие области, как облака и вода, которые могут исказить статистику, используемую для настройки цветового баланса нескольких изображений.

Использование

  • Этот инструмент используется для исключения областей, трудных для коррекции цвета, таких как вода, облака и аномальные области.

  • Выходные данные этого инструмента могут использоваться в инструменте Цветовой баланс набора данных мозаики для исключения пикселов (и цветов) из алгоритма, используемого для цветовой коррекции набора данных мозаики.

Синтаксис

arcpy.management.GenerateExcludeArea(in_raster, out_raster, pixel_type, generate_method, {max_red}, {max_green}, {max_blue}, {max_white}, {max_black}, {max_magenta}, {max_cyan}, {max_yellow}, {percentage_low}, {percentage_high})
ПараметрОбъяснениеТип данных
in_raster

Растровый слой или слой набора данных мозаики, который вы хотите скрыть.

Mosaic Dataset; Composite Layer; Raster Dataset; Raster Layer
out_raster

Имя, местоположение и формат создаваемого набора данных. При сохранении набора растровых данных в базе геоданных расширение файла к имени набора растровых данных добавлять не нужно. При хранении набора растровых данных в файле JPEG, файле JPEG 2000 или базе геоданных, вы можете указать тип Сжатия и Качество сжатия в настройках Параметров среды.

Raster Dataset
pixel_type

Выберите глубину пикселов входного набора растровых данных. Значением по умолчанию является 8-бит; для растровых наборов данных с глубиной больше, чем 8-бит, значения цветовой маски и гистограммы должны быть соразмерно скорректированы.

  • 8_BIT —Входной набор растровых данных имеет значения от 0 до 255. Используется по умолчанию.
  • 11_BIT —Входной набор растровых данных имеет значения от 0 до 2047.
  • 12_BIT —Входной набор растровых данных имеет значения от 0 до 4095.
  • 16_BIT —Входной набор растровых данных имеет значения от 0 до 65535.
String
generate_method

Создайте маску на основе цвета пикселов или посредством вырезания высоких и низких значений.

  • COLOR_MASK —Установите максимальные значения цвета для выходных данных. Используется по умолчанию.
  • HISTOGRAM_PERCENTAGE —Уберите процент высоких и низких значений пикселов.
String
max_red
(Дополнительный)

Максимальное исключаемое значение красного. Значение по умолчанию равно 255.

Double
max_green
(Дополнительный)

Максимальное исключаемое значение зеленого. Значение по умолчанию равно 255.

Double
max_blue
(Дополнительный)

Максимальное исключаемое значение синего. Значение по умолчанию равно 255.

Double
max_white
(Дополнительный)

Максимальное исключаемое значение белого. Значение по умолчанию равно 255.

Double
max_black
(Дополнительный)

Максимальное исключаемое значение черного. Значение по умолчанию равно 0.

Double
max_magenta
(Дополнительный)

Максимальное исключаемое значение пурпурного. Значение по умолчанию равно 255.

Double
max_cyan
(Дополнительный)

Максимальное исключаемое значение голубого. Значение по умолчанию равно 255.

Double
max_yellow
(Дополнительный)

Максимальное исключаемое значение желтого. Значение по умолчанию равно 255.

Double
percentage_low
(Дополнительный)

Уберите этот процент самых низких значений пикселов. Значение по умолчанию равно 0.

Double
percentage_high
(Дополнительный)

Уберите этот процент самых высоких значений пикселов. По умолчанию используется 100.

Double

Пример кода

Построить область исключения Пример 1 (окно Python)

Это пример скрипта Python для GenerateExcludeArea.

import arcpy
arcpy.GenerateExcludeArea_management("C:/workspace/fgdb.gdb/mosdata",
                               "C:/workspace/excludeArea.tif","8_BIT",
                               "COLOR_MASK","255","255","255","255","15",
                               "255","255","255","0","100")
GenerateExcludeArea, пример 2 (автономный скрипт)

Это пример скрипта Python для GenerateExcludeArea.

##===========================
##Generate Exclude Area
##Usage: GenerateExcludeArea_management in_raster out_raster 8_BIT | 11_BIT | 
##                                      12_BIT | 16_BIT COLOR_MASK | HISTOGRAM_PERCENTAGE
##                                      {max_red} {max_green} {max_blue} {max_white} 
##                                      {max_black} {max_magenta} {max_cyan}
##                                      {max_yellow} {percentage_low} {percentage_high}

import arcpy
arcpy.env.workspace = "c:/workspace"

# Generate exclude area dataset from raster dataset with Histogram
arcpy.GenerateExcludeArea_management("srcimage.tif", "exarea.tif", "8_BIT",
                                     "HISTOGRAM_PERCENTAGE", "", "", "", "",
                                     "", "", "", "", "10", "100")                                      

# Generate exclude area dataset from mosaic dataset with Color Mask
arcpy.GenerateExcludeArea_management("CC.gdb/srcmd", "exarea.tif", "8_BIT",
                                     "COLOR_MASK", "255", "200", "50", "255",
                                     "10", "210", "100", "255", "", "")

Параметры среды

Информация о лицензиях

  • Basic: Нет
  • Standard: Да
  • Advanced: Да

Связанные разделы