Protokoll der linear referenzierten Routen generieren (Location Referencing)—ArcGIS Pro

Mit der Location Referencing-Lizenz verfügbar.

Zusammenfassung

Erstellt ein Routenprotokoll-Datenprodukt für Routen in einem LRS-Netzwerk ohne LRS-Datenvorlage.

Verwendung

Dieses Werkzeug unterstützt Daten aus einer File-Geodatabase, einer Enterprise-Geodatabase (nach Verzweigung versioniert) oder einem Feature-Service (veröffentlicht aus nach Verzweigung versionierten Daten).
Die Eingaben werden von diesem Werkzeug nicht geändert. Als Ausgabe wird eine ‏‏‏‏‏‏‏‏.csv-Datei oder eine Geodatabase-Tabelle erstellt.
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.
Die Protokoll-, Positions- und Referenz-Layer müssen in der gleichen Geodatabase oder dem gleichen Feature-Service gespeichert sein und das gleiche Koordinatensystem wie das angegebene LRS-Netzwerk verwenden.
Beim Protokoll-Layer kann es sich um eine Feature-Class für LRS-Punktobjekte, eine Feature-Class für LRS-Linienobjekte oder eine Feature-Class für LRS-Schnittpunkte handeln, die beim angegebenen LRS-Netzwerk registriert ist. Eine Centerline-Feature-Class kann auch als Protokoll-Layer verwendet werden, wenn sie mit der Address Data Management-Lösung oder einem Versorgungsnetz konfiguriert wird.
Der Positions-Layer muss eine Polygon-Feature-Class sein.
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.
Der Referenz-Layer muss eine Feature-Class für LRS-Punktobjekte sein, die im angegebenen LRS-Netzwerk registriert ist.
Der Wert "Nicht klassifiziert" wird in den Ausgabe-Positionsfeldern für die Routen einbezogen, die nicht mit den Positions-Layern überlappen.
Sie können mehrere Protokoll- und Positionsfelder aus derselben Feature-Class hinzufügen, indem Sie Auswahl-Layer erstellen und jeden Auswahl-Layer als Protokollfeld oder Positionsfeld festlegen. Wenn Sie beispielsweise über eine Feature-Class für LRS-Linienobjekte verfügen, können Sie zwei Auswahl-Layer erstellen, Klasse A und Klasse B, und beide Auswahl-Layer als Protokollfeld festlegen.

Parameter

Beschriftung	Erläuterung	Datentyp
Eingabe-Routen-Features	Die Routen-Features, die zum Generieren des Routenprotokolls verwendet werden.	Feature Layer
Gültig ab	Das Datum, mit dem die Zeitdatenansicht des Netzwerks definiert wird. Der Standardwert ist das aktuelle Datum.	Date
Protokollfelder (optional)	Die Felder, die verwendet werden, um Objekt- und Schnittpunktinformationen in der Ausgabe anzuzeigen. Layer: Der Feature-Layer, der als Protokoll-Layer verwendet wird. Feld: Das Feld, das am Routenprotokoll beteiligt ist.	Value Table
Lagegleiche Objekte zusammenführen (optional)	Gibt an, ob lagegleiche Linienobjekte in der Ausgabe zusammengeführt werden. Aktiviert: Lagegleiche Linienobjekt mit demselben Wert im Protokollfeld werden zusammengeführt und als Einzelobjekt zurückgegeben. Deaktiviert: Lagegleiche Linienobjekte mit demselben Wert im Protokollfeld werden nicht zusammengeführt oder als Einzelobjekt zurückgegeben. Dies ist die Standardeinstellung.	Boolean
Positionsfelder (optional)	Diese Felder werden verwendet, um die Attribute der von den Routen durchquerten Polygongrenzen anzuzeigen. Layer: Der Feature-Layer, der als Positions-Layer verwendet wird. Feld: Das Feld, das die Attribute der von den Routen durchquerten Polygongrenzen enthält.	Value Table
Referenzposition (optional)	Gibt die Methode an, die zum Berechnen des Referenzversatzes verwendet wird. Keine—Der Referenzversatz wird nicht berechnet. Dies ist die Standardeinstellung. Nächster vorgelagerter—Das nächstgelegene vorgelagerte Referenz-Feature des Routenprotokolleintrags wird für die Berechnung des Referenzversatzes verwendet. Ist kein vorgelagertes Referenz-Feature vorhanden, sind die Referenzwerte leer. Nächster Nachbar—Das nächstgelegene nachgelagerte Referenz-Feature des Routenprotokolleintrags wird für die Berechnung des Referenzversatzes verwendet.	String
Referenz-Features (optional)	Der Feature-Layer, der zum Berechnen des Versatzes vom Routenprotokolleintrag verwendet wird.	Feature Layer
Referenzfeld (optional)	Das Referenzfeld, das die Attribute der Referenz-Features in der Ausgabe enthält.	Field
Versatzeinheiten (optional)	Gibt die Versatzeinheiten an, die verwendet werden, um die Entfernung zwischen dem Referenz-Feature und dem Routenprotokolleintrag zu berechnen. Zoll (US Survey)—Die Einheit ist Zoll. Fuß (US Survey)—Die Einheit ist Fuß. Yards (US Survey)—Die Einheit ist Yard. Meilen (US Survey)—Die Einheit ist Meilen. Seemeilen (US Survey)—Die Einheit ist Seemeilen. Fuß (International)—Die Einheit ist Fuß (International). Dies ist die Standardeinstellung. Meilen (Britisch)—Die Einheit ist Meilen (Britisch). 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
Ausgabeformat (optional)	Gibt das Ausgabeformat an. CSV—Die Ausgabe ist eine .csv-Datei. Dies ist die Standardeinstellung. Tabelle—Die Ausgabe ist eine Geodatabase-Tabelle.	String
Ausgabedatei (optional)	Die Ausgabe-.csv-Datei, die das Routenprotokoll enthält.	File
Ausgabetabelle (optional)	Die Ausgabe-Geodatabase-Tabelle, die das Routenprotokoll enthält.	Table

