ArcMap

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

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

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

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

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

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

Синтаксис

GenerateExcludeArea_management (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 или базе геоданных, вы можете указать тип Сжатия (Compression) и Качество сжатия (Compression Quality) в настройках Параметров среды.

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 для инструмента Построить область исключения (Generate Exclude Area).

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 для инструмента Построить область исключения (Generate Exclude Area).

##===========================
##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", "", "")

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

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

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

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