Make Closest Facility Layer (Network Analyst)

Resumen

Crea una capa de análisis de red de instalación más cercana y establece sus propiedades de análisis. Una capa de análisis de instalación más cercana es útil para determinar la o las instalaciones más cercanas a un incidente basadas en un coste de red específico.

Uso

Sintaxis

MakeClosestFacilityLayer_na (in_network_dataset, out_network_analysis_layer, impedance_attribute, {travel_from_to}, {default_cutoff}, {default_number_facilities_to_find}, {accumulate_attribute_name}, {UTurn_policy}, {restriction_attribute_name}, {hierarchy}, {hierarchy_settings}, {output_path_shape})
ParámetroExplicaciónTipo de datos
in_network_dataset

El dataset de red en el que se realizará el análisis de instalación más cercana.

Network Dataset Layer
out_network_analysis_layer

Nombre de la capa de análisis de red de instalación más cercana que se creará.

String
impedance_attribute

El atributo de coste que se usará como impedancia en el análisis.

String
travel_from_to
(Opcional)

Especifica la dirección de viaje entre las instalaciones e incidentes.

  • TRAVEL_FROMLa dirección de viaje desde las instalaciones hasta los incidentes.
  • TRAVEL_TOLa dirección de viaje desde los incidentes hasta las instalaciones.

Utilizando esta opción se pueden encontrar distintas instalaciones en una red con restricciones unidireccionales e impedancias diferentes basadas en la dirección del viaje. Por ejemplo, una instalación puede estar a una distancia de viaje de 10 minutos desde el incidente al viajar desde el incidente hasta la instalación, pero viajar desde la instalación hasta el incidente, puede llevar 15 minutos debido a que hay un tiempo de viaje distinto en esa dirección.

Los departamentos de bomberos generalmente utilizan la configuración TRAVEL_FROM ya que les interesa el tiempo que toma viajar desde la estación de bomberos (instalación) hasta la ubicación de la emergencia (incidente). A una tienda (instalación) le interesa más el tiempo que les toma a los compradores (incidentes) llegar a la tienda; por lo tanto, las tiendas generalmente usan la opción TRAVEL_TO.

String
default_cutoff
(Opcional)

Valor de impedancia predeterminado en el cual detener la búsqueda de instalaciones para un incidente determinado. Se puede invalidar el valor predeterminado especificando el valor límite de los incidentes cuando se utiliza la opción TRAVEL_TO o especificando el valor límite de las instalaciones cuando se usa la opción TRAVEL_FROM.

Double
default_number_facilities_to_find
(Opcional)

Cantidad predeterminada de entidades más cercanas que se buscarán por incidente. Se puede invalidar el valor predeterminado especificando un valor para la propiedad TargetFacilityCount en los incidentes.

Long
accumulate_attribute_name
[accumulate_attribute_name,...]
(Opcional)

Lista de los atributos de coste que se acumularán durante el análisis. Estos atributos de acumulación se usan específicamente de referencia; el solucionador utiliza los atributos de coste especificados por el parámetro de atributos Impedancia para calcular la ruta.

For each cost attribute that is accumulated, a Total_[Impedance] property is added to the routes that are output by the solver.

String
UTurn_policy
(Opcional)

Restrinja o permita giros en U en cruces que pudieran ocurrir durante el trazado poligonal de la red entre las paradas.

  • ALLOW_UTURNSSe permiten los giros en U en los cruces con cualquier cantidad de bordes adyacentes.
  • NO_UTURNSU-turns are prohibited at all junctions. Note, however, that U-turns are still permitted at network locations even when this setting is chosen; however, you can set the individual network locations' CurbApproach property to prohibit U-turns.
  • ALLOW_DEAD_ENDS_ONLYLos giros en U están prohibidos en todos los cruces, excepto los que tienen sólo un borde adyacente (una calle sin salida).
  • ALLOW_DEAD_ENDS_AND_INTERSECTIONS_ONLYLos giros en U están prohibidos en los cruces donde se encuentran dos bordes adyacentes pero están permitidos en las intersecciones (todo cruce con tres o más bordes adyacentes) o calles sin salida (cruces con un borde adyacente).
String
restriction_attribute_name
[restriction_attribute_name,...]
(Opcional)

Lista de atributos de restricción que se aplicarán durante el análisis.

String
hierarchy
(Opcional)
  • USE_HIERARCHY Usa el atributo de jerarquía para el análisis. Utilizar una jerarquía hace que el solucionador prefiera bordes de orden superior en lugar de bordes de orden inferior. Las soluciones jerárquicas son más rápidas y se pueden utilizar para simular la preferencia de un conductor que elige viajar en autopistas por sobre las carreteras locales cuando es posible, incluso si eso significa un viaje más largo. Esta opción es válida sólo si el dataset de red de entrada tiene atributos de jerarquía.
  • NO_HIERARCHYNo usa el atributo de jerarquía para el análisis. No utilizar una jerarquía produce una ruta exacta para el dataset de red.

