Función Acumulación de distancia

Disponible con una licencia de Spatial Analyst.

Información general

Calcula la distancia acumulada de cada celda a los orígenes, teniendo en cuenta la distancia en línea recta, coste-distancia y verdadera distancia de superficie, así como factores de coste vertical y horizontal.

Esta es una función ráster global.

Notas

Si tiene entidades de origen, puede convertirlas primero a un dataset ráster con la función Rasterizar entidades. Use una entrada uniforme para la entrada Ráster de esa funció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.

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.

Las barreras son obstáculos que deben sortearse. Pueden definirse de dos maneras.

En lo que respecta al parámetro Ráster de barrera de entrada, las barreras pueden representarse mediante celdas que tienen un valor válido o mediante datos de entidad que se convierten en ráster. Si las barreras están conectadas solamente mediante celdas diagonales, se engrosarán para hacerlas impermeables.

Las barreras también se definen mediante ubicaciones cuando existen celdas NoData en las entradas siguientes: ráster de costes de entrada, ráster de superficie de entrada, ráster vertical de entrada y ráster horizontal de entrada. Si las celdas NoData se conectan solamente mediante celdas diagonales, se engrosarán con celdas NoData adicionales para formar una barrera impermeable.

Si el valor de Ráster de superficie de entrada tiene un sistema de coordenadas verticales (VCS), se considera que los valores del ráster de superficie están en las unidades del VCS. Si el valor del Ráster de superficie de entrada no tiene un VCS y los datos se proyectan, se considera que los valores de superficie están en las unidades lineales de la referencia espacial. Si el ráster de superficie de entrada no tiene un sistema de coordenadas verticales y los datos no están proyectados, se considerará que los valores de superficie están en metros. El resultado de acumulación de distancia final se expresa en coste por unidad lineal o en unidades lineales si no se introduce el coste.

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.

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

La salida de la función Orientación se puede utilizar como entrada del parámetro Ráster horizontal.

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   ~

Al activar la opción booleana Generar banda de dirección hacia atrás como banda adicional en la salida, se creará una capa multibanda. La primera banda es el ráster de acumulación de distancia y la segunda banda es el ráster de dirección hacia atrás. Ambos rásteres son necesarios para generar una ruta óptima desde los orígenes a un destino determinado. Para generar una ruta, utilice primero la función Extraer banda para extraer el ráster de acumulación de distancia y el ráster de dirección hacia atrás; estas capas se utilizan como entrada para la función Ruta de coste. El ráster de acumulación de distancia se utilizará como Ráster de coste-distancia y el ráster de dirección hacia atrás se utilizará como Ráster de vínculo de menor coste.

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.

  • Acumulación inicial define el coste inicial antes de que se inicie el movimiento.
  • Acumulaciones máximas especifica el coste que puede acumular un origen antes de alcanzar su límite.
  • Multiplicador para aplicar a los costes especifica el modo de desplazamiento.
  • 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 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.

Si se especifica Acumulación inicial, las ubicaciones de origen de la superficie de coste-distancia de salida se establecerán en el valor de Acumulación inicial; de lo contrario, las ubicaciones de origen de la superficie de coste-distancia de salida se establecerán en cero.

Si no se especifica la configuración del entorno Extensión, la extensión de procesamiento se determina de esta manera:

  • Si solo se especifican el ráster de origen y las barreras de ráster, se utiliza la combinación de las entradas, expandida dos celdas de ancho a cada lado, como extensión de procesamiento. El motivo por el que se expande el ráster de salida dos filas y columnas es que las salidas pueden utilizarse en la función Ruta óptima como ráster o en la herramienta de geoprocesamiento Ruta óptima como línea y las rutas que se generan se pueden mover por las barreras. Para utilizar la extensión como barrera implícita, debe establecer de manera explícita el valor de Extensión en la configuración del entorno.

  • La extensión de procesamiento será la intersección de ráster de superficie, ráster de costes, ráster vertical o ráster horizontal, si se especifica.

El entorno de Máscara de análisis puede configurarse en una clase de entidad o en un dataset ráster. Si la máscara es una de entidades, se convertirá en un ráster. Las celdas que tienen un valor definen las ubicaciones que se encuentren dentro del área de la máscara. Las celdas NoData definen las ubicaciones que están fuera del área de la máscara y que se tratarán como unabarrera.

Si no se especifican las configuraciones del entorno Tamaño de celda ni Ráster de alineación y se especifican varios rásteres como entradas, el Tamaño de celda y el Ráster de alineación se definen en función del orden de prioridad: ráster de costes, ráster de superficie, ráster vertical, ráster horizontal, ráster de origen ybarreras de ráster.

Esta función 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 Procesamiento en paralelo con Spatial Analyst para más información 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 función usará el 50 por ciento de los núcleos disponibles. Si los datos de entrada tienen un tamaño inferior a 5.000 x 5.000 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.

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.

Puede ser de tipo entero o de punto flotante.

Barreras de ráster

El ráster que define las barreras.

