Краткая информация
Копирует объекты из входного класса пространственных объектов или слоя в новый класс объектов. Если входные данные являются слоем, где выбраны объекты, будут копироваться только выбранные объекты. Если входными данными является класс объектов базы геоданных или шейп-файл, будут скопированы все объекты.
Использование
Атрибуты и геометрия Входных объектов будут копироваться в выходной класс объектов.
Этот инструмент может использоваться для конвертации данных, поскольку он может считывать множество векторных форматов (все, которые можно добавить в ArcMap) и записывать их в шейп-файл или в базу геоданных (файловую, персональную или ArcSDE).
Синтаксис
CopyFeatures_management (in_features, out_feature_class, {config_keyword}, {spatial_grid_1}, {spatial_grid_2}, {spatial_grid_3})
Параметр | Объяснение | Тип данных |
in_features | Пространственные объекты, которые будут копироваться. | Feature Layer;Raster Catalog Layer |
out_feature_class | Создаваемый класс пространственных объектов, в который будут скопированы объекты. Если выходной класс объектов уже существует, и опция перезаписи включена, сначала будет удален существующий класс. Если выходной класс объектов уже существует, и опция перезаписи выключена, операция не сможет быть выполнена. | Feature Class |
config_keyword (дополнительно) | Если выходные данные записываются в файловую или ArcSDE базу геоданных, можете использовать ключевое слово конфигурации базы геоданных. | String |
spatial_grid_1 (дополнительно) | Параметры Пространственная сетка 1, 2 и 3 (Spatial Grid 1, 2, and 3) применяются только к файловым базам геоданных и к некоторым классам пространственных объектов в базах геоданных рабочей группы и корпоративных. Если вы не знакомы с установкой размеров сетки, оставьте эти опции как 0,0,0, и ArcGIS вычислит оптимальные для вас размеры. Чтобы узнать больше об этом параметре, обратитесь к документации инструмента Добавить пространственный индекс (Add Spatial Index). | Double |
spatial_grid_2 (дополнительно) | Размер ячейки второй пространственной сетки. Оставьте размер равным 0, если вам нужна только одна сетка. В противном случае, задайте размер по крайней мере в три раза больше, чем Пространственная сетка 1 (Spatial Grid 1). | Double |
spatial_grid_3 (дополнительно) | Размер ячейки третьей пространственной сетки. Оставьте размер равным 0, если вам нужно только две сетки. В противном случае, задайте размер, по крайней мере, в три раза больше, чем Пространственная сетка 2 (Spatial Grid 2). | Double |
Пример кода
CopyFeatures пример (окно Python)
Пример скрипта Python для инструмента CopyFeatures, с запуском из окна Python в ArcGIS.
import arcpy
arcpy.env.workspace = "C:/data"
arcpy.CopyFeatures_management("climate.shp", "C:/output/output.gdb/climate")
CopyFeatures пример 2 (автономный скрипт)
Следующий автономный скрипт демонстрирует использование функции CopyFeatures для копирования нескольких шейп-файлов из папки в файловую базу геоданных.
# Name: CopyFeatures_Example2.py
# Description: Convert all shapefiles in a folder to geodatabase feature classes
# Import system modules
import arcpy
import os
# Set environment settings
arcpy.env.workspace = "C:/data"
# Set local variables
outWorkspace = "c:/output/output.gdb"
# Use ListFeatureClasses to generate a list of shapefiles in the
# workspace shown above.
fcList = arcpy.ListFeatureClasses()
# Execute CopyFeatures for each input shapefile
for shapefile in fcList:
# Determine the new output feature class path and name
outFeatureClass = os.path.join(outWorkspace, shapefile.strip(".shp"))
arcpy.CopyFeatures_management(shapefile, outFeatureClass)
Параметры среды
- Текущая рабочая область (Current Workspace)
- Временная рабочая область (Scratch Workspace)
- Выходная система координат (Output Coordinate System)
- Географические преобразования (Geographic Transformations)
- Экстент (Extent)
- Разрешение XY (XY Resolution)
- Допуск XY (XY Tolerance)
- Выходные данные содержат значения M (Output has M values)
- Разрешение M (M Resolution)
- Допуск M (M Tolerance)
- Выходные данные содержат Z значения (Output has Z values)
- Выходное значение Z по умолчанию (Default Output Z Value)
- Разрешение Z (Z Resolution)
- Допуск Z (Z Tolerance)
- Стандартизированные имена полей (Qualified Field Names)
- Выходное ключевое слово CONFIG (Output CONFIG Keyword)
- Автоподтверждение (Auto Commit)
- Выходная пространственная сетка 1
- Выходная пространственная сетка 2
- Выходная пространственная сетка 3
- Выходной XY домен (Output XY Domain)
- Выходной домен M (Output M Domain)
- Выходной домен Z (Output Z Domain)