RouteSolverProperties (arcpy.na)

Récapitulatif

Permet d'accéder aux propriétés d'analyse d'une couche d'analyse de réseau d'itinéraire. La fonction GetSolverProperties permet d'obtenir un objet RouteSolverProperties à partir d'une couche d'analyse de réseau d'itinéraire.

Discussion

L'objet RouteSolverProperties permet un accès en lecture et en écriture à toutes les propriétés d'analyse d'une couche d'analyse de réseau d'itinéraire. L'objet permet de modifier les propriétés d'analyse souhaitées de la couche d'itinéraire, et la couche correspondante peut être analysée à nouveau en vue de déterminer les résultats appropriés. Il est possible de créer une nouvelle couche d'itinéraire à l'aide de l'outil de géotraitement Générer une couche d'itinéraires. Obtenir l'objet RouteSolverProperties à partir d'une nouvelle couche d'itinéraire permet de réutiliser la couche existante pour les analyses suivantes plutôt que de créer une couche pour chaque analyse, ce qui peut être un processus lent.

Une fois les propriétés de l'objet RouteSolverProperties modifiées, la couche correspondante peut être utilisée immédiatement avec d'autres fonctions et outils de géotraitement. Aucune actualisation ni mise à jour de la couche n'est requise pour respecter les changements effectués par l'intermédiaire de l'objet.

Propriétés

