ee.Image.displacement
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Détermine les déplacements nécessaires pour enregistrer une image par rapport à une image de référence tout en permettant des déformations locales de type "feuille de caoutchouc". Les déplacements sont calculés dans le CRS de l'image de référence, à une échelle dictée par la résolution la plus faible des trois projections suivantes : projection de l'image d'entrée, projection de l'image de référence et projection demandée. Les déplacements sont ensuite transformés dans la projection spécifiée par l'utilisateur pour la sortie.
| Utilisation | Renvoie |
|---|
Image.displacement(referenceImage, maxOffset, projection, patchWidth, stiffness) | Image |
| Argument | Type | Détails |
|---|
ceci : image | Image | Image à enregistrer. |
referenceImage | Image | Image à enregistrer. |
maxOffset | Float | Décalage maximal autorisé en mètres lorsque vous tentez d'aligner les images d'entrée. L'utilisation d'une valeur plus petite peut réduire considérablement le temps de calcul, mais elle doit tout de même être suffisamment grande pour couvrir le déplacement le plus important dans toute la région de l'image. |
projection | Projection, valeur par défaut : null | Projection dans laquelle les valeurs de déplacement doivent être générées. La valeur par défaut est la projection de la première bande de l'image de référence. |
patchWidth | Float, valeur par défaut : null | Taille du patch pour détecter les décalages d'image, en mètres. Cette valeur doit être suffisamment élevée pour capturer la texture, mais aussi pour que les objets ignorables soient petits dans le patch. La valeur par défaut est "null". Si aucune taille de correctif n'est fournie, elle sera déterminée automatiquement. |
stiffness | Float, valeur par défaut : 5 | Applique une contrainte de rigidité à la solution. Les valeurs valides sont comprises entre 0 et 10. La rigidité est utilisée pour le rejet des valeurs aberrantes lors de la détermination des déplacements aux points de grille adjacents. Des valeurs plus élevées rapprochent la solution d'une transformation rigide. Les valeurs plus faibles autorisent une plus grande distorsion ou déformation de l'image lors de l'enregistrement. |
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\u003eThis method calculates the displacements needed to align an image with a reference image, allowing for localized, flexible deformations.\u003c/p\u003e\n"],["\u003cp\u003eDisplacements are determined in the reference image's coordinate system and at a resolution based on the input, reference, and requested projections.\u003c/p\u003e\n"],["\u003cp\u003eUsers can specify a maximum offset for alignment, a projection for outputting displacements, a patch size for offset detection, and a stiffness parameter to control deformation.\u003c/p\u003e\n"],["\u003cp\u003eThe output is an image containing the calculated displacement values, which can be used to warp or transform the input image to match the reference image.\u003c/p\u003e\n"],["\u003cp\u003eUsing a smaller \u003ccode\u003emaxOffset\u003c/code\u003e value can speed up computation but must be sufficient to cover the largest displacement within the image.\u003c/p\u003e\n"]]],[],null,["# ee.Image.displacement\n\nDetermines displacements required to register an image to a reference image while allowing local, rubber sheet deformations. Displacements are computed in the CRS of the reference image, at a scale dictated by the lowest resolution of the following three projections: input image projection, reference image projection, and requested projection. The displacements are then transformed into the user-specified projection for output.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|--------------------------------------------------------------------------------------------------|---------|\n| Image.displacement`(referenceImage, maxOffset, `*projection* `, `*patchWidth* `, `*stiffness*`)` | Image |\n\n| Argument | Type | Details |\n|------------------|---------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| this: `image` | Image | The image to register. |\n| `referenceImage` | Image | The image to register to. |\n| `maxOffset` | Float | The maximum offset allowed when attempting to align the input images, in meters. Using a smaller value can reduce computation time significantly, but it must still be large enough to cover the greatest displacement within the entire image region. |\n| `projection` | Projection, default: null | The projection in which to output displacement values. The default is the projection of the first band of the reference image. |\n| `patchWidth` | Float, default: null | Patch size for detecting image offsets, in meters. This should be set large enough to capture texture, as well as large enough that ignorable objects are small within the patch. Default is null. Patch size will be determined automatically if not provided. |\n| `stiffness` | Float, default: 5 | Enforces a stiffness constraint on the solution. Valid values are in the range \\[0,10\\]. The stiffness is used for outlier rejection when determining displacements at adjacent grid points. Higher values move the solution towards a rigid transformation. Lower values allow more distortion or warping of the image during registration. |"]]
