Créer des itinéraires (Référencement linéaire)

Synthèse

Crée des itinéraires à partir de lignes existantes. 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 Route Identifier Field (Champ d'identifiant d'itinéraire) sont écrites dans Output Route Feature Class (Classe d'entités itinéraire 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 définir un environnement Tolérance M, Résolution M et Domaine M approprié.

  • Utilisez un Measure Factor (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 Measure Offset (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 Ignore spatial gaps (Ignorer les interruptions spatiales) n’est pas utilisé lorsque l’option Values from two fields (Valeurs de deux champs) de l’option Measure Source (Source des mesures) a été spécifiée. La raison en est que les valeurs de mesure sont dictées par les valeurs du From-Measure Field (Champ Mesure de départ) et du To-Measure Field (Champ Mesure d'arrivée).

  • Lorsque l'option Length of features (Longueur des entités) ou l’option Values from a single field (Valeurs d'un seul champ) de Measure Source (Source des mesures) est utilisée, la Coordinate Priority (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 Values from two fields (Valeurs de deux champs) de Measure Source (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 From-Measure Field (Champ Mesure de départ) et To-Measure Field (Champ 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:\Users\patrickb\AppData\Local\Temp\Create_Output0.txt (où Create_Output est le nom de la classe d’entités itinéraire en sortie).

  • Le paramètre d'environnement Valeurs M en sortie sera ignoré. La classe d'entités itinéraires en sortie comporte des valeurs M (mesure).

Paramètres

ÉtiquetteExplicationType de données
Entités linéaires en entrée

Entités à partir desquelles les itinéraires sont créés.

Feature Layer
Champ d'identifiant d'itinéraire

Champ contenant des valeurs identifiant de manière unique chaque itinéraire.

Field
Classe d'entités itinéraires en sortie

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
Source des mesures

Spécifie le mode d'obtention des mesures d'itinéraire.

  • Longueur des entitésLa longueur géométrique des entités en entrée sert à cumuler les mesures. Il s’agit de l’option par défaut.
  • Valeurs d'un seul champLa valeur stockée dans un champ unique sert à cumuler les mesures.
  • Valeurs de deux champsLes valeurs stockées dans les champs Mesure de départ et Mesure d'arrivée servent à définir les mesures.
String
Champ Mesure de départ
(Facultatif)

Champ contenant des valeurs de mesure. Ce champ, qui doit être numérique, est nécessaire lorsque la source des mesures est Values from a single field (Valeurs d’un seul champ) ou Values from two fields (Valeurs de deux champs).

Field
Champ Mesure d'arrivée
(Facultatif)

Champ contenant des valeurs de mesure. Ce champ, qui doit être numérique, est nécessaire lorsque la source des mesures est Values from two fields (Valeurs de deux champs).

Field
Priorité de coordonnées
(Facultatif)

Position à partir de laquelle des mesures sont cumulées pour chaque itinéraire en sortie. Ce paramètre est ignoré lorsque la source des mesures est Values from two fields (Valeurs de deux champs).

  • Angle supérieur gaucheLes mesures sont cumulées à partir du point le plus proche de l'angle supérieur gauche du rectangle d'emprise minimale. Il s’agit de l’option par défaut.
  • Angle inférieur gaucheLes mesures sont cumulées à partir du point le plus proche de l'angle inférieur gauche du rectangle d'emprise minimale.
  • Angle supérieur droitLes mesures sont cumulées à partir du point le plus proche de l'angle supérieur droit du rectangle d'emprise minimale.
  • Angle inférieur droitLes mesures sont cumulées à partir du point le plus proche de l'angle inférieur droit du rectangle d'emprise minimale.
String
Facteur de mesure
(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
Décalage de mesure
(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
Ignorer les interruptions
(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 lorsque la source de mesure est Length of features (Longueur des entités) ou Values from a single field (Valeurs d'un seul champ).

  • 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ésactivé : 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
Créer un 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 itinéraires en sortie.

  • Activée : créer un index attributaire. Il s’agit de l’option par défaut.
  • Non activée – Ne crée pas d'index attributaire.
Boolean

arcpy.lr.CreateRoutes(in_line_features, route_id_field, out_feature_class, measure_source, {from_measure_field}, {to_measure_field}, {coordinate_priority}, {measure_factor}, {measure_offset}, {ignore_gaps}, {build_index})
NomExplicationType 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.

  • LENGTHLa longueur géométrique des entités en entrée sert à cumuler les mesures. Il s’agit de l’option par défaut.
  • ONE_FIELDLa valeur stockée dans un champ unique sert à cumuler les mesures.
  • TWO_FIELDSLes valeurs stockées dans les champs Mesure de départ et Mesure d'arrivée servent à définir les mesures.
String
from_measure_field
(Facultatif)

Champ contenant des valeurs de mesure. Ce champ, qui doit être numérique, est nécessaire lorsque la source des mesures 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 des mesures 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 des mesures est TWO_FIELDS.

  • UPPER_LEFTLes mesures sont cumulées à partir du point le plus proche de l'angle supérieur gauche du rectangle d'emprise minimale. Il s’agit de l’option par défaut.
  • LOWER_LEFTLes mesures sont cumulées à partir du point le plus proche de l'angle inférieur gauche du rectangle d'emprise minimale.
  • UPPER_RIGHTLes mesures sont cumulées à partir du point le plus proche de l'angle supérieur droit du rectangle d'emprise minimale.
  • LOWER_RIGHTLes mesures sont cumulées à partir du point le plus proche de l'angle inférieur droit du rectangle d'emprise minimale.
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 lorsque la source de mesure est LENGTH ou ONE_FIELD.

  • IGNORELes 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_IGNORELes 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
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 itinéraires en sortie.

  • INDEXCréez un index attributaire. Il s’agit de l’option par défaut.
  • NO_INDEXNe crée pas d'index attributaire.
Boolean

Exemple de code

Exemple 1 d'utilisation de la fonction CreateRoutes (fenêtre Python)

Le script de fenêtre Python ci-dessous illustre l’utilisation de la fonction CreateRoutes dans la fenêtre Python.

import arcpy
arcpy.env.workspace = "C:/Data"
arcpy.CreateRoutes_lr(base_roads.shp, "route1", "newRoutes", "LENGTH", "#", "#", 
                      "LOWER_LEFT", 0.00018939394)
Exemple 2 d'utilisation de la fonction CreateRoutes (script autonome)

Le script Python suivant illustre l'utilisation de la fonction CreateRoutes à 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.
# Import system modules
import arcpy
# Set workspace
arcpy.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)
Exemple 3 d’utilisation de la fonction CreateRoutes (script autonome)

Le script Python suivant illustre l'utilisation de la fonction CreateRoutes à 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
# Set workspace
arcpy.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 result to the roads feature dataset
# Execute CreateRoutes
arcpy.CreateRoutes_lr(in_lines, rid, out_routes, "ONE_FIELD", m_fld, "#", 
                      "LOWER_LEFT")
Exemple 4 d'utilisation de la fonction CreateRoutes (script autonome)

Le script Python suivant illustre l’utilisation de la fonction CreateRoutes dans un script Python autonome à l’aide de données de géodatabase d’entreprise.

# Name CreateRoutes_Example4.py
# Description:  Create routes from lines. The lines are in an enterprise 
# geodatabase. The TWO_FIELD option will be used to set the measures.
# Import system modules
import arcpy
# Set workspace
arcpy.env.workspace = "C:/MyProject/myConn.sde"
# Set local variables
# base_roads is a standalone feature class
in_lines = arcpy.ValidateTableName("base_roads", wkspc)
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)

Informations de licence

  • Basic: Oui
  • Standard: Oui
  • Advanced: Oui

Rubriques connexes