Distancia de ruta (Spatial Analyst)

Disponible con una licencia de Spatial Analyst.

Resumen

Calcula, para cada celda, el menor coste de distancia acumulativo desde o hasta el origen de menor coste y tiene en cuenta la distancia de la superficie y los factores de coste horizontal y vertical.

Heredado:

Esta herramienta está obsoleta y se eliminará en una versión futura.

La herramienta Acumulación de distancia proporciona una funcionalidad o rendimiento mejorados.

Más información acerca del funcionamiento de las herramientas de distancia de ruta

Uso

  • Las herramientas de Distancia de ruta son similares a las herramientas de Coste de distancia, ya que ambas determinan el coste de viaje acumulativo mínimo desde o hasta un origen para cada ubicación de una superficie de ráster. Sin embargo, las herramientas Distancia de ruta agregan más complejidad al análisis al tener en cuenta la distancia real de la superficie, así como otros factores verticales y horizontales.

  • Los datos de origen de entrada pueden ser un ráster o una clase de entidad. La clase de entidad puede ser punto, línea o polígono.

  • Cuando los datos de origen de entrada son un ráster, el conjunto de celdas de origen consta de todas las celdas del ráster de origen que tengan valores válidos. Las celdas con valores NoData no se incluyen en el conjunto de origen. El valor 0 se considera un origen legítimo. Se puede crear un ráster de origen con las herramientas de extracción.

  • Cuando los datos de origen de entrada son una clase de entidad, las ubicaciones de origen se convierten internamente en un ráster antes de realizar el análisis. La resolución del ráster se puede controlar con el entorno Tamaño de celda. De forma predeterminada, si no se especifica ningún otro ráster en la herramienta, la resolución se determinará por medio del valor más bajo del ancho o la altura de la extensión de la entidad de entrada, en la referencia espacial de entrada, dividido entre 250.

  • Al utilizar datos de entidad para los datos de origen de entrada, se debe tener cuidado con la manera en que el tamaño de celda de salida se maneja cuando es grueso en relación con los detalles presentes en la entrada. El proceso de rasterización interno utiliza el mismo valor de Tipo de asignación de celdas predeterminado que la herramienta De polígono a ráster, que es el método de centro de celda. Esto significa que los datos no ubicados en el centro de la celda no se incluirán en la salida de origen rasterizada intermedia y, por tanto, no se representarán en los cálculos de distancia. Por ejemplo, si los orígenes son una serie de polígonos pequeños (como huellas de edificios) que son pequeños en relación con el tamaño de celda de salida, es posible que solo algunos queden caigan de los centros de las celdas ráster de salida, ocasionando aparentemente que la mayor parte de los otros se pierdan en el análisis.

    Para evitar esta situación, como paso intermedio, puede rasterizar las entidades de entrada directamente con la herramienta De entidad a ráster y establecer el parámetro Campo. A continuación, utilice la salida resultante como entrada de la herramienta de distancia que desee usar. Alternativamente, puede seleccionar un tamaño de celda pequeño para capturar la cantidad adecuada de detalle de las entidades de entrada.

  • Las celdas con NoData actúan como barreras en las herramientas de Distancia de ruta. El coste de distancia de las celdas detrás de los valores NoData se calcula mediante el coste acumulativo necesario para rodear la barrera NoData. Cualquier ubicación de celdas asignada como NoData en cualquiera de los rásteres de entrada recibirá NoData en todos los rásteres de salida.

  • Si los datos de origen de entrada y el ráster de costes son extensiones diferentes, la extensión de salida predeterminada es la intersección de los dos. Para obtener una superficie de distancia de costes para toda la extensión, seleccione la opción Combinación de entradas de la configuración del entorno de salida Extensión.

  • La salida de la herramienta Orientación se puede utilizar como entrada para el parámetro Ráster horizontal de entrada.

  • El valor del parámetro Distancia máxima se especifica en las mismas unidades de coste que las del ráster de costes.

  • En el ráster de distancia de salida, el menor coste de distancia (o coste de distancia acumulativo mínimo) de una celda desde o hasta un conjunto de ubicaciones de origen es el límite más bajo de los menores costes de distancia desde la celda hasta todas las ubicaciones de origen.

  • Los valores predeterminados para los modificadores del Factor horizontal son los siguientes:

    Keywords       Zero factor   Cut angle     Slope   Side value
    --------------   -----------   -----------   -----   ---------
    Binary           1.0            45           ~       ~
    Forward          0.5            45 (fixed)   ~       1.0
    Linear           0.5           181            1/90   ~
    Inverse linear   2.0           180           -1/90   ~
  • Los valores predeterminados para los modificadores del Factor vertical son los siguientes:

    Keyword                   Zero    Low    High   Slope  Power  Cos    Sec
                              factor  cut    cut                  power  power
                                      angle  angle                             
    ------------------------  ------  -----  -----  -----  -----  -----  -----
    Binary                    1.0     -30    30     ~      ~      ~      ~
    Linear                    1.0     -90    90      1/90  ~      ~      ~
    Symmetric linear          1.0     -90    90      1/90  ~      ~      ~
    Inverse linear            1.0     -45    45     -1/45  ~      ~      ~
    Symmetric inverse linear  1.0     -45    45     -1/45  ~      ~      ~
    Cos                       ~       -90    90     ~      1.0    ~      ~
    Sec                       ~       -90    90     ~      1.0    ~      ~
    Cos_sec                   ~       -90    90     ~      ~      1.0    1.0
    Sec_cos                   ~       -90    90     ~      ~      1.0    1.0
  • Las características del origen, o los elementos que se mueven desde o hasta un origen, se pueden controlar por medio de parámetros específicos. El parámetro Multiplicador del coste en origen especifica el modo de viaje o la magnitud en el origen, Coste de inicio en origen define el coste inicial antes de que empiece el movimiento, Tasa de resistencia en origen es un ajuste dinámico que refleja el impacto del coste acumulado, por ejemplo, simulando cuánto se cansa un senderista y Capacidad en origen define cuánto coste puede asimilar un origen antes de alcanzar su límite. Dirección del viaje identifica si el elemento en movimiento parte de un origen y se mueve a ubicaciones distintas del origen o parte de ubicaciones distintas del origen y regresa a un origen.

  • Si alguno de los parámetros de las características del origen se especifica usando un campo, la característica del origen se aplicará para cada origen en función de la información del campo dado para los datos de origen. Cuando se especifica una palabra clave o un valor constante, se aplica a todos los orígenes.

  • Si se especifica Coste de inicio en origen y Dirección del viaje es Viaje desde el origen, las ubicaciones de origen de la superficie de coste-distancia de salida se establecerán en el valor de Coste de inicio en origen; de lo contrario, las ubicaciones de origen de la superficie de coste-distancia de salida se establecerán en cero.

  • Esta herramienta admite el procesamiento en paralelo. Si su equipo tiene varios procesadores o procesadores con varios núcleos, puede conseguir un mayor rendimiento, especialmente en los datasets mayores. Consulte el tema de ayuda Procesamiento en paralelo con Spatial Analyst para obtener más detalles acerca de esta posibilidad y cómo configurarla.

    Al utilizar el procesamiento en paralelo, se escriben datos temporales para administrar los lotes de datos a medida que se procesan. La ubicación de la carpeta temporal predeterminada será su unidad C: local. Es posible controlar la ubicación de esta carpeta cambiando el valor de una variable de entorno del sistema denominada TempFolders y especificando la ruta de la carpeta que se desea usar (por ejemplo, E:\RasterCache). Si tiene privilegios de administrador en su equipo, también puede usar una clave de registro (por ejemplo, [HKEY_CURRENT_USER\SOFTWARE\ESRI\ArcGISPro\Raster]).

    De forma predeterminada, esta herramienta usará el 50 por ciento de los núcleos disponibles. Si los datos de entrada tienen un tamaño inferior a 5000 x 5000 celdas, es posible que se utilicen menos núcleos. Es posible controlar el número de núcleos empleados por la herramienta, a través de la configuración de entorno de Factor de procesamiento en paralelo.

  • Cuando el formato de ráster de salida es .crf, esta herramienta admite el entorno de almacenamiento ráster Pirámide. De forma predeterminada, se crearán pirámides en la salida. Para cualquier otro formato de salida, este entorno no es compatible y no se crearán pirámides.

  • Consulte Entornos de análisis y Spatial Analyst para obtener detalles adicionales sobre los entornos de geoprocesamiento válidos para esta herramienta.

