Плотность линий (Line Density) (Spatial Analyst)

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

Резюме

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

Более подробно о том, как работает инструмент Плотность линий (Line Density)

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

Синтаксис

LineDensity (in_polyline_features, population_field, {cell_size}, {search_radius}, {area_unit_scale_factor})
ПараметрОбъяснениеТип данных
in_polyline_features

Входные линейные объекты, для которых вычисляется плотность.

Feature Layer
population_field

Числовое поле, определяющие значения величины (population) (количество раз подсчета линии) для каждой полилинии.

Значения в поле численности могут быть целочисленными или с плавающей точкой.

Опции и поведение по умолчанию для поля перечислены ниже.

  • Используйте значение None (Нет), если не будет использовано какого-либо показателя или специального значения, и каждый объект будет подсчитан один раз.

  • Вы можете использовать Shape, если входные объекты содержат Z.

  • В противном случае, полем по умолчанию будет POPULATION. Также могут применяться следующие условия.

    • Если нет поля с именем POPULATION, но есть поле с именем POPULATIONxxxx, по умолчанию будет использовано оно. Часть названия, обозначенная в данном случае как «xxxx», может быть любым действительным символом, например, название поля может быть следующим: POPULATION6, POPULATION1974 или POPULATIONROADTYPE.
    • Если нет поля с именем POPULATION или POPULATIONxxxx, но есть поле с именем POP, именно оно будет использовано по умолчанию.
    • Если нет поля с именем POPULATION, или POPULATIONxxxx, или POP, но есть поле с именем POPxxxx, именно оно будет использовано по умолчанию.
    • Если нет поля с именем POPULATION, или POPULATIONxxxx, или POP, или POPxxxx, по умолчанию будет использовано значение NONE.
Field
cell_size
(дополнительно)

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

Значение, устанавливаемое в параметрах среды. Если параметры среды не установлены, размер ячейки определяется, как более короткий размер экстента выходных объектов (ширины или высоты) в выходной пространственной привязке, деленный на 250.

Analysis Cell Size
search_radius
(дополнительно)

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

Например, если единицы в метрах, чтобы включить все пространственные объекты в окрестность в 1 милю, установите радиус поиска на 1609,344 (1 миля = 1609,344 метра).

По умолчанию, используется значение меньшего из размеров ширины или высоты экстента выходных объектов на выходной пространственной привязке, деленное на 30.

Double
area_unit_scale_factor
(дополнительно)

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

По умолчанию единицы измерения выбираются, основываясь на линейных единицах проекции пространственной привязки выходных данных. Можно изменить их на соответствующие единицы измерения, если вы хотите преобразовать выходные данные плотности. Значения для плотности линий преобразуют единицы измерения и длин, и площадей.

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

Единицы плотности по умолчанию, на основе единиц измерения входных объектов:

  • SQUARE_MAP_UNITS Если единицы неизвестны, точки или десятичные градусы.
  • SQUARE_MILES Для футов, ярдов, миль и морских миль.
  • SQUARE_KILOMETERS Для метров или километров.
  • SQUARE_INCHES Для дюймов.
  • SQUARE_CENTIMETERS Для сантиметров.
  • SQUARE_MILLIMETERS Для миллиметров.
String

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

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

Выходной растр плотности линий.

Это всегда растр с плавающей точкой.

Raster

Пример кода

Плотность линий. Пример 1 (окно Python)

В этом примере вычисляется растр плотности на поле длины полилинейного шейп-файла.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outLDens = LineDensity("roads.shp", "LENGTH", 45, 1000, "SQUARE_MILES") 
outLDens.save("C:/sapyexamples/output/ldensout")
Плотность линий. Пример 2 (автономный скрипт)

В этом примере вычисляется растр плотности на поле длины полилинейного шейп-файла.

# Name: LineDensity_Ex_02.py
# Description: Calculates a magnitude per unit area from polyline features
#    that fall within a radius around each cell.
# 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
inPolylineFeatures = "roads.shp"
populationField = "length"
cellSize = 120
searchRadius = 1500

# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")

# Execute LineDensity
outLineDensity = LineDensity(inPolylineFeatures, populationField, cellSize,
                             searchRadius, "SQUARE_MILES") 

# Save the output 
outLineDensity.save("C:/sapyexamples/output/linedensity")

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

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

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

ArcGIS for Desktop Basic: Требует Spatial Analyst
ArcGIS for Desktop Standard: Требует Spatial Analyst
ArcGIS for Desktop Advanced: Требует Spatial Analyst
9/11/2013