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 longueur pour les itinéraires sélectionnés dans un réseau LRS. Vous pouvez, par exemple, utiliser cet outil pour totaliser le kilométrage d’un ensemble d’itinéraires ou la longueur des lignes dans les limites du comté.

Utilisation

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.
Le modèle doit être un fichier .json.
Utilisez une classe d’entités de réseau pour la valeur du paramètre Entités itinéraires en entrée.
Cet outil ne modifie pas les entrées et crée un fichier .csv 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 à cette date permettent de calculer la sortie.
Cet outil prend en charge la conversion des unités 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.
Si le réseau inclut des itinéraires comportant des problèmes de calibrage ou d’une longueur égale à zéro, cochez le paramètre Exclure les lignes de résumé nulles pour exclure ces itinéraires de la sortie. Sinon, ces itinéraires sont inclus dans la sortie avec une longueur égale à zéro.

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.	File
Entités itinéraires en entrée	Réseau LRS à utiliser pour calculer la longueur.	Feature Layer
Date d’effet	Date d’effet à utiliser pour définir la vue temporelle du réseau.	Date
Unités de longueur	Spécifie les unités de mesure à utiliser pour le champ de longueur dans la sortie. Pouces—Les unités seront les pouces. Pieds—L’unité est le pied. Yards—L’unité est le yard. Miles—L’unité est le mile. Milles nautiques—L’unité est le mille nautique. Miles internationaux—L’unité est le mile international. 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.	Feature Layer
Champ de récapitulation (Facultatif)	Champ de la couche de limites qui fournit les noms des lignes de résumé.	Field
Exclure les lignes de résumé nulles (Facultatif)	Indique si les lignes de résumé nulles sont exclues de la sortie. Activé : les itinéraires non calibrés ou dont la longueur est égale à zéro sont exclus de la sortie. Il s’agit de l’option par défaut. Désactivé : les itinéraires non calibrés ou dont la longueur est égale à zéro ne sont pas exclus de la sortie. Ils sont inclus dans la sortie avec un kilométrage de 0.	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.	String
Fichier en sortie (Facultatif)	Fichier .csv en sortie dans lequel la longueur calculée est enregistrée.	File
Table en sortie (Facultatif)	Table qui est créée avec la longueur calculée.	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.	File
in_route_features	Réseau LRS à utiliser pour calculer la longueur.	Feature Layer
effective_date	Date d’effet à utiliser pour définir la vue temporelle du réseau.	Date
units	Spécifie les unités de mesure à utiliser pour le champ 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. INTMILES—L’unité est le mile international. 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.	Feature Layer
summary_field (Facultatif)	Champ de la couche de limites qui fournit les noms des lignes de résumé.	Field
exclude_null_summary_rows (Facultatif)	Indique si les lignes de résumé nulles sont exclues de la sortie. EXCLUDE—Les itinéraires non calibrés ou dont la longueur est égale à zéro sont exclus de la sortie. Il s’agit de l’option par défaut. DO_NOT_EXCLUDE—Les itinéraires non calibrés ou dont la longueur est égale à zéro ne sont pas exclus de la sortie. Ils sont inclus dans la sortie avec un kilométrage de 0.	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.	String
out_file (Facultatif)	Fichier .csv en sortie dans lequel la longueur calculée est enregistrée.	File
out_table (Facultatif)	Table qui est créée avec la longueur calculée.	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 dans un script autonome.

# Name: GenerateLrsDataProduct_ex1.py
# Description: Transforms LRS data to create a Length 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="06/03/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 Length 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="06/03/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 ci-dessous illustre l’utilisation de la fonction GenerateLrsDataProduct dans un service d’entités.

# Name: GenerateLrsDataProduct_Ex3.py
# Description: Transforms LRS data to create a Length 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="06/03/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')

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 ?