El dataset debe contener NoData donde no haya barreras. Las barreras se representan mediante valores válidos, incluido el cero.

Las barreras pueden definirse mediante un ráster entero o de punto flotante.

Ráster de superficie

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.

Ráster de costes

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.

Ráster vertical

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

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

Factor vertical

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 empleado para calcular el coste total de realizar el movimiento hacia una celda próxima.

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

Entre los tipos de Factor vertical se incluyen los siguientes:

  • Binario: especifica que si el VRMA es mayor que el al ángulo de corte bajo y menor que el ángulo de corte alto, el VF está establecido como el valor asociado con el factor cero; de lo contrario, es infinito.
  • Lineal: indica que el VF es una función lineal de VRMA.
  • Lineal simétrica: especifica que 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: indica que el VF es una función lineal inversa de VRMA.
  • Lineal inversa simétrica: especifica que 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: identifica el VF como la función de base coseno del VRMA.
  • Sec: identifica el VF como la función de base secante del VRMA.
  • Cos-Sec: especifica que 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: especifica que 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: identifica que el archivo de tabla se utilizará para definir el gráfico de factor vertical empleado para determinar los VF.

Entre los modificadores para las palabras clave verticales se incluyen los siguientes:

  • Factor cero: establece el factor vertical que será utilizado 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: define el ángulo VRMA debajo del cuál el VF se establecerá en infinito.
  • Ángulo de corte: define el ángulo VRMA por encima del cual el VF se establecerá en infinito.
  • Pendiente: establece 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 la tabla: identifica el nombre de la tabla que define el VF.

Ráster horizontal

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.

Factores horizontales

Define 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 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 empleado para calcular el coste total de realizar el movimiento hacia una celda próxima.

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

Entre los tipos de Factor horizontal se incluyen los siguientes:

  • Binario: indica si el HRMA es menor al ángulo de corte, si el HF está establecido como el valor asociado con el factor cero; de lo contrario, es infinito.
  • Adelante: establece que sólo se permite el movimiento hacia adelante. 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 valor HRMA que sea igual o mayor que 90 grados se establece como infinito.
  • Lineal: especifica que el HF es una función lineal de HRMA.
  • Lineal: especifica que el HF es una función lineal inversa de HRMA.
  • Tabla: identifica que el archivo de tabla será utilizado para definir el gráfico de factor horizontal utilizado para determinar los HF.

Entre los modificadores para los factores horizontales se incluyen 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: define el ángulo HRMA más allá del cuál el HF se establecerá en infinito.
  • Pendiente: establece 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: establece el HF cuando el HRMA es mayor o igual a 45 grados y menor a 90 grados cuando se especifica la palabra clave del factor horizontal Adelante.
  • Nombre de la tabla: identifica el nombre de la tabla que define el HF.

Generar banda de dirección hacia atrás como banda adicional en la salida

Determina si se crea solamente el ráster de acumulación de distancia o si se crea un ráster multibanda formado por el ráster de acumulación de distancia y el ráster de dirección hacia atrás.

  • Desactivado: el resultado es el ráster de acumulación de distancia. Es un resultado de banda única. Esta es la opción predeterminada.
  • Activado: se crea un resultado multibanda. La primera banda es el ráster de acumulación de distancia y la segunda banda es el ráster de dirección hacia atrás.

El ráster de dirección hacia atrás calcula en grados, para cada celda, la dirección a la celda vecina por la ruta más corta, de vuelta al origen más cercano, a la vez que evita las barreras.

Método de distancia

Determina si la distancia se calculará utilizando un método planar (tierra plana) o geodésico (elipsoide).

  • Planar: las mediciones de tipo planar usan matemáticas cartesianas 2D para calcular la longitud y el área. Esta opción solo está disponible cuando se toman medidas en un sistema de coordenadas proyectadas y el plano 2D de ese sistema de coordenadas se utiliza como base para las mediciones.
  • Geodésico: la línea más corta entre dos puntos en la superficie terrestre de un esferoide (elipsoide). Los resultados no cambiarán, con independencia de la proyección de entrada o salida.
    Nota:

    Determinar la distancia más corta entre dos ciudades para la ruta de vuelo de un avión es uno de los usos de una línea geodésica. También se la conoce como línea de círculo grande si está basada en una esfera, en lugar de un elipsoide.

Acumulación inicial

El coste acumulativo inicial con el que comenzar el cálculo de costes. 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.

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

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

Acumulación máxima

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

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

El valor debe ser mayor que cero. La capacidad predeterminada es hasta el borde 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.

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

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

Dirección del viaje

Define la dirección del viajero cuando se aplica el factor vertical, el factor horizontal y la tasa de resistencia en origen.

  • Desde origen: el factor vertical, el factor horizontal y la tasa de resistencia en origen se aplicarán empezando en el origen de entrada y avanzando hacia las celdas que no pertenezcan al origen. Esta es la opción predeterminada.
  • A origen: el factor vertical, el factor horizontal 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 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: