创建要素类 (数据管理)

描述

在地理数据库中创建空要素类,或在文件夹中创建 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)

许可信息

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

相关主题