Anzahl der linear referenzierten Features generieren (Location Referencing)

Mit der Location Referencing-Lizenz verfügbar.

Zusammenfassung

Erstellt Feature-Anzahl-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.

  • Der Zusammenfassungs-Layer muss eine Polygon-Feature-Class, eine Feature-Class für LRS-Linienobjekte, die im angegebenen LRS-Netzwerk registriert ist, oder ein LRS-Netzwerk sein.

  • Der Wert "Nicht klassifiziert" wird in den Ausgabe-Zusammenfassungsfeldern für die Routen einbezogen, die nicht mit den Zusammenfassungs-Layern überlappen.

  • Es können mehrere Zusammenfassungsfelder hinzugefügt werden.

  • Die Ausgabe wird auf Grundlage des Schnittpunktes ausgewählter Features aus dem LRS-Netzwerk, den Zusammenfassungs-Layern und den Feature-Anzahl-Layern erstellt.

  • Beim Feature-Anzahl-Layer muss 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.

  • Der Wert "Nicht klassifiziert" wird in den Ausgabe-Feature-Anzahl-Feldern für die Routen einbezogen, die nicht mit den Feature-Anzahl-Layern überlappen.

  • Die Zusammenfassungs- und Feature-Anzahl-Layer müssen in der gleichen Geodatabase oder dem gleichen Feature-Service gespeichert sein und das gleiche Koordinatensystem wie das angegebene LRS-Netzwerk verwenden.

  • Sie können mehrere Feature-Anzahl-Layer aus derselben Feature-Class hinzufügen, indem Sie Auswahl-Layer erstellen und jeden Auswahl-Layer als Feature-Anzahl-Layer festlegen. Wenn Sie beispielsweise über eine Feature-Class für LRS-Punktobjekte verfügen, können Sie zwei Auswahl-Layer erstellen, Klasse A und Klasse B, und beide Auswahl-Layer als Feature-Anzahl-Layer festlegen.

Parameter

BeschriftungErläuterungDatentyp
Eingabe-Routen-Features

Die Routen-Features, die zum Erstellen des Feature-Anzahl-Datenprodukts verwendet werden.

Feature Layer
Gültig ab

Das Datum, mit dem die Zeitdatenansicht des Netzwerks definiert wird.

Der Standardwert ist das aktuelle Datum.

Date
Zusammenfassungsfelder
(optional)

Die Felder die zum Anzeigen der Namen für die Zusammenfassungszeilen in der Ausgabe verwendet werden.

  • Layer: Der Feature-Layer, der als Zusammenfassungs-Layer verwendet wird.
  • Feld: Das Feld, das zur Zusammenfassung der Feature-Anzahl verwendet wird.
  • Ausgabefeldname: Der Anzeigename des Zusammenfassungsfeldes in der Ausgabe.

Value Table
Feature-Anzahl-Layer
(optional)

Die Layer, die zum Verorten der Anzahl der Features entlang einer Route verwendet werden.

  • Layer: Der Feature-Layer, der als Feature-Anzahl-Layer verwendet wird.
  • Ausgabefeldname: Der Anzeigename des Feature-Anzahl-Layers in der Ausgabe.

Value Table
Zusammenfassungszeilen mit NULL-Wert ausschließen
(optional)

Gibt an, ob Zusammenfassungszeilen mit NULL-Werten in der Ausgabe ausgeschlossen werden sollen.

  • Aktiviert: Zeilen, die nur Feature-Anzahlen mit dem Wert 0 enthalten (Zusammenfassungszeilen mit NULL-Wert) werden von der Ausgabe ausgeschlossen. Dies ist die Standardeinstellung.
  • Deaktiviert: Zeilen, die nur Feature-Anzahlen mit dem Wert 0 enthalten (Zusammenfassungszeilen mit NULL-Wert) werden von der Ausgabe nicht ausgeschlossen.
Boolean
Ausgabeformat
(optional)

