LRS データプロダクトの生成 (Generate LRS Data Product) (Location Referencing)—ArcGIS Pro

Location Referencing ライセンスで利用可能です。

サマリー

LRS データを変換して、LRS ネットワーク内の選択されているルートの長さプロダクトを作成します。たとえば、このツールを使用して、一連のルートの距離を集計したり、郡の境界線の距離を集計することができます。

使用法

サマリーフィールドと長さフィールドを指定する LRS データテンプレートを使用します。パイプラインや一般道路と高速道路には位置参照テンプレートを使用できます。
サマリーフィールドと長さフィールドは LRS ネットワークレイヤーと同じジオデータベースに存在していなければなりません。
このテンプレートは .json ファイルでなければなりません。
[入力ルートフィーチャ] パラメーターの値としてはネットワークフィーチャクラスを使用します。
このツールでは入力は変更されず、出力として .csv ファイルが作成されます。
このツールでは選択と定義クエリがサポートされています。
[発効日] パラメーターを使用して、ネットワークの時間ビューを定義します。この日付にアクティブになっているルートだけが出力の計算に使用されます。
このツールでは、ネットワークの計測単位から別の単位に変換する際の単位変換がサポートされています。
[境界フィーチャ] パラメーターと [サマリーフィールド] パラメーターは、.json ファイルでサマリーフィールドが指定されていない場合にのみ有効です。
ネットワーク内のルートにキャリブレーションの問題がある場合やルートの長さがゼロである場合、[NULL のサマリー行を除外] パラメーターをオンにして、このようなルートを出力から除外します。オンにしない場合、このようなルートが長さゼロで出力に含まれます。

パラメーター

ラベル	説明	データタイプ
テンプレート	サマリーフィールドと長さフィールドを指定する、入力 LRS データテンプレート。	File
入力ルートフィーチャ	長さの計算に使用される LRS ネットワーク。	Feature Layer
発効日	ネットワークの時間ビューの定義に使用される日付。	Date
長さ単位	出力内の長さフィールドに使用される計測単位を指定します。インチ—単位はインチです。フィート—単位はフィートです。ヤード—単位はヤードです。マイル—単位はマイルです。海里—単位は海里です。国際マイル—単位は国際マイルです。国際フィート—単位は国際フィートです。ミリメートル—単位はミリメートルです。センチメートル—単位はセンチメートルです。メートル—単位はメートルです。キロメートル—単位はキロメートルです。デシメートル—単位はデシメートルです。	String
境界フィーチャ (オプション)	データの集計に使用される境界レイヤー。	Feature Layer
サマリーフィールド (オプション)	サマリー行の名前を示す、境界レイヤーのフィールド。	Field
NULL のサマリー行を除外 (オプション)	NULL のサマリー行を出力から除外するかどうかを指定します。オン - キャリブレーションされていないルートや長さがゼロのルートは出力から除外されます。これがデフォルトです。オフ - キャリブレーションされていないルートや長さがゼロのルートは出力から除外されず、距離 0 で出力に含まれます。	Boolean
出力形式 (オプション)	出力ファイルの形式を指定します。 CSV—出力ファイルは .csv ファイルになります。これがデフォルトです。	String
出力ファイル (オプション)	計算された長さが書き込まれる出力 .csv ファイル。	File
出力テーブル (オプション)	計算された長さが含まれる、作成されるテーブル。	Table

arcpy.locref.GenerateLrsDataProduct(in_template, in_route_features, effective_date, units, {boundary_features}, {summary_field}, {exclude_null_summary_rows}, {output_format}, {out_file}, {out_table})

名前	説明	データタイプ
in_template	サマリーフィールドと長さフィールドを指定する、入力 LRS データテンプレート。	File
in_route_features	長さの計算に使用される LRS ネットワーク。	Feature Layer
effective_date	ネットワークの時間ビューの定義に使用される日付。	Date
units	出力内の長さフィールドに使用される計測単位を指定します。 INCHES—単位はインチです。 FEET—単位はフィートです。 YARDS—単位はヤードです。 MILES—単位はマイルです。 NAUTICAL_MILES—単位は海里です。 INTMILES—単位は国際マイルです。 INTFEET—単位は国際フィートです。 MILLIMETERS—単位はミリメートルです。 CENTIMETERS—単位はセンチメートルです。 METERS—単位はメートルです。 KILOMETERS—単位はキロメートルです。 DECIMETERS—単位はデシメートルです。	String
boundary_features (オプション)	データの集計に使用される境界レイヤー。	Feature Layer
summary_field (オプション)	サマリー行の名前を示す、境界レイヤーのフィールド。	Field
exclude_null_summary_rows (オプション)	NULL のサマリー行を出力から除外するかどうかを指定します。 EXCLUDE—キャリブレーションされていないルートや長さがゼロのルートは出力から除外されます。これがデフォルトです。 DO_NOT_EXCLUDE—キャリブレーションされていないルートや長さがゼロのルートは出力から除外されず、距離 0 で出力に含まれます。	Boolean
output_format (オプション)	出力ファイルの形式を指定します。 CSV—出力ファイルは .csv ファイルになります。これがデフォルトです。	String
out_file (オプション)	計算された長さが書き込まれる出力 .csv ファイル。	File
out_table (オプション)	計算された長さが含まれる、作成されるテーブル。	Table

コードのサンプル

GenerateLrsDataProduct の例 1 (スタンドアロンスクリプト)

次のスタンドアロンスクリプトは、スタンドアロンスクリプトとして GenerateLrsDataProduct 関数を使用する方法を示しています。

# Name: GenerateLrsDataProduct_ex1.py
# Description: Transforms LRS data to create a Length product for the selected routes in an LRS Network in a stand-alone script.
# Requirements: ArcGIS Location Referencing

# Import arcpy module
import arcpy

# Check out any necessary licenses
arcpy.CheckOutExtension("LocationReferencing")

# Local tool variables
in_template=r"C:\Data\Template.json"
in_route_features=r"C:\Data\SampleData.gdb\LRS\Network"
effective_date="06/03/2024"
units="METERS"
boundary_features = None
summary_field = None
exclude_null_summary_rows="EXCLUDE"
output_format="CSV"
out_file= r"C:\Data\LP1.csv"
out_table=None

# Run the tool
arcpy.locref.GenerateLrsDataProduct(in_template, in_route_features, effective_date, units, boundary_features, summary_field, exclude_null_summary_rows, output_format, out_file, out_table)

# Check in licenses
arcpy.CheckInExtension('LocationReferencing')

GenerateLrsDataProduct の例 2 (Python ウィンドウ)

次のスクリプトは、Python ウィンドウでの GenerateLrsDataProduct 関数の使用方法を示しています。

# Name: GenerateLrsDataProduct_ex2.py
# Description: Transforms LRS data to create a Length product for the selected routes in an LRS Network in the inline Python window in ArcGIS Pro.
# Requirements: ArcGIS Location Referencing

# Local tool variables
in_template=r"C:\Data\Template.json"
in_route_features=r"C:\Data\SampleData.gdb\LRS\Network"
effective_date="06/03/2024"
units="METERS"
boundary_features = None
summary_field = None
exclude_null_summary_rows="DO_NOT_EXCLUDE"
output_format="CSV"
out_file= r"C:\Data\LP2.csv"
out_table=None

# Run the tool
arcpy.locref.GenerateLrsDataProduct(in_template, in_route_features, effective_date, units, boundary_features, summary_field, exclude_null_summary_rows, output_format, out_file, out_table)

GenerateLrsDataProduct の例 3 (スタンドアロンスクリプト)

次のスタンドアロンスクリプトは、フィーチャサービスで GenerateLrsDataProduct 関数を使用する方法を示しています。

# Name: GenerateLrsDataProduct_Ex3.py
# Description: Transforms LRS data to create a Length product for the selected routes using a feature service.
# Requires: ArcGIS Location Referencing

# Import arcpy module.
import arcpy

# Check out the license
arcpy.CheckOutExtension("LocationReferencing")

# Input event and target LRS network are in feature service.  Signing in portal is required to access the feature service.
arcpy.SignInToPortal('https://yourdomain.com/portal', 'username', 'password')

# Map the LRS network from the feature service. Here, 1 corresponds to the target LRS Network's layer ID.
in_route_features = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/1"

# Set tool variables
in_template=r"C:\Data\Template.json"
effective_date="06/03/2024"
units="FEET"
boundary_features = None
summary_field = None
exclude_null_summary_rows="EXCLUDE"
output_format="CSV"
out_file= r"C:\Data\LP3.csv"
out_table=None

# Run the tool
arcpy.locref.GenerateLrsDataProduct (in_template, in_route_features, effective_date, units, boundary_features, summary_field, exclude_null_summary_rows, output_format, out_file, out_table)

# Check in license
arcpy.CheckInExtension('LocationReferencing')

環境

現在のワークスペース

ライセンス情報

Basic: 次のものが必要 ArcGIS Location Referencing (ArcGIS Pipeline Referencing または ArcGIS Roads and Highways)
Standard: 次のものが必要 ArcGIS Location Referencing (ArcGIS Pipeline Referencing または ArcGIS Roads and Highways)
Advanced: 次のものが必要 ArcGIS Location Referencing (ArcGIS Pipeline Referencing または ArcGIS Roads and Highways)

サマリー

使用法

パラメーター

コードのサンプル

環境

ライセンス情報

関連トピック

このトピックの内容