ee.Number.clamp
Clamps the value to lie within the range of min to max.
Usage | Returns | Number.clamp(min, max) | Number |
Argument | Type | Details | this: number | Number | |
min | Float | The minimum value to clamp to. |
max | Float | The maximum value to clamp to. |
Examples
Code Editor (JavaScript)
// Numbers within range are unaffected.
print('100 clamped to range [0,255]', ee.Number(100).clamp(0, 255)); // 100
// Numbers greater than max in range are set to max.
print('259 clamped to range [0,255]', ee.Number(259).clamp(0, 255)); // 255
// Numbers less than min in range are set to min.
print('-259 clamped to range [0,255]', ee.Number(-259).clamp(0, 255)); // 0
Python setup
See the
Python Environment page for information on the Python API and using
geemap
for interactive development.
import ee
import geemap.core as geemap
Colab (Python)
# Numbers within range are unaffected.
# 100
print('100 clamped to range [0,255]:', ee.Number(100).clamp(0, 255).getInfo())
# Numbers greater than max in range are set to max.
# 255
print('259 clamped to range [0,255]:', ee.Number(259).clamp(0, 255).getInfo())
# Numbers less than min in range are set to min.
# 0
print('-259 clamped to range [0,255]:', ee.Number(-259).clamp(0, 255).getInfo())
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-09-19 UTC.
[null,null,["Last updated 2024-09-19 UTC."],[[["`Number.clamp()` constrains a number to a specified range, returning the original number if it falls within the range."],["If the number exceeds the maximum value of the range, the function returns the maximum value instead."],["If the number is less than the minimum value of the range, the function returns the minimum value."],["This function is useful for ensuring that numeric values stay within desired bounds."]]],[]]