LRS-Datenprodukt generieren (Location Referencing Tools)

Zusammenfassung

Transformiert LRS-Daten, um ein Längen-, ein Routenprotokoll- oder ein Feature-Anzahl-Datenprodukt für Routen in einem LRS-Netzwerk zu erstellen.

Verwendung

Die Vorlage muss eine .json-Datei sein.
Verwenden Sie eine Network-Feature-Class für den Parameter Eingabe-Route-Features.
Die Eingaben werden von diesem Werkzeug nicht geändert. Als Ausgabe wird eine .csv‏‏‏‏‏‏‏‏-Datei oder eine Geodatabase-Tabelle erstellt.
Dieses Werkzeug unterstützt Auswahlsätze und Definitionsabfragen.
Mit dem Parameter Gültig ab wird die Zeitdatenansicht des Netzwerks definiert. Für die Berechnung der Ausgabe werden nur die am festgelegten Datum aktiven Routen verwendet.
Für Längen- und Feature-Anzahl-Datenprodukte können Sie mehr als einen Parameterwert Gültig ab festlegen. Wenn mehrere Gültigkeitsdaten festgelegt werden, wird das Delta bzw. die Änderung der Länge oder der Feature-Anzahl zwischen jedem Paar von Gültigkeitsdaten berechnet.
Berücksichtigen Sie beim Erstellen eines Längendatenprodukts folgende Aspekte:
- Verwenden Sie eine LRS-Datenvorlage, die die Felder für die Zusammenfassung und die Länge angibt. Sie können eine Location-Referencing-Vorlage für Pipelines oder Roads and Highways verwenden.
- Die Zusammenfassungs- und Längenfelder müssen in derselben Geodatabase wie das LRS-Netzwerk vorhanden sein.
- Die Einheitenumrechnung wird bei der Umrechnung von den Maßeinheiten des Netzwerks in eine andere Einheit unterstützt.
- Die Parameter Grenz-Features und Zusammenfassungsfeld sind nur gültig, wenn in der .json-Datei kein Zusammenfassungsfeld angegeben wird.
- Die Ausgabe wird auf Grundlage des Schnittpunktes ausgewählter Features aus dem LRS-Netzwerk, den Zusammenfassungs-Layern und den Längen-Layern erstellt.
Berücksichtigen Sie beim Erstellen eines Routenprotokoll-Datenprodukts folgende Aspekte:
- Verwenden Sie eine LRS-Datenvorlage, die das Protokoll, den Standort und die Referenzfelder angibt. Sie können eine Location-Referencing-Vorlage für Pipelines oder Roads and Highways verwenden.
- Der Protokoll-Layer und die Felder müssen in derselben Geodatabase wie das LRS-Netzwerk vorhanden sein.
- Der Standort-Layer und die Felder müssen ein Polygon-Layer sein und sich in derselben Geodatabase wie das LRS-Netzwerk befinden.
- Der Referenz-Layer und die Felder müssen eine Feature-Class für LRS-Punktobjekte oder eine Feature-Class für LRS-Schnittpunkte sein und sich in derselben Geodatabase wie das LRS-Netzwerk befinden.
- Die Ausgabe wird auf Grundlage des Schnittpunktes ausgewählter Features aus dem LRS-Netzwerk, den Protokoll-Layern, den Positions-Layern und den Referenz-Layern erstellt.
Berücksichtigen Sie beim Erstellen eines Feature-Anzahl-Datenprodukts folgende Aspekte:
- Verwenden Sie eine LRS-Datenvorlage, die die Felder für die Anzahl, die Zusammenfassung und die Routenkennung angibt. Sie können eine Location-Referencing-Vorlage für Pipelines oder Roads and Highways verwenden.
- Die Felder für die Anzahl, die Zusammenfassung und die Routenkennung müssen in derselben Geodatabase wie das LRS-Netzwerk vorhanden sein.
- Die Parameter Grenz-Features und Zusammenfassungsfeld sind nur gültig, wenn in der .json-Datei kein Zusammenfassungsfeld angegeben wird.
- Die Ausgabe wird auf Grundlage des Schnittpunktes ausgewählter Features aus dem LRS-Netzwerk, den Zusammenfassungs-Layern und den Feature-Anzahl-Layern erstellt.

