log1p

Calcula log(1 + x) com precisão para x pequeno.

Categoria: Mathematics > Elementary Math

Sintaxe

Y = log1p(X)

Retorna log(1 + X) para cada elemento, sem o erro de arredondamento de formar 1 + X antes.

Descrição

Se x é menor que o epsilon de máquina (cerca de 2.2e-16), então 1 + x arredonda para exatamente 1 e log(1 + x) devolve 0, enquanto a resposta verdadeira é próxima de x. log1p calcula a função sem essa soma intermediária e mantém a precisão relativa total.

É a inversa de expm1 e a escolha certa para taxas de juros compostos e log-verossimilhanças de eventos raros.

Argumentos de entrada

X
Array real.

Argumentos de saída

Y
Array do mesmo tamanho de X. log1p(-1) é -Inf; valores abaixo de -1 dão NaN para entrada real.

Exemplo

Onde log(1+x) falha

x = 1e-17;
log(1 + x)
log1p(x)
log1p(-1)
Saída
ans = 0
ans = 1.0000e-17
ans = -Inf

Veja também

expm1 log log10 exp