Propriété	Explication	Type de données
accumulators (Lecture/écriture)	Permet d'obtenir ou de définir une liste des attributs de coût du réseau cumulés dans le cadre de l'analyse. Une liste vide, [], indique qu'aucun attribut de coût n'est cumulé.	String
attributeParameters (Lecture/écriture)	Permet d'obtenir ou de définir les attributs paramétrés à utiliser dans l'analyse. La propriété retourne un dictionnaire Python. La clé de dictionnaire est un tuple à deux valeurs comprenant le nom de l'attribut et le nom du paramètre. La valeur de chaque élément du dictionnaire correspond à la valeur du paramètre. Les attributs de réseau paramétrés permettent de modéliser un aspect dynamique de la valeur d'un attribut. Par exemple, un tunnel avec une restriction de hauteur de 12 pieds peut être modélisé à l'aide d'un paramètre. Dans ce cas, la hauteur du véhicule en pieds doit être spécifiée en tant que valeur de paramètre. Si la hauteur du véhicule est supérieure à 12 pieds, cette restriction prend la valeur True, ce qui restreint le passage par le tunnel. De la même façon, un pont peut comporter un paramètre pour spécifier une restriction de poids. Toute tentative de modification de la propriété attributeParameters en place ne permet pas de mettre à jour les valeurs. Vous devez à la place toujours utiliser un nouvel objet dictionnaire pour définir des valeurs pour la propriété. Les deux blocs de code suivants montrent la différence entre ces deux approches. #Don't attempt to modify the attributeParameters property in place. #This coding method won't work. solverProps.attributeParameters[('HeightRestriction', 'RestrictionUsage')] = "PROHIBITED" #Modify the attributeParameters property using a new dictionary object. #This coding method works. params = solverProps.attributeParameters params[('HeightRestriction', 'RestrictionUsage')] = "PROHIBITED" solverProps.attributeParameters = params Si la couche d'analyse de réseau ne comporte pas d'attributs paramétrés, cette propriété retourne la valeur Aucun.	Dictionary
findBestSequence (Lecture/écriture)	Contrôle si les arrêts sont réorganisés pour trouver des itinéraires optimaux. Voici une liste des valeurs possibles : FIND_BEST_ORDER —Les arrêts sont réorganisés pour trouver le meilleur itinéraire. Cette option transforme l'analyse des itinéraires d'un problème de plus court chemin en un problème du voyageur de commerce (TSP). Une valeur True peut également être utilisée pour spécifier cette option. USE_INPUT_ORDER —Les arrêts sont visités dans l'ordre de saisie. Une valeur False peut également être utilisée pour spécifier cette option.	String
impedance (Lecture/écriture)	Permet d'obtenir ou de définir l'attribut de coût du réseau utilisé en tant qu'impédance. Cet attribut de coût est réduit en déterminant le meilleur itinéraire.	String
orderingType (Lecture/écriture)	Contrôle le classement des arrêts lorsque la propriété findBestSequence est définie sur FIND_BEST_ORDER. Voici une liste des valeurs possibles : PRESERVE_BOTH —Conserve les premier et dernier arrêts selon l'ordre de saisie en les définissant comme les premier et dernier arrêts de l'itinéraire. PRESERVE_FIRST —Conserve le premier arrêt selon l'ordre de saisie en le définissant comme le premier arrêt de l'itinéraire, mais le dernier arrêt peut être réorganisé. PRESERVE_LAST —Conserve le dernier arrêt selon l'ordre de saisie en le définissant comme le dernier arrêt de l'itinéraire, mais le premier arrêt peut être réorganisé. PRESERVE_NONE —Permet de réorganiser à la fois le premier et le dernier arrêt.	String
outputPathShape (Lecture/écriture)	Permet d'obtenir ou de définir le type de forme pour les entités d'itinéraires générées en sortie par le solveur. Voici une liste des valeurs possibles : TRUE_LINES_WITH_MEASURES —Les itinéraires en sortie ont la forme exacte des sources de données du réseau sous-jacentes. En outre, la sortie comprend des mesures d'itinéraire pour le référencement linéaire. Les mesures augmentent à partir du premier arrêt et enregistrent l'impédance cumulée pour atteindre une position donnée. TRUE_LINES_WITHOUT_MEASURES —Les itinéraires en sortie ont la forme exacte des sources de données du réseau sous-jacentes. STRAIGHT_LINES —La forme d'itinéraire en sortie est une ligne droite unique entre les arrêts. NO_LINES —Aucune forme n'est créée pour les itinéraires en sortie.	String
restrictions (Lecture/écriture)	Permet d'obtenir ou de définir une liste des attributs de restriction appliqués pour l'analyse. Une liste vide, [], indique qu'aucun attribut de restriction n'est utilisé pour l'analyse.	String
solverName (Lecture seule)	Renvoie le nom du solveur qui est référencé par la couche d'analyse réseau utilisée pour obtenir l'objet des propriétés du solveur. La propriété renvoie toujours la valeur de chaîne Solveur d'itinéraire en cas d'accès depuis un objet RouteSolverProperties.	String
timeOfDay (Lecture/écriture)	Permet d'obtenir ou de définir la date et l'heure de début pour l'itinéraire. L'heure de début de l'itinéraire permet principalement de trouver des itinéraires selon l'attribut d'impédance qui varie avec l'heure du jour. Par exemple, une heure de début égale à 9h permet de trouver un itinéraire tenant compte de la circulation à l'heure de pointe. Une valeur Aucun peut permettre de spécifier qu'aucune date et heure ne doivent être utilisées. Au lieu d'utiliser une date particulière, un jour de la semaine peut être spécifié à l'aide des dates suivantes : Aujourd'hui - 12/30/1899 Dimanche - 12/31/1899 Lundi - 1/1/1900 Mardi - 1/2/1900 Mercredi - 1/3/1900 Jeudi - 1/4/1900 Vendredi - 1/5/1900 Samedi - 1/6/1900 Par exemple, pour préciser que l'itinéraire doit démarrer à 17h00 mardi, spécifiez la valeur sous la forme datetime.datetime(1900, 1, 2, 17,0,0).	DateTime
uTurns (Lecture/écriture)	Permet d'obtenir ou de définir la stratégie qui indique comment les demi-tours aux jonctions qui pourraient survenir pendant la traversée du réseau entre différents arrêts sont gérés par le solveur. Voici une liste des valeurs possibles : ALLOW_UTURNS —Les demi-tours sont autorisés aux jonctions comportant un nombre quelconque de tronçons connectés. NO_UTURNS —Les demi-tours sont interdits à toutes les jonctions, indépendamment de la valence de jonction. Notez toutefois que les demi-tours restent autorisés aux emplacements réseau même lorsque ce paramètre est sélectionné ; en revanche, vous pouvez configurer la propriété CurbApproach des emplacements réseau individuels pour y interdire les demi-tours également. ALLOW_DEAD_ENDS_ONLY —Les demi-tours sont interdits au niveau de toutes les jonctions, sauf celles ayant un seul tronçon adjacent (voie sans issue). ALLOW_DEAD_ENDS_AND_INTERSECTIONS_ONLY —Les demi-tours sont interdits aux jonctions où deux tronçons adjacents se rencontrent, mais sont autorisés aux intersections (jonctions avec au moins trois tronçons adjacents) et aux voies sans issue (jonctions avec exactement un tronçon adjacent). Souvent, les réseaux comportent des jonctions superflues au milieu de segments de route. Cette option empêche des véhicules de faire des demi-tours à ces emplacements.	String
useHierarchy (Lecture/écriture)	Contrôle l'utilisation de l'attribut de hiérarchie lors de l'analyse. Voici une liste des valeurs possibles : USE_HIERARCHY — Utilise l'attribut de hiérarchie pour l'analyse. L'utilisation d'une hiérarchie implique une préférence du solveur pour les tronçons d'ordre supérieur par rapport aux tronçons d'ordre inférieur. Les recherches hiérarchiques sont plus rapides et permettent de simuler la préférence d'un chauffeur de circuler sur des autoroutes au lieu de routes locales si possible, même si cela implique un trajet plus long. Cette option s'applique uniquement si le jeu de données réseau référencé par la couche ArcGIS Network Analyst dispose d'un attribut de hiérarchie. Une valeur True peut également être utilisée pour spécifier cette option. NO_HIERARCHY —N'utilise pas l'attribut de hiérarchie pour l'analyse. Un itinéraire exact est alors obtenu pour le jeu de données réseau. Une valeur False peut également être utilisée pour spécifier cette option.	String
useTimeWindows (Lecture/écriture)	Contrôle si des fenêtres horaires sont utilisées au niveau des arrêts. Voici une liste des valeurs possibles : USE_TIMEWINDOWS —L'itinéraire tient compte des fenêtres horaires au niveau des arrêts. Si un arrêt survient avant sa fenêtre horaire, un délai d'attente s'écoule avant l'affichage de la fenêtre horaire. Si un arrêt survient après sa fenêtre horaire, une infraction de fenêtre horaire se produit. L'infraction de fenêtre horaire totale est comparée à l'impédance minimale lors du calcul de l'itinéraire. Cette option s'applique uniquement lorsque l'attribut de coût du réseau spécifié en tant que valeur pour la propriété d'impédance est exprimé dans les unités de temps. Une valeur True peut également être utilisée pour spécifier cette option. NO_TIMEWINDOWS —L'itinéraire ignore les fenêtres horaires au niveau des arrêts. Une valeur False peut également être utilisée pour spécifier cette option.	String

