arcpy.na.MakeLocationAllocationLayer(in_network_dataset, out_network_analysis_layer, impedance_attribute, {loc_alloc_from_to}, {loc_alloc_problem_type}, {number_facilities_to_find}, {impedance_cutoff}, {impedance_transformation}, {impedance_parameter}, {target_market_share}, {accumulate_attribute_name}, {UTurn_policy}, {restriction_attribute_name}, {hierarchy}, {output_path_shape}, {default_capacity}, {time_of_day})
|
名称
|
说明
|
数据类型
|
|
in_network_dataset
|
要执行位置分配分析的网络数据集。
|
Network Dataset Layer
|
|
out_network_analysis_layer
|
要创建的位置分配网络分析图层的名称。
|
String
|
|
impedance_attribute
|
分析过程中将用作阻抗的成本属性。
|
String
|
|
loc_alloc_from_to
(可选)
|
指定计算网络成本时设施点与请求点之间的行驶方向。
使用此选项会影响具有单向限制和根据方向不同阻抗不同的网络上的请求点到设施点的分配。 例如,从请求点驾车到达设施点可能需要 15 分钟,但从设施点行驶至请求点仅需 10 分钟。
|
String
|
|
loc_alloc_problem_type
(可选)
|
将要求解的问题的类型。 问题类型的选择取决于要定位的设施点种类。 不同种类的设施点具有不同的优先级和约束。
MINIMIZE_IMPEDANCE—此选项可解决仓库位置问题。 它选择一组使加权阻抗(请求的位置乘以到最近设施点的阻抗)的总和最小的设施点。 此问题类型通常称为 P 中位数问题。
MAXIMIZE_COVERAGE—此选项可解决消防站位置问题。 它选择了多个设施点以保证所有或最大数量的请求点处于指定的阻抗中断范围内。
MAXIMIZE_CAPACITATED_COVERAGE—此选项用于求解容量有限的设施点的位置问题。 此选项将选择一组满足所有或最大数量的请求而不超出任何设施点容量的设施点。 除了支持容量外,该选项还选择一组使加权阻抗(分配给某个设施点的请求点乘以到该设施点的阻抗)的总和最小的设施点。
MINIMIZE_FACILITIES—此选项可解决消防站位置问题。 它将选择当在指定的阻抗中断范围内覆盖了所有或最大数量的请求点时所需要的设施点的最小数量。
MAXIMIZE_ATTENDANCE—此选项可解决邻域存储位置问题,其中分配给最近所选设施点的请求比例将随距离的增加而降低。 已选择最大化总分配请求点的设施点集。 大于指定的阻抗中断的请求点不会影响所选的设施点集。
MAXIMIZE_MARKET_SHARE—此选项可解决竞争性设施点的位置问题。 它选择当存在竞争性设施点时可最大化市场份额的设施点。 重力模型概念用于确定分配给每个设施点的请求点比例。 已选择最大化总分配请求点的设施点集。
TARGET_MARKET_SHARE—此选项可解决竞争性设施点的位置问题。 它选择当存在竞争性设施点时可达到指定目标市场份额的设施点。 重力模型概念用于确定分配给每个设施点的请求点比例。 已选择的最小设施点量需达到指定的目标市场份额。
|
String
|
|
number_facilities_to_find
(可选)
|
指定求解程序将查找的设施点数。
如果要查找的设施点数量大于必需的设施点,解决方案中将始终包含 FacilityType 值为必需的设施点;将从候选设施点中选取要选择的所有多余设施点。
任何在求解前 FacilityType 值为已选定的设施点,在求解时均视为候选设施点。
对于 MINIMIZE_FACILITIES 问题类型不会考虑参数值,因为求解程序会确定最小的设施点数来查找最大的覆盖范围。
对于 TARGET_MARKET_SHARE 问题类型,参数值会被覆盖,因为求解程序会搜索要占有指定市场份额所需的最小设施点数。
|
Long
|
|
impedance_cutoff
(可选)
|
阻抗中断用于指定请求点可被分配到设施点的最大阻抗。 最大阻抗以沿网络的最小成本路径进行测量。 如果请求点位于中断外,则不会被分配。 此属性可用于对人们为前往商店而愿意行进的最大距离,以及消防站到达社区中任一请求点所允许的最大时间进行建模。
如果设置请求点的 Cutoff_[Impedance] 属性,则该属性会覆盖分析图层的阻抗中断属性。 您可能会发现,乡村居民愿意走 10 英里远去往某个设施点,而城镇居民则只愿意走 2 英里的路程。 可按如下方式对此行为进行建模:将分析图层的阻抗中断值设置为 10 并将城区中请求点的 Cutoff_Miles 值设置为 2。
|
Double
|
|
impedance_transformation
(可选)
|
此属性可设置对设施点与请求点间网络成本进行变换的方程。 此属性与阻抗参数结合使用,可指定设施点与请求点间的网络阻抗对求解程序选择设施点的影响的严重程度。
如果设置请求点的 ImpedanceTransformation 属性,该属性会覆盖分析图层的“阻抗变换”属性。 这时,您可能要针对城镇居民和乡村居民使用不同的阻抗变换。 可通过为分析图层设置阻抗变换以匹配乡村居民的阻抗参数,同时为城镇地区中的请求点设置阻抗参数以匹配城镇居民的阻抗参数,来执行建模。
LINEAR—设施点和请求点之间变换的网络阻抗与它们之间的最短路径网络阻抗相同。 使用此选项,阻抗参数始终设置为 1。 这是默认设置。
POWER—设施点和请求点之间变换的网络阻抗等于以最短路径网络阻抗为底,以阻抗参数所指定的数为指数的幂运算结果。 将此选项与正阻抗参数结合使用可对附近的设施点指定较高的权重。
EXPONENTIAL—设施点和请求点之间变换的网络阻抗等于以数学常量 e 为底,以最短路径网络阻抗所指定的数为指数的幂乘以阻抗参数。 将此选项与正阻抗参数结合使用可对附近的设施点指定很高的权重。指数变化通常与阻抗中断结合使用。
|
String
|
|
impedance_parameter
(可选)
|
为“阻抗变换”参数中指定的方程提供参数值。 当阻抗变换的类型为 LINEAR 时会忽略参数值。 对于 POWER 和 EXPONENTIAL 阻抗变换,应设置非零值。
如果设置请求点的 ImpedanceParameter 属性,该属性会覆盖分析图层的阻抗参数属性。 这时,您可能要针对城镇居民和乡村居民使用不同的阻抗参数。 可通过为分析图层设置阻抗变换以匹配乡村居民的阻抗参数,同时为城镇地区中的请求点设置阻抗参数以匹配城镇居民的阻抗参数,来执行建模。
|
Double
|
|
target_market_share
(可选)
|
指定当位置分配问题类型参数设置为 TARGET_MARKET_SHARE 时要求解的目标市场份额百分比。 它是您希望设施点解占总请求权重的百分比。 求解程序会求出为占有该值指定的目标市场份额所需的最小设施点数。
|
Double
|
|
accumulate_attribute_name
[accumulate_attribute_name,...]
(可选)
|
分析过程中要累积的成本属性的列表。 这些累积属性仅供参考;求解程序仅使用阻抗属性参数所指定的成本属性来计算路径。
对于每个累积的成本属性,均会向求解程序所输出的路径中添加一个 Total_[阻抗] 属性。
|
String
|
|
UTurn_policy
(可选)
|
指定将在交汇点处使用的 U 形转弯策略。 允许 U 形转弯表示求解程序可以在交汇点处转向并沿同一街道往回行驶。 考虑到交汇点表示街道交叉路口和死角,不同的车辆可以在某些交汇点转弯,而在其他交汇点则不行 - 这取决于交汇点是交叉路口还是死角。 为适应此情况,U 形转弯策略参数由与交汇点连通的边数隐性指定,这称为交汇点原子价。 此参数可接受的值如下所列;每个值的后面是根据交汇点价对其含义的描述。
提示:
如果您需要定义更加精确的 U 形转弯策略,可以考虑在网络成本属性中添加一个通用转弯延迟赋值器,或者如果存在的话,调整其设置,并特别注意反向转弯的配置。 还可以设置网络位置的 CurbApproach 属性。
ALLOW_UTURNS—无论在交汇点处有几条连接的边,均允许 U 形转弯。 这是默认值。
NO_UTURNS—在所有交汇点处均禁止 U 形转弯,不管交汇点原子价如何。 然而,即使已指定该选项,在网络位置仍允许 U 形转弯;但是也可以通过设置单个网络位置的 CurbApproach 属性来禁止 U 形转弯。
ALLOW_DEAD_ENDS_ONLY—除仅有一条相邻边的交汇点(死角)外,其他交汇点均禁止 U 形转弯。
ALLOW_DEAD_ENDS_AND_INTERSECTIONS_ONLY—在恰好有两条相邻边相遇的交汇点处禁止 U 形转弯,但是交叉点(三条或三条以上相邻边的交汇点)和死角(仅有一条相邻边的交汇点)处允许。 通常,网络在路段中间有多余的交汇点。 此选项用于阻止车辆在这些位置进行 U 形转弯。
|
String
|
|
restriction_attribute_name
[restriction_attribute_name,...]
(可选)
|
分析期间要应用的限制属性列表。
|
String
|
|
hierarchy
(可选)
|
如果未在用于执行分析的网络数据集中定义等级属性,该参数将不可用。
|
Boolean
|
|
output_path_shape
(可选)
|
指定输出线形状。
无论指定的输出形状类型为何,最佳路径始终由网络阻抗(而非欧氏距离)决定。 这表示只是路径形状不同,而对网络进行的基础遍历则相同。
|
String
|
|
default_capacity
(可选)
|
指定 loc_alloc_problem_type 参数设为 MAXIMIZE_CAPACITATED_COVERAGE 时默认的设施点容量。 对于所有其他问题类型,可忽略此参数。
设施点有容量属性,如果此属性设置为非空值,将覆盖该设施点的 default_capacity 参数。
|
Double
|
|
time_of_day
(可选)
|
指示出发的时间和日期。 出发时间可以来自设施点或请求点,取决于行驶是从请求点到设施点还是从设施点到请求点。
如果您已经选择了基于流量的阻抗属性,将会根据特定的某天某时的动态交通状况来生成解决方案。 日期和时间可被指定为 5/14/2012 10:30 AM。
可使用以下日期来指定一周中的每一天,而无需使用特定的日期。
Today—12/30/1899
Sunday—12/31/1899
Monday—1/1/1900
Tuesday—1/2/1900
Wednesday—1/3/1900
Thursday—1/4/1900
Friday—1/5/1900
Saturday—1/6/1900
例如,要指定行程从星期二 5:00 PM 开始,则请将该参数值指定为 1/2/1900 5:00 PM。
|
Date
|
派生输出
|
名称
|
说明
|
数据类型
|
|
output_layer
|
新创建的网络分析图层。
|
Network Analyst Layer
|
代码示例
MakeLocationAllocationLayer 示例 1(Python 窗口)
仅使用必需参数运行该工具。
network = "C:/Data/SanFrancisco.gdb/Transportation/Streets_ND"
arcpy.na.MakeLocationAllocationLayer(network, "StoreLocations", "TravelTime")
MakeLocationAllocationLayer 示例 2(Python 窗口)
使用所有参数运行该工具。
network = "C:/Data/SanFrancisco.gdb/Transportation/Streets_ND"
arcpy.na.MakeLocationAllocationLayer(network, "NewStores", "TravelTime",
"DEMAND_TO_FACILITY", "MAXIMIZE_ATTENDANCE",
3, 5, "POWER", 2, "",
["TravelTime", "Meters"], "ALLOW_UTURNS",
["Oneway"], "NO_HIERARCHY",
"STRAIGHT_LINES", "", "9 AM")
MakeLocationAllocationLayer 示例 3(工作流)
以下独立 Python 脚本演示了如何使用 MakeLocationAllocationLayer 函数选择将为连锁零售店获得最大业务量的商店位置。
# Name: MakeLocationAllocationLayer_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 maximize attendance problem
# type.
# 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/SanFrancisco.gdb"
network = os.path.join(input_gdb, "Transportation", "Streets_ND")
layer_name = "NewStoreLocations"
impedance = "TravelTime"
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.MakeLocationAllocationLayer(network, layer_name,
impedance,
"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.
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, "",
"", exclude_restricted_elements = "EXCLUDE")
#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",
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.
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, "",
exclude_restricted_elements="EXCLUDE")
#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))