LocationAllocationSolverProperties (arcpy.na)

Récapitulatif

Permet d'accéder aux propriétés d'analyse à partir d'une couche d'analyse de réseau d'emplacement-allocation. La fonction GetSolverProperties permet d'obtenir un objet LocationAllocationSolverProperties à partir d'une couche d'analyse de réseau d'emplacement-allocation.

Discussion

L'objet LocationAllocationSolverProperties 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'emplacement-allocation. L'objet permet de modifier les propriétés d'analyse souhaitées de la couche d'emplacement-allocation, 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'emplacement-allocation à l'aide de l'outil de géotraitement Créer une couche emplacement-attribution. Obtenir l'objet LocationAllocationSolverProperties à partir d'une nouvelle couche de ressource emplacement-allocation 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 LocationAllocationSolverProperties 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
defaultCapacity (Lecture/écriture)	Permet d'obtenir ou de définir la capacité par défaut des ressources lorsque le paramètre d'emplacement-allocation problemType est défini sur MAXIMIZE_CAPACITATED_COVERAGE. Ce paramètre est ignoré pour tous les autres types de problème. La propriété de capacité des ressources, si elle est définie sur une valeur non nulle, a priorité sur le paramètre defaultCapacity de cette ressource, .	Double
facilitiesToFind (Lecture/écriture)	Permet d'obtenir ou de définir le nombre des ressources que le solveur doit localiser. La valeur de la propriété est ignorée si la propriété problemType est définie sur MINIMIZE_FACILITIES puisque le solveur détermine le nombre minimal de ressources à localiser pour optimiser la couverture. La valeur de la propriété est également ignorée si la propriété problemType est définie sur TARGET_MARKET_SHARE, car le solveur recherche le nombre minimal de ressources requises pour capturer la part de marché spécifiée.	Integer
impedance (Lecture/écriture)	Permet d'obtenir ou de définir l'attribut de coût du réseau utilisé en tant qu'impédance.	String
impedanceCutoff (Lecture/écriture)	Permet d'obtenir ou de définir l'impédance maximale à laquelle un point de demande peut être alloué à une ressource.	Double
impedanceParameter (Lecture/écriture)	Permet d'obtenir ou de définir une valeur de paramètre pour les équations spécifiées dans la propriété impedanceTransformation. La valeur de propriété est ignorée lorsque la propriété impedanceTransformation est définie sur LINEAR. La valeur de propriété ne doit pas être nulle.	Double
impedanceTransformation (Lecture/écriture)	Permet d'obtenir ou de définir l'équation pour la transformation du coût du réseau entre les ressources et les points de demande. Cette valeur de propriété, associée à la valeur de propriété impedanceParameter spécifie l'influence de l'impédance du réseau entre les ressources et les points de demande sur le choix de ressources du solveur. Voici une liste des valeurs possibles : LINEAR —L'impédance de réseau transformée entre la ressource et le point de demande est identique à l'impédance de réseau du plus court chemin. Avec cette valeur, la valeur de la propriété impedanceParameter est toujours définie sur un et toute valeur définie pour la propriété impedanceParameter est ignorée. POWER —L'impédance de réseau transformée entre la ressource et le point de demande est égale à l'impédance de réseau du plus court chemin élevée à la puissance indiquée par la valeur de propriété impedanceParameter. Utilisez cette valeur de propriété avec une valeur de la propriété impedanceParameter positive pour donner une pondération plus élevée aux ressources proches. EXPONENTIAL —L'impédance de réseau transformée entre la ressource et le point de demande est égale à la constante mathématique e élevée à la puissance indiquée par l'impédance de réseau du plus court chemin multipliée par la valeur de propriété impedanceParameter. Utilisez cette valeur de propriété avec une valeur de la propriété impedanceParameter positive pour donner une pondération très élevée aux ressources proches.	String
outputPathShape (Lecture/écriture)	Contrôle si les lignes droites permettent de représenter les résultats de l'analyse d'emplacement-allocation. Voici une liste des valeurs possibles : NO_LINES —Aucune ligne n'est créée pour l'analyse en sortie. Cette option est utile lorsque vous disposez d'un grand nombre de points de demande ou de ressources et vous intéressez uniquement à la sortie tabulaire. STRAIGHT_LINES —Les lignes droites qui connectent les ressources de solution à leurs points de demande alloués sont générées.	String
problemType (Lecture/écriture)	Permet d'obtenir ou de définir le type de problème qui sera résolu. 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. Voici une liste des valeurs possibles : MINIMIZE_IMPEDANCE —Cette option résout le problème de l'emplacement de l'entrepôt. Elle sélectionne un ensemble de ressources de manière à minimiser la somme des impédances pondérées (demande à un emplacement multipliée par la ressource la plus proche). Ce type de problème est souvent désigné par le nom de problème P Médian. MAXIMIZE_COVERAGE —Cette option résout le problème de l'emplacement de la caserne de pompiers. Elle sélectionne des ressources de manière que l'intégralité ou le plus grand nombre de demandes se trouve dans une limite d'impédance précisée. MINIMIZE_FACILITIES —Cette option résout le problème de l'emplacement de la caserne de pompiers. Elle sélectionne le nombre minimal de ressources nécessaires pour couvrir toutes les demandes (ou le plus grand nombre) dans une limite d’impédance spécifiée. MAXIMIZE_ATTENDANCE —Cette option résout le problème de l'emplacement d'un magasin de voisinage où la proportion de demande allouée à la ressource la plus proche sélectionnée diminue avec l'augmentation de la distance. L'ensemble de ressources qui maximisent la demande allouée est sélectionné. Une demande située plus loin que la limite d'impédance spécifiée n'affecte pas l'ensemble de ressources sélectionné. MAXIMIZE_MARKET_SHARE —Cette option résout le problème de l'emplacement de ressource compétitif. Elle sélectionne des ressources pour maximiser la part de marché en présence de ressources compétitives. Les concepts de modèle gravitaire permettent de déterminer la proportion de demande allouée à chaque ressource. L'ensemble de ressources qui maximise la demande allouée est sélectionné. TARGET_MARKET_SHARE —Cette option résout le problème de l'emplacement de ressource compétitif. Elle sélectionne des ressources permettant d'atteindre une part de marché cible spécifiée dans la présence de ressources compétitives. Les concepts de modèle gravitaire permettent de déterminer la proportion de demande allouée à chaque ressource. Le nombre minimal de ressources nécessaire pour atteindre la part de marché cible spécifiée est sélectionné.	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 Network Analyst utilisée pour obtenir l'objet des propriétés du solveur. La propriété renvoie toujours la valeur de chaîne Solveur d'emplacement-allocation en cas d'accès depuis un objet LocationAllocationSolverProperties.	String
targetMarketShare (Lecture/écriture)	Permet d'obtenir ou de définir la part de marché cible en pourcentage pour laquelle effectuer l'analyse lorsque la propriété problemType est définie avec la valeur 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. Toute valeur définie pour la propriété facilitiesToFind est ignorée.	Double
timeOfDay (Lecture/écriture)	Permet d'obtenir ou de définir la date et l'heure de départ. Le départ peut être défini à partir des ressources ou des points de demande, selon que le trajet s'effectue de la demande vers la ressource ou de la ressource vers la demande. 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 spécifier que le départ doit avoir lieu à 8h00 vendredi, spécifiez la valeur sous la forme datetime.datetime (1900, 1, 5, 8,0,0).	DateTime
travelDirection (Lecture/écriture)	Contrôle la direction de déplacement entre les ressources et les points de demande lors du calcul des coûts du réseau. Voici une liste des valeurs possibles : FACILITY_TO_DEMAND —La direction de déplacement va des ressources vers les points de demande. DEMAND_TO_FACILITY —La direction de déplacement va des points de demande vers les ressources.	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
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

Exemple de code

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

Le script indique comment mettre à jour le type de problème d'une couche d'analyse de réseau d'emplacement-allocation pour Minimiser les ressources et définir une transformation d'impédance d'alimentation avec un paramètre d'impédance de 2. Il suppose qu'une couche d'emplacement-allocation appelée Couverture de magasins a été créée dans un nouveau document ArcMap d'après le jeu de données du didacticiel réseau pour la région de San Francisco.

#Get the location-allocation layer object from a layer named "Stores Coverage" in
#the table of contents
laLayer = arcpy.mapping.Layer("Stores Coverage")

#Get the solver properties object from the location-allocation layer
solverProps = arcpy.na.GetSolverProperties(laLayer)

#Update the properties for the location-allocation layer using the solver properties
#object
solverProps.problemType = "MINIMIZE_FACILITIES"
solverProps.impedanceTransformation = "POWER"
solverProps.impedanceParameter = 2

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

Le script indique comment choisir des emplacements de magasin qui généreraient le plus gros chiffre d'affaires pour une chaîne à l'aide de l'analyse d'emplacement-allocation. Le script crée d'abord une nouvelle couche d'emplacement-allocation avec les paramètres d'analyse appropriés. À l'étape suivante, les emplacements de magasin candidats et les centroïdes de groupe d'îlots sont chargés en tant que ressources et points de demande, respectivement. L'analyse est résolue et enregistrée dans un fichier de couches. Deux analyses suivantes sont effectuées en modifiant les propriétés d'analyse à l'aide de l'objet LocationAllocationSolverProperties. Après chaque analyse, la couche est enregistrée en tant que fichier de couches. Le script utilise les données du didacticiel pour la région de San Francisco. La description détaillée du scénario est disponible dans le cadre de l'exercice 9 dans le didacticiel Network Analyst. Le didacticiel vous guide dans ce scénario à l'aide de l'interface utilisateur d'ArcMap, le script fournit un exemple de la façon dont le même scénario peut être automatisé à l'aide d'un script Python.

import arcpy

#Set up the environment
arcpy.env.overwriteOutput = True
arcpy.env.workspace = "C:/data/SanFrancisco.gdb"
arcpy.CheckOutExtension("network")

#Set up variables
networkDataset = "Transportation/Streets_ND"
outNALayerName = "NewStoreLocations"
inFacilities = "Analysis/CandidateStores"
requiredFacility = "Analysis/ExistingStore"
competitorFacility = "Analysis/CompetitorStores"
inDemandPoints = "Analysis/TractCentroids"
outputFolder = "C:/data/output/"

#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.
outNALayer = arcpy.na.MakeLocationAllocationLayer(networkDataset, outNALayerName,
                                                  "TravelTime","DEMAND_TO_FACILITY",
                                                  "MAXIMIZE_ATTENDANCE",3,5,
                                                  "LINEAR")
#Get the layer object from the result object. The location-allocation layer
#can now be referenced using the layer object.
outNALayer = outNALayer.getOutput(0)

#Get the names of all the sublayers within the location-allocation layer.
subLayerNames = arcpy.na.GetNAClassNames(outNALayer)
#Stores the layer names that we will use later
facilitiesLayerName = subLayerNames["Facilities"]
demandPointsLayerName = subLayerNames["DemandPoints"]

#Load the candidate store locations as facilities using default search
#tolerance and field mappings.
arcpy.na.AddLocations(outNALayer, facilitiesLayerName, inFacilities, "", "",
                      exclude_restricted_elements = "EXCLUDE")

#Load the tract centroids as demand points using default search tolerance. Use 
#the field mappings to map the Weight property from POP2000 field.
demandFieldMappings = arcpy.na.NAClassFieldMappings(outNALayer,
                                                    demandPointsLayerName)
demandFieldMappings["Weight"].mappedFieldName = "POP2000"
arcpy.na.AddLocations(outNALayer,demandPointsLayerName ,inDemandPoints,
                      demandFieldMappings, "",
                      exclude_restricted_elements = "EXCLUDE")

#Solve the location-allocation layer
arcpy.na.Solve(outNALayer)
    
#Save the solved location-allocation layer as a layer file on disk with 
#relative paths
outLayerFile = outputFolder + outNALayerName + ".lyr"
arcpy.management.SaveToLayerFile(outNALayer,outLayerFile,"RELATIVE")

#We need to re-solve the previous scenario as a store-expansion scenario, in
#which we will start with an existing store and optimally locate two additional
#stores.
#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.
fieldMappings = arcpy.na.NAClassFieldMappings(outNALayer, facilitiesLayerName)
fieldMappings["FacilityType"].defaultValue = 1
fieldMappings["Name"].mappedFieldName = "Name"
arcpy.na.AddLocations(outNALayer, facilitiesLayerName, requiredFacility,
                      fieldMappings, "", append = "APPEND",
                      exclude_restricted_elements = "EXCLUDE")

#Solve the location-allocation layer
arcpy.na.Solve(outNALayer)
    
#Save the solved location-allocation layer as a layer file on disk with 
#relative paths
updatedNALayerName = "StoreExpansionScenario"
outNALayer.name = updatedNALayerName
outLayerFile = outputFolder + updatedNALayerName + ".lyr"
arcpy.management.SaveToLayerFile(outNALayer,outLayerFile,"RELATIVE")

#We need to resolve the previous scenario and locate new stores to 
#maximize market share in light of competing stores.

#Load the competitor store locations as the competitor facilities. Use the field
#mappings to set the facility type to Competitor. We need to append these
#competitor facilities to existing facilities.
fieldMappings["FacilityType"].defaultValue = 2
arcpy.na.AddLocations(outNALayer, facilitiesLayerName, competitorFacility,
                      fieldMappings, "", append = "APPEND",
                      exclude_restricted_elements = "EXCLUDE")

#Get the LocationAllocationSolverProperties object from the location-allocation 
#layer to modify the analysis settings for the layer.
solverProps = arcpy.na.GetSolverProperties(outNALayer)

#Set the problem type to Maximize Market Share, and impedance transformation to
#Power with an impedance parameter value of 2.
solverProps.problemType = "MAXIMIZE_MARKET_SHARE"
solverProps.impedanceTransformation = "POWER"
solverProps.impedanceParameter = 2

#Solve the location-allocation layer
arcpy.na.Solve(outNALayer)

#print the market share that was obtained
arcpy.AddMessage(arcpy.GetMessage(0))

#Change the name of the NA Layer
updatedNALayerName = "MaximizedMarketShareStoreLocations"
outNALayer.name = updatedNALayerName

#Save the solved location-allocation layer as a layer file on disk with 
#relative paths
outLayerFile = outputFolder + updatedNALayerName + ".lyr"
arcpy.management.SaveToLayerFile(outNALayer,outLayerFile,"RELATIVE")
    
arcpy.AddMessage("Completed")