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

Уровень лицензии:BasicStandardAdvanced

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

Позволяет задать область исключения на основе цветовой маски или процентов гистограммы. Выходные данные этого инструмента используются в инструменте Цветовой баланс набора данных мозаики (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

Путь к файлу и имя файла входного растра. Выходными данными будет набор растровых данных.

Выходные данные затем можно использовать как параметр Исключить область растра (Exclude Area Raster) в инструменте Цветовой баланс набора данных мозаики (Color Balance Mosaic Dataset).

Raster Dataset
pixel_type

Выберите глубину пикселов набора растровых данных. Этот параметр имеет важное значение, поскольку у любой высоты пикселов больше 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
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")
Построить область исключения. Пример 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}

try:
    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", "", "") 
    
    
except:
    print "Generate Exclude Area example failed."
    print arcpy.GetMessages()

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

Связанные темы

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

ArcGIS for Desktop Basic: Нет
ArcGIS for Desktop Standard: Да
ArcGIS for Desktop Advanced: Да
5/10/2014