返回顶部

创建要素类 (数据管理)

在本主题中

  1. 摘要
  2. 使用情况
  3. 参数
  4. 环境
  5. 许可信息

摘要

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

使用情况

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

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

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

参数

对话框Python

标注说明数据类型
要素类位置

将在其中创建输出要素类的企业级地理数据库、文件地理数据库或文件夹。 此工作空间必须已经存在。

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

不支持此参数。 提供的任何值都将被忽略。

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

不支持此参数。 提供的任何值都将被忽略。

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

不支持此参数。 提供的任何值都将被忽略。

Double
要素类别名
(可选)

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

String
OID 类型
(可选)

指定输出对象 ID 字段将为 32 位，还是 64 位。

  • 与模板相同—输出对象 ID 字段类型（32 位或 64 位）将与第一个模板数据集的对象 ID 字段相同。 这是默认设置。
  • 64 位—输出对象 ID 字段将为 64 位。
  • 32 位—输出对象 ID 字段将为 32 位。
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}, {oid_type})
名称说明数据类型
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("Sinusoidal (Africa)")。

如果未提供空间参考，则输出将具有一个未定义的空间参考。

注：

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

Spatial Reference
config_keyword
(可选)

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

String
spatial_grid_1
(可选)

不支持此参数。 提供的任何值都将被忽略。

Double
spatial_grid_2
(可选)

不支持此参数。 提供的任何值都将被忽略。

Double
spatial_grid_3
(可选)

不支持此参数。 提供的任何值都将被忽略。

Double
out_alias
(可选)

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

String
oid_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)

环境

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

许可信息

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

相关主题

  • 要素类工具集概览
  • 查找地理处理工具

有关此主题的反馈?

在本主题中
  1. 摘要
  2. 使用情况
  3. 参数
  4. 环境
  5. 许可信息