ATan2 (Spatial Analyst)
Resumen
Calcula la tangente inversa (basada en x,y) de celdas en un ráster.
Ilustración
 |
OutRas = ATan2(InRas1, InRas2) |
Uso
-
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 coordenadas rectangulares a polaresLa ecuación para determinar ATan2 es: tanθ = y / x (donde θ es el ángulo).
La operación 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ática, 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:
El dominio es: -∞ < [in_value] < ∞
Este dominio se aplica a ambas entradas.
El rango es: -pi < [out_value] ≤ pi
Tenga en cuenta que aquí -∞ y ∞ 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 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. Si se desea expresarlos en grados, el ráster resultante deberá multiplicarse por el factor de conversión de radianes a grados de 180/pi ó 57,296 aproximadamente.
Consulte aquí ejemplos de conversión de valores de salida de radianes a grados.
Sintaxis
| Parámetro | Explicación | Tipo 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 poder 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 poder 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
| Nombre | Explicación | Tipo de datos |
| out_raster |
El ráster de salida. Los valores son el ángulo de la tangente inversa de los valores de entrada. | Raster |
Ejemplo de código
Este ejemplo calcula la tangente inversa para dos rásteres GRID 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")
Este ejemplo calcula la tangente inversa para dos rásteres GRID 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"
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute ATan2
outATan2 = ATan2(inRaster1, inRaster2)
# Save the output
outATan2.save("C:/sapyexamples/output/outatan2.tif")