arcpy.locref.GenerateLRRouteLog(in_route_features, effective_date, {log_fields}, {merge_coincident_events}, {location_fields}, {referent_location}, {referent_features}, {referent_field}, {offset_units}, {output_format}, {out_file}, {out_table})

Name	Erläuterung	Datentyp
in_route_features	Die Routen-Features, die zum Generieren des Routenprotokolls verwendet werden.	Feature Layer
effective_date	Das Datum, mit dem die Zeitdatenansicht des Netzwerks definiert wird. Der Standardwert ist das aktuelle Datum.	Date
log_fields [log_fields,...] (optional)	Die Felder, die verwendet werden, um Objekt- und Schnittpunktinformationen in der Ausgabe anzuzeigen. Layer: Der Feature-Layer, der als Protokoll-Layer verwendet wird. Feld: Das Feld, das am Routenprotokoll beteiligt ist.	Value Table
merge_coincident_events (optional)	Gibt an, ob lagegleiche Linienobjekte in der Ausgabe zusammengeführt werden. MERGE—Lagegleiche Linienobjekt mit demselben Wert im Protokollfeld werden zusammengeführt und als Einzelobjekt zurückgegeben. DO_NOT_MERGE—Lagegleiche Linienobjekt mit demselben Wert im Protokollfeld werden nicht zusammengeführt oder als Einzelobjekt zurückgegeben. Dies ist die Standardeinstellung.	Boolean
location_fields [location_fields,...] (optional)	Diese Felder werden verwendet, um die Attribute der von den Routen durchquerten Polygongrenzen anzuzeigen. Layer: Der Feature-Layer, der als Positions-Layer verwendet wird. Feld: Das Feld, das die Attribute der von den Routen durchquerten Polygongrenzen enthält.	Value Table
referent_location (optional)	Gibt die Methode an, die zum Berechnen des Referenzversatzes verwendet wird. NONE—Der Referenzversatz wird nicht berechnet. Dies ist die Standardeinstellung. NEAREST_UPSTREAM—Das nächstgelegene vorgelagerte Referenz-Feature des Routenprotokolleintrags wird für die Berechnung des Referenzversatzes verwendet. Ist kein vorgelagertes Referenz-Feature vorhanden, sind die Referenzwerte leer. NEAREST—Das nächstgelegene nachgelagerte Referenz-Feature des Routenprotokolleintrags wird für die Berechnung des Referenzversatzes verwendet.	String
referent_features (optional)	Der Feature-Layer, der zum Berechnen des Versatzes vom Routenprotokolleintrag verwendet wird.	Feature Layer
referent_field (optional)	Das Referenzfeld, das die Attribute der Referenz-Features in der Ausgabe enthält.	Field
offset_units (optional)	Gibt die Versatzeinheiten an, die verwendet werden, um die Entfernung zwischen dem Referenz-Feature und dem Routenprotokolleintrag zu berechnen. 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. INTFEET—Die Einheit ist Fuß (International). Dies ist die Standardeinstellung. INTMILES—Die Einheit ist Meilen (Britisch). 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
output_format (optional)	Gibt das Ausgabeformat an. CSV—Die Ausgabe ist eine .csv-Datei. Dies ist die Standardeinstellung. TABLE—Die Ausgabe ist eine Geodatabase-Tabelle.	String
out_file (optional)	Die Ausgabe-.csv-Datei, die das Routenprotokoll enthält.	File
out_table (optional)	Die Ausgabe-Geodatabase-Tabelle, die das Routenprotokoll enthält.	Table

Codebeispiel

GenerateLRRouteLog: Beispiel 1 (Python-Fenster)

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

# Name: GenerateLRRouteLog_ex1.py 
# Description: Create a route log data product that returns the location and information of signal events,
# functional class events, reference posts, intersections, and county boundaries for routes in an LRS Network
# Requirements: ArcGIS Location Referencing

