https://github.com/KittyGiraudel/SassyMatrix

[UNMAINTAINED] All you ever wanted to deal with matrices in Sass.
https://github.com/KittyGiraudel/SassyMatrix

Last synced: 3 months ago
JSON representation

[UNMAINTAINED] All you ever wanted to deal with matrices in Sass.

• Host: GitHub
• URL: https://github.com/KittyGiraudel/SassyMatrix
• Owner: KittyGiraudel
• License: mit
• Archived: true
• Created: 2014-01-09T15:11:28.000Z (about 11 years ago)
• Default Branch: master
• Last Pushed: 2021-03-06T09:35:08.000Z (almost 4 years ago)
• Last Synced: 2024-10-20T20:26:33.857Z (4 months ago)
• Language: SCSS
• Homepage: http://hugogiraudel.com/SassyMatrix
• Size: 149 KB
• Stars: 28
• Watchers: 5
• Forks: 2
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-sass - SassyMatrix

README

        
# SassyMatrix

All you ever wanted to deal with matrices in Sass.

## What's in there?

### Instanciating matrix

* `matrix($x, $y: $x)`: create a matrix of `$x` rows by `$y` columns filled with 0s

* `unit-matrix($x, $y)`: create a matrix of `$x` rows by `$y` columns filled with 0s except the diagonal which is filled with 1s

### Writing in matrix

* `set-entry($matrix, $coords, $value)`: set `$value` at `$matrix[$coords[1], $coords[2]]`

* `set-column($matrix, $index, $column: ())`: set `$column` at `$index` in `$matrix`

* `set-row($matrix, $index, $row: ())`: set `$row` at `$index` in `$matrix`

* `add-column($matrix, $column: (), $index: null)`: add `$column` at `$index` in `$matrix`

* `add-row($matrix, $row: (), $index: null)`: add `$row` at `$index` in `$matrix`

### Reading matrix

* `get-entry($matrix, $coords)`: get entry at `$matrix[$coords[1], $coords[2]]`

* `get-column($matrix, $index)`: get column at `$index` from `$matrix`

* `get-row($matrix, $index)`: get row at `$index` from `$matrix`

### Displaying matrix

* `display($matrix)`: display matrix

### Altering matrix

* `swap-entries($matrix, $e1, $e2)`: swaps values `$e1` and `$e2` from `$matrix`

* `swap-rows($matrix, $r1, $r2)`: swaps rows `$r1` and `$r2` from `$matrix`

* `swap-columns($matrix, $c1, $c2)`: swaps columns `$c1` and `$c2` from `$matrix`

* `transpose($matrix)`: rotates `$matrix` around its diagonal

* `add-matrices($matrix1, $matrix2)`: add `$matrix1` and `$matrix2`

### Checking for matrix properties

* `columns($matrix)`: return number of columns in `$matrix`

* `rows($matrix)`: return number of rows in `$matrix`

* `is-numeric($matrix)`: check whether `$matrix` has only numeric values

* `is-square($matrix)`: check whether `$matrix` has as many rows as columns

* `is-diagonal($matrix)`: check whether all values from the main diagonal of `$matrix` are set while all other values are equal to 0

* `is-lower-triangular($matrix, $flag: null)`: check whether all value below `$matrix` diagonal are equal to 0

* `is-upper-triangular($matrix, $flag: null)`: check whether all value above `$matrix` diagonal are equal to 0

## Requirements

All you need is a clean version of Sass 3.3. Otherwise it's just pure Sass madness.

## Development

### You need

  * [NodeJS](http://nodejs.org)

  * [Ruby](https://www.ruby-lang.org/)

  * Sass 3.3 via `gem instal sass --pre`

  * `grunt-cli` via `npm install -g grunt-cli`

### How to

  1. Fork this repository

  2. Run `npm install`

  3. `grunt dev`

  4. Make your changes + write tests

  5. Commit + Pull request