Función Coste de distancia

Disponible con una licencia de Spatial Analyst.

Descripción general

Calcula el menor coste-distancia acumulativo para cada celda desde o hasta el origen de menor coste por una superficie de coste.

Heredado:

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

La función Acumulación de distancia proporciona una funcionalidad y rendimiento mejorados.

Ilustración de Coste-distancia

Más información sobre el funcionamiento de las herramientas de coste-distancia

Esta es una función ráster global.

Notas

Los datos de origen de entrada deben ser una capa ráster.

Los valores NoData que existen en el Ráster de origen no se incluyen como valores válidos en la función. El valor 0 se considera un valor legítimo en el ráster de origen. Se puede crear un Ráster de origen usando las herramientas de extracción o la función Recortar.

Si tiene entidades de origen, puede convertirlas a un dataset ráster con la función Rasterizar entidades. Use el Ráster de costes existente como el Ráster de entrada en la función de rasterización. De esta manera, se garantiza que las entidades se conviertan adecuadamente a un dataset ráster con el mismo tamaño de celda, extensión y referencia espacial.

Las ubicaciones de las celdas NoData en el ráster de costes de entrada actúan como barreras en las herramientas de superficie de costes. Cualquier ubicación de celdas a la que se le asigne NoData en la superficie de coste de entrada recibirá NoData en todos los rásteres de salida (coste de distancia, asignación y vínculo).

Los valores de celda de NoData del Ráster de costes actúan como barreras en la superficie de coste. Las celdas que tengan asignado un valor NoData en el Ráster de costes también tendrán un valor NoData en el ráster de salida. El Ráster de costes no puede contener ningún valor de 0, ya que el algoritmo es un proceso multiplicativo. Si los valores de 0 representan áreas de bajo coste, cambie el valor de 0 a un valor positivo pequeño, como 0,01, usando la función Evaluación condicional. Si el valor de 0 representa áreas que deberían excluirse del análisis, estos valores deben convertirse en NoData usando la función Establecer nulos.

Si Ráster de origen y Ráster de costes tienen diferentes extensiones, la extensión de salida predeterminada será la intersección de los dos rásteres. Para obtener una salida de superficie de coste-distancia para toda la extensión, elija la opción Combinación de entradas de los entornos de geoprocesamiento de Extensión de salida.

La Distancia máxima se especifica en la misma unidad de coste que el Ráster de costes.

Las características del origen o los elementos que se mueven desde un origen, se pueden controlar por medio de los siguientes parámetros:

  • Multiplicador para aplicar a los costes: el modo de desplazamiento o la magnitud en el origen.
  • Coste inicial: el coste inicial antes de que se inicie el movimiento.
  • Tasa de resistencia del coste acumulado: ajuste dinámico que refleja el impacto del coste acumulado, por ejemplo, simulando cuánto se fatiga un senderista.
  • Capacidad: el coste que un origen puede asimilar antes de alcanzar su límite.

Si se especifica cualquier otro parámetro de características del origen usando un valor, ese valor se aplica a todos los orígenes. Si los parámetros se especifican mediante campos asociados al Ráster de origen, los valores de la tabla se aplicarán de forma exclusiva a los orígenes correspondientes.

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

Si se ha establecido una Máscara en los entornos de geoprocesamiento, todas las celdas con máscara se tratarán como valores NoData. Cuando se define una máscara en la ventana Análisis ráster y las celdas que serán enmascaradas crearán una máscara en el origen, los cálculos ocurrirán en las celdas de origen restantes. Las celdas de origen con máscaras no se considerarán en los cómputos. Las ubicaciones de estas celdas se asignarán como NoData en el ráster de salida. Consulte Entornos de análisis y Spatial Analyst para obtener detalles adicionales sobre los entornos de geoprocesamiento válidos para esta función.

Parámetros

Nombre del parámetroDescripción

Ráster de origen

(Requerido)

Ubicaciones de origen de entrada.

Es un ráster dataset que identifica las celdas o las ubicaciones desde las que se calcula el menor coste-distancia acumulado para cada ubicación de celda de salida.

Ráster de costes

(Requerido)

Ráster que define el coste o la impedancia de hacer un movimiento planimétrico a través 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 la celda.

Los valores del Ráster de costes pueden ser enteros o de punto flotante, pero no pueden ser negativos ni cero.

Distancia máxima

El umbral que los valores de coste acumulado no pueden superar. Si un coste-distancia acumulado supera este valor, el valor de salida de la ubicación de la celda será NoData. La distancia máxima define la extensión por la cual se calculan las distancias de coste acumulado. La distancia predeterminada es hasta la extensión del ráster de salida.

Multiplicador para aplicar a los costes

Multiplicador que se aplicará a los valores de coste.

Este parámetro 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.

Un valor numérico (doble) o un campo del Ráster de origen se pueden usar para este parámetro.

Coste inicial

El coste inicial que se utilizará al principio de los cálculos del coste. Este parámetro permite especificar el coste fijo asociado a un origen. En lugar de empezar con un coste de 0, el algoritmo de coste empezará con el valor especificado.

El valor debe ser mayor o igual que cero. El valor predeterminado es 0.

Tasa de resistencia del coste acumulado

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 atravesar 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. Cuanto mayor sea la tasa de resistencia, más coste adicional se agregará para llegar a la celda siguiente, un valor que se suma 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,005, o incluso menores, dependiendo de los valores del coste acumulado.

El valor debe ser mayor que cero. La capacidad predeterminada es hasta el borde del ráster de salida.

Un valor numérico (doble) o un campo del Ráster de origen se pueden usar para este parámetro.

Capacidad

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

El valor debe ser mayor que cero. La capacidad predeterminada es hasta el borde del ráster de salida.

Un valor numérico (doble) o un campo del Ráster de origen se pueden usar para este parámetro.

Dirección del viaje

Define la dirección del viajero cuando se aplica la tasa de resistencia en origen.

  • Desde origen: la tasa de resistencia en origen se aplicará empezando en el origen de entrada y avanzando hacia las celdas que no pertenezcan al origen. Esta es la opción predeterminada.
  • A origen: la tasa de resistencia en origen se aplicará empezando por cada celda que no pertenezca al origen y regresando al origen de entrada.

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

Configuración del entorno

La configuración del entorno de geoprocesamiento para las funciones globales se controla en el nivel de la aplicación. La configuración de entornos de procesamiento en ArcGIS Pro se puede realizar haciendo clic en el botón Entornos en la pestaña Análisis. Consulte Entornos de análisis y Spatial Analyst para obtener detalles adicionales sobre la configuración de entornos.

Los siguientes entornos son compatibles con esta función global:

Temas relacionados