Résumé
Crée une matrice de coût origine-destination (OD) de plusieurs origines vers plusieurs destinations. Une matrice de coût OD est une table contenant le temps de trajet et la distance à parcourir de chaque origine vers chaque destination. En outre, elle classe les destinations auxquelles chaque origine se connecte par ordre croissant en fonction du temps ou de la distance minimum nécessaire pour aller de cette origine vers chaque destination. Le meilleur chemin sur le réseau de transport est découvert pour chaque paire origine-destination. Les temps de déplacement et les distances à parcourir sont stockés sous forme d'attributs des lignes en sortie. Bien que, pour des raisons de performance, les lignes soient droites, elles stockent toujours le temps de trajet et la distance à parcourir avec le réseau de transport et non la distance en ligne droite.
Pour en savoir plus sur la sortie de la matrice de coût origine-destination
Utilisation
Recherche et mesure les chemins de moindre coût le long du réseau, de plusieurs origines vers plusieurs destinations.
La boîte de dialogue de cet outil regroupe divers paramètres facultatifs dans les six catégories suivantes pour vous permettre de mieux les gérer :
- Analyse avancée
- Interruptions
- Mode de déplacement personnalisé
- Jeu de données réseau
- Localisations du réseau
- Sortie
- Fonctionnalités de service
Syntaxe
arcpy.na.GenerateOriginDestinationCostMatrix(Origins, Destinations, Network_Dataset, Output_Geodatabase, Output_Origin_Destination_Lines_Name, Output_Origins_Name, Output_Destinations_Name, {Travel_Mode}, {Time_Units}, {Distance_Units}, {Number_of_Destinations_to_Find}, {Cutoff}, {Time_of_Day}, {Time_Zone_for_Time_of_Day}, {Point_Barriers}, {Line_Barriers}, {Polygon_Barriers}, {Impedance_Attribute}, {Impedance_Attribute_Units}, {Time_Attribute}, {Time_Attribute_Units}, {Distance_Attribute}, {Distance_Attribute_Units}, {UTurn_Policy}, {Use_Hierarchy_in_Analysis}, {Restrictions}, {Attribute_Parameter_Values}, {Accumulate_Attributes}, {Maximum_Snap_Tolerance}, {Feature_Locator_WHERE_Clause}, {Origin_Destination_Line_Shape}, {Maximum_Features_Affected_by_Point_Barriers}, {Maximum_Features_Affected_by_Line_Barriers}, {Maximum_Features_Affected_by_Polygon_Barriers}, Maximum_Origins, Maximum_Destinations, {Force_Hierarchy_Beyond_Distance}, {Save_Output_Network_Analysis_Layer}, {Overrides})
Paramètre | Explication | Type de données |
Origins | Indique les emplacements qui fonctionnent en tant que points de départ pour la génération des chemins vers les destinations. Vous pouvez ajouter jusqu'à 200 origines. Lorsque vous spécifiez les origines, vous pouvez définir les propriétés de chacune, telles que son nom ou le nombre de destinations à rechercher depuis l'origine, en utilisant des attributs. Vous pouvez spécifier les origines avec les attributs suivants : Name : nom de l’origine. Le nom peut être un identifiant unique de l'origine. Le nom est inclus dans les lignes en sortie (comme champ OriginName) et dans les origines en sortie (comme champ Name) et peut servir à joindre des informations supplémentaires depuis les sorties de l’outil vers les attributs de vos origines. Si le nom n'est pas spécifié, un nom unique accompagné du préfixe Location est automatiquement généré dans les origines en sortie. Aucun nom d'origine généré automatiquement n'est inclus dans les lignes en sortie. TargetDestinationCount : nombre maximum de destinations à rechercher pour l’origine. Si aucune valeur n'est indiquée, la valeur du paramètre Nombre de destinations à rechercher est utilisée. Cutoff : spécifiez la valeur du temps de trajet ou de la distance à parcourir à laquelle cesser la recherche de destinations depuis l’origine. Toute destination située au-delà de la valeur limite ne sera pas prise en compte. La valeur doit respecter les unités spécifiées par le paramètre Unités de tempssi l'attribut d'impédance dans votre mode de déplacement repose sur le temps ou les unités spécifiées par le paramètre Unités de distance si l'attribut d'impédance dans votre mode de déplacement repose sur la distance. Si aucune valeur n'est indiquée, la valeur du paramètre Limite est utilisée. CurbApproach : spécifiez la direction dans laquelle un véhicule peut quitter l’origine. Le champ peut prendre l'une des valeurs entières suivantes (utilisez le code numérique, pas le nom de l'option fourni entre parenthèses) :
La propriété CurbApproach est conçue pour opérer avec les deux types de normes de conduite nationale : à droite (États-Unis) et à gauche (Royaume-Uni). D'abord, considérez un arrêt du côté gauche d'un véhicule. Il se situe toujours sur la gauche, que le véhicule circule du côté gauche ou du côté droit de la route. Avec les normes de conduite nationales, ce qui peut changer est votre décision d'aborder un arrêt du côté droit ou du côté gauche du véhicule. Par exemple, si vous souhaitez atteindre un arrêt sans laisser une voie de circulation entre le véhicule et l'arrêt, vous choisissez Côté droit du véhicule (1) aux Etats-Unis, mais Côté gauche du véhicule (2) au Royaume-Uni. | Feature Set |
Destinations | Indique les emplacements qui fonctionnent en tant que points de fin pour la génération des chemins depuis les origines. Vous pouvez ajouter jusqu'à 200 destinations. Vous pouvez définir les propriétés des destinations que vous spécifiez, telles que leur nom, en utilisant des attributs. Vous pouvez spécifier les destinations avec les attributs suivants : Name : nom de la destination. Le nom peut être un identifiant unique de la destination. Le nom est inclus dans les lignes en sortie (comme champ DestinationName) et dans les destinations en sortie (comme champ Name) et peut servir à joindre des informations supplémentaires depuis les sorties de l’outil vers les attributs de vos destinations. Si le nom n'est pas spécifié, un nom unique accompagné du préfixe Location est automatiquement généré dans les destinations en sortie. Aucun nom de destination généré automatiquement n'est inclus dans les lignes en sortie. CurbApproach : spécifie la direction dans laquelle un véhicule peut atteindre la destination. Le champ peut prendre l'une des valeurs entières suivantes (utilisez le code numérique, pas le nom de l'option fourni entre parenthèses) :
La propriété CurbApproach est conçue pour opérer avec les deux types de normes de conduite nationale : à droite (États-Unis) et à gauche (Royaume-Uni). D'abord, considérez un arrêt du côté gauche d'un véhicule. Il se situe toujours sur la gauche, que le véhicule circule du côté gauche ou du côté droit de la route. Avec les normes de conduite nationales, ce qui peut changer est votre décision d'aborder un arrêt du côté droit ou du côté gauche du véhicule. Par exemple, si vous souhaitez atteindre un arrêt sans laisser une voie de circulation entre le véhicule et l'arrêt, vous choisissez Côté droit du véhicule (1) aux Etats-Unis, mais Côté gauche du véhicule (2) au Royaume-Uni. | Feature Set |
Network_Dataset | Jeu de données réseau qui fait l'objet d'une analyse. Les jeux de données réseau représentent le plus souvent des réseaux de transport, mais aussi d'autres types de réseaux. Le jeu de données réseau doit présenter au moins un attribut de coût basé sur le temps et un autre basé sur la distance. | Network Dataset Layer |
Output_Geodatabase | Espace de travail en sortie. Cet espace de travail doit déjà exister. | Workspace |
Output_Origin_Destination_Lines_Name | Nom du champ de la classe d'entités en sortie qui stocke les lignes qui relient les points d'origine et de destination. La rubrique d'aide Sortie de l'outil Générer une matrice de coût origine-destination décrit la structure de cette classe d'entités en sortie. | String |
Output_Origins_Name | Nom du champ de la classe d'entités en sortie contenant les points d'origine. La rubrique d'aide Sortie de l'outil Générer une matrice de coût origine-destination décrit la structure de cette classe d'entités en sortie. | String |
Output_Destinations_Name | Nom du champ de la classe d'entités en sortie contenant les points de destination. La rubrique d'aide Sortie de l'outil Générer une matrice de coût origine-destination décrit la structure de cette classe d'entités en sortie. | String |
Travel_Mode (Facultatif) | Choisissez le mode de transport pour l’analyse. CUSTOM est toujours proposé. Pour que les autres modes de déplacement apparaissent, ils doivent être présents dans le jeu de données réseau spécifié dans le paramètre Network_Dataset. (La fonction arcpy.na.GetTravelModes fournit un dictionnaire des objets du mode de déplacement qui sont configurés sur un jeu de données réseau et la propriété name renvoie le nom d’un objet du mode de déplacement.) Un mode de déplacement est défini sur un jeu de données réseau et offre des valeurs de remplacement des paramètres qui, ensemble, modélisent la voiture, le camion, le piéton et d’autres modes de déplacement. En choisissant ici un mode de déplacement, vous n'avez pas besoin de fournir des valeurs pour les paramètres suivants, qui sont remplacés par les valeurs spécifiées dans le jeu de données réseau :
| String |
Time_Units (Facultatif) | Précisez les unités que vous souhaitez utiliser pour mesurer et afficher le temps de trajet total entre chaque paire origine-destination. Les choix suivants sont disponibles :
| String |
Distance_Units (Facultatif) | Précisez les unités que vous souhaitez utiliser pour mesurer et afficher la distance totale à parcourir entre chaque paire origine-destination. Les choix suivants sont disponibles :
| String |
Number_of_Destinations_to_Find (Facultatif) | Indiquez le nombre maximum de destinations à rechercher par origine. Si aucune valeur n'est indiquée pour ce paramètre, la matrice en sortie inclut les coûts de déplacement depuis chaque origine vers chaque destination. Chaque origine peut posséder sa propre valeur (spécifiée comme champ TargetDestinationCount) qui remplace la valeur du paramètre Number of Destinations to Find (Nombre de destinations à rechercher). | Long |
Cutoff (Facultatif) | Spécifiez la valeur du temps de trajet ou de la distance à parcourir à laquelle cesser la recherche de destinations depuis une origine donnée. Toute destination située au-delà de la valeur limite ne sera pas prise en compte. Chaque origine peut posséder sa propre valeur (spécifiée comme champ Cutoff) qui remplace la valeur du paramètre Cutoff (Limite). La valeur doit respecter les unités spécifiées par le paramètre Unités de tempssi l'attribut d'impédance de votre mode de déplacement repose sur le temps ou les unités spécifiées par le paramètre Unités de distance si l'attribut d'impédance de votre mode de déplacement repose sur la distance. Si aucune valeur n'est spécifiée, l'outil n'applique aucune limite de temps de trajet ou de distance à parcourir lors de la recherche de destinations. | Double |
Time_of_Day (Facultatif) | Spécifie l'heure et la date auxquelles les itinéraires doivent commencer. Si votre jeu de données réseau contient des données de trafic réel ou historique, le fait de spécifier une heure permet une estimation plus précise de la durée du trajet entre les arrêts, car elle tient compte des conditions de circulation applicables à la date et à l'heure spécifiées. Le paramètre Fuseau horaire de l'heure de la journée spécifie si cette heure et cette date correspondent à l'heure UTC ou au fuseau horaire dans lequel l'arrêt se trouve. L'outil ignore ce paramètre lorsque le paramètre Unités de mesure n'est pas défini sur une unité temporelle. | Date |
Time_Zone_for_Time_of_Day (Facultatif) | Spécifie le fuseau horaire du paramètre Heure du jour.
| String |
Point_Barriers (Facultatif) | Spécifie les interruptions ponctuelles qui sont divisées en deux types : les interruptions ponctuelles de restriction et les interruptions ponctuelles à coût ajouté. Elles restreignent temporairement la traversée de points sur le réseau ou leur ajoutent une impédance. Les interruptions ponctuelles sont définies par un jeu d'entités, et les valeurs attributaires que vous spécifiez pour les entités ponctuelles déterminent s'il s'agit d'interruptions de restriction ou d'interruptions à coût ajouté. Les champs de la table attributaire sont répertoriés et décrits ci-dessous. ObjectID: Champ d'ID géré par le système. Shape: Champ de géométrie qui indique l'emplacement géographique de l'objet d'analyse de réseau. Name: Nom de l'interruption. BarrierType : Spécifie si l'interruption restreint entièrement le trajet ou ajoute un coût de parcours correspondant. Deux options sont disponibles :
Utilisez la valeur 0 pour l'option Restriction et 2 pour Coût ajouté. Additional_Time: Indique le temps de trajet ajouté lorsque l'interruption est franchie. Ce champ est actif uniquement pour les interruptions à coût ajouté et uniquement si les unités de mesure sont temporelles. Cette valeur de champ doit être supérieure ou égale à zéro et ses unités identiques à celles spécifiées dans le paramètre Unités de mesure. Additional_Distance: Indique la distance ajoutée lorsque l'interruption est franchie. Ce champ est actif uniquement pour les interruptions à coût ajouté et uniquement si les unités de mesure sont basées sur la distance. La valeur de champ doit être supérieure ou égale à zéro et ses unités identiques à celles spécifiées dans le paramètre Unités de mesure. | Feature Set |
Line_Barriers (Facultatif) | Spécifie les interruptions linéaires qui restreignent temporairement leur passage. Les interruptions linéaires sont définies par un jeu d'entités. Les champs de la table attributaire sont répertoriés et décrits ci-dessous. ObjectID: Champ d'ID géré par le système. Shape: Champ de géométrie qui indique l'emplacement géographique de l'objet d'analyse de réseau. Name: Nom de l'interruption. | Feature Set |
Polygon_Barriers (Facultatif) | Spécifie les interruptions polygonales qui sont divisées en deux types : les interruptions polygonales de restriction et les interruptions polygonales à coût proportionné. Elles restreignent temporairement la traversée des parties du réseau qu'elles couvrent ou proportionnent leur impédance. Les interruptions polygonales sont définies par un jeu d'entités, et les valeurs attributaires que vous spécifiez pour les entités surfaciques déterminent s'il s'agit d'interruptions de restriction ou d'interruptions à coût proportionné. Les champs de la table attributaire sont répertoriés et décrits ci-dessous. ObjectID: Champ d'ID géré par le système. Shape: Champ de géométrie qui indique l'emplacement géographique de l'objet d'analyse de réseau. Name: Nom de l'interruption. BarrierType : Spécifie si la barrière restreint entièrement le trajet ou proportionne son coût de parcours correspondant. Deux options sont disponibles :
Utilisez la valeur 0 pour l'option Restriction et 1 pour Coût proportionné. ScaledTimeFactor: Il s'agit du facteur de multiplication du temps de trajet des rues intersectées par l'interruption. Ce champ est actif uniquement pour les interruptions à coût proportionné et uniquement si les unités de mesure sont temporelles. La valeur du champ doit être supérieure à zéro. ScaledDistanceFactor: Il s'agit du facteur de multiplication de la distance des rues intersectées par l'interruption. Cet attribut est actif uniquement pour les interruptions à coût proportionné et uniquement si les unités de mesure sont basées sur la distance. La valeur de l'attribut doit être supérieure à zéro. | Feature Set |
Impedance_Attribute (Facultatif) | L'attribut de coût à utiliser comme impédance dans l'analyse. | String |
Impedance_Attribute_Units (Facultatif) | Les unités de l'attribut d'impédance du réseau spécifiées par le paramètre Attribut d'impédance. Il s'agit simplement d'un paramètre d'information qui ne peut pas être modifié sans mise à jour directe du jeu de données réseau. Il est également inutile de le modifier, car les conversions entre les unités de mesure et l'attribut de coût sont gérées à votre place. La valeur de ce paramètre est remplacée lorsque le paramètre Mode de déplacement est défini sur une valeur autre que Personnalisé. | String |
Time_Attribute (Facultatif) | Définit l’attribut de coût de réseau à utiliser lorsque la valeur des unités de mesure est une unité de temps. L'outil effectue la conversion des unités de temps nécessaire lorsque la valeur des unités de mesure diffère des unités de l'attribut de coût défini ici. En d'autres termes, les unités de temps de l'attribut de coût de réseau et de la limite par défaut ne doivent pas nécessairement être identiques. La valeur de ce paramètre est remplacée lorsque le paramètre Mode de déplacement (Travel_Mode dans Python) est défini sur une valeur autre que Personnalisé. | String |
Time_Attribute_Units (Facultatif) | Unités de l'attribut de temps. Vous pouvez explicitement définir les unités des attributs de temps, mais il est recommandé de ne rien transmettre ou de transmettre "#" et de laisser le solveur déterminer les unités. La valeur de ce paramètre est remplacée lorsque le paramètre Travel_Mode est défini sur une valeur autre que CUSTOM. | String |
Distance_Attribute (Facultatif) | Définit l'attribut de coût de réseau à utiliser lorsque la valeur des unités de mesure est une unité de distance. L'outil effectue la conversion des unités de distance nécessaire lorsque la valeur des unités de mesure diffère des unités de l'attribut de coût défini ici. En d’autres termes, les unités de mesure et les unités de distance de l’attribut de coût de réseau ne doivent pas nécessairement être identiques. La valeur de ce paramètre est remplacée lorsque le paramètre Mode de déplacement (Travel_Mode dans Python) est défini sur une valeur autre que Personnalisé. | String |
Distance_Attribute_Units (Facultatif) | Unités de l'attribut de distance. Vous pouvez explicitement définir les unités des attributs de distance, mais il est recommandé de ne rien transmettre ou de transmettre "#" et de laisser le solveur déterminer les unités. La valeur de ce paramètre est remplacée lorsque le paramètre Travel_Mode est défini sur une valeur autre que CUSTOM. | String |
UTurn_Policy (Facultatif) | Règle de demi-tour aux jonctions. L'autorisation des demi-tours implique que le solveur puisse faire demi-tour au niveau d'une jonction et revenir en arrière par la même rue. Étant donné que les jonctions représentent des intersections de rues et des voies sans issue, différents véhicules peuvent être en mesure de faire demi-tour à certaines jonctions mais pas à d’autres – selon que la jonction représente une intersection ou une voie sans issue. Pour en tenir compte, le paramètre de règle de demi-tour est spécifié implicitement par le nombre de tronçons connectés, ou de rues, à la jonction, également connu sous le nom de « valence de jonction ». Les valeurs acceptables pour ce paramètre sont répertoriées ci-dessous ; chacune est suivie d'une description de sa signification en termes de valence de jonction.
La valeur de ce paramètre est remplacée lorsque le paramètre Mode de déplacement (Travel_Mode dans Python) est défini sur une valeur autre que Personnalisé. | String |
Use_Hierarchy_in_Analysis (Facultatif) | Indiquez si vous souhaitez utiliser une hiérarchie lorsque vous recherchez les itinéraires les plus courts entre les points.
Le paramètre n'est pas utilisé si aucun attribut de hiérarchie n'est défini dans le jeu de données réseau utilisé pour effectuer l'analyse. Dans ces cas, utilisez "#" comme valeur de paramètre. Vous pouvez utiliser le paramètre Force_Hierarchy_Beyond_Distance pour contraindre le solveur à utiliser la hiérarchie même si l'option Use_Hierarchy_in_Analysis est définie sur False. Ce paramètre est ignoré sauf si le paramètre Travel_Mode est défini sur CUSTOM. Lorsque vous modélisez un mode de marche à pied personnalisé, il est recommandé de désactiver la hiérarchie, car elle est conçue pour les véhicules motorisés. | Boolean |
Restrictions [restriction,...] (Facultatif) | Indique quels attributs de restriction réseau sont respectés lors de l'analyse. La valeur de ce paramètre est remplacée lorsque le paramètre Mode de déplacement (Travel_Mode dans Python) est défini sur une valeur autre que Personnalisé. | String |
Attribute_Parameter_Values (Facultatif) | Spécifie les valeurs de paramètre des attributs de réseau possédant des paramètres. Le jeu d’enregistrements comporte deux colonnes qui permettent d’identifier les paramètres de manière unique et une autre colonne qui spécifie la valeur du paramètre. La valeur de ce paramètre est remplacée lorsque le paramètre Mode de déplacement (Travel_Mode dans Python) est défini sur une valeur autre que Personnalisé. Le jeu d'enregistrements des valeurs de paramètre est associé à des attributs. Les champs de la table attributaire sont répertoriés et décrits ci-dessous. ObjectID: Champ d'ID géré par le système. AttributeName : Nom de l'attribut de réseau dont le paramètre d'attribut est défini par la ligne de table. ParameterName : Nom du paramètre d'attribut dont la valeur est définie par la ligne de table. (Les paramètres de type Objet ne peuvent pas être mis à jour à l’aide de cet outil.) ParameterValue : Valeur à utiliser pour le paramètre d'attribut. Si aucune valeur n'est spécifiée, le paramètre d'attribut est défini comme étant Null. | Record Set |
Accumulate_Attributes [attribute,...] (Facultatif) | Liste des attributs de coût à cumuler lors de l'analyse. Ces attributs d'accumulation sont fournis à titre de référence uniquement. Le solveur utilise uniquement l'attribut de coût spécifié par le paramètre Attribut de temps (Time_Attribute dans Python) ou Attribut de distance (Distance_Attribute dans Python) pour calculer les plus courts chemins. Pour chaque attribut de coût accumulé, un champ Total_[attribut] est ajouté aux itinéraires générés en sortie par le solveur. | String |
Maximum_Snap_Tolerance (Facultatif) | La tolérance de capture maximale spécifie la distance maximale recherchée par Network Analyst pour placer ou replacer un point sur le réseau. Network Analyst recherche des tronçons ou jonctions appropriés et capture le point sur l'élément le plus proche. Si aucun emplacement approprié n'est trouvé dans la tolérance de capture maximale, l'objet est marqué comme étant non localisé. | Linear unit |
Feature_Locator_WHERE_Clause (Facultatif) | Expression SQL utilisée pour sélectionner un sous-ensemble d'entités source qui limite les éléments de réseau sur lesquels les arrêts peuvent être placés. La syntaxe de ce paramètre comprend deux parties : la première est le nom de la classe d'entités source (suivi d'un espace) et la seconde est l'expression SQL. Pour écrire une expression SQL pour deux classes d'entités source ou plus, séparez-les par un point-virgule. Pour éviter que les ressources ne soient placées sur des autoroutes à accès limité, par exemple, écrivez une expression SQL telle que la suivant pour exclure ces entités source : "Streets" "FUNC_CLASS not in('1', '2')". A noter que les interruptions ignorent la clause WHERE du localisateur d'entités lors du chargement. | String |
Origin_Destination_Line_Shape (Facultatif) | Les lignes résultantes d'une matrice de coût OD peuvent être représentées avec une géométrie de ligne droite ou sans aucune géométrie. Dans les deux cas, l'itinéraire est toujours calculé le long du réseau de transport en réduisant le temps de trajet ou la distance à parcourir et jamais en utilisant la distance en ligne droite entre les origines et les destinations.
| String |
Maximum_Features_Affected_by_Point_Barriers (Facultatif) | Limite le nombre d'entités pouvant être affectées par des interruptions ponctuelles. Une valeur Null indique qu'il n'existe pas de limite. | Long |
Maximum_Features_Affected_by_Line_Barriers (Facultatif) | Limite le nombre d'entités pouvant être affectées par des interruptions linéaires. Une valeur Null indique qu'il n'existe pas de limite. | Long |
Maximum_Features_Affected_by_Polygon_Barriers (Facultatif) | Limite le nombre d'entités pouvant être affectées par des interruptions polygonales. Une valeur Null indique qu'il n'existe pas de limite. | Long |
Maximum_Origins | Limite le nombre d'origines pouvant être ajoutées à l'analyse de matrice de coût origine-destination. Ce paramètre permet de contrôler la charge de traitement lors de l'analyse. Par exemple, vous pouvez attribuer une valeur faible à ce paramètre pour une version gratuite du service que vous créez et utiliser une valeur plus élevée pour une version payante du service. Une valeur Null indique qu'il n'existe pas de limite. | Long |
Maximum_Destinations | Limite le nombre de destinations pouvant être ajoutées à l'analyse de matrice de coût origine-destination. Ce paramètre permet de contrôler la charge de traitement lors de l'analyse. Par exemple, vous pouvez attribuer une valeur faible à ce paramètre pour une version gratuite du service que vous créez et utiliser une valeur plus élevée pour une version payante du service. Une valeur Null indique qu'il n'existe pas de limite. | Long |
Force_Hierarchy_Beyond_Distance (Facultatif) | Indique la distance au-delà de laquelle le solveur forcera la hiérarchie, lors du calcul d'itinéraires, même si la hiérarchie n'est pas activée. Les unités de ce paramètre sont les mêmes que celles affichées dans le paramètre Unités des attributs de distance. Le calcul d'itinéraires entre des arrêts qui sont éloignés lors de l'utilisation de la hiérarchie du réseau entraîne généralement moins de traitement que le calcul des mêmes itinéraires sans la hiérarchie. Ce paramètre permet de contrôler la charge de traitement lors de l'analyse. Une valeur Null indique que la hiérarchie ne sera jamais activée ; la valeur du paramètre Utiliser la hiérarchie lors de l’analyse sera toujours respectée. Si le jeu de données réseau en entrée ne prend pas la hiérarchie en charge, une erreur se produit lorsque vous spécifiez une valeur pour ce paramètre. Dans ce cas, vous devez utiliser une valeur Null. Ce paramètre est désactivé, sauf si le jeu de données réseau inclut un attribut de hiérarchie. | Double |
Save_Output_Network_Analysis_Layer (Facultatif) |
Dans tous les cas, les classes d'entités contenant les résultats sont renvoyées. Cependant, un administrateur de serveur peut choisir de générer également une couche d'analyse de réseau pour que la configuration et les résultats de l'outil puissent être débogués à l'aide des commandes de Network Analyst dans l'environnement ArcGIS Desktop. Le processus de débogage peut en être grandement facilité. Dans ArcGIS Desktop, l'emplacement en sortie par défaut de la couche d'analyse de réseau se trouve dans le dossier temporaire. Vous pouvez déterminer l'emplacement du dossier temporaire en évaluant la valeur de l'environnement de géotraitement arcpy.env.scratchFolder. La couche d'analyse de réseau en sortie est stockée en tant que fichier LYR dont le nom commence par _ags_gpna et est suivi d'un GUID alphanumérique. | Boolean |
Overrides (Facultatif) | Spécifiez des paramètres supplémentaires pouvant influencer le comportement du solveur lorsque vous recherchez des solutions pour résoudre les problèmes d'analyse du réseau. La valeur de ce paramètre doit être spécifiée au format JSON (JavaScript Object Notation). Une valeur valide, par exemple, a le format suivant : {"overrideSetting1" : "value1", "overrideSetting2" : "value2"}. Le nom du paramètre de remplacement est toujours spécifié entre des guillemets doubles. Les valeurs peuvent être un nombre, une valeur booléenne ou une chaîne. Par défaut, aucune valeur ne doit être spécifiée pour ce paramètre, ce qui signifie qu'il est déconseillé de remplacer les paramètres du solveur. Les valeurs de remplacement sont des paramètres avancés qui ne doivent être utilisés qu'après une analyse approfondie des résultats obtenus avant et après leur application. Vous pouvez obtenir auprès du support technique d'Esri une liste des paramètres de remplacement pris en charge, ainsi que leurs valeurs acceptables, pour chaque solveur. | string |
Sortie dérivée
Nom | Explication | Type de données |
Solve_Succeeded | Détermine si le service est parvenu à générer la matrice de coût origine-destination. | Booléen |
Output_Origin_Destination_Lines | Itinéraires obtenus à partir des origines jusqu’aux destinations. | Jeu d'entités |
Output_Origins | Origines qui ont participé à l’analyse. | Jeu d'entités |
Output_Destinations | Destinations qui ont participé à l’analyse. | Jeu d'entités |
Output_Network_Analysis_Layer | Couche d’analyse de réseau avec des propriétés dont la configuration correspond à celle des paramètres d’outil, pouvant être utilisée pour réaliser d’autres analyses ou des opérations de débogage sur la carte. | Fichier |
Exemple de code
Exemple 1 d'utilisation de l'outil GenerateOriginDestinationCostMatrix (fenêtre Python)
Exécutez l'outil avec les paramètres requis.
origins = arcpy.FeatureSet()
origins.load("Warehouses")
destinations = arcpy.FeatureSet()
destinations.load("Stores")
arcpy.na.GenerateOriginDestinationCostMAtrix(origins, destinations, "ParisMultimodal_ND")
Exemple 2 d'utilisation de l'outil GenerateOriginDestinationCostMatrix (script autonome)
Le script Python ci-dessous illustre l'utilisation de l'outil via un script autonome.
# Name: GenerateOriginDestinationCostMatrix_Workflow.py
# Description: Find and measure the least-cost paths along the network from multiple
# origins to multiple destinations.
# Requirements: Network Analyst Extension
#Import system modules
import arcpy
from arcpy import env
try:
#Check out the Network Analyst extension license
arcpy.CheckOutExtension('Network')
#Set environment settings
env.workspace = 'C:/arcgis/ArcTutor/Network Analyst/Tutorial/Paris.gdb'
env.overwriteOutput = True
#Set local variables
inOrigins = 'Analysis/Warehouses'
inDestinations = 'Analysis/Stores'
inNetworkDataset = 'Transportation/ParisMultimodal_ND'
outGeodatabase = 'C:/arcgis/ArcTutor/Network Analyst/Tutorial/Output.gdb'
# Run GenerateODCostMatrix
arcpy.na.GenerateOriginDestinationCostMatrix(inOrigins, inDestinations, inNetworkDataset, outGeodatabase,
Cutoff=10, Origin_Destination_Line_Shape='STRAIGHT_LINES')
print 'Script completed successfully'
except Exception as e:
# If an error occurred, print line number and error message
import traceback, sys
tb = sys.exc_info()[2]
print 'An error occured on line %i' % tb.tb_lineno
print str(e)
Environnements
Informations de licence
- Basic: Requiert Network Analyst
- Standard: Requiert Network Analyst
- Advanced: Requiert Network Analyst