Générer un produit de données LRS (Location Referencing)—ArcGIS Pro

Disponible avec la licence Location Referencing.

Synthèse

Transforme les données LRS afin de créer un produit de données de longueur, de journal d’itinéraire ou de nombre d’entités pour les itinéraires dans un réseau LRS.

Utilisation

Le modèle doit être un fichier .json.
Utilisez une classe d’entités de réseau pour le paramètre Input Route Features (Entités itinéraires en entrée).
Cet outil ne modifie pas les entrées et crée un fichier .csv ou une table de géodatabase en sortie.
Cet outil prend en charge la sélection et l’ensemble de définition.
Le paramètre Date d’effet permet de définir la vue temporelle du réseau. Seuls les itinéraires actifs à la date spécifiée permettent de calculer la sortie.
Pour les produits de données de longueur et de nombre d’entités, vous pouvez spécifier plusieurs valeurs de paramètre Date d’effet. Si plusieurs dates d’effet sont spécifiées, l’écart ou le changement de longueur ou de nombre d’entités entre chaque paire de dates d’effet est calculé.
Si vous créez un produit de données de longueur, tenez compte des points suivants :
- Utilisez un modèle de données LRS qui spécifie les champs de récapitulation et de longueur. Vous pouvez utiliser un modèle de référencement linéaire pour les pipelines ou les routes et autoroutes.
- Les champs de récapitulation et de longueur doivent figurer dans la même géodatabase que la couche de réseau LRS.
- La conversion des unités est prise en charge lors de la conversion de l’unité de mesure du réseau en une autre unité.
- Les paramètres Entités de limite et Champ de récapitulation sont valides à la condition qu’aucun champ de récapitulation ne soit indiqué dans le fichier .json.
- La sortie sera créée en se basant sur l’intersection des entités sélectionnées à partir du réseau LRS, des couches de résumé et des couches de longueur.
Si vous créez un produit de données de journal d’itinéraire, tenez compte des points suivants :
- Utilisez un modèle de données LRS qui spécifie les champs de journal, d’emplacement et de référence. Vous pouvez utiliser un modèle de référencement linéaire pour les pipelines ou les routes et autoroutes.
- Les champs et la couche de journal doivent figurer dans la même géodatabase que la couche de réseau LRS.
- Les champs et la couche d’emplacement doivent correspondre à une couche surfacique et figurer dans la même géodatabase que la couche de réseau LRS.
- Les champs et la couche de référence doivent correspondre à une classe d’entités d’événement ponctuel LRS et figurer dans la même géodatabase que la couche de réseau LRS.
- La sortie sera créée en se basant sur l’intersection des entités sélectionnées à partir du réseau LRS, des couches de journal, des couches de localisation et de la couche de référence.
Si vous créez un produit de données de nombre d’entités, tenez compte des points suivants :
- Utilisez un modèle de données LRS qui spécifie les champs de nombre, de récapitulation et d’identifiant d’itinéraire. Vous pouvez utiliser un modèle de référencement linéaire pour les pipelines ou les routes et autoroutes.
- Les champs de nombre, de récapitulation et d’identifiant d’itinéraire doivent figurer dans la même géodatabase que la couche de réseau LRS.
- Les paramètres Entités de limite et Champ de récapitulation sont valides à la condition qu’aucun champ de récapitulation ne soit indiqué dans le fichier .json.
- La sortie sera créée en se basant sur l’intersection des entités sélectionnées à partir du réseau LRS, des couches de résumé et des couches de nombre d’entités.

Paramètres