Exemple de code

Exemple 1 d'utilisation de l'objet RouteSolverProperties (fenêtre Python)

Le script indique comment mettre à jour la propriété d'impédance à l'attribut de coût TravelTime, spécifie des attributs de coût en minutes et en mètres comme attributs cumulatifs et utilise l'heure réelle comme heure de début d'itinéraire. Il suppose qu'une couche d'analyse de réseau d'itinéraire appelée Itinéraire a été créé dans un nouveau document ArcMap d'après le jeu de données réseau du didacticiel pour la région de San Francisco.

#Get the route layer object from a layer named "Route" in the table of contents
routeLayer = arcpy.mapping.Layer("Route")

#Get the route solver properties object from the route layer
solverProps = arcpy.na.GetSolverProperties(routeLayer)

#Update the properties for the route layer using the route solver properties object
solverProps.impedance = "TravelTime"
solverProps.accumulators = ["Meters", "Minutes"]
#Only set the time component from the current date time as time of day
solverProps.timeOfDay = datetime.datetime.now().time()

Exemple 2 d'utilisation de l'objet RouteSolverProperties (workflow)

Le script illustre comment trouver l'itinéraire le plus court (distance) et le plus rapide (durée de trajet) entre un ensemble d'arrêts et enregistre chaque itinéraire en tant que classe d'entités dans une géodatabase. Il illustre la création d'une seule instance d'une couche d'itinéraire et la modification de la propriété d'impédance à l'aide de l'objet RouteSolverProperties afin d'obtenir les résultats souhaités.

import arcpy

#Set up the environment
arcpy.env.overwriteOutput = True
arcpy.CheckOutExtension("network")

#Set up variables
networkDataset = "C:/Data/SanFrancisco.gdb/Transportation/Streets_ND"
stops = "C:/Data/SanFrancisco.gdb/Analysis/Stores"
fastestRoute = "C:/Data/SanFrancisco.gdb/FastestRoute"
shortestRoute = "C:/Data/SanFrancisco.gdb/ShortestRoute"

#Make a new route layer using travel time as impedance to determine fastest route
routeLayer = arcpy.na.MakeRouteLayer(networkDataset, "StoresRoute",
                                     "TravelTime").getOutput(0)

#Get the network analysis class names from the route layer
naClasses = arcpy.na.GetNAClassNames(routeLayer)

#Get the routes sublayer from the route layer
routesSublayer = arcpy.mapping.ListLayers(routeLayer, naClasses["Routes"])[0]

#Load stops
arcpy.na.AddLocations(routeLayer, naClasses["Stops"], stops)

#Solve the route layer
arcpy.na.Solve(routeLayer)

#Copy the route as a feature class
arcpy.management.CopyFeatures(routesSublayer, fastestRoute)

#Get the RouteSolverProperties object from the route layer to modify the
#impedance property of the route layer.
solverProps = arcpy.na.GetSolverProperties(routeLayer)

#Set the impedance property to "Meters" to determine the shortest route.
solverProps.impedance = "Meters"

#Resolve the route layer
arcpy.na.Solve(routeLayer)

#Copy the route as a feature class
arcpy.management.CopyFeatures(routesSublayer, shortestRoute)

arcpy.AddMessage("Completed")