Map

Remaps the specified value from one range to another. This function maps the value of `from low` to the value of `to low`, the value of `from high` to the value of `to high`, and intermediate values to intermediate values.

This function does not constrain values to the ranges, because out-of-range values are sometimes intended and useful. If you need to limit a range, you can use the `Math.clamp` function before or after calling this function.

``pins.map(0, 0, 4, 0, 1023);``

Parameters

• `value`: a number that specifies the value to map
• `fromLow`: a number that specifies the lower bound of the origin interval
• `fromHigh`: a number that specifies the upper bound of the origin interval
• `toLow`: a number that specifies the lower bound of the target interval
• `toHigh`: a number that specifies the upper bound of the target interval

Example

This example maps the value read from the analog pin `P0` to an LED coordinate between `0` and `4`.

``````let value1 = pins.analogReadPin(AnalogPin.P0)
let index = pins.map(value1, 0, 1023, 0, 4)
led.plot(0, index)``````