Data.Matrix

newtype Matrix h w a

Matrix with height h, width w and contained value a

Constructors

• Matrix (Vec h (Vec w a))

Instances

• (Nat h, Nat w, Semiring a) => Semigroup (Matrix h w a)
• (Nat h, Nat w, Semiring a) => Commutative (Matrix h w a)
• (Nat h, Nat w, Semiring a) => Monoid (Matrix h w a)
• (Nat h, Nat w, Ring a) => Group (Matrix h w a)
• (Field k, Nat s) => VectorField (Matrix s s) k
• (Nat h, Nat w, Show a) => Show (Matrix h w a)
• (Nat h, Nat w) => Functor (Matrix h w)
• (Nat h, Nat w) => Foldable (Matrix h w)
• (Eq a, Nat h, Nat w) => Eq (Matrix h w a)
• (Nat s, CommutativeRing a) => Semiring (Matrix s s a)
• (Nat s, CommutativeRing a) => Ring (Matrix s s a)
• (Nat h, Nat w, Arbitrary a) => Arbitrary (Matrix h w a)

fill :: forall a w h. Nat h => Nat w => (Int -> Int -> a) -> Matrix h w a

Creation

create Matrix of size hxw with a generator-function

> fill (\x y -> x) :: Matrix D2 D3 Int
  [0,1,2]
  [0,1,2]

fromVec :: forall a w h s. Nat s => Nat h => Nat w => Mul h w s => Vec s a -> Matrix h w a

> fromVec (Vec.vec3 1 2 3) :: Matrix D1 D3 _
  [1,2,3]

> fromVec (Vec.vec3 1 2 3) :: Matrix D3 D1 _
  [1]
  [2]
  [3]

toArray :: forall a w h. Nat h => Nat w => Matrix h w a -> Array (Array a)

Convert Matrix to Array

> toArray (matrix22 1 2 3 4)
[[1,2],[3,4]]

replicate' :: forall a h w. Nat w => Nat h => a -> Matrix h w a

create Matrix with one value

> replicate' "-" :: Matrix D3 D5 _
 ["-","-","-","-","-"]
 ["-","-","-","-","-"]
 ["-","-","-","-","-"]

height :: forall a w h. Nat h => Nat w => Matrix h w a -> Int

Basic Accesors

height of the matrix (aka number of rows)

width :: forall a w h. Nat h => Nat w => Matrix h w a -> Int

width of the matrix (aka number of columns)

size :: forall a s. Nat s => Matrix s s a -> Int

size of square matrix

index :: forall a w h y x. Nat x => Nat y => Lt x w => Lt y h => x -> y -> Matrix h w a -> a

value a position in matrix:

> m
 [1,2,-3]
 [4,9,0]
 [11,2,8]
> index d0 d2 m -- d0, d2 are value-representations of D0 D2
11

index' :: forall a w h. Nat h => Nat w => Int -> Int -> Matrix h w a -> Maybe a

value a position in matrix:

> m
 [1,2,-3]
 [4,9,0]
 [11,2,8]
> index 0 2 m
Just 11
> index 10 2 m
Nothing

unsafeIndex :: forall a w h. Partial => Nat h => Nat w => Matrix h w a -> Int -> Int -> a

column :: forall x a w h. Nat x => Lt x w => Nat h => Matrix h w a -> x -> Vec h a

get vector for column

> m
  [1,2]
  [0,5]
> column m d1
[2,5]

columnUnsafe :: forall a w h. Partial => Nat h => Nat w => Matrix h w a -> Int -> Vec h a

row :: forall y a w h. Nat y => Lt y h => Nat w => Matrix h w a -> y -> Vec w a

get vector for row

> m
  [1,2]
  [0,5]
> row m d1
[0,5]

rowUnsafe :: forall a w h. Partial => Nat h => Nat w => Matrix h w a -> Int -> Vec w a

concatH :: forall a w w2 w1 h. Add w1 w2 w => Nat h => Matrix h w1 a -> Matrix h w2 a -> Matrix h w a

> matrix22 1 2 3 4 `concatH` matrix22 0 1 2 0
 [1,2,0,1]
 [3,4,2,0]

concatV :: forall a w h h2 h1. Add h1 h2 h => Nat w => Matrix h1 w a -> Matrix h2 w a -> Matrix h w a

Basic Operations

> matrix22 1 2 3 4 `concatV` matrix22 0 1 2 0
 [1,2]
 [3,4]
 [0,1]
 [2,0]

zipWithE :: forall c b a h w. Nat w => Nat h => (a -> b -> c) -> Matrix h w a -> Matrix h w b -> Matrix h w c

Zip Matrices with function with Exactly the same size

> zipWithE Tuple (matrix22 1 2 0 0) (matrix22 1 3 4 5)
 [(Tuple 1 1),(Tuple 2 3)]
 [(Tuple 0 4),(Tuple 0 5)]

zipE :: forall b a h w. Nat w => Nat h => Matrix h w a -> Matrix h w b -> Matrix h w (Tuple a b)

Zip Matrices with Exactly the same size

> zipE (matrix22 1 2 0 0) (matrix22 1 3 4 5)
 [(Tuple 1 1),(Tuple 2 3)]
 [(Tuple 0 4),(Tuple 0 5)]

negateMatrix :: forall a w h. Nat h => Nat w => Ring a => Matrix h w a -> Matrix h w a

mulMatrix :: forall a w h. Nat h => Nat w => CommutativeRing a => Matrix h w a -> Matrix w h a -> Matrix h h a

matrixOne :: forall a w h. Semiring a => Nat h => Nat w => Matrix h w a

matrixZero :: forall a w h. Semiring a => Nat h => Nat w => Matrix h w a

scalarMul :: forall a w h. Nat h => Nat w => Semiring a => a -> Matrix h w a -> Matrix h w a

Operator alias for Data.Matrix.concatV (right-associative / precedence 3)