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

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

サマリー

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

使用法

• このテンプレートは .json ファイルでなければなりません。

• [入力ルート フィーチャ] パラメーターとしてはネットワーク フィーチャクラスを使用します。

• このツールでは入力は変更されず、出力として .csv ファイルまたはジオデータベース テーブルが作成されます。

• このツールでは選択と定義クエリーがサポートされています。

• [発効日] パラメーターを使用して、ネットワークの時間ビューを定義します。 指定した日付にアクティブになっているルートだけが出力の計算に使用されます。

• 長さおよびフィーチャ数データ プロダクトでは、複数の [発効日] パラメーター値を指定できます。 複数の発効日が指定された場合、各発効日間の長さまたはフィーチャ数の差分 (変化量) が計算されます。

• 長さデータ プロダクトを作成する際には、次の点を考慮してください:

  • サマリー フィールドと長さフィールドを指定する LRS データ テンプレートを使用します。 パイプラインや一般道路と高速道路には位置参照テンプレートを使用できます。
  • サマリー フィールドと長さフィールドは LRS ネットワーク レイヤーと同じジオデータベースに存在していなければなりません。
  • ネットワークの計測単位から別の単位に変換する際の単位変換がサポートされています。
  • [境界フィーチャ] パラメーターと [サマリー フィールド] パラメーターは、.json ファイルでサマリー フィールドが指定されていない場合にのみ有効です。
  • 出力は、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

Python

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

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

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

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

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

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

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

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

# Check in licenses
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)