Nach oben

Zusammenfassung der linear referenzierten Längen generieren (Location Referencing)

In diesem Thema

  1. Zusammenfassung
  2. Verwendung
  3. Parameter
  4. Umgebungen
  5. Lizenzinformationen

Mit der Location Referencing-Lizenz verfügbar.

Zusammenfassung

Erstellt ein Längendatenprodukt 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 Längen-Layer muss ein LRS-Netzwerk oder eine Feature-Class für LRS-Linienobjekte sein, die im angegebenen LRS-Netzwerk registriert ist.

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

  • 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 Längen-Layern erstellt.

  • Sie können mehrere Längenfelder aus derselben Feature-Class hinzufügen, indem Sie Auswahl-Layer erstellen und jeden Auswahl-Layer als Längenfeld 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 Längenfeld festlegen.

Parameter

DialogfeldPython

BeschriftungErläuterungDatentyp
Eingabe-Routen-Features

Die Routen-Features, die zum Berechnen des LRS-Längendatenprodukts verwendet werden.

Feature Layer
Gültig ab

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

Der Standardwert ist das aktuelle Datum.

Date
Längeneinheiten

Gibt die Maßeinheit an, die für die Längenfelder in der Ausgabe verwendet wird.

  • 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).
  • 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
Zusammenfassungsfelder
(optional)

Die Felder aus den Layern, 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 Länge verwendet wird.
  • Ausgabefeldname: Der Anzeigename des Zusammenfassungsfeldes in der Ausgabe.
Value Table
Längenfelder
(optional)

Die Felder aus den Layern, die zum Anzeigen der Länge der Routen in der Ausgabe verwendet werden.

  • Layer: Der Feature-Layer, der als Grundlage für die Berechnung der Länge verwendet wird.
  • Ausgabefeldname: Der Anzeigename des Längenfeldes 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 mit einer Länge von 0 (Zusammenfassungszeilen mit NULL-Wert) werden von der Ausgabe ausgeschlossen. Dies ist die Standardeinstellung.
  • Deaktiviert: Zeilen mit einer Länge von 0 (Zusammenfassungszeilen mit NULL-Wert) werden in der Ausgabe berücksichtigt.
Boolean
Länge für dominante Routen berechnen
(optional)
Hinweis:

In einer zukünftigen Version wird Unterstützung für diesen Parameter hinzugefügt.

Boolean
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 Längendatenprodukt enthält.

File
Ausgabetabelle
(optional)

Die Ausgabe-Geodatabase-Tabelle, die das Längendatenprodukt enthält.

Table

arcpy.locref.GenerateLRLengthSummary(in_route_features, effective_date, units, {summary_fields}, {length_fields}, {exclude_null_summary_rows}, {calculate_length_for_dominant_routes}, {output_format}, {out_file}, {out_table})
NameErläuterungDatentyp
in_route_features

Die Routen-Features, die zum Berechnen des LRS-Längendatenprodukts verwendet werden.

Feature Layer
effective_date

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

Der Standardwert ist das aktuelle Datum.

Date
units

Gibt die Maßeinheit an, die für die Längenfelder in der Ausgabe verwendet wird.

  • 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).
  • 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
summary_fields
[summary_fields,...]
(optional)

Die Felder aus den Layern, 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 Länge verwendet wird.
  • Ausgabefeldname: Der Anzeigename des Zusammenfassungsfeldes in der Ausgabe.
Value Table
length_fields
[length_fields,...]
(optional)

Die Felder aus den Layern, die zum Anzeigen der Länge der Routen in der Ausgabe verwendet werden.

  • Layer: Der Feature-Layer, der als Grundlage für die Berechnung der Länge verwendet wird.
  • Ausgabefeldname: Der Anzeigename des Längenfeldes in der Ausgabe.
Value Table
exclude_null_summary_rows
(optional)

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

  • EXCLUDE—Zeilen mit einer Länge von 0 (Zusammenfassungszeilen mit NULL-Wert) werden von der Ausgabe ausgeschlossen. Dies ist die Standardeinstellung.
  • DO_NOT_EXCLUDE—Zeilen mit einer Länge von 0 (Zusammenfassungszeilen mit NULL-Wert) werden nicht von der Ausgabe ausgeschlossen.
Boolean
calculate_length_for_dominant_routes
(optional)
Hinweis:

In einer zukünftigen Version wird Unterstützung für diesen Parameter hinzugefügt.

Boolean
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 Längendatenprodukt enthält.

File
out_table
(optional)

Die Ausgabe-Geodatabase-Tabelle, die das Längendatenprodukt enthält.

