add
add up a sequence of values
mul
multiply a sequence of values
Calling Sequence
Parameters
Description
Thread Safety
Examples
Compatibility
add(f, i = m..n)
add(f, i = m..n, step)
add(f, i = x)
add(f, i in x)
add(x)
mul(f, i = m..n)
mul(f, i = m..n, step)
mul(f, i = x)
mul(f, i in x)
mul(x)
f
-
expression
i
name
m, n
numerical values
x
step
(optional) numerical value
The add command is used to add up an explicit sequence of values. The mul command computes a product of an explicit sequence of values. A typical call to the add command is add(f(i), i=1..n). This computes f⁡1+f⁡2+...+f⁡n. More generally, add(f(i), i=m..n) computes f⁡m+f⁡m+1+...+f⁡n. Similarly, mul(f(i), i=m..n) computes f⁡m⁢f⁡m+1⁢...⁢f⁡n.
If the optional step is specified, add and mul step through the range m..n using that step size, i.e. f⁡m+f⁡m+step+...+f⁡ns where ns is the last value that would not pass n.
The call add(f(i), i=x) computes the sum of applying f to each operand or entry of x. Here, x would often be a set or list, but it could be any other data structure to which op can be applied, such as a sum or product. Likewise, the call mul(f(i), i=x) computes the product of f of the operands of x. For tables, Arrays, and rtables, the entries of x are scanned rather than the operands.
The add(x) calling sequence is equivalent to add(i,i in x). Likewise, mul(x) is equivalent to mul(i,i in x).
The add and mul commands are related to the seq command, which is related to the for-loop construct. The precise semantics of the two versions of the add and mul commands can best be understood by noting that they are equivalent to the following for-loops. In this description, the expression f is typically a function of i.
add(f, i=m..n) == S := 0;
old := i;
for i from m to n do S := S+f end do;
i := old;
S; # the result
mul(f, i=x) == P := 1;
for i in x do P := P*f end do;
P; # the result
In either form, the add and mul commands are generally more efficient than the for-loop versions because the for-loop versions construct many intermediate sums and products.
Note that the limits m and n must evaluate to numerical constants, that is, integers, fractions, or floating point numbers. If you want to compute a formula for a symbolic sum or product in terms of a symbolic limit, use the sum and product commands. As a special case, m may evaluate to ∞, or n may evaluate to −∞. If m is greater than n, add returns 0 and mul returns 1.
Note also that any previously existing value assigned to the index variable i is restored after the add or mul invocation. Thus the value of any local or global variable of the same name visible at the time the add or mul is executed will not be affected.
When x is a sparse Matrix, Vector or rtable, only the non-zero entries are scanned. Otherwise, regardless of the indexing function, or storage, the entire index-space of the object is scanned.
See also the sum and product commands for computing symbolic sums and products. These commands are designed to return a formula for an indefinite (or definite) sum or product, rather than an explicit sum or product.
The calling sequence add(f(i), i in x) is equivalent to add(f(i), i = x). The "in" and "=" notations produce the same result for both add and mul.
The add and mul commands are thread safe as of Maple 15, provided that evaluating the expression f is thread safe. Further the index variable i must not be shared between threads. Using a procedure local is advised.
For more information on thread safety, see index/threadsafe.
The add and mul commands are used to add up or multiply an explicit sequence of values.
mul⁡i,i=1..5
120
add⁡i2,i=1..5
55
add⁡ai⁢xi,i=0..5
a5⁢x5+a4⁢x4+a3⁢x3+a2⁢x2+a1⁢x+a0
The add and mul commands can be used on matrices.
M≔Matrix⁡1,2,3,4
M≔1234
add⁡M,k=1..2
2468
mul⁡M,k=1..3
375481118
The "in" and "=" notations produce the same result for both add and mul.
L≔seq⁡i,i=1..5
L≔1,2,3,4,5
add⁡i,i=L
15
add⁡i,iinL
mul⁡x−i,i=L
x−1⁢x−2⁢x−3⁢x−4⁢x−5
mul⁡x−i,iinL
The add command works only for numeric ranges.
add⁡i2,i=0..n
Error, unable to execute add
sum⁡i2,i=0..n
n+133−n+122+n6+16
add⁡i,i=∞..0
0
mul⁡i,i=0..−∞
1
product⁡i,i=1..∞
∞
The add and mul commands were updated in Maple 2015.
The step parameter was introduced in Maple 2015.
For more information on Maple 2015 changes, see Updates in Maple 2015.
See Also
for
op
product
seq
sum
Threads[Add]
Threads[Mul]
Download Help Document
What kind of issue would you like to report? (Optional)