Announcement: All noncommercial projects registered to use Earth Engine before
April 15, 2025 must
verify noncommercial eligibility to maintain Earth Engine access.
ee.Image.first
Stay organized with collections
Save and categorize content based on your preferences.
Selects the value of the first value for each matched pair of bands in image1 and image2. If either image1 or image2 has only 1 band, then it is used against all the bands in the other image. If the images have the same number of bands, but not the same names, they're used pairwise in the natural order. The output bands are named for the longer of the two inputs, or if they're equal in length, in image1's order. The type of the output pixels is the union of the input types.
| Usage | Returns | Image.first(image2) | Image |
| Argument | Type | Details | this: image1 | Image | The image from which the left operand bands are taken. |
image2 | Image | The image from which the right operand bands are taken. |
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 2023-10-06 UTC.
[null,null,["Last updated 2023-10-06 UTC."],[[["\u003cp\u003eSelects the first value of each matched band pair from two input images, prioritizing the value from the first image (\u003ccode\u003eimage1\u003c/code\u003e).\u003c/p\u003e\n"],["\u003cp\u003eAccommodates images with single or multiple bands, aligning them for pairwise comparison based on band order or name.\u003c/p\u003e\n"],["\u003cp\u003eOutput image bands inherit names from the image with more bands or from \u003ccode\u003eimage1\u003c/code\u003e if band counts are equal, with pixel types reflecting the combined types of input images.\u003c/p\u003e\n"],["\u003cp\u003eThis operation is accessible through the \u003ccode\u003efirst()\u003c/code\u003e method, taking the second image as an argument and returning the resulting image.\u003c/p\u003e\n"]]],[],null,["# ee.Image.first\n\nSelects the value of the first value for each matched pair of bands in image1 and image2. If either image1 or image2 has only 1 band, then it is used against all the bands in the other image. If the images have the same number of bands, but not the same names, they're used pairwise in the natural order. The output bands are named for the longer of the two inputs, or if they're equal in length, in image1's order. The type of the output pixels is the union of the input types.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|-----------------------|---------|\n| Image.first`(image2)` | Image |\n\n| Argument | Type | Details |\n|----------------|-------|---------------------------------------------------------|\n| this: `image1` | Image | The image from which the left operand bands are taken. |\n| `image2` | Image | The image from which the right operand bands are taken. |"]]