# NAME

Math::Bacovia::Log - Represents the natural logarithm of a symbolic value.

# SYNOPSIS

``````    use 5.014;
use Math::Bacovia qw(Log Symbol);

my \$f = Log(Symbol('a'));
my \$g = Log(Symbol('b'));

say ((\$f + \$g)->pretty);    #=> log(a * b)``````

# METHODS

This section describes the methods provided by the Math::Bacovia::Log module.

## new

``    my \$obj = Math::Bacovia::Log->new(\$value);``

Constructs and returns a new Math::Bacovia::Log object.

## get

``    my (\$value) = \$obj->get;``

Returns the internal value of the self-object.

``````    \$x + \$y

Sum of `x` and `y`, using the identity:

``    log(a) + log(b) = log(a * b)``

## sub

``````    \$x - \$y
\$x->sub(\$y)``````

Subtraction of `y` from `x`, using the identity:

``    log(a) - log(b) = log(a / b)``

## neg

``````    -\$x
\$x->neg``````

Additive inverse of `x`, using the identity:

``    -log(a) = log(1/a)``

## eq

``````    \$x == \$y
\$x->eq(\$y)``````

Return a true value when `x` and `y` are symbolically equal.

# SPECIAL METHODS

This section describes the special methods provided by the Math::Bacovia::Log module.

## alternatives

``````    my @alt = \$obj->alternatives;
my @alt = \$obj->alternatives(full => 1);``````

This method uses common mathematical identities to create symbolically equivalent expressions from the self-expression.

## pretty

``    my \$str = \$obj->pretty;``

Returns a human-readable stringification of the self-expression.

## stringify

``    my \$str = \$obj->stringify;``

Returns a stringification of the self-expression.

## numeric

``    my \$num = \$obj->numeric;``

Evaluates the self-expression numerically and returns a Math::AnyNum object.

The other parts of Math::Bacovia:

# AUTHOR

Daniel Șuteu, `<trizen at protonmail.com>`

# BUGS

Please report any bugs or feature requests to https://github.com/trizen/Math-Bacovia. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

# SUPPORT

You can find documentation for this module with the perldoc command.

``    perldoc Math::Bacovia::Log``

You can also look for information at:

This program is free software; you can redistribute it and/or modify it under the terms of the the Artistic License (2.0). You may obtain a copy of the full license at: