Copyright	(C) 2015 Christopher Chalmers
License	BSD-style (see the file LICENSE)
Maintainer	Christopher Chalmers
Stability	experimental
Portability	non-portable
Safe Haskell	None
Language	Haskell2010

Plots.Axis.Scale

Contents

Axis scale
- Log scales
Low level calculations

Description

Determine how to scale an axis.

Synopsis

data AxisScaling
data ScaleMode
- = AutoScale
- | NoScale
- | Stretch
- | UniformScale UniformScaleStrategy
data UniformScaleStrategy
data Extending
- = AbsoluteExtend !Double
- | RelativeExtend !Double
noExtend :: Extending
class HasAxisScaling f a where
- axisScaling :: LensLike' f a AxisScaling
- scaleAspectRatio :: Functor f => LensLike' f a (Maybe Double)
- scaleMode :: Functor f => LensLike' f a ScaleMode
- logScale :: Functor f => LensLike' f a LogScale
- axisExtend :: Functor f => LensLike' f a Extending
- boundMin :: Functor f => LensLike' f a (Maybe Double)
- boundMax :: Functor f => LensLike' f a (Maybe Double)
- renderSize :: Functor f => LensLike' f a (Maybe Double)
data LogScale
- = LinearAxis
- | LogAxis
logNumber :: Floating a => LogScale -> a -> a
logPoint :: (Additive v, Floating n) => v LogScale -> Point v n -> Point v n
calculateBounds :: AxisScaling -> Maybe (Double, Double) -> (Double, Double)
calculateScaling :: (HasLinearMap v, Applicative v) => v AxisScaling -> BoundingBox v Double -> (v (Double, Double), Transformation v Double, Transformation v Double)

Axis scale

data AxisScaling Source #

Data type used that concerns everything to do with the size or scale of the axis.

Instances

Default AxisScaling Source #
Instance details Defined in Plots.Axis.Scale Methods def :: AxisScaling #
HasAxisScaling f AxisScaling Source #
Instance details Defined in Plots.Axis.Scale Methods axisScaling :: LensLike' f AxisScaling AxisScaling Source # scaleAspectRatio :: LensLike' f AxisScaling (Maybe Double) Source # scaleMode :: LensLike' f AxisScaling ScaleMode Source # logScale :: LensLike' f AxisScaling LogScale Source # axisExtend :: LensLike' f AxisScaling Extending Source # boundMin :: LensLike' f AxisScaling (Maybe Double) Source # boundMax :: LensLike' f AxisScaling (Maybe Double) Source # renderSize :: LensLike' f AxisScaling (Maybe Double) Source #
type N AxisScaling Source #
Instance details Defined in Plots.Axis.Scale type N AxisScaling = Double

data ScaleMode Source #

How the axis should be scaled when not all dimensions are set.

Constructors

AutoScale
NoScale
Stretch
UniformScale UniformScaleStrategy

Instances

Read ScaleMode Source #
Instance details Defined in Plots.Axis.Scale Methods readsPrec :: Int -> ReadS ScaleMode # readList :: ReadS [ScaleMode] # readPrec :: ReadPrec ScaleMode # readListPrec :: ReadPrec [ScaleMode] #
Show ScaleMode Source #
Instance details Defined in Plots.Axis.Scale Methods showsPrec :: Int -> ScaleMode -> ShowS # show :: ScaleMode -> String # showList :: [ScaleMode] -> ShowS #

data UniformScaleStrategy Source #

?

Constructors

AutoUniformScale
UnitOnly
ChangeVerticalLimits
ChangeHorizontalLimits

Instances

Read UniformScaleStrategy Source #
Instance details Defined in Plots.Axis.Scale Methods readsPrec :: Int -> ReadS UniformScaleStrategy # readList :: ReadS [UniformScaleStrategy] # readPrec :: ReadPrec UniformScaleStrategy # readListPrec :: ReadPrec [UniformScaleStrategy] #
Show UniformScaleStrategy Source #
Instance details Defined in Plots.Axis.Scale Methods showsPrec :: Int -> UniformScaleStrategy -> ShowS # show :: UniformScaleStrategy -> String # showList :: [UniformScaleStrategy] -> ShowS #

data Extending Source #

How much to extend the bounds beyond any inferred bounds.

Constructors

AbsoluteExtend !Double
RelativeExtend !Double

Instances

Eq Extending Source #
Instance details Defined in Plots.Axis.Scale Methods (==) :: Extending -> Extending -> Bool # (/=) :: Extending -> Extending -> Bool #
Ord Extending Source #
Instance details Defined in Plots.Axis.Scale Methods compare :: Extending -> Extending -> Ordering # (<) :: Extending -> Extending -> Bool # (<=) :: Extending -> Extending -> Bool # (>) :: Extending -> Extending -> Bool # (>=) :: Extending -> Extending -> Bool # max :: Extending -> Extending -> Extending # min :: Extending -> Extending -> Extending #
Show Extending Source #
Instance details Defined in Plots.Axis.Scale Methods showsPrec :: Int -> Extending -> ShowS # show :: Extending -> String # showList :: [Extending] -> ShowS #

noExtend :: Extending Source #

Do not extend the axis beyond the inferred bounds.

class HasAxisScaling f a where Source #

Class of things that have an AxisScaling.

Minimal complete definition

axisScaling

Methods

axisScaling :: LensLike' f a AxisScaling Source #

