make_range

Contents

make_range#

tollan.plot.plotly.make_range(v: Any, pad: float | None = None, pad_frac: float = 0.05) tuple[float, float][source]#

Calculate data range with padding.

Parameters:
  • v (array-like) – Data values to compute range from.

  • pad (float, optional) – Absolute padding to add. If None, uses pad_frac.

  • pad_frac (float, default 0.05) – Fractional padding (fraction of data range). Ignored if pad is given.

Returns:

(min_value - padding, max_value + padding)

Return type:

tuple[float, float]

Raises:

ValueError – If both pad and pad_frac are specified.

Examples

>>> vmin, vmax = make_range([1, 2, 3, 4, 5])
>>> (float(vmin), float(vmax))
(0.8, 5.2)
>>> vmin, vmax = make_range([1, 2, 3, 4, 5], pad=1.0)
>>> (float(vmin), float(vmax))
(0.0, 6.0)