创建转弯要素类 (Network Analyst)

摘要

创建转弯要素类,用于存储网络数据集中模拟转弯动作的转弯要素。

使用情况

  • 仅当网络数据集支持转弯时,才能将转弯要素类作为转弯源添加到网络中。 要在不支持转弯的网络中添加转弯要素,需要先创建一个支持转弯功能的新网络数据集。

  • 创建了转弯要素类之后,可以使用编辑器工具栏上用于创建线状要素的命令创建转弯要素

参数

标注说明数据类型
输出位置

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

Workspace; Feature Dataset
输出转弯要素类名称

要创建的转弯要素类的名称。

String
最大边数
(可选)

对新转弯要素类中的转弯进行建模的最大边数。 默认值为 5。 最大值为 50。

Long
输入网络数据集
(可选)

转弯要素类将参与的网络数据集。 所生成的转弯要素类将作为转弯源添加到网络数据集中。 如果未提供网络数据集,转弯要素类将以“不参与网络数据集”的形式创建。

Network Dataset Layer
模板要素类
(可选)

可以使用一个要素类作为模板,定义新转弯要素类的属性架构。

如果模板要素类中包含以下字段,这些字段将不会在输出转弯要素类中创建:NODE_NODE#JUNCTIONF_EDGET_EDGEF-EDGET-EDGEARC1_ARC2_ARC1#ARC2#ARC1-IDARC2-IDAZIMUTHANGLE

Feature Layer
空间参考
(可选)

将应用到输出转弯要素类的空间参考。 如果输出位置为地理数据库要素数据集,此参数将被忽略,因为输出转弯要素类将继承要素数据集的空间参考。

Spatial Reference
配置关键字
(可选)

用于确定新转弯要素类的存储参数的配置关键字。 此参数仅在输出位置为工作组或企业级地理数据库时使用。

String
输出空间格网 1
(可选)

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

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

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

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

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

Double
包含 Z 值
(可选)

指定转弯要素类是否包含高程 (z) 值。

  • 选中 - 转弯要素类中的坐标将包含高程 (z) 值。 如果指定了输入网络数据集并且它支持基于网络源中 z 坐标值的连通性,则会禁用此参数。
  • 未选中 - 转弯要素类中的坐标将不包含高程 (z) 值。
Boolean

派生输出

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

包含转弯要素的输出转弯要素类。

Feature Class

arcpy.management.CreateTurnFeatureClass(out_location, out_feature_class_name, {maximum_edges}, {in_network_dataset}, {in_template_feature_class}, {spatial_reference}, {config_keyword}, {spatial_grid_1}, {spatial_grid_2}, {spatial_grid_3}, {has_z})
名称说明数据类型
out_location

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

Workspace; Feature Dataset
out_feature_class_name

要创建的转弯要素类的名称。

String
maximum_edges
(可选)

对新转弯要素类中的转弯进行建模的最大边数。 默认值为 5。 最大值为 50。

Long
in_network_dataset
(可选)

转弯要素类将参与的网络数据集。 所生成的转弯要素类将作为转弯源添加到网络数据集中。 如果未提供网络数据集,转弯要素类将以“不参与网络数据集”的形式创建。

Network Dataset Layer
in_template_feature_class
(可选)

可以使用一个要素类作为模板,定义新转弯要素类的属性架构。

如果模板要素类中包含以下字段,这些字段将不会在输出转弯要素类中创建:NODE_NODE#JUNCTIONF_EDGET_EDGEF-EDGET-EDGEARC1_ARC2_ARC1#ARC2#ARC1-IDARC2-IDAZIMUTHANGLE

Feature Layer
spatial_reference
(可选)

将应用到输出转弯要素类的空间参考。 如果输出位置为地理数据库要素数据集,此参数将被忽略,因为输出转弯要素类将继承要素数据集的空间参考。

要从现有要素类导入空间参考,可将其路径指定为参数值。

Spatial Reference
config_keyword
(可选)

用于确定新转弯要素类的存储参数的配置关键字。 此参数仅在输出位置为工作组或企业级地理数据库时使用。

String
spatial_grid_1
(可选)

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

Double
spatial_grid_2
(可选)

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

Double
spatial_grid_3
(可选)

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

Double
has_z
(可选)

指定转弯要素类是否包含高程 (z) 值。

  • ENABLED转弯要素类中的坐标将包含高程 (z) 值。 如果指定了输入网络数据集,并且其支持基于网络源的 z 坐标值的连通性,则使用此值。
  • DISABLED转弯要素类中的坐标将不包含高程 (z) 值。
Boolean

派生输出

名称说明数据类型
out_turn_features

包含转弯要素的输出转弯要素类。

Feature Class

代码示例

CreateTurnFeatureClass 示例 1(Python 窗口)

仅使用必需参数运行该工具。

out_loc = "C:/Data/SanFrancisco.gdb/Transportation"
arcpy.na.CreateTurnFeatureClass(out_loc, "DelayTurns")
CreateTurnFeatureClass 示例 2(Python 窗口)

使用所有参数运行该工具。

out_loc = "C:/Data/SanFrancisco.gdb/Transportation"
network = "C:/Data/SanFrancisco.gdb/Transportation/Streets_ND"
template = "C:/Data/schema.gdb/TurnTemplate"
arcpy.na.CreateTurnFeatureClass(out_loc, "DelayTurns", 2, network, template, "",
                                "", 0, 0, 0, "DISABLED")
CreateTurnFeatureClass 示例 3(独立脚本)

以下 Python 脚本演示了如何在独立脚本中使用 CreateTurnFeatureClass 函数。

# Name: CreateTurnFeatureClass_ex03.py
# Description: Create a new turn feature class associated with a network dataset
# Requirements: Network Analyst Extension

#Import system modules
import arcpy

#Set environment settings
arcpy.env.workspace = "C:/data/SanFrancisco.gdb"

#Set local variables
inFeatureDataset = "Transportation"
outTurnFeatureClassName = "DelayTurns"
maxEdges = 3
inNetworkDataset = inFeatureDataset + "/" + "Streets_ND"

#Create a turn feature class and add it as a turn source by specifying the
#network dataset
arcpy.na.CreateTurnFeatureClass(inFeatureDataset,outTurnFeatureClassName,
                                maxEdges, inNetworkDataset)

print("Script completed successfully.")