Étiquette	Explication	Type de données
Modèle	Modèle de données LRS en entrée qui spécifie les champs de récapitulation et de longueur (produit de données de longueur), les champs d’identifiant d’itinéraire, de journal, d’emplacement et de référence (produit de données de journal d’itinéraire) ou les champs de nombre, de récapitulation et d’identifiant d’itinéraire (produit de données de nombre d’entités).	File
Entités itinéraires en entrée	Réseau LRS à utiliser pour calculer la longueur, le journal d’itinéraire ou le nombre d’entités.	Feature Layer
Date d’effet	Date(s) d’effet à utiliser pour définir la vue temporelle du réseau.	Date
Unités de longueur (Facultatif)	Spécifie les unités de mesure à utiliser pour le champ de longueur dans la sortie. Ce paramètre n’est disponible que si vous créez un produit de données de longueur. 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. Milles terrestres—L’unité est le mille terrestre. Pieds internationaux—L’unité est le pied international. 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
Entités de limite (Facultatif)	Couche de limites à utiliser pour récapituler les données. Ce paramètre n’est disponible que si vous créez un produit de données de longueur ou de nombre d’entités.	Feature Layer
Champ de récapitulation (Facultatif)	Champ de la couche de limites qui fournit les noms des lignes de résumé. Ce paramètre n’est disponible que si vous créez un produit de données de longueur ou de nombre d’entités.	Field
Exclure les lignes de résumé nulles (Facultatif)	Indique si les lignes de résumé nulles sont exclues de la sortie. Coché : les lignes de longueur nulle ou avec un nombre d’entités sont exclues de la sortie. Il s’agit de l’option par défaut. Non coché : les lignes de longueur nulle ou avec un nombre d’entités ne sont pas exclues de la sortie. Ce paramètre n’est disponible que si vous créez un produit de données de longueur ou de nombre d’entités.	Boolean
Format en sortie (Facultatif)	Indique le format du fichier en sortie. CSV—Le fichier en sortie est un fichier .csv. Il s’agit de l’option par défaut. Table—Le fichier en sortie est une table de géodatabase.	String
Fichier en sortie (Facultatif)	Fichier .csv en sortie dans lequel la longueur calculée, le journal d’itinéraire ou le nombre d’entités est enregistré.	File
Table en sortie (Facultatif)	Table de géodatabase créée avec la longueur calculée, le journal d’itinéraire ou le nombre d’entités.	Table

arcpy.locref.GenerateLrsDataProduct(in_template, in_route_features, effective_date, {units}, {boundary_features}, {summary_field}, {exclude_null_summary_rows}, {output_format}, {out_file}, {out_table})

Nom	Explication	Type de données
in_template	Modèle de données LRS en entrée qui spécifie les champs de récapitulation et de longueur (produit de données de longueur), les champs d’identifiant d’itinéraire, de journal, d’emplacement et de référence (produit de données de journal d’itinéraire) ou les champs de nombre, de récapitulation et d’identifiant d’itinéraire (produit de données de nombre d’entités).	File
in_route_features	Réseau LRS à utiliser pour calculer la longueur, le journal d’itinéraire ou le nombre d’entités.	Feature Layer
effective_date [effective_date,...]	Date(s) d’effet à utiliser pour définir la vue temporelle du réseau.	Date
units (Facultatif)	Spécifie les unités de mesure à utiliser pour le champ de longueur dans la sortie. Ce paramètre n’est disponible que si vous créez un produit de données de longueur. 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. INTMILES—L’unité est le mille terrestre. INTFEET—L’unité est le pied international. 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
boundary_features (Facultatif)	Couche de limites à utiliser pour récapituler les données. Ce paramètre n’est disponible que si vous créez un produit de données de longueur ou de nombre d’entités.	Feature Layer
summary_field (Facultatif)	Champ de la couche de limites qui fournit les noms des lignes de résumé. Ce paramètre n’est disponible que si vous créez un produit de données de longueur ou de nombre d’entités.	Field
exclude_null_summary_rows (Facultatif)	Indique si les lignes de résumé nulles sont exclues de la sortie. EXCLUDE—Les lignes de longueur nulle ou avec un nombre d’entités sont exclues de la sortie. Il s’agit de l’option par défaut. DO_NOT_EXCLUDE—Les lignes de longueur nulle ou avec un nombre d’entités ne sont pas exclues de la sortie. Ce paramètre n’est disponible que si vous créez un produit de données de longueur ou de nombre d’entités.	Boolean
output_format (Facultatif)	Indique le format du fichier en sortie. CSV—Le fichier en sortie est un fichier .csv. Il s’agit de l’option par défaut. TABLE—Le fichier en sortie est une table de géodatabase.	String
out_file (Facultatif)	Fichier .csv en sortie dans lequel la longueur calculée, le journal d’itinéraire ou le nombre d’entités est enregistré.	File
out_table (Facultatif)	Table de géodatabase créée avec la longueur calculée, le journal d’itinéraire ou le nombre d’entités.	Table

