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).
In mathematics, all Trigonometric functions have a defined range of valid input values, called the domain. The output values from each function also has a defined range. For this tool:
The Domain is : -∞ < [in_value] < ∞
Este dominio se aplica a ambas entradas.
The Range is : -pi < [out_value] ≤ pi
Note that here -∞ and ∞ represent the smallest negative and largest positive value supported by the particular raster format, respectively.
-
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.
Output values are always floating point, regardless of the input data type.
The output values from this tool are in radians. If degrees are desired, the resulting raster must be multiplied by the radians-to-degrees conversion factor of 180/pi, or approximately 57.296.
See here for examples of converting output values from radians to degrees.
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. A number can be used as an input for this parameter, provided a raster is specified for the other parameter. To be able to specify a number for both inputs, the cell size and extent must first be set in the environment. | Raster Layer | Constant |
in_raster_or_constant2 |
La entrada que especifica el denominador, o valor x, para utilizarlo cuando se calcula la tangente inversa. A number can be used as an input for this parameter, provided a raster is specified for the other parameter. To be able to specify a number for both inputs, the cell size and extent must first be set in the environment. | Raster Layer | Constant |
Valor de retorno
| Nombre | Explicación | Tipo de datos |
| out_raster |
The output raster. 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")