Sage Reference Manual: Matrices and Spaces of Matrices - Mirrors

CHAPTER
SIX
BASE CLASS FOR MATRICES, PART 1
Base class for matrices, part 1
For design documentation see sage.matrix.docs.
TESTS:
sage: A = Matrix(GF(5),3,3,srange(9))
sage: TestSuite(A).run()
class sage.matrix.matrix1.Matrix
Bases: sage.matrix.matrix0.Matrix
The initialization routine of the Matrix base class ensures that it sets the attributes self._parent, self._base_ring,
self._nrows, self._ncols. It sets the latter ones by accessing the relevant information on parent, which is often
slower than what a more specific subclass can do.
Subclasses of Matrix can safely skip calling Matrix.__init__ provided they take care of initializing these attributes
themselves.
The private attributes self._is_immutable and self._cache are implicitly initialized to valid values upon memory
allocation.
EXAMPLES:
sage: import sage.matrix.matrix0
sage: A = sage.matrix.matrix0.Matrix(MatrixSpace(QQ,2))
sage: type(A)
augment(right, subdivide=False)
Returns a new matrix formed by appending the matrix (or vector) right on the right side of self.
INPUT:
•right - a matrix, vector or free module element, whose dimensions are compatible with self.
•subdivide - default: False - request the resulting matrix to have a new subdivision, separating
self from right.
OUTPUT:
A new matrix formed by appending right onto the right side of self. If right is a vector (or free
module element) then in this context it is appropriate to consider it as a column vector. (The code first
converts a vector to a 1-column matrix.)
If subdivide is True then any column subdivisions for the two matrices are preserved, and a new
subdivision is added between self and right. If the row divisions are identical, then they are preserved,
97