Tous les produits
Search
Centre de documentation

PolarDB:ST_MosaicFrom

Dernière mise à jour :Oct 10, 2026

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 :

  1. 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.

  2. 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.

  3. 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}'
  )
);