Table

Codebeispiel

GenerateLRLengthSummary: Beispiel 1 (eigenständiges Skript)

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

# Name: GenerateLRLengthSummary_ex1.py 
# Description: Create a length data product that provides the length of routes for three class types, summarized by counties with a population of more than 50,000
# 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" 

# Create a feature layer of counties that have more than 50,000 population, to be used as summary field
arcpy.management.MakeFeatureLayer("counties", "counties_50K", "POPULATION > 50000")

# Create 3 feature layers, each representing a class type, to be used as length fields
arcpy.management.MakeFeatureLayer("Class", "Class_A", "classtype = 1") 
arcpy.management.MakeFeatureLayer("Class", "Class_B", "classtype = 2")   
arcpy.management.MakeFeatureLayer("Class", "Class_C", "classtype = 3") 

# Set tool variables 
in_route_features = "Network" 
effective_date = "12/31/2024" 
units = "METERS" 
summary_fields = "counties_50K NAME Counties"
length_fields = "Class_A 'Class A'; Class_B 'Class B'; Class_C 'Class C'"
exclude_null_summary_rows = "EXCLUDE"
calculate_length_for_dominant_routes = None
output_format = "CSV" 
out_file = r"C:\Data\LP1.csv" 
out_table = None 

# Run the tool 
arcpy.locref.GenerateLRLengthSummary(in_route_features, effective_date, units, summary_fields, length_fields,
                                     exclude_null_summary_rows, calculate_length_for_dominant_routes,
                                     output_format, out_file, out_table) 

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

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

# Name: GenerateLRLengthSummary_ex2.py 
# Description: Create a length data product that provides the length of routes for all class types, summarized by counties
# Requirements: ArcGIS Location Referencing 
 
# Set tool variables 
in_route_features = "Network" 
effective_date = "12/31/2024" 
units = "METERS" 
summary_fields = "Counties NAME Counties" 
length_fields = "'Class' 'Class'"  
exclude_null_summary_rows = "DO_NOT_EXCLUDE" 
calculate_length_for_dominant_routes = None 
output_format = "CSV" 
out_file = r"C:\Data\LP2.csv" 
out_table = None 
 
# Run the tool 
arcpy.locref.GenerateLRLengthSummary(in_route_features, effective_date, units, summary_fields, length_fields,
                                     exclude_null_summary_rows, calculate_length_for_dominant_routes,
                                     output_format, out_file, out_table)
GenerateLRLengthSummary: Beispiel 3 (eigenständiges Skript)

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

# Name: GenerateLRLengthSummary_ex3.py 
# Description: Using LRS data in a feature service, create a length data product that provides the length of routes
# for three class types, summarized by counties with a population of more than 50,000
# 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, 1 corresponds to the LRS Network's layer ID
in_route_features = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/1"

# Map the Counties layer from the feature service. Here, 39 corresponds to the Counties layer's layer ID
counties = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/39"

# Create a feature layer of counties that have more than 50,000 population, to be used as summary field 
arcpy.management.MakeFeatureLayer(counties, "counties_50K", "POPULATION > 50000")

# Map the Class layer from the feature service. Here, 22 corresponds to the Class layer's layer ID
classlayer = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/22"

# Create 3 feature layers, each representing a class type, to be used as length fields 
arcpy.management.MakeFeatureLayer(classlayer, "Class_A", "classtype = 1") 
arcpy.management.MakeFeatureLayer(classlayer, "Class_B", "classtype = 4")   
arcpy.management.MakeFeatureLayer(classlayer, "Class_C", "classtype = 7")

# Set tool variables 
effective_date = "12/31/2024" 
units = "METERS" 
summary_fields = "counties_50K NAME Counties" 
length_fields = "Class_A 'Class A'; Class_B 'Class B'; Class_C 'Class C'"
exclude_null_summary_rows = "EXCLUDE"
calculate_length_for_dominant_routes = None
output_format = "CSV" 
out_file = r"C:\Data\LP3.csv" 
out_table = None 
 
# Run the tool 
arcpy.locref.GenerateLRLengthSummary(in_route_features, effective_date, units, summary_fields, length_fields,
                                     exclude_null_summary_rows, calculate_length_for_dominant_routes,
                                     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)

Verwandte Themen

  • Überblick über das Toolset "Datenprodukte"
  • Suchen eines Geoverarbeitungswerkzeugs

Feedback zu diesem Thema?

In diesem Thema
  1. Zusammenfassung
  2. Verwendung
  3. Parameter
  4. Umgebungen
  5. Lizenzinformationen