# Set tool variables 
in_route_features = "CountyLog"
effective_date = "12/31/2024"
log_fields = "Signal SIGNAL_MODE; Functional_Class FUNCTIONAL_CLASS; Intersections IntersectionName"
merge_coincident_events = "DO_NOT_MERGE"
location_fields = "Counties NAME"
referent_location = "NEAREST_UPSTREAM"
referent_features = "Reference_Post"
referent_field = "POST_NAME"
offset_units = "INTFEET"
output_format = "TABLE"
out_file = None
out_table = r"C:\Data\SampleData.gdb\RL1"

# Run the tool 
arcpy.locref.GenerateLRRouteLog(in_route_features, effective_date, log_fields, merge_coincident_events,
                                location_fields, referent_location, referent_features, referent_field,
                                offset_units, output_format, out_file, out_table)

GenerateLRRouteLog: Beispiel 2 (eigenständiges Skript)

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

# Name: GenerateLRRouteLog_ex2.py 
# Description: For routes in an LRS Network, create a route log data product that returns the location and information of anomalies, pipes, crossing utility intersections, operating pressure,
# ILI surveys, as well as county and city boundaries
# Requirements: ArcGIS Location Referencing

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

# Set current workspace  
arcpy.env.workspace = r"C:\Data\SampleData.gdb"

# Using the Anomaly point event feature class, create a feature layer that contains active anomalies, to be used as a log layer
arcpy.management.MakeFeatureLayer("Anomaly", "Anomaly_Active", "anomalystatus = 'Active'")

# Using the Pipes line event feature class, create three feature layers, each representing a different pipe material, to be used as log layers
arcpy.management.MakeFeatureLayer("Pipes", "Pipes_CastIron", "MATERIAL = 2") 
arcpy.management.MakeFeatureLayer("Pipes", "Pipes_Copper", "MATERIAL = 4") 
arcpy.management.MakeFeatureLayer("Pipes", "Pipes_Composite", "MATERIAL = 10") 

# Set tool variables 
in_route_features = "Engineering Network"
effective_date = "12/31/2024"
log_fields = "Anomaly_Active anomalytype; Crossing Utility Intersection intersectionname; Pipes_CastIron status; Pipes_Copper status; Pipes_Composite status; Operating Pressure pressurevalue"
merge_coincident_events = "DO_NOT_MERGE"
location_fields = "Counties NAME; Cities CITY_NM"
referent_location = "NEAREST_UPSTREAM"
referent_features = "ILI Survey Readings"
referent_field = "surveytype"
offset_units = "INTFEET"
output_format = "TABLE"
out_file = None
out_table = r"C:\Data\SampleData.gdb\RL2"
 
# Run the tool 
arcpy.locref.GenerateLRRouteLog(in_route_features, effective_date, log_fields, merge_coincident_events,
                                location_fields, referent_location, referent_features, referent_field,
                                offset_units, output_format, out_file, out_table)

GenerateLRRouteLog: Beispiel 3 (eigenständiges Skript)

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

# Name: GenerateLRRouteLog_ex3.py 
# Description: Create a route log data product that returns the location and information of crashes, speed limits, pavement conditions,
# centerlines, intersections, and city boundaries for routes in a combined LRS and Address Data Management dataset that is published as a feature service
# Requires: ArcGIS Location Referencing 
 
# Import arcpy module 
import arcpy 
 
# Check out the license 
arcpy.CheckOutExtension("LocationReferencing") 
 
# Data is in a feature service. Signing in to the Enterprise 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, 11 corresponds to the LRS Network's layer ID
in_route_features = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/11"

# Create the feature layers from the feature service. The feature layers will be used as log layers
arcpy.management.MakeFeatureLayer(r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/25", "crash")
arcpy.management.MakeFeatureLayer(r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/24", "intersections")
arcpy.management.MakeFeatureLayer(r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/17", "speed_limit")
arcpy.management.MakeFeatureLayer(r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/14", "pavement_condition")
arcpy.management.MakeFeatureLayer(r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/19", "centerline")

# Create a feature layer from the Cities layer of the feature service to be used as the location layer
arcpy.management.MakeFeatureLayer(r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/21", "cities")

# Map the Reference Post layer from the feature service to be used as the input to the referent_features parameter
referent_features = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/26"

# Set tool variables 
effective_date = "12/31/2024"
log_fields = "crash CrashType; intersections IntersectionName; speed_limit SpeedLimit; pavement_condition Condition; centerline fullname"
merge_coincident_events = "MERGE"
location_fields = "cities name"
referent_location = "NEAREST"
referent_field = "PostName"
offset_units = "INTFEET"
output_format = "CSV"
out_file = r"C:\Data\RL3.csv"
out_table = None
 
# Run the tool 
arcpy.locref.GenerateLRRouteLog(in_route_features, effective_date, log_fields, merge_coincident_events,
                                location_fields, referent_location, referent_features, referent_field,
                                offset_units, output_format, out_file, out_table)
 
# Check in the 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)