Доступно с лицензией Spatial Analyst.
Краткая информация
Вычисляет количество на единицу площади (плотность) полилинейных объектов, попадающих в пределы радиуса вокруг каждой ячейки.
Более подробно о том, как работает инструмент Плотность линий
Иллюстрация
Использование
При вычислении плотности учитывается только та часть линии, которая попадает в заданную область соседства. Если в область соседства конкретной ячейки не попадает никаких линий, такой ячейке будет присвоено значение NoData.
Более высокие значения для параметра радиуса приводят к построению более генерализованного растра плотности. Более низкие значения приводят к построению растра, на котором показано большее количество деталей.
Если коэффициент преобразования для единиц измерения площади мал относительно объектов (длин сегментов линии), выходные значения могут быть очень маленькими. Чтобы получить более высокие значения, выберите коэффициент масштаба для единиц площади для более крупных единиц измерения (например, квадратные километры, а не квадратные метры).
Значения на выходном растре всегда будут представлены значениями с плавающей точкой.
См. раздел Параметры среды анализа и Spatial Analyst для получения дополнительной информации о среде геообработки данного инструмента.
Синтаксис
LineDensity (in_polyline_features, population_field, {cell_size}, {search_radius}, {area_unit_scale_factor})
Параметр | Объяснение | Тип данных |
in_polyline_features | Входные линейные объекты, для которых вычисляется плотность. | Feature Layer |
population_field | Числовое поле, определяющие значения величины (population) (количество раз подсчета линии) для каждой полилинии. Значения в поле численности могут быть целочисленными или с плавающей точкой. Опции и поведение по умолчанию для поля перечислены ниже.
| Field |
cell_size (Дополнительный) | Размер ячейки для выходного набора растровых данных. Значение, устанавливаемое в параметрах среды. Если параметры среды не установлены, размер ячейки определяется, как более короткий размер экстента выходных объектов (ширины или высоты) в выходной пространственной привязке, деленный на 250. | Analysis Cell Size |
search_radius (Дополнительный) | Радиус поиска, в пределах которого будет вычислена плотность. Единицы измерения выбираются, основываясь на линейных единицах проекции пространственной привязки выходных данных. Например, если единицы в метрах, то для того, чтобы включить все пространственные объекты в пределах окрестности радиусом 1 миля, установите радиус поиска равным 1609,344 (1 миля = 1609,344 метра). По умолчанию, используется значение меньшего из размеров ширины или высоты экстента выходных объектов на выходной пространственной привязке, деленное на 30. | Double |
area_unit_scale_factor (Дополнительный) | Желаемые единицы измерения площади выходных значений плотности. По умолчанию единицы измерения выбираются на основе линейных единиц выходной пространственной привязки. Можно изменить их на соответствующие единицы измерения, если вы хотите преобразовать выходные данные плотности. Значения для плотности линий преобразуют единицы измерения и длин, и площадей. Если выходная пространственная привязка не указана, то она будет такой же, что и у входного класса пространственных объектов. Единицы выходной плотности по умолчанию определяются по линейным единицам выходной пространственной привязки следующим образом. Если выходными линейными единицами измерения являются метры, то выходными площадными единицами измерения плотности будут установлены SQUARE_KILOMETERS, что обеспечивает вывод квадратных километров для точечных объектов или километров на квадратный километр для полилинейных объектов. Если выходными линейными единицами измерения являются футы, то выходными площадными единицами измерения плотности будут установлены SQUARE_MILES. Если выходными единицами измерения являются иные, чем футы или метры, единицы, то выходными площадными единицами измерения плотности будут установлены SQUARE_MAP_UNITS. Таким образом единицы выходной плотности будут квадратом линейных единиц выходной пространственной привязки. Например, если выходными линейными единицами измерения являются сантиметры, то выходными площадными единицами измерения плотности будут SQUARE_MAP_UNITS, что приводит к результату в квадратных сантиметрах. Если выходными линейными единицами измерения являются километры, то выходными площадными единицами измерения плотности будут SQUARE_MAP_UNITS, что приводит к результату в квадратных километрах. Доступными опциями и соответствующими им выходными единицами измерения плотности являются следующие:
| String |
Возвращаемое значение
Название | Объяснение | Тип данных |
out_raster | Выходной растр плотности линий. Это всегда растр с плавающей точкой. | Raster |
Пример кода
LineDensity, пример 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")
LineDensity, пример 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")
Параметры среды
- Автоподтверждение (Auto Commit)
- Размер ячейки (Cell size)
- Текущая рабочая область (Current Workspace)
- Экстент (Extent)
- Географические преобразования (Geographic Transformations)
- Маска (Mask)
- Выходное ключевое слово CONFIG (Output CONFIG Keyword)
- Выходная система координат (Output Coordinate System)
- Временная рабочая область (Scratch Workspace)
- Растр привязки (Snap Raster)
- Размер листа (Tile Size)
Информация о лицензиях
- ArcGIS Desktop Basic: Требует Spatial Analyst
- ArcGIS Desktop Standard: Требует Spatial Analyst
- ArcGIS Desktop Advanced: Требует Spatial Analyst