Résumé
Nouveau calcul des mesures d'itinéraires à l'aide de points.
Utilisation
Il est possible de calibrer des itinéraires complets ou partiels. Vous pouvez choisir 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 trois méthodes.
Utilisez l'outil Générer une couche ou Générer une table de requête pour réduire efficacement le nombre d'itinéraires qui seront calibrés.
Si la Classe d'entités itinéraires en sortie doit être écrite dans une géodatabase, vous devez définir un environnement Tolérance M, Résolution M et Domaine M approprié.
La classe d'entités itinéraires en sortie inclura tous les champs des entités itinéraires en entrée.
Le paramètre d'environnement outputMFlag est ignoré. La classe d'entités itinéraires en sortie aura des valeurs M (mesure).
Il n'est pas possible de spécifier un rayon de recherche infini.
Un index attributaire sur le champ d'identifiant d'itinéraire accélère le processus de segmentation dynamique. Si vous prévoyez d'utiliser la 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 le processus Calibrer des itinéraires, un fichier texte est créé dans le chemin d'accès temporaire pour stocker les informations concernant ces entités. Par exemple, C:\Documents and Settings\patrickb\Local Settings\Temp\Calibrate_Output0.txt (où Calibrate_Output est le nom de la Classe d'entités itinéraires en sortie).
Syntaxe
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})| Paramètre | Explication | Type de données |
in_route_features | Classes d'entités itinéraires à calibrer. | Feature Layer |
route_id_field | Champ contenant des valeurs identifiant de manière unique chaque itinéraire. Il peut s'agir d'un champ numérique ou textuel. | 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. Il peut s'agir d'un champ numérique ou textuel. | 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 à créer. 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.
| 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 les unités de mesures sont inconnues, les unités utilisées sont celles du système de coordonnées de la classe d'entités itinéraires. | Linear unit |
interpolate_between (Facultatif) | Indique si les valeurs de mesure doivent être 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.
| Boolean |
extrapolate_after (Facultatif) | Indique si les valeurs de mesure doivent être interpolé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.
| Boolean |
keep_all_routes (Facultatif) | Indique si les classes d'entités itinéraires dépourvues de points de calibrage sont exclues de la classe d'entités en sortie.
| Boolean |
build_index (Facultatif) | Indique si un index attributaire est créé pour le champ Identifiant d'itinéraire qui s'inscrit dans la classe d'entités itinéraires en sortie.
| Boolean |
Exemple de code
Exemple d'utilisation de la fonction CalibrateRoutes (fenêtre Python)
Le script de fenêtre Python ci-dessous illustre l'utilisation de la fonction CalibrateRoutes en mode immédiat.
import arcpy
from arcpy import env
env.workspace = "C:/data"
arcpy.CalibrateRoutes_lr("hwy.shp", "RID", "cal_pts.shp", "RID", "MEASURE", "C:/output/hwy_new.shp","DISTANCE", \
"5.0 Feet", "BETWEEN", "BEFORE", "AFTER", "#", "NO_KEEP")
2e exemple d'utilisation de l'outil CalibrateRoutes (script Python autonome)
Le script Python suivant 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
from arcpy import env
# Set workspace
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
# Execute CalibrateRoutes
arcpy.CalibrateRoutes_lr (rts, rid, pts, rid, mfield, out_fc, "DISTANCE", radius, \
"BETWEEN", "NO_BEFORE", "NO_AFTER")
3e exemple d'utilisation de l'outil CalibrateRoutes (script Python autonome)
Le script Python suivant illustre l'utilisation de la fonction CalibrateRoutes à l'aide de données de géodatabase personnelle dans un script Python autonome.
# Name CalibrateRoutes_Example3.py
# Description: Calibrate personal geodatabase routes with personal geodatabase points.
# Import system modules
import arcpy
from arcpy import env
# Set workspace
env.workspace = "C:/Data/Pitt.mdb"
# 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 a feature dataset
# Execute CalibrateRoutes
arcpy.CalibrateRoutes_lr (rts, rid, pts, rid, mfield, out_fc, "DISTANCE", radius, \
"BETWEEN", "NO_BEFORE", "NO_AFTER")
4e exemple d'utilisation de l'outil CalibrateRoutes (script Python autonome)
Le script Python suivant illustre l'utilisation de la fonction CalibrateRoutes avec des données SDE dans un script Python autonome.
# Name Example 4:
# Description: Calibrate enterprise geodatabase routes using enterprise geodatabase points.
# Import system modules
import arcpy
from arcpy import env
# Set workspace
wkspc = "Database Connections/Connection to Jerry.sde"
env.workspace = wkspc
# Set local variables
rts = gp.QualifyTableName("hwy", wkspc) # standalone feature class
rid = "ROUTE1"
pts = gp.QualifyTableName("cal_pts", wkspc) # standalone feature class
mfield = "MEASURE"
radius = "5.0 Feet"
out_fc = "hwy_new" #new standalone feature class
# Execute CalibrateRoutes
arcpy.CalibrateRoutes_lr (rts, rid, pts, rid, mfield, out_fc, "DISTANCE", radius, \
"#", "#", "#", "#", "NO_KEEP")
Environnements
Informations de licence
- Basic: Oui
- Standard: Oui
- Advanced: Oui