Parámetros

EtiquetaExplicaciónTipo de datos
Ráster o datos de origen de entidad de entrada

Ubicaciones de origen de entrada.

Se trata de un ráster o entidad (de punto, línea o polígono) que identifica las celdas o ubicaciones que se utilizarán para calcular la distancia de menor coste acumulado para cada ubicación de celda de salida.

Para los rásteres, el tipo de entrada puede ser de tipo entero o punto flotante.

Raster Layer; Feature Layer
Ráster de costes de entrada
(Opcional)

Ráster que define la impedancia o el coste de hacer un movimiento planimétrico por medio de cada celda.

El valor de cada ubicación de celda representa la distancia de coste por unidad para moverse a través de la celda. Cada valor de ubicación de celda se multiplica por la resolución de la celda mientras que también se compensa por el movimiento diagonal para obtener el coste total de pasar por medio de la celda.

Los valores del ráster de coste pueden ser enteros o de punto flotante, pero no pueden ser negativos o cero (no puede tener un coste negativo o cero).

Raster Layer
Ráster de superficie de entrada
(Opcional)

Ráster que define los valores de elevación de cada ubicación de celda.

Los valores se utilizan para calcular la distancia de la superficie actual cubierta al pasar entre las celdas.

Raster Layer
Ráster horizontal de entrada
(Opcional)

