Растяжение (Spatial Analyst)

Доступно с лицензией Spatial Analyst.

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

Растягивает (расширяет) выбранные зоны растра на заданное количество ячеек.

Более подробно о том, как работает инструмент Растяжение

Иллюстрация

Иллюстрация инструмента Растяжение
OutRas = Expand(InRas1, 1, 5)

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

  • Определенные значения зоны считаются передними зонами, в то время как остальные значения зоны считаются фоновыми. С помощью этого инструмента значения зон переднего плана могут быть расширены в зоны фоновых значений.

  • Когда на расширение в одну и ту же фоновую зону претендуют две приоритетные зоны, конфликт разрешается на основе значения большинства окружающих ячеек.

  • Ячейки с значением NoData всегда рассматриваются как фоновые; следовательно, в ячейки с значением NoData могут быть расширены соседние ячейки с любым значением. Ячейки NoData никогда не будут расширены в соседние ячейки.

  • См. раздел Параметры среды анализа и Spatial Analyst для получения дополнительной информации о среде геообработки данного инструмента.

Параметры

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

Входной растр, для которого будут растянуты определенные зоны

Должен быть целочисленным.

Raster Layer
Число ячеек

Количество ячеек, на которое будет расширена каждая заданная зона.

Значение должно быть целым числом больше 1.

Long
Значения зоны

Перечень значений зон для растяжения.

Значения зон должны быть представлены целыми числами. Они могут быть даны в любом порядке.

Long
Метод растяжения
(Дополнительный)

Метод, используемый для расширения выбранных зон.

Опция Расстояние поддерживает распараллеливание и может управляться с помощью параметра среды Коэффициент параллельной обработки.

  • МорфологическийДля расширения зон используется метод математической морфологии. Это значение по умолчанию
  • РасстояниеДля расширения зон используется метод на основе расстояния.
String

Возвращаемое значение

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

Выходной генерализованный растр.

Заданные зоны входного растра будут растянуты на заданное количество ячеек.

Выходные данные всегда будут целочисленными.

Raster

Expand(in_raster, number_cells, zone_values, {expand_method})
ИмяОписаниеТип данных
in_raster

Входной растр, для которого будут растянуты определенные зоны

Должен быть целочисленным.

Raster Layer
number_cells

Количество ячеек, на которое будет расширена каждая заданная зона.

Значение должно быть целым числом больше 1.

Long
zone_values
[zone_value,...]

Перечень значений зон для растяжения.

Значения зон должны быть представлены целыми числами. Они могут быть даны в любом порядке.

Long
expand_method
(Дополнительный)

Метод, используемый для расширения выбранных зон.

  • MORPHOLOGICALДля расширения зон используется метод математической морфологии. Это значение по умолчанию
  • DISTANCEДля расширения зон используется метод на основе расстояния.

Опция DISTANCE поддерживает распараллеливание и может управляться с помощью параметра среды parallelProcessingFactor.

String

Возвращаемое значение

ИмяОписаниеТип данных
out_raster

Выходной генерализованный растр.

Заданные зоны входного растра будут растянуты на заданное количество ячеек.

Выходные данные всегда будут целочисленными.

Raster

Пример кода

Expand, пример 1 (окно Python)

В этом примере расширяется зона, определенная в списке значений, на две ячейки.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outExpand = Expand("filter", 2, [0, 6, -3])
outExpand.save("C:/sapyexamples/output/outexpand.img")
Expand, пример 2 (автономный скрипт)

В этом примере расширяется зона, определенная в списке значений, на две ячейки.

# Name: Expand_Ex_02.py
# Description: Expands specified zones of a raster 
#              by a specified number of cells.
# Requirements: Spatial Analyst Extension

# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *

# Set environment settings
env.workspace = "C:/sapyexamples/data"

# Set local variables
inRaster = "filter"
numberCells = 2
zoneValues = [0, 6, -3]

# Execute Expand
outExpand = Expand(inRaster, numberCells, zoneValues)

# Save the output 
outExpand.save("C:/sapyexamples/output/outexpand")

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