reallog

Logaritmo natural que gera erro se o resultado for complexo.

Categoria: Mathematics > Elementary Math

Sintaxe

Y = reallog(X)

Retorna log(X) para X real não negativo, e um erro se algum elemento for negativo.

Descrição

log retorna silenciosamente um número complexo ao encontrar um argumento negativo, o que pode esconder um erro mais acima. reallog transforma essa situação em um erro (Reallog produced complex result.), de modo que um programa que deve ficar nos reais falha cedo, em vez de levar valores complexos adiante.

Quando todos os elementos são não negativos, dá exatamente a mesma resposta que log.

Argumentos de entrada

X
Array real cujos elementos devem ser não negativos.

Argumentos de saída

Y
Array real do mesmo tamanho de X.

Exemplo

Logaritmo estrito

reallog([1 exp(1) 10])
log(-1)
Saída
ans = 1×3

         0    1.0000    2.3026
ans = 0.0000 + 3.1416i

Veja também

log realsqrt realpow exp