Ráster que define la dirección horizontal de cada celda.

Los valores del ráster deben ser números enteros comprendidos entre 0 y 360, con 0 grados al norte o hacia la parte superior de la pantalla y que aumentan en el sentido de las agujas del reloj. Las áreas llanas deben tener el valor -1. Los valores de cada ubicación se utilizarán en conjunto con el parámetro Factor horizontal para determinar el coste horizontal en que se incurre al realizar el movimiento desde una celda hasta sus elementos próximos.

Raster Layer
Factor horizontal
(Opcional)

Especifica la relación entre el factor de coste horizontal y el ángulo de movimiento relativo horizontal (HRMA).

Existen varios factores con modificadores que identifican un gráfico de factor horizontal definido. Además, se puede utilizar una tabla para crear un gráfico personalizado. Los gráficos se utilizan para identificar el factor horizontal utilizado para calcular el coste total de realizar el movimiento hacia una celda próxima.

En las descripciones de abajo se utilizan dos acrónimos: HF, que significa factor horizontal y define la dificultad horizontal con la se encuentra al realizar un movimiento desde una celda a la siguiente; y HRMA, que significa ángulo de movimiento relativo horizontal y define el ángulo entre la dirección horizontal de una celda y la dirección del movimiento.

Las opciones para Factor horizontal son las siguientes:

  • Binario: si el HRMA es menor que el ángulo de corte, el HF está establecido en el valor asociado al factor cero; de lo contrario, es infinito.
  • Adelante: solo se permite el movimiento hacia delante. El HRMA debe ser mayor o igual que 0 y menor que 90 grados (0 <= HRMA <90). Si el HRMA es mayor que 0 y menor que 45 grados, el HF de la celda se establece para el valor asociado con el factor cero. Si el HRMA es mayor o igual que 45 grados, se utiliza el valor de modificación del valor lateral. El HF de cualquier HRMA que sea igual o mayor que 90 grados se establece como infinito.
  • Lineal: el HF es una función lineal del HRMA.
  • Lineal inversa: el HF es una función lineal inversa del HRMA.
  • Tabla: se utilizará un archivo de tabla para definir el gráfico de factor horizontal utilizado para determinar los HF.

Los modificadores de los factores horizontales son los siguientes:

  • Factor cero: el factor horizontal que se utilizará cuando el HRMA sea cero. Este factor posiciona el interceptor y para cualquiera de las funciones de los factores horizontales.
  • Ángulo de corte: el ángulo HRMA más allá del cual el HF se establecerá en infinito.
  • Pendiente: la pendiente de la línea recta utilizada con las palabras clave de factor horizontal Lineal y Lineal inversa. La pendiente se especifica como una fracción de aumento sobre la ejecución (por ejemplo, 45 de pendiente en porcentaje es 1/45, lo que es entrada como 0,02222).
  • Valor lateral: el HF cuando el HRMA es mayor o igual a 45 grados y menor que 90 grados cuando se especifica la palabra clave de factor horizontal Adelante.
  • Nombre de tabla: el nombre de la tabla que define el HF.
Horizontal Factor
Ráster vertical de entrada
(Opcional)

Ráster que define los valores z de cada ubicación de celda.

Los valores se utilizan para calcular la pendiente utilizada para identificar el factor vertical incurrido al realizar un movimiento de una celda a otra.

Raster Layer
Factor vertical
(Opcional)

Especifica la relación entre el factor de coste vertical y el ángulo de movimiento relativo vertical (VRMA).

Existen varios factores con modificadores que identifican un gráfico de factor vertical definido. Además, se puede utilizar una tabla para crear un gráfico personalizado. Los gráficos se utilizan para identificar el factor vertical utilizado para calcular el coste total de realizar el movimiento hacia una celda próxima.

