Fusionne un ou plusieurs objets raster source dans un objet raster cible.
Syntaxe
raster ST_MosaicTo(raster raster_obj, raster source[]);Paramètres
| Paramètre | Description |
|---|---|
raster_obj |
Objet raster cible de la fusion. |
source |
Un ou plusieurs objets raster source à fusionner dans raster_obj. |
Notes d'utilisation
Avant d'appeler ST_MosaicTo, vérifiez que les objets raster source et cible satisfont aux exigences suivantes.
Même nombre de bandes : tous les objets raster doivent posséder le même nombre de bandes.
Géoréférencement cohérent : tous les objets raster doivent être géoréférencés, ou aucun ne doit l'être. Si tous sont géoréférencés, l'opération de mosaïque utilise les coordonnées mondiales (coordonnées géographiques).
Même référence spatiale : si les coordonnées mondiales sont utilisées, tous les objets raster doivent partager le même identifiant de système de référence spatiale (SRID) et les mêmes paramètres affines. Les types de pixels peuvent différer.
Configurer le comportement des valeurs NoData
Définissez ganos.raster.mosaic_must_same_nodata pour contrôler la gestion des valeurs NoData par l'opération de mosaïque sur les objets raster source. Les valeurs NoData restent inchangées pendant l'opération.
| Valeur | Comportement |
|---|---|
true |
Tous les objets raster source doivent avoir la même valeur NoData. |
false |
Les objets raster source peuvent avoir des valeurs NoData différentes. La sémantique des pixels peut changer après l'opération de mosaïque. |
Pour définir ce paramètre, exécutez :
Set ganos.raster.mosaic_must_same_nodata = false;Exemple
L'exemple suivant fusionne tous les objets raster dont id < 10 dans l'objet raster où id = 11.
Update raster_table Set raster_obj = ST_MosaicTo(raster_obj, Array(select raster_obj from raster_table where id < 10)) where id = 11;