ee.Image.where
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
: effectue un remplacement conditionnel des valeurs.
Pour chaque pixel de chaque bande d 'entrée, si le pixel correspondant dans "test" est différent de zéro, affichez le pixel correspondant dans la valeur. Sinon, affichez le pixel d'entrée.
Si, pour un pixel donné, le test ou la valeur sont masqués, la valeur d'entrée est utilisée. Si l'entrée est masquée, rien n'est fait.
Les bandes de sortie portent les mêmes noms que les bandes d'entrée. Le type de sortie de chaque bande est le plus grand des types d'entrée et de valeur. L'image de sortie conserve les métadonnées et l'empreinte de l'image d'entrée.
| Utilisation | Renvoie |
|---|
Image.where(test, value) | Image |
| Argument | Type | Détails |
|---|
ceci : input | Image | Image d'entrée. |
test | Image | Image de test. Les pixels de cette image déterminent lesquels des pixels d'entrée sont renvoyés. S'il s'agit d'une seule bande, elle est utilisée pour toutes les bandes de l'image d'entrée. Il ne s'agit peut-être pas d'une image matricielle. |
value | Image | Valeur de sortie à utiliser lorsque le test n'est pas nul. S'il s'agit d'une seule bande, elle est utilisée pour toutes les bandes de l'image d'entrée. |
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/26 (UTC).
[null,null,["Dernière mise à jour le 2025/07/26 (UTC)."],[[["\u003cp\u003eReplaces input image pixel values with values from a secondary image based on a test image's pixel values.\u003c/p\u003e\n"],["\u003cp\u003eIf the test image pixel is non-zero, the corresponding pixel from the value image is used; otherwise, the original input pixel is retained.\u003c/p\u003e\n"],["\u003cp\u003eInput image metadata and footprint are preserved in the output image.\u003c/p\u003e\n"],["\u003cp\u003eOutput image band types are determined by the larger type between the input and value images.\u003c/p\u003e\n"],["\u003cp\u003eMasked pixels in either test or value images result in the original input pixel being used in the output.\u003c/p\u003e\n"]]],[],null,["# ee.Image.where\n\nPerforms conditional replacement of values.\n\n\u003cbr /\u003e\n\nFor each pixel in each band of 'input', if the corresponding pixel in 'test' is nonzero, output the corresponding pixel in value, otherwise output the input pixel.\n\nIf at a given pixel, either test or value is masked, the input value is used. If the input is masked, nothing is done.\n\nThe output bands have the same names as the input bands. The output type of each band is the larger of the input and value types. The output image retains the metadata and footprint of the input image.\n\n| Usage | Returns |\n|----------------------------|---------|\n| Image.where`(test, value)` | Image |\n\n| Argument | Type | Details |\n|---------------|-------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| this: `input` | Image | The input image. |\n| `test` | Image | The test image. The pixels of this image determines which of the input pixels is returned. If this is a single band, it is used for all bands in the input image. This may not be an array image. |\n| `value` | Image | The output value to use where test is not zero. If this is a single band, it is used for all bands in the input image. |"]]