En las descripciones de abajo se utilizan dos acrónimos: VF, que significa factor vertical y define la dificultad vertical encontrada al realizar un movimiento desde una celda a la siguiente; y VRMA, que significa ángulo de movimiento relativo vertical e identifica el ángulo de pendiente entre la celda FROM o, celda de procesamiento, y la celda TO.

Las opciones para Factor vertical son las siguientes:

  • Binario: si el VRMA es mayor que el ángulo de corte bajo y menor que el ángulo de corte alto, el VF está establecido en el valor asociado al factor cero; de lo contrario, es infinito.
  • Lineal: el VF es una función lineal del VRMA.
  • Lineal simétrica: el VF es una función lineal del VRMA tanto en el lado negativo como en el positivo del VRMA, respectivamente, y las dos funciones lineales son simétricas con respecto al eje VF (y).
  • Lineal inversa: el VF es una función lineal inversa del VRMA.
  • Lineal inversa simétrica: el VF es una función lineal del VRMA tanto en el lado negativo como en el positivo del VRMA, respectivamente, y las dos funciones lineales son simétricas con respecto al eje VF (y).
  • Cos: el VF es la función de base coseno del VRMA.
  • Sec: el VF es la función de base secante del VRMA.
  • Cos-Sec: el VF es la función de base coseno del VRMA cuando el VRMA es negativo y la función de base secante del VRMA cuando el VRMA no es negativo.
  • Sec-Cos: el VF es la función de base secante del VRMA cuando el VRMA es negativo y la función de base coseno del VRMA cuando el VRMA no es negativo.
  • Tabla: se utilizará un archivo de tabla para definir el gráfico de factor vertical que se utiliza para determinar los VF.

Los modificadores de las palabras clave verticales son los siguientes:

  • Factor cero: el factor vertical que se utilizará cuando el VRMA sea cero. Este factor posiciona el interceptor y de la función especificada. Por definición, el factor cero no es aplicable a ninguna de las funciones verticales trigonométricas (COS, SEC, COS-SEC o SEC-COS). El interceptor y se define mediante estas funciones.
  • Ángulo de corte bajo: el ángulo VRMA por debajo del cual el VF se establecerá en infinito.
  • Ángulo de corte alto: el ángulo VRMA por encima del cual el VF se establecerá en infinito.
  • Pendiente: la pendiente de la línea recta utilizada con las palabras clave de factor vertical Lineal y Lineal inversa. La pendiente se especifica como una fracción de aumento sobre la ejecución (por ejemplo, 45 de pendiente en porcentaje es 1/45, lo que es entrada como 0,02222).
  • Nombre de tabla: el nombre de la tabla que define el VF.
Vertical Factor
Distancia máxima
(Opcional)

El umbral que los valores de coste acumulado no pueden superar.

Si un valor de distancia de coste acumulado supera este valor, el valor de salida de la ubicación de la celda será NoData. La distancia máxima es la extensión por la cual se calculan los costes-distancia acumulados.

La distancia predeterminada es hasta el borde del ráster de salida.

Double
Ráster de vínculo de menor coste de salida
(Opcional)

Ráster de vínculo de coste de salida.

El ráster de vínculo contiene valores de 0 a 8 que definen la dirección o identifican la siguiente celda vecina (la celda que sigue) a lo largo de la ruta con menor coste acumulativo desde una celda para alcanzar el origen de menor coste teniendo en cuenta la distancia de superficie y los factores de superficie vertical y horizontal.

Si la ruta consiste en pasar al vecino de la derecha, se le asignará el valor 1, 2 para la celda diagonal inferior derecha y continuará en el sentido de las agujas del reloj. El valor 0 se reserva para las celdas de origen.

Posiciones de vínculo
Raster Dataset
Multiplicador que se debe aplicar a los costes
(Opcional)

Multiplicador que se aplicará a los valores de coste.

Permite controlar el modo de viaje o la magnitud en un origen. Cuanto mayor sea el multiplicador, mayor será el coste de moverse a través de cada celda.

Los valores deben ser mayores que cero. El valor predeterminado es 1.

Double; Field
Coste inicial
(Opcional)

El coste inicial que se utilizará al principio de los cálculos del coste.

Permite especificar el coste fijo asociado a un origen. En lugar de empezar con un coste cero, el algoritmo de coste empezará con el valor establecido por Coste inicial.

Los valores deben ser mayores o iguales que cero. El valor predeterminado es 0.

Double; Field
Tasa de resistencia del coste acumulado
(Opcional)

Este parámetro simula el aumento del esfuerzo para sobreponerse a los costes a medida que aumenta el coste acumulado. Se utiliza para modelar el cansancio del viajero. El coste acumulado que aumenta para llegar a una celda se multiplica por la tasa de resistencia y se agrega al coste de moverse a la celda siguiente.

Es una versión modificada de una fórmula de tasa de interés compuesto que se usa para calcular el coste aparente de moverse por una celda. A medida que aumenta el valor de la tasa de resistencia, aumenta el coste de las celdas que se visitan más tarde. Cuando mayor sea la tasa de resistencia, más coste se agregará a la celda siguiente, que se calcula para cada movimiento posterior. Como la tasa de resistencia es similar a una tasa compuesta y normalmente los valores del coste acumulado son muy grandes, es recomendable usar tasas de resistencia pequeñas, como 0,02 o 0,005, o incluso menores, dependiendo de los valores del coste acumulado.

Los valores deben ser mayores o iguales que cero. El valor predeterminado es 0.

Double; Field
Capacidad
(Opcional)

La capacidad de coste de la persona que viaja para un origen.

Los cálculos de coste continúan para cada origen hasta que se alcanza la capacidad especificada.

Los valores deben ser mayores que cero. La capacidad predeterminada es hasta el borde del ráster de salida.

Double; Field
Dirección del viaje
(Opcional)

Especifica la dirección de la persona que viaja al aplicar factores horizontales y verticales y la tasa de resistencia en origen.

Si selecciona la opción Cadena de caracteres, puede elegir entre las opciones desde y hasta, que se aplicarán a todos los orígenes.

Si selecciona la opción Campo, puede seleccionar el campo de los datos de origen que determine qué dirección se debe usar para cada origen. El campo debe contener la cadena de caracteres de texto FROM_SOURCE o TO_SOURCE.

  • Viaje desde el origenEl factor horizontal, el factor vertical y la tasa de resistencia en origen se aplicarán empezando por el origen de entrada y avanzando hacia las celdas que no pertenezcan al origen. Esta es la opción predeterminada.
  • Viaje hasta el origenEl factor horizontal, el factor vertical y la tasa de resistencia en origen se aplicarán empezando por cada celda que no pertenezca al origen y regresando al origen de entrada.
String; Field

Valor de retorno

EtiquetaExplicaciónTipo de datos
Ráster de coste de distancia de salida

Ráster de distancia de ruta de salida.

El ráster de distancia de ruta de salida identifica, para cada celda, el menor coste-distancia acumulado sobre una superficie hacia las ubicaciones de origen identificadas, mientras que representa la distancia de superficie, así como los factores de superficie vertical y horizontal.

Un origen puede ser una celda, un conjunto de celdas o una o más ubicaciones de entidades.

El ráster de salida es de tipo de punto flotante.

Raster

PathDistance(in_source_data, {in_cost_raster}, {in_surface_raster}, {in_horizontal_raster}, {horizontal_factor}, {in_vertical_raster}, {vertical_factor}, {maximum_distance}, {out_backlink_raster}, {source_cost_multiplier}, {source_start_cost}, {source_resistance_rate}, {source_capacity}, {source_direction})
NombreExplicaciónTipo de datos
in_source_data

Ubicaciones de origen de entrada.

Se trata de un ráster o entidad (de punto, línea o polígono) que identifica las celdas o ubicaciones que se utilizarán para calcular la distancia de menor coste acumulado para cada ubicación de celda de salida.

Para los rásteres, el tipo de entrada puede ser de tipo entero o punto flotante.

Raster Layer; Feature Layer
in_cost_raster
(Opcional)

Ráster que define la impedancia o el coste de hacer un movimiento planimétrico por medio de cada celda.

El valor de cada ubicación de celda representa la distancia de coste por unidad para moverse a través de la celda. Cada valor de ubicación de celda se multiplica por la resolución de la celda mientras que también se compensa por el movimiento diagonal para obtener el coste total de pasar por medio de la celda.

Los valores del ráster de coste pueden ser enteros o de punto flotante, pero no pueden ser negativos o cero (no puede tener un coste negativo o cero).

Raster Layer
in_surface_raster
(Opcional)

Ráster que define los valores de elevación de cada ubicación de celda.

Los valores se utilizan para calcular la distancia de la superficie actual cubierta al pasar entre las celdas.

Raster Layer
in_horizontal_raster
(Opcional)

Ráster que define la dirección horizontal de cada celda.

Los valores del ráster deben ser números enteros comprendidos entre 0 y 360, con 0 grados al norte o hacia la parte superior de la pantalla y que aumentan en el sentido de las agujas del reloj. Las áreas llanas deben tener el valor -1. Los valores de cada ubicación se utilizarán en conjunto con el parámetro horizontal_factor para determinar el coste horizontal incurrido al realizar el movimiento de una celda hacia sus vecinos.

Raster Layer
horizontal_factor
(Opcional)

El objeto Horizontal Factor define la relación entre el factor de coste horizontal y el ángulo de movimiento relativo horizontal.

Existen varios factores con modificadores que identifican un gráfico de factor horizontal definido. Además, se puede utilizar una tabla para crear un gráfico personalizado. Los gráficos se utilizan para identificar el factor horizontal utilizado para calcular el coste total de realizar el movimiento hacia una celda próxima.

En las descripciones de abajo se utilizan dos acrónimos: HF, que significa factor horizontal y define la dificultad horizontal con la se encuentra al realizar un movimiento desde una celda a la siguiente; y HRMA, que significa ángulo de movimiento relativo horizontal y define el ángulo entre la dirección horizontal de una celda y la dirección del movimiento.

El objeto se presenta de las siguientes maneras:

Sus definiciones y parámetros son los siguientes:

  • HfBinary({zeroFactor}, {cutAngle})

    Si el HRMA es menor que el ángulo de corte, el HF está establecido en el valor asociado al factor cero; de lo contrario, es infinito.

  • HfForward({zeroFactor}, {sideValue})

    Solo se permite el movimiento hacia delante. El HRMA debe ser mayor o igual que 0 y menor que 90 (0 <= HRMA < 90). Si el HRMA es mayor que 0 y menor que 45 grados, el HF de la celda se establece para el valor asociado con el factor cero. Si el HRMA es mayor o igual que 45 grados, se utiliza el valor de modificación del valor lateral. El HF de cualquier HRMA que sea igual o mayor que 90 grados se establece como infinito.

  • HfLinear({zeroFactor}, {cutAngle}, {slope})

    El HF es una función lineal del HRMA.

  • HfInverseLinear({zeroFactor}, {cutAngle}, {slope})

    El HF es una función lineal inversa del HRMA.

  • HfTable(inTable)

    Se utilizará un archivo de tabla para definir el gráfico de factor horizontal utilizado para determinar los HF.

Los modificadores para las palabras clave horizontales son los siguientes:

  • zeroFactor: el factor horizontal que se utilizará cuando el HRMA sea 0. Este factor posiciona el interceptor y para cualquiera de las funciones de los factores horizontales.
  • cutAngle: el ángulo HRMA más allá del cual el HF se establecerá en infinito.
  • slope: la pendiente de la línea recta utilizada con las palabras clave de factor horizontal HfLinear y HfInverseLinear. La pendiente se especifica como una fracción de aumento sobre la ejecución (por ejemplo, 45 de pendiente en porcentaje es 1/45, lo que es entrada como 0,02222).
  • sideValue: el HF cuando el HRMA es mayor o igual a 45 grados y menor que 90 grados cuando se especifica la palabra clave de factor horizontal HfForward.
  • inTable: el nombre de la tabla que define el HF.

Horizontal Factor
in_vertical_raster
(Opcional)

Ráster que define los valores z de cada ubicación de celda.

Los valores se utilizan para calcular la pendiente utilizada para identificar el factor vertical incurrido al realizar un movimiento de una celda a otra.

Raster Layer
vertical_factor
(Opcional)

El objeto Vertical factor define la relación entre el factor de coste vertical y el ángulo de movimiento relativo vertical (VRMA).

Existen varios factores con modificadores que identifican un gráfico de factor vertical definido. Además, se puede utilizar una tabla para crear un gráfico personalizado. Los gráficos se utilizan para identificar el factor vertical utilizado para calcular el coste total de realizar el movimiento hacia una celda próxima.

En las descripciones de abajo se utilizan dos acrónimos: VF, que significa factor vertical y define la dificultad vertical encontrada al realizar un movimiento desde una celda a la siguiente; y VRMA, que significa ángulo de movimiento relativo vertical e identifica el ángulo de pendiente entre la celda FROM o, celda de procesamiento, y la celda TO.

El objeto se presenta de las siguientes maneras:

