Superposer des événements d'itinéraires (Référencement linéaire)

Niveau de licence :BasicStandardAdvanced

Récapitulatif

Superpose deux tables d'événements pour créer une table d'événements en sortie qui représente l'union ou l'intersection des données en entrée.

Utilisation

Syntaxe

OverlayRouteEvents_lr (in_table, in_event_properties, overlay_table, overlay_event_properties, overlay_type, out_table, out_event_properties, {zero_length_events}, {in_fields}, {build_index})
ParamètreExplicationType de données
in_table

Table d'événements en entrée.

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.

  • Champ d'identifiant d'itinéraire - Champ contenant des valeurs indiquant les itinéraires le long de chaque événement. Il peut s'agir d'un champ numérique ou textuel.
  • Type d'événement - Type des événements dans la table d'événements en entrée (POINT ou LINE).
    • POINT - Les événements ponctuels se produisent à un emplacement précis le long d'un itinéraire. Seul un champ Mesure de départ doit être spécifié.
    • LINE - Les événements linéaires décrivent une portion d'itinéraire. Les champs de mesure de départ et d'arrivée doivent être spécifiés.
  • Champ M de départ - Champ contenant des valeurs de mesure. Ce champ, qui doit être numérique, est nécessaire lorsque le type d'événement est POINT ou LINE. Lorsque le type d'événement est POINT, l'appellation de ce paramètre devient Champ de mesure.
  • Champ M d'arrivée - Champ contenant des valeurs de mesure. Ce champ, qui doit être numérique, est nécessaire lorsque le type d'événement est LINE.
Route Measure Event Properties
overlay_table

Table d'événements superposés.

Table View
overlay_event_properties

Paramètre constitué des champs de localisation d'itinéraire et du type d'événement dans la table des événements superposés.

Champ d'identifiant d'itinéraire — Champ contenant des valeurs indiquant les itinéraires le long de chaque événement. Il peut s'agir d'un champ numérique ou textuel.

Type d'événement — Le type d'événement dans la table des événements superposés (POINT ou LINE).

  • POINT — Les événements ponctuels se produisent à un emplacement précis le long d'un itinéraire. Seul un champ de mesure de départ doit être spécifié.
  • LINE — Les événements linéaires décrivent une portion d'itinéraire. Les champs de mesure de départ et d'arrivée doivent être spécifiés.

Champ M de départ — Champ contenant des valeurs de mesure. Ce champ, qui doit être numérique, est nécessaire lorsque le type d'événement est POINT ou LINE. Lorsque le type d'événement est POINT, l'appellation de ce paramètre devient "Champ de mesure".

Champ M d'arrivée — Champ contenant des valeurs de mesure. Ce champ, qui doit être numérique, est nécessaire lorsque le type d'événement est LINE.

Route Measure Event Properties
overlay_type

Type de superposition à réaliser.

  • INTERSECTInscrit dans la table d'événements en sortie uniquement les événements superposés. Il s'agit de l'option par défaut.
  • UNIONInscrit tous les événements dans la table en sortie. Les événements linéaires sont divisés à leurs intersections.
String
out_table

Table à créer.

Table
out_event_properties

Paramètre composé des champs de localisation d'itinéraire et du type d'événements qui seront écrits dans la table d'événements en sortie.

  • Champ d'identifiant d'itinéraire - Champ contenant des valeurs indiquant les itinéraires le long de chaque événement.
  • Type d'événement - Type des événements dans la table d'événements en sortie (POINT ou LINE).
    • POINT - Les événements ponctuels se produisent à un emplacement précis le long d'un itinéraire. Seul un champ de mesure unique doit être spécifié.
    • LINE - Les événements linéaires décrivent une portion d'itinéraire. Les champs de mesure de départ et d'arrivée doivent être spécifiés.
  • Champ M de départ - Champ qui contiendra des valeurs de mesure. Ce champ est requis pour un événement de type POINT ou LINE. Lorsque le type d'événement est POINT, l'appellation de ce paramètre devient Champ de mesure.
  • Champ M d'arrivée - Champ qui contiendra des valeurs de mesure. Ce champ est requis pour un événement de type LINE.
Route Measure Event Properties
zero_length_events
(Facultatif)

Spécifie s'il convient ou non de conserver les événements linéaires de longueur nulle dans la table en sortie. Ce paramètre est valide uniquement si le type d'événement en sortie est LINE.

  • ZEROConserve les événements linéaires de longueur nulle. Il s'agit de l'option par défaut.
  • NO_ZERONe conserve pas les événements linéaires de longueur nulle.
Boolean
in_fields
(Facultatif)

