Matrix Mindbusters

Matrix Mindbusters is an educational game aimed to help undergraduate Math & Engineering students learn matrix transformations. Written in Elm, the program was created for a summative assignment in McMaster's computer science undergraduate course COMPSCI 1XD3, and it utilizes MacCAS Outreach's GraphicSVG library to render images and vector shapes (written by McMaster students and Dr. Christopher Anand). During gameplay, a two-by-two/-three matrix is visually represented on a Cartesian grid system through a two dimensional diagram, and the user is tasked with altering the matrix's values to manipulate the shape into taking on a specific formation.

Test out the program live here:
 Windows version
 Mac/Linux version

Created by Alex Chen, Loic Sinclair, Jacob Armstrong, Norah Muqbel, and Lu Yan.

---

Features

• Contains three level packs of varying difficulties—Easy, Medium, and Hard—each focused on either introducing the player to a new matrix transformation or testing their knowledge through a combination of concepts
• Includes Info and About submenus to refresh the player's knowledge on necessary linear algebra knowledge while acquainting them with the controls and purpose behind the program
• Contains a rudimentary timer score system to allow the user to note how long they take to complete each level, while encouraging them to return to prior cleared stages to improve their time and review past concepts

Current Bugs

• Best time scores are not displayed properly on the individual level select screens. The score values, however, are still registered and appear on the top taskbar during gameplay when in a level.
• Generated HTML files from the source code lag slightly when navigating through the level select menus.

Required Dependencies

• Elm (get it here!)
• MacCASOutreach's GraphicSVG v7.2.0
  (run elm install MacCASOutreach/graphicsvg in terminal)

Clone Repo

git clone https://github.com/alexchen2/Matrix-Mindbusters.git

Compile App

Windows:

elm make .\src\MainWin.elm

Mac/Linux:

elm make .\src\MainMac.elm

If any parsing errors pop up in your IDE if opening up in a code editor (e.g. VS Code), just ignore them; the code is formatted properly and has been tested to work properly.

The command will generate an .html file, which you can open in your browser. Ensure that you have as few tabs open as possible when running the file in order to reduce lag in the program.