创建要素类 (数据管理)

描述

在地理数据库中创建空要素类，或在文件夹中创建 shapefile。

使用方法

• 要素类位置参数值（地理数据库或文件夹）必须已经存在。

• 此工具只能创建简单要素类，如点、多点、面和折线。

• 此工具所创建的 shapefile 具有一个名为 ID 的整型字段。当您提供模板数据集参数值时，不会创建该 ID 字段。

语法

arcpy.management.CreateFeatureclass(out_path, out_name, {geometry_type}, {template}, {has_m}, {has_z}, {spatial_reference}, {config_keyword}, {spatial_grid_1}, {spatial_grid_2}, {spatial_grid_3}, {out_alias})

参数	说明	数据类型
out_path	将在其中创建输出要素类的企业级地理数据库、文件地理数据库或文件夹。此工作空间必须已经存在。	Workspace; Feature Dataset
out_name	要创建的要素类的名称。	String
geometry_type （可选）	用于指定要素类的几何类型。 POINT —几何类型为点。 MULTIPOINT —几何类型为多点。 POLYGON —几何类型为面。 POLYLINE —几何类型为折线。 MULTIPATCH —几何类型为多面体。	String
template [template,...] （可选）	用作模板以定义新要素类的属性字段的要素类或表。	Table View
has_m （可选）	指定要素类是否包含线性测量值（m 值）。 DISABLED —输出要素类将不具有 M 值。这是默认设置。 ENABLED —输出要素类将具有 M 值。 SAME_AS_TEMPLATE —如果在模板要素类参数（Python 中的 template 参数）中指定的数据集具有 M 值，则输出要素类将具有 M 值。	String
has_z （可选）	指定要素类是否包含高程值（z 值）。 DISABLED —输出要素类将不具有 Z 值。这是默认设置。 ENABLED —输出要素类将具有 Z 值。 SAME_AS_TEMPLATE —如果模板要素类参数（Python 中的 template 参数）中指定的数据集具有 Z 值，则输出要素类将具有 Z 值。	String
spatial_reference （可选）	输出要素数据集的空间参考。可通过以下方式指定空间参考： 输入 .prj 文件的路径，例如 C:/workspace/watershed.prj。 引用包含要应用的空间参考的要素类或要素数据集，例如 C:/workspace/myproject.gdb/landuse/grassland。 在使用此工具之前定义空间参考对象，例如之后要用作空间参考参数的 sr = arcpy.SpatialReference("C:/data/Africa/Carthage.prj")。 如果未提供空间参考，则输出将具有一个未定义的空间参考。 注： 模板要素类的空间参考对输出空间参考没有影响。如果想在模板要素类的坐标系中输出，请将坐标系参数设置为模板要素类的空间参考。	Spatial Reference
config_keyword （可选）	配置关键字仅适用于企业级地理数据库数据。它用于确定数据库表的存储参数。	String
spatial_grid_1 （可选）	已在 ArcGIS Pro 中弃用此参数。将忽略您输入的任何值。	Double
spatial_grid_2 （可选）	已在 ArcGIS Pro 中弃用此参数。将忽略您输入的任何值。	Double
spatial_grid_3 （可选）	已在 ArcGIS Pro 中弃用此参数。将忽略您输入的任何值。	Double
out_alias （可选）	将创建输出要素类的备用名称。	String

派生输出

名称	说明	数据类型
out_feature_class	新要素类。	要素类

代码示例

CreateFeatureclass 示例（Python 窗口）

以下 Python 窗口脚本演示了如何在即时模式下使用 CreateFeatureclass 函数。

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.CreateFeatureclass_management("C:/output", "habitatareas.shp", "POLYGON", 
                                    "study_quads.shp", "DISABLED", "DISABLED", 
                                    "C:/workspace/landuse.shp")

CreateFeatureclass 示例 2（独立脚本）

以下 Python 脚本演示了如何在独立脚本中使用 CreateFeatureclass 函数。

# Name: CreateFeatureclass_Example2.py
# Description: Create a feature class to store the gnatcatcher habitat zones
# Import system modules
import arcpy
# Set workspace
arcpy.env.workspace = "C:/data"
# Set local variables
out_path = "C:/output"
out_name = "habitatareas.shp"
geometry_type = "POLYGON"
template = "study_quads.shp"
has_m = "DISABLED"
has_z = "DISABLED"
# Use Describe to get a SpatialReference object
spatial_ref = arcpy.Describe("C:/workspace/studyarea.shp").spatialReference
# Execute CreateFeatureclass
arcpy.CreateFeatureclass_management(out_path, out_name, geometry_type, template, 
                                    has_m, has_z, spatial_ref)

环境

输出坐标系, 地理变换, 输出包含 M 值, M 分辨率, M 容差, 输出 XY 值域, XY 分辨率, XY 容差, 默认输出 Z 值, 输出包含 Z 值, Z 容差, Z 分辨率, 输出配置关键字

许可信息

• Basic: 是
• Standard: 是
• Advanced: 是