创建要素类 (数据管理)

摘要

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

使用情况

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

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

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

参数

对话框

标注	说明	数据类型
要素类位置	将在其中创建输出要素类的企业级地理数据库、文件地理数据库或文件夹。 此工作空间必须已经存在。	Workspace; Feature Dataset
要素类名称	要创建的要素类的名称。	String
几何类型 (可选)	指定输出要素类的几何类型。 点—该几何类型将为点。 多点—该几何类型将为多点。 面—该几何类型将为面。 折线—该几何类型将为折线。 多面体—几何类型将为多面体。	String
模板数据集 (可选)	用作模板以定义新要素类的属性字段的要素类或表。	Table View
包含 M 值 (可选)	指定要素类是否包含线性测量值（m 值）。 否—输出要素类将不具有 m 值。 这是默认设置。 是—输出要素类将具有 m 值。 与模板要素类相同—如果在模板要素类参数（Python 中的 template 参数）中指定的数据集具有 m 值，则输出要素类将具有 m 值。	String
包含 Z 值 (可选)	指定要素类是否包含高程值（z 值）。 否—输出要素类将不具有 z 值。 这是默认设置。 是—输出要素类将具有 z 值。 与模板要素类相同—如果模板要素类参数（Python 中的 template 参数）中指定的数据集具有 z 值，则输出要素类将具有 z 值。	String
坐标系 (可选)	输出要素数据集的空间参考。在空间参考属性对话框中，可以选择、导入或新建坐标系。要设置空间参考的各个方面（例如，x,y 值域、z 值域、m 值域、分辨率或容差），请使用环境对话框。 如果未提供空间参考，则输出将具有一个未定义的空间参考。 注： 模板要素类的空间参考对输出空间参考没有影响。如果想在模板要素类的坐标系中输出，请将坐标系参数设置为模板要素类的空间参考。	Spatial Reference
配置关键字 (可选)	配置关键字仅适用于企业级地理数据库数据。 它用于确定数据库表的存储参数。	String
输出空间格网 1 (可选)	已在 ArcGIS Pro 中弃用此参数。将忽略您输入的任何值。	Double
输出空间格网 2 (可选)	已在 ArcGIS Pro 中弃用此参数。将忽略您输入的任何值。	Double
输出空间格网 3 (可选)	已在 ArcGIS Pro 中弃用此参数。将忽略您输入的任何值。	Double
要素类别名 (可选)	将创建输出要素类的备用名称。	String

派生输出

标注	说明	数据类型
输出要素类	新要素类。	Feature Class

Python

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	新要素类。	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 函数。

# 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

# Run CreateFeatureclass
arcpy.management.CreateFeatureclass(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: 是