<< mps_sqrt mpscilab mps_sum >>

mpscilab >> mpscilab > mps_sub

mps_sub

Subtraction operation

Calling Sequence

mps_sub( rop, op1, op2 )
rop = mps_sub( op1, op2 )

Overloaded usage:

rop = op1 - op2

Arguments

rop

multi-precision matrix

op1, op2

multi-precision or Scilab matrices or scalars

Description

Subtract op2 from op1 and put the result in rop. op1 and op2 can be any combinations of Scilab or multi-precision matrix. In case of subtraction between a matrix and a scalar, element-wise subtraction of every elements of the non-scalar operand will be performed.

mps_sub( rop, op1, op2 )

Subtract op2 from op1 and put the result in rop.

rop = mps_sub( op1, op2 )

Creates a multi-precision matrix the same size and precision as op containing the result.

rop = op1 - op2

Overloaded Scilab subtraction operation.

Usage notes

Like most mps functions the mps_sub( rop, op1, op2 ) form is faster and can reuse the space of an existing matrix but requires an already initialized operand. Also, the same form can be used to perform an in-place operation when rop and op are the same.

Examples

// Subtraction between two MPS matrix.
A = [1 2; 3 4]
B = [4 3; 2 1]
mpsA = mps_init2(A,100)
mpsB = mps_init2(B,100)
rop = mps_init(2,2,100)
rop = mps_sub(mpsA,mpsB)

// Subtraction between an MPS matrix and a Scilab double scalar.
A = [1 2; 3 4]
mpsA = mps_init2(A,100)
rop = mps_init(2,2,100)
mps_sub(rop,mpsA,2)

// In-place subtraction mpsA = mpsA - mpsB. This is done without any intermediary
// variable or storage.
A = [1 2; 3 4]
B = [4 3; 2 1]
mpsA = mps_init2(A,100)
mpsB = mps_init2(B,100)
mps_sub(mpsA,mpsA,mpsB)

//Overloaded usage
A = [1 2; 3 4]
B = [4 3; 2 1]
mpsA = mps_init2(A,100)
mpsB = mps_init2(B,100)
rop = mpsA - mpsB

See Also

<< mps_sqrt mpscilab mps_sum >>