Générer un produit de données Synthèse des longueurs avec référencement linéaire (Location Referencing)—ArcGIS Pro

Disponible avec la licence Location Referencing.

Synthèse

Crée un produit de données de longueur pour des itinéraires dans un réseau LRS sans modèle de données LRS.

Utilisation

Cet outil prend en charge les données d’une géodatabase fichier, d’une géodatabase d’entreprise (connexion de versionnement de branche) ou d’un service d’entités (publié à partir de données en branche versionnées).
Cet outil ne modifie pas les entrées et crée un fichier .csv ou une table de géodatabase en sortie.
Le paramètre Date d’effet permet de définir la vue temporelle du réseau. Seuls les itinéraires actifs à cette date servent à calculer la sortie.
La couche de synthèse doit être une classe d’entités surfaciques, une classe d’entités d’événement linéaire LRS inscrite auprès du réseau LRS spécifié ou un réseau LRS.
La couche de longueur doit être un réseau LRS ou une classe d’entités d’événement linéaire LRS inscrite auprès du réseau LRS spécifié.
Les couches de synthèse et de longueur doivent être stockées dans la même géodatabase ou le même service d’entités et avoir le même système de coordonnées que le réseau LRS spécifié.
Une valeur non classée est incluse dans les champs de synthèse en sortie pour les itinéraires qui ne sont pas superposés avec les couches de synthèse.
Vous pouvez ajouter plusieurs champs de synthèse.
La sortie est créée en se basant sur l’intersection des entités sélectionnées à partir du réseau LRS, des couches de synthèse et des couches de longueur.
Vous pouvez ajouter plusieurs champs de longueur de la même classe d’entités en créant des couches de sélection et en définissant chaque couche de sélection comme champ de longueur. Par exemple, si vous avez une classe d’entités d’événement linéaire LRS, vous pouvez créer deux couches de sélection (Classe A et Classe B) et définir chaque couche de sélection comme champ de longueur.

Paramètres

Étiquette	Explication	Type de données
Entités itinéraires en entrée	Entités itinéraires qui seront utilisées pour calculer le produit de données de longueur LRS.	Feature Layer
Date d’effet	Date d’effet à utiliser pour définir la vue temporelle du réseau. La valeur par défaut est la date d’aujourd’hui.	Date
Unités de longueur	Spécifie l’unité de mesure utilisée pour les champs de longueur dans la sortie. Pouces d’arpentage américains—Les unités seront les pouces. Pieds d’arpentage américains—L’unité est le pied. Yards d’arpentage américains—L’unité est le yard. Miles d’arpentage américains—L’unité est le mile. Milles nautiques (Arpentage américain)—L’unité est le mille nautique. Pieds internationaux—L’unité est le pied international. Milles terrestres—L’unité est le mille terrestre. Millimètres—L'unité est le millimètre. Centimètres—L'unité est le centimètre. Mètres—L’unité est le mètre. Kilomètres—L’unité est le kilomètre Décimètres—L'unité est le décimètre.	String
Champs de récapitulation (Facultatif)	Champs des couches qui seront utilisés pour afficher les noms des lignes de résumé dans la sortie. Couche : couche d’entités qui servira de couche de synthèse. Champ : champ qui sera utilisé pour synthétiser la longueur. Nom du champ en sortie : nom d’affichage du champ de récapitulation dans la sortie.	Value Table
Champs de longueur (Facultatif)	Champs des couches qui seront utilisés pour afficher la longueur des itinéraires dans la sortie. Couche : couche d’entités qui servira de base au calcul de la longueur. Nom du champ en sortie : nom d’affichage du champ de longueur dans la sortie.	Value Table
Exclure les lignes de résumé nulles (Facultatif)	Indique si les lignes de résumé nulles sont exclues de la sortie. Activé : les lignes de longueur nulle (lignes de résumé nulles) seront exclues de la sortie. Il s’agit de l’option par défaut. Désactivé : les lignes de longueur nulle (lignes de résumé nulles) ne seront pas exclues de la sortie.	Boolean
Calculer la longueur des itinéraires dominants (Facultatif)	Remarque : La prise en charge de ce paramètre sera intégrée dans une version ultérieure.	Boolean
Format en sortie (Facultatif)	Spécifie le format de la sortie. CSV—La sortie est un fichier .csv. Il s’agit de l’option par défaut. Table—La sortie est une table de géodatabase.	String
Fichier en sortie (Facultatif)	Fichier .csv en sortie devant contenir le produit de données de longueur.	File
Table en sortie (Facultatif)	Table de géodatabase en sortie devant contenir le produit de données de longueur.	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})

