LRS-Datenprodukt generieren (Location Referencing)—ArcGIS Pro

Mit der Location Referencing-Lizenz verfügbar.

Zusammenfassung

Transformiert LRS-Daten, um ein Längenprodukt für ausgewählte Routen in einem LRS-Netzwerk zu erstellen. Verwenden Sie dieses Werkzeug beispielsweise, um die Entfernung in Meilen für eine Reihe von Routen oder Linien anhand einer Landkreisgrenze zusammenzufassen.

Verwendung

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 der LRS-Netzwerk-Layer vorhanden sein.
Die Vorlage muss eine .json-Datei sein.
Verwenden Sie eine Network-Feature-Class für den Parameterwert Eingabe-Route-Features.
Die Eingaben werden von diesem Werkzeug nicht geändert. Als Ausgabe wird eine ‏‏‏‏‏‏‏‏.csv-Datei 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 an diesem Datum aktiven Routen verwendet.
Dieses Werkzeug unterstützt die Einheitenumrechnung bei der Umrechnung von den Maßeinheiten des Netzwerks in eine andere Einheit.
Die Parameter Grenz-Features und Zusammenfassungsfeld sind nur gültig, wenn in der .json-Datei kein Zusammenfassungsfeld angegeben wird.
Wenn das Netzwerk Routen mit Kalibrierungsproblemen oder mit einer Länge von Null aufweist, aktivieren Sie den Parameter Zusammenfassungszeilen mit NULL-Wert ausschließen, um diese Routen aus der Ausgabe auszuschließen. Andernfalls werden diese Routen mit einer Länge von Null in die Ausgabe eingeschlossen.

Parameter

Beschriftung	Erläuterung	Datentyp
Vorlage	Die Eingabe-LRS-Datenvorlage, die die Felder für die Zusammenfassung und die Länge angibt.	File
Eingabe-Routen-Features	Das LRS-Netzwerk, das zum Berechnen der Länge verwendet wird.	Feature Layer
Gültig ab	Das Datum, mit dem die Zeitdatenansicht des Netzwerks definiert wird.	Date
Längeneinheiten	Gibt die Maßeinheiten an, die im Feld für die Länge in der Ausgabe verwendet werden. Zoll—Die Einheit ist Zoll. Fuß—Die Einheit ist Fuß. Yard—Die Einheit ist Yard. Meilen—Die Einheit ist Meilen. Seemeilen—Die Einheit ist Seemeilen. Meilen (International)—Die Einheit ist Meilen (International). 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.	Feature Layer
Zusammenfassungsfeld (optional)	Das Feld aus dem Grenzen-Layer, das die Namen für die Zusammenfassungszeilen enthält.	Field
Zusammenfassungszeilen mit NULL-Wert ausschließen (optional)	Gibt an, ob Zusammenfassungszeilen mit NULL-Werten in der Ausgabe ausgeschlossen werden sollen. Aktiviert: Nicht kalibrierte Routen oder Routen mit einer Länge von Null werden in der Ausgabe ausgeschlossen. Dies ist die Standardeinstellung. Deaktiviert: Nicht kalibrierte Routen oder Routen mit einer Länge von Null werden in der Ausgabe nicht ausgeschlossen (sie werden mit einer Entfernung von 0 Meilen in die Ausgabe eingeschlossen).	Boolean
Ausgabeformat (optional)	Gibt das Format der Ausgabedatei an. CSV—Die Ausgabedatei ist eine .csv-Datei. Dies ist die Standardeinstellung.	String
Ausgabedatei (optional)	Die .csv-Ausgabedatei, in die die berechnete Länge geschrieben wird.	File
Ausgabetabelle (optional)	Die Tabelle, die mit der berechneten Länge 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 die Zusammenfassung und die Länge angibt.	File
in_route_features	Das LRS-Netzwerk, das zum Berechnen der Länge verwendet wird.	Feature Layer
effective_date	Das Datum, mit dem die Zeitdatenansicht des Netzwerks definiert wird.	Date
units	Gibt die Maßeinheiten an, die im Feld für die Länge in der Ausgabe verwendet werden. INCHES—Die Einheit ist Zoll. FEET—Die Einheit ist Fuß. YARDS—Die Einheit ist Yard. MILES—Die Einheit ist Meilen. NAUTICAL_MILES—Die Einheit ist Seemeilen. INTMILES—Die Einheit ist Meilen (International). 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.	Feature Layer
summary_field (optional)	Das Feld aus dem Grenzen-Layer, das die Namen für die Zusammenfassungszeilen enthält.	Field
exclude_null_summary_rows (optional)	Gibt an, ob Zusammenfassungszeilen mit NULL-Werten in der Ausgabe ausgeschlossen werden sollen. EXCLUDE—Nicht kalibrierte Routen oder Routen mit einer Länge von Null werden in der Ausgabe ausgeschlossen. Dies ist die Standardeinstellung. DO_NOT_EXCLUDE—Nicht kalibrierte Routen oder Routen mit einer Länge von Null werden in der Ausgabe nicht ausgeschlossen (sie werden mit einer Entfernung von 0 Meilen in die Ausgabe eingeschlossen).	Boolean
output_format (optional)	Gibt das Format der Ausgabedatei an. CSV—Die Ausgabedatei ist eine .csv-Datei. Dies ist die Standardeinstellung.	String
out_file (optional)	Die .csv-Ausgabedatei, in die die berechnete Länge geschrieben wird.	File
out_table (optional)	Die Tabelle, die mit der berechneten Länge erstellt wird.	Table

Codebeispiel

GenerateLrsDataProduct: Beispiel 1 (eigenständiges Skript)

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

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

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

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

Umgebungen

Aktueller Workspace

Lizenzinformationen

Basic: Erfordert ArcGIS Location Referencing (ArcGIS Pipeline Referencing oder ArcGIS Roads and Highways)
Standard: Erfordert ArcGIS Location Referencing (ArcGIS Pipeline Referencing oder ArcGIS Roads and Highways)
Advanced: Erfordert ArcGIS Location Referencing (ArcGIS Pipeline Referencing oder ArcGIS Roads and Highways)