Gaussian Elimination Calculator

A calculator for the gaussian elimination algorithm to solve systems of linear equations with multiple unknown variables, written in Java.

This project is intended for education purposes. For understanding the maths behind it, the calculator has a built-in calculation path step trace, and an easy-to-use GUI. Note that the calculator will only change a given matrix to the reduced row echelon form, from which the solution vector can be read.

This calculator currently only works with uniquely solvable matrices.

The core of the algorithm is located in the GaussianElimination.java file, with the matrix data being held in an instance of the GaussMatrix.java class.

Getting started

Dependencies

Apache Maven
Java Platform (OpenJDK 17)

Installation

Download and install dependencies
Navigate to the project root directory
Build the application jar file with maven:

$ mvn install

The jar file and build information is then written to the newly created directory targets.

Usage

To run the application, use the maven exec command:

$ mvn exec:exec

If you don't want to use the same VM as maven, you can pass the .jar file to the locally installed java runtime:

$ java -jar ./target/gauss-1.1-jar-with-dependencies.jar

Documentation

To generate the JavaDoc HTML documentation files, run the maven javadoc command:

$ mvn javadoc:javadoc

The generated files are accessible in the directory target/site/apidocs.

Tests

To run only the unit tests, run the maven test command:

$ mvn test

The generated test resulsts are accesible in the directory target/surefire-reports.