Copyright	(c) 2018 Cedric Liegeois
License	BSD3
Maintainer	Cedric Liegeois <ofmooseandmen@yahoo.fr>
Stability	experimental
Portability	portable
Safe Haskell	Safe
Language	Haskell2010

Data.Geo.Jord.Angle

Contents

The Angle type
Smart constructors
Calculations
Trigonometric functions
Accessors
Conversions
Read

Description

Types and functions for working with angles representing latitudes, longitude and bearings.

Synopsis

data Angle
decimalDegrees :: Double -> Angle
dms :: Int -> Int -> Int -> Int -> Angle
dmsE :: Int -> Int -> Int -> Int -> Either String Angle
dmsF :: MonadFail m => Int -> Int -> Int -> Int -> m Angle
radians :: Double -> Angle
arcLength :: Angle -> Length -> Length
central :: Length -> Length -> Angle
isNegative :: Angle -> Bool
isWithin :: Angle -> Angle -> Angle -> Bool
negate' :: Angle -> Angle
normalise :: Angle -> Angle -> Angle
asin' :: Double -> Angle
atan2' :: Double -> Double -> Angle
cos' :: Angle -> Double
sin' :: Angle -> Double
getDegrees :: Angle -> Int
getMinutes :: Angle -> Int
getSeconds :: Angle -> Int
getMilliseconds :: Angle -> Int
toDecimalDegrees :: Angle -> Double
toRadians :: Angle -> Double
angle :: ReadP Angle
readAngle :: String -> Angle
readAngleE :: String -> Either String Angle
readAngleF :: MonadFail m => String -> m Angle

The `Angle` type

data Angle Source #

An angle with a resolution of a milliseconds of a degree. When used as a latitude/longitude this roughly translate to a precision of 30 millimetres at the equator.

Instances

Eq Angle Source #
Instance details Defined in Data.Geo.Jord.Angle Methods (==) :: Angle -> Angle -> Bool # (/=) :: Angle -> Angle -> Bool #
Read Angle Source #	See `readAngle`.
Instance details Defined in Data.Geo.Jord.Angle Methods readsPrec :: Int -> ReadS Angle # readList :: ReadS [Angle] # readPrec :: ReadPrec Angle # readListPrec :: ReadPrec [Angle] #
Show Angle Source #	Angle is shown degrees, minutes, seconds and milliseconds - e.g. 154°25'43.5".
Instance details Defined in Data.Geo.Jord.Angle Methods showsPrec :: Int -> Angle -> ShowS # show :: Angle -> String # showList :: [Angle] -> ShowS #
Quantity Angle Source #	Add/Subtract `Angle`s.
Instance details Defined in Data.Geo.Jord.Angle Methods add :: Angle -> Angle -> Angle Source # sub :: Angle -> Angle -> Angle Source # zero :: Angle Source #
NTransform a => IsGreatCircle (a, Angle) Source #	`GreatCircle` passing by the given position and heading on given bearing. greatCircle (readLatLong "283321N0290700W", decimalDegrees 33.0)
Instance details Defined in Data.Geo.Jord.Geodetics Methods greatCircle :: (a, Angle) -> GreatCircle Source # greatCircleE :: (a, Angle) -> Either String GreatCircle Source # greatCircleF :: MonadFail m => (a, Angle) -> m GreatCircle Source #

Smart constructors

decimalDegrees :: Double -> Angle Source #

Angle from given decimal degrees. Any Double is accepted: it must be validated by the call site when used to represent a latitude or longitude.

dms :: Int -> Int -> Int -> Int -> Angle Source #

Angle from the given degrees, minutes, seconds and milliseconds. errors if given minutes, seconds and/or milliseconds are invalid. Degrees are not validated and can be any Int: they must be validated by the call site when used to represent a latitude or longitude.

dmsE :: Int -> Int -> Int -> Int -> Either String Angle Source #

Angle from the given degrees, minutes, seconds and milliseconds. A Left indicates that given minutes, seconds and/or milliseconds are invalid. Degrees are not validated and can be any Int: they must be validated by the call site when used to represent a latitude or longitude.

dmsF :: MonadFail m => Int -> Int -> Int -> Int -> m Angle Source #

Angle from the given degrees, minutes, seconds and milliseconds. fails if given minutes, seconds and/or milliseconds are invalid. Degrees are not validated and can be any Int: they must be validated by the call site when used to represent a latitude or longitude.

radians :: Double -> Angle Source #

Angle from the given radians.