LinearAlgebra - Maple Programming Help

Online Help

All Products    Maple    MapleSim


Home : Support : Online Help : Mathematics : Linear Algebra : LinearAlgebra Package : SubOperations : LinearAlgebra/Pivot

LinearAlgebra

  

Pivot

  

pivot about a Matrix entry

 

Calling Sequence

Parameters

Description

Examples

Calling Sequence

Pivot(A, i, j, L, ip, options)

Parameters

A

-

Matrix

i, j

-

integers; position of the pivot entry

L

-

(optional) an integer, a range with integer endpoints, or a list of integers and/or ranges with integer endpoints; selection of pivot rows

ip

-

(optional) BooleanOpt(inplace); specifies if output overwrites input

options

-

(optional); constructor options for the result object

Description

• 

The Pivot(A, i, j) function pivots A about the non-zero entry A[i, j]. Multiples of the ith row are added to every other row in A, with the result that all of the entries in the jth column of A are zero except for the (i, j)th element.

• 

The Pivot(A, i, j, L) function acts like Pivot(A, i, j) except that only rows indicated in L are modified. Rows not included in L are unaffected. If any rows in L are repeated or if i occurs in L, they are ignored. For more information regarding parameter L, see Matrix and Vector Entry Selection.

• 

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.

  

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 argument may be corrupted.

• 

The constructor options provide additional information (readonly, shape, storage, order, datatype, and attributes) to the Matrix 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 Pivot(..) only after executing the command with(LinearAlgebra). However, it can always be accessed through the long form of the command by using LinearAlgebra[Pivot](..).

Examples

withLinearAlgebra:

A1,5,9,3,7|2,6,0,4,8|3,7,1,5,9|4,8,2,6,0

A:=12345678901234567890

(1)

APivotA,2,1

A:=0458512556780545585625025456502545565

(2)

APivotA,1,2,4..1,3

A:=045851255678001020000000010

(3)

See Also

LinearAlgebra[LUDecomposition]

Matrix

type[BooleanOpt]

 


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