__      _
  __ _  ___ _/ /_____(_)_ __
 /  ' \/ _ `/ __/ __/ /\ \ /
/_/_/_/\_,_/\__/_/ /_//_\_\

A python package for matrix operations and manipulations.

• Back-Story
• Features
• Installation
• Usage
• Uninstallation
• Contributing

I had just completed my "Journey through the Docs", studying the Core Python aspect of the Python Docs (majorly the Library & Language References, wherever else those referred me to and whatever else I needed to fully understand things) with interactive sessions, testing things out and making notes.

Then I needed something to put to (real) practice all the things I had learned. I wanted something purely Standard Python, no 3rd-party libraries and seemed this project would be a good place to start.

The project was conceived in the course of my "Journey through the Docs" but only stayed on my TODO list till after.

It's been interesting so far and the project turned out to incoparate a lot of what I had learnt... though, definitely not all. 😄

NOTE: This project is not intended to be a "re-invention of any wheel", it's just me practicing. I didn't test out or go through any similar project in the course of developing this, in order to stay unbiased and get the best out of it since it was for practice.

This is just an outline of the major features of the library. For the complete feature list, detailed descriptions and project documentation, see the documentation.

• The class constructor
• Utility functions to generate:
  • Unit matrices.
  • Matrices filled with random integer elements.
  • Matrices filled with random floating-point elements.

• Intelligent string representation
• Subscription
  • Single-element indexing, assignment and deletion
  • Block-slice (sub-matrix) subscription and assignment.
• Truthiness
• Membership test for elements
• Iteration over elements
• Per-element rounding

• Size
• Number of rows
• Number of columns
• Determinant
• Principal diagonal
• Trace
• Rank

• Negation
• Equality comparison
• Addition and subtraction
• Scalar multiplication
• Matrix multiplication
• Exponentiation (Repeated matrix multiplication)
• Division (by scalar)
• Inverse
• Transpose
• Augmentation
• Row reduction
  • Row Echelon form (Forward elimination)
  • Reduced Row Echelon form
  • Back substitution

• Diagonality
• Nullity
• Orthogonality
• Squareness
• Symmetry
• Triangularity
• Identity matrix
• Conformability

These are views of the matrix object, like .keys() and .values() are to dict.

• Rows and Columns (and their slices). Support:
  • Single row/column Indexing
  • Slicing of multiple rows/columns (Yes, a slice of rows/columns can still be sliced further! 😎)
  • Row/column assignment and deletion (Rows/Columns slices DO NOT support these).
  • Length (number of rows/columns "in" the view)
  • Iteration over rows/columns
• Row and column. Support:
  • String representation
  • Single element indexing
  • Multiple element slicing
  • Equality comparison
  • Mathematical operations (Also supports augmented assignment of these operations):
    • Addition and subtraction of rows and/or columns (Element-wise)
    • Multiplication and Division by scalar
    • Multiplication and Division by row/column (i.e inter-operation of two rows/columns element-by-element)
    • NOTE: Augmented assignments of these operations are performed in-place i.e affect the matrix itself.
  • Row/column length
  • Membership tests
  • Iteration over elements

• Horizontal and vertical flip
• Clockwise and anti-clockwise rotation
• Matrix copy
• Matrix resize
• Rounded comparison

• Gaussian elimination
• Gauss-Jordan elimination
• Inverse method

• Python >= 3.8

NOTE: You must have the pip python package installed (usually is, by default)

Run

pip install matrix-47

OR

python -m pip install matrix-47

Download and unzip this repository or run

git clone https://github.com/AnonymouX47/matrix

Change your Working Directory to the local repository; run

cd matrix

Then, run

pip install .

Instead, you might run

python -i test.py

to just test out the library without installing the package (but will be limited to only that interactive session).

NOTE: On Windows, the Python executables must've been added to PATH (For help, check here).

Quick example:

>>> from matrix import Matrix
>>> print(Matrix(4, 4))
+―――――――――――――――+
| 0 | 0 | 0 | 0 |
|―――+―――+―――+―――|
| 0 | 0 | 0 | 0 |
|―――+―――+―――+―――|
| 0 | 0 | 0 | 0 |
|―――+―――+―――+―――|
| 0 | 0 | 0 | 0 |
+―――――――――――――――+

For more usage examples, check the samples.

For the complete feature list and descriptions, see Feature Description.

To uninstall the package, run

pip uninstall matrix-47

If you find any bug, please create an Issue in the Issues section. Please make sure you check other issues first, to make sure you don't create a duplicate. Thank you 😃