要素类至要素类 (转换)

描述

将 shapefile、coverage 要素类或地理数据库要素类转换为 shapefile 或地理数据库要素类。

使用方法

  • 您可以使用字段映射来控制输出数据集中所有字段以及各字段中的内容。

    • 要更改字段顺序,请选择一个字段名称并将其拖动到首选位置。
    • 输出字段的默认数据类型与其所遇到的第一个名称相同的输入字段的数据类型相同。您可以随时将该数据类型手动更改为其他任何有效的数据类型。
    • 可以使用以下合并规则:first、last、join、sum、mean、median、mode、minimum、maximum、standard deviation 和 count。
    • 如果使用连接合并规则,则可指定分隔符,例如,空格、逗号、句点和短划线等。要使用空格,请确保指针位于输入框的起始位置处,然后按一次空格键。
    • 您可以使用格式选项来指定文本字段的起始和终止位置。
    • 请勿对单个输入执行标准差计算,因为数字不能被零除,因此标准差不适用于单个输入。

    了解有关在脚本中映射字段的详细信息

  • 可用于选择要素子集的 SQL 表达式。有关表达式参数的语法的更多详细信息,请参阅在查询表达式中使用的元素的 SQL 参考

  • 将包含子类型或域的地理数据库数据转换为 shapefile 时,子类型和域代码以及描述都将包含在输出中。使用传送字段属性域描述地理处理环境控制此行为。默认情况下,只有属性域和子类型代码才会被包含在输出中,描述不会被包含在输出中。

    注:

    转换为包含子类型和域描述的 shapefile 比转换为不包含描述的 shapefile 可能需要更多时间(降低性能)。如果在 shapefile 输出中不需要子类型和域描述,则建议取消选中传输字段域描述环境的(Python 中的 FalseNOT_TRANSFER_DOMAINS)默认行为以实现最佳性能。

语法

arcpy.conversion.FeatureClassToFeatureClass(in_features, out_path, out_name, {where_clause}, {field_mapping}, {config_keyword})
参数说明数据类型
in_features

要转换的要素类或要素图层。

Feature Layer
out_path

将创建输出要素类所在的位置。该位置可以是地理数据库或文件夹。如果输出位置是文件夹,则输出将为 shapefile。

Workspace;Feature Dataset
out_name

输出要素类的名称。

String
where_clause
(可选)

用于选择要素子集的 SQL 表达式。有关 SQL 语法的详细信息,请参阅帮助主题在 ArcGIS 中使用的查询表达式的 SQL 参考

SQL Expression
field_mapping
(可选)

控制输出中要包含的属性字段。默认情况下,将包括输入的所有字段。

可以添加、删除、重命名和重新排序字段,且可以更改其属性。

合并规则用于指定如何将两个或更多个输入字段的值合并或组合为一个输出值。有多种合并规则可用于确定如何用值填充输出字段。

  • First - 使用输入字段的第一个值。
  • Last - 使用输入字段的最后一个值。
  • Join - 串连(连接)输入字段的值。
  • Sum - 计算输入字段值的总和。
  • Mean - 计算输入字段值的平均值。
  • Median - 计算输入字段值的中值。
  • Mode - 使用具有最高频率的值。
  • Min - 使用所有输入字段值中的最小值。
  • Max - 使用所有输入字段值中的最大值。
  • Standard deviation - 对所有输入字段值使用标准差分类方法。
  • Count - 查找计算中所包含的记录数。

在 Python 中,您可使用 FieldMappings 类来定义此参数。

Field Mappings
config_keyword
(可选)

指定关系数据库管理系统 (RDBMS) 中的地理数据库的默认存储参数(配置)。此设置仅在使用企业级地理数据库表时可用。

配置关键字由数据库管理员进行设置。

了解有关配置关键字的详细信息

String

派生输出

名称说明数据类型
out_feature_class

输出要素类。

要素类

代码示例

FeatureClassToFeatureClass 示例 1(Python 窗口)

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

import arcpy
arcpy.env.workspace = "C:/data/GreenvalleyDB.gdb/Public Buildings"
arcpy.FeatureClassToFeatureClass_conversion("buildings_point", 
                                            "C:/output/output.gdb", 
                                            "buildings_point")
FeatureClassToFeatureClass 示例 2(独立脚本)

以下独立脚本演示了如何使用 FeatureClassToFeatureClass 函数。

# Name: FeatureClassToFeatureClass_Example2.py
# Description: Use FeatureClassToFeatureClass with an expression to create a subset
#  of the original feature class.  
 
# Import system modules
import arcpy
 
# Set environment settings
arcpy.env.workspace = "C:/data/GreenvalleyDB.gdb/Public Buildings"
 
# Set local variables
inFeatures = "buildings_point"
outLocation = "C:/output/output.gdb"
outFeatureClass = "postoffices"
delimitedField = arcpy.AddFieldDelimiters(arcpy.env.workspace, "NAME")
expression = delimitedField + " = 'Post Office'"
 
# Execute FeatureClassToFeatureClass
arcpy.FeatureClassToFeatureClass_conversion(inFeatures, outLocation, 
                                            outFeatureClass, expression)

许可信息

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

相关主题