Hylograph.Scale.FP

type ScaleModifier d r k = Scale d r k -> Scale d r k

A scale modifier transforms a scale while preserving its type Modifiers form a Semigroup under composition

niceModifier :: forall r k. ScaleModifier Number r k

Modifier that makes the domain nice (rounds to clean values)

clampModifier :: forall d r k. ScaleModifier d r k

Modifier that enables clamping

roundModifier :: forall d r k. ScaleModifier d r k

Modifier that enables rounding

combineModifiers :: forall d r k. Array (ScaleModifier d r k) -> ScaleModifier d r k

Combine multiple modifiers (apply left to right)

combined = combineModifiers [niceModifier, clampModifier, roundModifier]
myScale = linear # combined # domain [...] # range [...]

sample :: forall r. Int -> Scale Number r Continuous -> Array r

Sample a scale at n evenly-spaced points in [0, 1]

Useful for generating color gradients, paths, etc.

-- Generate 256 colors for a gradient
colors = sample 256 viridisColorScale

sampleRange :: forall r. Int -> Number -> Number -> Scale Number r Continuous -> Array r

Sample within a specific range

-- Sample 50 points between 0.2 and 0.8
samples = sampleRange 50 0.2 0.8 scale

sampleWithDomain :: forall r. Int -> Scale Number r Continuous -> Array (Tuple Number r)

Sample and return both domain and range values

-- Get (input, output) pairs
pairs = sampleWithDomain 10 scale

tickPositions :: forall r k. Int -> Scale Number r k -> Array r

Get tick positions as pixel coordinates

-- Get where to draw tick marks
positions = tickPositions 10 xScale

tickLabels :: forall r k. Int -> String -> Scale Number r k -> Array String

Get formatted tick labels

ticksWithLabels :: forall r k. Int -> String -> Scale Number r k -> Array { label :: String, position :: r }

Get ticks with both position and label

-- For rendering axis ticks
tickData = ticksWithLabels 10 ".0f" xScale
-- Returns: [{ position: 0.0, label: "0" }, ...]

blendInterpolators :: Number -> Interpolator String -> Interpolator String -> Interpolator String

Blend two interpolators together

-- 50% viridis, 50% plasma
blended = blendInterpolators 0.5 interpolateViridis interpolatePlasma

reverseInterpolator :: forall a. Interpolator a -> Interpolator a

Reverse an interpolator (1-t instead of t)

reversed = reverseInterpolator interpolateViridis

clampInterpolator :: forall a. Interpolator a -> Interpolator a

Clamp interpolator input to [0, 1]

cycleInterpolator :: forall a. Interpolator a -> Interpolator a

Make an interpolator cycle (values outside [0,1] wrap)

normalize :: Number -> Number -> ContinuousScale

Create a normalizing scale (maps domain to [0, 1])

normalizer = normalize 0.0 100.0
normalizer 50.0  -- Returns 0.5

quantize :: forall a. NonEmptyArray a -> Number -> Number -> Number -> a

Create a quantizing scale (continuous → discrete buckets)

colorBuckets = quantize (NEA.cons' "low" ["medium", "high"])
colorBuckets 0.0 100.0 33.0  -- Returns "low"
colorBuckets 0.0 100.0 66.0  -- Returns "medium"

threshold :: forall a. Array Number -> NonEmptyArray a -> Number -> a

Create a threshold scale with custom breakpoints

rating = threshold [0.0, 60.0, 80.0, 90.0] (NEA.cons' "F" ["D", "C", "B", "A"])
rating 75.0  -- Returns "C"

scaleExtent :: ContinuousScale -> { max :: Number, min :: Number }

Get the extent (min, max) of a scale's output for inputs in [0, 1]

scaleMidpoint :: ContinuousScale -> Number

Get the midpoint of a scale

scaleInRange :: ContinuousScale -> Number -> Boolean

Check if a value is within a scale's output range