Spécifie si tous les champs issus des tables d'événements en entrée et superposés doivent être inscrits dans la table d'événements en sortie.

  • FIELDSInclut tous les champs des tables en entrée dans la table en sortie. Il s'agit de l'option par défaut.
  • NO_FIELDSN'inclut pas tous les champs des tables en entrée dans la table en sortie. Seuls le champ ObjectID et les champs de localisation d'itinéraire sont conservés.
Boolean
build_index
(Facultatif)

Spécifie si un index attributaire est créé pour le champ d'identifiant d'itinéraire inscrit dans la table d'événements en sortie.

  • INDEXCrée 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 d'utilisation de la fonction Superposer des événements d'itinéraires (fenêtre Python)
import arcpy
from arcpy import env

env.workspace = "C:/Data"
arcpy.OverlayRouteEvents_lr ("accident.dbf", "rkey POINT mile" , "pavecond.dbf", "rkey LINE fmp tmp", "INTERSECT", \
                              "accpav", "rkey POINT mile" )
Exemple d'utilisation de la fonction Superposer des événements d'itinéraires (script Python autonome)

Le script Python ci-dessous illustre l'utilisation de la fonction Superposer des événements d'itinéraires dans un script Python autonome.

# NAme: OverlayRouteEvents_Example.py
# Description: Point-on-line INTERSECT overlay (both tables are dBASE)
# Author: ESRI

# Import system modules 
import arcpy
from arcpy import env

# Set workspace
env.workspace = "C:/Data"

# Set local variables
in_tbl = "accident.dbf"
in_props = "rkey POINT mile"        # reused as out event properties
ov_tbl = "pavecond.dbf"
ov_props = "rkey LINE fmp tmp"
out_tbl = "accpav"

# Execute OverlayRouteEvents
arcpy.OverlayRouteEvents_lr (in_tbl, in_props, ov_tbl, ov_props, "INTERSECT", \
                              out_tbl, in_props)
Exemple 2 d'utilisation de la fonction Superposer des événements d'itinéraires (script Python autonome)

Le script Python suivant illustre l'utilisation de la fonction Superposer des événements d'itinéraires dans un script Python autonome à l'aide de données de géodatabase fichier.

# Name OverlayRouteEvents_Example2.py
# Description: Line-on-line UNION overlay (both tables are in a file geodatabase)
# Author: ESRI

# Import system modules
import arcpy
from arcpy import env

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

# Set local variables
in_tbl = "pavecond"
in_props = "rkey LINE fmp tmp"     # reused as overlay and out event properties
ov_tbl = "pavetype"
out_tbl = "condtype" 

# Execute OverlayRouteEvents
arcpy.OverlayRouteEvents_lr (in_tbl, in_props, ov_tbl, in_props, "UNION", \
                              out_tbl, in_props, "NO_ZERO")
Exemple 3 d'utilisation de la fonction Superposer des événements d'itinéraires (script Python autonome)

Le script Python suivant illustre l'utilisation de la fonction Superposer des événements d'itinéraires dans un script Python autonome à l'aide de données de géodatabase personnelle.

# Name: OverlayRouteEvents_Example3.py
# Description: Line-on-line UNION overlay (both tables are in a personal geodatabase)
# Author: ESRI

# Import system modules
import arcpy
from arcpy import env

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

# Set local variables
in_tbl = "pavecond"
in_props = "rkey LINE fmp tmp"     # reused as overlay and out event properties
ov_tbl = "pavetype"
out_tbl = "condtype" 

# Execute OverlayRouteEvents
arcpy.OverlayRouteEvents_lr (in_tbl, in_props, ov_tbl, in_props, "UNION", \
                              out_tbl, in_props, "NO_ZERO")
Exemple 4 d'utilisation de la fonction Superposer des événements d'itinéraires (script Python autonome)

Le script Python ci-dessous illustre l'utilisation de la fonction Superposer des événements d'itinéraires dans un script Python autonome à l'aide de données ArcSDE.

# Name: OverlayRouteEvents_Example4.py
# Description:  Point-on-line INTERSECT overlay (both tables are in enterprise geodatabase)

# Import system modules 
import arcoy
from arcpy import env

# Set workspace
env.workspace = "Database Connections/Connection to Jerry.sde"

# Set local variables
in_tbl = gp.QualifyTableName("accident", wkspc)
in_props = "rkey POINT mile"  
ov_tbl = gp.QualifyTableName("pavecond", wkspc) 
ov_props = "rkey LINE fmp tmp"
out_tbl = "accpav"
out_props = "routekey POINT milepost"     # names are changed for out table

# Execute OverlayRouteEvents
arcpy.OverlayRouteEvents_lr (in_tbl, in_props, ov_tbl, ov_props, "INTERSECT", \
                              out_tbl, out_props)

Environnements

Thèmes connexes

Informations de licence

ArcGIS for Desktop Basic: Oui
ArcGIS for Desktop Standard: Oui
ArcGIS for Desktop Advanced: Oui
5/10/2014