Résoudre (Outils Network Analyst)

Résumé

Résout le problème de la couche d’analyse de réseau en fonction de ses données en entrée et de ses paramètres d’analyse. La sortie de résolution est ajoutée à la couche d’analyse de réseau et peut être examinée sur la carte et dans les tables attributaire, puis utilisée pour une analyse ultérieure.

Utilisation

Cet outil est généralement utilisé dans le cadre d’un processus d’analyse de réseau.

En savoir plus sur le processus de la couche d’analyse de réseau
Lorsque la résolution échoue, les messages d’erreur et d’avertissement fournissent des informations utiles concernant les raisons de l’échec.
Lorsque la couche d’analyse de réseau en entrée référence ArcGIS Online ou un portail ArcGIS Enterprise dont les services de calcul d’itinéraire sont configurés avec ArcGIS Online, la réalisation d’une analyse consomme des crédits et est soumise à certaines limites, telles que le nombre d’entrées autorisées.

En savoir plus sur la consommation de crédits et les limites de l’analyse de réseau
Bien que cet outil puisse être utilisé dans un script Python, la meilleure pratique pour effectuer une analyse de réseau dans Python consiste à lui préférer les classes du solveur dans le module arcpy.nax.

En savoir plus sur l’analyse de réseau dans Python.

Etiqueter	Explication	Type de données
Couche d’analyse de réseau en entrée	Couche d’analyse de réseau sur laquelle l’analyse est calculée.	Network Analyst Layer
Ignorer les localisations non valides (Facultatif)	Détermine si les localisations en entrée non valides sont ignorées. Généralement, les localisations ne sont pas valides si elles sont impossibles à localiser sur le réseau. Lorsque les emplacements non valides sont ignorés, le solveur les ignore et tente de réaliser l’analyse avec les emplacements restants. La valeur par défaut correspond au paramètre Ignore Invalid Locations at Solve Time (Ignorer les localisations non valides lors de la résolution) sur la valeur Input Network Analysis Layer (Couche d’analyse de réseau en entrée) désignée. Activé—Les emplacements en entrée non valides sont ignorés et seuls les emplacements valides sont utilisés. Décoché—Tous les emplacements en entrée sont utilisés. Les emplacements non valides provoquent l’échec de la résolution.	Boolean
Terminer sur une erreur de résolution (Facultatif)	Détermine si l’outil arrête de s’exécuter et se ferme si une erreur est rencontrée lors de la résolution. Activé—L’outil arrête de s’exécuter et se ferme lorsque le solveur rencontre une erreur. Il s’agit de l’option par défaut. Décoché—L’outil n’échoue pas et poursuit son exécution lorsque le solveur rencontre une erreur. Tous les messages d’erreur renvoyés par le solveur sont convertis en messages d’avertissement.	Boolean
Tolérance de simplification (Facultatif)	Tolérance qui détermine le degré de simplification pour la géométrie en sortie. Si elle est spécifiée, la tolérance doit être supérieure à zéro. Vous pouvez choisir une unité préférée. L’unité par défaut correspond aux degrés décimaux. La spécification d’une tolérance de simplification a tendance à réduire le temps nécessaire pour afficher des itinéraires ou des zones de desserte. L’inconvénient de cela, toutefois, est que la simplification de la géométrie supprime des sommets, ce qui peut amoindrir la précision spatiale de la sortie à plus grande échelle. Étant donné qu’une ligne dotée de seulement deux sommets ne peut pas être simplifiée, ce paramètre n’a aucun effet sur la durée d’affichage d’une sortie composée de segments simples, telle que des itinéraires en lignes droites, les lignes d’une matrice de coût OD ou des lignes de localisation-allocation.	Linear Unit
Débrayages (Facultatif)	Remarque : Ce paramètre n’est destiné qu’à un usage interne.	String

Sortie dérivée

Etiqueter	Explication	Type de données
Couche Network Analyst	Couche d’analyse de réseau résolue.	Network Analyst Layer
Erreur résolue	Opérateur booléen indiquant si la résolution a réussi.	Boolean

arcpy.na.Solve(in_network_analysis_layer, {ignore_invalids}, {terminate_on_solve_error}, {simplification_tolerance}, {overrides})

Nom	Explication	Type de données
in_network_analysis_layer	Couche d’analyse de réseau sur laquelle l’analyse est calculée.	Network Analyst Layer
ignore_invalids (Facultatif)	Détermine si les localisations en entrée non valides sont ignorées. Généralement, les localisations ne sont pas valides si elles sont impossibles à localiser sur le réseau. Lorsque les emplacements non valides sont ignorés, le solveur les ignore et tente de réaliser l’analyse avec les emplacements restants. La valeur par défaut correspond à la propriété `ignoreInvalidLocations` de la valeur `in_network_analysis_layer` désignée. `SKIP`—Les emplacements en entrée non valides sont ignorés et seuls les emplacements valides sont utilisés. `HALT`—Tous les emplacements en entrée sont utilisés. Les emplacements non valides provoquent l’échec de la résolution.	Boolean
terminate_on_solve_error (Facultatif)	Détermine si l’outil arrête de s’exécuter et se ferme si une erreur est rencontrée lors de la résolution. `TERMINATE`—L’outil arrête de s’exécuter et se ferme lorsque le solveur rencontre une erreur. Il s’agit de l’option par défaut. Lorsque vous utilisez cette option, l’objet `Result` n’est pas créé si l’outil se ferme en raison d’une erreur du solveur. Examinez les messages de géotraitement de l’objet ArcPy. `CONTINUE`—L’outil n’échoue pas et poursuit son exécution lorsque le solveur rencontre une erreur. Tous les messages d’erreur renvoyés par le solveur sont convertis en messages d’avertissement. Lorsque vous utilisez cette option, l’objet `Result` est toujours créé et la propriété `maxSeverity` de l’objet `Result` est définie sur 1. Utilisez la méthode `getOutput` de l’objet `Result` avec une valeur d’index égale à 1 pour déterminer si le solveur a produit les résultats attendus.	Boolean
simplification_tolerance (Facultatif)	Tolérance qui détermine le degré de simplification pour la géométrie en sortie. Si elle est spécifiée, la tolérance doit être supérieure à zéro. Vous pouvez choisir une unité préférée. L’unité par défaut correspond aux degrés décimaux. La spécification d’une tolérance de simplification a tendance à réduire le temps nécessaire pour afficher des itinéraires ou des zones de desserte. L’inconvénient de cela, toutefois, est que la simplification de la géométrie supprime des sommets, ce qui peut amoindrir la précision spatiale de la sortie à plus grande échelle. Étant donné qu’une ligne dotée de seulement deux sommets ne peut pas être simplifiée, ce paramètre n’a aucun effet sur la durée d’affichage d’une sortie composée de segments simples, telle que des itinéraires en lignes droites, les lignes d’une matrice de coût OD ou des lignes de localisation-allocation.	Linear Unit
overrides (Facultatif)	Remarque : Ce paramètre n’est destiné qu’à un usage interne.	String

Sortie dérivée

Nom	Explication	Type de données
output_layer	Couche d’analyse de réseau résolue.	Network Analyst Layer
solve_succeeded	Opérateur booléen indiquant si la résolution a réussi.	Boolean

Exemple de code

Conseil :

Bien que cet outil puisse être utilisé dans un script Python, la meilleure pratique pour effectuer une analyse de réseau dans Python consiste à lui préférer les classes du solveur dans le module arcpy.nax. En savoir plus sur l’analyse de réseau dans Python.

Exemple 1 d’utilisation de la fonction Solve (fenêtre Python)

Exécutez l’outil avec tous les paramètres.

arcpy.na.Solve("Route", "HALT", "TERMINATE", "10 Meters")

Exemple 2 d’utilisation de la fonction Solve (processus)

Le script Python autonome suivant illustre l’utilisation de la fonction Solve pour effectuer une analyse de la ressource la plus proche et enregistrer les résultats dans un fichier de couches.

# Name: Solve_Workflow.py
# Description: Solve a closest facility analysis to find the closest warehouse
#              from the store locations and save the results to a layer file on
#              disk.
# Requirements: Network Analyst extension

#Import system modules
import arcpy
from arcpy import env
import os

try:
    #Set environment settings
    output_dir = "C:/Data"
    #The NA layer's data will be saved to the workspace specified here
    env.workspace = os.path.join(output_dir, "Output.gdb")
    env.overwriteOutput = True

    #Set local variables
    input_gdb = "C:/Data/Paris.gdb"
    network = os.path.join(input_gdb, "Transportation", "ParisMultimodal_ND")
    layer_name = "ClosestWarehouse"
    travel_mode = "Driving Time"
    facilities = os.path.join(input_gdb, "Analysis", "Warehouses")
    incidents = os.path.join(input_gdb, "Analysis", "Stores")
    output_layer_file = os.path.join(output_dir, layer_name + ".lyrx")

    #Create a new closest facility analysis layer.
    result_object = arcpy.na.MakeClosestFacilityAnalysisLayer(network,
                                            layer_name, travel_mode,
                                            "TO_FACILITIES",
                                            number_of_facilities_to_find=1)

    #Get the layer object from the result object. The closest facility layer can
    #now be referenced using the layer object.
    layer_object = result_object.getOutput(0)

    #Get the names of all the sublayers within the closest facility layer.
    sublayer_names = arcpy.na.GetNAClassNames(layer_object)
    #Stores the layer names that we will use later
    facilities_layer_name = sublayer_names["Facilities"]
    incidents_layer_name = sublayer_names["Incidents"]

    #Load the warehouses as Facilities using the default field mappings and
    #search tolerance
    arcpy.na.AddLocations(layer_object, facilities_layer_name,
                            facilities, "", "")

    #Load the stores as Incidents. Map the Name property from the NOM field
    #using field mappings
    field_mappings = arcpy.na.NAClassFieldMappings(layer_object,
                                                    incidents_layer_name)
    field_mappings["Name"].mappedFieldName = "NOM"
    arcpy.na.AddLocations(layer_object, incidents_layer_name, incidents,
                          field_mappings, "")

    #Solve the closest facility layer
    arcpy.na.Solve(layer_object)

    #Save the solved closest facility layer as a layer file on disk
    layer_object.saveACopy(output_layer_file)

    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 occurred on line %i" % tb.tb_lineno)
    print(str(e))

Environnements

Espace de travail courant

Informations de licence

Basic: Limité
Cet outil nécessite la licence Network Analyst si la source de données réseau de la couche résolue est un jeu de données réseau, mais pas si la source de données réseau est un service.
Standard: Limité
Cet outil nécessite la licence Network Analyst si la source de données réseau de la couche résolue est un jeu de données réseau, mais pas si la source de données réseau est un service.
Advanced: Limité
Cet outil nécessite la licence Network Analyst si la source de données réseau de la couche résolue est un jeu de données réseau, mais pas si la source de données réseau est un service.

Résoudre (Outils Network Analyst)

Résumé

Utilisation

Paramètres

Remarque :

Sortie dérivée

Environnements

Informations de licence

Rubriques connexes