HOWTO · NumPy
Calcule o valor absoluto em NumPy
Existem 3 métodos que podem ser usados para calcular o valor absoluto em NumPy, a função abs(), a função numpy.absolute() e a função numpy.abs().
Nesta página
Calcular valores absolutos é uma operação fundamental na análise de dados e na computação científica. Em Python, a biblioteca NumPy oferece maneiras eficientes de executar essa operação em arrays e dados numéricos. Quer você esteja lidando com uma simples lista de números ou com arrays multidimensionais complexos, entender como calcular valores absolutos pode aprimorar suas habilidades de manipulação de dados.
Neste artigo, exploraremos três métodos principais para calcular valores absolutos no NumPy: a função abs(), numpy.absolute() e numpy.abs(). Os três estão intimamente relacionados - em um array NumPy, todos executam a mesma operação elemento a elemento - portanto, este guia se concentra em onde eles realmente diferem: quais entradas cada um aceita e quais controles extras as funções do NumPy oferecem.
Usar a função integrada abs()
A função abs() é uma função integrada do Python que retorna o valor absoluto de um número. Embora não seja específica do NumPy, ela funciona com arrays NumPy: quando você aplica abs() a um array, o Python chama o método __abs__() do array, que é a própria operação de valor absoluto do NumPy, e você obtém um novo array contendo os valores absolutos dos elementos originais.
Veja como você pode usar a função abs() com o NumPy:
import numpy as np
array = np.array([-1, -2, 3, -4])
absolute_values = abs(array)
print(absolute_values)
Saída:
[1 2 3 4]
Como abs() simplesmente encaminha a chamada para o método __abs__() do array, ele executa exatamente o mesmo cálculo que numpy.absolute() em um array - não há nenhuma penalidade de desempenho por usar a função integrada em dados NumPy. Sua verdadeira limitação é outra: abs() precisa de um objeto que defina __abs__(). Ele funciona com números do Python, números complexos e arrays NumPy, mas chamar abs() em uma lista Python simples gera um TypeError, enquanto as funções do NumPy abaixo aceitam listas diretamente.
Usar numpy.absolute()
numpy.absolute() é a função de valor absoluto própria do NumPy, implementada como uma ufunc. Ela calcula o valor absoluto elemento a elemento em arrays de qualquer forma e tamanho e, diferentemente da função integrada, também aceita entradas do tipo array, como uma lista simples, convertendo-as primeiro em um array. Como ufunc, ela também aceita os parâmetros usuais de ufunc, por exemplo out= para escrever o resultado em um array existente.
Aqui está um exemplo de como usar numpy.absolute():
import numpy as np
array = np.array([[-1, -2, 3], [-4, 5, -6]])
absolute_values = np.absolute(array)
print(absolute_values)
Saída:
[[1 2 3]
[4 5 6]]
numpy.absolute() também oferece suporte a números complexos, retornando a magnitude de cada elemento:
import numpy as np
complex_array = np.array([3 + 4j, -5 + 12j])
magnitudes = np.absolute(complex_array)
print(magnitudes)
Saída:
[ 5. 13.]
Isso a torna uma escolha padrão segura para computações científicas, nas quais os dados podem ser multidimensionais ou complexos.
Usar numpy.abs()
numpy.abs() não é de forma alguma uma implementação separada: é exatamente o mesmo objeto de função que numpy.absolute() - no NumPy, np.abs is np.absolute é avaliado como True. O nome mais curto existe puramente como um alias conveniente.
Veja como usar numpy.abs():
import numpy as np
array = np.array([[1, -2], [-3, 4]])
absolute_values = np.abs(array)
print(absolute_values)
Saída:
[[1 2]
[3 4]]
Como os dois nomes denotam uma única função, a escolha entre numpy.abs() e numpy.absolute() é apenas uma questão de estilo ou legibilidade no seu código; os resultados e o desempenho são idênticos de qualquer maneira.
Conclusão
Calcular valores absolutos no NumPy é simples porque os três métodos executam a mesma operação elemento a elemento nos arrays. Use a função integrada abs() quando seus valores já forem arrays NumPy ou números simples e você quiser um código Python genérico; recorra a numpy.absolute() ou ao seu alias numpy.abs() quando precisar passar dados do tipo array, como listas, ou opções de ufunc, como out=. Qualquer que seja a grafia escolhida, os números que você receberá de volta serão os mesmos.
Perguntas frequentes
-
Qual é a diferença entre abs() e numpy.absolute()?
A interface, não o cálculo. Em um array NumPy,abs()chama o método__abs__()do array, que é a mesma operação executada pornumpy.absolute().numpy.absolute()aceita adicionalmente entradas do tipo array, como listas, e parâmetros de ufunc, comoout=;abs()gera umTypeErrorem uma lista simples porque as listas não definem__abs__(). -
Posso usar numpy.abs() com números complexos?
Sim. Todos os três métodos retornam a magnitude de um número complexo; por exemplo, os valores absolutos de3 + 4je-5 + 12jsão5.0e13.0, como mostrado no exemplo denumpy.absolute()acima. -
Existem diferenças de desempenho entre esses métodos?
Nenhuma significativa.numpy.abs()enumpy.absolute()são o mesmo objeto de função, eabs()em um array é despachado para a mesma operação do NumPy, então todos os três fazem o mesmo trabalho elemento a elemento; apenas a sobrecarga da chamada difere, e de forma insignificante. -
Qual método devo usar para arrays multidimensionais?
Qualquer um deles - todos os três lidam com arrays de qualquer forma, como mostram os exemplos bidimensionais acima. Prefiranumpy.absolute()ounumpy.abs()se a entrada puder ser uma lista ou outro objeto do tipo array, já que a função integradaabs()só aceita objetos que definem__abs__(). -
Há alguma diferença na saída ao usar essas funções?
Não. Para a mesma entrada, todos os três métodos retornam os mesmos valores.