Beschriftung	Erläuterung	Datentyp
Vorlage	Die Eingabe-LRS-Datenvorlage, die die Felder für Zusammenfassung und Länge (Längendatenprodukt), die Felder für Routenkennung, Protokoll, Standort und Referenz (Routenprotokoll-Datenprodukt) oder die Felder für Anzahl, Zusammenfassung und Routenkennung (Feature-Anzahl-Datenprodukt) angibt.	File
Eingabe-Routen-Features	Das LRS-Netzwerk, das zum Berechnen der Länge, des Routenprotokolls oder der Feature-Anzahl verwendet wird.	Feature Layer
Gültig ab	Das Datum bzw. die Daten, mit dem bzw. denen die Zeitdatenansicht des Netzwerks definiert wird.	Date
Längeneinheiten (Optional)	Gibt die Maßeinheiten an, die im Feld für die Länge in der Ausgabe verwendet werden. Der Parameter ist nur beim Erstellen eines Längendatenprodukts verfügbar. Zoll (US Survey)—Die Einheit ist Zoll. Fuß (US Survey)—Die Einheit ist Fuß. Yards (US Survey)—Die Einheit ist Yards. Meilen (US Survey)—Die Einheit ist Meilen. Seemeilen (US Survey)—Die Einheit ist Seemeilen. Meilen (Britisch)—Die Einheit ist Meilen (Britisch). Fuß (International)—Die Einheit ist Fuß (International). Millimeter—Die Einheit ist Millimeter. Zentimeter—Die Einheit ist Zentimeter. Meter—Die Einheit ist Meter. Kilometer—Die Einheit ist Kilometer. Dezimeter—Die Einheit ist Dezimeter.	String
Grenz-Features (Optional)	Der Grenzen-Layer, der zum Zusammenfassen der Daten verwendet wird. Der Parameter ist nur beim Erstellen eines Längen- oder Feature-Anzahl-Datenprodukts verfügbar.	Feature Layer
Zusammenfassungsfeld (Optional)	Das Feld aus dem Grenzen-Layer, das die Namen für die Zusammenfassungszeilen enthält. Der Parameter ist nur beim Erstellen eines Längen- oder Feature-Anzahl-Datenprodukts verfügbar.	Field
Zusammenfassungszeilen mit NULL-Wert ausschließen (Optional)	Gibt an, ob Zusammenfassungszeilen mit NULL-Werten in der Ausgabe ausgeschlossen werden sollen. Der Parameter ist nur beim Erstellen eines Längen- oder Feature-Anzahl-Datenprodukts verfügbar. Aktiviert—Zeilen mit einer Länge oder Feature-Anzahl von 0 werden von der Ausgabe ausgeschlossen. Dies ist die Standardeinstellung. Deaktiviert—Zeilen mit einer Länge oder Feature-Anzahl von 0 werden in der Ausgabe berücksichtigt.	Boolean
Ausgabeformat (Optional)	Gibt das Format der Ausgabedatei an. CSV—Die Ausgabedatei ist eine `.csv`-Datei. Dies ist die Standardeinstellung. Tabelle—Die Ausgabe ist eine Geodatabase-Tabelle.	String
Ausgabedatei (Optional)	Die `.csv`-Ausgabedatei, in die die berechnete Länge, das Routenprotokoll oder die Feature-Anzahl geschrieben wird.	File
Ausgabetabelle (Optional)	Die Geodatabase-Tabelle, die mit der berechneten Länge, dem Routenprotokoll oder der Feature-Anzahl erstellt wird.	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})

