Сводка
Создает разбитые на пересечениях перекрывающиеся объекты из входных объектов. Число перекрывающихся объектов записывается в выходные объекты.
Иллюстрация
Использование
Тип геометрии выходных данных совпадает с типом геометрии входных данных, за исключением точечной геометрии. Для точечной геометрии выходные данные будут классом мультиточечных объектов, если имеется несколько входных классов пространственных объектов или классом точечных объектов, если есть один входной класс точечных пространственных объектов.
Выходные данные – объединение разбитых на пересечении входных объектов. Перекрытие между объектами с вертикальным смещением (геометрия с различными значениями z) оценивается так, как будто все объекты были помещены на одну плоскость.
Для полигональной геометрии любая область, которая занята двумя и более объектами, считается перекрытием. Для линейной геометрии только линии, которые непосредственно перекрываются (один сегмент линии совпадает с другим), считаются перекрывающимися. Пересекающиеся в точке линии перекрывающимися не считаются. Для точечной геометрии перекрывающимися считаются любые совпадающие точки.
К Выходному классу объектов будут добавлены следующие поля:
- COUNT_ – число выбранных объектов в слое.
- COUNT_FC – число отдельных классов объектов, перекрывающих объект
Остальные поля Входных объектов будут исключены из Выходного класса пространственных объектов.
При создании Выходной таблицы перекрытия она будет содержать только одну запись для каждого перекрытия. Например, если три входных объекта перекрывают одно и то же местоположение, таблица содержит три записи для этого местоположения - по одной для каждой перекрывающейся геометрии. В Выходной таблице перекрытий: имеются следующие поля:
- OVERLAP_OID - ObjectID связанного объекта Выходного класса объектов.
- ORIG_OID - ObjectID связанного объекта из Входных объектов
- ORIG_NAME - это поле будет добавлено при нескольких входных данных. Поле содержит имя входных данных.
Эта таблица позволяет связать каждое перекрытие с входными и выходными объектами.
Синтаксис
arcpy.analysis.CountOverlappingFeatures(in_features, out_feature_class, {min_overlap_count}, {out_overlap_table})| Parameter | Объяснение | Тип данных |
in_features [in_features,...] | Входные классы пространственных объектов или слои. Входными объектами могут быть точки, мультиточки, линии или полигоны. Если задано несколько входных данных, у них должна быть геометрия одинакового типа. | Feature Layer |
out_feature_class | Выходной класс пространственных объектов, содержащий число перекрытий. | Feature Class |
min_overlap_count (Дополнительный) | Ограничивает выходные данные только местоположениями, которые соответствуют заданному числу перекрытий или превышают его. Значение по умолчанию равно 1. | Long |
out_overlap_table (Дополнительный) | Выходная таблица с записями для каждой отдельной перекрывающейся геометрии. | Table |
Пример кода
Пример скрипта окна Python для использования функции CountOverlappingFeatures в режиме прямого запуска.
import arcpy
arcpy.env.workspace = r"C:\data\data.gdb"
arcpy.CountOverlappingFeatures_analysis("Viewsheds", "Viewshed_Overlaps")В следующем скрипте демонстрируется порядок использования функции CountOverlappingFeatures для получения числа перекрытий для трех перекрывающихся сете провайдера сотовой связи и применения параметра min_overlap_count для ограничения выходных данных только теми областями, где есть покрытие у всех трех провайдеров сотовой связи.
# CountOverlappingFeatures_Example_2.py
# Description: Count number of cellular service providers for given area
# Import the system modules
import arcpy
# Set current workspace
arcpy.env.workspace = r"C:\data\data.gdb"
# Set input parameters
provider_a = 'Provider_A_ServiceArea'
provider_b = 'Provider_B_ServiceArea'
provider_c = 'Provider_C_ServiceArea'
in_fcs = [provider_a, provider_b, provider_c]
# Set output feature names
out_fc = 'CellularProviders_Count'
out_tbl = 'CelluarProviders_Count_Tbl'
# Obtain overlap count for three overlapping input feature classes
# and use minimum_overlap_count parameter to limit the output to only
# those areas where all three overlap.
arcpy.CountOverlappingFeatures_analysis(in_fcs, out_fc, 3, out_tbl)Environments
Информация о лицензиях
- Basic: Да
- Standard: Да
- Advanced: Да