创建转弯要素类 (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) 值。
Boolean

派生输出

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

包含转弯要素的新转弯要素类。

要素类

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
(可选)
  • ENABLED新转弯要素类中的坐标将具有高程 (Z) 值。如果指定了输入网络数据集并且它支持基于网络源的 z 坐标值的连通性,则应使用此值。
  • DISABLED新转弯要素类中的坐标将不具有高程 (Z) 值。
Boolean

派生输出

名称说明数据类型
out_turn_features

包含转弯要素的新转弯要素类。

要素类

代码示例

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
from arcpy import env

#Set environment settings
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.CreateTurnFeatureClass_na(inFeatureDataset,outTurnFeatureClassName,
                                maxEdges, inNetworkDataset)

print("Script completed successfully.")