Resumen
Crea una matriz de coste origen-destino (OD) de múltiples orígenes a múltiples destinos. Un matriz de coste OD es una tabla que contiene el tiempo y la distancia de viaje desde cada origen hasta cada destino. Además, clasifica en orden ascendente los destinos a los que se llega desde cada origen basándose en el tiempo o la distancia mínimos requeridos para viajar desde ese origen a cada destino. Se descubre la mejor ruta en la red de calles para cada par origen-destino y los tiempos de viaje y las distancias de viaje se almacenan como atributos de las líneas de salida. Aunque las líneas son rectas por razones de rendimiento, siempre se almacena el tiempo y la distancia del viaje a lo largo de la red de calles, no la distancia en línea recta.
Más información acerca de la salida de Matriz de coste origen-destino
Uso
Buscar y mide las rutas de menor coste a lo largo de la red desde varios orígenes a varios destinos.
El cuadro de diálogo de la herramienta agrupa los diversos parámetros opcionales en las siguientes seis categorías para hacer que sea más fácil administrarlos:
- Análisis avanzado
- Barreras
- Modo de viaje personalizado
- Dataset de red
- Ubicaciones de red
- Salida
- Capacidades de servicio
Sintaxis
arcpy.na.GenerateOriginDestinationCostMatrix(Origins, Destinations, Network_Dataset, Output_Geodatabase, Output_Origin_Destination_Lines_Name, Output_Origins_Name, Output_Destinations_Name, {Travel_Mode}, {Time_Units}, {Distance_Units}, {Number_of_Destinations_to_Find}, {Cutoff}, {Time_of_Day}, {Time_Zone_for_Time_of_Day}, {Point_Barriers}, {Line_Barriers}, {Polygon_Barriers}, {Impedance_Attribute}, {Impedance_Attribute_Units}, {Time_Attribute}, {Time_Attribute_Units}, {Distance_Attribute}, {Distance_Attribute_Units}, {UTurn_Policy}, {Use_Hierarchy_in_Analysis}, {Restrictions}, {Attribute_Parameter_Values}, {Accumulate_Attributes}, {Maximum_Snap_Tolerance}, {Feature_Locator_WHERE_Clause}, {Origin_Destination_Line_Shape}, {Maximum_Features_Affected_by_Point_Barriers}, {Maximum_Features_Affected_by_Line_Barriers}, {Maximum_Features_Affected_by_Polygon_Barriers}, Maximum_Origins, Maximum_Destinations, {Force_Hierarchy_Beyond_Distance}, {Save_Output_Network_Analysis_Layer}, {Overrides})| Parámetro | Explicación | Tipo de datos |
Origins | Especifique ubicaciones que funcionen como puntos de partida para la generación de las rutas a los destinos. Se pueden agregar hasta 200 orígenes. Al especificar los orígenes, puede definir propiedades para cada una de ellos como, por ejemplo, el nombre o la cantidad de destinos a buscar desde el origen, utilizando atributos. Los orígenes se pueden especificar con los siguientes atributos: Name: el nombre del origen. El nombre puede ser un identificador único del origen. El nombre se incluye en las líneas de salida (como el campo OriginName) y en los orígenes de salida (como el campoName) y se puede utilizar para unir información adicional de las salidas de la herramienta a los atributos de los orígenes. Si no se especifica el nombre, se genera automáticamente un nombre único con el prefijo de Location en los orígenes de salida. En las líneas de salida no se incluye ningún nombre de origen generado automáticamente. TargetDestinationCount: el número máximo de destinos que se deben encontrar para el origen. Si no se especifica un valor, se utilizará el valor del parámetro Número de destinos para buscar. Cutoff: especifica el valor del tiempo o la distancia de viaje en el que se debe detener la búsqueda de destinos para un origen. Los destinos situados más allá del valor de punto crítico serán ignorados. El valor debe estar expresado en las unidades especificadas en el parámetro Unidades de tiempo en el caso de que el atributo de impedancia del modo de viaje está basado en el tiempo o en las unidades especificadas en el parámetro Unidades de distancia si el atributo de impedancia del modo de viaje está basado en la distancia. Si no se especifica un valor, se utilizará el valor del parámetro Cutoff. CurbApproach: especifica la dirección en la que un vehículo puede partir del origen. El valor de campo se especifica como uno de los siguientes enteros (use el código numérico, no el nombre entre paréntesis):
La propiedad CurbApproach se ha diseñado para trabajar con los dos tipos de estándares nacionales de tráfico: por la derecha (Estados Unidos) y por la izquierda (Reino Unido). En primer lugar, considere una parada en el lado izquierdo de un vehículo. Siempre estará situada el lado izquierdo, independientemente de si el vehículo circula por la mitad izquierda o derecha del camino. Las normas de circulación nacionales pueden influir en su decisión de aproximarse a una parada desde una de las dos direcciones posibles, de modo que quede en el lado derecho o en el lado izquierdo del vehículo. Por ejemplo, si desea llegar a una parada y no hay ningún carril entre el vehículo y la parada, elegiría Lado derecho del vehículo (1) en los Estados Unidos y Lado izquierdo del vehículo (2) en el Reino Unido. | Feature Set |
Destinations | Especifique ubicaciones que funcionen como puntos finales para la generación de las rutas desde los orígenes. Se pueden agregar hasta 200 destinos. Al especificar los destinos, se pueden definir propiedades para cada uno de ellos como, por ejemplo, el nombre, mediante el uso de atributos. Los destinos se pueden especificar con los siguientes atributos: Name: el nombre del destino. El nombre puede ser un identificador único del destino. El nombre se incluye en las líneas de salida (como el campo DestinationName) y en los destinos de salida (como el campo Name) y se puede utilizar para unir información adicional de las salidas de la herramienta a los atributos de los destinos. Si no se especifica el nombre, se genera automáticamente un nombre único con el prefijo de Location en los destinos de salida. En las líneas de salida no se incluye ningún nombre de destino generado automáticamente. CurbApproach: especifica la dirección en la que un vehículo puede llegar al destino. El valor de campo se especifica como uno de los siguientes enteros (use el código numérico, no el nombre entre paréntesis):
La propiedad CurbApproach se ha diseñado para trabajar con los dos tipos de estándares nacionales de tráfico: por la derecha (Estados Unidos) y por la izquierda (Reino Unido). En primer lugar, considere una parada en el lado izquierdo de un vehículo. Siempre estará situada el lado izquierdo, independientemente de si el vehículo circula por la mitad izquierda o derecha del camino. Las normas de circulación nacionales pueden influir en su decisión de aproximarse a una parada desde una de las dos direcciones posibles, de modo que quede en el lado derecho o en el lado izquierdo del vehículo. Por ejemplo, si desea llegar a una parada y no hay ningún carril entre el vehículo y la parada, elegiría Lado derecho del vehículo (1) en los Estados Unidos y Lado izquierdo del vehículo (2) en el Reino Unido. | Feature Set |
Network_Dataset | El dataset de red en el que se realizará el análisis. La mayoría de las veces los datasets de red representan redes de calles pero también pueden representar otras redes de transporte. El dataset de red debe tener al menos un atributo de coste basado en el tiempo y uno basado en la distancia. | Network Dataset Layer |
Output_Geodatabase | Espacio de trabajo de salida. Este espacio de trabajo ya debe existir. | Workspace |
Output_Origin_Destination_Lines_Name | Nombre de la clase de entidad de salida que almacena las líneas que conectan los puntos de origen y destino. En el resultado de Generar matriz de coste origen-destino se describe el esquema de esta clase de entidad de salida. | String |
Output_Origins_Name | Nombre de la clase de entidad de salida que contiene puntos de origen. En el resultado de Generar matriz de coste origen-destino se describe el esquema de esta clase de entidad de salida. | String |
Output_Destinations_Name | Nombre de la clase de entidad de salida que contiene puntos de destino. En el resultado de Generar matriz de coste origen-destino se describe el esquema de esta clase de entidad de salida. | String |
Travel_Mode (Opcional) | Seleccione el modo de transporte para el análisis. CUSTOM siempre es una opción. Para que aparezcan otros nombres de modo de viaje, estos deben estar presentes en el dataset de red especificado en el parámetro Network_Dataset. (La función arcpy.na.GetTravelModes proporciona un diccionario de los objetos de modo de viaje configurados en un dataset de red, y la propiedad name devuelve el nombre de un objeto de modo de viaje). Un modo de viaje se define en un dataset de red y proporciona valores de invalidación para los parámetros que, juntos, modelan coches, camiones, peatones u otros modos de viaje. Al elegir aquí un modo de viaje, no tiene que proporcionar valores para los siguientes parámetros, que se invalidan con los valores especificados en el dataset de red:
| String |
Time_Units (Opcional) | Especifique las unidades que se deben usar para medir e indicar el tiempo total de viaje entre cada par de origen-destino. Se incluyen las opciones siguientes:
| String |
Distance_Units (Opcional) | Especifique las unidades que se deben usar para medir e indicar la distancia total de viaje entre cada par de origen-destino. Se incluyen las opciones siguientes:
| String |
Number_of_Destinations_to_Find (Opcional) | Especifique la cantidad máxima de destinos que se buscarán por origen. Si no se especifica un valor para este parámetro, la matriz de salida incluirá los costes de viaje desde cada origen hasta cada destino. Determinados orígenes pueden tener sus propios valores (especificados como el campo TargetDestinationCount TargetDestinationCount), que invalidan el valor del parámetro Número de destinos para buscar. | Long |
Cutoff (Opcional) | Especifica el valor del tiempo de viaje o la distancia de viaje en la cual se debe detener la búsqueda de destinos desde un origen determinado. Los destinos situados más allá del valor de punto crítico serán ignorados. Determinados orígenes pueden tener sus propios valores (especificados como el campo Cutoff), que invalidan el valor del parámetro Cutoff. El valor debe estar expresado en las unidades especificadas en el parámetro Unidades de tiempo en el caso de que el atributo de impedancia del modo de viaje esté basado en el tiempo o en las unidades especificadas en el parámetro Unidades de distancia si el atributo de impedancia del modo de viaje está basado en la distancia. Si no se especifica ningún valor, la herramienta no aplicará ningún límite de tiempo o distancia de viaje al buscar destinos. | Double |
Time_of_Day (Opcional) | Especifica la hora y la fecha en la cual deben comenzar las rutas. Si su dataset de red contiene datos de tráfico en directo o históricos, al especificar una hora del día se obtiene una estimación más precisa del tiempo de viaje entre paradas porque los tiempos de viaje tienen en cuenta las condiciones del tráfico aplicables a esa fecha y hora. El parámetro Zona horaria para hora del día especifica si la fecha y la hora se refieren a UTC o a la zona horaria en la cual se encuentra la parada. La herramienta ignora este parámetro cuando Unidades de medida no está configurada con una unidad de tiempo. | Date |
Time_Zone_for_Time_of_Day (Opcional) | Especifica la zona horaria del parámetro Hora del día.
| String |
Point_Barriers (Opcional) | Especifica barreras de punto, que se dividen en dos tipos: barreras de restricción y barreras de punto de coste añadido. Restringen temporalmente el trazado poligonal en toda la red o agregan impedancia a puntos de la red. Las barreras de punto se definen mediante un conjunto de entidades, y los valores de atributo que especifica para las entidades de punto determinan si son barreras de restricción o de coste agregado. Los campos en la tabla de atributos se muestran y describen a continuación. ObjectID: Campo ID administrado por el sistema. Shape: Campo de geometría que indica la ubicación geográfica del objeto de análisis de red. Name: El nombre de la barrera. BarrierType: Especifica si la barrera restringe completamente el viaje o agrega coste cuando se viaja a través de ella. Existen dos opciones:
Utilice el valor 0 para Restricción y 2 para Coste agregado. Additional_Time: Indica cuánto tiempo de viaje se agrega al atravesar la barrera. Este campo solo es aplicable para barreras con coste añadido y solo si las unidades de medida se basan en el tiempo. El valor de este campo debe ser mayor o igual que cero, y sus unidades son las mismas que las especificadas en el parámetro Unidades de medida. Additional_Distance: Indica cuánta distancia se agrega al atravesar la barrera. Este campo solo se aplica a barreras con coste agregado y solo si las unidades de medida se basan en distancias. El valor de este campo debe ser mayor o igual que cero, y sus unidades son las mismas que las especificadas en el parámetro Unidades de medida. | Feature Set |
Line_Barriers (Opcional) | Especifica las barreras de línea, que restringen temporalmente el trazado poligonal en ellos. Las barreras de línea se definen mediante un conjunto de entidades. Los campos en la tabla de atributos se muestran y describen a continuación. ObjectID: Campo ID administrado por el sistema. Shape: Campo de geometría que indica la ubicación geográfica del objeto de análisis de red. Name: El nombre de la barrera. | Feature Set |
Polygon_Barriers (Opcional) | Especifica barreras de polígono, que se dividen en dos tipos: barreras de restricción y barreras de polígono de coste escalado. Restringen temporalmente el trazado poligonal o la impedancia de escala en las partes de la red que cubren. Las barreras de polígono se definen mediante un conjunto de entidades, y los valores de atributo que especifica para las entidades de polígono determinan si son barreras de restricción o de coste de escala. Los campos en la tabla de atributos se muestran y describen a continuación. ObjectID: Campo ID administrado por el sistema. Shape: Campo de geometría que indica la ubicación geográfica del objeto de análisis de red. Name: El nombre de la barrera. BarrierType: Especifica si la barrera restringe completamente el viaje o escala el coste de viajar a través de ella. Existen dos opciones:
Utilice el valor 0 para Restricción y 1 para Coste en escala. ScaledTimeFactor: Este es el factor por el cual se multiplica el tiempo de viaje de las calles que intersecan con la barrera. Este campo solo tiene validez para barreras con coste en escala y solo si las unidades de medida se basan en el tiempo. El valor del campo debe ser mayor que cero. ScaledDistanceFactor: Este es el factor por el cual se multiplica la distancia de las calles que intersecan con la barrera. Este atributo solo tiene validez para barreras con coste en escala y solo si las unidades de medida se basan en distancias. El valor del atributo debe ser mayor que cero. | Feature Set |
Impedance_Attribute (Opcional) | El atributo de coste que se usará como impedancia en el análisis. | String |
Impedance_Attribute_Units (Opcional) | Las unidades del atributo de impedancia de red especificado por el parámetro Atributo de impedancia. Este es un parámetro de información que no se puede cambiar sin editar directamente el dataset de red. Tampoco es necesario cambiar porque las conversiones de unidades entre las unidades de medida y del atributo de coste las maneja usted. El valor de este parámetro se invalida cuando Modo de viaje está establecido en cualquier otro valor que no sea Personalizado. | String |
Time_Attribute (Opcional) | Define el atributo de coste de red que se debe utilizar cuando el valor de las unidades de medida sea una unidad de tiempo. La herramienta realiza la conversión necesaria de unidades de tiempo cuando el valor de las unidades de medida difiere de las unidades del atributo de coste definido aquí. Es decir, no es necesario que las unidades de tiempo del límite predeterminado y del atributo de coste de red sean las mismas. El valor de este parámetro se invalida cuando Modo de viaje (Travel_Mode en Python) está establecido en cualquier otro valor que no sea Personalizado. | String |
Time_Attribute_Units (Opcional) | Unidades del atributo de tiempo. Las unidades del atributo de tiempo se pueden establecer explícitamente pero se recomienda no pasar nada o pasar "#" y dejar que el solucionador determine las unidades. El valor de este parámetro se invalida cuando Travel_Mode está establecido en cualquier otro valor que no sea CUSTOM. | String |
Distance_Attribute (Opcional) | Define el atributo de coste de red que se debe utilizar cuando el valor de las unidades de medida sea una unidad de distancia. La herramienta realiza la conversión necesaria de unidades de distancia cuando el valor de las unidades de medida difiere de las unidades del atributo de coste definido aquí. Es decir, no es necesario que las unidades de medida y las unidades de distancia del atributo de coste de red sean las mismas. El valor de este parámetro se invalida cuando Modo de viaje (Travel_Mode en Python) está establecido en cualquier otro valor que no sea Personalizado. | String |
Distance_Attribute_Units (Opcional) | Unidades del atributo de distancia. Las unidades del atributo de distancia se pueden establecer explícitamente pero se recomienda no pasar nada o pasar "#" y dejar que el solucionador determine las unidades. El valor de este parámetro se invalida cuando Travel_Mode está establecido en cualquier otro valor que no sea CUSTOM. | String |
UTurn_Policy (Opcional) | Política de cambios de sentido en los cruces. Permitir cambios de sentido implica que el solucionador puede dar la vuelta en un cruce y regresar por la misma calle. Debido a que los cruces representan intersecciones de calles y callejones sin salida, los diferentes vehículos pueden ser capaces de dar la vuelta en algunos cruces, pero no en otros, depende de que el cruce sea una intersección o un callejón sin salida. Para adaptarse, el parámetro de la política de cambios de sentido se especifica implícitamente por la cantidad de bordes, o calles, que se conectan en el cruce, que se conoce como valencia de cruce. Los valores aceptables para este parámetro se enumeran a continuación; cada uno seguido de una descripción de su significado en términos de valencia de cruce.
El valor de este parámetro se invalida cuando Modo de viaje (Travel_Mode en Python) está establecido en cualquier otro valor que no sea personalizado. | String |
Use_Hierarchy_in_Analysis (Opcional) | Especifique si es necesario usar la jerarquía para buscar las rutas más cortas entre puntos.
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 caso, utilice «#» como el valor de parámetro. Puede utilizar el parámetro Force_Hierarchy_Beyond_Distance para forzar que el solucionador utilice la jerarquía incluso si Use_Hierarchy_in_Analysis está establecido en False. Este parámetro se ignora a menos que Travel_Mode esté establecido en CUSTOM. Cuando se modela un modo a pie personalizado, se recomienda desactivar la jerarquía, ya que está diseñada para vehículos motorizados. | Boolean |
Restrictions [restriction,...] (Opcional) | Indica qué atributos de restricción de red se respetan en el momento de la resolución. El valor de este parámetro se invalida cuando Modo de viaje (Travel_Mode en Python) está establecido en cualquier otro valor que no sea personalizado. | String |
Attribute_Parameter_Values (Opcional) | Especifica los valores de parámetro de atributos de red que tienen parámetros. El conjunto de registros tiene dos columnas que trabajan juntas para identificar parámetros de forma única y otra columna que especifica el valor del parámetro. El valor de este parámetro se invalida cuando Modo de viaje (Travel_Mode en Python) está establecido en cualquier otro valor que no sea personalizado. El conjunto de registros de valores de parámetro tiene atributos asociados. Los campos en la tabla de atributos se enumeran y describen a continuación. ObjectID: Campo ID administrado por el sistema. AttributeName: El nombre del atributo de red cuyo parámetro de atributos se establece por la fila de tabla. ParameterName: El nombre del parámetro de atributos cuyo valor se establece por la fila de tabla. (Los parámetros de tipo Objeto no se pueden actualizar utilizando esta herramienta). ParameterValue: El valor que desea para el parámetro de atributos. Si no se especifica el valor, el valor de los parámetros de atributos se establecerá en Nulo. | Record Set |
Accumulate_Attributes [attribute,...] (Opcional) | Lista de los atributos de coste que se acumularán durante el análisis. Estos atributos de acumulación se usan exclusivamente como referencia; el solucionador solo utiliza los atributos de coste especificados por los parámetros Atributo de tiempo (Time_Attribute en Python) o Atributo de distancia (Distance_Attribute en Python) para calcular las rutas más cortas. Para cada atributo de coste acumulado, se agrega un campo Total_[atributo] a las rutas generadas por el solucionador. | String |
Maximum_Snap_Tolerance (Opcional) | La máxima tolerancia de alineación es la distancia más lejana que busca Network Analyst al ubicar o reubicar un punto en la red. La búsqueda busca bordes o cruces adecuados y alinea el punto con el más cercano. Si no se encuentra una ubicación adecuada dentro de la máxima tolerancia de alineación, el objeto se marca como no ubicado. | Linear unit |
Feature_Locator_WHERE_Clause (Opcional) | Una expresión SQL utilizada para seleccionar un subconjunto de entidades de origen que limita los elementos de red en que se pueden ubicar las paradas. La sintaxis para este parámetro consta de dos partes: la primera es el nombre de la clase de entidad de origen (seguido de un espacio) y la segunda es la expresión SQL. Al escribir una expresión SQL para dos o más clases de entidad de origen, sepárelas con un punto y coma. Para garantizar que las instalaciones no se encuentran en autopistas de acceso limitado, por ejemplo, se debe escribir una expresión SQL como la siguiente para excluir esas entidades de origen: "Streets" "FUNC_CLASS not in('1', '2')". Tenga en cuenta que durante la carga las barreras ignoran la cláusula WHERE del localizador de entidad. | String |
Origin_Destination_Line_Shape (Opcional) | Las líneas resultantes de una matriz de coste OD se pueden representar con geometría de línea o sin ninguna geometría. En ambos casos, la ruta siempre se calcula a lo largo de la red de calles minimizando el tiempo o la distancia de viaje; nunca usando la distancia en línea recta entre orígenes y destinos.
| String |
Maximum_Features_Affected_by_Point_Barriers (Opcional) | Restringe el número de entidades que pueden ser afectadas por las barreras de punto. Un valor nulo indica que no hay ningún límite. | Long |
Maximum_Features_Affected_by_Line_Barriers (Opcional) | Restringe el número de entidades pueden ser afectadas por las barreras de línea. Un valor nulo indica que no hay ningún límite. | Long |
Maximum_Features_Affected_by_Polygon_Barriers (Opcional) | Restringe el número de entidades que pueden ser afectadas por las barreras de polígono. Un valor nulo indica que no hay ningún límite. | Long |
Maximum_Origins | Limita la cantidad de orígenes que se puede agregar al análisis de la matriz de coste de origen-destino. Este parámetro le ayuda a regir la cantidad de procesamiento que se produce al resolver. Por ejemplo, puede asignar un valor bajo para este parámetro para la versión gratuita del servicio que está creando y utilizar un valor más alto para la versión de suscripción de pago. Un valor nulo indica que no hay ningún límite. | Long |
Maximum_Destinations | Limita la cantidad de destinos que se puede agregar al análisis de la matriz de coste de origen-destino. Este parámetro le ayuda a regir la cantidad de procesamiento que se produce al resolver. Por ejemplo, puede asignar un valor bajo para este parámetro para la versión gratuita del servicio que está creando y utilizar un valor más alto para la versión de suscripción de pago. Un valor nulo indica que no hay ningún límite. | Long |
Force_Hierarchy_Beyond_Distance (Opcional) | Especifica la distancia después de la cual el solucionador forzará la jerarquía al buscar rutas, aunque la jerarquía no esté habilitada. Las unidades de este parámetro son las mismas que las que se muestran en el parámetro Unidades de atributo de distancia. Buscar rutas entre paradas que están alejadas mientras se utiliza la jerarquía de red tiende a utilizar menos tiempo de procesamiento que buscar las mismas rutas sin usar la jerarquía. Este parámetro le ayuda a regir la cantidad de procesamiento que se produce al resolver. Un valor nulo indica que la jerarquía nunca será aplicada y el valor del parámetro Utilizar jerarquía en el análisis siempre se respeta. Si el dataset de red de entrada no admite jerarquía, especificar un valor para este parámetro ocasionará un error. En este caso se debe utilizar un valor nulo. Este parámetro está deshabilitado a menos que el dataset de red incluya un atributo de jerarquía. | Double |
Save_Output_Network_Analysis_Layer (Opcional) |
En cualquier caso, se devuelven las clases de entidad que contienen los resultados. Sin embargo, un administrador del servidor puede elegir que la salida sea también una capa de análisis de red de salida para que el programa de instalación y los resultados de la herramienta puedan ser depurados utilizando los controles Network Analyst en el entorno de ArcGIS Desktop. Esto puede hacer que el proceso de depuración sea mucho más fácil. En ArcGIS Desktop, la ubicación de salida predeterminada para la capa de análisis de red está en la carpeta temporal. Puede determinar la ubicación de la carpeta temporal mediante la evaluación del valor de entorno de geoprocesamiento arcpy.env.scratchFolder. La capa de análisis de red de salida se almacena como un archivo LYR cuyo nombre comienza con _ags_gpna y está seguido por un GUID alfanumérico. | Boolean |
Overrides (Opcional) | Especifique cualquier parámetro adicional que pueda influir en el comportamiento del solucionador al buscar soluciones para problemas de análisis de red. Se debe especificar el valor para este parámetro en la notación de objetos JavaScript (JSON). Por ejemplo, un valor válido tiene el siguiente formato: {"overrideSetting1" : "value1", "overrideSetting2" : "value2"}. El nombre del parámetro de invalidación siempre está incluido entre comillas dobles. Los valores pueden ser un número, operador booleano o cadena de caracteres. El valor predeterminado para este parámetro es ningún valor, lo que indica que no se debe invalidar ningún parámetro del solucionador. Las invalidaciones son parámetros avanzados que se deben utilizar solamente después de un análisis cuidadoso de los resultados obtenidos antes y después de aplicar los parámetros. Puede ponerse en contacto con el Soporte técnico de Esri para obtener una lista de los parámetros de invalidación compatibles para cada solucionador y sus valores aceptables. | string |
Salida derivada
| Nombre | Explicación | Tipo de datos |
| Solve_Succeeded | Determina si el servicio ha podido generar correctamente la matriz de coste origen-destino. | Booleano |
| Output_Origin_Destination_Lines | Las rutas resultantes desde los orígenes hasta los destinos. | Conjunto de entidades |
| Output_Origins | Los orígenes que participaron en los análisis. | Conjunto de entidades |
| Output_Destinations | Los destinos que participaron en los análisis. | Conjunto de entidades |
| Output_Network_Analysis_Layer | Capa de análisis de red con las propiedades según se configuraron en los parámetros de la herramienta, que se puede utilizar para análisis posteriores o para depurar el mapa. | Archivo |
Muestra de código
Ejemplo 1 de GenerateOriginDestinationCostMatrix (ventana de Python)
Ejecutar la herramienta utilizando los parámetros requeridos.
origins = arcpy.FeatureSet()
origins.load("Warehouses")
destinations = arcpy.FeatureSet()
destinations.load("Stores")
arcpy.na.GenerateOriginDestinationCostMAtrix(origins, destinations, "ParisMultimodal_ND")
Ejemplo 2 de GenerateOriginDestinationCostMatrix (script independiente)
En el siguiente script de Python se muestra cómo utilizar la herramienta en un script independiente.
# Name: GenerateOriginDestinationCostMatrix_Workflow.py
# Description: Find and measure the least-cost paths along the network from multiple
# origins to multiple destinations.
# 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:/arcgis/ArcTutor/Network Analyst/Tutorial/Paris.gdb'
env.overwriteOutput = True
#Set local variables
inOrigins = 'Analysis/Warehouses'
inDestinations = 'Analysis/Stores'
inNetworkDataset = 'Transportation/ParisMultimodal_ND'
outGeodatabase = 'C:/arcgis/ArcTutor/Network Analyst/Tutorial/Output.gdb'
# Run GenerateODCostMatrix
arcpy.na.GenerateOriginDestinationCostMatrix(inOrigins, inDestinations, inNetworkDataset, outGeodatabase,
Cutoff=10, Origin_Destination_Line_Shape='STRAIGHT_LINES')
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
Información de licenciamiento
- Basic: Requiere Network Analyst
- Standard: Requiere Network Analyst
- Advanced: Requiere Network Analyst