Nom	Explication	Type de données
in_route_features	Entités itinéraires qui seront utilisées pour calculer le produit de données de longueur LRS.	Feature Layer
effective_date	Date d’effet à utiliser pour définir la vue temporelle du réseau. La valeur par défaut est la date d’aujourd’hui.	Date
units	Spécifie l’unité de mesure utilisée pour les champs de longueur dans la sortie. INCHES—Les unités seront les pouces. FEET—L’unité est le pied. YARDS—L’unité est le yard. MILES—L’unité est le mile. NAUTICAL_MILES—L’unité est le mille nautique. INTFEET—L’unité est le pied international. INTMILES—L’unité est le mille terrestre. MILLIMETERS—L'unité est le millimètre. CENTIMETERS—L'unité est le centimètre. METERS—L’unité est le mètre. KILOMETERS—L’unité est le kilomètre DECIMETERS—L'unité est le décimètre.	String
summary_fields [summary_fields,...] (Facultatif)	Champs des couches qui seront utilisés pour afficher les noms des lignes de résumé dans la sortie. Couche : couche d’entités qui servira de couche de synthèse. Champ : champ qui sera utilisé pour synthétiser la longueur. Nom du champ en sortie : nom d’affichage du champ de récapitulation dans la sortie.	Value Table
length_fields [length_fields,...] (Facultatif)	Champs des couches qui seront utilisés pour afficher la longueur des itinéraires dans la sortie. Couche : couche d’entités qui servira de base au calcul de la longueur. Nom du champ en sortie : nom d’affichage du champ de longueur dans la sortie.	Value Table
exclude_null_summary_rows (Facultatif)	Indique si les lignes de résumé nulles sont exclues de la sortie. EXCLUDE—Les lignes de longueur nulle (lignes de résumé nulles) seront exclues de la sortie. Il s’agit de l’option par défaut. DO_NOT_EXCLUDE—Les lignes de longueur nulle (lignes de résumé nulles) ne seront pas exclues de la sortie.	Boolean
calculate_length_for_dominant_routes (Facultatif)	Remarque : La prise en charge de ce paramètre sera intégrée dans une version ultérieure.	Boolean
output_format (Facultatif)	Spécifie le format de la sortie. CSV—La sortie est un fichier .csv. Il s’agit de l’option par défaut. TABLE—La sortie est une table de géodatabase.	String
out_file (Facultatif)	Fichier .csv en sortie devant contenir le produit de données de longueur.	File
out_table (Facultatif)	Table de géodatabase en sortie devant contenir le produit de données de longueur.	Table

Exemple de code

Exemple 1 d’utilisation de la fonction GenerateLRLengthSummary (script autonome)

Le script autonome ci-dessous illustre l’utilisation de la fonction GenerateLRLengthSummary dans un script autonome.

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

Exemple 2 d’utilisation de la fonction GenerateLRLengthSummary (fenêtre Python)

Le script ci-dessous montre comment utiliser la fonction GenerateLRLengthSummary dans la fenêtre Python.

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

Exemple 3 d’utilisation de la fonction GenerateLRLengthSummary (script autonome)

Le script autonome suivant illustre l’utilisation de la fonction GenerateLRLengthSummary avec les données d’un service d’entités.

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

Environnements

Espace de travail courant

Informations de licence

Basic: Nécessite ArcGIS Location Referencing (ArcGIS Pipeline Referencing ou ArcGIS Roads and Highways)
Standard: Nécessite ArcGIS Location Referencing (ArcGIS Pipeline Referencing ou ArcGIS Roads and Highways)
Advanced: Nécessite ArcGIS Location Referencing (ArcGIS Pipeline Referencing ou ArcGIS Roads and Highways)

Rubriques connexes

Vous avez un commentaire à formuler concernant cette rubrique ?