Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

linear diophantine equations #220

Open
wants to merge 6 commits into
base: master
Choose a base branch
from
Open
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
109 changes: 109 additions & 0 deletions Math/NumberTheory/Diophantine.hs
Original file line number Diff line number Diff line change
@@ -1,8 +1,16 @@
-- Module for Diophantine Equations and related functions

{-# LANGUAGE RecordWildCards, BlockArguments, TypeApplications, PartialTypeSignatures #-}
{-# LANGUAGE DuplicateRecordFields #-}
{-# OPTIONS_GHC -Wno-partial-type-signatures #-}
Copy link
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is it difficult to provide full type signatures?


module Math.NumberTheory.Diophantine
( cornacchiaPrimitive
, cornacchia
, Linear (..)
, LinearSolution (..)
, solveLinear
, runLinearSolution
)
where

Expand All @@ -14,6 +22,9 @@ import Math.NumberTheory.Primes ( factorise
import Math.NumberTheory.Roots ( integerSquareRoot )
import Math.NumberTheory.Utils.FromIntegral

import Control.Monad (guard)
import Data.Euclidean (gcdExt)

-- | See `cornacchiaPrimitive`, this is the internal algorithm implementation
-- | as described at https://en.wikipedia.org/wiki/Cornacchia%27s_algorithm
cornacchiaPrimitive' :: Integer -> Integer -> [(Integer, Integer)]
Expand Down Expand Up @@ -64,3 +75,101 @@ cornacchia d m
where
candidates = map (\sf -> (sf, m `div` (sf * sf))) (squareFactors m)
solve (sf, m') = map (\(x, y) -> (x * sf, y * sf)) (cornacchiaPrimitive d m')

----

-- | A linear diophantine equation `ax + by = c`
-- | where `x` and `y` are unknown
data Linear a = Lin { a,b,c :: a }
Copy link
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This makes a, b and c globally defined functions, stealing them from any other potential usage. Could you please use something more specific and less likely to clash? Same applies to LinearSolution.

Copy link
Author

@BlackCapCoder BlackCapCoder Nov 19, 2022

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

If that is a problem I am more inclined to not have names at all, or something like a_var, or removing Linear all together in favor of function arguments? The current names are what is used in the literature

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I am not as attached to the names in LinearSolution. The only reason I have it rather than returning Maybe (Int -> (Int, Int)) is that runLinearSolution is a very simple function, and applying it is technically lossy

Copy link
Author

@BlackCapCoder BlackCapCoder Nov 19, 2022

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Sorry for the spam.

I am leaning towards just removing Linear. It is only used in one function- the user can create their own data type if they really want it.

On the other hand, I know that Linear has a sensible Semigroup instance, and many analogues of liftA2 f makes sense for it:

-- Basically `liftA2 (+)`
-- (a1+a2)*x + (b1+b2)*y = c1 + c2
--
add (Lin a1 b1 c1) (Lin a2 b2 c2) =
  Lin (a1+a2) (b1+b2) (c1+c2)

I didn't add instances because I didn't want to bloat this PR.

deriving
( Show, Eq, Ord
)

-- | A solution to a linear equation
data LinearSolution a = LS { x,v,y,u :: a }
deriving
( Show, Eq, Ord
)

-- | Produces an unique solution given any
-- | arbitrary number k
runLinearSolution :: _ => LinearSolution b -> b -> (b, b)
Copy link
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Could you please add tests, showing that
a) everything this function returns is a solution,
b) all possible solutions are generated by this function by supplying different k?

Copy link
Author

@BlackCapCoder BlackCapCoder Nov 15, 2022

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There are either no solutions (handled by Maybe), or an infinite number of solutions. I'll add some test cases, but I cannot check it exhaustively

runLinearSolution LS {..} k =
( x + k*v, y - k*u )

solveLinear :: _ => Linear a -> Maybe (LinearSolution a)
solveLinear Lin {..} =
LS {..} <$ guard @Maybe do b /= 0 && q == 0
where
(d, e) = gcdExt a b
(h, q) = divMod c d
f = div (a*e-d) (-b)
(x, y) = (e*h, f*h)
(u, v) = (quot a d, quot b d)

----

-- https://en.wikipedia.org/wiki/Ku%E1%B9%AD%E1%B9%ADaka
--
-- "Find an integer such that it leaves a remainder of 'r1' when
-- divided by 'a' and a remainder of 'r2' when divided by 'b'
--
data Kuṭṭaka i = Kuṭṭaka { r1,a,r2,b :: i }
deriving Show

kuṭṭakaLinear :: _ => Kuṭṭaka i -> Linear i
kuṭṭakaLinear Kuṭṭaka{..}
= Lin {..}
where
c = r2 - r1

----

{-
You are standing on a pogo stick at the surface of a circle of
circumferance C. A distance D away from you is a piece of candy.
Your pogo stick can only jump jumps of some integer length L.
How many hops H does it take to land on the candy?

Examples:
(C=10, D=1, L=2) -> no solution
(C=23, D=3, L=5) -> 19 hops

D = H*L (mod C)
D = H*L - T*C
-}

data Pogo i
= Pogo { l :: i -- Jump length
, d :: i -- Initial distance to the candy
, c :: i } -- Circle circumference
deriving
( Show, Eq, Ord
)

pogoLinear Pogo {l=a, c=b, d=c} =
Lin {..}

solvePogo p@Pogo {..} = do
let l = pogoLinear p
s <- solveLinear l
let (h,_) = runLinearSolution s 0
pure $ mod h c

----

-- i*s1 == i*s2 + o (mod c)
--
-- This is like Pogo, but the piece of candy is also moving
--
data Race a = Race
{ c :: a -- Length of the cycle
, s1 :: a -- Speed itterator 1
, s2 :: a -- Speed itterator 2
, o :: a -- Offset itterator 2
}
deriving Show

raceLinear Race {..} =
Lin { b=c, c=o, a=s1-s2 }