Générer un produit de données LRS (Outils Location Referencing)

Résumé

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 Effective Date (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 pour le paramètre Effective Date (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 Location Referencing pour Pipelines ou Roads and Highways.
- Les champs de récapitulation et de longueur doivent exister dans la même géodatabase que celle du 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 Boundary Features (Entités de limite) et Summary Field (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 Location Referencing pour Pipelines ou Roads and Highways.
- Les champs et la couche de journal doivent exister dans la même géodatabase que celle du réseau LRS.
- Les champs et la couche de localisation doivent correspondre à une couche surfacique et exister dans la même géodatabase que celle du réseau LRS.
- Les champs et la couche de référence doivent correspondre à une classe de d’entités d’événement ponctuel LRS ou à une classe d’entités d’intersection LRS et exister dans la même géodatabase que celle du 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 Location Referencing pour Pipelines ou Roads and Highways.
- Les champs de nombre, de récapitulation et d’identifiant d’itinéraire doivent exister dans la même géodatabase que celle du réseau LRS.
- Les paramètres Boundary Features (Entités de limite) et Summary Field (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.

Etiqueter	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—Les unités seront les pieds. Yards d’arpentage américains—Les unités seront les yards. Miles d’arpentage américains—Les unités seront les miles. 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—Les unités seront les mètres. Kilomètres—Les unités seront les kilomètres. 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. Ce paramètre n’est disponible que si vous créez un produit de données de longueur ou de nombre d’entités. Activé—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. Décoché—Les lignes de longueur nulle ou avec un nombre d’entités ne sont pas exclues de la sortie.	Boolean
Format de 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. Tableau—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 sont consignés.	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`—Les unités seront les pieds. `YARDS`—Les unités seront les yards. `MILES`—Les unités seront les miles. `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`—Les unités seront les mètres. `KILOMETERS`—Les unités seront les kilomètres. `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. Ce paramètre n’est disponible que si vous créez un produit de données de longueur ou de nombre d’entités. `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.	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 sont consignés.	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-après 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

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

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

Le script suivant illustre l’utilisation de 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 ci-dessous 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

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

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

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

Environnements

Espace de travail courant

Informations de licence