Créer des itinéraires (Référencement linéaire)
Récapitulatif
Crée des entités itinéraires à l'aide de deux champs de mesure Les entités linéaires en entrée partageant un identifiant commun sont combinées pour créer un seul itinéraire.
Utilisation
-
Les valeurs uniques dans le champ Identifiant d'itinéraire sont écrites dans Classe d'entités itinéraires en sortie.
-
Faites appel aux outils Générer une couche d'entités ou Générer une table de requête pour réduire efficacement le nombre de lignes qui seront utilisées pour créer des itinéraires.
-
Si la Classe d'entités itinéraires en sortie doit être écrite dans une géodatabase, vous devez attribuer une valeur à la Tolérance M, à la Résolution M et au Domaine M.
-
Utilisez un Facteur de mesure pour effectuer la conversion entre des unités de mesure d'itinéraire. Par exemple, pour convertir des pieds en miles, utilisez un facteur 0.00018939394.
-
Utilisez un Décalage de mesure dans les applications où la mesure de départ de chaque itinéraire doit être une valeur autre que 0.
-
Le paramètre Ignorer les interruptions spatiales n'est pas utilisé lorsque l'option TWO_FIELDS Source des mesures a été spécifiée. La raison en est que les valeurs de mesure sont dictées par les valeurs du champ M de départ et du champ M d'arrivée.
-
Lorsque l'option LENGTH ou ONE_FIELD de Source des mesures est utilisée, la Priorité de coordonnées est déterminée en plaçant le rectangle d'emprise minimale autour des entités en entrée qui seront combinées pour créer un itinéraire.
-
Lorsque l'option TWO_FIELDS de Source des mesures est utilisée, il n'est pas nécessaire de spécifier une priorité de coordonnées car la direction de mesure est déduite des valeurs des champs Mesure de départ et Mesure d'arrivée.
-
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 l'outil Créer 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\Create_Output0.txt (où Create_Output est le nom de la classe d'entités itinéraires en sortie).
-
Le paramètre d'environnement outputMFlag sera ignoré. La Classe d'entités itinéraires en sortie comporte des valeurs M (mesure).
Syntaxe
| Paramètre | Explication | Type de données |
in_line_features |
Entités à partir desquelles les itinéraires sont créés. | Feature Layer |
route_id_field |
Champ contenant des valeurs identifiant de manière unique chaque itinéraire. | 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 |
measure_source |
Spécifie le mode d'obtention des mesures d'itinéraire.
| String |
from_measure_field (Facultatif) |
Champ contenant des valeurs de mesure. Ce champ, qui doit être numérique, est nécessaire lorsque la source de mesure est ONE_FIELD ou TWO_FIELDS. | Field |
to_measure_field (Facultatif) |
Champ contenant des valeurs de mesure. Ce champ, qui doit être numérique, est nécessaire lorsque la source de mesure est TWO_FIELDS. | Field |
coordinate_priority (Facultatif) |
Position à partir de laquelle des mesures sont cumulées pour chaque itinéraire en sortie. Ce paramètre est ignoré lorsque la source de mesure est TWO_FIELDS.
| String |
measure_factor (Facultatif) |
Valeur multipliée par la mesure de longueur de chaque ligne en entrée avant qu'elles ne soient combinées pour créer des mesures d'itinéraire. La valeur par défaut est 1. | Double |
measure_offset (Facultatif) |
Valeur ajoutée aux mesures d'itinéraire après que les lignes en entrée ont été combinées pour créer un itinéraire. La valeur par défaut est 0. | Double |
ignore_gaps (Facultatif) |
Spécifie si des interruptions spatiales sont ignorées lors du calcul des mesures sur des itinéraires discontinus. Ce paramètre s'applique uniquement lorsque la source de mesure est LENGTH ou ONE_FIELD.
| Boolean |
build_index (Facultatif) |
Spécifie si un index attributaire est créé pour le champ d'identifiant d'itinéraire écrit dans la classe d'entités d'itinéraires en sortie.
| Boolean |
Exemple de code
Le script de fenêtre Python ci-dessous illustre l'utilisation de la fonction Créer des itinéraires dans la fenêtre Python.
import arcpy from arcpy import env env.workspace = "C:/Data" arcpy.CreateRoutes_lr(base_roads.shp, "route1", "newRoutes", "LENGTH", "#", "#", "LOWER_LEFT", 0.00018939394)
Le script Python suivant illustre l'utilisation de la fonction Créer des itinéraires à l'aide de données de fichier de formes dans un script Python autonome.
# Name CreateRoutes_Example2.py # Description: Create routes from lines. The lines are in a shapefile workspace. # The LENGTH option will be used to set the measures, and a measure factor # will be used to convert measure units from feet to miles. # Author: ESRI # Import system modules import arcpy from arcpy import env # Set workspace env.workspace = "C:/Data" # Set local variables in_lines = "base_roads.shp" rid = "route1" out_routes = "create_output1" # Execute CreateRoutes arcpy.CreateRoutes_lr(in_lines, rid, out_routes, "LENGTH", "#", "#", "LOWER_LEFT", 0.00018939394)
Le script Python suivant illustre l'utilisation de la fonction Créer des itinéraires à l'aide de données de géodatabase fichier dans un script Python autonome.
# Name CreateRoutes_Example3.py
# Description: Create routes from lines. The lines are in a file geodatabase.
# The ONE_FIELD option will be used to set the measures.
# Import system modules
import arcpy
from arcpy import env
# Set workspace
env.workspace = "C:/Data/pitt.gdb"
# Set local variables
in_lines = "roads/base_roads" # base_roads exists in the roads feature dataset
rid = "route1"
m_fld = "len_mile"
out_routes = "roads/create_output2" # write the result to the roads feature dataset
# Execute CreateRoutes
arcpy.CreateRoutes_lr(in_lines, rid, out_routes, "ONE_FIELD", m_fld, "#", "LOWER_LEFT")
Le script Python suivant illustre l'utilisation de la fonction Créer des itinéraires dans un script Python autonome à l'aide de données de géodatabase personnelle.
# Name: CreateRoutes_Example4.py # Description: Create routes from lines. The lines are in a personal geodatabase. # The ONE_FIELD option will be used to set the measures. # Author: ESRI # Import system modules import arcpy from arcpy import env # Set workspace env.workspace = "C:/Data/pitt.mdb" # Set local variables in_lines = "roads/base_roads" # base_roads exists in the roads feature dataset rid = "route1" m_fld = "len_mile" out_routes = "roads/create_output2" # write the result to the roads feature dataset # Execute CreateRoutes arcpy.CreateRoutes_lr(in_lines, rid, out_routes, "ONE_FIELD", m_fld, "#", "LOWER_LEFT")
Le script Python suivant illustre l'utilisation de la fonction Créer des itinéraires dans un script Python autonome à l'aide de données ArcSDE.
# Name CreateRoutes_Example5.py
# Description: Create routes from lines. The lines are in an enterprise geodatabase.
# The TWO_FIELD option will be used to set the measures.
# Author: ESRI
# Import system modules
import arcpy
from arcpy import env
# Set workspace
env.workspace = "Database Connections/Connection to Jerry.sde"
# Set local variables
in_lines = gp.QualifyTableName("base_roads", wkspc) # base_roads is a standalone feature class
rid = "route1"
fr_fld = "begmp1"
to_fld = "endmp1"
out_routes = "create_output3" # write the result to a standalone feature class
# Execute CreateRoutes
arcpy.CreateRoutes_lr(in_lines, rid, out_routes, "TWO_FIELDS", fr_fld, to_fld)