Arcotangente (x/y) (ATan2) (Spatial Analyst)

Disponible con una licencia de Spatial Analyst.

Disponible con licencia de Image Analyst.

Resumen

Calcula la tangente inversa (basada en x,y) de celdas en un ráster.

Ilustración

Ilustración de Arcotangente (x/y) (ATan2)
OutRas = ATan2(InRas1, InRas2)

Uso

  • Arcotangente (x/y) (ATan2) convierte las coordenadas rectangulares (x,y) en coordenadas polares (r,θ), donde r es la distancia desde el origen y θ es el ángulo desde el eje x.

    Conversión de Arcotangente (x/y) (ATan2)
    Conversión de coordenadas rectangulares a polares

    La ecuación para determinar Arcotangente (x/y) (ATan2) es: tanθ = y / x (donde θ es el ángulo).

    La operación Arcotangente (x/y) (ATan2) representa todos los cuadrantes en una matriz Cartesiana (basada en el signo).

  • Los valores de la primera entrada especificada se utilizan como el numerador en el cálculo del ángulo de la tangente (y). Los valores de la segunda entrada especificada se utilizan como el denominador en el cálculo del ángulo (x).

  • En matemáticas, todas las funciones trigonométricas tienen un rango definido de valores de entrada válidos, llamado dominio. Los valores de salida de cada función también tienen un rango definido. Para esta herramienta, se cumplen las siguientes afirmaciones:

    • El domino es: -∞ < [in_value] < ∞

      Este dominio se aplica a ambas entradas.

    • El rango es: -pi < [out_value] ≤ pi

    Tenga en cuenta que -∞ e ∞ representan el valor negativo más pequeño y el positivo más grande admitidos por el formato de ráster determinado, respectivamente.

  • Si ambos valores de entrada son 0, la salida será NoData.

    Si el primer valor de entrada es 0, la salida será 0.

  • Los valores de entrada para Arcotangente (x/y) (ATan2) se interpretan como unidades lineales y para proporcionar resultados significativos deben estar ambos en la misma unidad.

  • Los valores de salida siempre son de punto flotante, sin importar el tipo de datos de entrada.

  • Los valores de salida de esta herramienta están expresados en radianes. Para utilizar grados, el ráster resultante deberá multiplicarse por el factor de conversión de radianes a grados de 180/pi ó 57,296 aproximadamente.

    Para obtener más ayuda, puede consultar el procedimiento a seguir, así como ejemplos de conversión de valores de salida expresados en unidad de radianes a grados.

  • Si ambas entradas son rásteres de banda única o una de las entradas es una constante, la salida será un ráster de banda única.

  • Si ambas entradas son rásteres multibanda, la herramienta realizará la operación en cada banda desde una entrada y la salida será un ráster multibanda. El número de bandas de cada entrada multibanda debe ser el mismo.

  • Si una de las entradas es un ráster multibanda y la otra entrada es una constante, la herramienta realizará la operación utilizando el valor constante de cada banda de la entrada multibanda, y la salida será un ráster multibanda.

  • Si ambas las entradas son datos ráster multidimensional con el mismo número de variables, la herramienta realizará la operación para todas las porciones con el mismo valor de dimensión. La salida será un ráster multidimensional en formato CRF. Las variables de las entradas deben tener al menos una dimensión común y un valor dimensional común para que procese la herramienta; de lo contrario, se producirá un error.

    Si ambas entradas tienen una variable, pero nombres diferentes, desactive el entorno de geoprocesamiento Variable multidimensional coincidente (establecer arcpy.env.matchMultidimensionalVariable = False en Python) antes de cualquier proceso.

    Si una de las entradas es un ráster multidimensional y la otra entrada es una constante, la herramienta realizará la operación en todas las porciones de todas las variables utilizando el valor constante y la salida será un ráster multidimensional.

  • 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 de entrada o valor constante 1

La entrada que especifica el numerador, o valor y, para utilizarlo cuando se calcula la tangente inversa.

Se puede utilizar un número como entrada para este parámetro, siempre que se especifique un ráster para el otro parámetro. Para especificar un número para ambas entradas, previamente se deben establecer en el entorno el tamaño de la celda y la extensión.

Raster Layer; Constant
Ráster de entrada o valor constante 2

La entrada que especifica el denominador, o valor x, para utilizarlo cuando se calcula la tangente inversa.

Se puede utilizar un número como entrada para este parámetro, siempre que se especifique un ráster para el otro parámetro. Para especificar un número para ambas entradas, previamente se deben establecer en el entorno el tamaño de la celda y la extensión.

Raster Layer; Constant

Valor de retorno

EtiquetaExplicaciónTipo de datos
Ráster de salida

El ráster de salida.

Los valores son el ángulo de la tangente inversa de los valores de entrada.

Raster

ATan2(in_raster_or_constant1, in_raster_or_constant2)
NombreExplicaciónTipo de datos
in_raster_or_constant1

La entrada que especifica el numerador, o valor y, para utilizarlo cuando se calcula la tangente inversa.

Se puede utilizar un número como entrada para este parámetro, siempre que se especifique un ráster para el otro parámetro. Para especificar un número para ambas entradas, previamente se deben establecer en el entorno el tamaño de la celda y la extensión.

Raster Layer; Constant
in_raster_or_constant2

La entrada que especifica el denominador, o valor x, para utilizarlo cuando se calcula la tangente inversa.

Se puede utilizar un número como entrada para este parámetro, siempre que se especifique un ráster para el otro parámetro. Para especificar un número para ambas entradas, previamente se deben establecer en el entorno el tamaño de la celda y la extensión.

Raster Layer; Constant

Valor de retorno

NombreExplicaciónTipo de datos
out_raster

El ráster de salida.

Los valores son el ángulo de la tangente inversa de los valores de entrada.

Raster

Muestra de código

Ejemplo 1 de Arcotangente (x/y) (ATan2) (ventana de Python)

Este ejemplo calcula la tangente inversa para dos cuadrículas ráster de entrada.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outATan2 = ATan2("degs", "negs")
outATan2.save("C:/sapyexamples/output/outatan2")
Ejemplo 2 de Arcotangente (x/y) (ATan2) (secuencia de comandos independiente)

Este ejemplo calcula la tangente inversa para dos cuadrículas ráster de entrada.

# Name: ATan2_Ex_02.py
# Description: Calculates the inverse tangent of cells based
#              on (y, x) values from two rasters
# 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
inRaster1 = "degs"
inRaster2 = "negs"

# Execute ATan2
outATan2 = ATan2(inRaster1, inRaster2)

# Save the output 
outATan2.save("C:/sapyexamples/output/outatan2.tif")

Información de licenciamiento

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

Temas relacionados