add - Maple Help

Online Help

All Products    Maple    MapleSim


Home : Support : Online Help : Programming : Flow Control : Iteration or Looping : add

add

add up a sequence of values

mul

multiply a sequence of values

 

Calling Sequence

Parameters

Description

Thread Safety

Examples

Compatibility

Calling Sequence

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)

Parameters

f

-

expression

i

-

name

m, n

-

numerical values

x

-

expression

step

-

(optional) numerical value

Description

• 

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 f1+f2+...+fn. More generally, add(f(i), i=m..n) computes fm+fm+1+...+fn. Similarly, mul(f(i), i=m..n) computes fmfm+1...fn.

• 

If the optional step is specified, add and mul step through the range m..n using that step size, i.e. fm+fm+step+...+fns 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;

                   old := i;

                   for i in x do P := P*f end do;

                   i := old;

                   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.

Thread Safety

• 

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.

Examples

The add and mul commands are used to add up or multiply an explicit sequence of values.

muli,i=1..5

120

(1)

addi2,i=1..5

55

(2)

addaixi,i=0..5

x5a5+x4a4+x3a3+x2a2+xa1+a0

(3)

The add and mul commands can be used on matrices.

MMatrix1,2,3,4

M:=1234

(4)

addM,k=1..2

2468

(5)

mulM,k=1..3

375481118

(6)

The "in" and "=" notations produce the same result for both add and mul.

Lseqi,i=1..5

L:=1,2,3,4,5

(7)

addi,i=L

15

(8)

addi,i∈L

15

(9)

mulxi,i=L

x1x2x3x4x5

(10)

mulxi,i∈L

x1x2x3x4x5

(11)

The add command works only for numeric ranges.

addi2,i=0..n

Error, unable to execute add

i=0ni2

13n+1312n+12+16n+16

(12)

addi,i=∞..0

0

(13)

muli,i=0..∞

1

(14)

i=1∞i

∞

(15)

Compatibility

• 

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

Was this information helpful?



Please add your Comment (Optional)
E-mail Address (Optional)
What is ? This question helps us to combat spam