El parámetro no se utiliza si no se definen atributos de jerarquía en el dataset de red utilizado para realizar el análisis. En tales casos, utilice "#" como el valor de parámetro.

Boolean
hierarchy_settings
(Opcional)

LegadoLegado:

Antes de la versión 10, este parámetro le permitía cambiar los rangos de jerarquía para su análisis de los rangos de jerarquía predeterminados establecidos en el dataset de red. En la versión 10, este parámetro ya no es compatible y se debe especificar como una cadena de caracteres vacía. Si desea cambiar los rangos de jerarquía para su análisis, actualice los rangos de jerarquía predeterminados en el dataset de red.

Network Analyst Hierarchy Settings
output_path_shape
(Opcional)

Especifica el tipo de forma para las entidades de ruta que son la salida del análisis.

  • TRUE_LINES_WITH_MEASURESLas rutas de salida tendrán la misma forma que las fuentes de red subyacentes. Además, la salida incluye mediciones de salida para la referencia lineal. Las mediciones aumentan desde la primera parada y registran la impedancia acumulativa para alcanzar una posición determinada.
  • TRUE_LINES_WITHOUT_MEASURESLas rutas de salida tendrán la misma forma que las fuentes de red subyacentes.
  • STRAIGHT_LINESLa forma de la ruta de salida será una línea recta simple entre cada par incidente-instalación.
  • NO_LINESNo se generará ninguna forma para las rutas de salida.

Sin importar el tipo de forma de salida elegido, la mejor ruta siempre se determina mediante la impedancia de red, nunca según la distancia euclidiana. Esto significa que sólo las formas de las rutas son diferentes, y no el trazado poligonal subyacente de la red.

String

Ejemplo de código

Ejemplo 1 de MakeClosestFacilityLayer (ventana de Python)

Ejecutar la herramienta utilizando sólo los parámetros requeridos

import arcpy
arcpy.env.workspace = "C:/ArcTutor/Network Analyst/Tutorial/SanFrancisco.gdb"
arcpy.MakeClosestFacilityLayer_na("Transportation/Streets_ND",
                                  "ClosestFireStations","Minutes")
Ejemplo 2 de MakeClosestFacilityLayer (ventana de Python)

Ejecutar la herramienta utilizando todos los parámetros

import arcpy
arcpy.env.workspace = "C:/ArcTutor/Network Analyst/Tutorial/SanFrancisco.gdb"
arcpy.MakeClosestFacilityLayer_na("Transportation/Streets_ND",
                                  "ClosestHospitals","Minutes","TRAVEL_TO",5,3,
                                  ["Meters","Minutes"],"ALLOW_UTURNS",
                                  ["Oneway"],"USE_HIERARCHY","",
                                  "TRUE_LINES_WITH_MEASURES")
Ejemplo 3 de MakeClosestFacilityLayer (flujo de trabajo)

La siguiente secuencia de comandos de Python independiente muestra cómo utilizar la herramienta MakeClosestFacilityLayer para encontrar el depósito más cercano desde las ubicaciones de tienda.

# Name: MakeClosestFacilityLayer_Workflow.py
# Description: 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

try:
    #Check out the Network Analyst extension license
    arcpy.CheckOutExtension("Network")

    #Set environment settings
    env.workspace = "C:/data/Paris.gdb"
    env.overwriteOutput = True
    
    #Set local variables
    inNetworkDataset = "Transportation/ParisMultimodal_ND"
    outNALayer = "ClosestWarehouse"
    impedanceAttribute = "Drivetime"
    accumulateAttributeName = ["Meters"]
    inFacilities = "Analysis/Warehouses"
    inIncidents = "Analysis/Stores"
    fieldMappings = "Name NOM #"
    outLayerFile = "C:/data/output" + "/" + outNALayer + ".lyr"
    
    #Create a new closest facility analysis layer. Apart from finding the drive 
    #time to the closest warehouse, we also want to find the total distance. So
    #we will accumulate the "Meters" impedance attribute.
    arcpy.MakeClosestFacilityLayer_na(inNetworkDataset,outNALayer,
                                      impedanceAttribute,"TRAVEL_TO","",1,
                                      accumulateAttributeName,"NO_UTURNS")
    
    #Load the warehouses as Facilities using the default field mappings and 
    #search tolerance
    arcpy.AddLocations_na(outNALayer,"Facilities",inFacilities,"","")
    
    #Load the Stores as Incidents. Map the Name property from the NOM field
    arcpy.AddLocations_na(outNALayer,"Incidents",inIncidents,fieldMappings,"")
    
    #Solve the closest facility layer
    arcpy.Solve_na(outNALayer)
    
    #Save the solved closest facility layer as a layer file on disk with 
    #relative paths
    arcpy.SaveToLayerFile_management(outNALayer,outLayerFile,"RELATIVE")
    
    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)

Entornos

Temas relacionados

Información de licencia

ArcView: Sí
ArcEditor: Sí
ArcInfo: Sí

7/11/2012