Fusionne un tableau d'objets raster en un seul nouvel objet raster, avec des options facultatives de rééchantillonnage, de gestion des valeurs nodata, d'équilibrage des couleurs et de traitement parallèle.
Syntaxe
raster ST_MosaicFrom(
raster source[],
cstring chunkTableName,
cstring storageOption DEFAULT '{}',
cstring mosaicOption DEFAULT '{}'
)
Paramètres
| Paramètre | Description |
|---|---|
source |
Les objets raster à fusionner. |
chunkTableName |
Nom de la table de blocs qui stocke le raster de sortie. Doit respecter les conventions de nommage des tables de base de données. |
storageOption |
Chaîne JSON contrôlant le stockage du raster de sortie. Valeur par défaut : '{}'. Consultez la section Options de stockage. |
mosaicOption |
Chaîne JSON contrôlant l'algorithme de mosaïque. Valeur par défaut : '{}'. Consultez la section Options de mosaïque. |
Options de stockage
Le paramètre storageOption accepte les champs JSON suivants.
| Champ | Type | Valeur par défaut | Description |
|---|---|---|---|
chunking |
boolean | Identique aux rasters sources | Indique si le raster de sortie doit être stocké sous forme de blocs. |
chunkdim |
string | Identique aux rasters sources | Dimensions des blocs. Valide uniquement lorsque chunking est défini sur true. Format : (w,h,b). |
interleaving |
string | Identique aux rasters sources | Type d'entrelacement. Valeurs valides : bip (entrelacement par pixel), bil (entrelacement par ligne), bsq (entrelacement par bande), auto (déterminé automatiquement). |
compression |
string | Identique aux rasters sources | Format de compression. Valeurs valides : none, jpeg, zlib, png, lzo, lz4, zstd, snappy, jp2k. |
quality |
integer | Identique aux rasters sources | Qualité de l'image après compression. S'applique uniquement lorsque compression est défini sur jpeg ou jp2k. |
Options de mosaïque
Le paramètre mosaicOption accepte les champs JSON suivants.
| Champ | Type | Valeur par défaut | Description |
|---|---|---|---|
srid |
integer | SRID du raster supérieur gauche | Identifiant du système de référence spatiale (SRID) du raster de sortie. Doit être spécifié conjointement avec cell_size. |
cell_size |
float8[] | Taille de pixel du raster supérieur gauche | Taille des pixels du raster de sortie, au format [cell_size_x, cell_size_y]. Doit être spécifiée conjointement avec srid. |
resample |
text | 'Near' |
Méthode de rééchantillonnage. Valeurs valides : 'Near', 'Average', 'Cubic', 'Bilinear'. |
nodata |
bool | false |
Indique si les valeurs nodata des rasters sources sont traitées comme valides. Si la valeur est true, les pixels ayant des valeurs nodata ne sont pas rééchantillonnés. Si la valeur est false, les pixels ayant des valeurs nodata sont rééchantillonnés. |
nodataValue |
float8 or float8[] | NULL |
Valeur nodata à attribuer au raster de sortie. Définissez une valeur scalaire pour appliquer la même valeur à toutes les bandes, ou un tableau dont la longueur correspond au nombre de bandes. |
color_balance |
bool | false |
Indique s'il faut appliquer un équilibrage des couleurs. |
step |
integer | 0.1 |
Taille du pas utilisée lors de l'équilibrage des couleurs. Valide uniquement lorsque color_balance est défini sur true. Un pas plus grand accélère le traitement mais peut réduire la précision. |
iteration |
integer | 50000 |
Nombre d'itérations d'équilibrage des couleurs. Valide uniquement lorsque color_balance est défini sur true. Davantage d'itérations produisent de meilleurs résultats mais prennent plus de temps. |
parallel |
integer | 1 |
Degré de parallélisme (DOP). Valeurs valides : de 1 à 64. |
Description
La fonction ST_MosaicFrom fusionne plusieurs objets raster en un seul raster de sortie.
Prérequis pour les rasters sources
Tous les rasters sources doivent satisfaire aux conditions suivantes :
Même nombre de bandes.
Tous géoréférencés ou aucun ne l'est. Lorsque tous les rasters sont géoréférencés, les coordonnées mondiales sont utilisées pour l'opération de mosaïque ; les SRID et les paramètres affines peuvent différer d'un raster à l'autre.
Les types de pixels peuvent différer.
Fonctionnement de l'équilibrage des couleurs
La fonction ST_MosaicFrom utilise un équilibrage des couleurs basé sur la correction gamma, appliqué en trois étapes :
Génération d'un plan de couleur global. Tous les rasters sources sont rééchantillonnés et un ajustement polynomial est appliqué pour produire une matrice de pixels globale, qui sert de référence de couleur.
Calcul d'un plan de couleur local. Pour chaque raster source, une interpolation bilinéaire permet de dériver un plan de couleur local qui mappe les couleurs individuelles du raster vers la matrice de pixels globale.
Application de la correction gamma. Pour chaque position de pixel, deux valeurs sont calculées : l'une issue du plan de couleur local et l'autre du plan de couleur global. Le paramètre de correction gamma est ensuite calculé pour aligner les deux valeurs, produisant ainsi une sortie équilibrée en couleurs.
Exemples
Mosaïque de base
INSERT INTO raster_obj
VALUES (
1,
ST_MosaicFrom(
ARRAY(SELECT raster_obj FROM raster_table WHERE id < 10),
'chunk_table_mosaic',
'',
''
)
);
Mosaïque avec SRID et taille de cellule
UPDATE raster_table
SET raster_obj = ST_MosaicFrom(
ARRAY(SELECT raster_obj FROM raster_table WHERE id < 10),
'chunk_table_mosaic',
'',
'{"srid":4326,"cell_size":[0.00002,0.00002]}'
)
WHERE id = 11;
Mosaïque avec gestion des valeurs nodata
INSERT INTO rat_mosaicfrom
VALUES (
110,
ST_MosaicFrom(
ARRAY(SELECT rast FROM rat_mosaicfrom WHERE id < 5),
'rbt_mosaic',
'{"chunking":true,"chunkdim":"(256,256,3)","compression":"jpeg","quality":75,"interleaving":"bsq","celltype":"8bui"}',
'{"resample":"Average","srid":4326,"cell_size":[0.00002,0.00002],"nodata":true,"nodataValue":[255,255,255]}'
)
);
Mosaïque avec parallélisme
INSERT INTO raster_obj
VALUES (
1,
ST_MosaicFrom(
ARRAY(SELECT raster_obj FROM raster_table WHERE id < 10),
'chunk_table_mosaic',
'',
'{"srid":4326,"cell_size":[0.00002,0.00002],"parallel":4}'
)
);
Mosaïque avec équilibrage des couleurs et parallélisme
INSERT INTO raster_obj
VALUES (
1,
ST_MosaicFrom(
ARRAY(SELECT raster_obj FROM raster_table WHERE id < 10),
'chunk_table_mosaic',
'',
'{"srid":4326,"cell_size":[0.00002,0.00002],"color_balance":true,"parallel":4}'
)
);