Résumé
Crée une couche d'analyse de réseau emplacement-attribution et définit ses propriétés d'analyse. Une couche d'analyse d'emplacement-allocation est utile pour sélectionner un nombre donné de ressources dans un ensemble de localisations potentielles de manière qu'une demande soit allouée aux ressources de façon optimale et efficace. La couche peut être créée à l'aide d'un jeu de données réseau local ou d'un service hébergé en ligne ou sur un portail.
Utilisation
Après avoir créé la couche d'analyse avec cet outil, vous pouvez ajouter des objets d'analyse de réseau à l'aide de l'outil Ajouter des localisations, résoudre l'analyse à l'aide de l'outil Calculer et enregistrer les résultats sur le disque à l'aide de l'outil Enregistrer dans un fichier de couche.
Lorsque vous utilisez cet outil dans des modèles de géotraitement, si le modèle est exécuté en tant qu'outil, la couche d'analyse de réseau en sortie doit être convertie en paramètre de modèle. Dans le cas contraire, la couche en sortie n'est pas ajoutée au contenu de la carte.
Dans ArcGIS Pro, les données des couches d’analyse de réseau sont stockées sur disque dans des classes d’entités de géodatabase fichier. Lorsque vous créez une couche d’analyse de réseau dans un projet, les données de cette couche sont créées dans un nouveau jeu de classes d’entités dans l’environnement Espace de travail courant. Lorsque vous créez une couche d’analyse de réseau dans un script Python, vous devez commencer par définir de façon explicite l’environnement de l’espace de travail sur une géodatabase fichier dans laquelle vous voulez stocker les données de la couche à l’aide de arcpy.env.workspace = "<path to file gdb>". Lorsque la couche est créée, un nouveau jeu de données d'entité contenant les classes d'entités de sous-couche appropriées est ajouté à cette géodatabase fichier.
Syntaxe
arcpy.na.MakeLocationAllocationAnalysisLayer(network_data_source, {layer_name}, {travel_mode}, {travel_direction}, {problem_type}, {cutoff}, {number_of_facilities_to_find}, {decay_function_type}, {decay_function_parameter_value}, {target_market_share}, {capacity}, {time_of_day}, {time_zone}, {line_shape}, {accumulate_attributes})| Paramètre | Explication | Type de données |
network_data_source | Jeu de données réseau ou service sur lequel l'analyse du réseau est effectuée. Utilisez l'URL du portail pour un service. | Network Dataset Layer;String |
layer_name (Facultatif) | Nom de la couche d’analyse de réseau à créer. | String |
travel_mode (Facultatif) | Nom du mode de déplacement à utiliser dans l’analyse. Le mode de déplacement représente une collection de paramètres réseau, tels que des restrictions de circulation et des règles de demi-tour, qui détermine la façon dont un piéton, une voiture, un camion ou un autre mode de transport se déplace sur le réseau. Les modes de déplacement sont définis dans votre source de données de réseau. Vous pouvez aussi utiliser un objet arcpy.na.TravelMode et une chaîne contenant la représentation JSON valide d’un mode de déplacement en entrée du paramètre. | String |
travel_direction (Facultatif) | Précise la direction de déplacement entre ressources et points de demande lors du calcul des coûts du réseau.
Cette option peut affecter l'attribution des points de demande aux ressources d'un réseau avec des restrictions unilatérales et des impédances différentes selon la direction de déplacement. Par exemple, un point de demande peut être situé à 15 minutes de trajet d'une ressource, mais le trajet peut demander seulement 10 minutes en circulant en sens inverse (de la ressource vers le point de demande). | String |
problem_type (Facultatif) | Type de problème à résoudre. Le choix du type de problème dépend du genre de ressource localisée. Différents genres de ressources ont des priorités et des contraintes différentes.
| String |
cutoff (Facultatif) | Impédance maximale à laquelle un point de demande peut être alloué à une ressource, dans les unités de l'attribut d'impédance utilisé pour le Mode de déplacement choisi. L'impédance maximale est mesurée par le chemin de moindre coût le long du réseau. Si un point de demande est situé à l'extérieur de la limite, il reste non alloué. Cette propriété peut permettre de modéliser la distance maximale que les gens sont disposés à parcourir pour accéder à vos magasins ou la durée maximale autorisée pour un service des pompiers pour atteindre toute personne de la communauté. Vous pouvez remplacer cette limite point de demande par point de demande en spécifiant des valeurs de limites individuelles dans la sous-couche des points de demande de la propriété Cutoff_[Impédance]. Vous pouvez par exemple déterminer que les habitants des zones rurales sont prêts à faire jusqu'à 10 miles pour atteindre une ressource, tandis que les citadins sont uniquement prêts à faire jusqu'à 2 miles. Vous pouvez modéliser ce comportement en définissant la valeur Limite de la couche d'analyse sur 10 et la valeur Cutoff_Miles de chaque point de demande d'une zone urbaine sur 2. Par défaut, aucune limite n'est utilisée pour l'analyse. | Double |
number_of_facilities_to_find (Facultatif) | Spécifie le nombre des ressources que le solveur doit localiser. Par défaut, ce paramètre est défini sur 1. Les ressources présentant une propriété FacilityType de valeur Requis font toujours partie de la solution lorsque le nombre de ressources à rechercher est supérieur au nombre de ressources requises ; toutes les ressources à sélectionner supplémentaires sont choisies parmi les ressources candidates. Toute ressource ayant une propriété FacilityType de valeur Choix avant le calcul est traitée comme les ressources candidates lors de la recherche. La valeur du paramètre n'est pas prise en compte pour le type de problème MINIMIZE_FACILITIES, puisque le solveur détermine le nombre minimum de ressources à localiser pour optimiser la couverture. La valeur du paramètre est remplacée pour le type de problème TARGET_MARKET_SHARE, car le solveur recherche le nombre minimum de ressources requises pour capturer la part de marché spécifiée. | Long |
decay_function_type (Facultatif) | Définit l'équation pour la transformation du coût du réseau entre les ressources et les points de demande. Cette propriété, associée à la Valeur du paramètre de la fonction de désintégration, spécifie l'importance de l'influence de l'impédance du réseau entre les ressources et les points de demande sur le choix de ressources du solveur.
Les points de demande disposent d'une propriété ImpedanceTransformation qui, si elle est définie, remplace la propriété Valeur du paramètre de la fonction de désintégration de la couche d'analyse, point de demande par point de demande. Vous pouvez déterminer que la fonction de désintégration doit être différente pour les ruraux et les citadins. Vous pouvez modéliser ceci en définissant la transformation d'impédance de la couche d'analyse de manière à ce qu'elle corresponde à celle des résidents ruraux et en définissant la transformation d'impédance des points de demande individuels situés dans les zones urbaines de manière à ce qu'elle corresponde à celle des citadins. | String |
decay_function_parameter_value (Facultatif) | Fournit une valeur de paramètre aux équations spécifiées dans le paramètre decay_function_type. La valeur de paramètre est ignorée lorsque la fonction de désintégration est de type LINEAR. Pour les fonctions de désintégration POWER et EXPONENTIAL, la valeur doit être différente de zéro. Les points de demande disposent d'une propriété ImpedanceTransformation qui, si elle est définie, remplace la propriété decay_function_parameter_value de la couche d'analyse, point de demande par point de demande. Vous pouvez déterminer que la fonction de désintégration doit être différente pour les ruraux et les citadins. Vous pouvez modéliser ceci en définissant la transformation d'impédance de la couche d'analyse de manière à ce qu'elle corresponde à celle des résidents ruraux et en définissant la transformation d'impédance des points de demande individuels situés dans les zones urbaines de manière à ce qu'elle corresponde à celle des citadins. | Double |
target_market_share (Facultatif) | Spécifie la part de marché cible en pourcentage pour laquelle effectuer l'analyse lorsque le paramètre problem_type est défini sur TARGET_MARKET_SHARE. Il s'agit du pourcentage de la pondération de demande totale à capturer par vos ressources de solution. Le solveur sélectionne le nombre minimal de ressources requis pour capturer la part de marché cible spécifiée par cette valeur numérique. | Double |
capacity (Facultatif) | Spécifie la capacité par défaut des ressources lorsque le paramètre problem_type est défini sur MAXIMIZE_CAPACITATED_COVERAGE. Ce paramètre est ignoré pour tous les autres types de problème. Les ressources ont une propriété Capacité qui, lorsqu'elle est définie sur une valeur non nulle, remplace le paramètre capacity correspondant. | Double |
time_of_day (Facultatif) | Indique l'heure et la date de départ. L'heure de départ peut être définie à partir des ressources ou des points de demande, selon que le Sens de déplacement s'effectue de la demande vers la ressource ou de la ressource vers la demande. Si vous avez choisi un attribut d'impédance basé sur la circulation, l'analyse est effectuée selon des conditions de circulation dynamiques correspondant à l'heure du jour spécifiée ici. Une date et une heure peuvent être spécifiées sous la forme 5/14/2012 10:30 AM. Au lieu d'utiliser une date particulière, un jour de la semaine peut être spécifié à l'aide des dates suivantes :
| Date |
time_zone (Facultatif) | Fuseau horaire du paramètre Time of Day (Heure du jour).
| String |
line_shape (Facultatif) |
Indépendamment du type de forme en sortie choisi, le meilleur itinéraire est toujours déterminé par l'impédance du réseau, jamais par la distance euclidienne. Cela signifie que seules les formes d'itinéraire sont différentes, pas le parcours du réseau sous-jacent. | String |
accumulate_attributes [accumulate_attributes,...] (Facultatif) | Liste des attributs de coût à cumuler lors de l’analyse. Ces attributs accumulés servent uniquement de référence. Le solveur utilise uniquement l’attribut de coût utilisé par le mode de déplacement désigné pour la réalisation de l’analyse. Pour chaque attribut de coût accumulé, une propriété Total_[Impédance] est renseignée dans les entités en sortie de l’analyse du réseau. Ce paramètre n’est pas disponible si la source de données réseau est un service ArcGIS Online ou si la source de données réseau est un service hébergé sur une version de Portal for ArcGIS qui ne prend pas en charge l’accumulation. | String |
Sortie dérivée
| Nom | Explication | Type de données |
| out_network_analysis_layer | La couche d’analyse de réseau nouvellement créée. | Couche Network Analyst |
Exemple de code
Exécute l'outil uniquement avec les paramètres requis.
network = "C:/Data/SanFrancisco.gdb/Transportation/Streets_ND"
arcpy.na.MakeLocationAllocationAnalysisLayer(network, "StoreLocations")Exécutez l'outil avec tous les paramètres.
network = "C:/Data/SanFrancisco.gdb/Transportation/Streets_ND"
arcpy.na.MakeLocationAllocationAnalysisLayer(network, "NewStores",
"Driving Time", "TO_FACILITIES",
"MAXIMIZE_ATTENDANCE", 3, 5, "POWER", 2, "",
"", "1/1/1900 9:00 AM", "UTC",
"STRAIGHT_LINES", ["TravelTime", "Meters"])Le script Python autonome suivant illustre l'utilisation de l'outil MakeLocationAllocationAnalysisLayer pour sélectionner les emplacements de points de vente susceptibles de générer la plus grande activité pour une chaîne de magasins.
# Name: MakeLocationAllocationAnalysisLayer_Workflow.py
# Description: Choose the store locations that would generate the most business
# for a retail chain. For this scenario, we will perform the
# location-Allocation analysis using the maximize attendance
# problem type.
# Requirements: Network Analyst Extension
#Import system modules
import arcpy
from arcpy import env
import os
try:
#Check out Network Analyst license if available. Fail if the Network Analyst license is not available.
if arcpy.CheckExtension("network") == "Available":
arcpy.CheckOutExtension("network")
else:
raise arcpy.ExecuteError("Network Analyst Extension license is not available.")
#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/SanFrancisco.gdb"
network = os.path.join(input_gdb, "Transportation", "Streets_ND")
layer_name = "NewStoreLocations"
travel_mode = "Driving Time"
facilities = os.path.join(input_gdb, "Analysis", "CandidateStores")
required_facility = os.path.join(input_gdb, "Analysis", "ExistingStore")
demand_points = os.path.join(input_gdb, "Analysis", "TractCentroids")
output_layer_file = os.path.join(output_dir, layer_name + ".lyrx")
#Create a new location-allocation layer. In this case, the demand travels to
#the facility. We wish to find 3 potential store locations out of all the
#candidate store locations using the maximize attendance model.
result_object = arcpy.na.MakeLocationAllocationAnalysisLayer(network,
layer_name, travel_mode, "TO_FACILITIES",
"MAXIMIZE_ATTENDANCE", cutoff=20,
number_of_facilities_to_find=3)
#Get the layer object from the result object. The location-allocation layer
#can now be referenced using the layer object.
layer_object = result_object.getOutput(0)
#Get the names of all the sublayers within the location-allocation layer.
sublayer_names = arcpy.na.GetNAClassNames(layer_object)
#Stores the layer names that we will use later
facilities_layer_name = sublayer_names["Facilities"]
demand_points_layer_name = sublayer_names["DemandPoints"]
#Load the candidate store locations as facilities using default search
#tolerance and field mappings.
arcpy.na.AddLocations(layer_object, facilities_layer_name, facilities, "",
"")
#Load the existing store location as the required facility. Use the field
#mappings to set the facility type to requried. We need to append this
#required facility to existing facilities.
field_mappings = arcpy.na.NAClassFieldMappings(layer_object,
facilities_layer_name)
field_mappings["FacilityType"].defaultValue = 1
arcpy.na.AddLocations(layer_object, facilities_layer_name,
required_facility, field_mappings, "",
append="APPEND")
#Load the tract centroids as demand points using default search tolerance
#Use the field mappings to map the Weight property from POP2000 field.
demand_field_mappings = arcpy.na.NAClassFieldMappings(layer_object,
demand_points_layer_name)
demand_field_mappings["Weight"].mappedFieldName = "POP2000"
arcpy.na.AddLocations(layer_object, demand_points_layer_name, demand_points,
demand_field_mappings, "")
#Solve the location-allocation layer
arcpy.na.Solve(layer_object)
#Save the solved location-allocation 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
Informations de licence
- Basic: Oui
- Standard: Oui
- Advanced: Oui
Vous avez un commentaire à formuler concernant cette rubrique ?