Name	Erläuterung	Datentyp
in_template	Die Eingabe-LRS-Datenvorlage, die die Felder für Zusammenfassung und Länge (Längendatenprodukt), die Felder für Routenkennung, Protokoll, Standort und Referenz (Routenprotokoll-Datenprodukt) oder die Felder für Anzahl, Zusammenfassung und Routenkennung (Feature-Anzahl-Datenprodukt) angibt.	File
in_route_features	Das LRS-Netzwerk, das zum Berechnen der Länge, des Routenprotokolls oder der Feature-Anzahl verwendet wird.	Feature Layer
effective_date [effective_date,...]	Das Datum bzw. die Daten, mit dem bzw. denen die Zeitdatenansicht des Netzwerks definiert wird.	Date
units (Optional)	Gibt die Maßeinheiten an, die im Feld für die Länge in der Ausgabe verwendet werden. Der Parameter ist nur beim Erstellen eines Längendatenprodukts verfügbar. `INCHES`—Die Einheit ist Zoll. `FEET`—Die Einheit ist Fuß. `YARDS`—Die Einheit ist Yards. `MILES`—Die Einheit ist Meilen. `NAUTICAL_MILES`—Die Einheit ist Seemeilen. `INTMILES`—Die Einheit ist Meilen (Britisch). `INTFEET`—Die Einheit ist Fuß (International). `MILLIMETERS`—Die Einheit ist Millimeter. `CENTIMETERS`—Die Einheit ist Zentimeter. `METERS`—Die Einheit ist Meter. `KILOMETERS`—Die Einheit ist Kilometer. `DECIMETERS`—Die Einheit ist Dezimeter.	String
boundary_features (Optional)	Der Grenzen-Layer, der zum Zusammenfassen der Daten verwendet wird. Der Parameter ist nur beim Erstellen eines Längen- oder Feature-Anzahl-Datenprodukts verfügbar.	Feature Layer
summary_field (Optional)	Das Feld aus dem Grenzen-Layer, das die Namen für die Zusammenfassungszeilen enthält. Der Parameter ist nur beim Erstellen eines Längen- oder Feature-Anzahl-Datenprodukts verfügbar.	Field
exclude_null_summary_rows (Optional)	Gibt an, ob Zusammenfassungszeilen mit NULL-Werten in der Ausgabe ausgeschlossen werden sollen. Der Parameter ist nur beim Erstellen eines Längen- oder Feature-Anzahl-Datenprodukts verfügbar. `EXCLUDE`—Zeilen mit einer Länge oder Feature-Anzahl von 0 werden von der Ausgabe ausgeschlossen. Dies ist die Standardeinstellung. `DO_NOT_EXCLUDE`—Zeilen mit einer Länge oder Feature-Anzahl von 0 werden in der Ausgabe berücksichtigt.	Boolean
output_format (Optional)	Gibt das Format der Ausgabedatei an. `CSV`—Die Ausgabedatei ist eine `.csv`-Datei. Dies ist die Standardeinstellung. `TABLE`—Die Ausgabe ist eine Geodatabase-Tabelle.	String
out_file (Optional)	Die `.csv`-Ausgabedatei, in die die berechnete Länge, das Routenprotokoll oder die Feature-Anzahl geschrieben wird.	File
out_table (Optional)	Die Geodatabase-Tabelle, die mit der berechneten Länge, dem Routenprotokoll oder der Feature-Anzahl erstellt wird.	Table

Codebeispiel

GenerateLrsDataProduct: Beispiel 1 (eigenständiges Skript)

Das folgende eigenständige Skript veranschaulicht, wie die Funktion GenerateLrsDataProduct verwendet wird.

# 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: Beispiel 2 (Python-Fenster)

Das folgende Skript veranschaulicht, wie die Funktion GenerateLrsDataProduct im Python-Fenster verwendet wird.

# 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: Beispiel 3 (eigenständiges Skript)

Das folgende eigenständige Skript veranschaulicht, wie die Funktion GenerateLrsDataProduct mit Daten von einem Feature-Service verwendet wird.

# 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: Beispiel 4 (eigenständiges Skript)

Das folgende eigenständige Skript veranschaulicht, wie die Funktion GenerateLrsDataProduct mit mehreren Gültigkeitsdaten verwendet wird.

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

Umgebungen

Aktueller Workspace

Lizenzierungsinformationen