| Copyright | (C) 2012-2015 Edward Kmett |
|---|---|
| License | BSD-style (see the file LICENSE) |
| Maintainer | Edward Kmett <ekmett@gmail.com> |
| Stability | experimental |
| Portability | non-portable |
| Safe Haskell | Trustworthy |
| Language | Haskell2010 |
Linear.Plucker
Description
Plücker coordinates for lines in 3d homogeneous space.
Synopsis
- data Plucker a = Plucker !a !a !a !a !a !a
- squaredError :: Num a => Plucker a -> a
- isotropic :: Epsilon a => Plucker a -> Bool
- (><) :: Num a => Plucker a -> Plucker a -> a
- plucker :: Num a => V4 a -> V4 a -> Plucker a
- plucker3D :: Num a => V3 a -> V3 a -> Plucker a
- parallel :: Epsilon a => Plucker a -> Plucker a -> Bool
- intersects :: (Epsilon a, Ord a) => Plucker a -> Plucker a -> Bool
- data LinePass
- passes :: (Epsilon a, Ord a) => Plucker a -> Plucker a -> LinePass
- quadranceToOrigin :: Fractional a => Plucker a -> a
- closestToOrigin :: Fractional a => Plucker a -> V3 a
- isLine :: Epsilon a => Plucker a -> Bool
- coincides :: (Epsilon a, Fractional a) => Plucker a -> Plucker a -> Bool
- coincides' :: (Epsilon a, Fractional a, Ord a) => Plucker a -> Plucker a -> Bool
- p01 :: forall a f. Functor f => (a -> f a) -> Plucker a -> f (Plucker a)
- p02 :: forall a f. Functor f => (a -> f a) -> Plucker a -> f (Plucker a)
- p03 :: forall a f. Functor f => (a -> f a) -> Plucker a -> f (Plucker a)
- p10 :: (Functor f, Num a) => (a -> f a) -> Plucker a -> f (Plucker a)
- p12 :: forall a f. Functor f => (a -> f a) -> Plucker a -> f (Plucker a)
- p13 :: (Functor f, Num a) => (a -> f a) -> Plucker a -> f (Plucker a)
- p20 :: (Functor f, Num a) => (a -> f a) -> Plucker a -> f (Plucker a)
- p21 :: (Functor f, Num a) => (a -> f a) -> Plucker a -> f (Plucker a)
- p23 :: forall a f. Functor f => (a -> f a) -> Plucker a -> f (Plucker a)
- p30 :: (Functor f, Num a) => (a -> f a) -> Plucker a -> f (Plucker a)
- p31 :: forall a f. Functor f => (a -> f a) -> Plucker a -> f (Plucker a)
- p32 :: (Functor f, Num a) => (a -> f a) -> Plucker a -> f (Plucker a)
- e01 :: E Plucker
- e02 :: E Plucker
- e03 :: E Plucker
- e12 :: E Plucker
- e31 :: E Plucker
- e23 :: E Plucker
Documentation
Plücker coordinates for lines in a 3-dimensional space.
Constructors
| Plucker !a !a !a !a !a !a |
Instances
| Representable Plucker Source # | |||||
| MonadFix Plucker Source # | |||||
Defined in Linear.Plucker | |||||
| MonadZip Plucker Source # | |||||
| Foldable Plucker Source # | |||||
Defined in Linear.Plucker Methods fold :: Monoid m => Plucker m -> m foldMap :: Monoid m => (a -> m) -> Plucker a -> m foldMap' :: Monoid m => (a -> m) -> Plucker a -> m foldr :: (a -> b -> b) -> b -> Plucker a -> b foldr' :: (a -> b -> b) -> b -> Plucker a -> b foldl :: (b -> a -> b) -> b -> Plucker a -> b foldl' :: (b -> a -> b) -> b -> Plucker a -> b foldr1 :: (a -> a -> a) -> Plucker a -> a foldl1 :: (a -> a -> a) -> Plucker a -> a elem :: Eq a => a -> Plucker a -> Bool maximum :: Ord a => Plucker a -> a minimum :: Ord a => Plucker a -> a | |||||
| Foldable1 Plucker Source # | |||||
Defined in Linear.Plucker Methods fold1 :: Semigroup m => Plucker m -> m foldMap1 :: Semigroup m => (a -> m) -> Plucker a -> m foldMap1' :: Semigroup m => (a -> m) -> Plucker a -> m toNonEmpty :: Plucker a -> NonEmpty a maximum :: Ord a => Plucker a -> a minimum :: Ord a => Plucker a -> a foldrMap1 :: (a -> b) -> (a -> b -> b) -> Plucker a -> b foldlMap1' :: (a -> b) -> (b -> a -> b) -> Plucker a -> b foldlMap1 :: (a -> b) -> (b -> a -> b) -> Plucker a -> b foldrMap1' :: (a -> b) -> (a -> b -> b) -> Plucker a -> b | |||||
| Eq1 Plucker Source # | |||||
Defined in Linear.Plucker | |||||
| Ord1 Plucker Source # | |||||
Defined in Linear.Plucker Methods liftCompare :: (a -> b -> Ordering) -> Plucker a -> Plucker b -> Ordering | |||||
| Read1 Plucker Source # | |||||
Defined in Linear.Plucker Methods liftReadsPrec :: (Int -> ReadS a) -> ReadS [a] -> Int -> ReadS (Plucker a) liftReadList :: (Int -> ReadS a) -> ReadS [a] -> ReadS [Plucker a] liftReadPrec :: ReadPrec a -> ReadPrec [a] -> ReadPrec (Plucker a) liftReadListPrec :: ReadPrec a -> ReadPrec [a] -> ReadPrec [Plucker a] | |||||
| Show1 Plucker Source # | |||||
Defined in Linear.Plucker Methods liftShowsPrec :: (Int -> a -> ShowS) -> ([a] -> ShowS) -> Int -> Plucker a -> ShowS liftShowList :: (Int -> a -> ShowS) -> ([a] -> ShowS) -> [Plucker a] -> ShowS | |||||
| Traversable Plucker Source # | |||||
| Applicative Plucker Source # | |||||
| Functor Plucker Source # | |||||
| Monad Plucker Source # | |||||
| Serial1 Plucker Source # | |||||
Defined in Linear.Plucker Methods serializeWith :: MonadPut m => (a -> m ()) -> Plucker a -> m () deserializeWith :: MonadGet m => m a -> m (Plucker a) | |||||
| Distributive Plucker Source # | |||||
Defined in Linear.Plucker | |||||
| Affine Plucker Source # | |||||
Defined in Linear.Affine | |||||
| Metric Plucker Source # | |||||
| Trace Plucker Source # | |||||
| Finite Plucker Source # | |||||
| Additive Plucker Source # | |||||
Defined in Linear.Plucker Methods zero :: Num a => Plucker a Source # (^+^) :: Num a => Plucker a -> Plucker a -> Plucker a Source # (^-^) :: Num a => Plucker a -> Plucker a -> Plucker a Source # lerp :: Num a => a -> Plucker a -> Plucker a -> Plucker a Source # liftU2 :: (a -> a -> a) -> Plucker a -> Plucker a -> Plucker a Source # liftI2 :: (a -> b -> c) -> Plucker a -> Plucker b -> Plucker c Source # | |||||
| Apply Plucker Source # | |||||
| Bind Plucker Source # | |||||
| Traversable1 Plucker Source # | |||||
| Generic1 Plucker Source # | |||||
Defined in Linear.Plucker Associated Types
| |||||
| Lift a => Lift (Plucker a :: Type) Source # | |||||
| Unbox a => Vector Vector (Plucker a) Source # | |||||
Defined in Linear.Plucker Methods basicUnsafeFreeze :: Mutable Vector s (Plucker a) -> ST s (Vector (Plucker a)) basicUnsafeThaw :: Vector (Plucker a) -> ST s (Mutable Vector s (Plucker a)) basicLength :: Vector (Plucker a) -> Int basicUnsafeSlice :: Int -> Int -> Vector (Plucker a) -> Vector (Plucker a) basicUnsafeIndexM :: Vector (Plucker a) -> Int -> Box (Plucker a) basicUnsafeCopy :: Mutable Vector s (Plucker a) -> Vector (Plucker a) -> ST s () | |||||
| Unbox a => MVector MVector (Plucker a) Source # | |||||
Defined in Linear.Plucker Methods basicLength :: MVector s (Plucker a) -> Int basicUnsafeSlice :: Int -> Int -> MVector s (Plucker a) -> MVector s (Plucker a) basicOverlaps :: MVector s (Plucker a) -> MVector s (Plucker a) -> Bool basicUnsafeNew :: Int -> ST s (MVector s (Plucker a)) basicInitialize :: MVector s (Plucker a) -> ST s () basicUnsafeReplicate :: Int -> Plucker a -> ST s (MVector s (Plucker a)) basicUnsafeRead :: MVector s (Plucker a) -> Int -> ST s (Plucker a) basicUnsafeWrite :: MVector s (Plucker a) -> Int -> Plucker a -> ST s () basicClear :: MVector s (Plucker a) -> ST s () basicSet :: MVector s (Plucker a) -> Plucker a -> ST s () basicUnsafeCopy :: MVector s (Plucker a) -> MVector s (Plucker a) -> ST s () basicUnsafeMove :: MVector s (Plucker a) -> MVector s (Plucker a) -> ST s () basicUnsafeGrow :: MVector s (Plucker a) -> Int -> ST s (MVector s (Plucker a)) | |||||
| Storable a => Storable (Plucker a) Source # | |||||
Defined in Linear.Plucker Methods peekElemOff :: Ptr (Plucker a) -> Int -> IO (Plucker a) pokeElemOff :: Ptr (Plucker a) -> Int -> Plucker a -> IO () peekByteOff :: Ptr b -> Int -> IO (Plucker a) pokeByteOff :: Ptr b -> Int -> Plucker a -> IO () | |||||
| Monoid a => Monoid (Plucker a) Source # | |||||
| Semigroup a => Semigroup (Plucker a) Source # | |||||
| Floating a => Floating (Plucker a) Source # | |||||
Defined in Linear.Plucker Methods sqrt :: Plucker a -> Plucker a (**) :: Plucker a -> Plucker a -> Plucker a logBase :: Plucker a -> Plucker a -> Plucker a asin :: Plucker a -> Plucker a acos :: Plucker a -> Plucker a atan :: Plucker a -> Plucker a sinh :: Plucker a -> Plucker a cosh :: Plucker a -> Plucker a tanh :: Plucker a -> Plucker a asinh :: Plucker a -> Plucker a acosh :: Plucker a -> Plucker a atanh :: Plucker a -> Plucker a log1p :: Plucker a -> Plucker a expm1 :: Plucker a -> Plucker a | |||||
| Generic (Plucker a) Source # | |||||
Defined in Linear.Plucker Associated Types
| |||||
| Ix a => Ix (Plucker a) Source # | |||||
Defined in Linear.Plucker Methods range :: (Plucker a, Plucker a) -> [Plucker a] index :: (Plucker a, Plucker a) -> Plucker a -> Int unsafeIndex :: (Plucker a, Plucker a) -> Plucker a -> Int inRange :: (Plucker a, Plucker a) -> Plucker a -> Bool rangeSize :: (Plucker a, Plucker a) -> Int unsafeRangeSize :: (Plucker a, Plucker a) -> Int | |||||
| Num a => Num (Plucker a) Source # | |||||
| Read a => Read (Plucker a) Source # | |||||
Defined in Linear.Plucker | |||||
| Fractional a => Fractional (Plucker a) Source # | |||||
Defined in Linear.Plucker | |||||
| Show a => Show (Plucker a) Source # | |||||
| Binary a => Binary (Plucker a) Source # | |||||
| Serial a => Serial (Plucker a) Source # | |||||
Defined in Linear.Plucker | |||||
| Serialize a => Serialize (Plucker a) Source # | |||||
Defined in Linear.Plucker | |||||
| NFData a => NFData (Plucker a) Source # | |||||
Defined in Linear.Plucker | |||||
| Eq a => Eq (Plucker a) Source # | |||||
| Ord a => Ord (Plucker a) Source # | |||||
Defined in Linear.Plucker | |||||
| Hashable a => Hashable (Plucker a) Source # | |||||
Defined in Linear.Plucker | |||||
| Ixed (Plucker a) Source # | |||||
Defined in Linear.Plucker | |||||
| Epsilon a => Epsilon (Plucker a) Source # | |||||
Defined in Linear.Plucker | |||||
| Random a => Random (Plucker a) Source # | |||||
| Uniform a => Uniform (Plucker a) Source # | |||||
Defined in Linear.Plucker | |||||
| UniformRange a => UniformRange (Plucker a) Source # | |||||
Defined in Linear.Plucker | |||||
| Unbox a => Unbox (Plucker a) Source # | |||||
Defined in Linear.Plucker | |||||
| FoldableWithIndex (E Plucker) Plucker Source # | |||||
Defined in Linear.Plucker Methods ifoldMap :: Monoid m => (E Plucker -> a -> m) -> Plucker a -> m ifoldMap' :: Monoid m => (E Plucker -> a -> m) -> Plucker a -> m ifoldr :: (E Plucker -> a -> b -> b) -> b -> Plucker a -> b ifoldl :: (E Plucker -> b -> a -> b) -> b -> Plucker a -> b ifoldr' :: (E Plucker -> a -> b -> b) -> b -> Plucker a -> b ifoldl' :: (E Plucker -> b -> a -> b) -> b -> Plucker a -> b | |||||
| FunctorWithIndex (E Plucker) Plucker Source # | |||||
| TraversableWithIndex (E Plucker) Plucker Source # | |||||
| Each (Plucker a) (Plucker b) a b Source # | |||||
Defined in Linear.Plucker | |||||
| Field1 (Plucker a) (Plucker a) a a Source # | |||||
Defined in Linear.Plucker | |||||
| Field2 (Plucker a) (Plucker a) a a Source # | |||||
Defined in Linear.Plucker | |||||
| Field3 (Plucker a) (Plucker a) a a Source # | |||||
Defined in Linear.Plucker | |||||
| Field4 (Plucker a) (Plucker a) a a Source # | |||||
Defined in Linear.Plucker | |||||
| Field5 (Plucker a) (Plucker a) a a Source # | |||||
Defined in Linear.Plucker | |||||
| Field6 (Plucker a) (Plucker a) a a Source # | |||||
Defined in Linear.Plucker | |||||
| type Rep Plucker Source # | |||||
Defined in Linear.Plucker | |||||
| type Diff Plucker Source # | |||||
Defined in Linear.Affine | |||||
| type Size Plucker Source # | |||||
Defined in Linear.Plucker | |||||
| type Rep1 Plucker Source # | |||||
Defined in Linear.Plucker type Rep1 Plucker = D1 ('MetaData "Plucker" "Linear.Plucker" "linear-1.23.1-4PkpeR6bwxzLkqVghZ3FgL" 'False) (C1 ('MetaCons "Plucker" 'PrefixI 'False) ((S1 ('MetaSel ('Nothing :: Maybe Symbol) 'NoSourceUnpackedness 'SourceStrict 'DecidedStrict) Par1 :*: (S1 ('MetaSel ('Nothing :: Maybe Symbol) 'NoSourceUnpackedness 'SourceStrict 'DecidedStrict) Par1 :*: S1 ('MetaSel ('Nothing :: Maybe Symbol) 'NoSourceUnpackedness 'SourceStrict 'DecidedStrict) Par1)) :*: (S1 ('MetaSel ('Nothing :: Maybe Symbol) 'NoSourceUnpackedness 'SourceStrict 'DecidedStrict) Par1 :*: (S1 ('MetaSel ('Nothing :: Maybe Symbol) 'NoSourceUnpackedness 'SourceStrict 'DecidedStrict) Par1 :*: S1 ('MetaSel ('Nothing :: Maybe Symbol) 'NoSourceUnpackedness 'SourceStrict 'DecidedStrict) Par1)))) | |||||
| data MVector s (Plucker a) Source # | |||||
Defined in Linear.Plucker | |||||
| type Rep (Plucker a) Source # | |||||
Defined in Linear.Plucker type Rep (Plucker a) = D1 ('MetaData "Plucker" "Linear.Plucker" "linear-1.23.1-4PkpeR6bwxzLkqVghZ3FgL" 'False) (C1 ('MetaCons "Plucker" 'PrefixI 'False) ((S1 ('MetaSel ('Nothing :: Maybe Symbol) 'NoSourceUnpackedness 'SourceStrict 'DecidedStrict) (Rec0 a) :*: (S1 ('MetaSel ('Nothing :: Maybe Symbol) 'NoSourceUnpackedness 'SourceStrict 'DecidedStrict) (Rec0 a) :*: S1 ('MetaSel ('Nothing :: Maybe Symbol) 'NoSourceUnpackedness 'SourceStrict 'DecidedStrict) (Rec0 a))) :*: (S1 ('MetaSel ('Nothing :: Maybe Symbol) 'NoSourceUnpackedness 'SourceStrict 'DecidedStrict) (Rec0 a) :*: (S1 ('MetaSel ('Nothing :: Maybe Symbol) 'NoSourceUnpackedness 'SourceStrict 'DecidedStrict) (Rec0 a) :*: S1 ('MetaSel ('Nothing :: Maybe Symbol) 'NoSourceUnpackedness 'SourceStrict 'DecidedStrict) (Rec0 a))))) | |||||
| type Index (Plucker a) Source # | |||||
Defined in Linear.Plucker | |||||
| type IxValue (Plucker a) Source # | |||||
Defined in Linear.Plucker type IxValue (Plucker a) = a | |||||
| data Vector (Plucker a) Source # | |||||
Defined in Linear.Plucker | |||||
squaredError :: Num a => Plucker a -> a Source #
Valid Plücker coordinates p will have squaredError p == 0
That said, floating point makes a mockery of this claim, so you may want to use nearZero.
isotropic :: Epsilon a => Plucker a -> Bool Source #
Checks if the line is near-isotropic (isotropic vectors in this quadratic space represent lines in real 3d space).
(><) :: Num a => Plucker a -> Plucker a -> a infixl 5 Source #
This isn't th actual metric because this bilinear form gives rise to an isotropic quadratic space
plucker :: Num a => V4 a -> V4 a -> Plucker a Source #
Given a pair of points represented by homogeneous coordinates generate Plücker coordinates for the line through them, directed from the second towards the first.
plucker3D :: Num a => V3 a -> V3 a -> Plucker a Source #
Given a pair of 3D points, generate Plücker coordinates for the line through them, directed from the second towards the first.
Operations on lines
intersects :: (Epsilon a, Ord a) => Plucker a -> Plucker a -> Bool Source #
Checks if two lines intersect (or nearly intersect).
Describe how two lines pass each other.
Constructors
| Coplanar | The lines are coplanar (parallel or intersecting). |
| Clockwise | The lines pass each other clockwise (right-handed screw) |
| Counterclockwise | The lines pass each other counterclockwise (left-handed screw). |
Instances
| Generic LinePass Source # | |||||
Defined in Linear.Plucker Associated Types
| |||||
| Show LinePass Source # | |||||
| Eq LinePass Source # | |||||
| type Rep LinePass Source # | |||||
Defined in Linear.Plucker type Rep LinePass = D1 ('MetaData "LinePass" "Linear.Plucker" "linear-1.23.1-4PkpeR6bwxzLkqVghZ3FgL" 'False) (C1 ('MetaCons "Coplanar" 'PrefixI 'False) (U1 :: Type -> Type) :+: (C1 ('MetaCons "Clockwise" 'PrefixI 'False) (U1 :: Type -> Type) :+: C1 ('MetaCons "Counterclockwise" 'PrefixI 'False) (U1 :: Type -> Type))) | |||||
passes :: (Epsilon a, Ord a) => Plucker a -> Plucker a -> LinePass Source #
Check how two lines pass each other. passes l1 l2 describes
l2 when looking down l1.
quadranceToOrigin :: Fractional a => Plucker a -> a Source #
The minimum squared distance of a line from the origin.
closestToOrigin :: Fractional a => Plucker a -> V3 a Source #
The point where a line is closest to the origin.
isLine :: Epsilon a => Plucker a -> Bool Source #
Not all 6-dimensional points correspond to a line in 3D. This predicate tests that a Plücker coordinate lies on the Grassmann manifold, and does indeed represent a 3D line.
coincides :: (Epsilon a, Fractional a) => Plucker a -> Plucker a -> Bool Source #
Checks if two lines coincide in space. In other words, undirected equality.
coincides' :: (Epsilon a, Fractional a, Ord a) => Plucker a -> Plucker a -> Bool Source #
Checks if two lines coincide in space, and have the same orientation.
Basis elements
p10 :: (Functor f, Num a) => (a -> f a) -> Plucker a -> f (Plucker a) Source #
These elements form an alternate basis for the Plücker space, or the Grassmanian manifold Gr(2,V4).
p10::Numa =>Lens'(Pluckera) ap20::Numa =>Lens'(Pluckera) ap30::Numa =>Lens'(Pluckera) ap32::Numa =>Lens'(Pluckera) ap13::Numa =>Lens'(Pluckera) ap21::Numa =>Lens'(Pluckera) a
p13 :: (Functor f, Num a) => (a -> f a) -> Plucker a -> f (Plucker a) Source #
These elements form an alternate basis for the Plücker space, or the Grassmanian manifold Gr(2,V4).
p10::Numa =>Lens'(Pluckera) ap20::Numa =>Lens'(Pluckera) ap30::Numa =>Lens'(Pluckera) ap32::Numa =>Lens'(Pluckera) ap13::Numa =>Lens'(Pluckera) ap21::Numa =>Lens'(Pluckera) a
p20 :: (Functor f, Num a) => (a -> f a) -> Plucker a -> f (Plucker a) Source #
These elements form an alternate basis for the Plücker space, or the Grassmanian manifold Gr(2,V4).
p10::Numa =>Lens'(Pluckera) ap20::Numa =>Lens'(Pluckera) ap30::Numa =>Lens'(Pluckera) ap32::Numa =>Lens'(Pluckera) ap13::Numa =>Lens'(Pluckera) ap21::Numa =>Lens'(Pluckera) a
p21 :: (Functor f, Num a) => (a -> f a) -> Plucker a -> f (Plucker a) Source #
These elements form an alternate basis for the Plücker space, or the Grassmanian manifold Gr(2,V4).
p10::Numa =>Lens'(Pluckera) ap20::Numa =>Lens'(Pluckera) ap30::Numa =>Lens'(Pluckera) ap32::Numa =>Lens'(Pluckera) ap13::Numa =>Lens'(Pluckera) ap21::Numa =>Lens'(Pluckera) a
p30 :: (Functor f, Num a) => (a -> f a) -> Plucker a -> f (Plucker a) Source #
These elements form an alternate basis for the Plücker space, or the Grassmanian manifold Gr(2,V4).
p10::Numa =>Lens'(Pluckera) ap20::Numa =>Lens'(Pluckera) ap30::Numa =>Lens'(Pluckera) ap32::Numa =>Lens'(Pluckera) ap13::Numa =>Lens'(Pluckera) ap21::Numa =>Lens'(Pluckera) a
p32 :: (Functor f, Num a) => (a -> f a) -> Plucker a -> f (Plucker a) Source #
These elements form an alternate basis for the Plücker space, or the Grassmanian manifold Gr(2,V4).
p10::Numa =>Lens'(Pluckera) ap20::Numa =>Lens'(Pluckera) ap30::Numa =>Lens'(Pluckera) ap32::Numa =>Lens'(Pluckera) ap13::Numa =>Lens'(Pluckera) ap21::Numa =>Lens'(Pluckera) a