Add - Maple Help
For the best experience, we recommend viewing online help using Google Chrome or Microsoft Edge.

Online Help

All Products    Maple    MapleSim


LinearAlgebra

  

Add

  

compute a linear combination of Matrices, Vectors and scalars

 

Calling Sequence

Parameters

Description

Examples

Calling Sequence

Add(A, B, c1, c2, ip, options)

Parameters

A

-

Matrix, Vector, or scalar

B

-

Matrix, Vector, or scalar

c1, c2

-

(optional) scalars

ip

-

(optional) equation of the form inplace=true or false; specifies if output overwrites input

options

-

(optional); constructor options for the result object

Description

• 

The Add(A, B) function, where A and B are either both Matrices or both Vectors, computes the elementwise sum of A and B. The special case of the sum of a scalar and a Matrix is described below. Any other combination for the types of A and B results in an error.

  

The default values of c1 and c2 is 1.

  

If A and B are both Matrices or both Vectors, Add(A, B, c1, c2) computes the sum c1A+c2B.

  

If A is a scalar and B is a Matrix, then Add(A, B, c1, c2) computes the sum c1ScalarMatrixA,op1,B+c2B.

  

If A is a Matrix and B is a scalar, Add(A, B, c1, c2) returns the sum c1A+c2ScalarMatrixB,op1,A.

  

If A is a scalar and B is a scalar, Add(A, B, c1, c2) returns the sum c1A+c2B.

• 

The inplace option (ip) determines where the result is returned. If given as inplace=true, the result overwrites the first argument. If given as inplace=false, or if this option is not included in the calling sequence, the result is returned in a new Matrix (or Vector).

  

The condition inplace=true can be abbreviated to inplace.

  

The inplace option must be used with caution since, if the operation fails, the original Matrix (or Vector) argument may be corrupted.

• 

The constructor options provide additional information (readonly, shape, storage, order, datatype, and attributes) to the Matrix or Vector constructor that builds the result. These options may also be provided in the form outputoptions=[...], where [...] represents a Maple list.  If a constructor option is provided in both the calling sequence directly and in an outputoptions option, the latter takes precedence (regardless of the order).

• 

The inplace and constructor options are mutually exclusive.

• 

This function is part of the LinearAlgebra package, and so it can be used in the form Add(..) only after executing the command with(LinearAlgebra). However, it can always be accessed through the long form of the command by using LinearAlgebra[Add](..).

  

Note:  This routine uses the types of the first two parameters to select between the MatrixAdd and VectorAdd LinearAlgebra routines to do the actual computation.

Examples

withLinearAlgebra:

Ax1.00004,1.99987,0.00012:

b1.,2.,0.:

AddAx,b,1,1

0.0000400000000000400−0.000129999999999963−0.000120000000000000

(1)

Mm,o|n,p:

AddM,λ,inplace

mλnopλ

(2)

M

mλnopλ

(3)

See Also

LinearAlgebra[MatrixAdd]

LinearAlgebra[ScalarMatrix]

LinearAlgebra[VectorAdd]

Matrix

op

type/scalar

Vector