Calibrer des itinéraires (Outils de référencement linéaire)

Résumé

Recalcule les mesures d’itinéraires à l’aide de points.

Utilisation

Il est possible de calibrer des itinéraires complets ou partiels. Vous pouvez effectuer une interpolation entre les points en entrée, une extrapolation avant les points en entrée, une extrapolation après les points en entrée ou utiliser toute combinaison de ces méthodes.
L’outil Make Feature Layer (Créer une couche d’entités) ou Make Query Table (Générer une table de requête) permet de réduire efficacement le nombre d’itinéraires à calibrer.
Si la valeur du paramètre Output Route Feature Class (Classe d’entités itinéraires en sortie) est écrite dans une géodatabase, définissez les environnements M Tolerance (Tolérance M), M Resolution (Résolution M) et M Domain (Domaine M) appropriés.
La valeur du paramètre Output Route Feature Class (Classe d’entités itinéraires en sortie) inclut tous les champs de la valeur du paramètre Input Route Features (Entités itinéraires en entrée).
Le paramètre d’environnement Output has M Values (Valeurs M en sortie) est ignoré. La valeur du paramètre Output Route Feature Class (Classe d’entités itinéraires en sortie) contient des valeurs m (valeurs de mesure).
Il n'est pas possible de spécifier un rayon de recherche infini.
Un index attributaire sur le champ d’identifiant de l’itinéraire accélère la segmentation dynamique. Si vous comptez utiliser la valeur du paramètre Output Route Feature Class (Classe d’entités itinéraires en sortie) pour la segmentation dynamique, il est recommandé de créer un index attributaire.
Si des entités sont rejetées par cet outil, un fichier texte est créé dans le chemin d’accès temporaire pour stocker les informations sur ces entités. Par exemple, C:\Users\patrickb\AppData\Local\Temp\Calibrate_Output0.txt (où Calibrer_Sortie représente le nom de la valeur du paramètre Output Route Feature Class [Classe d’entités itinéraires en sortie]).

Etiqueter	Explication	Type de données
Entités itinéraires en entrée	Entités itinéraires à calibrer.	Feature Layer
Champ d’identifiant d’itinéraire	Champ contenant des valeurs identifiant de manière unique chaque itinéraire. Le champ peut être de type numérique, texte ou GUID.	Field
Entités points en entrée	Entités ponctuelles permettant de calibrer des itinéraires.	Feature Layer
Champ d’identifiant de point	Ce champ identifie l'itinéraire sur lequel se trouve chaque point de calibrage. Les valeurs de ce champ correspondent à celles du champ d'identifiant d'itinéraire. Ce champ peut être de type numérique, texte ou GUID.	Field
Champ de mesure	Champ contenant la valeur de mesure de chaque point de calibrage. Ce champ doit être numérique.	Field
Classe d’entités itinéraire en sortie	Classe d’entités allant être créée. Il peut s'agir d'un fichier de formes ou d'une classe d'entités de géodatabase.	Feature Class
Méthode de calcul des mesures (Facultatif)	Indique la manière dont sont recalculées les mesures d'itinéraire. Distance—Les mesures sont recalculées en utilisant la distance du plus court chemin entre les points de calibrage. Il s’agit de l’option par défaut. Mesures—Les mesures sont recalculées avec la distance de mesure préexistante entre les points de calibrage.	String
Rayon de recherche (Facultatif)	Limite l'éloignement du point de calibrage par rapport à un itinéraire en indiquant la distance et les unités de mesure avec lesquelles elle est exprimée. Si l’unité de mesures est inconnue, les unités du système de coordonnées de la classe d’entités itinéraires sont utilisées.	Linear Unit
Interpoler entre les points de calibrage (Facultatif)	Indique si les valeurs de mesure doivent être interpolées entre les points de calibrage. Activé—Les valeurs de mesure sont interpolées entre les points de calibrage. Il s’agit de l’option par défaut. Décoché—Les valeurs de mesure ne sont pas interpolées entre les points de calibrage.	Boolean
Extrapoler avant les points de calibrage (Facultatif)	Indique si les valeurs de mesure doivent être interpolées avant les points de calibrage. Activé—Les valeurs de mesure sont extrapolées avant les points de calibrage. Il s’agit de l’option par défaut. Décoché—Les valeurs de mesure ne sont pas extrapolées avant les points de calibrage.	Boolean
Extrapoler après les points de calibrage (Facultatif)	Indique si les valeurs de mesure doivent être interpolées après les points de calibrage. Activé—Les valeurs de mesure sont extrapolées après les points de calibrage. Il s’agit de l’option par défaut. Décoché—Les valeurs de mesure ne sont pas extrapolées après les points de calibrage.	Boolean
Ignorer les interruptions (Facultatif)	Indique si les interruptions spatiales sont ignorées lors du nouveau calcul des mesures sur les itinéraires discontinus. Activé—Les interruptions spatiales sont ignorées. Les valeurs de mesure sont continues pour les itinéraires discontinus. Il s’agit de l’option par défaut. Décoché—Les interruptions spatiales ne sont pas ignorées. Les valeurs de mesure sur les itinéraires discontinus comportent des interruptions. La distance d'interruption est calculée en utilisant la distance en ligne droite qui sépare les extrémités des parties discontinues.	Boolean
Inclure toutes les entités dans la classe d’entités en sortie. (Facultatif)	Indique si les entités itinéraires dépourvues de points de calibrage sont incluses dans la classe d’entités en sortie. Activé—Toutes les entités itinéraires sont incluses dans la classe d’entités en sortie. Il s’agit de l’option par défaut. Décoché—Toutes les entités itinéraires ne sont pas nécessairement incluses dans la classe d’entités en sortie. Les entités dépourvues de points de calibrage sont exclues.	Boolean
Créer un index (Facultatif)	Indique si un index attributaire est créé pour le champ d’identifiant d’itinéraire écrit dans la valeur du paramètre Output Route Feature Class (Classe d’entités itinéraires en sortie). Activé—Un index attributaire est créé. Il s’agit de l’option par défaut. Décoché—Aucun index attributaire n’est créé.	Boolean

arcpy.lr.CalibrateRoutes(in_route_features, route_id_field, in_point_features, point_id_field, measure_field, out_feature_class, {calibrate_method}, {search_radius}, {interpolate_between}, {extrapolate_before}, {extrapolate_after}, {ignore_gaps}, {keep_all_routes}, {build_index})

Nom	Explication	Type de données
in_route_features	Entités itinéraires à calibrer.	Feature Layer
route_id_field	Champ contenant des valeurs identifiant de manière unique chaque itinéraire. Le champ peut être de type numérique, texte ou GUID.	Field
in_point_features	Entités ponctuelles permettant de calibrer des itinéraires.	Feature Layer
point_id_field	Ce champ identifie l'itinéraire sur lequel se trouve chaque point de calibrage. Les valeurs de ce champ correspondent à celles du champ d'identifiant d'itinéraire. Ce champ peut être de type numérique, texte ou GUID.	Field
measure_field	Champ contenant la valeur de mesure de chaque point de calibrage. Ce champ doit être numérique.	Field
out_feature_class	Classe d’entités allant être créée. Il peut s'agir d'un fichier de formes ou d'une classe d'entités de géodatabase.	Feature Class
calibrate_method (Facultatif)	Indique la manière dont sont recalculées les mesures d'itinéraire. `DISTANCE`—Les mesures sont recalculées en utilisant la distance du plus court chemin entre les points de calibrage. Il s’agit de l’option par défaut. `MEASURES`—Les mesures sont recalculées avec la distance de mesure préexistante entre les points de calibrage.	String
search_radius (Facultatif)	Limite l'éloignement du point de calibrage par rapport à un itinéraire en indiquant la distance et les unités de mesure avec lesquelles elle est exprimée. Si l’unité de mesures est inconnue, les unités du système de coordonnées de la classe d’entités itinéraires sont utilisées.	Linear Unit
interpolate_between (Facultatif)	Indique si les valeurs de mesure doivent être interpolées entre les points de calibrage. `BETWEEN`—Les valeurs de mesure sont interpolées entre les points de calibrage. Il s’agit de l’option par défaut. `NO_BETWEEN`—Les valeurs de mesure ne sont pas interpolées entre les points de calibrage.	Boolean
extrapolate_before (Facultatif)	Indique si les valeurs de mesure doivent être interpolées avant les points de calibrage. `BEFORE`—Les valeurs de mesure sont extrapolées avant les points de calibrage. Il s’agit de l’option par défaut. `NO_BEFORE`—Les valeurs de mesure ne sont pas extrapolées avant les points de calibrage.	Boolean
extrapolate_after (Facultatif)	Indique si les valeurs de mesure doivent être interpolées après les points de calibrage. `AFTER`—Les valeurs de mesure sont extrapolées après les points de calibrage. Il s’agit de l’option par défaut. `NO_AFTER`—Les valeurs de mesure ne sont pas extrapolées après les points de calibrage.	Boolean
ignore_gaps (Facultatif)	Indique si les interruptions spatiales sont ignorées lors du nouveau calcul des mesures sur les itinéraires discontinus. `IGNORE`—Les interruptions spatiales sont ignorées. Les valeurs de mesure sont continues pour les itinéraires discontinus. Il s’agit de l’option par défaut. `NO_IGNORE`—Les interruptions spatiales ne sont pas ignorées. Les valeurs de mesure sur les itinéraires discontinus comportent des interruptions. La distance d'interruption est calculée en utilisant la distance en ligne droite qui sépare les extrémités des parties discontinues.	Boolean
keep_all_routes (Facultatif)	Indique si les entités itinéraires dépourvues de points de calibrage sont incluses dans la classe d’entités en sortie. `KEEP`—Toutes les entités itinéraires sont incluses dans la classe d’entités en sortie. Il s’agit de l’option par défaut. `NO_KEEP`—Toutes les entités itinéraires ne sont pas nécessairement incluses dans la classe d’entités en sortie. Les entités dépourvues de points de calibrage sont exclues.	Boolean
build_index (Facultatif)	Indique si un index attributaire est créé pour le champ d’identifiant d’itinéraire écrit dans la valeur du paramètre `out_feature_class`. `INDEX`—Un index attributaire est créé. Il s’agit de l’option par défaut. `NO_INDEX`—Aucun index attributaire n’est créé.	Boolean

Exemple de code

Exemple 1 d’utilisation de la fonction CalibrateRoutes (fenêtre Python)

Le script de fenêtre Python ci-après illustre l’utilisation de la fonction CalibrateRoutes en mode immédiat.

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.lr.CalibrateRoutes("hwy.shp", "RID", "cal_pts.shp", "RID", "MEASURE",
                         "C:/output/hwy_new.shp","DISTANCE", "5.0 feet",
                         "BETWEEN", "BEFORE", "AFTER", "#", "NO_KEEP")

Exemple 2 d’utilisation de la fonction CalibrateRoutes (script autonome)

Le script Python ci-après illustre l’utilisation de la fonction CalibrateRoutes à l’aide de données de géodatabase fichier dans un script Python autonome.

# Name CalibrateRoutes_Example2.py
# Description: Calibrate personal geodatabase routes with file geodatabase
# points.

# Import system modules
import arcpy

# Set workspace
arcpy.env.workspace = "C:/Data/Pitt.gdb"

# Set local variables
rts = "roads/hwy"  # hwy is in the roads feature dataset
rid = "ROUTE1"
pts = "roads/cal_pts"  # cal_pts is in the roads feature dataset
mfield = "MEASURE"
radius = "2.5 Meters"
out_fc = "roads/hwy_new"  # new feature class in the roads feature dataset

# Run CalibrateRoutes
arcpy.lr.CalibrateRoutes(rts, rid, pts, rid, mfield, out_fc, "DISTANCE", radius,
                         "BETWEEN", "NO_BEFORE", "NO_AFTER")

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

Le script Python ci-après illustre l’utilisation de la fonction CalibrateRoutes à l’aide de données de géodatabase d’entreprise dans un script Python autonome.

# Name CalibrateRoutes_Example3.py
# Description: Calibrate enterprise geodatabase routes using enterprise
# geodatabase points.

# Import system modules
import arcpy

# Set workspace
wkspc = "C:/MyProject/myConn.sde"
arcpy.env.workspace = wkspc

# Set local variables
rts = arcpy.ValidateTableName("hwy", wkspc)  # standalone feature class
rid = "ROUTE1"
pts = arcpy.ValidateTableName("cal_pts", wkspc)  # standalone feature class
mfield = "MEASURE"
radius = "5.0 Feet"
out_fc = "hwy_new" # new standalone feature class

# Run CalibrateRoutes
arcpy.lr.CalibrateRoutes(rts, rid, pts, rid, mfield, out_fc, "DISTANCE", radius,
                         "#", "#", "#", "#", "NO_KEEP")

Environnements

Espace de travail courant, Résolution M, Tolérance M, Mot-clé CONFIG en sortie, Domaine M en sortie, Domaine XY en sortie, Domaine Z en sortie, Système de coordonnées en sortie, Etendue, Valeurs Z en sortie, Espace de travail temporaire

Informations de licence