Reanimate.GeoProjection

This module provides functions for mapping the surface of a sphere on to a 2D plane. It also has convenience functions for loading GeoJSON data.

Documentation

data Projection

Projections are named bi-directional mappings between a sphere and a 2D plane.

Constructors

Projection

Fields

• projectionLabel :: String

  Name of the projection.

• projectionForward :: !(LonLat -> XYCoord)

  Mapping from longitude and latitude on a sphere to XY coordinates on a 2D plane.

• projectionInverse :: !(XYCoord -> LonLat)

  Mapping from XY coordinates on a 2D plane to longitude and latitude on a sphere.

data XYCoord

XY coordinates on a 2D plane. Valid ranges go from 0 to 1, inclusive.

Constructors

XYCoord !Double !Double

Instances

Eq XYCoord

Defined in Reanimate.GeoProjection

Methods

(==) :: XYCoord -> XYCoord -> Bool

(/=) :: XYCoord -> XYCoord -> Bool

Ord XYCoord

Defined in Reanimate.GeoProjection

Methods

compare :: XYCoord -> XYCoord -> Ordering

(<) :: XYCoord -> XYCoord -> Bool

(<=) :: XYCoord -> XYCoord -> Bool

(>) :: XYCoord -> XYCoord -> Bool

(>=) :: XYCoord -> XYCoord -> Bool

max :: XYCoord -> XYCoord -> XYCoord

min :: XYCoord -> XYCoord -> XYCoord

Read XYCoord

Defined in Reanimate.GeoProjection

Methods

readsPrec :: Int -> ReadS XYCoord

readList :: ReadS [XYCoord]

readPrec :: ReadPrec XYCoord

readListPrec :: ReadPrec [XYCoord]

Show XYCoord

Defined in Reanimate.GeoProjection

Methods

showsPrec :: Int -> XYCoord -> ShowS

show :: XYCoord -> String

showList :: [XYCoord] -> ShowS

data LonLat

Longitude and latitude. Valid range for longitude is -pi to +pi. Valid range for latitude is -pi2 to +pi2.

Constructors

LonLat !Double !Double

Instances

Eq LonLat

Defined in Reanimate.GeoProjection

Methods

(==) :: LonLat -> LonLat -> Bool

(/=) :: LonLat -> LonLat -> Bool

Ord LonLat

Defined in Reanimate.GeoProjection

Methods

compare :: LonLat -> LonLat -> Ordering

(<) :: LonLat -> LonLat -> Bool

(<=) :: LonLat -> LonLat -> Bool

(>) :: LonLat -> LonLat -> Bool

(>=) :: LonLat -> LonLat -> Bool

max :: LonLat -> LonLat -> LonLat

min :: LonLat -> LonLat -> LonLat

Read LonLat

Defined in Reanimate.GeoProjection

Methods

readsPrec :: Int -> ReadS LonLat

readList :: ReadS [LonLat]

readPrec :: ReadPrec LonLat

readListPrec :: ReadPrec [LonLat]

Show LonLat

Defined in Reanimate.GeoProjection

Methods

showsPrec :: Int -> LonLat -> ShowS

show :: LonLat -> String

showList :: [LonLat] -> ShowS

Hashable LonLat

Defined in Reanimate.GeoProjection

Methods

hashWithSalt :: Int -> LonLat -> Int

hash :: LonLat -> Int

project :: Image PixelRGBA8 -> Projection -> Image PixelRGBA8

Apply on an image in equirectangular format. The source image therfore must have an aspect ratio of 2:1.

interpP :: Image PixelRGBA8 -> Projection -> Projection -> Double -> Image PixelRGBA8

Interpolate between two projections and apply the result to an image in equirectangular format. The source image must have an aspect ratio of 2:1.

interpBBP :: Image PixelRGBA8 -> Projection -> Projection -> (Double, Double, Double, Double) -> (Double, Double, Double, Double) -> Double -> Image PixelRGBA8

Interpolate between two projections and apply the result to an image in equirectangular format. The source image must have an aspect ratio of 2:1. Only the areas inside of the two bounding boxes (applying to the source and target projection, respectively) are mapped. Pixels outside of these bounding-boxes are undefined.

mergeP :: Projection -> Projection -> Double -> Projection

Attempt to smoothly interpolate two projections. The result may not be continuous and interpP may give prettier results.

isValidP :: Projection -> Bool

Returns True iff a projection is consistent and complete.

scaleP :: Double -> Double -> Projection -> Projection

Scale X and Y axis of projection.

flipYAxisP :: Projection -> Projection

Invert the Y axis of projection.

moveBottomP :: Double -> Projection -> Projection

Translate the lower-most point of a projection by an offset.

moveTopP :: Double -> Projection -> Projection

Translate the top-most point of a projection by an offset.

Projections

equirectangularP :: Projection

mercatorP :: Projection

mollweideP :: Projection

hammerP :: Projection

cylindricalEqualAreaP :: Double -> Projection

lambertP :: Projection

bottomleyP :: Double -> Projection

sinusoidalP :: Projection

wernerP :: Projection

bonneP :: Double -> Projection

orthoP :: LonLat -> Projection

cassiniP :: Projection

augustP :: Projection

collignonP :: Projection

eckert1P :: Projection

eckert3P :: Projection

eckert5P :: Projection

faheyP :: Projection

foucautP :: Projection

lagrangeP :: Projection

GeoJSON helpers

drawFeatureCollection :: GeoFeatureCollection a -> (a -> SVG -> SVG) -> SVG

Map for all features and render the geometry.

loadFeatureCollection :: FromJSON a => FilePath -> (a -> SVG -> SVG) -> SVG

Load GeoJSON from a filepath and render the geometry.

applyProjection :: Projection -> SVG -> SVG

Apply a projection to an SVG image. This is a lossy transformation but the default tolerance is low enough that inaccuracies should not be visible.

applyProjection' :: Double -> Projection -> SVG -> SVG

Apply a projection to an SVG image with a specified tolerance. Projections may turn straight lines into disjointed curves and the tolerance argument determined the accuracy of this transformation.

renderGeometry :: GeospatialGeometry -> SVG

Render GeoJSON geometry as SVG.