Sus definiciones y parámetros son los siguientes:

  • VfBinary({zeroFactor}, {lowCutAngle}, {highCutAngle})

    Si el VRMA es mayor que el ángulo de corte bajo y menor que el ángulo de corte alto, el VF está establecido en el valor asociado al factor cero; de lo contrario, es infinito.

  • VfLinear({zeroFactor}, {lowCutAngle}, {highCutAngle}, {slope})

    El VF es una función lineal del VRMA.

  • VfInverseLinear({zeroFactor}, {lowCutAngle}, {highCutAngle}, {slope})

    El VF es una función lineal inversa del VRMA.

  • VfSymLinear({zeroFactor}, {lowCutAngle}, {highCutAngle}, {slope})

    El VF es una función lineal del VRMA tanto en el lado negativo como en el positivo del VRMA, respectivamente, y las dos funciones lineales son simétricas con respecto al eje VF (y).

  • VfSymInverseLinear({zeroFactor}, {lowCutAngle}, {highCutAngle}, {slope})

    El VF es una función lineal del VRMA tanto en el lado negativo como en el positivo del VRMA, respectivamente, y las dos funciones lineales son simétricas con respecto al eje VF (y).

  • VfCos({lowCutAngle}, {highCutAngle}, {cosPower})

    El VF es la función de base coseno del VRMA.

  • VfSec({lowCutAngle}, {highCutAngle}, {secPower})

    El VF es la función de base secante del VRMA.

  • VfCosSec({lowCutAngle}, {highCutAngle}, {cosPower}, {secPower})

    El VF es la función de base coseno del VRMA cuando el VRMA es negativo y la función de base secante del VRMA cuando el VRMA no es negativo.

  • VfSecCos({lowCutAngle}, {highCutAngle}, {secPower}, {cos_power})

    El VF es la función de base secante del VRMA cuando el VRMA es negativo y la función de base coseno del VRMA cuando el VRMA no es negativo.

  • VfTable(inTable)

    Se utilizará un archivo de tabla para definir el gráfico de factor vertical utilizado para determinar los VF.

Los modificadores de los parámetros verticales son los siguientes:

  • zeroFactor: el factor vertical que se utilizará cuando el VRMA sea cero. Este factor posiciona el interceptor y de la función especificada. Por definición, el factor cero no es aplicable a ninguna de las funciones verticales trigonométricas (Cos, Sec, Cos-Sec o Sec-Cos). El interceptor y se define mediante estas funciones.
  • lowCutAngle: el ángulo VRMA por debajo del cual el VF se establecerá en infinito.
  • highCutAngle: el ángulo VRMA por encima del cual el VF se establecerá en infinito.
  • slope: la pendiente de la línea recta utilizada con los parámetros VfLinear y VfInverseLinear. La pendiente se especifica como una fracción de aumento sobre la ejecución (por ejemplo, 45 de pendiente en porcentaje es 1/45, lo que es entrada como 0,02222).
  • inTable: el nombre de la tabla que define el VF.
Vertical Factor
maximum_distance
(Opcional)

El umbral que los valores de coste acumulado no pueden superar.

Si un valor de distancia de coste acumulado supera este valor, el valor de salida de la ubicación de la celda será NoData. La distancia máxima es la extensión por la cual se calculan los costes-distancia acumulados.

La distancia predeterminada es hasta el borde del ráster de salida.

Double
out_backlink_raster
(Opcional)

Ráster de vínculo de coste de salida.

El ráster de vínculo contiene valores de 0 a 8 que definen la dirección o identifican la siguiente celda vecina (la celda que sigue) a lo largo de la ruta con menor coste acumulativo desde una celda para alcanzar el origen de menor coste teniendo en cuenta la distancia de superficie y los factores de superficie vertical y horizontal.

Si la ruta consiste en pasar al vecino de la derecha, se le asignará el valor 1, 2 para la celda diagonal inferior derecha y continuará en el sentido de las agujas del reloj. El valor 0 se reserva para las celdas de origen.

Posiciones de vínculo
Raster Dataset
source_cost_multiplier
(Opcional)

Multiplicador que se aplicará a los valores de coste.

Permite controlar el modo de viaje o la magnitud en un origen. Cuanto mayor sea el multiplicador, mayor será el coste de moverse a través de cada celda.

Los valores deben ser mayores que cero. El valor predeterminado es 1.

Double; Field
source_start_cost
(Opcional)

El coste inicial que se utilizará al principio de los cálculos del coste.

Permite especificar el coste fijo asociado a un origen. En lugar de empezar con un coste cero, el algoritmo de coste empezarán con el valor establecido en por source_start_cost.

Los valores deben ser mayores o iguales que cero. El valor predeterminado es 0.

Double; Field
source_resistance_rate
(Opcional)

Este parámetro simula el aumento del esfuerzo para sobreponerse a los costes a medida que aumenta el coste acumulado. Se utiliza para modelar el cansancio del viajero. El coste acumulado que aumenta para llegar a una celda se multiplica por la tasa de resistencia y se agrega al coste de moverse a la celda siguiente.