Exemple de code

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

Le script autonome ci-dessous illustre l’utilisation de la fonction GenerateLrsDataProduct.

# Name: GenerateLrsDataProduct_ex1.py
# Description: Transforms LRS data to create a data product for the selected routes in an LRS Network in a stand-alone script.
# Requirements: ArcGIS Location Referencing

# Import arcpy module
import arcpy

# Check out any necessary licenses
arcpy.CheckOutExtension("LocationReferencing")

# Local tool variables
in_template = r"C:\Data\Template.json"
in_route_features = r"C:\Data\SampleData.gdb\LRS\Network"
effective_date = "12/31/2024"
units = "METERS"
boundary_features = None
summary_field = None
exclude_null_summary_rows = "EXCLUDE"
output_format = "CSV"
out_file = r"C:\Data\LP1.csv"
out_table = None

# Run the tool
arcpy.locref.GenerateLrsDataProduct(in_template, in_route_features, effective_date, units, boundary_features, summary_field, exclude_null_summary_rows, output_format, out_file, out_table)

# Check in licenses
arcpy.CheckInExtension("LocationReferencing")

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

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

# Name: GenerateLrsDataProduct_ex2.py
# Description: Transforms LRS data to create a data product for the selected routes in an LRS Network in the inline Python window in ArcGIS Pro.
# Requirements: ArcGIS Location Referencing

# Local tool variables
in_template = r"C:\Data\Template.json"
in_route_features = r"C:\Data\SampleData.gdb\LRS\Network"
effective_date = "12/31/2024"
units = "METERS"
boundary_features = None
summary_field = None
exclude_null_summary_rows = "DO_NOT_EXCLUDE"
output_format = "CSV"
out_file = r"C:\Data\LP2.csv"
out_table = None

# Run the tool
arcpy.locref.GenerateLrsDataProduct(in_template, in_route_features, effective_date, units, boundary_features, summary_field, exclude_null_summary_rows, output_format, out_file, out_table)

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

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

# Name: GenerateLrsDataProduct_ex3.py
# Description: Transforms LRS data to create a data product for the selected routes using a feature service.
# Requires: ArcGIS Location Referencing

# Import arcpy module.
import arcpy

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

# Input event and target LRS network are in feature service.  Signing in 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 target LRS Network's layer ID.
in_route_features = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/1"

# Set tool variables
in_template = r"C:\Data\Template.json"
effective_date = "12/31/2024"
units = "FEET"
boundary_features = None
summary_field = None
exclude_null_summary_rows = "EXCLUDE"
output_format = "CSV"
out_file = r"C:\Data\LP3.csv"
out_table = None

# Run the tool
arcpy.locref.GenerateLrsDataProduct(in_template, in_route_features, effective_date, units, boundary_features, summary_field, exclude_null_summary_rows, output_format, out_file, out_table)

# Check in license
arcpy.CheckInExtension("LocationReferencing")

Exemple 4 d’utilisation de la fonction GenerateLrsDataProduct (script autonome)

Le script autonome ci-dessous illustre l’utilisation de la fonction GenerateLrsDataProduct avec plusieurs dates d’effet.

# Name: GenerateLrsDataProduct_ex4.py
# Description: Transforms LRS data to create a data product for the selected routes in an LRS Network in a stand-alone script.
# Requirements: ArcGIS Location Referencing

# Import arcpy module
import arcpy

# Check out any necessary licenses
arcpy.CheckOutExtension("LocationReferencing")

# Local tool variables
in_template = r"C:\Data\Template.json"
in_route_features = r"C:\Data\SampleData.gdb\LRS\Network"
effective_date = "12/31/2000; 12/31/2010; 12/31/2020"
units = "METERS"
boundary_features = None
summary_field = None
exclude_null_summary_rows = "EXCLUDE"
output_format = "TABLE"
out_file = None
out_table = r"C:\Data\SampleData.gdb\LP4"

# Run the tool
arcpy.locref.GenerateLrsDataProduct(in_template, in_route_features, effective_date, units, boundary_features, summary_field, exclude_null_summary_rows, output_format, out_file, out_table)

# Check in licenses
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 ?