Générer une couche d'événements d'itinéraires (Référencement linéaire)
Summary
Crée une couche d'entités temporaire à l'aide d'itinéraires et d'événements d'itinéraires.
Lorsque vous utilisez cette couche temporaire (affichage sur une carte ou utilisation par un autre outil de géotraitement), une segmentation dynamique est effectuée.
Usage
-
La table d'événements en entrée peut être tout type de table pris en charge par ArcGIS.
-
Utilisez Générer une couche sur les itinéraires et/ou Générer une vue tabulaire sur les événements avant cet outil pour réduire le nombre d'itinéraires et d'événements qui seront traités.
-
Les types de tables n'ont pas tous un ObjectID champ. Lorsque ces tables sont utilisées par cet outil, la couche résultante ne peut pas être sélectionnée ni utilisée efficacement par certaines opérations de géotraitement. Envisagez d'utiliser l'outil Générer une table de requête avant cet outil pour ajouter un champ ObjectID virtuel.
-
Les couches temporaires sont stockées en mémoire et peuvent être utilisées comme données en entrée pour d'autres fonctions de géotraitement dans votre session ArcCatalog ou ArcMap en cours.
-
Dans ArcMap, les couches d'entités temporaires peuvent être affichées si vous avez indiqué que vous voulez ajouter des résultats d'opérations de géotraitement à l'affichage sous Géotraitement > Options de géotraitement... > Ajouter les résultats du géotraitement à l'affichage.
-
Une fois que vous quittez ArcCatalog ou ArcMap, les couches d'entités temporaires sont supprimées de la mémoire. Pour rendre une couche temporaire persistante sur le disque, utilisez les outils Enregistrer dans un fichier de couches (Gestion) ou Copier des entités (Gestion).
Syntax
Parameter | Explanation | Data Type |
in_routes |
Entités itinéraires sur lesquels les événements sont localisés. | Feature Layer |
route_id_field |
Champ contenant des valeurs identifiant de manière unique chaque itinéraire. | Field |
in_table |
Table dont les lignes sont localisées le long d'itinéraires. | Table View |
in_event_properties |
Paramètre composé des champs de localisation d'itinéraire et du type d'événements dans la table d'événements en entrée.
| Route Measure Event Properties |
out_layer |
Couche à créer. Cette couche étant stockée en mémoire, aucun chemin n'est requis. | Feature Layer |
offset_field (Optional) |
Champ contenant les valeurs utilisées pour décaler les événements par rapport à leur itinéraire sous-jacent. Ce champ doit être numérique. | Field |
add_error_field (Optional) |
Spécifie si un champ nommé LOC_ERROR doit être ajouté à la couche temporaire créée.
| Boolean |
add_angle_field (Optional) |
Spécifie si un champ nommé LOC_ANGLE doit être ajouté à la couche temporaire créée. Ce paramètre est valide uniquement si le type d'événements est POINT.
| Boolean |
angle_type (Optional) |
Spécifie le type d'angle de localisation qui doit être calculé. Ce paramètre est valide seulement si le paramètre ANGLE_FIELD a été spécifié.
| String |
complement_angle (Optional) |
Spécifie si le complémentaire de l'angle de localisation doit être calculé. Ce paramètre est valide seulement si le paramètre ANGLE_FIELD a été spécifié.
| Boolean |
offset_direction (Optional) |
Spécifie de quel côté les événements d'itinéraire avec un décalage positif sont affichés. Ce paramètre est valide seulement si un champ de décalage a été spécifié.
| Boolean |
point_event_type (Optional) |
Spécifie si les événements ponctuels doivent être traités comme des entités ponctuelles ou des entités multi-ponctuelles.
| Boolean |
Code Sample
import arcpy
from arcpy import env
env.workspace = "C:/Data"
arcpy.MakeRouteEventLayer_lr ("route_hwy.shp", "rkey" , "accident.dbf", "rkey POINT mile", "accident_events", "#", "ERROR_FIELD", "ANGLE_FIELD")
Le script Python ci-dessous illustre l'utilisation de la fonction Générer une couche d'événements d'itinéraires dans un script Python autonome.
# Name: MakeRouteEventLayer_Example.py
# Description: Make a POINT event layer. Routes and events are in a shapefile workspace.
# An error field and an angle field are added to the new layer. The new layer can be used
# by other geoprocessing functions.
# Author: ESRI
# Import system modules
import arcpy
from arcpy import env
# Set workspace
env.workspace = "C:/Data"
# Set local variables
rt = "route_hwy.shp"
rid = "rkey"
tbl = "accident.dbf"
props = "rkey POINT mile"
lyr = "accident_events"
# Execute MakeRouteEventLayer
arcpy.MakeRouteEventLayer_lr (rt, rid, tbl, props, lyr, "#", "ERROR_FIELD", "ANGLE_FIELD")
Le script Python ci-dessous illustre l'utilisation de la fonction Générer une couche d'événements d'itinéraires dans un script Python autonome.
# Name: MakeRouteEventLayer_Example2.py
# Description: Make a LINE event layer. Routes and events are in a file geodatabase.
# An error field is added to the new layer. The new layer can be used by other
# geoprocessing functions.
# Author: ESRI
# Import system modules
import arcpy
from arcpy import env
# Set workspace
env.workspace = "C:/Data/pitt.gdb"
# Set local variables
rt = "roads/hwy" # the 'hwy' feature class is in the 'roads' feature dataset
rid = "rkey"
tbl = "pavecond"
props = "rkey LINE fmp tmp"
lyr = "pave_events"
# Execute MakeRouteEventLayer
arcpy.MakeRouteEventLayer_lr (rt, rid, tbl, props, lyr, "#", "ERROR_FIELD")
Le script Python suivant illustre l'utilisation de la fonction Générer une couche d'événements d'itinéraires dans un script Python autonome à l'aide de données de géodatabase personnelle.
# Name: MakeRouteEventLayer_Example3.py
# Description: Make a LINE event layer. Routes and events are in a personal geodatabase.
# An error field is added to the new layer. The new layer can be used by other
# geoprocessing functions.
# Author: ESRI
# Import system modules
import arcpy
from arcpy import env
# Set workspace
env.workspace = "C:/Data/pitt.mdb"
# Set local variables
rt = "roads/hwy" # the 'hwy' feature class is in the 'roads' feature dataset
rid = "rkey"
tbl = "pavecond"
props = "rkey LINE fmp tmp"
lyr = "pave_events"
# Execute MakeRouteEventLayer
arcpy.MakeRouteEventLayer_lr (rt, rid, tbl, props, lyr, "#", "ERROR_FIELD")
Le script Python ci-dessous illustre l'utilisation de la fonction Générer une couche d'événements d'itinéraires dans un script Python autonome à l'aide de données ArcSDE.
# Name: MakeRouteEventLayer_Example4.py
# Description: Make a POINT event layer. Routes and events are in an enterprise geodatabase.
# The new layer can be used by other geoprocessing functions.
# Import system modules
import arcpy
from arcpy import env
# Set workspace
env.workspace = "Database Connections/Connection to Jerry.sde"
# Set local variables
ds = gp.QualifyTableName("roads", wkspc) # the 'roads' feature dataset
fc = gp.QualifyTableName("hwy", wkspc) # the 'hwy' feature class
rt = ds + "/" + fc #the 'hwy' feature class is in the 'roads' feature dataset
rid = "rkey"
tbl = gp.QualifyTableName("accident", wkspc)
props = "rkey POINT mile"
lyr = "accident_events2"
# Execute MakeRouteEventLayer
arcpy.MakeRouteEventLayer_lr (rt, rid, tbl, props, lyr)