ST_Raster.mosaic

Definición

La función de mosaico ST_Raster. fusiona la imagen o imágenes de entrada con un objeto ST_Raster. Esta función está destinada solo a las declaraciones UPDATE. Se devolverá un error de la base de datos cuando se utilicen en una declaración SELECT.

La función ST_Raster.mosaic se ejecuta dentro de una única transacción, por lo que debe tenerse en cuenta la cantidad de rásteres de origen con los que se creará un mosaico en una sola vez, con respecto a la cantidad de espacio de reversión disponible para alojar la transacción pendiente.

Cuando la fuente de datos ráster esté en una unidad de red, debe concederse al propietario del proceso de la base de datos actual el permiso de acceso al archivo correspondiente.

Sintaxis

Oracle

mosaic (filename IN VARCHAR2) RETURN ST_RASTER  mosaic (filename IN VARCHAR2,          parameter_list IN VARCHAR2) RETURN ST_RASTER  mosaic (data IN ST_PIXELDATA) RETURN ST_RASTER  mosaic (data IN ST_PIXELDATA,          parameter_list IN VARCHAR2) RETURN ST_RASTER

PostgreSQL

 mosaic (raster IN ST_RASTER,          filename IN TEXT) RETURN ST_RASTER  mosaic (raster IN ST_RASTER,          filename IN TEXT,          parameter_list IN TEXT) RETURN ST_RASTER  mosaic (raster IN ST_RASTER,          data IN ST_PIXELDATA) RETURN ST_RASTER  mosaic (raster IN ST_RASTER,          data IN ST_PIXELDATA,          parameter_list IN TEXT) RETURN ST_RASTER

SQL Server

 mosaic (filename IN NVARCHAR,          data IN ST_PIXELDATA,          parameter_list IN NVARCHAR) RETURN ST_RASTER

Devuelve

ST_Raster

Parámetros

Parámetro

Descripción

filename

Nombre o nombres de archivo de la fuente de datos ráster

El nombre de archivo puede contener caracteres comodín del sistema operativo. O podría ser una declaración SQL SELECT que selecciona una única columna ST_Raster en una tabla definida por el usuario. El formato de archivo de imagen admitido es GeoTIFF.

data

Objeto ST_PixelData predefinido

raster

Valor objetivo de ST_Raster donde se creará un mosaico de la imagen designada

parameter_list

Una lista delimitada por comas de parámetros entre comillas simples que pueden incluir los siguientes parámetros:

  • align: realizan la alineación extendida del ráster de origen al ST_Raster objetivo.
  • recursive: si se proporciona un argumento comodín como la ruta de los datos de origen, busque en todas las subcarpetas de manera recursiva en la carpeta de nivel superior proporcionada.
  • conversion <rgb | en escala de grises>: cuando se establece en rgb, el parámetro de conversión dirige la función de mosaico para convertir imágenes de origen de banda única con mapa de color en un objeto ST_Raster de tres bandas RGB. Un parámetro de conversión establecido en escala de grises indica que la función de mosaico debe convertir imágenes de origen de 1 bit en blanco y negro en un objeto ST_Raster de 8 bits en escala de grises.
  • quality <valor>: si el tipo de compresión de la capa base es JPEG o JPEG 2000, la calidad de la compresión de la pirámide estará controlada por la configuración de este parámetro. El valor predeterminado para la compresión JPEG es 75, mientras que el valor predeterminado para la compresión JPEG 2000 es 0.
  • bitrate <valor>: la tasa de bits para la compresión fija de JPEG 2000
  • nodata (r, g, b) | <valor>: valores de píxel de la imagen de origen que se convierten en NoData cuando se crea un mosaico en el ST_Raster
  • nocolormap: indica que el mapa de color se quitará de una imagen de origen con mapa de color cuando se crea un mosaico en ST_Raster
  • edge <valor>:<tolerancia>: elimina los píxeles de límite no deseados en un ST_Raster que están marcados como NoData; edge indica que solo los píxeles dentro del rango de valores especificado se eliminarán y que solo lo harán desde el borde externo del ráster. Esto evita que se eliminen los píxeles del mismo valor dentro del ráster.
  • level <nivel de pirámide>: el nivel de pirámide máximo del ST_Raster que existirá después que se cree un mosaico de la imagen de origen en ST_Raster
  • skipLevel1: hace que la función no almacene el primer nivel de pirámide
  • nearest | bilinear | bicubic: el algoritmo de interpolación utilizado para construir la pirámide; el valor predeterminado es nearest
  • log <nombre de archivo de registro>: el archivo de registro captura los resultados de la función de mosaico cuando crea mosaicos de los datos de origen.
  • erase: permite eliminar el modo de mosaico; para cualquier entrada NoData, quita los datos de píxel correspondientes del ráster resultante.

Ejemplos

Estos ejemplos ilustran lo siguiente:

  1. Crear un mosaico de todos los TIFF en la ruta E: \data y todas las subcarpetas para un objeto ST_Raster existente. Los resultados de la función de mosaico se escriben en el archivo de registro E:\'log.txt'.
  2. Rellenar un objeto ST_PixelData con los píxeles de un objeto ST_Raster y, a continuación, crear un mosaico de él en otro objeto ST_Raster.

Oracle

  1. UPDATE SAT t SET image = t.image.mosaic('E:\data\*.tif',                            'recursive,log=E:\log.txt');
  2. DECLARE   	  data sde.ST_PIXELDATA;  BEGIN   	  SELECT t.image.getPixelData('level=1')       INTO DATA       FROM SAT t;    	  UPDATE SAT t 	    SET image = t.image.mosaic(data,'log=E:\log.txt');   END;   /

PostgreSQL

  1. UPDATE sat SET image = mosaic(image,'E:\data\*.tif',                   'recursive,log=E:\log.txt');
  2. DROP FUNCTION IF EXISTS mosaic_from_pixeldata();  CREATE OR REPLACE FUNCTION mosaic_from_pixeldata()  RETURNS integer AS ' DECLARE data sde.st_pixeldata;   BEGIN    	  SELECT getPixelData(image)       INTO data    	  FROM sat;    	  UPDATE sat    	  SET image = mosaic(image,data,''log=E:\log.txt'')    	  WHERE name = ''1_1_data'';  END;'  LANGUAGE plpgsql;        SELECT mosaic_from_pixeldata();  DROP FUNCTION IF EXISTS mosaic_from_pixeldata();

SQL Server

  1. UPDATE sat SET image = image.mosaic('E:\data\*.tif',NULL,                          'recursive,log=E:\log.txt');

  2. DECLARE @data ST_PIXELDATA;  SET @data = (SELECT image.getPixelData('level=1')  FROM sat);  UPDATE sat SET image = image.mosaic(NULL,@data,'log=E:\log.txt');

7/11/2012