# NAME

Math::Bacovia::Sum - Represents a summation of an arbitrary (finite) number of symbolic values.

# SYNOPSIS

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

my \$f = Sum(Symbol('a'), Symbol('b'), Symbol('c'));
say sqrt(\$f)->pretty;         #=> (a + b + c)^(1/2)``````

# METHODS

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

## new

``    my \$obj = Math::Bacovia::Sum->new(\$x, \$y, \$z, , ,);``

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

## get

``    my @values = \$obj->get;``

Returns the internal values of the self-object.

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

Sum of `x` and `y`.

## sub

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

Subtraction of `y` from `x`.

## mul

``````    \$x * \$y
\$x->mul(\$y)``````

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

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

## div

``````    \$x / \$y
\$x->div(\$y)``````

Division of `x` by `y`, using the identity:

``    (a + b) / c = a/c + b/c``

## neg

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

Additive inverse of `x`, using the identity:

``    -(a + b) = (-a) + (-b)``

## 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::Sum 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::Sum``

You can also look for information at:

Copyright 2017-2018 Daniel Șuteu.

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: