创建要素类 (数据管理)

摘要

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

已在 AllSource 中弃用此参数。将忽略您输入的任何值。

Double
输出空间格网 2
(可选)

已在 AllSource 中弃用此参数。将忽略您输入的任何值。

Double
输出空间格网 3
(可选)

已在 AllSource 中弃用此参数。将忽略您输入的任何值。

Double
要素类别名
(可选)

将创建输出要素类的备用名称。

String

派生输出

标注说明数据类型
输出要素类

新要素类。

Feature Class

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
(可选)

已在 AllSource 中弃用此参数。将忽略您输入的任何值。

Double
spatial_grid_2
(可选)

已在 AllSource 中弃用此参数。将忽略您输入的任何值。

Double
spatial_grid_3
(可选)

已在 AllSource 中弃用此参数。将忽略您输入的任何值。

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)