Построить область исключения (Управление данными)

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

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

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

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

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

Параметры

ПодписьОписаниеТип данных
Входной растр

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

Mosaic Dataset; Raster Dataset; Raster Layer
Выходной набор растровых данных

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

Raster Dataset
Тип пиксела

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

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

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

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

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

Double
Максимум зеленый
(Дополнительный)

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

Double
Максимум синий
(Дополнительный)

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

Double
Максимум белый
(Дополнительный)

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

Double
Максимум чёрный
(Дополнительный)

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

Double
Максимум пурпурный
(Дополнительный)

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

Double
Максимум голубой
(Дополнительный)

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

Double
Максимум жёлтый
(Дополнительный)

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

Double
Низкие проценты
(Дополнительный)

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

Double
Высокие проценты
(Дополнительный)

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

Double

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; 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

Пример кода

GenerateExcludeArea, пример 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", "", "")