Краткая информация
Создает класс пространственных объектов, содержащий простые объекты, созданные путем разделения составных входных объектов.
Рисунок
Использование
Атрибуты входных объектов будут скопированы в выходной класс объектов. Новое поле ORIG_FID будет добавлено к выходному классу объектов, оно будет содержать ID входных объектов.
Каждая часть составного входного объекта станет отдельным простым объектом в выходном классе объектов. Пространственные объекты, которые уже являются простыми, не будут подвержены влиянию.
Большинство типов выходных объектов будут такими же, как входные (входные полигоны останутся полигонами; входные линии останутся линиями). Единственным исключением является случай, если входные объекты – мультиточечного типа, выходной класс объектов будет типа точек.
Для восстановления составных объектов на основе значения общего поля, например, ORIG_FID, используйте инструмент Слияние по атрибуту.
Синтаксис
MultipartToSinglepart_management (in_features, out_feature_class)
Параметр | Объяснение | Тип данных |
in_features | Входные объекты могут быть любого типа геометрии. | Feature Layer |
out_feature_class | Выходной класс объектов, содержащий пространственные объекты, которые варьируются с типом входных объектов. | Feature Class |
Пример кода
Составной в простые. Пример 1 (окно Python)
Пример скрипта Python для выполнения функции MultipartToSinglepart с запуском из окна Python в ArcGIS.
import arcpy
arcpy.env.workspace = "C:/data"
arcpy.MultipartToSinglepart_management("landuse.shp",
"c:/output/output.gdb/landuse_singlepart")
MultipartToSinglepart, пример 2 (автономный скрипт)
пример скрипта Python для выполнения функции Multipart To Singlepart в автономном режиме.
# Name: MultipartToSinglepart_Example2.py
# Description: Break all multipart features into singlepart features,
# and report which features were separated.
# Import system modules
import arcpy
# Create variables for the input and output feature classes
inFeatureClass = "c:/data/gdb.gdb/vegetation"
outFeatureClass = "c:/data/gdb.gdb/vegetation_singlepart"
try:
# Create list of all fields in inFeatureClass
fieldNameList = [field.name for field in arcpy.ListFields(inFeatureClass)]
# Add a field to the input this will be used as a unique identifier
arcpy.AddField_management(inFeatureClass, "tmpUID", "double")
# Determine what the name of the Object ID is
OIDFieldName = arcpy.Describe(inFeatureClass).OIDFieldName
# Calculate the tmpUID to the OID
arcpy.CalculateField_management(inFeatureClass, "tmpUID",
"!" + OIDFieldName + "!", "PYTHON")
# Run the tool to create a new fc with only singlepart features
arcpy.MultipartToSinglepart_management(inFeatureClass, outFeatureClass)
# Check if there is a different number of features in the output
# than there was in the input
inCount = int(arcpy.GetCount_management(inFeatureClass).getOutput(0))
outCount = int(arcpy.GetCount_management(outFeatureClass).getOutput(0))
if inCount != outCount:
# If there is a difference, print out the FID of the input
# features which were multipart
arcpy.Frequency_analysis(outFeatureClass,
outFeatureClass + "_freq", "tmpUID")
# Use a search cursor to go through the table, and print the tmpUID
print("Multipart features from {0}".format(inFeatureClass))
for row in arcpy.da.SearchCursor(outFeatureClass + "_freq",
["tmpUID"], "FREQUENCY > 1"):
print(int(row[0]))
else:
print("No multipart features were found")
except arcpy.ExecuteError:
print(arcpy.GetMessages())
except Exception as err:
print(err.args[0])
Параметры среды
- Текущая рабочая область (Current Workspace)
- Временная рабочая область (Scratch Workspace)
- Выходное значение Z по умолчанию (Default Output Z Value)
- Разрешение M (M Resolution)
- Допуск M (M Tolerance)
- Выходной домен M (Output M Domain)
- Выходной домен Z (Output Z Domain)
- Выходная система координат (Output Coordinate System)
- Экстент (Extent)
- Выходные данные содержат значения M (Output has M values)
- Выходные данные содержат Z значения (Output has Z values)
- Выходная пространственная сетка 1
- Выходная пространственная сетка 2
- Выходная пространственная сетка 3
- Разрешение XY (XY Resolution)
- Допуск XY (XY Tolerance)
- Разрешение Z (Z Resolution)
- Допуск Z (Z Tolerance)