ee.Image.firstNonZero
Selects the first value if it is non-zero, and the second value otherwise 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.firstNonZero(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."],[[["Selects the first image's band value if non-zero, otherwise selects the second image's band value, comparing bands pairwise."],["If one image has a single band, it's compared against all bands of the other image."],["Output bands are named using the longer image's band names, or the first image's if band counts are equal."],["Output pixel type is determined by combining the input pixel types to accommodate all possible values."]]],["The operation compares paired bands from two images, `image1` and `image2`. For each pair, it selects the first non-zero value. If one image has a single band, that band is used against all bands of the other. If band names differ but counts match, they are matched in order. Output bands are named after the longer input or `image1` if lengths are equal, with the output pixel type being a union of input types. The operation returns an `Image`.\n"]]