2025-12-27 09:09:52

创建要素类 (数据管理)

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}, {oid_type})名称说明数据类型out_path将在其中创建输出要素类的企业级地理数据库、文件地理数据库或文件夹。 此工作空间必须已经存在。

Workspace; Feature Datasetout_name要创建的要素类的名称。

Stringgeometry_type(可选)指定输出要素类的几何类型。

POINT—该几何类型将为点。MULTIPOINT—该几何类型将为多点。POLYGON—该几何类型将为面。POLYLINE—该几何类型将为折线。MULTIPATCH—几何类型将为多面体。Stringtemplate[template,...](可选)现有数据集或数据集列表，用作定义新要素类属性字段的模板。

Table Viewhas_m(可选)指定要素类是否包含线性测量值（m 值）。

DISABLED—输出要素类将不具有 m 值。 这是默认设置。ENABLED—输出要素类将具有 m 值。SAME_AS_TEMPLATE—如果在模板要素类参数（Python 中的 template 参数）中指定的数据集具有 m 值，则输出要素类将具有 m 值。Stringhas_z(可选)指定要素类是否包含高程值（z 值）。

DISABLED—输出要素类将不具有 z 值。 这是默认设置。ENABLED—输出要素类将具有 z 值。SAME_AS_TEMPLATE—如果模板要素类参数（Python 中的 template 参数）中指定的数据集具有 z 值，则输出要素类将具有 z 值。Stringspatial_reference(可选)

输出要素数据集的空间参考。 可通过以下方式指定空间参考：

输入 .prj 文件的路径，例如 C:/workspace/watershed.prj。引用包含要应用的空间参考的要素类或要素数据集，例如 C:/workspace/myproject.gdb/landuse/grassland。在使用此工具之前定义空间参考对象，例如之后要用作空间参考参数的 sr = arcpy.SpatialReference("Sinusoidal (Africa)")。

注：此参数为可选项，但建议提供一个值。 如果未提供任何空间参考，则输出将使用未定义的空间参考。

注：模板要素类值的空间参考对输出空间参考没有影响。 如果想在模板要素类值的坐标系中输出，请将坐标系参数设置为模板要素类值的空间参考。

Spatial Referenceconfig_keyword(可选)配置关键字仅适用于企业级地理数据库数据。 它用于确定数据库表的存储参数。

Stringspatial_grid_1(可选)不支持此参数。 提供的任何值都将被忽略。

Doublespatial_grid_2(可选)不支持此参数。 提供的任何值都将被忽略。

Doublespatial_grid_3(可选)不支持此参数。 提供的任何值都将被忽略。

Doubleout_alias(可选)将创建输出要素类的备用名称。

Stringoid_type(可选)指定输出对象 ID 字段将为 32 位，还是 64 位。

SAME_AS_TEMPLATE—输出对象 ID 字段类型（32 位或 64 位）将与第一个模板数据集的对象 ID 字段相同。 这是默认设置。64_BIT—输出对象 ID 字段将为 64 位。32_BIT—输出对象 ID 字段将为 32 位。String派生输出名称说明数据类型out_feature_class新要素类。

Feature Class代码示例CreateFeatureclass 示例（Python 窗口）

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

import arcpy

arcpy.env.workspace = "C:/data"

arcpy.management.CreateFeatureclass("C:/output", "habitatareas.shp", "POLYGON",

"study_quads.shp", "DISABLED", "DISABLED",

"C:/workspace/landuse.shp")CreateFeatureclass 示例 2（独立脚本）

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

# 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

# Run CreateFeatureclass

arcpy.management.CreateFeatureclass(out_path, out_name, geometry_type, template,

has_m, has_z, spatial_ref)