Étiquette | Explication | Type de données |
Entités en entrée | Entités ponctuelles, linéaires ou surfaciques en entrée. | Feature Layer |
Entités itinéraires en entrée | Itinéraires avec lesquels la valeur du paramètre Input Features (Entités en entrée) intersecte. | Feature Layer |
Champ d’identifiant d’itinéraire | Champ contenant des valeurs identifiant de manière unique chaque itinéraire. Le champ peut être de type numérique, texte ou GUID. | Field |
Rayon de recherche | Si la valeur du paramètre Input Features (Entités en entrée) est points, le rayon de recherche est une valeur numérique définissant la distance autour de chaque point au sein de laquelle un itinéraire cible est recherché. Si la valeur du paramètre Input Features (Entités en entrée) est lines (lignes), la tolérance de recherche est une tolérance d’agrégat, c’est-à-dire une valeur numérique représentant la distance tolérée maximale entre les lignes en entrée et les itinéraires cible. Si la valeur du paramètre Input Features (Entités en entrée) est polygons (polygones), ce paramètre est ignoré et aucun rayon de recherche n’est utilisé. | Linear Unit |
Table d’événements en sortie | Table qui sera créée. La table en sortie peut être un dBase (fichier .dbf) ou une table de géodatabase. | Table |
Propriétés des événements en sortie | Champs de localisation d’itinéraire et type d’événements qui sont écrits dans la table d’événement en sortie.
| Route Measure Event Properties |
Keep only the closest route location (Conserver uniquement l’emplacement d’itinéraire le plus proche) (Facultatif) | Indique si l’emplacement d’itinéraire le plus proche ou tous les emplacements d’itinéraires situés dans le rayon de recherche sont écrits dans la valeur du paramètre Output Event Table (Table d’événements en sortie). Lorsque vous localisez des points le long des itinéraires, il est possible que plusieurs itinéraires se trouvent dans le rayon de recherche d’un point donné. Ce paramètre est ignoré lorsque vous localisez des lignes ou des polygones le long des itinéraires.
| Boolean |
Inclure le champ de distance dans la table en sortie (Facultatif) | Spécifie si un champ DISTANCE est ajouté à la valeur du paramètre Table d’événements en sortie. Les valeurs de ce champ sont exprimées dans les mêmes unités que le rayon de recherche spécifié. Ce paramètre est ignoré lorsque vous localisez des lignes ou des polygones le long des itinéraires.
| Boolean |
Conserver les événements linéaires de longueur nulle (Facultatif) | Spécifie si les événements linéaires de longueur nulle sont écrits dans la sortie. Lorsque vous localisez des polygones le long des itinéraires, il est possible que des événements soient créés lorsque les mesures de départ et d’arrivée sont égales. Ce paramètre est ignoré lorsque vous localisez des points ou des lignes le long des itinéraires.
| Boolean |
Include all fields from input (Inclure tous les champs de la sortie) (Facultatif) | Spécifie si la valeur du paramètre Output Event Table (Table d’événements en sortie) doit contenir les champs de localisation d’itinéraire, ainsi que tous les attributs de la valeur du paramètre Input Features (Entités en entrée).
| Boolean |
Utiliser le décalage de la direction M (Facultatif) | Spécifie si la distance de décalage calculée doit être basée sur la direction M ou sur le sens de numérisation. Les distances sont comprises dans la valeur du paramètre Table d’événements en sortie si le paramètre Inclure le champ de distance dans la table en sortie est sélectionnée.
| Boolean |
Synthèse
Calcule l'intersection des entités en entrée (ponctuelles, linéaires ou surfaciques) et des itinéraires, et inscrit les informations d'itinéraire et de mesure dans une nouvelle table d'événements.
Utilisation
Lorsque la valeur du paramètre Input Features (Entités en entrée) est points, la valeur de Event Type (Type d’événement) doit être définie sur Point. Lorsque la valeur du paramètre Input Features (Entités en entrée) est lines (lignes) ou polygons (polygones), la valeur de Event Type (Type d’événement) doit être définie sur Line (Ligne).
Les résultats sont meilleurs lorsque les entités en entrée et les itinéraires cible se superposent exactement.
Attention :
L'utilisation d'un rayon de recherche élargi ou d'une tolérance d'agrégat importante en vue de réduire les écarts entre les entités en entrée et les itinéraires cible peut produire des résultats inattendus.
Pour réduire le nombre des entités en entrée qui seront traitées par cet outil, vous pouvez entrer des couches dotées de sélections.
-
La table en sortie peut être affichée dans une carte à l’aide de l’outil Générer une couche d’événements d’itinéraires.
Paramètres
arcpy.lr.LocateFeaturesAlongRoutes(in_features, in_routes, route_id_field, radius_or_tolerance, out_table, out_event_properties, {route_locations}, {distance_field}, {zero_length_events}, {in_fields}, {m_direction_offsetting})
Nom | Explication | Type de données |
in_features | Entités ponctuelles, linéaires ou surfaciques en entrée. | Feature Layer |
in_routes | Itinéraires avec lesquels la valeur du paramètre in_features intersecte. | Feature Layer |
route_id_field | Champ contenant des valeurs identifiant de manière unique chaque itinéraire. Le champ peut être de type numérique, texte ou GUID. | Field |
radius_or_tolerance | Si la valeur du paramètre in_features est points, le rayon de recherche est une valeur numérique définissant la distance autour de chaque point au sein de laquelle un itinéraire cible est recherché. Si la valeur du paramètre in_features est lines (lignes), la tolérance de recherche est une tolérance d’agrégat, c’est-à-dire une valeur numérique représentant la distance tolérée maximale entre les lignes en entrée et les itinéraires cible. Si la valeur du paramètre in_features est polygons (polygones), ce paramètre est ignoré et aucun rayon de recherche n’est utilisé. | Linear Unit |
out_table | Table qui sera créée. La table en sortie peut être un dBase (fichier .dbf) ou une table de géodatabase. | Table |
out_event_properties | Champs de localisation d’itinéraire et type d’événements qui sont écrits dans la table d’événement en sortie.
| Route Measure Event Properties |
route_locations (Facultatif) | Indique si l’emplacement d’itinéraire le plus proche ou tous les emplacements d’itinéraires situés dans le rayon de recherche sont écrits dans la valeur du paramètre out_table. Lorsque vous localisez des points le long des itinéraires, il est possible que plusieurs itinéraires se trouvent dans le rayon de recherche d’un point donné. Ce paramètre est ignoré lorsque vous localisez des lignes ou des polygones le long des itinéraires.
| Boolean |
distance_field (Facultatif) | Spécifie si un champ DISTANCE est ajouté à la valeur du paramètre out_table. Les valeurs de ce champ sont exprimées dans les mêmes unités que le rayon de recherche spécifié. Ce paramètre est ignoré lorsque vous localisez des lignes ou des polygones le long des itinéraires.
| Boolean |
zero_length_events (Facultatif) | Spécifie si les événements linéaires de longueur nulle sont écrits dans la sortie. Lorsque vous localisez des polygones le long des itinéraires, il est possible que des événements soient créés lorsque les mesures de départ et d’arrivée sont égales. Ce paramètre est ignoré lorsque vous localisez des points ou des lignes le long des itinéraires.
| Boolean |
in_fields (Facultatif) | Spécifie si la valeur du paramètre out_table doit contenir les champs de localisation d’itinéraire, ainsi que tous les attributs de la valeur du paramètre in_features.
| Boolean |
m_direction_offsetting (Facultatif) | Spécifie si la distance de décalage calculée doit être basée sur la direction M ou sur le sens de numérisation. Les distances sont comprises dans la valeur du paramètre out_table si le paramètre distance_field est défini sur DISTANCE.
| Boolean |
Exemple de code
Le script Python suivant illustre l’utilisation de la fonction LocateFeaturesAlongRoutes dans la fenêtre Python
import arcpy
arcpy.env.workspace = "C:/Data"
arcpy.lr.LocateFeaturesAlongRoutes("rail_segments.shp", "rail_routes.shp",
"rkey", "0.5 Feet", "locate_lines",
"rkey LINE fmp tmp")
Le script Python ci-dessous illustre l’utilisation de la fonction LocateFeaturesAlongRoutes dans un script Python autonome.
# Name: LocateFeaturesAlongRoutes_Example2.py
# Description: Locate shapefile lines along shapefile routes.
# Import system modules
import arcpy
# Set workspace
arcpy.env.workspace = "C:/Data"
# Set local variables
feats = "rail_segments.shp"
rts = "rail_routes.shp"
rid = "rkey"
tol = "0.5 Feet"
tbl = "locate_lines"
props = "rkey LINE fmp tmp"
# Run LocateFeaturesAlongRoutes
arcpy.lr.LocateFeaturesAlongRoutes(feats, rts, rid, tol, tbl, props)
Le script Python suivant illustre l’utilisation de la fonction LocateFeaturesAlongRoutes dans un script Python autonome à l’aide de données de géodatabase fichier.
# Name: LocateFeaturesAlongRoutes_Example3.py
# Description: Locate file geodatabase points along file geodatabase routes.
# Import system modules
import arcpy
# Set workspace
arcpy.env.workspace = "C:/Data/Pitt.gdb"
# Set local variables
feats = "rail/crossings" # Crossings is in the rail feature dataset
rts = "rail/routes" # Routes is in the rail feature dataset
rid = "rkey"
rad = "10 Feet"
tbl = "locate_points"
props = "rkey POINT mp"
# Run LocateFeaturesAlongRoutes
arcpy.lr.LocateFeaturesAlongRoutes(feats, rts, rid, rad, tbl, props)
Le script Python suivant illustre l’utilisation de la fonction LocateFeaturesAlongRoutes dans un script Python autonome avec des données de géodatabase d’entreprise.
# Name: LocateFeaturesAlongRoutes_Example4.py
# Description: Locate enterprise geodatabase polygons along enterprise geodatabase routes.
# Import system modules
import arcpy
# Set workspace
arcpy.env.workspace = "C:/MyProject/myConn.sde"
# Set local variables
feats = arcpy.ValidateTableName("counties", wkspc) # Stand-alone feature class
rts = arcpy.ValidateTableName("rail_routes", wkspc) # Stand-alone feature class
rid = "rkey"
tbl = "locate_polys"
props = "rkey LINE fmp tmp"
# Run LocateFeaturesAlongRoutes
arcpy.lr.LocateFeaturesAlongRoutes(feats, rts, rid, "#", tbl, props, "#", "#",
"NO_ZERO", "M_DIRECTON")
Environnements
Informations de licence
- Basic: Oui
- Standard: Oui
- Advanced: Oui
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?