Générer un produit de données Nombre d’entités avec référencement linéaire (Location Referencing)

Disponible avec la licence Location Referencing.

Synthèse

Crée un produit de données de nombre d’entités pour les itinéraires d’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.

  • 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 nombre d’entités.

  • La couche de nombre d’entités doit être une classe d’entités d’événement ponctuel LRS, une classe d’entités d’événement linéaire LRS ou une classe d’entités d’intersection LRS inscrite auprès du réseau LRS spécifié.

  • Une valeur non classée est incluse dans les champs de nombre d’entités en sortie des itinéraires qui ne sont pas superposés aux couches de nombre d’entités.

  • Les couches de synthèse et de nombre d’entités 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é.

  • Vous pouvez ajouter plusieurs couches de nombre d’entités 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 couche de nombre d’entités. Par exemple, si vous avez une classe d’entités d’événement ponctuel LRS, vous pouvez créer deux couches de sélection (Classe A et Classe B) et définir chaque couche de sélection comme couche de nombre d’entités.

Paramètres

ÉtiquetteExplicationType de données
Entités itinéraires en entrée

Entités itinéraires utilisées pour créer le produit de données de nombre d’entités.

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
Champs de récapitulation
(Facultatif)

Champs utilisés pour afficher les noms des lignes de synthèse dans la sortie.

  • Couche : couche d’entités qui servira de couche de synthèse.
  • Champ : champ utilisé pour synthétiser le nombre d’entités.
  • Nom du champ en sortie : nom d’affichage du champ de récapitulation dans la sortie.

Value Table
Couches Nombre d’entités
(Facultatif)

Couches utilisées pour localiser le nombre d’entités le long d’un itinéraire.

  • Couche : couche d’entités utilisée comme de couche de nombre d’entités.
  • Nom du champ en sortie : nom d’affichage du champ de nombre d’entités 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 qui ne comportent que des nombres d’entités égaux à zéro (lignes de synthèse nulles) sont exclues de la sortie. Il s’agit de l’option par défaut.
  • Désactivé : les lignes qui ne comportent que des nombres d’entités égaux à zéro (lignes de synthèse nulles) ne sont pas exclues de la sortie.
Boolean
Format en sortie
(Facultatif)

Spécifie le format de la sortie.

  • CSVLa sortie est un fichier .csv. Il s’agit de l’option par défaut.
  • TableLa sortie est une table de géodatabase.
String
Fichier en sortie
(Facultatif)

Fichier .csv en sortie devant contenir le produit de données de nombre d’entités.

File
Table en sortie
(Facultatif)

Table de géodatabase en sortie devant contenir le produit de données de nombre d’entités.

Table

arcpy.locref.GenerateLRFeatureCount(in_route_features, effective_date, {summary_fields}, {feature_count_layers}, {exclude_null_summary_rows}, {output_format}, {out_file}, {out_table})
NomExplicationType de données
in_route_features

Entités itinéraires utilisées pour créer le produit de données de nombre d’entités.

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

Champs utilisés pour afficher les noms des lignes de synthèse dans la sortie.

  • Couche : couche d’entités qui servira de couche de synthèse.
  • Champ : champ utilisé pour synthétiser le nombre d’entités.
  • Nom du champ en sortie : nom d’affichage du champ de récapitulation dans la sortie.

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

Couches utilisées pour localiser le nombre d’entités le long d’un itinéraire.

  • Couche : couche d’entités utilisée comme de couche de nombre d’entités.
  • Nom du champ en sortie : nom d’affichage du champ de nombre d’entités dans la sortie.

Value Table
exclude_null_summary_rows
(Facultatif)

Indique si les lignes de résumé nulles sont exclues de la sortie.

  • EXCLUDELes lignes qui ne comportent que des nombres d’entités égaux à zéro (lignes de synthèse nulles) sont exclues de la sortie. Il s’agit de l’option par défaut.
  • DO_NOT_EXCLUDELes lignes qui ne comportent que des nombres d’entités égaux à zéro (lignes de synthèse nulles) ne sont pas exclues de la sortie.
Boolean
output_format
(Facultatif)

Spécifie le format de la sortie.

  • CSVLa sortie est un fichier .csv. Il s’agit de l’option par défaut.
  • TABLELa sortie est une table de géodatabase.
String
out_file
(Facultatif)

Fichier .csv en sortie devant contenir le produit de données de nombre d’entités.

File
out_table
(Facultatif)

Table de géodatabase en sortie devant contenir le produit de données de nombre d’entités.

Table

Exemple de code

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

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

# 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")
Exemple 2 d’utilisation de la fonction GenerateLRFeatureCount (fenêtre Python)

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

# 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)
Exemple 3 d’utilisation de la fonction GenerateLRFeatureCount (script autonome)

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

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

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