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

Axis scale

data AxisScaling n Source #

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

Instances

HasAxisScaling f (AxisScaling n) Source #
Methods axisScaling :: LensLike' f (AxisScaling n) (AxisScaling (N (AxisScaling n))) Source # scaleAspectRatio :: LensLike' f (AxisScaling n) (Maybe (N (AxisScaling n))) Source # scaleMode :: LensLike' f (AxisScaling n) ScaleMode Source # logScale :: LensLike' f (AxisScaling n) LogScale Source # axisExtend :: LensLike' f (AxisScaling n) (Extending (N (AxisScaling n))) Source # boundMin :: LensLike' f (AxisScaling n) (Maybe (N (AxisScaling n))) Source # boundMax :: LensLike' f (AxisScaling n) (Maybe (N (AxisScaling n))) Source # renderSize :: LensLike' f (AxisScaling n) (Maybe (N (AxisScaling n))) Source #
Fractional n => Default (AxisScaling n) Source #
Methods def :: AxisScaling n #
type N (AxisScaling n) Source #
type N (AxisScaling n) = n

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 #
Methods readsPrec :: Int -> ReadS ScaleMode # readList :: ReadS [ScaleMode] # readPrec :: ReadPrec ScaleMode # readListPrec :: ReadPrec [ScaleMode] #
Show ScaleMode Source #
Methods showsPrec :: Int -> ScaleMode -> ShowS # show :: ScaleMode -> String # showList :: [ScaleMode] -> ShowS #

data UniformScaleStrategy Source #

?

Constructors

AutoUniformScale
UnitOnly
ChangeVerticalLimits
ChangeHorizontalLimits

Instances

Read UniformScaleStrategy Source #
Methods readsPrec :: Int -> ReadS UniformScaleStrategy # readList :: ReadS [UniformScaleStrategy] # readPrec :: ReadPrec UniformScaleStrategy # readListPrec :: ReadPrec [UniformScaleStrategy] #
Show UniformScaleStrategy Source #
Methods showsPrec :: Int -> UniformScaleStrategy -> ShowS # show :: UniformScaleStrategy -> String # showList :: [UniformScaleStrategy] -> ShowS #

data Extending n Source #

How much to extend the bounds beyond any inferred bounds.

Constructors

AbsoluteExtend n
RelativeExtend n

Instances

Functor Extending Source #
Methods fmap :: (a -> b) -> Extending a -> Extending b # (<$) :: a -> Extending b -> Extending a #
Eq n => Eq (Extending n) Source #
Methods (==) :: Extending n -> Extending n -> Bool # (/=) :: Extending n -> Extending n -> Bool #
Ord n => Ord (Extending n) Source #
Methods compare :: Extending n -> Extending n -> Ordering # (<) :: Extending n -> Extending n -> Bool # (<=) :: Extending n -> Extending n -> Bool # (>) :: Extending n -> Extending n -> Bool # (>=) :: Extending n -> Extending n -> Bool # max :: Extending n -> Extending n -> Extending n # min :: Extending n -> Extending n -> Extending n #
Show n => Show (Extending n) Source #
Methods showsPrec :: Int -> Extending n -> ShowS # show :: Extending n -> String # showList :: [Extending n] -> ShowS #

noExtend :: Num n => Extending n 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 (N a)) Source #

The way to scale in one direction.

scaleAspectRatio :: Functor f => LensLike' f a (Maybe (N a)) 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 (N a)) 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 (N a)) 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 (N a)) 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 (N a)) Source #

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

Instances

HasAxisScaling f (AxisScaling n) Source #
Methods axisScaling :: LensLike' f (AxisScaling n) (AxisScaling (N (AxisScaling n))) Source # scaleAspectRatio :: LensLike' f (AxisScaling n) (Maybe (N (AxisScaling n))) Source # scaleMode :: LensLike' f (AxisScaling n) ScaleMode Source # logScale :: LensLike' f (AxisScaling n) LogScale Source # axisExtend :: LensLike' f (AxisScaling n) (Extending (N (AxisScaling n))) Source # boundMin :: LensLike' f (AxisScaling n) (Maybe (N (AxisScaling n))) Source # boundMax :: LensLike' f (AxisScaling n) (Maybe (N (AxisScaling n))) Source # renderSize :: LensLike' f (AxisScaling n) (Maybe (N (AxisScaling n))) Source #
(Applicative f, Traversable c) => HasAxisScaling f (Axis b c n) Source #
Methods axisScaling :: LensLike' f (Axis b c n) (AxisScaling (N (Axis b c n))) Source # scaleAspectRatio :: LensLike' f (Axis b c n) (Maybe (N (Axis b c n))) Source # scaleMode :: LensLike' f (Axis b c n) ScaleMode Source # logScale :: LensLike' f (Axis b c n) LogScale Source # axisExtend :: LensLike' f (Axis b c n) (Extending (N (Axis b c n))) Source # boundMin :: LensLike' f (Axis b c n) (Maybe (N (Axis b c n))) Source # boundMax :: LensLike' f (Axis b c n) (Maybe (N (Axis b c n))) Source # renderSize :: LensLike' f (Axis b c n) (Maybe (N (Axis b c n))) Source #
Functor f => HasAxisScaling f (SingleAxis b v n) Source #
Methods axisScaling :: LensLike' f (SingleAxis b v n) (AxisScaling (N (SingleAxis b v n))) Source # scaleAspectRatio :: LensLike' f (SingleAxis b v n) (Maybe (N (SingleAxis b v n))) Source # scaleMode :: LensLike' f (SingleAxis b v n) ScaleMode Source # logScale :: LensLike' f (SingleAxis b v n) LogScale Source # axisExtend :: LensLike' f (SingleAxis b v n) (Extending (N (SingleAxis b v n))) Source # boundMin :: LensLike' f (SingleAxis b v n) (Maybe (N (SingleAxis b v n))) Source # boundMax :: LensLike' f (SingleAxis b v n) (Maybe (N (SingleAxis b v n))) Source # renderSize :: LensLike' f (SingleAxis b v n) (Maybe (N (SingleAxis b v n))) 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 #
Methods (==) :: LogScale -> LogScale -> Bool # (/=) :: LogScale -> LogScale -> Bool #
Show LogScale Source #
Methods showsPrec :: Int -> LogScale -> ShowS # show :: LogScale -> String # showList :: [LogScale] -> ShowS #
Default LogScale Source #
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.

logDeform :: (InSpace v n a, Foldable v, Floating n, Deformable a a) => v LogScale -> a -> a Source #

Deform an object according to the axis scale. Does nothing for linear scales.

Low level calculations

These functions are used by Plots.Axis.Render.

calculateBounds Source #

Arguments

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

Calculating the bounds for an axis.

calculateScaling Source #

Arguments

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

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