map() - Pine Script Function

map()

Overview

map() performs a linear interpolation that translates value expressed in the [from_min, from_max] range into a number that lies proportionally inside [to_min, to_max]. It is widely used to normalize indicators, convert booleans into numeric levels, or scale price moves to oscillator bounds.

Syntax

map(value, from_min, from_max, to_min, to_max) → series float

Parameters

Name	Type	Description
value	series int/float	The value to convert.
from_min	series int/float	Lower bound of the input range.
from_max	series int/float	Upper bound of the input range. Must differ from from_min.
to_min	series int/float	Lower bound of the target range.
to_max	series int/float	Upper bound of the target range.

Returns

series float — The proportional value within [to_min, to_max].

Remarks

• When from_max == from_min, the function returns na (division by zero).
• If value falls outside the source range, the result can extrapolate beyond [to_min, to_max]. Clamp manually when you need strict bounds.
• Combine with math.min/math.max to enforce bounds after the mapping.

Example

//@version=5
indicator("map() oscillator scaling", overlay=false)

rsiLen = input.int(21, "RSI length")

rsiValue = ta.rsi(close, rsiLen)
normalized = map(rsiValue, 0, 100, -1, 1)

plot(normalized, "Mapped RSI", color=color.teal)
hline(0.0, "Midline", color=color.gray)
bgcolor(math.abs(normalized) > 0.5 ? color.new(color.orange, 85) : na)

See Also

• math
• float()
• int()
• ta