The way to scale in one direction.

scaleAspectRatio :: Functor f => LensLike' f a (Maybe Double) Source #

The ratio relative to other axis. If no ratios are set, the ratio is not enforced. If at least one is set, Nothing ratios are 1.

scaleMode :: Functor f => LensLike' f a ScaleMode Source #

The mode to determine how to scale the bounds in a direction. Choose between AutoScale, NoScale, Stretch or UniformScale.

Default is AutoScale.

logScale :: Functor f => LensLike' f a LogScale Source #

Whether the axis uses LogAxis or LinearAxis.

Default is LinearAxis.

axisExtend :: Functor f => LensLike' f a Extending Source #

How much to extend the bounds over infered bounds. This is ignored if a boundMax or boundMin is set.

boundMin :: Functor f => LensLike' f a (Maybe Double) Source #

The maximum bound the axis. There are helper functions for setting a minimum bound for a specific axis.

xMin :: Lens' (Axis b V2 Double) (Maybe Double)
yMin :: Lens' (Axis b V2 Double) (Maybe Double)

Default is Nothing.

boundMax :: Functor f => LensLike' f a (Maybe Double) Source #

The maximum bound the axis. There are helper functions for setting a maximum bound specific axis.

xMax :: Lens' (Axis b V2 Double) (Maybe Double)
yMax :: Lens' (Axis b V2 Double) (Maybe Double)
rMax :: Lens' (Axis b 'Polar Double) (Maybe Double)

Default is Nothing.

renderSize :: Functor f => LensLike' f a (Maybe Double) Source #

The size of the rendered axis. Default is Just 400.

Instances

HasAxisScaling f AxisScaling Source #
Instance details Defined in Plots.Axis.Scale Methods axisScaling :: LensLike' f AxisScaling AxisScaling Source # scaleAspectRatio :: LensLike' f AxisScaling (Maybe Double) Source # scaleMode :: LensLike' f AxisScaling ScaleMode Source # logScale :: LensLike' f AxisScaling LogScale Source # axisExtend :: LensLike' f AxisScaling Extending Source # boundMin :: LensLike' f AxisScaling (Maybe Double) Source # boundMax :: LensLike' f AxisScaling (Maybe Double) Source # renderSize :: LensLike' f AxisScaling (Maybe Double) Source #
(Applicative f, Traversable c) => HasAxisScaling f (Axis c) Source #
Instance details Defined in Plots.Axis Methods axisScaling :: LensLike' f (Axis c) AxisScaling Source # scaleAspectRatio :: LensLike' f (Axis c) (Maybe Double) Source # scaleMode :: LensLike' f (Axis c) ScaleMode Source # logScale :: LensLike' f (Axis c) LogScale Source # axisExtend :: LensLike' f (Axis c) Extending Source # boundMin :: LensLike' f (Axis c) (Maybe Double) Source # boundMax :: LensLike' f (Axis c) (Maybe Double) Source # renderSize :: LensLike' f (Axis c) (Maybe Double) Source #
Functor f => HasAxisScaling f (SingleAxis v) Source #
Instance details Defined in Plots.Axis Methods axisScaling :: LensLike' f (SingleAxis v) AxisScaling Source # scaleAspectRatio :: LensLike' f (SingleAxis v) (Maybe Double) Source # scaleMode :: LensLike' f (SingleAxis v) ScaleMode Source # logScale :: LensLike' f (SingleAxis v) LogScale Source # axisExtend :: LensLike' f (SingleAxis v) Extending Source # boundMin :: LensLike' f (SingleAxis v) (Maybe Double) Source # boundMax :: LensLike' f (SingleAxis v) (Maybe Double) Source # renderSize :: LensLike' f (SingleAxis v) (Maybe Double) Source #

Log scales

data LogScale Source #

Should the axis be on a logarithmic scale. The Default is LinearAxis.

Constructors

LinearAxis
LogAxis

Instances

Eq LogScale Source #
Instance details Defined in Plots.Axis.Scale Methods (==) :: LogScale -> LogScale -> Bool # (/=) :: LogScale -> LogScale -> Bool #
Show LogScale Source #
Instance details Defined in Plots.Axis.Scale Methods showsPrec :: Int -> LogScale -> ShowS # show :: LogScale -> String # showList :: [LogScale] -> ShowS #
Default LogScale Source #
Instance details Defined in Plots.Axis.Scale Methods def :: LogScale #

logNumber :: Floating a => LogScale -> a -> a Source #

Log the number for LogAxis, do nothing for LinearAxis.

logPoint :: (Additive v, Floating n) => v LogScale -> Point v n -> Point v n Source #

Transform a point according to the axis scale. Does nothing for linear scales.

Low level calculations

These functions are used by Plots.Axis.Render.

calculateBounds Source #

Arguments

:: AxisScaling	Scaling to use for this axis
-> Maybe (Double, Double)	Inferred bounds (from any plots)
-> (Double, Double)	Lower and upper bounds to use for this axis

Calculating the bounds for an axis.

calculateScaling Source #

Arguments

:: (HasLinearMap v, Applicative v)
=> v AxisScaling	axis scaling options
-> BoundingBox v Double	bounding box from the axis plots
-> (v (Double, Double), Transformation v Double, Transformation v Double)

Calculate the scaling for the axis.

The result returns:

The final bounds for the axis
scale to match desired scaleAspectRatio
scale to match desired asSizeSpec