HOWTO · Python
Calcule a tangente inversa em Python
Este tutorial demonstra como calcular a tangente inversa em Python.
Nesta página
A tangente inversa, também chamada de arco-tangente, responde à pergunta: “qual ângulo tem esta tangente?”. Em Python, use math.atan() para um valor numérico, numpy.arctan() para cálculos elemento a elemento em arrays ou sympy.atan() quando a entrada deve continuar sendo uma expressão simbólica. As duas primeiras são APIs numéricas; o SymPy representa a relação simbolicamente até que você peça para avaliar um valor.
Use math.atan() para um valor
O módulo math da biblioteca padrão é a opção mais simples para um único número e não exige pacotes de terceiros. Passe o valor da tangente para math.atan(); o resultado é um ângulo em radianos. Converta-o com math.degrees() apenas quando o restante da aplicação esperar graus.
Execute este exemplo:
O código e os rótulos ou saídas exibidos nesta seção permanecem em inglês.
import math
tangent = 1
angle_radians = math.atan(tangent)
angle_degrees = math.degrees(angle_radians)
print(angle_radians)
print(angle_degrees)
Este exemplo mostra um padrão executável para um único valor. Adapte tangent à sua entrada e mantenha o valor em radianos nos cálculos que usam as funções trigonométricas do Python. A conversão para graus é útil para exibição ou para interfaces que usam graus explicitamente.
Use numpy.arctan() para arrays
Use NumPy quando sua entrada for um array ou quando quiser aplicar a mesma operação a muitos valores. NumPy é uma dependência opcional; a biblioteca padrão do Python não oferece o tipo de array nem a função vetorizada do NumPy. numpy.arctan() calcula um resultado elemento a elemento e retorna ângulos em radianos. numpy.degrees() converte um array desses ângulos, preservando sua forma elemento a elemento.
O código e os rótulos ou saídas exibidos nesta seção permanecem em inglês.
import numpy as np
tangents = np.array([0.0, 1.0, -1.0])
angles_radians = np.arctan(tangents)
angles_degrees = np.degrees(angles_radians)
print(angles_radians)
print(angles_degrees)
Use esta abordagem para dados numéricos que já estejam representados como arrays NumPy. Para um único número comum do Python, math.atan() evita adicionar uma dependência. Essas APIs operam sobre valores de tangente; elas não recebem um ângulo para retornar sua tangente.
Use sympy.atan() para expressões simbólicas
Escolha SymPy quando a entrada contiver símbolos e você quiser obter uma expressão em vez de um ângulo imediato em ponto flutuante. SymPy é um pacote de terceiros opcional. Importe a função explicitamente e crie um símbolo com sympy.Symbol; ao passar uma expressão como x para sympy.atan(), o resultado permanece simbólico.
O código e os rótulos ou saídas exibidos nesta seção permanecem em inglês.
import sympy
from sympy import atan
x = sympy.Symbol("x")
angle = atan(x)
print(angle)
Uma expressão simbólica é útil para manipulações algébricas. Ela é diferente de um resultado numérico: substitua um valor para o símbolo e chame evalf() quando precisar de uma aproximação decimal. Use math.atan() ou numpy.arctan() para cálculos numéricos diretos.
Interprete os resultados da tangente inversa
Para entradas reais finitas, a tangente inversa de um argumento retorna um ângulo principal em radianos, no intervalo aberto de -pi/2 a pi/2. Para infinito positivo ou negativo, math.atan() e numpy.arctan() retornam o extremo correspondente: pi/2 ou -pi/2. Vários ângulos podem ter a mesma tangente; portanto, atan() não recupera todos os ângulos possíveis nem identifica um quadrante completo com base apenas no valor da tangente. Para calcular a direção a partir de componentes horizontal e vertical separados, use math.atan2(y, x) ou numpy.arctan2(y, x), que preservam as informações de quadrante dos sinais de ambos os componentes.
Para um único valor, use math.atan() e converta as unidades somente se necessário. Para arrays, use numpy.arctan() e, se quiser, numpy.degrees(). Para álgebra, use sympy.atan() e avalie a expressão apenas quando precisar de uma aproximação numérica. Lembre-se de que o resultado padrão é dado em radianos e escolha a função conforme sua entrada seja um número escalar, um array ou uma expressão simbólica.