Gibt das Ausgabeformat an.

  • CSVDie Ausgabe ist eine .csv-Datei. Dies ist die Standardeinstellung.
  • TabelleDie Ausgabe ist eine Geodatabase-Tabelle.
String
Ausgabedatei
(optional)

Die Ausgabe-.csv-Datei, die das Feature-Anzahl-Datenprodukt enthält.

File
Ausgabetabelle
(optional)

Die Ausgabe-Geodatabase-Tabelle, die das Feature-Anzahl-Datenprodukt enthält.

Table

arcpy.locref.GenerateLRFeatureCount(in_route_features, effective_date, {summary_fields}, {feature_count_layers}, {exclude_null_summary_rows}, {output_format}, {out_file}, {out_table})
NameErläuterungDatentyp
in_route_features

Die Routen-Features, die zum Erstellen des Feature-Anzahl-Datenprodukts verwendet werden.

Feature Layer
effective_date

Das Datum, mit dem die Zeitdatenansicht des Netzwerks definiert wird.

Der Standardwert ist das aktuelle Datum.

Date
summary_fields
[summary_fields,...]
(optional)

Die Felder die zum Anzeigen der Namen für die Zusammenfassungszeilen in der Ausgabe verwendet werden.

  • Layer: Der Feature-Layer, der als Zusammenfassungs-Layer verwendet wird.
  • Feld: Das Feld, das zur Zusammenfassung der Feature-Anzahl verwendet wird.
  • Ausgabefeldname: Der Anzeigename des Zusammenfassungsfeldes in der Ausgabe.

Value Table
feature_count_layers
[feature_count_layers,...]
(optional)

Die Layer, die zum Verorten der Anzahl der Features entlang einer Route verwendet werden.

  • Layer: Der Feature-Layer, der als Feature-Anzahl-Layer verwendet wird.
  • Ausgabefeldname: Der Anzeigename des Feature-Anzahl-Layers in der Ausgabe.

Value Table
exclude_null_summary_rows
(optional)

Gibt an, ob Zusammenfassungszeilen mit NULL-Werten in der Ausgabe ausgeschlossen werden sollen.

  • EXCLUDEZeilen, die nur Feature-Anzahlen mit dem Wert 0 enthalten (Zusammenfassungszeilen mit NULL-Wert) werden von der Ausgabe ausgeschlossen. Dies ist die Standardeinstellung.
  • DO_NOT_EXCLUDEZeilen, die nur Feature-Anzahlen mit dem Wert 0 enthalten (Zusammenfassungszeilen mit NULL-Wert) werden von der Ausgabe nicht ausgeschlossen.
Boolean
output_format
(optional)

Gibt das Ausgabeformat an.

  • CSVDie Ausgabe ist eine .csv-Datei. Dies ist die Standardeinstellung.
  • TABLEDie Ausgabe ist eine Geodatabase-Tabelle.
String
out_file
(optional)

Die Ausgabe-.csv-Datei, die das Feature-Anzahl-Datenprodukt enthält.

File
out_table
(optional)

Die Ausgabe-Geodatabase-Tabelle, die das Feature-Anzahl-Datenprodukt enthält.

Table

Codebeispiel

GenerateLRFeatureCount: Beispiel 1 (eigenständiges Skript)

Das folgende eigenständige Skript veranschaulicht, wie die Funktion GenerateLRFeatureCount in einem eigenständigen Skript verwendet wird.

# Name: GenerateLRFeatureCount_ex1.py 
# Description: Create a feature count data product that provides the number of active anomalies, pipeline crossings, and DOT Class line events per route
# Requirements: ArcGIS Location Referencing  
 
# Import arcpy module 
import arcpy 
 
# Check out any necessary licenses 
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 feature count layer
arcpy.management.MakeFeatureLayer("Anomaly", "Anomaly_Active", "anomalystatus = 'Active'")

# Using the DOT Class line event feature class, create 3 feature layers, each representing a class type, to be used as feature count layers
arcpy.management.MakeFeatureLayer("DOTClass", "Class_A", "classtype = 1") 
arcpy.management.MakeFeatureLayer("DOTClass", "Class_B", "classtype = 2")   
arcpy.management.MakeFeatureLayer("DOTClass", "Class_C", "classtype = 3")

# Set tool variables 
in_route_features = "EngineeringNetwork" 
effective_date = "12/31/2024" 
summary_fields = "Counties NAME Counties"
feature_count_layers = "Anomaly_Active 'Anomaly'; PipeCrossing 'Pipe Crossings'; Class_A 'Class A'; Class_B 'Class B'; Class_C 'Class C'"
exclude_null_summary_rows = "EXCLUDE"
output_format = "TABLE" 
out_file = None
out_table = r"C:\Data\SampleData.gdb\FC1" 

# Run the tool 
arcpy.locref.GenerateLRFeatureCount(in_route_features, effective_date, summary_fields, feature_count_layers, exclude_null_summary_rows, output_format, out_file, out_table) 

# Check in licenses 
arcpy.CheckInExtension("LocationReferencing")
GenerateLRFeatureCount: Beispiel 2 (Python-Fenster)

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

# Name: GenerateLRFeatureCount_ex2.py 
# Description: Create a feature count data product that provides the number of bridges and intersections per route
# Requirements: ArcGIS Location Referencing  

# Set tool variables 
in_route_features = "CountyLog" 
effective_date = "12/31/2024" 
summary_fields = "Counties NAME Counties"
feature_count_layers = "Bridge_Point 'Bridges'; Intersections 'Intersections'"
exclude_null_summary_rows = "EXCLUDE"
output_format = "TABLE" 
out_file = None 
out_table = r"C:\Data\SampleData.gdb\FC2"
 
# Run the tool 
arcpy.locref.GenerateLRFeatureCount(in_route_features, effective_date, summary_fields, feature_count_layers,
                                    exclude_null_summary_rows, output_format, out_file, out_table)
GenerateLRFeatureCount: Beispiel 3 (eigenständiges Skript)

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

# Name: GenerateLRFeatureCount_ex3.py 
# Description: Create a feature count data product that provides the number of active anomalies, pipeline casing material types, and crossing utility intersections per route
# Requirements: 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, 49 corresponds to the LRS Network's layer ID
in_route_features = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/49"

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

# Create the feature layers from the feature service. The feature layers will be used as feature count layers
arcpy.management.MakeFeatureLayer(r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/18", "Anomaly_Active", "anomalystatus = 'Active'")
arcpy.management.MakeFeatureLayer(r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/54", "Casing_CastIron", "MATERIAL = 2")
arcpy.management.MakeFeatureLayer(r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/54", "Casing_Copper", "MATERIAL = 4")
arcpy.management.MakeFeatureLayer(r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/54", "Casing_Composite", "MATERIAL = 10")
arcpy.management.MakeFeatureLayer(r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/61", "Crossing_Utility_Intersection")

# Set tool variables 
effective_date = "12/31/2024" 
summary_fields = "Cities NAME Cities"
feature_count_layers = "Anomaly_Active 'Anomalies'; Casing_CastIron 'Cast Iron Casing'; Casing_Copper 'Copper Casing'; Casing_Composite 'Composite Casing'; Crossing_Utility_Intersection 'Crossing Utility Intersections'"
exclude_null_summary_rows = "EXCLUDE"
output_format = "CSV" 
out_file = r"C:\Data\FC3.csv"
out_table = None

# Run the tool 
arcpy.locref.GenerateLRFeatureCount(in_route_features, effective_date, summary_fields, feature_count_layers,
                                    exclude_null_summary_rows, output_format, out_file, out_table)
 
# Check in the license 
arcpy.CheckInExtension("LocationReferencing")

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)

Verwandte Themen