on e4dbb8f help sign in
31 files changed+916−1071
since splitsnapshots
unifiedsplit
.ghc.environment.x86_64-linux-8.6.5+17 .github/workflows/ci.yml−43 .gitignore+2−54 .travis.yml−47 CHANGELOG.md−17 ChangeLog.md+3 LICENSE+26−17 README.md+30−34 Setup.hs+2 benchmark/Main.hs → app/Benchmarks.hs+13−11 test/Examples/Readme.hs → app/Examples.hs+10−25 app/Main.hs+7 test/Examples/Quantum.hs → app/Quantum.hs+4−6 test/Examples/Spreadsheets.hs → app/Spreadsheets.hs+4−5 appveyor.yml−34 hackage.sh+10 laop.cabal−89 package.yaml+57 src/LAoP/Dist.hs+2−2 src/LAoP/Dist/Internal.hs+43−44 src/LAoP/Matrix/Internal.hs+204−173 src/LAoP/Matrix/Nat.hs+80−68 src/LAoP/Matrix/Type.hs+124−143 src/LAoP/Relation.hs+4−3 src/LAoP/Relation/Internal.hs+200−211 src/LAoP/Utils.hs+1−4 src/LAoP/Utils/Internal.hs+2−28 stack-8.8.3.yaml−1 stack.yaml+66−1 stack.yaml.lock+4−4 test/Spec.hs+1−7
.ghc.environment.x86_64-linux-8.6.5new file+17
@@ -0,0 +1,17 @@
1+-- This is a GHC environment file written by cabal. This means you can
2+-- run ghc or ghci and get the environment of the project as a whole.
3+-- But you still need to use cabal repl $target to get the environment
4+-- of specific components (libs, exes, tests etc) because each one can
5+-- have its own source dirs, cpp flags etc.
6+--
7+clear-package-db
8+global-package-db
9+package-db /home/bolt/.cabal/store/ghc-8.6.5/package.db
10+package-db packagedb/ghc-8.6.5
11+package-id laop-0.1.0.0-inplace
12+package-id base-4.12.0.0
13+package-id ghc-prim-0.5.3
14+package-id rts
15+package-id integer-gmp-1.0.2.0
16+package-id deepseq-1.4.4.0
17+package-id array-0.5.3.0
.github/workflows/ci.ymldeleted−43
@@ -1,43 +0,0 @@
1−name: CI
2−
3−# Trigger the workflow on push or pull request, but only for the master branch
4−on:
5− pull_request:
6− push:
7− branches: [master]
8−
9−jobs:
10− build:
11− name: ghc ${{ matrix.ghc }}
12− runs-on: ubuntu-16.04
13− strategy:
14− matrix:
15− cabal: ["3.0"]
16− ghc:
17− - "8.6.5"
18− - "8.8.3"
19−
20− steps:
21− - uses: actions/checkout@v2
22− if: github.event.action == 'opened' || github.event.action == 'synchronize' || github.event.ref == 'refs/heads/master'
23−
24− - uses: actions/setup-haskell@v1
25− name: Setup Haskell
26− with:
27− ghc-version: ${{ matrix.ghc }}
28− cabal-version: ${{ matrix.cabal }}
29−
30− - uses: actions/cache@v1
31− name: Cache ~/.cabal/store
32− with:
33− path: ~/.cabal/store
34− key: ${{ runner.os }}-${{ matrix.ghc }}-cabal
35−
36− - name: Build
37− run: |
38− cabal v2-update
39− cabal v2-build --enable-tests --enable-benchmarks
40−
41− - name: Test
42− run: |
43− cabal v2-test --enable-tests
.gitignore+2−54
@@ -1,55 +1,3 @@
1−### Haskell
2−dist
3−dist-*
4−cabal-dev
5−*.o
6−*.hi
7−*.chi
8−*.chs.h
9−*.dyn_o
10−*.dyn_hi
11−*.prof
12−*.aux
13−*.hp
14−*.eventlog
15−.virtualenv
16−.hsenv
17−.hpc
18−.cabal-sandbox/
19−cabal.sandbox.config
20−cabal.config
21−cabal.project.local
22−.ghc.environment.*
23−.HTF/
24−# Stack
251.stack-work/
26−stack.yaml.lock
27−
28−### IDE/support
29−# Vim
30−[._]*.s[a-v][a-z]
31−[._]*.sw[a-p]
32−[._]s[a-v][a-z]
33−[._]sw[a-p]
34−*~
35−tags
36−
37−# IntellijIDEA
38−.idea/
39−.ideaHaskellLib/
40−*.iml
41−
42−# Atom
43−.haskell-ghc-mod.json
44−
45−# VS
46−.vscode/
47−
48−# Emacs
49−*#
50−.dir-locals.el
51−TAGS
52−
53−# other
54−.DS_Store
55−hackage.sh
2+laop.cabal
3+*~
.travis.ymldeleted−47
@@ -1,47 +0,0 @@
1−sudo: true
2−language: haskell
3−
4−git:
5− depth: 5
6−
7−cabal: "3.0"
8−
9−cache:
10− directories:
11− - "$HOME/.cabal/store"
12− - "$HOME/.stack"
13− - "$TRAVIS_BUILD_DIR/.stack-work"
14−
15−matrix:
16− include:
17− - ghc: 8.6.5
18− - ghc: 8.8.3
19−
20− - ghc: 8.8.3
21− env: STACK_YAML="$TRAVIS_BUILD_DIR/stack-8.8.3.yaml"
22−
23− - ghc: 8.6.5
24− env: STACK_YAML="$TRAVIS_BUILD_DIR/stack.yaml"
25−
26−
27−install:
28− - |
29− if [ -z "$STACK_YAML" ]; then
30− cabal v2-update
31− cabal v2-build --enable-tests --enable-benchmarks
32− else
33− curl -sSL https://get.haskellstack.org/ | sh
34− stack --version
35− stack build --system-ghc --test --bench --no-run-tests --no-run-benchmarks
36− fi
37−
38−script:
39− - |
40− if [ -z "$STACK_YAML" ]; then
41− cabal v2-test --enable-tests
42− else
43− stack test --system-ghc
44− fi
45−
46−notifications:
47− email: false
CHANGELOG.mddeleted−17
@@ -1,17 +0,0 @@
1−# Changelog
2−
3−`laop` uses [PVP Versioning][1].
4−The changelog is available [on GitHub][2].
5−
6−## 0.1.1.1
7−
8−* Bump base version to work with cabal
9−
10−## 0.1.1.0
11−
12−* Package is more organized and now has tests and benchmarks separated
13−* Repository is more organized and clean
14−* Added CI
15−
16−[1]: https://pvp.haskell.org
17−[2]: https://github.com/bolt12/laop2/releases
ChangeLog.mdnew file+3
@@ -0,0 +1,3 @@
1+# Changelog for laop
2+
3+## Unreleased changes
LICENSE+26−17
@@ -1,21 +1,30 @@
1−MIT License
1+Copyright Armando Santos (c) 2019
22
3−Copyright (c) 2020 Armando Santos
3+All rights reserved.
44
5−Permission is hereby granted, free of charge, to any person obtaining a copy
6−of this software and associated documentation files (the "Software"), to deal
7−in the Software without restriction, including without limitation the rights
8−to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9−copies of the Software, and to permit persons to whom the Software is
10−furnished to do so, subject to the following conditions:
5+Redistribution and use in source and binary forms, with or without
6+modification, are permitted provided that the following conditions are met:
117
12−The above copyright notice and this permission notice shall be included in all
13−copies or substantial portions of the Software.
8+ * Redistributions of source code must retain the above copyright
9+ notice, this list of conditions and the following disclaimer.
1410
15−THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16−IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17−FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18−AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19−LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20−OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21−SOFTWARE.
11+ * Redistributions in binary form must reproduce the above
12+ copyright notice, this list of conditions and the following
13+ disclaimer in the documentation and/or other materials provided
14+ with the distribution.
15+
16+ * Neither the name of Armando Santos nor the names of other
17+ contributors may be used to endorse or promote products derived
18+ from this software without specific prior written permission.
19+
20+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
21+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
22+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
23+A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
24+OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
25+SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
26+LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
27+DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
28+THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
29+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
30+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
README.md+30−34
@@ -1,11 +1,5 @@
11# laop - Linear Algebra of Programming library
22
3−[![GitHub CI](https://github.com/bolt12/laop/workflows/CI/badge.svg)](https://github.com/bolt12/laop/actions)
4−[![Build status](https://img.shields.io/travis/bolt12/laop.svg?logo=travis)](https://travis-ci.org/bolt12/laop)
5−[![Hackage](https://img.shields.io/hackage/v/laop.svg?logo=haskell)](https://hackage.haskell.org/package/laop)
6−[![Stackage Lts](http://stackage.org/package/laop/badge/lts)](http://stackage.org/lts/package/laop)
7−[![Stackage Nightly](http://stackage.org/package/laop/badge/nightly)](http://stackage.org/nightly/package/laop)
8−
93The LAoP discipline generalises relations and functions treating them as
104Boolean matrices and in turn consider these as arrows.
115
@@ -16,38 +10,40 @@ motivation behind the library, the underlying theory, and implementation details
1610This module offers many of the combinators mentioned in the work of
1711[Macedo (2012)](https://repositorium.sdum.uminho.pt/handle/1822/22894) and [Oliveira (2012)](https://pdfs.semanticscholar.org/ccf5/27fa9179081223bffe8067edd81948644fc0.pdf).
1812
19−See the package in hackage [here](https://hackage.haskell.org/package/laop-0.1.1.0)
20−
21−A Functional Pearl has been written and can be regarded as the [reference document](https://github.com/bolt12/tymfgg-pearl) for this library.
22−
23−## Features
24−
25−This library offers 3 main matrix programming modules:
13+See the package in hackage [here](https://hackage.haskell.org/package/laop-0.1.0.5)
2614
27−- One in which matrices are typed with type level natural numbers;
28−- One in which matrices are typed with arbitrary generic data types;
29−- One in which matrices are regarded as relations, i.e. boolean matrices;
15+There are a couple of repos with a WIP of benchmarks comparing [matrix composition](https://github.com/bolt12/laop-benchmarks) and a real use case of [data analytics](https://github.com/bolt12/laop-analytics).
3016
31−There's also an experimental module that uses matrices to represent probability
32−distributions.
17+A Functional Pearl is also on its way, hopefully will be the reference document for this library.
3318
34−The most interesting feature is that matrices are represented as an inductive data type.
35−Given this formulation, matrix algorithms can be expressed in a much more elegant and
36−calculational style than the traditional vector of vectors representation. This data type
37−guarantees that a matrix will always have valid dimensions. It can also express block matrix
38−computations naturally, which leads to total, efficient and statically typed manipulation
39−and transformation functions.
40−
41−Like matrix multiplication, other common operations, such as matrix transposition, benefit from a block-oriented structure that leads to a simple and natural divide-and-conquer algorithmic solution. Performance wise, this means that without much effort we can obtain optimal cache-oblivious algorithms.
42−
43−Given this, this new matrix formulation compared to other libraries:
44−
45−- Is more compositional and polymorphic and does not have partial matrix manipulation functions (hence less chances for usage errors);
46−- Our implementation of matrices enables simple manipulation of submatrices, making it particularly suitable for formal verification and equation reasoning, using the mathematical framework defined by the linear algebra of programming. Furthermore, the data type constructors ensure that the matrices of this kind are sound, i.e. malformed matrices with incorrect dimensions of the sort, can not be constructed.
47−
48−## Known issues
19+## Features
4920
50−Unfortunately, due to the use of type-level programming features, this approach sometimes requires type dimensions to be constrainted, in some way, impossible to write idiomatic Arrow instances, for example. Type inference isn't perfect, when it comes to infer the types of matrices which dimensions are computed using type level naturals multiplication, the compiler needs type annotations in order to succeed. And not all kinds of programs can be modeled using matrices, namely programs that deal with arbitrary infinite data types such as lists or integers (although there are some workarounds).
21+This library offers:
22+
23+- An internal module representation that uses normal datatypes (`Void`, `()`, `Either`) for matrix dimensions and two
24+ type families `FromNat` and `Count` to make it easier to work with these type of matrices.
25+- An interfacing module that uses generalised types for the dimensions and is just a newtype wrapper
26+ around the internal matrix data type.
27+- An interfacing module that uses type level naturals for the dimensions and is just a newtype wrapper
28+ around the internal matrix data type.
29+- An interfacing module that restricts the matrix contents to being only 0's or 1's (True
30+ and False). This module is called 'Relation' and offers many of the combinators seen in
31+ AoP and Relational Calculus/Algebra.
32+- A very simple Probabilistic Programming module and several functions and data types to
33+ make it easier to deal with sample space.
34+
35+Given this, this new matrix formulation compared to other libraries one has much more advantages, such as:
36+
37+- Has an inductive definition enabling writing matrix manipulation functions in a much more elegant and calculational way;
38+- Statically typed dimensions;
39+- Polymorphic data type dimensions;
40+- Polymorphic matrix content;
41+- Awesome dimension type inference;
42+- Fast type natural conversion via `FromNat` type family;
43+- Matrix `Junc` and `Split`-ing in O(1);
44+- Matrix composition takes advantage of divide-and-conquer and fusion laws.
45+
46+Unfortunately, this approach does not solve the issue of type dimensions being in some way constrainted making it impossible to write Arrow instances, for example. Type inference isn't perfect, when it comes to infer the types of matrices which dimensions are computed using type level naturals multiplication, the compiler needs type annotations in order to succeed.
5147
5248## Notes
5349
Setup.hsnew file+2
@@ -0,0 +1,2 @@
1+import Distribution.Simple
2+main = defaultMain
benchmark/Main.hs → app/Benchmarks.hsrenamed+13−11
@@ -8,28 +8,30 @@
88{-# LANGUAGE AllowAmbiguousTypes #-}
99{-# LANGUAGE ScopedTypeVariables #-}
1010
11−module Main (main) where
11+module Benchmarks
12+ ( benchmark
13+ )
14+ where
1215
1316import LAoP.Dist.Internal
1417import LAoP.Utils
15−import LAoP.Matrix.Type hiding (CountableN, Countable, FLN)
16−import qualified LAoP.Matrix.Type as T (FLN)
18+import LAoP.Matrix.Type hiding (CountableN, Countable, FromListsN)
19+import qualified LAoP.Matrix.Type as T (FromListsN)
1720import Criterion.Main
1821import Control.DeepSeq
1922import Test.QuickCheck
2023import GHC.TypeLits
2124import Data.Proxy
22−import Prelude hiding (id, (.))
2325
2426selectM2 ::
2527 ( Num e,
26− T.FLN b b,
28+ T.FromListsN e b b,
2729 CountableN b
2830 ) => Matrix e cols (Either a b) -> Matrix e a b -> Matrix e cols b
2931selectM2 m y = join y iden `comp` m
3032
3133selectD2 ::
32− ( FLN b b,
34+ ( FromListsN b b,
3335 CountableN b
3436 ) => Dist (Either a b) -> Matrix Prob a b -> Dist b
3537selectD2 (D d) m = D (join m iden `comp` d)
@@ -37,7 +39,7 @@ selectD2 (D d) m = D (join m iden `comp` d)
3739-- Composition with iden
3840compId m = comp iden m
3941
40−randomDist :: forall a . (Countable a, FLN () a) => Gen (Dist a)
42+randomDist :: forall a . (Countable a, FromListsN () a) => Gen (Dist a)
4143randomDist = do
4244 let size = fromInteger (natVal (Proxy :: Proxy (Count a)))
4345 l <- vectorOf size (arbitrary :: Gen Prob)
@@ -46,7 +48,7 @@ randomDist = do
4648 m = fromLists lr
4749 return (D m)
4850
49−randomMatrix :: forall a b . (CountableDims a b, FLN a b) => Gen (Matrix Prob a b)
51+randomMatrix :: forall a b . (CountableDimensions a b, FromListsN a b) => Gen (Matrix Prob a b)
5052randomMatrix = do
5153 let cols = fromInteger (natVal (Proxy :: Proxy (Count a)))
5254 rows = fromInteger (natVal (Proxy :: Proxy (Count b)))
@@ -105,7 +107,7 @@ normalize3 as l = let s = sum l
105107 probs = map (/ s) l
106108 in zip as probs
107109
108−randomDistF :: forall a b . (CountableDims a b, CoArbitrary a, Arbitrary b) => Gen (Dist' (a -> b))
110+randomDistF :: forall a b . (CountableDimensions a b, CoArbitrary a, Arbitrary b) => Gen (Dist' (a -> b))
109111randomDistF = do
110112 let a = fromInteger (natVal (Proxy :: Proxy (Count a)))
111113 b = fromInteger (natVal (Proxy :: Proxy (Count b)))
@@ -144,8 +146,8 @@ setupEnv2 = do
144146 distList2 <- generate (resize 1 (randomDistF @(Natural 0 100) @(Natural 0 100)))
145147 return (m21, m40, dist, dist2, distList1, distList2)
146148
147−main :: IO ()
148−main = defaultMain [
149+benchmark :: IO ()
150+benchmark = defaultMain [
149151 env setupEnv $ \ ~(m11, m12, m21, m22, m31, m32) -> bgroup "Matrix Composition" [
150152 bgroup "10x10" [
151153 bench "WHNF - 10x10" $ whnf (comp m11) m12
test/Examples/Readme.hs → app/Examples.hsrenamed+10−25
@@ -1,10 +1,11 @@
11{-# LANGUAGE GADTs #-}
22{-# LANGUAGE DeriveGeneric #-}
33{-# LANGUAGE FlexibleContexts #-}
4+{-# LANGUAGE TypeOperators #-}
45{-# LANGUAGE TypeApplications #-}
56{-# LANGUAGE DataKinds #-}
67
7−module Examples.Readme
8+module Examples
89 ( exec
910 )
1011 where
@@ -16,7 +17,8 @@ import LAoP.Dist
1617import GHC.TypeLits
1718import Data.Coerce
1819import qualified GHC.Generics as G
19−import Prelude hiding (id, (.))
20+import Control.Category hiding (id)
21+import Prelude hiding ((.))
2022
2123-- Monty Hall Problem
2224data Outcome = Win | Lose
@@ -65,34 +67,17 @@ data R = No | Yes
6567 deriving (Bounded, Enum, Eq, Show, G.Generic)
6668
6769rain :: Matrix Double () R
68−rain = matrixBuilder gen
69− where
70− gen (_, No) = 0.8
71− gen (_, Yes) = 0.2
70+rain = col [0.8, 0.2]
7271
7372sprinkler :: Matrix Double R S
74−sprinkler = matrixBuilder gen
75− where
76− gen (No, Off) = 0.6
77− gen (No, On) = 0.4
78− gen (Yes, Off) = 0.99
79− gen (Yes, On) = 0.01
73+sprinkler = fromLists [[0.6, 0.99], [0.4, 0.01]]
8074
8175grass :: Matrix Double (S, R) G
82−grass = matrixBuilder gen
83− where
84− gen ((Off, No), Dry) = 1
85− gen ((Off, Yes), Dry) = 0.2
86− gen ((On, No), Dry) = 0.1
87− gen ((On, Yes), Dry) = 0.01
88− gen ((Off, No), Wet) = 0
89− gen ((Off, Yes), Wet) = 0.8
90− gen ((On, No), Wet) = 0.9
91− gen ((On, Yes), Wet) = 0.99
76+grass = fromLists [[1, 0.2, 0.1, 0.01], [0, 0.8, 0.9, 0.99]]
9277
93−tag f = kr f id
78+tag f = kr f iden
9479
95−state g s r = tag g . tag s . r
80+state g s r = tag g `comp` tag s `comp` r
9681
9782grass_wet :: Matrix Double () (G, (S, R)) -> Matrix Double One One
9883grass_wet state = row [0,1] . fstM . state
@@ -171,7 +156,7 @@ exec = do
171156 putStrLn "Monty Hall Problem solution:"
172157 prettyPrint (secondChoice . firstChoice)
173158 putStrLn "\n Sum of dices probability:"
174− prettyPrint (sumSSM . kr die die)
159+ prettyPrint (sumSSM `comp` kr die die)
175160 putStrLn "\n Conditional dice throw:"
176161 prettyPrint conditionalThrows
177162 putStrLn "\n Checking that the last result is indeed a distribution: "
app/Main.hsnew file+7
@@ -0,0 +1,7 @@
1+module Main where
2+
3+import Examples
4+import Benchmarks
5+
6+main :: IO ()
7+main = benchmark
test/Examples/Quantum.hs → app/Quantum.hsrenamed+4−6
@@ -1,10 +1,8 @@
11{-# LANGUAGE StandaloneDeriving #-}
2−module Examples.Quantum where
2+module Quantum where
33
4−import LAoP.Utils
54import LAoP.Matrix.Type
65import Data.Complex
7−import Prelude hiding (id, (.))
86
97deriving instance Ord a => Ord (Complex a)
108
@@ -13,7 +11,7 @@ xor (False, b) = b
1311xor (True, b) = not b
1412
1513ker :: Num e => Matrix e a b -> Matrix e a a
16−ker m = tr m . m
14+ker m = tr m `comp` m
1715
1816cnot :: Matrix (Complex Double) (Bool, Bool) (Bool, Bool)
1917cnot = kr fstM (fromF xor)
@@ -21,11 +19,11 @@ cnot = kr fstM (fromF xor)
2119ccnot :: (Num e, Ord e) => Matrix e ((Bool, Bool), Bool) ((Bool, Bool), Bool)
2220ccnot = kr fstM (fromF f)
2321 where
24− f = xor . tp (uncurry (&&)) id
22+ f = xor . (tp (uncurry (&&)) id)
2523 tp f g (a,b) = (f a, g b)
2624
2725had :: Matrix (Complex Double) Bool Bool
2826had = (1/sqrt 2) .| fromLists [[1, 1], [1, -1]]
2927
3028bell :: Matrix (Complex Double) (Bool, Bool) (Bool, Bool)
31−bell = cnot . (had >< iden)
29+bell = cnot `comp` (had >< iden)
test/Examples/Spreadsheets.hs → app/Spreadsheets.hsrenamed+4−5
@@ -1,11 +1,10 @@
11{-# LANGUAGE DeriveGeneric #-}
22
3−module Examples.Spreadsheets
3+module Spreadsheets
4+ where
45
5−import LAoP.Utils
66import LAoP.Matrix.Type
77import GHC.Generics
8−import Prelude hiding (id, (.))
98
109data Student = Student1 | Student2 | Student3 | Student4
1110 deriving (Eq, Show, Enum, Bounded, Generic)
@@ -37,10 +36,10 @@ xls :: Matrix Float Question One
3736 -> Matrix Float (Either Question Results) (Either One Student)
3837xls w m t = join (fork w m) (fork zeros r)
3938 where
40− rExam = m . tr w
39+ rExam = m `comp` tr w
4140 rTest = tr t
4241 rFinal = rTest `maxPW` rExam
43− r = (rExam . tr exam) + (rTest . tr test) + (rFinal . tr final)
42+ r = (rExam `comp` tr exam) + (rTest `comp` tr test) + (rFinal `comp` tr final)
4443
4544-- | Overloaded, point-wise 'max' function
4645maxPW :: Ord e => Matrix e a b -> Matrix e a b -> Matrix e a b
appveyor.ymldeleted−34
@@ -1,34 +0,0 @@
1−clone_folder: "c:\\WORK"
2−clone_depth: 5
3−
4−# Do not build feature branch with open Pull Requests
5−skip_branch_with_pr: true
6−
7−platform:
8− - x86_64
9−
10−cache:
11− - "C:\\SR"
12− - dist-newstyle
13−
14−environment:
15− global:
16− CABOPTS: --store-dir=C:\\SR
17−
18− matrix:
19− - GHCVER: 8.6.5
20−
21−install:
22− - choco source add -n mistuke -s https://www.myget.org/F/mistuke/api/v2
23− - choco install -y cabal --version 2.4.1.0
24− - choco install -y ghc --version 8.6.3
25− - refreshenv
26−
27−before_build:
28− - cabal --version
29− - ghc --version
30− - cabal %CABOPTS% v2-update
31−
32−build_script:
33− - cabal %CABOPTS% v2-build --enable-tests
34− - cabal %CABOPTS% v2-test --enable-tests
hackage.shnew file+10
@@ -0,0 +1,10 @@
1+#!/bin/sh
2+set -e
3+
4+dir=$(mktemp -d dist-docs.XXXXXX)
5+trap 'rm -r "$dir"' EXIT
6+
7+# assumes cabal 2.4 or later
8+cabal v2-haddock --builddir="$dir" --haddock-for-hackage --enable-doc
9+
10+cabal upload -d $dir/*-docs.tar.gz --publish
laop.cabaldeleted−89
@@ -1,89 +0,0 @@
1−cabal-version: 2.4
2−name: laop
3−version: 0.1.1.1
4−synopsis: Matrix programming library
5−description: Matrix programming library that uses a type-safe inductive definition
6− inspired by the Linear Algebra of Programming
7−homepage: https://github.com/bolt12/laop
8−bug-reports: https://github.com/bolt12/laop/issues
9−license: MIT
10−license-file: LICENSE
11−author: Armando Santos
12−maintainer: Armando Santos <armandoifsantos@gmail.com>
13−copyright: 2020 Armando Santos
14−category: Data
15−build-type: Simple
16−extra-doc-files: README.md
17− CHANGELOG.md
18−tested-with: GHC == 8.6.5
19− GHC == 8.8.3
20−
21−source-repository head
22− type: git
23− location: https://github.com/bolt12/laop.git
24−
25−common common-options
26− build-depends: base >= 4.12.0.0 && < 5,
27− deepseq
28−
29− ghc-options: -Wall
30− -Wcompat
31− -Widentities
32− -Wincomplete-uni-patterns
33− -Wincomplete-record-updates
34− if impl(ghc >= 8.0)
35− ghc-options: -Wredundant-constraints
36− if impl(ghc >= 8.2)
37− ghc-options: -fhide-source-paths
38− if impl(ghc >= 8.4)
39− ghc-options: -Wmissing-export-lists
40− -Wpartial-fields
41− if impl(ghc >= 8.8)
42− ghc-options: -Wmissing-deriving-strategies
43−
44− default-language: Haskell2010
45−
46−library
47− import: common-options
48− hs-source-dirs: src
49− exposed-modules: LAoP.Dist
50− LAoP.Dist.Internal
51− LAoP.Matrix.Internal
52− LAoP.Matrix.Nat
53− LAoP.Matrix.Type
54− LAoP.Relation
55− LAoP.Relation.Internal
56− LAoP.Utils
57− LAoP.Utils.Internal
58−
59−test-suite laop-test
60− import: common-options
61− type: exitcode-stdio-1.0
62− hs-source-dirs: test
63− other-modules: Examples.Readme
64− main-is: Spec.hs
65− build-depends: laop
66− ghc-options: -threaded
67− -rtsopts
68− -with-rtsopts=-N
69− -funfolding-use-threshold=16
70− -fexcess-precision
71− -optc-O3
72− -optc-ffast-math
73−
74−benchmark laop-benchmark
75− import: common-options
76− type: exitcode-stdio-1.0
77− hs-source-dirs: benchmark
78− main-is: Main.hs
79− build-depends: criterion
80− , QuickCheck
81− , deepseq
82− , laop
83− ghc-options: -threaded
84− -rtsopts
85− -with-rtsopts=-N
86− -funfolding-use-threshold=16
87− -fexcess-precision
88− -optc-O3
89− -optc-ffast-math
package.yamlnew file+57
@@ -0,0 +1,57 @@
1+name: laop
2+version: 0.1.0.5
3+github: "bolt12/laop"
4+license: BSD3
5+author: "Armando Santos"
6+maintainer: "armandoifsantos@gmail.com"
7+copyright: "MIT"
8+
9+extra-source-files:
10+- README.md
11+- ChangeLog.md
12+
13+# Metadata used when publishing your package
14+# synopsis: Short description of your package
15+category: Data
16+
17+# To avoid duplicated efforts in documentation and dealing with the
18+# complications of embedding Haddock markup inside cabal files, it is
19+# common to point users to the README.md file.
20+description: Please see the README on GitHub at <https://github.com/bolt12/laop#readme>
21+
22+dependencies:
23+- base >= 4.7 && < 5
24+- deepseq
25+
26+library:
27+ source-dirs: src
28+
29+executables:
30+ laop-exe:
31+ main: Main.hs
32+ source-dirs: app
33+ ghc-options:
34+ - -threaded
35+ - -rtsopts
36+ - -with-rtsopts=-N
37+ - -funfolding-use-threshold=16
38+ - -fexcess-precision # Good for doubles
39+ - -optc-O3 # Good for doubles
40+ - -optc-ffast-math # Good for doubles
41+ - -O2
42+ dependencies:
43+ - laop
44+ - criterion
45+ - deepseq
46+ - QuickCheck
47+
48+tests:
49+ laop-test:
50+ main: Spec.hs
51+ source-dirs: test
52+ ghc-options:
53+ - -threaded
54+ - -rtsopts
55+ - -with-rtsopts=-N
56+ dependencies:
57+ - laop
src/LAoP/Dist.hs+2−2
@@ -39,8 +39,8 @@ module LAoP.Dist
3939 -- * Constraint type synonyms
4040 Countable,
4141 CountableN,
42− CountableDimsN,
43− FLN,
42+ CountableDimensionsN,
43+ FromListsN,
4444 Liftable,
4545 TrivialP,
4646
src/LAoP/Dist/Internal.hs+43−44
@@ -16,8 +16,8 @@ module LAoP.Dist.Internal
1616
1717 Countable,
1818 CountableN,
19− CountableDimsN,
20− FLN,
19+ CountableDimensionsN,
20+ FromListsN,
2121 Liftable,
2222 TrivialP,
2323
@@ -43,8 +43,7 @@ module LAoP.Dist.Internal
4343 )
4444 where
4545
46−import LAoP.Matrix.Type hiding (TrivialP, Countable, CountableDims, CountableN, CountableDimsN, Liftable, FLN)
47−import Prelude hiding (id, (.))
46+import LAoP.Matrix.Type hiding (TrivialP, Countable, CountableDimensions, CountableN, CountableDimensionsN, Liftable, FromListsN)
4847import qualified LAoP.Matrix.Internal as I
4948import LAoP.Utils
5049import GHC.TypeLits
@@ -62,18 +61,18 @@ newtype Dist a = D (Matrix Prob () a)
6261 deriving (Show, Num, Eq, Ord, NFData) via (Matrix Prob () a)
6362
6463-- | Constraint type synonyms to keep the type signatures less convoluted
65−type Countable a = KnownNat (I.Count a)
66−type CountableN a = KnownNat (I.Count (I.Normalize a))
67−type CountableDimsN a b = (CountableN a, CountableN b)
68−type FLN a b = I.FL (I.Normalize a) (I.Normalize b)
69−type Liftable a b = (Bounded a, Bounded b, Enum a, Enum b, Eq b, Num Prob, Ord Prob)
70−type TrivialP a b = Normalize (a, b) ~ Normalize (Normalize a, Normalize b)
64+type Countable a = KnownNat (I.Count a)
65+type CountableN a = KnownNat (I.Count (I.Normalize a))
66+type CountableDimensionsN a b = (CountableN a, CountableN b)
67+type FromListsN a b = I.FromLists Prob (I.Normalize a) (I.Normalize b)
68+type Liftable a b = (Bounded a, Bounded b, Enum a, Enum b, Eq b, Num Prob, Ord Prob)
69+type TrivialP a b = Normalize (a, b) ~ Normalize (Normalize a, Normalize b)
7170
7271-- | Functor instance
7372fmapD ::
7473 ( Liftable a b,
75− CountableDimsN a b,
76− FLN b a
74+ CountableDimensionsN a b,
75+ FromListsN b a
7776 )
7877 =>
7978 (a -> b) -> Dist a -> Dist b
@@ -85,17 +84,17 @@ unitD = D (one 1)
8584
8685-- | Applicative/Monoidal instance 'mult' function
8786multD ::
88− ( CountableDimsN a b,
87+ ( CountableDimensionsN a b,
8988 CountableN (a, b),
90− FLN (a, b) a,
91− FLN (a, b) b,
89+ FromListsN (a, b) a,
90+ FromListsN (a, b) b,
9291 TrivialP a b
9392 ) => Dist a -> Dist b -> Dist (a, b)
9493multD (D a) (D b) = D (kr a b)
9594
9695-- | Selective instance function
9796selectD ::
98− ( FLN b b,
97+ ( FromListsN b b,
9998 CountableN b
10099 ) => Dist (Either a b) -> Matrix Prob a b -> Dist b
101100selectD (D d) m = D (selectM d m)
@@ -104,17 +103,17 @@ selectD (D d) m = D (selectM d m)
104103-- functions to apply to a given argument;
105104branchD ::
106105 ( Num e,
107− CountableDimsN a b,
108− CountableDimsN c (Either b c),
109− FLN c b,
110− FLN a b,
111− FLN a a,
112− FLN b b,
113− FLN c c,
114− FLN b a,
115− FLN b c,
116− FLN (Either b c) b,
117− FLN (Either b c) c
106+ CountableDimensionsN a b,
107+ CountableDimensionsN c (Either b c),
108+ FromListsN c b,
109+ FromListsN a b,
110+ FromListsN a a,
111+ FromListsN b b,
112+ FromListsN c c,
113+ FromListsN b a,
114+ FromListsN b c,
115+ FromListsN (Either b c) b,
116+ FromListsN (Either b c) c
118117 )
119118 => Dist (Either a b) -> Matrix Prob a c -> Matrix Prob b c -> Dist c
120119branchD x l r = f x `selectD` g l `selectD` r
@@ -124,11 +123,11 @@ branchD x l r = f x `selectD` g l `selectD` r
124123
125124-- | Branch on a Boolean value, skipping unnecessary computations.
126125ifD ::
127− ( CountableDimsN a (Either () a),
128− FLN a a,
129− FLN a (),
130− FLN () a,
131− FLN (Either () a) a
126+ ( CountableDimensionsN a (Either () a),
127+ FromListsN a a,
128+ FromListsN a (),
129+ FromListsN () a,
130+ FromListsN (Either () a) a
132131 )
133132 => Dist Bool -> Dist a -> Dist a -> Dist a
134133ifD x (D t) (D e) = branchD x' t e
@@ -136,7 +135,7 @@ ifD x (D t) (D e) = branchD x' t e
136135 x' = bool (Right ()) (Left ()) `fmapD` x
137136
138137-- | Monad instance 'return' function
139−returnD :: forall a . (Enum a, FLN () a, Countable a) => a -> Dist a
138+returnD :: forall a . (Enum a, FromListsN () a, Countable a) => a -> Dist a
140139returnD a = D (col l)
141140 where
142141 i = fromInteger $ natVal (Proxy :: Proxy (Count a))
@@ -151,7 +150,7 @@ bindD (D d) m = D (m `comp` d)
151150(??) ::
152151 ( Enum a,
153152 Countable a,
154− FLN () a
153+ FromListsN () a
155154 ) => (a -> Bool) -> Dist a -> Prob
156155(??) p d =
157156 let l = toValues d
@@ -161,11 +160,11 @@ bindD (D d) m = D (m `comp` d)
161160-- Distribution Construction
162161
163162-- | Constructs a Bernoulli distribution
164−choose :: (FLN () a) => Prob -> Dist a
163+choose :: (FromListsN () a) => Prob -> Dist a
165164choose prob = D (col [prob, 1 - prob])
166165
167166-- | Creates a distribution given a shape function
168−shape :: (FLN () a) => (Prob -> Prob) -> [a] -> Dist a
167+shape :: (FromListsN () a) => (Prob -> Prob) -> [a] -> Dist a
169168shape _ [] = error "Probability.shape: empty list"
170169shape f xs =
171170 let incr = 1 / fromIntegral (length xs - 1)
@@ -173,23 +172,23 @@ shape f xs =
173172 in fromFreqs (zip xs ps)
174173
175174-- | Constructs a Linear distribution
176−linear :: (FLN () a) => [a] -> Dist a
175+linear :: (FromListsN () a) => [a] -> Dist a
177176linear = shape id
178177
179178-- | Constructs an Uniform distribution
180−uniform :: (FLN () a) => [a] -> Dist a
179+uniform :: (FromListsN () a) => [a] -> Dist a
181180uniform = shape (const 1)
182181
183182-- | Constructs an Negative Exponential distribution
184−negExp :: (FLN () a) => [a] -> Dist a
183+negExp :: (FromListsN () a) => [a] -> Dist a
185184negExp = shape (\x -> exp (-x))
186185
187186-- | Constructs an Normal distribution
188−normal :: (FLN () a) => [a] -> Dist a
187+normal :: (FromListsN () a) => [a] -> Dist a
189188normal = shape (normalCurve 0.5 0.5)
190189
191190-- | Transforms a 'Dist' into a list of pairs.
192−toValues :: forall a . (Enum a, Countable a, FLN () a) => Dist a -> [(a, Prob)]
191+toValues :: forall a . (Enum a, Countable a, FromListsN () a) => Dist a -> [(a, Prob)]
193192toValues (D d) =
194193 let rows = fromInteger (natVal (Proxy :: Proxy (Count a)))
195194 probs = toList d
@@ -197,7 +196,7 @@ toValues (D d) =
197196 in res
198197
199198-- | Pretty a distribution
200−prettyDist :: forall a. (Show a, Enum a, Countable a, FLN () a) => Dist a -> String
199+prettyDist :: forall a. (Show a, Enum a, Countable a, FromListsN () a) => Dist a -> String
201200prettyDist d =
202201 let values = sortBy (\(a, p1) (b, p2) -> compare p2 p1) (toValues @a d)
203202 w = maximum (map (length . show . fst) values)
@@ -209,12 +208,12 @@ prettyDist d =
209208 showR n x = show x ++ " "
210209
211210-- | Pretty Print a distribution
212−prettyPrintDist :: forall a . (Show a, Enum a, Countable a, FLN () a) => Dist a -> IO ()
211+prettyPrintDist :: forall a . (Show a, Enum a, Countable a, FromListsN () a) => Dist a -> IO ()
213212prettyPrintDist = putStrLn . prettyDist @a
214213
215214-- Auxiliary functions
216215
217−fromFreqs :: (FLN () a) => [(a,Prob)] -> Dist a
216+fromFreqs :: (FromListsN () a) => [(a,Prob)] -> Dist a
218217fromFreqs xs = D (col (map (\(x,p) -> p/q) xs))
219218 where q = sum $ map snd xs
220219
src/LAoP/Matrix/Internal.hs+204−173
@@ -30,7 +30,7 @@
3030-- motivation behind the library, the underlying theory, and implementation details.
3131--
3232-- This module offers many of the combinators mentioned in the work of
33−-- Macedo (2012) and Oliveira (2012).
33+-- Macedo (2012) and Oliveira (2012).
3434--
3535-- This is an Internal module and it is no supposed to be imported.
3636--
@@ -43,23 +43,14 @@ module LAoP.Matrix.Internal
4343 --
4444 -- There exists two type families that make it easier to write
4545 -- matrix dimensions: 'FromNat' and 'Count'. This approach
46− -- leads to a very straightforward implementation
47− -- of LAoP combinators.
46+ -- leads to a very straightforward implementation
47+ -- of LAoP combinators.
4848
4949 -- * Type safe matrix representation
5050 Matrix (..),
5151
52− -- * Constraint type aliases
53− Countable,
54− CountableDims,
55− CountableN,
56− CountableDimsN,
57− FL,
58− FLN,
59− Liftable,
60− Trivial,
61−
6252 -- * Primitives
53+ empty,
6354 one,
6455 join,
6556 fork,
@@ -75,7 +66,6 @@ module LAoP.Matrix.Internal
7566 toLists,
7667 toList,
7768 matrixBuilder,
78− matrixBuilder',
7969 row,
8070 col,
8171 zeros,
@@ -86,9 +76,7 @@ module LAoP.Matrix.Internal
8676 -- * Misc
8777 -- ** Get dimensions
8878 columns,
89− columns',
9079 rows,
91− rows',
9280
9381 -- ** Matrix Transposition
9482 tr,
@@ -130,7 +118,6 @@ module LAoP.Matrix.Internal
130118
131119 -- | Note that given the restrictions imposed it is not possible to
132120 -- implement the standard type classes present in standard Haskell.
133−
134121 -- *** Matrix pairing projections
135122 fstM,
136123 sndM,
@@ -176,17 +163,17 @@ import Data.Kind
176163import Data.List
177164import Data.Maybe
178165import Data.Proxy
179−import Data.Typeable
180166import Data.Void
181167import GHC.TypeLits
182168import Data.Type.Equality
183169import GHC.Generics
184170import Control.DeepSeq
185−import Prelude hiding (id, (.))
186−import qualified Prelude (id, (.))
171+import Control.Category
172+import Prelude hiding ((.))
187173
188174-- | LAoP (Linear Algebra of Programming) Inductive Matrix definition.
189175data Matrix e cols rows where
176+ Empty :: Matrix e Void Void
190177 One :: e -> Matrix e () ()
191178 Join :: Matrix e a rows -> Matrix e b rows -> Matrix e (Either a b) rows
192179 Fork :: Matrix e cols a -> Matrix e cols b -> Matrix e cols (Either a b)
@@ -216,6 +203,7 @@ type family Count (d :: Type) :: Nat where
216203--
217204-- Thanks to Li-Yao Xia this type family is super fast.
218205type family FromNat (n :: Nat) :: Type where
206+ FromNat 0 = Void
219207 FromNat 1 = ()
220208 FromNat n = FromNat' (Mod n 2 == 0) (FromNat (Div n 2))
221209
@@ -232,26 +220,29 @@ type family Normalize (d :: Type) :: Type where
232220-- | Constraint type synonyms to keep the type signatures less convoluted
233221type Countable a = KnownNat (Count a)
234222type CountableN a = KnownNat (Count (Normalize a))
235−type CountableDims a b = (Countable a, Countable b)
236−type CountableDimsN a b = (CountableN a, CountableN b)
237−type FL a b = FromLists a b
238−type FLN a b = FromLists (Normalize a) (Normalize b)
223+type CountableDimensions a b = (Countable a, Countable b)
224+type CountableDimensionsN a b = (CountableN a, CountableN b)
225+type FromListsN e a b = FromLists e (Normalize a) (Normalize b)
239226type Liftable e a b = (Bounded a, Bounded b, Enum a, Enum b, Eq b, Num e, Ord e)
240227type Trivial a = FromNat (Count a) ~ a
241228
242−-- | It is possible to implement a constrained version of the category type
243−-- class.
229+-- | It isn't possible to implement the 'id' function so it's
230+-- implementation is 'undefined'. However 'comp' can be and this partial
231+-- class implementation exists just to make the code more readable.
232+--
233+-- Please use 'iden' instead.
244234instance (Num e) => Category (Matrix e) where
245− type Object (Matrix e) a = (FL a a, Countable a)
246− id = iden
247− (.) = comp
235+ id = undefined
236+ (.) = comp
248237
249238instance NFData e => NFData (Matrix e cols rows) where
239+ rnf Empty = ()
250240 rnf (One e) = rnf e
251241 rnf (Join a b) = rnf a `seq` rnf b
252242 rnf (Fork a b) = rnf a `seq` rnf b
253243
254244instance Eq e => Eq (Matrix e cols rows) where
245+ Empty == Empty = True
255246 (One a) == (One b) = a == b
256247 (Join a b) == (Join c d) = a == c && b == d
257248 (Fork a b) == (Fork c d) = a == c && b == d
@@ -259,21 +250,25 @@ instance Eq e => Eq (Matrix e cols rows) where
259250 x@(Join _ _) == y@(Fork _ _) = abideJF x == y
260251
261252instance Num e => Num (Matrix e cols rows) where
253+
262254 a + b = zipWithM (+) a b
263255
264256 a - b = zipWithM (-) a b
265257
266258 a * b = zipWithM (*) a b
267259
260+ abs Empty = Empty
268261 abs (One a) = One (abs a)
269262 abs (Join a b) = Join (abs a) (abs b)
270263 abs (Fork a b) = Fork (abs a) (abs b)
271264
265+ signum Empty = Empty
272266 signum (One a) = One (signum a)
273267 signum (Join a b) = Join (signum a) (signum b)
274268 signum (Fork a b) = Fork (signum a) (signum b)
275269
276270instance Ord e => Ord (Matrix e cols rows) where
271+ Empty <= Empty = True
277272 (One a) <= (One b) = a <= b
278273 (Join a b) <= (Join c d) = (a <= c) && (b <= d)
279274 (Fork a b) <= (Fork c d) = (a <= c) && (b <= d)
@@ -282,6 +277,10 @@ instance Ord e => Ord (Matrix e cols rows) where
282277
283278-- Primitives
284279
280+-- | Empty matrix constructor
281+empty :: Matrix e Void Void
282+empty = Empty
283+
285284-- | Unit matrix constructor
286285one :: e -> Matrix e () ()
287286one = One
@@ -312,39 +311,40 @@ infixl 2 ===
312311--
313312-- Given that it is not possible to branch on types at the term level type
314313-- classes are needed very much like an inductive definition but on types.
315−class FromLists cols rows where
314+class FromLists e cols rows where
316315 -- | Build a matrix out of a list of list of elements. Throws a runtime
317316 -- error if the dimensions do not match.
318317 fromLists :: [[e]] -> Matrix e cols rows
319318
320−instance FromLists () () where
319+instance FromLists e Void Void where
320+ fromLists [] = Empty
321+ fromLists _ = error "Wrong dimensions"
322+
323+instance {-# OVERLAPPING #-} FromLists e () () where
321324 fromLists [[e]] = One e
322325 fromLists _ = error "Wrong dimensions"
323326
324−instance (FromLists cols ()) => FromLists (Either () cols) () where
327+instance {-# OVERLAPPING #-} (FromLists e cols ()) => FromLists e (Either () cols) () where
325328 fromLists [h : t] = Join (One h) (fromLists [t])
326329 fromLists _ = error "Wrong dimensions"
327330
328−instance {-# OVERLAPPABLE #-}
329− (FromLists a (), FromLists b (), Countable a) => FromLists (Either a b) () where
331+instance {-# OVERLAPPABLE #-} (FromLists e a (), FromLists e b (), Countable a) => FromLists e (Either a b) () where
330332 fromLists [l] =
331333 let rowsA = fromInteger (natVal (Proxy :: Proxy (Count a)))
332334 in Join (fromLists [take rowsA l]) (fromLists [drop rowsA l])
333335 fromLists _ = error "Wrong dimensions"
334336
335−instance (FromLists () rows) => FromLists () (Either () rows) where
337+instance {-# OVERLAPPING #-} (FromLists e () rows) => FromLists e () (Either () rows) where
336338 fromLists ([h] : t) = Fork (One h) (fromLists t)
337339 fromLists _ = error "Wrong dimensions"
338340
339−instance {-# OVERLAPPABLE #-}
340− (FromLists () a, FromLists () b, Countable a) => FromLists () (Either a b) where
341− fromLists l@([_] : _) =
341+instance {-# OVERLAPPABLE #-} (FromLists e () a, FromLists e () b, Countable a) => FromLists e () (Either a b) where
342+ fromLists l@([_] : _) =
342343 let rowsA = fromInteger (natVal (Proxy :: Proxy (Count a)))
343344 in Fork (fromLists (take rowsA l)) (fromLists (drop rowsA l))
344345 fromLists _ = error "Wrong dimensions"
345346
346−instance (FromLists (Either a b) c, FromLists (Either a b) d, Countable c)
347− => FromLists (Either a b) (Either c d) where
347+instance {-# OVERLAPPABLE #-} (FromLists e (Either a b) c, FromLists e (Either a b) d, Countable c) => FromLists e (Either a b) (Either c d) where
348348 fromLists l@(h : t) =
349349 let lh = length h
350350 rowsC = fromInteger (natVal (Proxy :: Proxy (Count c)))
@@ -354,44 +354,24 @@ instance (FromLists (Either a b) c, FromLists (Either a b) d, Countable c)
354354 else error "Not all rows have the same length"
355355
356356-- | Matrix builder function. Constructs a matrix provided with
357−-- a construction function that operates with indices.
358−matrixBuilder' ::
357+-- a construction function.
358+matrixBuilder ::
359359 forall e cols rows.
360− ( FL cols rows,
361− CountableDims cols rows
360+ ( FromLists e cols rows,
361+ CountableDimensions cols rows
362362 ) => ((Int, Int) -> e) -> Matrix e cols rows
363−matrixBuilder' f =
363+matrixBuilder f =
364364 let c = fromInteger $ natVal (Proxy :: Proxy (Count cols))
365365 r = fromInteger $ natVal (Proxy :: Proxy (Count rows))
366366 positions = [(a, b) | a <- [0 .. (r - 1)], b <- [0 .. (c - 1)]]
367367 in fromLists . map (map f) . groupBy (\(x, _) (w, _) -> x == w) $ positions
368368
369−-- | Matrix builder function. Constructs a matrix provided with
370−-- a construction function that operates with arbitrary types.
371−matrixBuilder ::
372− forall e a b.
373− ( FLN a b,
374− Enum a,
375− Enum b,
376− Bounded a,
377− Bounded b,
378− Eq a,
379− Countable b
380− ) => ((a, b) -> e) -> Matrix e (Normalize a) (Normalize b)
381−matrixBuilder f =
382− let r = fromInteger $ natVal (Proxy :: Proxy (Count b))
383− positions = [(a, b) | a <- [minBound .. maxBound], b <- [minBound .. maxBound]]
384− in fromLists . map (map f) . transpose . buildList r $ positions
385− where
386− buildList _ [] = []
387− buildList r l = take r l : buildList r (drop r l)
388−
389369-- | Constructs a column vector matrix
390−col :: (FL () rows) => [e] -> Matrix e () rows
370+col :: (FromLists e () rows) => [e] -> Matrix e () rows
391371col = fromLists . map (: [])
392372
393373-- | Constructs a row vector matrix
394−row :: (FL cols ()) => [e] -> Matrix e cols ()
374+row :: (FromLists e cols ()) => [e] -> Matrix e cols ()
395375row = fromLists . (: [])
396376
397377-- | Lifts functions to matrices with arbitrary dimensions.
@@ -401,8 +381,8 @@ row = fromLists . (: [])
401381fromF' ::
402382 forall a b cols rows e.
403383 ( Liftable e a b,
404− CountableDims cols rows,
405− FL rows cols
384+ CountableDimensions cols rows,
385+ FromLists e rows cols
406386 ) =>
407387 (a -> b) ->
408388 Matrix e cols rows
@@ -430,17 +410,35 @@ fromF' f =
430410fromF ::
431411 forall a b e.
432412 ( Liftable e a b,
433− CountableDimsN a b,
434− FLN b a
413+ CountableDimensionsN a b,
414+ FromListsN e b a
435415 ) =>
436416 (a -> b) ->
437417 Matrix e (Normalize a) (Normalize b)
438−fromF = fromF'
418+fromF f =
419+ let minA = minBound @a
420+ maxA = maxBound @a
421+ minB = minBound @b
422+ maxB = maxBound @b
423+ ccols = fromInteger $ natVal (Proxy :: Proxy (Count (Normalize a)))
424+ rrows = fromInteger $ natVal (Proxy :: Proxy (Count (Normalize b)))
425+ elementsA = take ccols [minA .. maxA]
426+ elementsB = take rrows [minB .. maxB]
427+ combinations = (,) <$> elementsA <*> elementsB
428+ combAp = map snd . sort . map (\(a, b) -> if f a == b
429+ then ((fromEnum a, fromEnum b), 1)
430+ else ((fromEnum a, fromEnum b), 0)) $ combinations
431+ mList = buildList combAp rrows
432+ in tr $ fromLists mList
433+ where
434+ buildList [] _ = []
435+ buildList l r = take r l : buildList (drop r l) r
439436
440437-- Conversion
441438
442439-- | Converts a matrix to a list of lists of elements.
443440toLists :: Matrix e cols rows -> [[e]]
441+toLists Empty = []
444442toLists (One e) = [[e]]
445443toLists (Fork l r) = toLists l ++ toLists r
446444toLists (Join l r) = zipWith (++) (toLists l) (toLists r)
@@ -452,28 +450,28 @@ toList = concat . toLists
452450-- Zeros Matrix
453451
454452-- | The zero matrix. A matrix wholly filled with zeros.
455−zeros :: (Num e, FL cols rows, CountableDims cols rows) => Matrix e cols rows
456−zeros = matrixBuilder' (const 0)
453+zeros :: (Num e, FromLists e cols rows, CountableDimensions cols rows) => Matrix e cols rows
454+zeros = matrixBuilder (const 0)
457455
458456-- Ones Matrix
459457
460458-- | The ones matrix. A matrix wholly filled with ones.
461459--
462460-- Also known as T (Top) matrix.
463−ones :: (Num e, FL cols rows, CountableDims cols rows) => Matrix e cols rows
464−ones = matrixBuilder' (const 1)
461+ones :: (Num e, FromLists e cols rows, CountableDimensions cols rows) => Matrix e cols rows
462+ones = matrixBuilder (const 1)
465463
466464-- Const Matrix
467465
468466-- | The constant matrix constructor. A matrix wholly filled with a given
469467-- value.
470−constant :: (Num e, FL cols rows, CountableDims cols rows) => e -> Matrix e cols rows
471−constant e = matrixBuilder' (const e)
468+constant :: (Num e, FromLists e cols rows, CountableDimensions cols rows) => e -> Matrix e cols rows
469+constant e = matrixBuilder (const e)
472470
473471-- Bang Matrix
474472
475473-- | The T (Top) row vector matrix.
476−bang :: forall e cols. (Num e, Enum e, FL cols (), Countable cols) => Matrix e cols ()
474+bang :: forall e cols. (Num e, Enum e, FromLists e cols (), Countable cols) => Matrix e cols ()
477475bang =
478476 let c = fromInteger $ natVal (Proxy :: Proxy (Count cols))
479477 in fromLists [take c [1, 1 ..]]
@@ -481,8 +479,8 @@ bang =
481479-- iden Matrix
482480
483481-- | iden matrix.
484−iden :: forall e cols . (Num e, FL cols cols, Countable cols) => Matrix e cols cols
485−iden = matrixBuilder' (bool 0 1 . uncurry (==))
482+iden :: (Num e, FromLists e cols cols, Countable cols) => Matrix e cols cols
483+iden = matrixBuilder (bool 0 1 . uncurry (==))
486484{-# NOINLINE iden #-}
487485
488486-- Matrix composition (MMM)
@@ -492,12 +490,13 @@ iden = matrixBuilder' (bool 0 1 . uncurry (==))
492490-- This definition takes advantage of divide-and-conquer and fusion laws
493491-- from LAoP.
494492comp :: (Num e) => Matrix e cr rows -> Matrix e cols cr -> Matrix e cols rows
493+comp Empty Empty = Empty
495494comp (One a) (One b) = One (a * b)
496495comp (Join a b) (Fork c d) = comp a c + comp b d -- Divide-and-conquer law
497496comp (Fork a b) c = Fork (comp a c) (comp b c) -- Fork fusion law
498497comp c (Join a b) = Join (comp c a) (comp c b) -- Join fusion law
499498{-# NOINLINE comp #-}
500−{-# RULES
499+{-# RULES
501500 "comp/iden1" forall m. comp m iden = m ;
502501 "comp/iden2" forall m. comp iden m = m
503502#-}
@@ -507,6 +506,7 @@ comp c (Join a b) = Join (comp c a) (comp c b) -- Join fusion law
507506infixl 7 .|
508507-- | Scalar multiplication of matrices.
509508(.|) :: Num e => e -> Matrix e cols rows -> Matrix e cols rows
509+(.|) _ Empty = Empty
510510(.|) e (One a) = One (e * a)
511511(.|) e (Join a b) = Join (e .| a) (e .| b)
512512(.|) e (Fork a b) = Fork (e .| a) (e .| b)
@@ -516,6 +516,7 @@ infixl 7 .|
516516infixl 7 ./
517517-- | Scalar multiplication of matrices.
518518(./) :: Fractional e => Matrix e cols rows -> e -> Matrix e cols rows
519+(./) Empty _ = Empty
519520(./) (One a) e = One (a / e)
520521(./) (Join a b) e = Join (a ./ e) (b ./ e)
521522(./) (Fork a b) e = Fork (a ./ e) (b ./ e)
@@ -523,59 +524,45 @@ infixl 7 ./
523524-- Projections
524525
525526-- | Biproduct first component projection
526−p1 :: (Num e, CountableDims n m, FL n m, FL m m) => Matrix e (Either m n) m
527−p1 = join id zeros
527+p1 :: (Num e, CountableDimensions n m, FromLists e n m, FromLists e m m) => Matrix e (Either m n) m
528+p1 = join iden zeros
528529
529530-- | Biproduct second component projection
530−p2 :: (Num e, CountableDims n m, FL m n, FL n n) => Matrix e (Either m n) n
531−p2 = join zeros id
531+p2 :: (Num e, CountableDimensions n m, FromLists e m n, FromLists e n n) => Matrix e (Either m n) n
532+p2 = join zeros iden
532533
533534-- Injections
534535
535536-- | Biproduct first component injection
536−i1 :: (Num e, CountableDims n m, FL n m, FL m m) => Matrix e m (Either m n)
537+i1 :: (Num e, CountableDimensions n m, FromLists e n m, FromLists e m m) => Matrix e m (Either m n)
537538i1 = tr p1
538539
539540-- | Biproduct second component injection
540−i2 :: (Num e, CountableDims n m, FL m n, FL n n) => Matrix e n (Either m n)
541+i2 :: (Num e, CountableDimensions n m, FromLists e m n, FromLists e n n) => Matrix e n (Either m n)
541542i2 = tr p2
542543
543544-- Dimensions
544545
545546-- | Obtain the number of rows.
546547--
547−-- NOTE: The 'KnownNat' constraint is needed in order to obtain the
548−-- dimensions in constant time. For a version that doesn't require the
549−-- constraint see 'rows''.
548+-- NOTE: The 'KnownNat' constaint is needed in order to obtain the
549+-- dimensions in constant time.
550+--
551+-- TODO: A 'rows' function that does not need the 'KnownNat' constraint in
552+-- exchange for performance.
550553rows :: forall e cols rows. (Countable rows) => Matrix e cols rows -> Int
551554rows _ = fromInteger $ natVal (Proxy :: Proxy (Count rows))
552555
553−-- | Obtain the number of rows in an inefficient manner, but without any
554−-- constraints.
555−--
556−-- For a more efficient version see 'rows'.
557−rows' :: Matrix e cols rows -> Int
558−rows' (One _) = 1
559−rows' (Join lhs _) = rows' lhs
560−rows' (Fork top bottom) = rows' top + rows' bottom
561−
562556-- | Obtain the number of columns.
557+--
558+-- NOTE: The 'KnownNat' constaint is needed in order to obtain the
559+-- dimensions in constant time.
563560--
564−-- NOTE: The 'KnownNat' constraint is needed in order to obtain the
565−-- dimensions in constant time. For a version that doesn't require the
566−-- constraint see 'columns''.
561+-- TODO: A 'columns' function that does not need the 'KnownNat' constraint in
562+-- exchange for performance.
567563columns :: forall e cols rows. (Countable cols) => Matrix e cols rows -> Int
568564columns _ = fromInteger $ natVal (Proxy :: Proxy (Count cols))
569565
570−-- | Obtain the number of columns in an inefficient manner, but without any
571−-- constraints.
572−--
573−-- For a more efficient version see 'columns'.
574−columns' :: Matrix e cols rows -> Int
575−columns' (One _) = 1
576−columns' (Join lhs rhs) = columns' lhs + columns' rhs
577−columns' (Fork top _) = columns' top
578−
579566-- Coproduct Bifunctor
580567
581568infixl 5 -|-
@@ -584,11 +571,11 @@ infixl 5 -|-
584571(-|-) ::
585572 forall e n k m j.
586573 ( Num e,
587− CountableDims j k,
588− FL k k,
589− FL j k,
590− FL k j,
591− FL j j
574+ CountableDimensions j k,
575+ FromLists e k k,
576+ FromLists e j k,
577+ FromLists e k j,
578+ FromLists e j j
592579 ) =>
593580 Matrix e n k ->
594581 Matrix e m j ->
@@ -601,11 +588,11 @@ infixl 5 -|-
601588fstM ::
602589 forall e m k .
603590 ( Num e,
604− CountableDims k m,
605− FL (Normalize (m, k)) m,
591+ CountableDimensions k m,
592+ FromLists e (Normalize (m, k)) m,
606593 CountableN (m, k)
607594 ) => Matrix e (Normalize (m, k)) m
608−fstM = matrixBuilder' f
595+fstM = matrixBuilder f
609596 where
610597 offset = fromInteger (natVal (Proxy :: Proxy (Count k)))
611598 f (x, y)
@@ -616,11 +603,11 @@ fstM = matrixBuilder' f
616603sndM ::
617604 forall e m k .
618605 ( Num e,
619− CountableDims k m,
620− FL (Normalize (m, k)) k,
606+ CountableDimensions k m,
607+ FromLists e (Normalize (m, k)) k,
621608 CountableN (m, k)
622609 ) => Matrix e (Normalize (m, k)) k
623−sndM = matrixBuilder' f
610+sndM = matrixBuilder f
624611 where
625612 offset = fromInteger (natVal (Proxy :: Proxy (Count k)))
626613 f (x, y)
@@ -630,7 +617,7 @@ sndM = matrixBuilder' f
630617-- | Khatri Rao Matrix product also known as matrix pairing.
631618--
632619-- NOTE: That this is not a true categorical product, see for instance:
633−--
620+--
634621-- @
635622-- | fstM . kr a b == a
636623-- kr a b ==> |
@@ -641,10 +628,10 @@ sndM = matrixBuilder' f
641628kr ::
642629 forall e cols a b.
643630 ( Num e,
644− CountableDims a b,
631+ CountableDimensions a b,
645632 CountableN (a, b),
646− FL (Normalize (a, b)) a,
647− FL (Normalize (a, b)) b
633+ FromLists e (Normalize (a, b)) a,
634+ FromLists e (Normalize (a, b)) b
648635 ) => Matrix e cols a -> Matrix e cols b -> Matrix e cols (Normalize (a, b))
649636kr a b =
650637 let fstM' = fstM @e @a @b
@@ -659,14 +646,14 @@ infixl 4 ><
659646(><) ::
660647 forall e m p n q.
661648 ( Num e,
662− CountableDims m n,
663− CountableDims p q,
664− CountableDimsN (m, n) (p, q),
665− FL (Normalize (m, n)) m,
666− FL (Normalize (m, n)) n,
667− FL (Normalize (p, q)) p,
668− FL (Normalize (p, q)) q
669− )
649+ CountableDimensions m n,
650+ CountableDimensions p q,
651+ CountableDimensionsN (m, n) (p, q),
652+ FromLists e (Normalize (m, n)) m,
653+ FromLists e (Normalize (m, n)) n,
654+ FromLists e (Normalize (p, q)) p,
655+ FromLists e (Normalize (p, q)) q
656+ )
670657 => Matrix e m p -> Matrix e n q -> Matrix e (Normalize (m, n)) (Normalize (p, q))
671658(><) a b =
672659 let fstM' = fstM @e @m @n
@@ -684,6 +671,7 @@ infixl 4 ><
684671-- @
685672abideJF :: Matrix e cols rows -> Matrix e cols rows
686673abideJF (Join (Fork a c) (Fork b d)) = Fork (Join (abideJF a) (abideJF b)) (Join (abideJF c) (abideJF d)) -- Join-Fork abide law
674+abideJF Empty = Empty
687675abideJF (One e) = One e
688676abideJF (Join a b) = Join (abideJF a) (abideJF b)
689677abideJF (Fork a b) = Fork (abideJF a) (abideJF b)
@@ -697,6 +685,7 @@ abideJF (Fork a b) = Fork (abideJF a) (abideJF b)
697685-- @
698686abideFJ :: Matrix e cols rows -> Matrix e cols rows
699687abideFJ (Fork (Join a b) (Join c d)) = Join (Fork (abideFJ a) (abideFJ c)) (Fork (abideFJ b) (abideFJ d)) -- Fork-Join abide law
688+abideFJ Empty = Empty
700689abideFJ (One e) = One e
701690abideFJ (Join a b) = Join (abideFJ a) (abideFJ b)
702691abideFJ (Fork a b) = Fork (abideFJ a) (abideFJ b)
@@ -705,6 +694,7 @@ abideFJ (Fork a b) = Fork (abideFJ a) (abideFJ b)
705694
706695-- | Matrix transposition.
707696tr :: Matrix e cols rows -> Matrix e rows cols
697+tr Empty = Empty
708698tr (One e) = One e
709699tr (Join a b) = Fork (tr a) (tr b)
710700tr (Fork a b) = Join (tr a) (tr b)
@@ -713,32 +703,32 @@ tr (Fork a b) = Join (tr a) (tr b)
713703
714704-- | Selective functors 'select' operator equivalent inspired by the
715705-- ArrowMonad solution presented in the paper.
716−select :: (Num e, FL b b, Countable b) => Matrix e cols (Either a b) -> Matrix e a b -> Matrix e cols b
706+select :: (Num e, FromLists e b b, Countable b) => Matrix e cols (Either a b) -> Matrix e a b -> Matrix e cols b
717707select (Fork a b) y = y . a + b -- Divide-and-conquer law
718708select (Join (Fork a c) (Fork b d)) y = join (y . a + c) (y . b + d) -- Pattern matching + DnC law
719−select m y = join y id . m
709+select m y = join y iden . m
720710
721711branch ::
722712 ( Num e,
723− CountableDims a b,
724− CountableDims c (Either b c),
725− FL c b,
726− FL a b,
727− FL a a,
728− FL b b,
729− FL c c,
730− FL b a,
731− FL b c,
732− FL (Either b c) b,
733− FL (Either b c) c
713+ CountableDimensions a b,
714+ CountableDimensions c (Either b c),
715+ FromLists e c b,
716+ FromLists e a b,
717+ FromLists e a a,
718+ FromLists e b b,
719+ FromLists e c c,
720+ FromLists e b a,
721+ FromLists e b c,
722+ FromLists e (Either b c) b,
723+ FromLists e (Either b c) c
734724 )
735725 => Matrix e cols (Either a b) -> Matrix e a c -> Matrix e b c -> Matrix e cols c
736726branch x l r = f x `select` g l `select` r
737727 where
738− f :: (Num e, Countable a, CountableDims b c, FL a b, FL c b, FL b b, FL b a, FL a a)
728+ f :: (Num e, Countable a, CountableDimensions b c, FromLists e a b, FromLists e c b, FromLists e b b, FromLists e b a, FromLists e a a)
739729 => Matrix e cols (Either a b) -> Matrix e cols (Either a (Either b c))
740730 f m = fork (tr i1) (i1 . tr i2) . m
741− g :: (Num e, CountableDims b c, FL b c, FL c c) => Matrix e a c -> Matrix e a (Either b c)
731+ g :: (Num e, CountableDimensions b c, FromLists e b c, FromLists e c c) => Matrix e a c -> Matrix e a (Either b c)
742732 g m = i2 . m
743733
744734-- McCarthy's Conditional
@@ -747,9 +737,9 @@ branch x l r = f x `select` g l `select` r
747737cond ::
748738 ( Trivial cols,
749739 Countable cols,
750− FL () cols,
751− FL cols (),
752− FL cols cols,
740+ FromLists e () cols,
741+ FromLists e cols (),
742+ FromLists e cols cols,
753743 Bounded a,
754744 Enum a,
755745 Num e,
@@ -762,9 +752,9 @@ cond p f g = join f g . grd p
762752grd ::
763753 ( Trivial q,
764754 Countable q,
765− FL () q,
766− FL q (),
767− FL q q,
755+ FromLists e () q,
756+ FromLists e q (),
757+ FromLists e q q,
768758 Bounded a,
769759 Enum a,
770760 Num e,
@@ -778,14 +768,14 @@ corr ::
778768 forall e a q .
779769 ( Trivial q,
780770 Countable q,
781− FL () q,
782− FL q (),
783− FL q q,
771+ FromLists e () q,
772+ FromLists e q (),
773+ FromLists e q q,
784774 Liftable e a Bool
785775 )
786776 => (a -> Bool) -> Matrix e q q
787777corr p = let f = fromF' p :: Matrix e q ()
788− in kr f (id :: Matrix e q q)
778+ in kr f (iden :: Matrix e q q)
789779
790780-- Pretty print
791781
@@ -809,7 +799,7 @@ prettyAux (h : t) l = "│ " ++ fill (unwords $ map show h) ++ " │\n" ++
809799 fill str = replicate (widest - length str - 2) ' ' ++ str
810800
811801-- | Matrix pretty printer
812−pretty :: (CountableDims cols rows, Show e) => Matrix e cols rows -> String
802+pretty :: (CountableDimensions cols rows, Show e) => Matrix e cols rows -> String
813803pretty m = concat
814804 [ "┌ ", unwords (replicate (columns m) blank), " ┐\n"
815805 , unlines
@@ -838,11 +828,12 @@ pretty m = concat
838828 (safeGet i j m)
839829
840830-- | Matrix pretty printer
841−prettyPrint :: (CountableDims cols rows, Show e) => Matrix e cols rows -> IO ()
831+prettyPrint :: (CountableDimensions cols rows, Show e) => Matrix e cols rows -> IO ()
842832prettyPrint = putStrLn . pretty
843833
844834-- | Zip two matrices with a given binary function
845835zipWithM :: (e -> f -> g) -> Matrix e cols rows -> Matrix f cols rows -> Matrix g cols rows
836+zipWithM _ Empty Empty = Empty
846837zipWithM f (One a) (One b) = One (f a b)
847838zipWithM f (Join a b) (Join c d) = Join (zipWithM f a c) (zipWithM f b d)
848839zipWithM f (Fork a b) (Fork c d) = Fork (zipWithM f a c) (zipWithM f b d)
@@ -867,12 +858,14 @@ fromBool False = nat 0
867858
868859-- | Relational negation
869860negateM :: Relation cols rows -> Relation cols rows
861+negateM Empty = Empty
870862negateM (One (Nat p)) = One (Nat (negate p))
871863negateM (Join a b) = Join (negateM a) (negateM b)
872864negateM (Fork a b) = Fork (negateM a) (negateM b)
873865
874866-- | Relational addition
875867orM :: Relation cols rows -> Relation cols rows -> Relation cols rows
868+orM Empty Empty = Empty
876869orM (One a) (One b) = One (fromBool (toBool a || toBool b))
877870orM (Join a b) (Join c d) = Join (orM a c) (orM b d)
878871orM (Fork a b) (Fork c d) = Fork (orM a c) (orM b d)
@@ -881,6 +874,7 @@ orM x@(Join _ _) y@(Fork _ _) = orM (abideJF x) y
881874
882875-- | Relational multiplication
883876andM :: Relation cols rows -> Relation cols rows -> Relation cols rows
877+andM Empty Empty = Empty
884878andM (One a) (One b) = One (fromBool (toBool a && toBool b))
885879andM (Join a b) (Join c d) = Join (andM a c) (andM b d)
886880andM (Fork a b) (Fork c d) = Fork (andM a c) (andM b d)
@@ -889,6 +883,7 @@ andM x@(Join _ _) y@(Fork _ _) = andM (abideJF x) y
889883
890884-- | Relational subtraction
891885subM :: Relation cols rows -> Relation cols rows -> Relation cols rows
886+subM Empty Empty = Empty
892887subM (One a) (One b) = if a - b < nat 0 then One (nat 0) else One (a - b)
893888subM (Join a b) (Join c d) = Join (subM a c) (subM b d)
894889subM (Fork a b) (Fork c d) = Fork (subM a c) (subM b d)
@@ -897,6 +892,7 @@ subM x@(Join _ _) y@(Fork _ _) = subM (abideJF x) y
897892
898893-- | Matrix relational composition.
899894compRel :: Relation cr rows -> Relation cols cr -> Relation cols rows
895+compRel Empty Empty = Empty
900896compRel (One a) (One b) = One (fromBool (toBool a && toBool b))
901897compRel (Join a b) (Fork c d) = orM (compRel a c) (compRel b d) -- Divide-and-conquer law
902898compRel (Fork a b) c = Fork (compRel a c) (compRel b c) -- Fork fusion law
@@ -904,6 +900,7 @@ compRel c (Join a b) = Join (compRel c a) (compRel c b) -- Join fusion
904900
905901-- | Matrix relational right division
906902divR :: Relation b c -> Relation b a -> Relation a c
903+divR Empty Empty = Empty
907904divR (One a) (One b) = One (fromBool (not (toBool b) || toBool a)) -- b implies a
908905divR (Join a b) (Join c d) = andM (divR a c) (divR b d)
909906divR (Fork a b) c = Fork (divR a c) (divR b c)
@@ -926,24 +923,58 @@ divS s r = divL r s `intersection` divR (tr r) (tr s)
926923fromFRel' ::
927924 forall a b cols rows.
928925 ( Liftable Boolean a b,
929− CountableDims cols rows,
930− FL rows cols
926+ CountableDimensions cols rows,
927+ FromLists Boolean rows cols
931928 ) =>
932929 (a -> b) ->
933930 Relation cols rows
934−fromFRel' = fromF'
931+fromFRel' f =
932+ let minA = minBound @a
933+ maxA = maxBound @a
934+ minB = minBound @b
935+ maxB = maxBound @b
936+ ccols = fromInteger $ natVal (Proxy :: Proxy (Count cols))
937+ rrows = fromInteger $ natVal (Proxy :: Proxy (Count rows))
938+ elementsA = take ccols [minA .. maxA]
939+ elementsB = take rrows [minB .. maxB]
940+ combinations = (,) <$> elementsA <*> elementsB
941+ combAp = map snd . sort . map (\(a, b) -> if f a == b
942+ then ((fromEnum a, fromEnum b), nat 1)
943+ else ((fromEnum a, fromEnum b), nat 0)) $ combinations
944+ mList = buildList combAp rrows
945+ in tr $ fromLists mList
946+ where
947+ buildList [] _ = []
948+ buildList l r = take r l : buildList (drop r l) r
935949
936950-- | Lifts functions to relations with dimensions matching @a@ and @b@
937951-- cardinality's.
938952fromFRel ::
939953 forall a b.
940954 ( Liftable Boolean a b,
941− CountableDimsN a b,
942− FLN b a
955+ CountableDimensionsN a b,
956+ FromLists Boolean (Normalize b) (Normalize a)
943957 ) =>
944958 (a -> b) ->
945959 Relation (Normalize a) (Normalize b)
946−fromFRel = fromFRel'
960+fromFRel f =
961+ let minA = minBound @a
962+ maxA = maxBound @a
963+ minB = minBound @b
964+ maxB = maxBound @b
965+ ccols = fromInteger $ natVal (Proxy :: Proxy (Count (Normalize a)))
966+ rrows = fromInteger $ natVal (Proxy :: Proxy (Count (Normalize b)))
967+ elementsA = take ccols [minA .. maxA]
968+ elementsB = take rrows [minB .. maxB]
969+ combinations = (,) <$> elementsA <*> elementsB
970+ combAp = map snd . sort . map (\(a, b) -> if f a == b
971+ then ((fromEnum a, fromEnum b), nat 1)
972+ else ((fromEnum a, fromEnum b), nat 0)) $ combinations
973+ mList = buildList combAp rrows
974+ in tr $ fromLists mList
975+ where
976+ buildList [] _ = []
977+ buildList l r = take r l : buildList (drop r l) r
947978
948979-- | Lifts a relation function to a Boolean Matrix
949980toRel ::
@@ -953,17 +984,17 @@ toRel ::
953984 Enum a,
954985 Enum b,
955986 Eq b,
956− CountableDims a b,
957− FLN b a
958− )
987+ CountableDimensionsN a b,
988+ FromListsN Boolean b a
989+ )
959990 => (a -> b -> Bool) -> Relation (Normalize a) (Normalize b)
960991toRel f =
961992 let minA = minBound @a
962993 maxA = maxBound @a
963994 minB = minBound @b
964995 maxB = maxBound @b
965− ccols = fromInteger $ natVal (Proxy :: Proxy (Count a))
966− rrows = fromInteger $ natVal (Proxy :: Proxy (Count b))
996+ ccols = fromInteger $ natVal (Proxy :: Proxy (Count (Normalize a)))
997+ rrows = fromInteger $ natVal (Proxy :: Proxy (Count (Normalize b)))
967998 elementsA = take ccols [minA .. maxA]
968999 elementsB = take rrows [minB .. maxB]
9691000 combinations = (,) <$> elementsA <*> elementsB
src/LAoP/Matrix/Nat.hs+80−68
@@ -56,17 +56,18 @@ module LAoP.Matrix.Nat
5656
5757 -- * Constraint type synonyms
5858 Countable,
59− CountableDims,
59+ CountableDimensions,
6060 CountableN,
6161 CountableNz,
62− CountableDimsN,
63− FLN,
64− FLNz,
62+ CountableDimensionsN,
63+ FromListsN,
64+ FromListsNz,
6565 Liftable,
6666 TrivialE,
6767 TrivialP,
6868
6969 -- * Primitives
70+ empty,
7071 one,
7172 join,
7273 fork,
@@ -77,11 +78,11 @@ module LAoP.Matrix.Nat
7778 I.Normalize,
7879
7980 -- * Matrix construction and conversion
80− I.FL,
81+ I.FromLists,
8182 fromLists,
8283 toLists,
8384 toList,
84− matrixBuilder',
85+ matrixBuilder,
8586 row,
8687 col,
8788 zeros,
@@ -160,25 +161,38 @@ where
160161import Data.Proxy
161162import GHC.TypeLits
162163import Control.DeepSeq
164+import qualified Control.Category as C
163165import qualified LAoP.Matrix.Internal as I
164166
165167newtype Matrix e (cols :: Nat) (rows :: Nat) = M (I.Matrix e (I.FromNat cols) (I.FromNat rows))
166168 deriving (Show, Num, Eq, Ord, NFData) via (I.Matrix e (I.FromNat cols) (I.FromNat rows))
167169
168170-- | Constraint type synonyms to keep the type signatures less convoluted
169−type Countable a = KnownNat (I.Count a)
170−type CountableDims a b = (Countable a, Countable b)
171−type CountableN a = KnownNat (I.Count (I.FromNat a))
172−type CountableNz a = KnownNat (I.Count (I.Normalize a))
173−type CountableDimsN a b = (CountableN a, CountableN b)
174−type FLN e a b = I.FL (I.FromNat a) (I.FromNat b)
175−type FLNz e a b = I.FL (I.Normalize a) (I.Normalize b)
176−type Liftable e a b = (Bounded a, Bounded b, Enum a, Enum b, Eq b, Num e, Ord e)
177−type TrivialE a b = I.FromNat (a + b) ~ Either (I.FromNat a) (I.FromNat b)
178−type TrivialP a b = I.FromNat (a * b) ~ I.FromNat (I.Count (I.FromNat a) * I.Count (I.FromNat b))
171+type Countable a = KnownNat (I.Count a)
172+type CountableDimensions a b = (Countable a, Countable b)
173+type CountableN a = KnownNat (I.Count (I.FromNat a))
174+type CountableNz a = KnownNat (I.Count (I.Normalize a))
175+type CountableDimensionsN a b = (CountableN a, CountableN b)
176+type FromListsN e a b = I.FromLists e (I.FromNat a) (I.FromNat b)
177+type FromListsNz e a b = I.FromLists e (I.Normalize a) (I.Normalize b)
178+type Liftable e a b = (Bounded a, Bounded b, Enum a, Enum b, Eq b, Num e, Ord e)
179+type TrivialE a b = I.FromNat (a + b) ~ Either (I.FromNat a) (I.FromNat b)
180+type TrivialP a b = I.FromNat (a * b) ~ I.FromNat (I.Count (I.FromNat a) * I.Count (I.FromNat b))
181+
182+-- | It isn't possible to implement the 'id' function so it's
183+-- implementation is 'undefined'. However 'comp' can be and this partial
184+-- class implementation exists just to make the code more readable.
185+--
186+-- Please use 'iden' instead.
187+instance (Num e) => C.Category (Matrix e) where
188+ id = undefined
189+ (.) = comp
179190
180191-- Primitives
181192
193+empty :: Matrix e 0 0
194+empty = M I.Empty
195+
182196one :: e -> Matrix e 1 1
183197one = M . I.One
184198
@@ -214,27 +228,25 @@ infixl 2 ===
214228
215229-- Construction
216230
217−fromLists :: (FLN e cols rows) => [[e]] -> Matrix e cols rows
231+fromLists :: (FromListsN e cols rows) => [[e]] -> Matrix e cols rows
218232fromLists = M . I.fromLists
219233
220−-- | Matrix builder function. Constructs a matrix provided with
221−-- a construction function that operates with indices.
222−matrixBuilder' ::
223− (FLN e cols rows, CountableN cols, CountableN rows)
234+matrixBuilder ::
235+ (FromListsN e cols rows, CountableN cols, CountableN rows)
224236 => ((Int, Int) -> e) -> Matrix e cols rows
225−matrixBuilder' = M . I.matrixBuilder'
237+matrixBuilder = M . I.matrixBuilder
226238
227−col :: (I.FL () (I.FromNat rows)) => [e] -> Matrix e 1 rows
239+col :: (I.FromLists e () (I.FromNat rows)) => [e] -> Matrix e 1 rows
228240col = M . I.col
229241
230−row :: (I.FL (I.FromNat cols) ()) => [e] -> Matrix e cols 1
242+row :: (I.FromLists e (I.FromNat cols) ()) => [e] -> Matrix e cols 1
231243row = M . I.row
232244
233245fromF' ::
234246 ( Liftable e a b,
235247 CountableN cols,
236248 CountableN rows,
237− FLN e rows cols
249+ FromListsN e rows cols
238250 ) =>
239251 (a -> b) ->
240252 Matrix e cols rows
@@ -244,7 +256,7 @@ fromF ::
244256 ( Liftable e a b,
245257 CountableNz a,
246258 CountableNz b,
247− FLNz e b a
259+ FromListsNz e b a
248260 ) =>
249261 (a -> b) ->
250262 Matrix e (I.Count a) (I.Count b)
@@ -261,21 +273,21 @@ toList (M m) = I.toList m
261273-- Zeros Matrix
262274
263275zeros ::
264− (Num e, FLN e cols rows, CountableN cols, CountableN rows) =>
276+ (Num e, FromListsN e cols rows, CountableN cols, CountableN rows) =>
265277 Matrix e cols rows
266278zeros = M I.zeros
267279
268280-- Ones Matrix
269281
270282ones ::
271− (Num e, FLN e cols rows, CountableN cols, CountableN rows) =>
283+ (Num e, FromListsN e cols rows, CountableN cols, CountableN rows) =>
272284 Matrix e cols rows
273285ones = M I.ones
274286
275287-- Const Matrix
276288
277289constant ::
278− (Num e, FLN e cols rows, CountableN cols, CountableN rows) =>
290+ (Num e, FromListsN e cols rows, CountableN cols, CountableN rows) =>
279291 e ->
280292 Matrix e cols rows
281293constant = M . I.constant
@@ -284,14 +296,14 @@ constant = M . I.constant
284296
285297bang ::
286298 forall e cols.
287− (Num e, Enum e, I.FL (I.FromNat cols) (), CountableN cols) =>
299+ (Num e, Enum e, I.FromLists e (I.FromNat cols) (), CountableN cols) =>
288300 Matrix e cols 1
289301bang = M I.bang
290302
291303-- iden Matrix
292304
293305iden ::
294− (Num e, FLN e cols cols, CountableN cols) =>
306+ (Num e, FromListsN e cols cols, CountableN cols) =>
295307 Matrix e cols cols
296308iden = M I.iden
297309
@@ -316,9 +328,9 @@ infixl 7 ./
316328
317329p1 ::
318330 ( Num e,
319− CountableDimsN n m,
320− FLN e n m,
321− FLN e m m,
331+ CountableDimensionsN n m,
332+ FromListsN e n m,
333+ FromListsN e m m,
322334 TrivialE m n
323335 ) =>
324336 Matrix e (m + n) m
@@ -326,9 +338,9 @@ p1 = M I.p1
326338
327339p2 ::
328340 ( Num e,
329− CountableDimsN n m,
330− FLN e m n,
331− FLN e n n,
341+ CountableDimensionsN n m,
342+ FromListsN e m n,
343+ FromListsN e n n,
332344 TrivialE m n
333345 ) =>
334346 Matrix e (m + n) n
@@ -338,9 +350,9 @@ p2 = M I.p2
338350
339351i1 ::
340352 ( Num e,
341− CountableDimsN n rows,
342− FLN e n rows,
343− FLN e rows rows,
353+ CountableDimensionsN n rows,
354+ FromListsN e n rows,
355+ FromListsN e rows rows,
344356 TrivialE rows n
345357 ) =>
346358 Matrix e rows (rows + n)
@@ -348,9 +360,9 @@ i1 = tr p1
348360
349361i2 ::
350362 ( Num e,
351− CountableDimsN rows m,
352− FLN e m rows,
353− FLN e rows rows,
363+ CountableDimensionsN rows m,
364+ FromListsN e m rows,
365+ FromListsN e rows rows,
354366 TrivialE m rows
355367 ) =>
356368 Matrix e rows (m + rows)
@@ -369,11 +381,11 @@ infixl 5 -|-
369381-- | Coproduct Bifunctor (Direct sum)
370382(-|-) ::
371383 ( Num e,
372− CountableDimsN j k,
373− FLN e k k,
374− FLN e j k,
375− FLN e k j,
376− FLN e j j,
384+ CountableDimensionsN j k,
385+ FromListsN e k k,
386+ FromListsN e j k,
387+ FromListsN e k j,
388+ FromListsN e j j,
377389 TrivialE n m,
378390 TrivialE k j
379391 ) =>
@@ -386,9 +398,9 @@ infixl 5 -|-
386398fstM ::
387399 forall e m k .
388400 ( Num e,
389− CountableDimsN m k,
401+ CountableDimensionsN m k,
390402 CountableN (m * k),
391− FLN e (m * k) m,
403+ FromListsN e (m * k) m,
392404 TrivialP m k
393405 ) => Matrix e (m * k) m
394406fstM = M (I.fstM @e @(I.FromNat m) @(I.FromNat k))
@@ -397,8 +409,8 @@ fstM = M (I.fstM @e @(I.FromNat m) @(I.FromNat k))
397409sndM ::
398410 forall e m k.
399411 ( Num e,
400− CountableDimsN k m,
401− FLN e (m * k) k,
412+ CountableDimensionsN k m,
413+ FromListsN e (m * k) k,
402414 CountableN (m * k),
403415 TrivialP m k
404416 ) => Matrix e (m * k) k
@@ -408,10 +420,10 @@ sndM = M (I.sndM @e @(I.FromNat m) @(I.FromNat k))
408420kr ::
409421 forall e cols a b.
410422 ( Num e,
411− CountableDimsN a b,
423+ CountableDimensionsN a b,
412424 CountableN (a * b),
413− FLN e (a * b) a,
414− FLN e (a * b) b,
425+ FromListsN e (a * b) a,
426+ FromListsN e (a * b) b,
415427 TrivialP a b
416428 ) => Matrix e cols a -> Matrix e cols b -> Matrix e cols (a * b)
417429kr a b =
@@ -425,13 +437,13 @@ infixl 4 ><
425437(><) ::
426438 forall e m p n q.
427439 ( Num e,
428− CountableDimsN m n,
429− CountableDimsN p q,
430− CountableDimsN (m * n) (p * q),
431− FLN e (m * n) m,
432− FLN e (m * n) n,
433− FLN e (p * q) p,
434− FLN e (p * q) q,
440+ CountableDimensionsN m n,
441+ CountableDimensionsN p q,
442+ CountableDimensionsN (m * n) (p * q),
443+ FromListsN e (m * n) m,
444+ FromListsN e (m * n) n,
445+ FromListsN e (p * q) p,
446+ FromListsN e (p * q) q,
435447 TrivialP m n,
436448 TrivialP p q
437449 ) => Matrix e m p -> Matrix e n q -> Matrix e (m * n) (p * q)
@@ -455,7 +467,7 @@ tr (M m) = M (I.tr m)
455467-- Selective 'select' operator
456468select ::
457469 ( Num e,
458− FLN e rows1 rows1,
470+ FromListsN e rows1 rows1,
459471 CountableN rows1,
460472 I.FromNat rows2 ~ I.FromNat rows1,
461473 I.FromNat cols1 ~ I.FromNat cols2,
@@ -468,9 +480,9 @@ select (M m) (M y) = M (I.select m y)
468480cond ::
469481 ( I.FromNat (I.Count (I.FromNat cols)) ~ I.FromNat cols,
470482 CountableN cols,
471− I.FL () (I.FromNat cols),
472− I.FL (I.FromNat cols) (),
473− FLN e cols cols,
483+ I.FromLists e () (I.FromNat cols),
484+ I.FromLists e (I.FromNat cols) (),
485+ FromListsN e cols cols,
474486 Liftable e a Bool
475487 )
476488 =>
@@ -479,10 +491,10 @@ cond p (M a) (M b) = M (I.cond p a b)
479491
480492-- Pretty print
481493
482−pretty :: (CountableDimsN cols rows, Show e) => Matrix e cols rows -> String
494+pretty :: (CountableDimensionsN cols rows, Show e) => Matrix e cols rows -> String
483495pretty (M m) = I.pretty m
484496
485−prettyPrint :: (CountableDimsN cols rows, Show e) => Matrix e cols rows -> IO ()
497+prettyPrint :: (CountableDimensionsN cols rows, Show e) => Matrix e cols rows -> IO ()
486498prettyPrint (M m) = I.prettyPrint m
487499
488500-- | Zip two matrices with a given binary function
src/LAoP/Matrix/Type.hs+124−143
@@ -1,11 +1,11 @@
11{-# LANGUAGE ConstraintKinds #-}
2−{-# LANGUAGE TypeFamilies #-}
32{-# LANGUAGE AllowAmbiguousTypes #-}
43{-# LANGUAGE DataKinds #-}
54{-# LANGUAGE DerivingVia #-}
65{-# LANGUAGE FlexibleContexts #-}
76{-# LANGUAGE FlexibleInstances #-}
87{-# LANGUAGE GADTs #-}
8+{-# LANGUAGE KindSignatures #-}
99{-# LANGUAGE MultiParamTypeClasses #-}
1010{-# LANGUAGE NoStarIsType #-}
1111{-# LANGUAGE RankNTypes #-}
@@ -58,10 +58,10 @@ module LAoP.Matrix.Type
5858
5959 -- * Constraint type aliases
6060 Countable,
61− CountableDims,
61+ CountableDimensions,
6262 CountableN,
63− CountableDimsN,
64− FLN,
63+ CountableDimensionsN,
64+ FromListsN,
6565 Liftable,
6666 Trivial,
6767 TrivialP,
@@ -71,6 +71,7 @@ module LAoP.Matrix.Type
7171 One,
7272
7373 -- * Primitives
74+ empty,
7475 one,
7576 join,
7677 fork,
@@ -85,7 +86,6 @@ module LAoP.Matrix.Type
8586 fromLists,
8687 toLists,
8788 toList,
88− matrixBuilder',
8989 matrixBuilder,
9090 row,
9191 col,
@@ -104,8 +104,8 @@ module LAoP.Matrix.Type
104104 multM,
105105
106106 -- * Selective equivalent instance function
107− selectM,
108−
107+ selectM,
108+
109109 -- * Monad equivalent instance function
110110 returnM,
111111 bindM,
@@ -113,9 +113,7 @@ module LAoP.Matrix.Type
113113 -- * Misc
114114 -- ** Get dimensions
115115 columns,
116− columns',
117116 rows,
118− rows',
119117
120118 -- ** Matrix Transposition
121119 tr,
@@ -183,44 +181,46 @@ where
183181import Data.Void
184182import Data.Proxy
185183import Data.Kind
186−import GHC.TypeLits
184+import GHC.TypeLits
187185import Control.DeepSeq
188186import LAoP.Utils
187+import qualified Control.Category as C
189188import qualified LAoP.Matrix.Internal as I
190−import Prelude hiding (id, (.))
191189
192190newtype Matrix e (cols :: Type) (rows :: Type) = M (I.Matrix e (I.Normalize cols) (I.Normalize rows))
193191 deriving (Show, Num, Eq, Ord, NFData) via (I.Matrix e (I.Normalize cols) (I.Normalize rows))
194192
195193-- | Constraint type synonyms to keep the type signatures less convoluted
196−type Countable a = KnownNat (I.Count a)
197−type CountableDims a b = (Countable a, Countable b)
198−type CountableN a = KnownNat (I.Count (I.Normalize a))
199−type CountableDimsN a b = (CountableN a, CountableN b)
200−type FLN a b = I.FromLists (I.Normalize a) (I.Normalize b)
201−type Liftable e a b = (Bounded a, Bounded b, Enum a, Enum b, Eq b, Num e, Ord e)
202−type Trivial a = I.Normalize (I.Normalize a) ~ I.Normalize (I.Normalize (I.Normalize a))
203−type Trivial2 a = I.Normalize a ~ I.Normalize (I.Normalize a)
204−type Trivial3 a = I.FromNat (I.Count (I.Normalize (I.Normalize a))) ~ I.Normalize (I.Normalize a)
205−type TrivialP a b = I.Normalize (a, b) ~ I.Normalize (I.Normalize a, I.Normalize b)
206−
207−-- | It is possible to implement a constrained version of the category type
208−-- class.
209−instance (Num e) => Category (Matrix e) where
210− type Object (Matrix e) a = (FLN a a, CountableN a)
211− id = iden
212− (.) = comp
194+type Countable a = KnownNat (I.Count a)
195+type CountableDimensions a b = (Countable a, Countable b)
196+type CountableN a = KnownNat (I.Count (I.Normalize a))
197+type CountableDimensionsN a b = (CountableN a, CountableN b)
198+type FromListsN e a b = I.FromLists e (I.Normalize a) (I.Normalize b)
199+type Liftable e a b = (Bounded a, Bounded b, Enum a, Enum b, Eq b, Num e, Ord e)
200+type Trivial a = I.Normalize (I.Normalize a) ~ I.Normalize (I.Normalize (I.Normalize a))
201+type Trivial2 a = I.Normalize a ~ I.Normalize (I.Normalize a)
202+type Trivial3 a = I.FromNat (I.Count (I.Normalize (I.Normalize a))) ~ I.Normalize (I.Normalize a)
203+type TrivialP a b = I.Normalize (a, b) ~ I.Normalize (I.Normalize a, I.Normalize b)
204+
205+-- | It isn't possible to implement the 'id' function so it's
206+-- implementation is 'undefined'. However 'comp' can be and this partial
207+-- class implementation exists just to make the code more readable.
208+--
209+-- Please use 'iden' instead.
210+instance (Num e) => C.Category (Matrix e) where
211+ id = undefined
212+ (.) = comp
213213
214214-- | Bifunctor equivalent function
215215bimapM ::
216216 ( Liftable e a b,
217217 Liftable e c d,
218− CountableDimsN a c,
219− CountableDimsN b d,
220− FLN d c,
221− FLN b a
218+ CountableDimensionsN a c,
219+ CountableDimensionsN b d,
220+ FromListsN e d c,
221+ FromListsN e b a
222222 ) => (a -> b) -> (c -> d) -> Matrix e a c -> Matrix e b d
223−bimapM f g m = fromF g . m . tr (fromF f)
223+bimapM f g m = fromF g `comp` m `comp` tr (fromF f)
224224
225225-- | Zero type alias
226226type Zero = Void
@@ -230,6 +230,10 @@ type One = ()
230230
231231-- Primitives
232232
233+-- | Empty matrix constructor
234+empty :: Matrix e Zero Zero
235+empty = M I.Empty
236+
233237-- | Unit matrix constructor
234238one :: e -> Matrix e One One
235239one = M . I.One
@@ -267,37 +271,37 @@ infixl 2 ===
267271-- Functor hierarchy
268272
269273-- | Functor instance equivalent function
270−fmapM ::
274+fmapM ::
271275 ( Liftable e a b,
272− CountableDimsN a b,
273− FLN b a
276+ CountableDimensionsN a b,
277+ FromListsN e b a
274278 )
275279 =>
276280 (a -> b) -> Matrix e c a -> Matrix e c b
277−fmapM f m = fromF f . m
281+fmapM f m = fromF f `comp` m
278282
279283-- | Applicative instance equivalent 'unit' function,
280284unitM :: (Num e) => Matrix e () ()
281285unitM = one 1
282286
283287-- | Applicative instance equivalent 'unit' function,
284−multM ::
285− ( CountableDimsN a b,
288+multM ::
289+ ( CountableDimensionsN a b,
286290 CountableN (a, b),
287291 Num e,
288− FLN (a, b) a,
289− FLN (a, b) b,
292+ FromListsN e (a, b) a,
293+ FromListsN e (a, b) b,
290294 TrivialP a b
291295 ) => Matrix e c a -> Matrix e c b -> Matrix e c (a, b)
292296multM = kr
293297
294298-- | Monad instance equivalent 'return' function,
295−returnM ::
296− forall e a .
299+returnM ::
300+ forall e a .
297301 ( Num e,
298302 Enum e,
299303 Enum a,
300− FLN () a,
304+ FromListsN e () a,
301305 Countable a
302306 ) => a -> Matrix e One a
303307returnM a = col l
@@ -314,35 +318,22 @@ bindM = flip comp
314318
315319-- | Build a matrix out of a list of list of elements. Throws a runtime
316320-- error if the dimensions do not match.
317−fromLists :: (FLN cols rows) => [[e]] -> Matrix e cols rows
321+fromLists :: (FromListsN e cols rows) => [[e]] -> Matrix e cols rows
318322fromLists = M . I.fromLists
319323
320324-- | Matrix builder function. Constructs a matrix provided with
321−-- a construction function that operates with indices.
322−matrixBuilder' ::
323− (FLN cols rows, CountableDimsN cols rows )
324− => ((Int, Int) -> e) -> Matrix e cols rows
325−matrixBuilder' = M . I.matrixBuilder'
326−
327−-- | Matrix builder function. Constructs a matrix provided with
328−-- a construction function that operates with arbitrary types.
325+-- a construction function.
329326matrixBuilder ::
330− ( FLN a b,
331− Enum a,
332− Enum b,
333− Bounded a,
334− Bounded b,
335− Eq a,
336− Countable b
337− ) => ((a, b) -> e) -> Matrix e a b
338−matrixBuilder f = M (I.matrixBuilder f)
327+ (FromListsN e cols rows, CountableDimensionsN cols rows )
328+ => ((Int, Int) -> e) -> Matrix e cols rows
329+matrixBuilder = M . I.matrixBuilder
339330
340331-- | Constructs a column vector matrix
341−col :: (FLN () rows) => [e] -> Matrix e One rows
332+col :: (FromListsN e () rows) => [e] -> Matrix e One rows
342333col = M . I.col
343334
344335-- | Constructs a row vector matrix
345−row :: (FLN cols ()) => [e] -> Matrix e cols One
336+row :: (FromListsN e cols ()) => [e] -> Matrix e cols One
346337row = M . I.row
347338
348339-- | Lifts functions to matrices with arbitrary dimensions.
@@ -351,8 +342,8 @@ row = M . I.row
351342-- types @a@ or @b@ allows.
352343fromF' ::
353344 ( Liftable e a b,
354− CountableDimsN cols rows,
355− FLN rows cols
345+ CountableDimensionsN cols rows,
346+ FromListsN e rows cols
356347 ) =>
357348 (a -> b) -> Matrix e cols rows
358349fromF' = M . I.fromF'
@@ -361,8 +352,8 @@ fromF' = M . I.fromF'
361352-- cardinality's.
362353fromF ::
363354 ( Liftable e a b,
364− CountableDimsN a b,
365− FLN b a
355+ CountableDimensionsN a b,
356+ FromListsN e b a
366357 ) =>
367358 (a -> b) -> Matrix e a b
368359fromF = M . I.fromF
@@ -370,8 +361,8 @@ fromF = M . I.fromF
370361-- | Lifts relation functions to Boolean Matrix
371362toRel ::
372363 ( Liftable (Natural 0 1) a b,
373− CountableDims a b,
374− FLN b a
364+ CountableDimensionsN a b,
365+ FromListsN (Natural 0 1) b a
375366 ) => (a -> b -> Bool) -> Matrix (Natural 0 1) a b
376367toRel = M . I.toRel
377368
@@ -389,7 +380,7 @@ toList (M m) = I.toList m
389380
390381-- | The zero matrix. A matrix wholly filled with zeros.
391382zeros ::
392− (Num e, FLN cols rows, CountableDimsN cols rows)
383+ (Num e, FromListsN e cols rows, CountableDimensionsN cols rows)
393384 => Matrix e cols rows
394385zeros = M I.zeros
395386
@@ -399,7 +390,7 @@ zeros = M I.zeros
399390--
400391-- Also known as T (Top) matrix.
401392ones ::
402− (Num e, FLN cols rows, CountableDimsN cols rows)
393+ (Num e, FromListsN e cols rows, CountableDimensionsN cols rows)
403394 => Matrix e cols rows
404395ones = M I.ones
405396
@@ -408,7 +399,7 @@ ones = M I.ones
408399-- | The constant matrix constructor. A matrix wholly filled with a given
409400-- value.
410401constant ::
411− (Num e, FLN cols rows, CountableDimsN cols rows)
402+ (Num e, FromListsN e cols rows, CountableDimensionsN cols rows)
412403 => e -> Matrix e cols rows
413404constant = M . I.constant
414405
@@ -417,19 +408,19 @@ constant = M . I.constant
417408-- | The T (Top) row vector matrix.
418409bang ::
419410 forall e cols.
420− (Num e, Enum e, FLN cols (), CountableN cols) =>
411+ (Num e, Enum e, FromListsN e cols (), CountableN cols) =>
421412 Matrix e cols One
422413bang = M I.bang
423414
424415-- | Point constant relation
425−point ::
416+point ::
426417 ( Bounded a,
427418 Enum a,
428419 Eq a,
429420 Num e,
430421 Ord e,
431422 CountableN a,
432− FLN a One
423+ FromListsN e a One
433424 ) => a -> Matrix e One a
434425point = fromF . const
435426
@@ -437,7 +428,7 @@ point = fromF . const
437428
438429-- | iden matrix
439430iden ::
440− (Num e, FLN a a, CountableN a) =>
431+ (Num e, FromListsN e a a, CountableN a) =>
441432 Matrix e a a
442433iden = M I.iden
443434{-# NOINLINE iden #-}
@@ -451,7 +442,7 @@ iden = M I.iden
451442comp :: (Num e) => Matrix e cr rows -> Matrix e cols cr -> Matrix e cols rows
452443comp (M a) (M b) = M (I.comp a b)
453444{-# NOINLINE comp #-}
454−{-# RULES
445+{-# RULES
455446 "comp/iden1" forall m. comp m iden = m ;
456447 "comp/iden2" forall m. comp iden m = m
457448#-}
@@ -473,9 +464,9 @@ infixl 7 ./
473464-- | Biproduct first component projection
474465p1 ::
475466 ( Num e,
476− CountableDimsN n m,
477− FLN n m,
478− FLN m m
467+ CountableDimensionsN n m,
468+ FromListsN e n m,
469+ FromListsN e m m
479470 ) =>
480471 Matrix e (Either m n) m
481472p1 = M I.p1
@@ -483,9 +474,9 @@ p1 = M I.p1
483474-- | Biproduct second component projection
484475p2 ::
485476 ( Num e,
486− CountableDimsN n m,
487− FLN m n,
488− FLN n n
477+ CountableDimensionsN n m,
478+ FromListsN e m n,
479+ FromListsN e n n
489480 ) =>
490481 Matrix e (Either m n) n
491482p2 = M I.p2
@@ -495,9 +486,9 @@ p2 = M I.p2
495486-- | Biproduct first component injection
496487i1 ::
497488 ( Num e,
498− CountableDimsN n m,
499− FLN n m,
500− FLN m m
489+ CountableDimensionsN n m,
490+ FromListsN e n m,
491+ FromListsN e m m
501492 ) =>
502493 Matrix e m (Either m n)
503494i1 = tr p1
@@ -505,9 +496,9 @@ i1 = tr p1
505496-- | Biproduct second component injection
506497i2 ::
507498 ( Num e,
508− CountableDimsN n m,
509− FLN m n,
510− FLN n n
499+ CountableDimensionsN n m,
500+ FromListsN e m n,
501+ FromListsN e n n
511502 ) =>
512503 Matrix e n (Either m n)
513504i2 = tr p2
@@ -516,34 +507,24 @@ i2 = tr p2
516507
517508-- | Obtain the number of rows.
518509--
519−-- NOTE: The 'KnownNat' constraint is needed in order to obtain the
520−-- dimensions in constant time. For a version that doesn't require the
521−-- constraint see 'rows''.
510+-- NOTE: The 'KnownNat' constaint is needed in order to obtain the
511+-- dimensions in constant time.
512+--
513+-- TODO: A 'rows' function that does not need the 'KnownNat' constraint in
514+-- exchange for performance.
522515rows :: (CountableN rows) => Matrix e cols rows -> Int
523516rows (M m) = I.rows m
524517
525−-- | Obtain the number of rows in an inefficient manner, but without any
526−-- constraints.
527−--
528−-- For a more efficient version see 'rows'.
529−rows' :: Matrix e cols rows -> Int
530−rows' (M m) = I.rows' m
531−
532518-- | Obtain the number of columns.
519+--
520+-- NOTE: The 'KnownNat' constaint is needed in order to obtain the
521+-- dimensions in constant time.
533522--
534−-- NOTE: The 'KnownNat' constraint is needed in order to obtain the
535−-- dimensions in constant time. For a version that doesn't require the
536−-- constraint see 'columns''.
523+-- TODO: A 'columns' function that does not need the 'KnownNat' constraint in
524+-- exchange for performance.
537525columns :: (CountableN cols) => Matrix e cols rows -> Int
538526columns (M m) = I.columns m
539527
540−-- | Obtain the number of columns in an inefficient manner, but without any
541−-- constraints.
542−--
543−-- For a more efficient version see 'columns'.
544−columns' :: Matrix e cols rows -> Int
545−columns' (M m) = I.columns' m
546−
547528-- Coproduct Bifunctor
548529
549530infixl 5 -|-
@@ -551,11 +532,11 @@ infixl 5 -|-
551532-- | Matrix coproduct functor also known as matrix direct sum.
552533(-|-) ::
553534 ( Num e,
554− CountableDimsN j k,
555− FLN k k,
556− FLN j k,
557− FLN k j,
558− FLN j j
535+ CountableDimensionsN j k,
536+ FromListsN e k k,
537+ FromListsN e j k,
538+ FromListsN e k j,
539+ FromListsN e j j
559540 ) =>
560541 Matrix e n k ->
561542 Matrix e m j ->
@@ -565,23 +546,23 @@ infixl 5 -|-
565546-- Khatri Rao Product and projections
566547
567548-- | Khatri Rao product first component projection matrix.
568−fstM ::
549+fstM ::
569550 forall e m k .
570551 ( Num e,
571− CountableDimsN m k,
552+ CountableDimensionsN m k,
572553 CountableN (m, k),
573− FLN (m, k) m,
554+ FromListsN e (m, k) m,
574555 TrivialP m k
575556 ) => Matrix e (m, k) m
576557fstM = M (I.fstM @e @(I.Normalize m) @(I.Normalize k))
577558
578559-- | Khatri Rao product second component projection matrix.
579−sndM ::
560+sndM ::
580561 forall e m k.
581562 ( Num e,
582− CountableDimsN k m,
563+ CountableDimensionsN k m,
583564 CountableN (m, k),
584− FLN (m, k) k,
565+ FromListsN e (m, k) k,
585566 TrivialP m k
586567 ) => Matrix e (m, k) k
587568sndM = M (I.sndM @e @(I.Normalize m) @(I.Normalize k))
@@ -589,21 +570,21 @@ sndM = M (I.sndM @e @(I.Normalize m) @(I.Normalize k))
589570-- | Khatri Rao Matrix product also known as matrix pairing.
590571--
591572-- NOTE: That this is not a true categorical product, see for instance:
592−--
573+--
593574-- @
594−-- | fstM . kr a b == a
575+-- | fstM `comp` kr a b == a
595576-- kr a b ==> |
596−-- | sndM . kr a b == b
577+-- | sndM `comp` kr a b == b
597578-- @
598579--
599580-- __Emphasis__ on the implication symbol.
600581kr ::
601582 forall e cols a b.
602583 ( Num e,
603− CountableDimsN a b,
584+ CountableDimensionsN a b,
604585 CountableN (a, b),
605− FLN (a, b) a,
606− FLN (a, b) b,
586+ FromListsN e (a, b) a,
587+ FromListsN e (a, b) b,
607588 TrivialP a b
608589 ) => Matrix e cols a -> Matrix e cols b -> Matrix e cols (a, b)
609590kr a b =
@@ -619,13 +600,13 @@ infixl 4 ><
619600(><) ::
620601 forall e m p n q.
621602 ( Num e,
622− CountableDimsN m n,
623− CountableDimsN p q,
624− CountableDimsN (m, n) (p, q),
625− FLN (m, n) m,
626− FLN (m, n) n,
627− FLN (p, q) p,
628− FLN (p, q) q,
603+ CountableDimensionsN m n,
604+ CountableDimensionsN p q,
605+ CountableDimensionsN (m, n) (p, q),
606+ FromListsN e (m, n) m,
607+ FromListsN e (m, n) n,
608+ FromListsN e (p, q) p,
609+ FromListsN e (p, q) q,
629610 TrivialP m n,
630611 TrivialP p q
631612 ) => Matrix e m p -> Matrix e n q -> Matrix e (m, n) (p, q)
@@ -637,7 +618,7 @@ infixl 4 ><
637618-- Matrix abide Join Fork
638619
639620-- | Matrix "abiding" followin the 'Join'-'Fork' abide law.
640−--
621+--
641622-- Law:
642623--
643624-- @
@@ -649,7 +630,7 @@ abideJF (M m) = M (I.abideJF m)
649630-- Matrix abide Fork Join
650631
651632-- | Matrix "abiding" followin the 'Fork'-'Join' abide law.
652−--
633+--
653634-- Law:
654635--
655636-- @
@@ -668,9 +649,9 @@ tr (M m) = M (I.tr m)
668649
669650-- | Selective functors 'select' operator equivalent inspired by the
670651-- ArrowMonad solution presented in the paper.
671−selectM ::
652+selectM ::
672653 ( Num e,
673− FLN b b,
654+ FromListsN e b b,
674655 CountableN b
675656 ) => Matrix e cols (Either a b) -> Matrix e a b -> Matrix e cols b
676657selectM (M m) (M y) = M (I.select m y)
@@ -683,9 +664,9 @@ cond ::
683664 Trivial2 a,
684665 Trivial3 a,
685666 CountableN a,
686− FLN () a,
687− FLN a (),
688− FLN a a,
667+ FromListsN e () a,
668+ FromListsN e a (),
669+ FromListsN e a a,
689670 Liftable e a Bool
690671 )
691672 =>
@@ -695,11 +676,11 @@ cond p (M a) (M b) = M (I.cond p a b)
695676-- Pretty print
696677
697678-- | Matrix pretty printer
698−pretty :: (CountableDimsN cols rows, Show e) => Matrix e cols rows -> String
679+pretty :: (CountableDimensionsN cols rows, Show e) => Matrix e cols rows -> String
699680pretty (M m) = I.pretty m
700681
701682-- | Matrix pretty printer
702−prettyPrint :: (CountableDimsN cols rows, Show e) => Matrix e cols rows -> IO ()
683+prettyPrint :: (CountableDimensionsN cols rows, Show e) => Matrix e cols rows -> IO ()
703684prettyPrint (M m) = I.prettyPrint m
704685
705686-- | Zip two matrices with a given binary function
src/LAoP/Relation.hs+4−3
@@ -32,15 +32,16 @@ module LAoP.Relation
3232
3333 -- * Constraint type synonyms
3434 Countable,
35− CountableDims,
35+ CountableDimensions,
3636 CountableN,
37− CountableDimsN,
38− FLN,
37+ CountableDimensionsN,
38+ FromListsN,
3939 Liftable,
4040 Trivial,
4141 TrivialP,
4242
4343 -- * Primitives
44+ empty,
4445 one,
4546 join,
4647 (|||),
src/LAoP/Relation/Internal.hs+200−211
@@ -1,4 +1,3 @@
1−{-# LANGUAGE TypeFamilies #-}
21{-# LANGUAGE ConstraintKinds #-}
32{-# LANGUAGE GADTs #-}
43{-# LANGUAGE UndecidableInstances #-}
@@ -43,15 +42,16 @@ module LAoP.Relation.Internal
4342
4443 -- * Constraint type synonyms
4544 Countable,
46− CountableDims,
45+ CountableDimensions,
4746 CountableN,
48− CountableDimsN,
49− FLN,
47+ CountableDimensionsN,
48+ FromListsN,
5049 Liftable,
5150 Trivial,
5251 TrivialP,
5352
5453 -- * Primitives
54+ empty,
5555 one,
5656 join,
5757 (|||),
@@ -74,7 +74,6 @@ module LAoP.Relation.Internal
7474 toBool,
7575 pt,
7676 belongs,
77− relationBuilder',
7877 relationBuilder,
7978 zeros,
8079 ones,
@@ -178,9 +177,9 @@ import Data.Void
178177import qualified LAoP.Matrix.Internal as I
179178import LAoP.Utils.Internal
180179import Control.DeepSeq
180+import qualified Control.Category as C
181181import Data.Bool
182182import GHC.TypeLits
183−import Prelude hiding (id, (.))
184183
185184-- | Boolean type synonym for working with boolean matrices
186185type Boolean = Natural 0 1
@@ -193,21 +192,23 @@ newtype Relation a b = R (I.Matrix Boolean (I.Normalize a) (I.Normalize b))
193192deriving instance (Read (I.Matrix Boolean (I.Normalize a) (I.Normalize b))) => Read (Relation a b)
194193
195194-- | Constraint type synonyms to keep the type signatures less convoluted
196−type Countable a = KnownNat (I.Count a)
197−type CountableDims a b = (Countable a, Countable b)
198−type CountableN a = KnownNat (I.Count (I.Normalize a))
199−type CountableDimsN a b = (CountableN a, CountableN b)
200−type FLN a b = I.FromLists (I.Normalize a) (I.Normalize b)
201−type Liftable a b = (Bounded a, Bounded b, Enum a, Enum b, Eq b, Num Boolean, Ord Boolean)
202−type Trivial a = I.Normalize a ~ I.Normalize (I.Normalize a)
203−type TrivialP a b = I.Normalize (a, b) ~ I.Normalize (I.Normalize a, I.Normalize b)
204−
205−-- | It is possible to implement a constrained version of the category type
206−-- class.
207−instance Category Relation where
208− type Object Relation a = (FLN a a, CountableN a)
209− id = iden
210− (.) = comp
195+type Countable a = KnownNat (I.Count a)
196+type CountableDimensions a b = (Countable a, Countable b)
197+type CountableN a = KnownNat (I.Count (I.Normalize a))
198+type CountableDimensionsN a b = (CountableN a, CountableN b)
199+type FromListsN a b = I.FromLists Boolean (I.Normalize a) (I.Normalize b)
200+type Liftable a b = (Bounded a, Bounded b, Enum a, Enum b, Eq b, Num Boolean, Ord Boolean)
201+type Trivial a = I.Normalize a ~ I.Normalize (I.Normalize a)
202+type TrivialP a b = I.Normalize (a, b) ~ I.Normalize (I.Normalize a, I.Normalize b)
203+
204+-- | It isn't possible to implement the 'id' function so it's
205+-- implementation is 'undefined'. However 'comp' can be and this partial
206+-- class implementation exists just to make the code more readable.
207+--
208+-- Please use 'iden' instead.
209+instance C.Category Relation where
210+ id = undefined
211+ (.) = comp
211212
212213instance Num (Relation a b) where
213214 -- | Matrix addition becomes Boolean matrix disjointion
@@ -228,6 +229,10 @@ type One = ()
228229
229230-- Primitives
230231
232+-- | Empty matrix constructor
233+empty :: Relation Zero Zero
234+empty = R I.Empty
235+
231236-- | Unit matrix constructor
232237one :: Boolean -> Relation One One
233238one = R . I.One
@@ -264,27 +269,14 @@ infixl 2 ===
264269
265270-- | Build a matrix out of a list of list of elements. Throws a runtime
266271-- error if the dimensions do not match.
267−fromLists :: (FLN a b) => [[Boolean]] -> Relation a b
272+fromLists :: (FromListsN a b) => [[Boolean]] -> Relation a b
268273fromLists = R . I.fromLists
269274
270−-- | Relation builder function. Constructs a relation provided with
271−-- a construction function that operates with indices.
272−relationBuilder' ::
273− (FLN a b, CountableDimsN a b) =>
274− ((Int, Int) -> Boolean) -> Relation a b
275−relationBuilder' = R . I.matrixBuilder'
276−
277−-- | Relation builder function. Constructs a relation provided with
278−-- a construction function that operates with arbitrary types.
275+-- | Matrix builder function. Constructs a matrix provided with
276+-- a construction function.
279277relationBuilder ::
280− ( FLN a b,
281− Enum a,
282− Enum b,
283− Bounded a,
284− Bounded b,
285− Eq a,
286− CountableDims a b
287− ) => ((a, b) -> Boolean) -> Relation a b
278+ (FromListsN a b, CountableDimensionsN a b) =>
279+ ((Int, Int) -> Boolean) -> Relation a b
288280relationBuilder = R . I.matrixBuilder
289281
290282-- | Lifts functions to matrices with arbitrary dimensions.
@@ -293,18 +285,18 @@ relationBuilder = R . I.matrixBuilder
293285-- types @a@ or @b@ allows.
294286fromF' ::
295287 ( Liftable a b,
296− CountableDimsN c d,
297− FLN d c
288+ CountableDimensionsN c d,
289+ FromListsN d c
298290 )
299291 => (a -> b) -> Relation c d
300292fromF' f = R (I.fromFRel' f)
301293
302294-- | Lifts functions to matrices with dimensions matching @a@ and @b@
303295-- cardinality's.
304−fromF ::
296+fromF ::
305297 ( Liftable a b,
306− CountableDimsN a b,
307− FLN b a
298+ CountableDimensionsN a b,
299+ FromListsN b a
308300 )
309301 => (a -> b) -> Relation a b
310302fromF f = R (I.fromFRel f)
@@ -312,8 +304,8 @@ fromF f = R (I.fromFRel f)
312304-- | Lifts relation functions to 'Relation'
313305toRel ::
314306 ( Liftable a b,
315− CountableDims a b,
316− FLN b a
307+ CountableDimensionsN a b,
308+ FromListsN b a
317309 )
318310 => (a -> b -> Bool) -> Relation a b
319311toRel = R . I.toRel
@@ -322,9 +314,9 @@ toRel = R . I.toRel
322314fromRel ::
323315 ( Liftable a b,
324316 Eq a,
325− CountableDimsN a b,
326− FLN a One,
327− FLN b One
317+ CountableDimensionsN a b,
318+ FromListsN a One,
319+ FromListsN b One
328320 )
329321 => Relation a b -> (a -> b -> Bool)
330322fromRel r a b = pointApBool a b r
@@ -348,12 +340,12 @@ toBool r = case toList r of
348340-- | Power transpose.
349341--
350342-- Maps a relation to a set valued function.
351−pt ::
343+pt ::
352344 ( Liftable a b,
353345 Eq a,
354− CountableDimsN a b,
355− FLN a One,
356− FLN b One
346+ CountableDimensionsN a b,
347+ FromListsN a One,
348+ FromListsN b One
357349 )
358350 => Relation a b -> (a -> List b)
359351pt r a =
@@ -365,8 +357,8 @@ belongs ::
365357 ( Bounded a,
366358 Enum a,
367359 Eq a,
368− CountableDims (List a) a,
369− FLN a (List a)
360+ CountableDimensionsN (List a) a,
361+ FromListsN a (List a)
370362 )
371363 => Relation (List a) a
372364belongs = toRel elemR
@@ -378,16 +370,16 @@ belongs = toRel elemR
378370-- | The zero relation. A relation where no element of type @a@ relates
379371-- with elements of type @b@.
380372--
381−-- Also known as ⊥ (Bottom) Relation.
373+-- Also known as ⊥ (Bottom) Relation or empty Relation.
382374--
383375-- @
384−-- r `.` ⊥ == ⊥ `.` r == ⊥
376+-- r ``comp`` ⊥ == ⊥ ``comp`` r == ⊥
385377-- ⊥ ``sse`` R && R ``sse`` T == True
386378-- @
387379zeros ::
388− (FLN a b, CountableDimsN a b) =>
380+ (FromListsN a b, CountableDimensionsN a b) =>
389381 Relation a b
390−zeros = relationBuilder' (const (nat 0))
382+zeros = relationBuilder (const (nat 0))
391383
392384-- Ones Matrix
393385
@@ -400,25 +392,25 @@ zeros = relationBuilder' (const (nat 0))
400392-- ⊥ ``sse`` R && R ``sse`` T == True
401393-- @
402394ones ::
403− (FLN a b, CountableDimsN a b) =>
395+ (FromListsN a b, CountableDimensionsN a b) =>
404396 Relation a b
405−ones = relationBuilder' (const (nat 1))
397+ones = relationBuilder (const (nat 1))
406398
407399-- Bang Matrix
408400
409401-- | The T (Top) row vector relation.
410402bang ::
411− (FLN a One, CountableN a) =>
403+ (FromListsN a One, CountableN a) =>
412404 Relation a One
413405bang = ones
414406
415407-- | Point constant relation
416−point ::
408+point ::
417409 ( Bounded a,
418410 Enum a,
419411 Eq a,
420412 CountableN a,
421− FLN a One
413+ FromListsN a One
422414 ) => a -> Relation One a
423415point = fromF . const
424416
@@ -427,16 +419,16 @@ point = fromF . const
427419-- | iden matrix
428420--
429421-- @
430−-- 'iden' `.` r == r == r `.` 'iden'
422+-- 'iden' ``comp`` r == r == r ``comp`` 'iden'
431423-- @
432424iden ::
433− (FLN a a, CountableN a) => Relation a a
434−iden = relationBuilder' (bool (nat 0) (nat 1) . uncurry (==))
425+ (FromListsN a a, CountableN a) => Relation a a
426+iden = relationBuilder (bool (nat 0) (nat 1) . uncurry (==))
435427
436428-- | Relational composition
437429--
438430-- @
439−-- r `.` (s `.` p) = (r `.` s) `.` p
431+-- r ``comp`` (s ``comp`` p) = (r ``comp`` s) ``comp`` p
440432-- @
441433comp :: Relation b c -> Relation a b -> Relation a c
442434comp (R a) (R b) = R (I.compRel a b)
@@ -484,7 +476,7 @@ shrunkBy r s = r `intersection` divR s (conv r)
484476-- r ``overriddenBy`` r == r
485477-- @
486478overriddenBy ::
487− ( FLN b b,
479+ ( FromListsN b b,
488480 CountableN b
489481 ) => Relation a b -> Relation a b -> Relation a b
490482overriddenBy r s = s `union` r `intersection` divR zeros (conv s)
@@ -496,11 +488,11 @@ overriddenBy r s = s `union` r `intersection` divR zeros (conv s)
496488pointAp ::
497489 ( Liftable a b,
498490 Eq a,
499− CountableDimsN a b,
500− FLN a One,
501− FLN b One
491+ CountableDimensionsN a b,
492+ FromListsN a One,
493+ FromListsN b One
502494 ) => a -> b -> Relation a b -> Relation One One
503−pointAp a b r = conv (point b) . r . point a
495+pointAp a b r = conv (point b) `comp` r `comp` point a
504496
505497-- | Relational application
506498--
@@ -508,11 +500,11 @@ pointAp a b r = conv (point b) . r . point a
508500pointApBool ::
509501 ( Liftable a b,
510502 Eq a,
511− CountableDimsN a b,
512− FLN a One,
513− FLN b One
503+ CountableDimensionsN a b,
504+ FromListsN a One,
505+ FromListsN b One
514506 ) => a -> b -> Relation a b -> Bool
515−pointApBool a b r = toBool $ conv (point b) . r . point a
507+pointApBool a b r = toBool $ conv (point b) `comp` r `comp` point a
516508
517509-- | Relational converse
518510--
@@ -554,8 +546,8 @@ intersection a b = a * b
554546-- @
555547-- (r ``union`` s) ``union`` t == r `'union' (s ``union`` t)
556548-- r ``union`` s ``sse`` x == r ``sse`` x && s ``sse`` x
557−-- r `.` (s ``union`` t) == (r `.` s) ``union`` (r `.` t)
558−-- (s ``union`` t) `.` r == (s `.` r) ``union`` (t `.` r)
549+-- r ``comp`` (s ``union`` t) == (r ``comp`` s) ``union`` (r ``comp`` t)
550+-- (s ``union`` t) ``comp`` r == (s ``comp`` r) ``union`` (t ``comp`` r)
559551-- @
560552union :: Relation a b -> Relation a b -> Relation a b
561553union a b = a + b
@@ -563,46 +555,46 @@ union a b = a + b
563555-- | Relation Kernel
564556--
565557-- @
566−-- 'ker' r == 'conv' r `.` r
558+-- 'ker' r == 'conv' r ``comp`` r
567559-- 'ker' r == 'img' ('conv' r)
568560-- @
569561ker :: Relation a b -> Relation a a
570−ker r = conv r . r
562+ker r = conv r `comp` r
571563
572564-- | Relation Image
573565--
574566-- @
575−-- 'img' r == r `.` conv r
567+-- 'img' r == r ``comp`` conv r
576568-- 'img' r == 'ker' ('conv' r)
577569-- @
578570img :: Relation a b -> Relation b b
579−img r = r . conv r
571+img r = r `comp` conv r
580572
581573-- | Function division. Special case of 'divS'.
582574--
583575-- NOTE: _This is only valid_ if @f@ and @g@ are 'function's, i.e. 'simple' and
584576-- 'entire'.
585577--
586−-- @'divisionF' f g == 'conv' g `.` f@
578+-- @'divisionF' f g == 'conv' g ``comp`` f@
587579divisionF :: Relation a c -> Relation b c -> Relation a b
588−divisionF f g = conv g . f
580+divisionF f g = conv g `comp` f
589581
590582-- Taxonomy of binary relations
591583
592584-- | A 'Relation' @r@ is 'simple' 'iff' @'coreflexive' ('img' r)@
593−simple :: (CountableN b, FLN b b) => Relation a b -> Bool
585+simple :: (CountableN b, FromListsN b b) => Relation a b -> Bool
594586simple = coreflexive . img
595587
596588-- | A 'Relation' @r@ is 'injective' 'iff' @'coreflexive' ('ker' r)@
597−injective :: (CountableN a, FLN a a) => Relation a b -> Bool
589+injective :: (CountableN a, FromListsN a a) => Relation a b -> Bool
598590injective = coreflexive . ker
599591
600592-- | A 'Relation' @r@ is 'entire' 'iff' @'reflexive' ('ker' r)@
601−entire :: (CountableN a, FLN a a) => Relation a b -> Bool
593+entire :: (CountableN a, FromListsN a a) => Relation a b -> Bool
602594entire = reflexive . ker
603595
604596-- | A 'Relation' @r@ is 'surjective' 'iff' @'reflexive' ('img' r)@
605−surjective :: (CountableN b, FLN b b) => Relation a b -> Bool
597+surjective :: (CountableN b, FromListsN b b) => Relation a b -> Bool
606598surjective = reflexive . img
607599
608600-- | A 'Relation' @r@ is a 'function' 'iff' @'simple' r && 'entire' r@
@@ -611,13 +603,13 @@ surjective = reflexive . img
611603-- relations:
612604--
613605-- @
614−-- f `.` r ``sse`` s == r ``sse`` f `.` s
615−-- r `.` f ``sse`` s == r ``sse`` s `.` f
606+-- f ``comp`` r ``sse`` s == r ``sse`` f ``comp`` s
607+-- r ``comp`` f ``sse`` s == r ``sse`` s ``comp`` f
616608-- @
617609function ::
618− ( CountableDimsN a b,
619− FLN a a,
620− FLN b b
610+ ( CountableDimensionsN a b,
611+ FromListsN a a,
612+ FromListsN b b
621613 )
622614 => Relation a b -> Bool
623615function r = simple r && entire r
@@ -625,7 +617,7 @@ function r = simple r && entire r
625617-- | A 'Relation' @r@ is a 'representation' 'iff' @'injective' r && 'entire' r@
626618representation ::
627619 ( CountableN a,
628− FLN a a
620+ FromListsN a a
629621 )
630622 => Relation a b -> Bool
631623representation r = injective r && entire r
@@ -633,91 +625,91 @@ representation r = injective r && entire r
633625-- | A 'Relation' @r@ is an 'abstraction' 'iff' @'surjective' r && 'simple' r@
634626abstraction ::
635627 ( CountableN b,
636− FLN b b
628+ FromListsN b b
637629 )
638630 => Relation a b -> Bool
639631abstraction r = surjective r && simple r
640632
641633-- | A 'Relation' @r@ is a 'surjection' 'iff' @'function' r && 'abstraction' r@
642634surjection ::
643− ( CountableDimsN a b,
644− FLN a a,
645− FLN b b
635+ ( CountableDimensionsN a b,
636+ FromListsN a a,
637+ FromListsN b b
646638 )
647639 => Relation a b -> Bool
648640surjection r = function r && abstraction r
649641
650642-- | A 'Relation' @r@ is a 'injection' 'iff' @'function' r && 'representation' r@
651643injection ::
652− ( CountableDimsN a b,
653− FLN a a,
654− FLN b b
644+ ( CountableDimensionsN a b,
645+ FromListsN a a,
646+ FromListsN b b
655647 )
656648 => Relation a b -> Bool
657649injection r = function r && representation r
658650
659651-- | A 'Relation' @r@ is an 'bijection' 'iff' @'injection' r && 'surjection' r@
660652bijection ::
661− ( CountableDimsN a b,
662− FLN b b,
663− FLN a a
653+ ( CountableDimensionsN a b,
654+ FromListsN b b,
655+ FromListsN a a
664656 ) => Relation a b -> Bool
665657bijection r = injection r && surjection r
666658
667659-- Properties of relations
668660
669−-- | A 'Relation' @r@ is 'reflexive' 'iff' @'id' ``sse`` r@
670−reflexive :: (CountableN a, FLN a a) => Relation a a -> Bool
671−reflexive r = id <= r
661+-- | A 'Relation' @r@ is 'reflexive' 'iff' @'iden' ``sse`` r@
662+reflexive :: (CountableN a, FromListsN a a) => Relation a a -> Bool
663+reflexive r = iden <= r
672664
673−-- | A 'Relation' @r@ is 'coreflexive' 'iff' @r ``sse`` 'id'@
674−coreflexive :: (CountableN a, FLN a a) => Relation a a -> Bool
675−coreflexive r = r <= id
665+-- | A 'Relation' @r@ is 'coreflexive' 'iff' @r ``sse`` 'iden'@
666+coreflexive :: (CountableN a, FromListsN a a) => Relation a a -> Bool
667+coreflexive r = r <= iden
676668
677−-- | A 'Relation' @r@ is 'transitive' 'iff' @(r `.` r) ``sse`` r@
669+-- | A 'Relation' @r@ is 'transitive' 'iff' @(r ``comp`` r) ``sse`` r@
678670transitive :: Relation a a -> Bool
679−transitive r = (r . r) `sse` r
671+transitive r = (r `comp` r) `sse` r
680672
681673-- | A 'Relation' @r@ is 'symmetric' 'iff' @r == 'conv' r@
682674symmetric :: Relation a a -> Bool
683675symmetric r = r == conv r
684676
685−-- | A 'Relation' @r@ is anti-symmetric 'iff' @(r ``intersection`` 'conv' r) ``sse`` 'id'@
686−antiSymmetric :: (CountableN a, FLN a a) => Relation a a -> Bool
687−antiSymmetric r = (r `intersection` conv r) `sse` id
677+-- | A 'Relation' @r@ is anti-symmetric 'iff' @(r ``intersection`` 'conv' r) ``sse`` 'iden'@
678+antiSymmetric :: (CountableN a, FromListsN a a) => Relation a a -> Bool
679+antiSymmetric r = (r `intersection` conv r) `sse` iden
688680
689−-- | A 'Relation' @r@ is 'irreflexive' 'iff' @(r ``intersection`` 'id') == 'zeros'@
690−irreflexive :: (CountableN a, FLN a a) => Relation a a -> Bool
691−irreflexive r = (r `intersection` id) == zeros
681+-- | A 'Relation' @r@ is 'irreflexive' 'iff' @(r ``intersection`` 'iden') == 'zeros'@
682+irreflexive :: (CountableN a, FromListsN a a) => Relation a a -> Bool
683+irreflexive r = (r `intersection` iden) == zeros
692684
693685-- | A 'Relation' @r@ is 'connected' 'iff' @(r ``union`` 'conv' r) == 'ones'@
694−connected :: (CountableN a, FLN a a) => Relation a a -> Bool
686+connected :: (CountableN a, FromListsN a a) => Relation a a -> Bool
695687connected r = (r `union` conv r) == ones
696688
697689-- | A 'Relation' @r@ is a 'preorder' 'iff' @'reflexive' r && 'transitive' r@
698−preorder :: (CountableN a, FLN a a) => Relation a a -> Bool
690+preorder :: (CountableN a, FromListsN a a) => Relation a a -> Bool
699691preorder r = reflexive r && transitive r
700692
701693-- | A 'Relation' @r@ is a partial-order 'iff' @'antiSymmetric' r && 'preorder' r@
702−partialOrder :: (CountableN a, FLN a a) => Relation a a -> Bool
694+partialOrder :: (CountableN a, FromListsN a a) => Relation a a -> Bool
703695partialOrder r = antiSymmetric r && preorder r
704696
705697-- | A 'Relation' @r@ is a linear-order 'iff' @'connected' r && 'partialOrder' r@
706−linearOrder :: (CountableN a, FLN a a) => Relation a a -> Bool
698+linearOrder :: (CountableN a, FromListsN a a) => Relation a a -> Bool
707699linearOrder r = connected r && partialOrder r
708700
709701-- | A 'Relation' @r@ is an 'equivalence' 'iff' @'symmetric' r && 'preorder' r@
710−equivalence :: (CountableN a, FLN a a) => Relation a a -> Bool
702+equivalence :: (CountableN a, FromListsN a a) => Relation a a -> Bool
711703equivalence r = symmetric r && preorder r
712704
713705-- | A 'Relation' @r@ is a partial-equivalence 'iff' @'partialOrder' r && 'equivalence' r@
714−partialEquivalence :: (CountableN a, FLN a a) => Relation a a -> Bool
706+partialEquivalence :: (CountableN a, FromListsN a a) => Relation a a -> Bool
715707partialEquivalence r = partialOrder r && equivalence r
716708
717709-- | A 'Relation' @r@ is 'difunctional' or regular wherever
718−-- @r `.` 'conv' r `.` r == r@
710+-- @r ``comp`` 'conv' r ``comp`` r == r@
719711difunctional :: Relation a b -> Bool
720−difunctional r = r . conv r . r == r
712+difunctional r = r `comp` conv r `comp` r == r
721713
722714-- Relational pairing
723715
@@ -726,27 +718,27 @@ difunctional r = r . conv r . r == r
726718-- NOTE: That this is not a true categorical product, see for instance:
727719--
728720-- @
729−-- | 'fstR' `.` 'splitR' a b ``sse`` a
721+-- | 'fstR' ``comp`` 'splitR' a b ``sse`` a
730722-- 'splitR' a b <=> |
731−-- | 'sndR' `.` 'splitR' a b ``sse`` b
723+-- | 'sndR' ``comp`` 'splitR' a b ``sse`` b
732724-- @
733725--
734726-- __Emphasis__ on the 'sse'.
735727--
736728-- @
737−-- 'splitR' r s `.` f == 'splitR' (r `.` f) (s `.` f)
738−-- (R '><' S) `.` 'splitR' p q == 'splitR' (r `.` p) (s `.` q)
739−-- 'conv' ('splitR' r s) `.` 'splitR' x y == ('conv' r `.` x) ``intersection`` ('conv' s `.` y)
729+-- 'splitR' r s ``comp`` f == 'splitR' (r ``comp`` f) (s ``comp`` f)
730+-- (R '><' S) ``comp`` 'splitR' p q == 'splitR' (r ``comp`` p) (s ``comp`` q)
731+-- 'conv' ('splitR' r s) ``comp`` 'splitR' x y == ('conv' r ``comp`` x) ``intersection`` ('conv' s ``comp`` y)
740732-- @
741733--
742734-- @
743735-- 'eitherR' ('splitR' r s) ('splitR' t v) == 'splitR' ('eitherR' r t) ('eitherR' s v)
744736-- @
745737splitR ::
746− ( CountableDimsN a b,
738+ ( CountableDimensionsN a b,
747739 CountableN (a, b),
748− FLN (a, b) a,
749− FLN (a, b) b,
740+ FromListsN (a, b) a,
741+ FromListsN (a, b) b,
750742 TrivialP a b
751743 )
752744 => Relation c a -> Relation c b -> Relation c (a, b)
@@ -755,13 +747,13 @@ splitR (R f) (R g) = R (I.kr f g)
755747-- | Relational pairing first component projection
756748--
757749-- @
758−-- 'fstR' `.` 'splitR' r s ``sse`` r
750+-- 'fstR' ``comp`` 'splitR' r s ``sse`` r
759751-- @
760752fstR ::
761753 forall a b .
762− ( CountableDimsN a b,
754+ ( CountableDimensionsN a b,
763755 CountableN (a, b),
764− FLN (a, b) a,
756+ FromListsN (a, b) a,
765757 TrivialP a b
766758 )
767759 => Relation (a, b) a
@@ -770,13 +762,13 @@ fstR = R (I.fstM @Boolean @(I.Normalize a) @(I.Normalize b))
770762-- | Relational pairing second component projection
771763--
772764-- @
773−-- 'sndR' `.` 'splitR' r s ``sse`` s
765+-- 'sndR' ``comp`` 'splitR' r s ``sse`` s
774766-- @
775767sndR ::
776768 forall a b .
777− ( CountableDimsN a b,
769+ ( CountableDimensionsN a b,
778770 CountableN (a, b),
779− FLN (a, b) b,
771+ FromListsN (a, b) b,
780772 TrivialP a b
781773 )
782774 => Relation (a, b) b
@@ -788,17 +780,17 @@ infixl 4 ><
788780-- | Relational pairing functor
789781--
790782-- @
791−-- r '><' s == 'splitR' (r `.` fstR) (s `.` sndR)
792−-- (r '><' s) `.` (p '><' q) == (r `.` p) '><' (s `.` q)
783+-- r '><' s == 'splitR' (r ``comp`` fstR) (s ``comp`` sndR)
784+-- (r '><' s) ``comp`` (p '><' q) == (r ``comp`` p) '><' (s ``comp`` q)
793785-- @
794786(><) ::
795− ( CountableDimsN a b,
796− CountableDimsN c d,
797− CountableDimsN (a, c) (b, d),
798− FLN (a, c) a,
799− FLN (a, c) c,
800− FLN (b, d) b,
801− FLN (b, d) d,
787+ ( CountableDimensionsN a b,
788+ CountableDimensionsN c d,
789+ CountableDimensionsN (a, c) (b, d),
790+ FromListsN (a, c) a,
791+ FromListsN (a, c) c,
792+ FromListsN (b, d) b,
793+ FromListsN (b, d) d,
802794 TrivialP a c,
803795 TrivialP b d
804796 )
@@ -810,13 +802,13 @@ infixl 4 ><
810802-- | Relational coproduct.
811803--
812804-- @
813−-- | 'eitherR' a b `.` 'i1' == a
805+-- | 'eitherR' a b ``comp`` 'i1' == a
814806-- 'eitherR' a b <=> |
815−-- | 'eitherR' a b `.` 'i2' == b
807+-- | 'eitherR' a b ``comp`` 'i2' == b
816808-- @
817809--
818810-- @
819−-- 'eitherR' r s `.` 'conv' ('eitherR' t u) == (r `.` 'conv' t) ``union`` (s `.` 'conv' u)
811+-- 'eitherR' r s ``comp`` 'conv' ('eitherR' t u) == (r ``comp`` 'conv' t) ``union`` (s ``comp`` 'conv' u)
820812-- @
821813--
822814-- @
@@ -828,13 +820,13 @@ eitherR = join
828820-- | Relational coproduct first component injection
829821--
830822-- @
831−-- 'img' 'i1' ``union`` 'img' 'i2' == 'id'
832−-- 'i1' `.` 'i2' = 'zeros'
823+-- 'img' 'i1' ``union`` 'img' 'i2' == 'iden'
824+-- 'i1' ``comp`` 'i2' = 'zeros'
833825-- @
834826i1 ::
835− ( CountableDimsN a b,
836− FLN b a,
837− FLN a a
827+ ( CountableDimensionsN a b,
828+ FromListsN b a,
829+ FromListsN a a
838830 )
839831 => Relation a (Either a b)
840832i1 = R I.i1
@@ -842,13 +834,13 @@ i1 = R I.i1
842834-- | Relational coproduct second component injection
843835--
844836-- @
845−-- 'img' 'i1' ``union`` 'img' 'i2' == 'id'
846−-- 'i1' `.` 'i2' = 'zeros'
837+-- 'img' 'i1' ``union`` 'img' 'i2' == 'iden'
838+-- 'i1' ``comp`` 'i2' = 'zeros'
847839-- @
848840i2 ::
849− ( CountableDimsN a b,
850− FLN a b,
851− FLN b b
841+ ( CountableDimensionsN a b,
842+ FromListsN a b,
843+ FromListsN b b
852844 )
853845 => Relation b (Either a b)
854846i2 = R I.i2
@@ -858,14 +850,14 @@ infixl 5 -|-
858850-- | Relational coproduct functor.
859851--
860852-- @
861−-- r '-|-' s == 'eitherR' ('i1' `.` r) ('i2' `.` s)
853+-- r '-|-' s == 'eitherR' ('i1' ``comp`` r) ('i2' ``comp`` s)
862854-- @
863855(-|-) ::
864− ( CountableDimsN b d,
865− FLN b b,
866− FLN d b,
867− FLN b d,
868− FLN d d
856+ ( CountableDimensionsN b d,
857+ FromListsN b b,
858+ FromListsN d b,
859+ FromListsN b d,
860+ FromListsN d d
869861 )
870862 => Relation a b -> Relation c d -> Relation (Either a c) (Either b d)
871863(-|-) (R a) (R b) = R ((I.-|-) a b)
@@ -878,20 +870,20 @@ infixl 5 -|-
878870-- 'trans'/'untrans';
879871-- more-over, where each particular attribute is placed (input/output) is irrelevant.
880872trans ::
881− ( CountableDimsN a b,
873+ ( CountableDimensionsN a b,
882874 CountableN c,
883− CountableDimsN (a, b) (c, b),
884− FLN (c, b) c,
885− FLN (c, b) b,
886− FLN (a, b) a,
887− FLN (a, b) b,
875+ CountableDimensionsN (a, b) (c, b),
876+ FromListsN (c, b) c,
877+ FromListsN (c, b) b,
878+ FromListsN (a, b) a,
879+ FromListsN (a, b) b,
888880 Trivial (a, b),
889881 Trivial (c, b),
890882 TrivialP a b,
891883 TrivialP c b
892884 )
893885 => Relation (a, b) c -> Relation a (c, b)
894−trans r = splitR r sndR . conv fstR
886+trans r = splitR r sndR `comp` conv fstR
895887
896888-- | Relational 'untrans'
897889--
@@ -899,110 +891,107 @@ trans r = splitR r sndR . conv fstR
899891-- 'trans'/'untrans';
900892-- more-over, where each particular attribute is placed (input/output) is irrelevant.
901893untrans ::
902− ( CountableDimsN a b,
894+ ( CountableDimensionsN a b,
903895 CountableN c,
904− CountableDimsN (a, b) (c, b),
905− FLN (c, b) c,
906− FLN (c, b) b,
907− FLN (a, b) b,
908− FLN (a, b) a,
896+ CountableDimensionsN (a, b) (c, b),
897+ FromListsN (c, b) c,
898+ FromListsN (c, b) b,
899+ FromListsN (a, b) b,
900+ FromListsN (a, b) a,
909901 Trivial (a, b),
910902 Trivial (c, b),
911903 TrivialP a b,
912904 TrivialP c b
913905 )
914906 => Relation a (c, b) -> Relation (a, b) c
915−untrans s = fstR . conv (splitR (conv s) sndR)
907+untrans s = fstR `comp` conv (splitR (conv s) sndR)
916908
917909-- | Transforms predicate @p@ into a correflexive relation.
918910--
919911-- @
920−-- 'predR' ('const' True) == 'id'
912+-- 'predR' ('const' True) == 'iden'
921913-- 'predR' ('const' False) == 'zeros'
922914-- @
923915--
924916-- @
925−-- 'predR' q `.` 'predR' p == 'predR' q ``union`` 'predR' p
917+-- 'predR' q ``comp`` 'predR' p == 'predR' q ``union`` 'predR' p
926918-- @
927919predR ::
928920 ( Bounded a,
929921 Enum a,
930− Countable a,
931922 CountableN a,
932− FLN a a,
933− FLN Bool a
923+ FromListsN a a,
924+ FromListsN Bool a
934925 )
935926 => Relation a Bool -> Relation a a
936−predR p = id `intersection` divisionF (fromF (const True)) p
927+predR p = iden `intersection` divisionF (fromF (const True)) p
937928
938929-- | Equalizes functions @f@ and @g@.
939930-- That is, @'equalizer' f g@ is the largest coreflexive
940931-- that restricts @g@ so that @f@ and @g@ yield the same outputs.
941932--
942933-- @
943−-- 'equalizer' r r == 'id'
934+-- 'equalizer' r r == 'iden'
944935-- 'equalizer' ('point' True) ('point' False) == 'zeros'
945936-- @
946937equalizer ::
947938 ( CountableN a,
948− FLN a a
939+ FromListsN a a
949940 )
950941 => Relation a b -> Relation a b -> Relation a a
951−equalizer f g = id `intersection` divisionF f g
942+equalizer f g = iden `intersection` divisionF f g
952943
953944-- | Relational conditional guard.
954945--
955946-- @
956−-- 'guard' p = 'i2' ``overriddenBy`` 'i1' `.` 'predR' p
947+-- 'guard' p = 'i2' ``overriddenBy`` 'i1' ``comp`` 'predR' p
957948-- @
958−guard ::
949+guard ::
959950 ( Bounded b,
960951 Enum b,
961952 CountableN b,
962− Countable b,
963− FLN b b,
964− FLN Bool b
953+ FromListsN b b,
954+ FromListsN Bool b
965955 ) => Relation b Bool -> Relation b (Either b b)
966956guard p = conv (eitherR (predR p) (predR (negate p)))
967957
968958-- | Relational McCarthy's conditional.
969−cond ::
959+cond ::
970960 ( Bounded b,
971961 Enum b,
972− Countable b,
973962 CountableN b,
974− FLN b b,
975− FLN Bool b
976− )
963+ FromListsN b b,
964+ FromListsN Bool b
965+ )
977966 => Relation b Bool -> Relation b c -> Relation b c -> Relation b c
978−cond p r s = eitherR r s . guard p
967+cond p r s = eitherR r s `comp` guard p
979968
980969-- | Relational domain.
981970--
982971-- For injective relations, 'domain' and 'ker'nel coincide,
983−-- since @'ker' r ``sse`` 'id'@ in such situations.
972+-- since @'ker' r ``sse`` 'iden'@ in such situations.
984973domain ::
985974 ( CountableN a,
986− FLN a a
975+ FromListsN a a
987976 ) => Relation a b -> Relation a a
988−domain r = ker r `intersection` id
977+domain r = ker r `intersection` iden
989978
990979-- | Relational range.
991980--
992981-- For functions, 'range' and 'img' (image) coincide,
993−-- since @'img' f ``sse`` id@ for any @f@.
982+-- since @'img' f ``sse`` 'iden'@ for any @f@.
994983range ::
995984 ( CountableN b,
996− FLN b b
985+ FromListsN b b
997986 ) => Relation a b -> Relation b b
998−range r = img r `intersection` id
987+range r = img r `intersection` iden
999988
1000989-- Relation pretty print
1001990
1002991-- | Relation pretty printing
1003−pretty :: (CountableDimsN a b) => Relation a b -> String
992+pretty :: (CountableDimensionsN a b) => Relation a b -> String
1004993pretty (R a) = I.pretty a
1005994
1006995-- | Relation pretty printing
1007−prettyPrint :: (CountableDimsN a b) => Relation a b -> IO ()
996+prettyPrint :: (CountableDimensionsN a b) => Relation a b -> IO ()
1008997prettyPrint (R a) = I.prettyPrint a
src/LAoP/Utils.hs+1−4
@@ -96,10 +96,7 @@ module LAoP.Utils
9696 coerceNat3,
9797
9898 -- * List data type
99− List (..),
100−
101− -- * Category type-class
102− Category(..)
99+ List (..)
103100 )
104101where
105102
src/LAoP/Utils/Internal.hs+2−28
@@ -1,9 +1,9 @@
1−{-# LANGUAGE TypeFamilies #-}
21{-# LANGUAGE DeriveGeneric #-}
32{-# LANGUAGE TypeApplications #-}
43{-# LANGUAGE DataKinds #-}
54{-# LANGUAGE FlexibleInstances #-}
65{-# LANGUAGE GeneralizedNewtypeDeriving #-}
6+{-# LANGUAGE KindSignatures #-}
77{-# LANGUAGE ScopedTypeVariables #-}
88
99module LAoP.Utils.Internal
@@ -19,10 +19,7 @@ module LAoP.Utils.Internal
1919 coerceNat3,
2020
2121 -- * 'List' data type
22− List (..),
23−
24− -- * Category type class
25− Category(..)
22+ List (..)
2623 )
2724where
2825
@@ -33,9 +30,6 @@ import Data.Maybe
3330import GHC.TypeLits
3431import Control.DeepSeq
3532import GHC.Generics
36−import Data.Kind
37−import Prelude hiding (id, (.))
38−import qualified Prelude
3933
4034-- | Wrapper around 'Int's that have a restrictive semantic associated.
4135-- A value of type @'Natural' n m@ can only be instanciated with some 'Int'
@@ -174,23 +168,3 @@ instance
174168 fromEnum (L x) =
175169 let as = [minBound .. maxBound]
176170 in fromMaybe (error "Does not exist") $ elemIndex x (powerset as)
177−
178−-- | Constrained category instance
179−class Category k where
180− type Object k o :: Constraint
181− type Object k o = ()
182− id :: Object k a => k a a
183− (.) :: k b c -> k a b -> k a c
184−
185−{-# RULES
186−"identity/left" forall p .
187− id . p = p
188−"identity/right" forall p .
189− p . id = p
190−"association" forall p q r .
191− (p . q) . r = p . (q . r)
192− #-}
193−
194−instance Category (->) where
195− id = Prelude.id
196− (.) = (Prelude..)
stack-8.8.3.yamldeleted−1
@@ -1 +0,0 @@
1−resolver: lts-15.5
stack.yaml+66−1
@@ -1 +1,66 @@
1−resolver: lts-14.3
1+# This file was automatically generated by 'stack init'
2+#
3+# Some commonly used options have been documented as comments in this file.
4+# For advanced use and comprehensive documentation of the format, please see:
5+# https://docs.haskellstack.org/en/stable/yaml_configuration/
6+
7+# Resolver to choose a 'specific' stackage snapshot or a compiler version.
8+# A snapshot resolver dictates the compiler version and the set of packages
9+# to be used for project dependencies. For example:
10+#
11+# resolver: lts-3.5
12+# resolver: nightly-2015-09-21
13+# resolver: ghc-7.10.2
14+#
15+# The location of a snapshot can be provided as a file or url. Stack assumes
16+# a snapshot provided as a file might change, whereas a url resource does not.
17+#
18+# resolver: ./custom-snapshot.yaml
19+# resolver: https://example.com/snapshots/2018-01-01.yaml
20+resolver: lts-14.18
21+
22+# User packages to be built.
23+# Various formats can be used as shown in the example below.
24+#
25+# packages:
26+# - some-directory
27+# - https://example.com/foo/bar/baz-0.0.2.tar.gz
28+# subdirs:
29+# - auto-update
30+# - wai
31+packages:
32+- .
33+# Dependency packages to be pulled from upstream that are not in the resolver.
34+# These entries can reference officially published versions as well as
35+# forks / in-progress versions pinned to a git hash. For example:
36+#
37+# extra-deps:
38+# - acme-missiles-0.3
39+# - git: https://github.com/commercialhaskell/stack.git
40+# commit: e7b331f14bcffb8367cd58fbfc8b40ec7642100a
41+#
42+# extra-deps: []
43+
44+# Override default flag values for local packages and extra-deps
45+# flags: {}
46+
47+# Extra package databases containing global packages
48+# extra-package-dbs: []
49+
50+# Control whether we use the GHC we find on the path
51+# system-ghc: true
52+#
53+# Require a specific version of stack, using version ranges
54+# require-stack-version: -any # Default
55+# require-stack-version: ">=2.1"
56+#
57+# Override the architecture used by stack, especially useful on Windows
58+# arch: i386
59+# arch: x86_64
60+#
61+# Extra directories used by stack for building
62+# extra-include-dirs: [/path/to/dir]
63+# extra-lib-dirs: [/path/to/dir]
64+#
65+# Allow a newer minor version of GHC than the snapshot specifies
66+# compiler-check: newer-minor
stack.yaml.lock+4−4
@@ -6,7 +6,7 @@
66packages: []
77snapshots:
88- completed:
9− size: 523878
10− url: https://raw.githubusercontent.com/commercialhaskell/stackage-snapshots/master/lts/14/3.yaml
11− sha256: 470c46c27746a48c7c50f829efc0cf00112787a7804ee4ac7a27754658f6d92c
12− original: lts-14.3
9+ size: 524789
10+ url: https://raw.githubusercontent.com/commercialhaskell/stackage-snapshots/master/lts/14/18.yaml
11+ sha256: 646be71223e08234131c6989912e6011e01b9767bc447b6d466a35e14360bdf2
12+ original: lts-14.18
test/Spec.hs+1−7
@@ -1,8 +1,2 @@
1−module Main (main) where
2−
3−import qualified Examples.Readme as RD
4−
51main :: IO ()
6−main = do
7− putStrLn ("Testing if README works" :: String)
8− RD.exec
2+main = putStrLn "Test suite not yet implemented"