Acumulación de distancia (Herramientas de Análisis ráster)

Resumen

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.

Ilustración

Flujo de trabajo Acumulación de distancia

Uso

La herramienta del portal de análisis ráster está disponibles cuando inicia sesión en un portal de ArcGIS Enterprise en el que se haya configurado ArcGIS Image Server para el Análisis de ráster. Cuando se ejecuta la herramienta, ArcGIS Pro funciona como cliente y el procesamiento tiene lugar en los servidores federados con ArcGIS Enterprise. La herramienta del portal acepta las capas de su portal como entrada y crea la salida en su portal.

La capa ráster de entrada admite una capa del portal, una URI o URL de un servicio de imágenes o la salida procedente de la herramienta Crear capa de servidor de imágenes. La capa de entidades de entrada puede ser una capa del portal o una URI o URL de un servicio de entidades. Esta herramienta no admite capas o datos ráster locales. Aunque puede usar las capas y los datos de entidades locales como entradas de esta herramienta del portal, la práctica recomendada es usar capas del portal como entrada.
Los datos de origen de entrada pueden ser un servicio de entidades o un servicio de imágenes. El servicio de entidades puede ser punto, línea o polígono.
Si el origen se encuentra en NoData en alguno de los rásteres de entrada correspondientes, se ignora en el análisis y, por lo tanto, no se calculará la distancia desde ese origen.
Cuando los datos de origen de entrada son un servicio de imágenes, 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.
Cuando los datos de origen de entrada son un servicio de entidades, 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 largo del ancho o la altura de la extensión de la entidad de entrada, en la referencia espacial de entrada, dividido entre 1000.
Para evitar esta situación, como paso intermedio, podría 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 barreras son obstáculos que deben sortearse. Pueden definirse de dos maneras.

En lo que respecta al parámetro Barreras de entidad o ráster 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 ráster de superficie de entrada tiene un sistema de coordenadas verticales, se considerará que los valores del ráster de superficie están en las unidades del sistema de coordinadas verticales. 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 valor del Ráster de superficie de entrada no tiene un VCS y los datos no se proyectan, se considera 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.
Los valores de ráster de costes que son negativos o cero no son válidos, pero se tratarán como valores positivos pequeños. El algoritmo de coste acumulativo es un proceso multiplicativo y no se puede calcular correctamente el coste acumulativo si los valores de coste son negativos o cero. Si el ráster de costes contiene esos valores y esas ubicaciones representan áreas que se van a excluir del análisis, active esas celdas en NoData antes de ejecutar la herramienta. Puede hacerlo con la extensión Establecer nulos de ArcGIS Spatial Analyst. El valor NoData se considera como una barrera en el análisis, por lo que las ubicaciones que sean NoData en la entrada serán NoData en el resultado.
Los valores predeterminados para los modificadores del Factor vertical son los siguientes:

<!--```nohighlight Palabra clave Cero Baja Alta Pendiente Potencia Cos Sec factor corte corte potencia potencia ángulo ángulo

Binaria 1.0 -30 30 ~ ~ ~ ~ Lineal 1.0 -90 90 1/90 ~ ~ ~ Lineal simétrico 1.0 -90 90 1/90 ~ ~ ~ Inversp lineal 1.0 -45 45 -1/45 ~ ~ ~ Lineal inverso simétrico 1.0 -45 45 -1/45 ~ ~ ~ Coseno ~ -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 Tiempo de senderismo ~ -70 70 ~ ~ ~ ~ Tiempo de senderismo bidireccional ~ -70 70 ~ ~ ~ ~


- La salida de la herramienta [**Orientación**](../3d-analyst/aspect.yml) de Spatial Analyst se puede utilizar como entrada del parámetro **Ráster horizontal de entrada**.

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

&lt;!--```nohighlight
Palabras clave         Factor cero   Ángulo de corte     Valor de la pendiente
--------------   -----------   -----------   -----   ---------
Binaria           1.0            45           ~       ~
Adelante          0.5            45 (fixed)   ~       1.0
Lineal           0.5           181            1/90   ~
Inverso lineal   2.0           180           -1/90   ~
```-->

- 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.

- **Acumulación máxima** especifica el coste que puede acumular un origen antes de alcanzar su límite.

- **Multiplicador de costes** especifica el modo de desplazamiento o la magnitud en el origen.

- **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 un valor de **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.

- Para manejar adecuadamente el borde de la proyección en una extensión global cuando se realiza un análisis de distancia a escala global, asegúrese de que se utiliza una proyección cilíndrica o un sistema de coordenadas de salida geográfico junto con la opción **Geodésico** para el parámetro **Método de distancia**.

- Si no se especifica la configuración del entorno [Extensión](../environment-settings/output-extent.yml), la extensión de procesamiento se determina de esta manera:

Si solo se especifican los valores de **Orígenes de ráster o entidad de entrada** y **Barreras de entidad o ráster de entrada**, se utilizará 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 para que las salidas se puedan utilizar en [**Ruta óptima como ráster**](optimal-path-as-raster.yml) y [**Ruta óptima como línea**](optimal-path-as-line.yml) y las rutas que se generan se puedan mover por las barreras. Para utilizar la extensión como barrera implícita, debe establecer de manera explícita la [Extensión](../environment-settings/output-extent.yml) en la configuración del entorno.

La extensión del procesamiento será la intersección de **Ráster de superficie de entrada**, **Ráster de costes de entrada**, **Ráster vertical de entrada** o **Ráster horizontal de entrada**, si se especifica.

- El entorno de [Máscara](../environment-settings/mask.yml) de análisis puede configurarse en un servicio de entidades o un servicio de imágenes. 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 máscara y se tratarán como una [barrera](../spatial-analyst/account-for-barriers-in-distance-calculations.md).

- Si no se especifican las configuraciones del entorno [Tamaño de celda](../environment-settings/cell-size.yml) ni [Ráster de alineación](../environment-settings/snap-raster.yml) 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 de la prioridad: **Ráster de costes de entrada**, **Ráster de superficie de entrada**, **Ráster vertical de entrada**, **Ráster horizontal de entrada**, **Orígenes de ráster o entidad de entrada** y **Barreras de entidad o ráster de entrada**.

- Consulte [Entornos de análisis y Spatial Analyst](../spatial-analyst/analysis-environments-and-spatial-analyst.md) para obtener detalles adicionales sobre los entornos de geoprocesamiento válidos para esta herramienta.

Etiqueta	Explicación	Tipo de datos
Orígenes de ráster o entidad de entrada	Ubicaciones de origen de entrada. Es un servicio de entidades o un servicio de imágenes que identifica las celdas o las ubicaciones desde o hasta las cuales se calcula el menor coste-distancia acumulado para cada ubicación de celda de salida. En el caso de un servicio de imágenes, el tipo de entrada puede ser de tipo entero o de punto flotante. En el caso de un servicio de entidades, el tipo de entrada puede ser un punto, una línea o un polígono.	Raster Layer; Feature Layer
Nombre de ráster de acumulación de distancia de salida	Nombre del ráster de acumulación de distancia de salida. El ráster de acumulación de distancia contiene la distancia acumulativa de cada celda desde el origen de menor coste o hasta él.	String
Ráster de entrada o barreras de entidad (Opcional)	El dataset que define las barreras. Las barreras pueden definirse mediante un servicio de imágenes de entero o de punto flotante o mediante un servicio de entidades. En el caso de un servicio de entidades, el tipo de entrada puede ser un punto, una línea o un polígono. En el caso de una barrera de un servicio de imágenes, la barrera debe tener un valor válido, incluido cero, y las áreas que no son barreras deben ser NoData.	Raster Layer; Feature Layer
Ráster de superficie de entrada (Opcional)	Servicio de imágenes 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.	Image Service; Raster Layer
Ráster de costes de entrada (Opcional)	Servicio de imágenes que define la impedancia o el coste de 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 medio de la celda. Los valores del ráster de costes pueden ser de tipo entero o punto flotante. Los valores de ráster de costes que son negativos o cero no son válidos, pero se tratarán como valores de costes positivos pequeños.	Image Service; Raster Layer
Ráster vertical de entrada (Opcional)	Servicio de imágenes 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.	Image Service; 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. 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 descripciones siguientes, el factor vertical (VF) define la dificultad vertical encontrada al realizar un movimiento desde una celda a la siguiente; el ángulo de movimiento relativo vertical (VRMA) identifica el ángulo de inclinación entre la celda FROM o celda de procesamiento y la celda TO. Las opciones de 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—VF es una función lineal del VRMA tanto en el lado negativo como en el positivo del VRMA, 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—VF es una función lineal del VRMA tanto en el lado negativo como en el positivo del VRMA, 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. Tiempo de caminata— Define la relación entre el factor de coste vertical y el ángulo de movimiento relativo vertical a través de la recíproca de la función de Tobler, que genera el tiempo de caminata en horas. Tiempo de caminata bidireccional—Define la relación entre el factor de coste vertical y el ángulo de movimiento relativo vertical a través de una función de caminata bidireccional. Los modificadores de las palabras clave verticales son como sigue: 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).	Vertical Factor
Ráster horizontal de entrada (Opcional)	Servicio de imágenes 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.	Image Service; Raster Layer
Factores horizontales (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. 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 siguientes, factor horizontal (HF) define la dificultad horizontal encontrada al realizar un movimiento desde una celda a la siguiente, y ángulo de movimiento relativo horizontal (HRMA) identifica el ángulo entre la dirección horizontal de una celda y la dirección del movimiento. Las opciones de 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. 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.	Horizontal Factor
Nombre de ráster de dirección hacia atrás de salida (Opcional)	Nombre del ráster de dirección hacia atrás de salida. El ráster de dirección hacia atrás contiene direcciones calculadas en grados. La dirección identifica la siguiente celda a lo largo de la ruta óptima, de vuelta al origen de menor coste-distancia acumulado, a la vez que se evitan barreras. El rango de valores oscila entre 0 y 360 grados. El valor 0 se reserva para las celdas de origen. Hacia el este (derecha) es 90 grados, y los valores aumentan en el sentido de las agujas del reloj (180 es sur, 270 es oeste y 360 es norte). El ráster de salida es de tipo flotante.	String
Nombre de ráster de dirección de origen de salida (Opcional)	Nombre del ráster de dirección de origen de salida. El ráster de dirección de origen identifica la dirección de la celda de origen de coste acumulado como acimut en grados. El rango de valores oscila entre 0 y 360 grados. El valor 0 se reserva para las celdas de origen. Hacia el este (derecha) es 90 grados, y los valores aumentan en el sentido de las agujas del reloj (180 es sur, 270 es oeste y 360 es norte). El ráster de salida es de tipo flotante.	String
Nombre de ráster de ubicación de origen de salida (Opcional)	El ráster de ubicación de origen es una salida multibanda. La primera banda contiene un índice de fila y la segunda banda contiene un índice de columna. Estos índices identifican la ubicación de la celda de origen más cercana al menor coste-distancia acumulado.	String
Acumulación inicial (Opcional)	Coste acumulativo inicial que se utilizará para comenzar el cálculo 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 en la Acumulación inicial. Los valores deben ser mayores o iguales que cero. El valor predeterminado es 0.	Double; Field
Acumulación máxima (Opcional)	La acumulación máxima de la persona que viaja para un origen. Los cálculos de coste continúan para cada origen hasta que se alcanza la acumulación especificada. Los valores deben ser mayores que cero. La acumulación predeterminada es hasta el borde del ráster de salida.	Double; Field
Multiplicador de coste (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
Dirección del viaje (Opcional)	Especifica la dirección de la persona que viaja al aplicar factores horizontales y verticales. 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 origen—El factor horizontal y el factor vertical 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 origen—El factor horizontal y el factor vertical se aplicarán empezando por las celdas que no pertenezcan al origen y regresando al origen de entrada.	String; Field
Método de distancia (Opcional)	Especifica si el cálculo se basará en un método planar (tierra plana) o geodésico (elipsoide). Planar—El cálculo de distancia se realizará sobre un plano plano proyectado usando un sistema de coordenadas cartesianas 2D. Esta es la opción predeterminada. Geodésica—El cálculo de distancia se realizará en el elipsoide. Los resultados no cambiarán, con independencia de la proyección de entrada o salida.	String

Salida derivada

Etiqueta	Explicación	Tipo de datos
Ráster de acumulación de distancia de salida	Ráster de acumulación de distancia de salida.	Raster Layer
Ráster de dirección hacia atrás de salida	El ráster de dirección hacia atrás de salida.	Raster Layer
Ráster de dirección de origen de salida	Ráster de dirección de origen de salida.	Raster Layer
Ráster de ubicación de origen de salida	Ráster de ubicación de origen de salida.	Raster Layer

arcpy.ra.DistanceAccumulation(inputSourceRasterOrFeatures, outputDistanceAccumulationRasterName, {inputBarrierRasterOrFeatures}, {inputSurfaceRaster}, {inputCostRaster}, {inputVerticalRaster}, {verticalFactor}, {inputHorizontalRaster}, {horizontalFactor}, {outputBackDirectionRasterName}, {outputSourceDirectionRasterName}, {outputSourceLocationRasterName}, {sourceInitialAccumulation}, {sourceMaximumAccumulation}, {sourceCostMultiplier}, {sourceDirection}, {distanceMethod})

Nombre	Explicación	Tipo de datos
inputSourceRasterOrFeatures	Ubicaciones de origen de entrada. Es un servicio de entidades o un servicio de imágenes que identifica las celdas o las ubicaciones desde o hasta las cuales se calcula el menor coste-distancia acumulado para cada ubicación de celda de salida. En el caso de un servicio de imágenes, el tipo de entrada puede ser de tipo entero o de punto flotante. En el caso de un servicio de entidades, el tipo de entrada puede ser un punto, una línea o un polígono.	Raster Layer; Feature Layer
outputDistanceAccumulationRasterName	Nombre del ráster de acumulación de distancia de salida. El ráster de acumulación de distancia contiene la distancia acumulativa de cada celda desde el origen de menor coste o hasta él.	String
inputBarrierRasterOrFeatures (Opcional)	El dataset que define las barreras. Las barreras pueden definirse mediante un servicio de imágenes de entero o de punto flotante o mediante un servicio de entidades. En el caso de un servicio de entidades, el tipo de entrada puede ser un punto, una línea o un polígono. En el caso de una barrera de un servicio de imágenes, la barrera debe tener un valor válido, incluido cero, y las áreas que no son barreras deben ser NoData.	Raster Layer; Feature Layer
inputSurfaceRaster (Opcional)	Servicio de imágenes 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.	Image Service; Raster Layer
inputCostRaster (Opcional)	Servicio de imágenes que define la impedancia o el coste de 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 medio de la celda. Los valores del ráster de costes pueden ser de tipo entero o punto flotante. Los valores de ráster de costes que son negativos o cero no son válidos, pero se tratarán como valores de costes positivos pequeños.	Image Service; Raster Layer
inputVerticalRaster (Opcional)	Servicio de imágenes 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.	Image Service; Raster Layer
verticalFactor (Opcional)	El `Factor vertical` define la relación que existe 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. 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 siguientes, el factor vertical (VF) define la dificultad vertical encontrada al realizar un movimiento desde una celda a la siguiente y VRMA identifica el ángulo de inclinación entre la celda FROM o celda de procesamiento y la celda TO. El objeto se presenta de las siguientes maneras: `VfBinary`, `VfLinear`, `VfInverseLinear`, `VfSymLinear`, `VfSymInverseLinear`, `VfCos`, `VfSec`, `VfSec`, `VfCosSec`, `VfSecCos`, `VfHikingTime`, `VfBidirHikingTime`, `VfTable` Las definiciones y los parámetros de estas 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, 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, 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. `VfHikingTime({lowCutAngle}, {highCutAngle})` El VF es la función de tiempo de caminata del VRMA. `VfBidirHikingTime({lowCutAngle}, {highCutAngle})` El VF es una función de tiempo de caminata bidireccional modificada del VRMA. 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).	Vertical Factor
inputHorizontalRaster (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.	Image Service; Raster Layer
horizontalFactor (Opcional)	El `Factor horizontal` define la relación que existe 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. 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 siguientes, factor horizontal (HF) define la dificultad horizontal encontrada al realizar un movimiento desde una celda a la siguiente, y ángulo de movimiento relativo horizontal (HRMA) identifica el ángulo entre la dirección horizontal de una celda y la dirección del movimiento. El objeto se presenta de las siguientes maneras: `HfBinary`, `HfForward`, `HfLinear`, and `HfInverseLinear` Las definiciones y los parámetros de estas 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. Los modificadores para las palabras clave horizontales son: `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`.	Horizontal Factor
outputBackDirectionRasterName (Opcional)	Nombre del ráster de dirección hacia atrás de salida. El ráster de dirección hacia atrás contiene direcciones calculadas en grados. La dirección identifica la siguiente celda a lo largo de la ruta óptima, de vuelta al origen de menor coste-distancia acumulado, a la vez que se evitan barreras. El rango de valores oscila entre 0 y 360 grados. El valor 0 se reserva para las celdas de origen. Hacia el este (derecha) es 90 grados, y los valores aumentan en el sentido de las agujas del reloj (180 es sur, 270 es oeste y 360 es norte). El ráster de salida es de tipo flotante.	String
outputSourceDirectionRasterName (Opcional)	Nombre del ráster de dirección de origen de salida. El ráster de dirección de origen identifica la dirección de la celda de origen de coste acumulado como acimut en grados. El rango de valores oscila entre 0 y 360 grados. El valor 0 se reserva para las celdas de origen. Hacia el este (derecha) es 90 grados, y los valores aumentan en el sentido de las agujas del reloj (180 es sur, 270 es oeste y 360 es norte). El ráster de salida es de tipo flotante.	String
outputSourceLocationRasterName (Opcional)	El ráster de ubicación de origen es una salida multibanda. La primera banda contiene un índice de fila y la segunda banda contiene un índice de columna. Estos índices identifican la ubicación de la celda de origen más cercana al menor coste-distancia acumulado.	String
sourceInitialAccumulation (Opcional)	Coste acumulativo inicial que se utilizará para comenzar el cálculo 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_initial_accumulation`. Los valores deben ser mayores o iguales que cero. El valor predeterminado es 0.	Double; Field
sourceMaximumAccumulation (Opcional)	La acumulación máxima de la persona que viaja para un origen. Los cálculos de coste continúan para cada origen hasta que se alcanza la acumulación especificada. Los valores deben ser mayores que cero. La acumulación predeterminada es hasta el borde del ráster de salida.	Double; Field
sourceCostMultiplier (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
sourceDirection (Opcional)	Especifica la dirección de la persona que viaja al aplicar factores horizontales y verticales. 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`. `FROM_SOURCE`—El factor horizontal y el factor vertical 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_SOURCE`—El factor horizontal y el factor vertical se aplicarán empezando por las celdas que no pertenezcan al origen y regresando al origen de entrada.	String; Field
distanceMethod (Opcional)	Especifica si el cálculo se basará en un método planar (tierra plana) o geodésico (elipsoide). `PLANAR`—El cálculo de distancia se realizará sobre un plano plano proyectado usando un sistema de coordenadas cartesianas 2D. Esta es la opción predeterminada. `GEODESIC`—El cálculo de distancia se realizará en el elipsoide. Los resultados no cambiarán, con independencia de la proyección de entrada o salida.	String

Salida derivada

Nombre	Explicación	Tipo de datos
outputDistanceAccumulationRaster	Ráster de acumulación de distancia de salida.	Raster Layer
outputBackDirectionRaster	El ráster de dirección hacia atrás de salida.	Raster Layer
outputSourceDirectionRaster	Ráster de dirección de origen de salida.	Raster Layer
outputSourceLocationRaster	Ráster de ubicación de origen de salida.	Raster Layer

Muestra de código

Ejemplo 1 de Acumulación de distancia (ventana de Python)

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

import arcpy

arcpy.ra.DistanceAccumulation('https://MyPortal.esri.com/server/rest/services/Hosted/sources/ImageServer',
                            'OutAccumulationRaster',
                            'https://MyPortal.esri.com/server/rest/services/Hosted/barrier/ImageServer',
                            'https://MyPortal.esri.com/server/rest/services/Hosted/surface/ImageServer',
                            'https://MyPortal.esri.com/server/rest/services/Hosted/cost/ImageServer')

Ejemplo 2 de Acumulación de distancia (script independiente)

Calcular para cada celda el menor coste-distancia acumulado respecto al origen más cercano a la vez que se tiene en cuenta la distancia de la superficie y los factores de coste vertical y horizontal.

# Name: DistanceAccumulation_Ex_02.py
# Description: Calculates the distance accumulation.
# Requirements: ArcGIS Image Server

# Import system modules
import arcpy

# Set local variables
inputSourceRasterOrFeatures = 'https://MyPortal.esri.com/server/rest/services/Hosted/sources/ImageServer'
outputDistanceAccunulationName = "outDistAccum"
inputBarrierRasterOrFeatures  = 'https://MyPortal.esri.com/server/rest/services/Hosted/barrier/ImageServer'
inputSurfaceRaster = 'https://MyPortal.esri.com/server/rest/services/Hosted/surface/ImageServer'
inputCostRaster = 'https://MyPortal.esri.com/server/rest/services/Hosted/cost/ImageServer'
inputVerticalRaster = 'https://MyPortal.esri.com/server/rest/services/vertical/sources/ImageServer'
verticalFactor = ""
inputHorizontalRaster = 'https://MyPortal.esri.com/server/rest/services/Hosted/horizontal/ImageServer'
horizontalFactor = ""
outputBackDirectionRasterName = "outBackDir"
outputSourceDirectionRasterName = "outSourceDir"
outputSourceLocationRasterName = "outSourceLocation"
sourceInitialAccumulation = "IntitalAccum"
sourceMaximumAccumulation = "500000"
sourceCostMultiplier = "CostMultiplier"
sourceDirection = "FROM_SOURCE"
distanceMethod = "PLANAR"

# Run
arcpy.ra.DistanceAccumulation(inputSourceRasterOrFeatures, outputDistanceAccumulationName,
                            inputBarrierRasterOrFeatures, inputSurfaceRaster,
                            inputCostRaster, inputVerticalRaster, verticalFactor,
                            inputHorizontalRaster, horizontalFactor,
                            outputBackDirectionRasterName, outputSourceDirectionRasterName,
                            outputSourceLocationRasterName, sourceInitialAccumulation,
                            sourceMaximumAccumulation,sourceCostMultiplier, sourceDirection, distanceMethod)

Entornos

Extensión, Tamaño de celda, Máscara, Sistema de coordenadas de salida, Pirámide, Alinear ráster

Información de licenciamiento

Basic: Requiere ArcGIS Image Server
Standard: Requiere ArcGIS Image Server
Avanzado: Requiere ArcGIS Image Server

Acumulación de distancia (Herramientas de Análisis ráster)

Resumen

Ilustración

Uso

Parámetros

Salida derivada

Entornos

Información de licenciamiento

Temas relacionados