ST_Raster.subset

Définition

La fonction ST_Raster.subset renvoie un sous-ensemble d'un objet ST_Raster.

Syntaxe

Oracle

subset (parameter_list IN VARCHAR2) RETURN ST_RASTER

subset (parameter_list IN VARCHAR2, 
        options IN VARCHAR2) RETURN ST_RASTER

PostgreSQL

subset (raster IN ST_RASTER, 
        parameter_list IN TEXT) RETURN ST_RASTER

subset (raster IN ST_RASTER, 
        parameter_list IN TEXT, 
        options IN TEXT) RETURN ST_RASTER

SQL Server

subset (parameter_list IN NVARCHAR, 
        options IN NVARCHAR) RETURN ST_RASTER

Renvoie

ST_Raster

Paramètres

Paramètre	Description
raster	ST_Raster à partir duquel le sous-ensemble sera généré.
parameter_list	Liste délimitée par des virgules de paramètres compris entre des guillemets simples, parmi lesquels on peut compter les suivants : band <1er numéro de canal>[,<2e numéro de canal>],…,[nième numéro de canal]> -  liste délimitée par des virgules de numéros de séquence des canaux renvoyés. Les données de pixel sont renvoyées dans l'ordre des numéros de séquence des canaux. Si le paramètre n'est pas spécifié, tous les canaux de l'objet ST_Raster sont exportés dans l'ordre séquentiel normal des canaux. window (minx,miny,maxx,maxy) - zone de l'objet ST_Raster exprimée sous la forme de coordonnées en pixels. Le paramètre de fenêtre n'inclut pas le paramètre d'étendue. Vous pouvez utiliser une des méthodes pour définir une zone de sous-ensemble, mais pas les deux. Dans ce cas, une erreur s'affiche. En l'absence de méthode, la zone entière du ST_Raster source est renvoyée. extent (minx,miny,maxx,maxy) - zone de l'objet ST_Raster exprimée sous la forme de coordonnées géographiques. Le paramètre d'étendue n'inclut pas le paramètre de fenêtre. Vous pouvez utiliser une des méthodes pour définir une zone de sous-ensemble, mais pas les deux. Dans ce cas, une erreur s'affiche. En l'absence de méthode, la zone entière de l'objet ST_Raster source est renvoyée.
options	Liste délimitée par des virgules d'options comprises entre des guillemets simples, parmi lesquels on peut compter les suivantes : compression <lz77 | jpeg | jp2> - algorithme de compression à appliquer au ST_Raster, la valeur par défaut étant de ne pas compresser les données. interleave <separate | contiguous> - cette option s'applique aux objets ST_Raster qui stockent des données de pixel 8 bits à trois canaux. Si vous spécifiez un entrelacement distinct, vous indiquez que les données de pixel seront extraites dans des canaux RVB distincts alors qu'en spécifiant un entrelacement contigu, vous indiquez que les pixels de données seront extraits dans une série contigüe de pixels rouges, verts et bleus. conversion <rgb | grayscale> - lorsque la valeur est rgb, le paramètre de conversion indique à la fonction subset qu'elle doit renvoyer un objet ST_Raster coloré monocanal sous la forme d'un objet ST_Raster RVB à trois canaux. Un paramètre de conversion défini sur nuances de gris indique qu'un objet ST_Raster 1 bit noir et blanc doit être renvoyé sous la forme d'un objet ST_Raster 8 bits en nuances de gris. quality <valeur> - qualité de la compression JPEG ou de la compression variable JPEG 2000. bitrate <valeur> - vitesse de transmission pour la compression fixe JPEG 2000. nodata (r,g,b) | <valeur> - valeurs de pixel du ST_Raster renvoyées en tant que nodata. nocolormap – indique que la palette de couleurs ne sera pas renvoyée. edge <valeur>:<tolérance> - supprime les pixels de limite indésirables autour d'un objet ST_Raster, lesquels sont identifiés comme NoData. Le tronçon indique que seuls les pixels compris dans la plage spécifiée seront supprimés, et ce, uniquement du tronçon extérieur du raster. Cela empêche la suppression des pixels de valeur identique dans le raster. level <niveau de pyramide> - niveau de pyramide de l'objet ST_Raster renvoyé, la valeur par défaut étant le niveau de pyramide de base. skipLevel1 – indique que l'objet ST_Raster est renvoyé sans son premier niveau de pyramide. La pyramide commence au deuxième niveau. tile (width,height) – largeur et hauteur de pixel des tuiles de l'objet ST_Raster renvoyé. nearest | bilinear | bicubic – interpolation de pyramide de l'objet ST_Raster renvoyé. log <nom du fichier journal> - le fichier journal capture les résultats de la fonction subset.

Exemples

Dans le premier exemple, la fonction ST_Raster.subset permet de créer une copie d'un objet ST_Raster avec une séquence de canaux inversée.

Dans le deuxième exemple, la sortie de la fonction ST_Raster.subset est utilisée comme une source de données raster pour la fonction ST_Raster.mosaic. Le deuxième niveau de pyramide est extrait de la colonne image de la table world à l'aide de la fonction ST_Raster.subset et est ensuite mosaïqué dans la colonne image de la table valley.

Oracle

1. INSERT INTO VALLEY (image)
   SELECT t.image.subset('band=(3,2,1)')
   FROM VALLEY t
   WHERE t.image.raster_id = 2;

2. UPDATE VALLEY t
   SET image = t.image.mosaic ('select t.image.subset('level=2') 
   FROM WORLD t', 'log=E:\log.txt');

PostgreSQL

1. INSERT INTO valley (image)
   SELECT subset(image,'band=(3,2,1)')
   FROM valley
   WHERE raster_id(image) = 2;

2. UPDATE valley
   SET image = mosaic (image,'select subset(image,'level=2') 
   FROM world', 'log=E:\log.txt');

SQL Server

1. INSERT INTO valley (image)
   SELECT image.subset('band=(3,2,1)',NULL)
   FROM valley
   WHERE image.raster_id = 2;

2. UPDATE valley
   SET image = image.mosaic (NULL, 'select image.subset('level=2',NULL) 
   FROM world', 'log=E:\log.txt');