描述
将输入要素类或图层中的要素复制到新要素类。如果输入是具有选定内容的图层,则仅复制所选要素。如果输入是地理数据库要素类或 shapefile,则会复制所有要素。
使用
输入要素的几何特征和属性特征都将被复制到输出要素类。
此工具可用于进行数据转换,因为它可以读取多种要素格式(任何可添加到地图中的格式),并且可将这些要素格式写入 shapefile 或地理数据库中。
语法
CopyFeatures(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 (可选) | 如果输出为地理数据库,则将应用地理数据库配置关键字。 | String |
spatial_grid_1 (可选) |
输出空间格网 1、2 和 3 参数仅适用于文件地理数据库和某些企业级地理数据库要素类。如果对设置格网大小不熟悉,则将这些选项保留为 0,0,0,然后 ArcGIS 会为您计算最佳大小。有关此参数的详细信息,请参阅添加空间索引工具文档。 | Double |
spatial_grid_2 (可选) |
第二个空间格网的像元大小。如果您只需要一个格网,则将大小设置为 0。否则,至少将大小设置为比输出空间格网 1 大三倍。 | Double |
spatial_grid_3 (可选) |
第三个空间格网的像元大小。如果您只需要两个格网,则将大小设置为 0。否则,至少将大小设置为比输出空间格网 2 大三倍。 | Double |
代码示例
复制要素 (CopyFeatures) 示例(Python 窗口)
以下 Python 窗口脚本演示了如何在即时模式下使用 CopyFeatures 工具。
import arcpy
arcpy.env.workspace = "C:/data"
arcpy.CopyFeatures_management("climate.shp", "C:/output/output.gdb/climate")
复制要素 (CopyFeatures) 示例 2(独立脚本)
以下独立脚本演示了如何使用 CopyFeatures 将文件夹中的 shapefile 复制到文件地理数据库中。
# 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
out_workspace = "c:/output/output.gdb"
# Use ListFeatureClasses to generate a list of shapefiles in the workspace
# shown above.
fc_list = arcpy.ListFeatureClasses()
# Execute CopyFeatures for each input shapefile
for shapefile in fc_list:
# Determine the new output feature class path and name
out_featureclass = os.path.join(out_workspace,
os.path.splitext(shapefile)[0])
arcpy.CopyFeatures_management(shapefile, out_featureclass)
环境
许可信息
- Basic: 是
- Standard: 是
- Advanced: 是