ee.Image.constant

  • Generates an image where every pixel has the same specified value, creating a constant image.

  • Accepts a number, an array, or a list of numbers/arrays as input to define the constant value for the image pixels.

  • Can create single-band or multi-band images with constant values in each band.

  • Uses ee.Image.constant(value) for construction, where 'value' represents the desired constant.

  • Can be visualized using Map.addLayer() by providing the image and optional visualization parameters.

 Generates an image containing a constant value everywhere.

UsageReturns
ee.Image.constant(value)Image
ArgumentTypeDetails
valueObjectThe value of the pixels in the constant image. Must be a number or an Array or a list of numbers or Arrays.

Examples

Code Editor (JavaScript)

// Create a constant image, where every pixel has bands of the same value.
var image1 = ee.Image.constant(1);
Map.addLayer(image1, null, '1');
// Image (1 band)
// type: Image
// bands: List (1 element)
// 0: "constant", int ∈ [1, 1], EPSG:4326
print(image1);

var image2 = ee.Image(2);
Map.addLayer(image2, null, '2');
// Image (1 band)
// type: Image
// bands: List (1 element)
// 0: "constant", int ∈ [2, 2], EPSG:4326
print(image2);

var π = ee.Image(Math.PI);
Map.addLayer(π, null, 'π');
// Image (1 band)
// type: Image
// bands: List (1 element)
// 0: "constant", double ∈ [3.141592653589793, 3.141592653589793], EPSG:4326
// id: constant
// crs: EPSG:4326
// crs_transform: [1,0,0,0,1,0]
// data_type: double ∈ [3.141592653589793, 3.141592653589793]
print(π);

// Create a multi-band image from a list of constant double integers.
var doubleIntImage = ee.Image.constant([-1.2, 4]);
Map.addLayer(doubleIntImage, null, 'double int');
// Image (2 bands)
// type: Image
// bands: List (2 elements)
// 0: "constant_0", double ∈ [-1.2, -1.2], EPSG:4326
// 1: "constant_1", int ∈ [4, 4], EPSG:4326
print(doubleIntImage);

// Create a multi-band image from a list of constants, using hexadecimal
// notation.
var multiband = ee.Image([0xff, 0x88, 0x00]);
Map.addLayer(multiband, {min: 0, max: 0xff}, 'orange');
// Image (3 bands)
// type: Image
// bands: List (3 elements)
// 0: "constant", int ∈ [255, 255], EPSG:4326
// 1: "constant_1", int ∈ [136, 136], EPSG:4326
// 2: "constant_2", int ∈ [0, 0], EPSG:4326
print(multiband);