Es una versión modificada de una fórmula de tasa de interés compuesto que se usa para calcular el coste aparente de moverse por una celda. A medida que aumenta el valor de la tasa de resistencia, aumenta el coste de las celdas que se visitan más tarde. Cuando mayor sea la tasa de resistencia, más coste se agregará a la celda siguiente, que se calcula para cada movimiento posterior. Como la tasa de resistencia es similar a una tasa compuesta y normalmente los valores del coste acumulado son muy grandes, es recomendable usar tasas de resistencia pequeñas, como 0,02 o 0,005, o incluso menores, dependiendo de los valores del coste acumulado.

Los valores deben ser mayores o iguales que cero. El valor predeterminado es 0.

Double; Field
source_capacity
(Opcional)

La capacidad de coste de la persona que viaja para un origen.

Los cálculos de coste continúan para cada origen hasta que se alcanza la capacidad especificada.

Los valores deben ser mayores que cero. La capacidad predeterminada es hasta el borde del ráster de salida.

Double; Field
source_direction
(Opcional)

Especifica la dirección de la persona que viaja al aplicar factores horizontales y verticales y la tasa de resistencia en origen.

  • FROM_SOURCEEl factor horizontal, el factor vertical y la tasa de resistencia en origen se aplicarán empezando por el origen de entrada y avanzando hacia las celdas que no pertenezcan al origen. Esta es la opción predeterminada.
  • TO_SOURCEEl factor horizontal, el factor vertical y la tasa de resistencia en origen se aplicarán empezando por cada celda que no pertenezca al origen y regresando al origen de entrada.

Especifique la palabra clave FROM_SOURCE o TO_SOURCE, que se aplicará a todos los orígenes, o bien especifique un campo en los datos de origen que contenga las palabras clave para identificar la dirección de viaje para cada origen. Ese campo debe contener la cadena de caracteres FROM_SOURCE o TO_SOURCE.

String; Field

Valor de retorno

NombreExplicaciónTipo de datos
out_distance_raster

Ráster de distancia de ruta de salida.

El ráster de distancia de ruta de salida identifica, para cada celda, el menor coste-distancia acumulado sobre una superficie hacia las ubicaciones de origen identificadas, mientras que representa la distancia de superficie, así como los factores de superficie vertical y horizontal.

Un origen puede ser una celda, un conjunto de celdas o una o más ubicaciones de entidades.

El ráster de salida es de tipo de punto flotante.

Raster

Muestra de código

Ejemplo 1 de PathDistance (ventana de Python)

El siguiente script de la ventana de Python muestra cómo utilizar la herramienta PathDistance.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outPathDist = PathDistance("observers.shp", "costraster", "elevation", "hfraster",
                            HfForward(0.5, 1.0), "elevation", VfBinary(1.0, -30, 30),  
                            "", "c:/sapyexamples/output/backlinkpath", "Multiplier", "StartCost", "Resistance", 500000)
outPathDist.save("c:/sapyexamples/output/pathdistout")
Ejemplo 2 de PathDistance (script independiente)

Calcula para cada celda la distancia de coste acumulativo inferior a la fuente más cercana a la vez que se tiene en cuenta la distancia de la superficie y los factores de coste vertical y horizontal.

# Name: PathDistance_Ex_02.py
# Description: Calculates, for each cell, the least accumulative 
#              cost distance to the nearest source, while accounting 
#              for surface distance and horizontal and vertical 
#              cost factors.  
# Requirements: Spatial Analyst Extension

# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *

# Set environment settings
env.workspace = "C:/sapyexamples/data"

# Set local variables
inSource = "observers.shp"
inCostRast = "costraster"
inElev = "elevation"

# The horizontal factor
inHoriz = "backlink2"
# Create the HfForward Object
zeroFactor = 0.5
sideValue = 1.0
myHorizFactor = HfForward(zeroFactor, sideValue)

#The vertical factor
inVertical = "focalcost.tif"
# Create the VfBinary Object
zeroFactor = 1.0
lowCutAngle = -30
highCutAngle = 30
myVerticalFactor = VfBinary(zeroFactor, lowCutAngle, highCutAngle)

maxDist = 50000
optBacklinkOut = "c:/sapyexamples/output/pathbacklink"

# Execute PathDistance
outPathDist = PathDistance(inSource, inCostRast, inElev, inHoriz, 
                           myHorizFactor, inVertical, myVerticalFactor, 
                           maxDist, optBacklinkOut)

# Save the output 
outPathDist.save("c:/sapyexamples/output/pathdistout02")

Información de licenciamiento

  • Basic: Requiere Spatial Analyst
  • Standard: Requiere Spatial Analyst
  • Advanced: Requiere Spatial Analyst

Temas relacionados