time-to-botec/js/node_modules/@stdlib/math/base/special/log1mexp/README.md

log1mexp

Evaluates the natural logarithm of 1-exp(-|x|).

Usage

var log1mexp = require( '@stdlib/math/base/special/log1mexp' );

log1mexp( x )

Evaluates the natural logarithm of 1-exp(-|x|).

var y = log1mexp( 0.0 );
// returns -Infinity

y = log1mexp( 5.0 );
// returns ~-0.00676

y = log1mexp( 10.0 );
// returns ~-0.00005

y = log1mexp( -10.0 );
// returns ~-0.00005

y = log1mexp( NaN );
// returns NaN

Examples

var incrspace = require( '@stdlib/array/incrspace' );
var log1mexp = require( '@stdlib/math/base/special/log1mexp' );

var x = incrspace( -10.0, 10.0, 0.01 );
var v;
var i;

for ( i = 0; i < x.length; i++ ) {
    v = log1mexp( x[ i ] );
    console.log( 'x: %d, f(x): %d', x[ i ], v );
}