LRS データプロダクトの生成 (Generate LRS Data Product) (Location Referencing ツール)

サマリー

LRS データを変換して、LRS ネットワーク内のルートの長さ、ルートログ、フィーチャ数データプロダクトを作成します。

使用法

このテンプレートは .json ファイルでなければなりません。
入力ルートフィーチャ パラメーターとしてはネットワークフィーチャクラスを使用します。
このツールでは入力は変更されず、出力として .csv ファイルまたはジオデータベーステーブルが作成されます。
このツールでは選択と定義クエリーがサポートされています。
発効日 パラメーターを使用して、ネットワークの時間ビューを定義します。指定した日付にアクティブになっているルートだけが出力の計算に使用されます。
長さおよびフィーチャ数データプロダクトでは、複数の 発効日 パラメーター値を指定できます。複数の発効日が指定された場合、各発効日間の長さまたはフィーチャ数の差分 (変化量) が計算されます。
長さデータプロダクトを作成する際には、次の点を考慮してください:
- サマリーフィールドと長さフィールドを指定する LRS データテンプレートを使用します。パイプラインや一般道路と高速道路には位置参照テンプレートを使用できます。
- サマリーフィールドと長さフィールドは LRS ネットワークと同じジオデータベースに存在していなければなりません。
- ネットワークの計測単位から別の単位に変換する際の単位変換がサポートされています。
- 境界フィーチャ パラメーターと サマリーフィールド パラメーターは、.json ファイルでサマリーフィールドが指定されていない場合にのみ有効です。
- 出力は、LRS ネットワーク、サマリーレイヤー、長さレイヤーから選択されたフィーチャの交差部分に基づいて作成されます。
ルートログデータプロダクトを作成する際には、次の点を考慮してください:
- ログ、ロケーション、対象フィールドを指定する LRS データテンプレートを使用します。パイプラインや一般道路と高速道路には位置参照テンプレートを使用できます。
- ログレイヤーとログフィールドは LRS ネットワークと同じジオデータベースに存在していなければなりません。
- ロケーションレイヤーとロケーションフィールドはポリゴンレイヤーである必要があり、LRS ネットワークと同じジオデータベースに存在していなければなりません。
- 対象レイヤーおよびフィールドは、LRS ポイントイベントフィーチャクラスまたは LRS 交点フィーチャクラスで、LRS ネットワークと同じジオデータベース内に存在している必要があります。
- 出力は、LRS ネットワーク、ログレイヤー、ロケーションレイヤー、対象レイヤーから選択されたフィーチャの交差部分に基づいて作成されます。
フィーチャ数データプロダクトを作成する際には、次の点を考慮してください:
- 個数、サマリー、ルート識別子フィールドを指定する LRS データテンプレートを使用します。パイプラインや一般道路と高速道路には位置参照テンプレートを使用できます。
- 個数、サマリー、ルート識別子フィールドは LRS ネットワークと同じジオデータベースに存在していなければなりません。
- 境界フィーチャ パラメーターと サマリーフィールド パラメーターは、.json ファイルでサマリーフィールドが指定されていない場合にのみ有効です。
- 出力は、LRS ネットワーク、サマリーレイヤー、フィーチャ数レイヤーから選択されたフィーチャの交差部分に基づいて作成されます。

ラベル	説明	データタイプ
テンプレート	サマリーフィールドと長さフィールド (長さデータプロダクト)、ルート識別子、ログ、ロケーション、対象フィールド (ルートログデータプロダクト)、または個数、サマリー、ルート識別子フィールド (フィーチャ数データプロダクト) を指定する、入力 LRS データテンプレート。	File
入力ルートフィーチャ	長さ、ルートログ、フィーチャ数の計算に使用される LRS ネットワーク。	Feature Layer
発効日	ネットワークの時間ビューの定義に使用される 1 つまたは複数の日付。	Date
長さ単位 (オプション)	出力内の長さフィールドに使用される計測単位を指定します。このパラメーターは、長さデータプロダクトを作成する場合にのみ使用できます。インチ (米国測量)—単位はインチです。フィート (米国測量)—単位はフィートになります。ヤード (米国測量)—単位はヤードになります。マイル (米国測量)—単位はマイルになります。海里 (米国測量)—単位は海里です。法定マイル—単位は法定マイルです。フィート (国際)—単位は国際フィートです。ミリメートル—単位はミリメートルです。センチメートル—単位はセンチメートルです。メートル—単位はメートルになります。キロメートル—単位はキロメートルになります。デシメートル—単位はデシメートルです。	String
境界フィーチャ (オプション)	データの集計に使用される境界レイヤー。このパラメーターは、長さデータプロダクトまたはフィーチャ数データプロダクトを作成する場合にのみ使用できます。	Feature Layer
サマリーフィールド (オプション)	サマリー行の名前を示す、境界レイヤーのフィールド。このパラメーターは、長さデータプロダクトまたはフィーチャ数データプロダクトを作成する場合にのみ使用できます。	Field
NULL のサマリー行を除外 (オプション)	NULL のサマリー行を出力から除外するかどうかを指定します。このパラメーターは、長さデータプロダクトまたはフィーチャ数データプロダクトを作成する場合にのみ使用できます。オン—長さやフィーチャ数がゼロの行は出力から除外されます。これがデフォルトです。オフ—長さやフィーチャ数がゼロの行は出力から除外されません。	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 [effective_date,...]	ネットワークの時間ビューの定義に使用される 1 つまたは複数の日付。	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`—長さやフィーチャ数がゼロの行は出力から除外されません。	Boolean
output_format (オプション)	出力ファイルの形式を指定します。 `CSV`—出力ファイルは `.csv` ファイルになります。これがデフォルトです。 `TABLE`—出力ファイルはジオデータベーステーブルになります。	String
out_file (オプション)	計算された長さ、ルートログ、フィーチャ数が書き込まれる出力 `.csv` ファイル。	File
out_table (オプション)	計算された長さ、ルートログ、フィーチャ数が含まれる、作成されたジオデータベーステーブル。	Table

コードのサンプル

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

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

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

# Import arcpy module
import arcpy

# Local tool variables
in_template = r"C:\Data\Template.json"
in_route_features = r"C:\Data\SampleData.gdb\LRS\Network"
effective_date = "12/31/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)

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

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

# Name: GenerateLrsDataProduct_ex2.py
# Description: Transforms LRS data to create a data 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 = "12/31/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 data product for the selected routes using a feature service.
# Requires: ArcGIS Location Referencing

# Import arcpy module.
import arcpy

# 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 = "12/31/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)

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

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

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

# Import arcpy module
import arcpy

# Local tool variables
in_template = r"C:\Data\Template.json"
in_route_features = r"C:\Data\SampleData.gdb\LRS\Network"
effective_date = "12/31/2000; 12/31/2010; 12/31/2020"
units = "METERS"
boundary_features = None
summary_field = None
exclude_null_summary_rows = "EXCLUDE"
output_format = "TABLE"
out_file = None
out_table = r"C:\Data\SampleData.gdb\LP4"

# 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)

環境

現在のワークスペース

ライセンス情報

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) が必要

LRS データ プロダクトの生成 (Generate LRS Data Product) (Location Referencing ツール)

サマリー

使用法

パラメーター

環境

ライセンス情報

関連トピック

LRS データプロダクトの生成 (Generate LRS Data Product) (Location Referencing ツール)