Desktop Help 10.0 - ST

Definición

ST_Raster crea un objeto tipo ST_Raster.

Sintaxis

Oracle

 sde.st_raster (filename IN VARCHAR2)  sde.st_raster (filename IN VARCHAR2,                 options IN VARCHAR2)  sde.st_raster (data IN ST_PIXELDATA)  sde.st_raster (data IN ST_PIXELDATA,                 options IN VARCHAR2)

PostgreSQL

 st_raster (filename IN TEXT)  st_raster (filename IN TEXT,             options IN TEXT)  st_raster (data IN ST_PIXELDATA)  st_raster (data IN ST_PIXELDATA,             options IN TEXT)

SQL Server

 st_raster (filename IN NVARCHAR,             data IN ST_PIXELDATA,             options IN NVARCHAR)

Parámetros

Parámetro	Descripción
filename	Nombre de la fuente de datos ráster
data	Objeto ST_PixelData predefinido
options	Una lista delimitada por comas entre comillas simples que pueden incluir los siguientes parámetros: align: cambia automáticamente los píxeles de origen por un máximo de una mitad de un ancho o altura de celda de píxeles con la alineación de celda de píxel de ST_Raster; el valor predeterminado es sin cambiar los datos y se produce un error si no se alinean. compression <lz77 \| jpeg \| jp2>: el algoritmo de compresión que se va a aplicar al objeto ST_Raster; el valor predeterminado es sin comprimir los datos. interleave <separar \| contiguas>: esta opción se aplica a objetos ST_Rasters que almacenarán datos de píxel de 8 bits y tres bandas. Especificar una intercalación independiente indica que los datos de píxel se almacenarán en distintas bandas RGB, mientras que si se especifica una intercalación contigua indica que los datos de píxel se almacenarán en una serie contigua de píxeles rojo, verde y azul. recursive: guía al constructor para buscar la carpeta especificada en el argumento de nombre de archivo y en cualquier subcarpeta de archivos de imagen que tienen nombres que coincidan con los criterios de búsqueda. conversion <rgb \| en escala de grises>: cuando se establece en rgb, el parámetro de conversión dirige al constructor 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 el constructor 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>: la calidad de la compresión de la opción ST_Raster para la compresión JPEG o JPEG 2000 variable bitrate <valor>: la tasa de bits para la compresión de JPEG 2000 nodata (r, g, b) \| <valor>: los valores de píxel de la imagen de origen que se convertirán en NoData cuando se introducen en el ST_Raster nocolormap: indica que el mapa de color se quitará de una imagen de origen con mapa de colores de la imagen cuando se introduzca 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 que se creará después de que la imagen de origen se introduzca en el ST_Raster origin (x, y): el origen de referencia de pirámide del ST_Raster skipLevel1: indica que no se creará el primer nivel de la pirámide del ST_Raster tile (anchura,altura): el ancho y la altura de almacenamiento de las teselas del ST_Raster nearest \| bilinear \| bicubic: el algoritmo de interpolación que se utilizará para crear la pirámide del objeto ST_Raster log <nombre de archivo de registro>: el archivo de registro en el que el constructor escribirá los resultados.

Parámetro

Descripción

filename

Nombre de la fuente de datos ráster

data

Objeto ST_PixelData predefinido

options

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

align: cambia automáticamente los píxeles de origen por un máximo de una mitad de un ancho o altura de celda de píxeles con la alineación de celda de píxel de ST_Raster; el valor predeterminado es sin cambiar los datos y se produce un error si no se alinean.
compression <lz77 | jpeg | jp2>: el algoritmo de compresión que se va a aplicar al objeto ST_Raster; el valor predeterminado es sin comprimir los datos.
interleave <separar | contiguas>: esta opción se aplica a objetos ST_Rasters que almacenarán datos de píxel de 8 bits y tres bandas. Especificar una intercalación independiente indica que los datos de píxel se almacenarán en distintas bandas RGB, mientras que si se especifica una intercalación contigua indica que los datos de píxel se almacenarán en una serie contigua de píxeles rojo, verde y azul.
recursive: guía al constructor para buscar la carpeta especificada en el argumento de nombre de archivo y en cualquier subcarpeta de archivos de imagen que tienen nombres que coincidan con los criterios de búsqueda.
conversion <rgb | en escala de grises>: cuando se establece en rgb, el parámetro de conversión dirige al constructor 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 el constructor 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>: la calidad de la compresión de la opción ST_Raster para la compresión JPEG o JPEG 2000 variable
bitrate <valor>: la tasa de bits para la compresión de JPEG 2000
nodata (r, g, b) | <valor>: los valores de píxel de la imagen de origen que se convertirán en NoData cuando se introducen en el ST_Raster
nocolormap: indica que el mapa de color se quitará de una imagen de origen con mapa de colores de la imagen cuando se introduzca 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 que se creará después de que la imagen de origen se introduzca en el ST_Raster
origin (x, y): el origen de referencia de pirámide del ST_Raster
skipLevel1: indica que no se creará el primer nivel de la pirámide del ST_Raster
tile (anchura,altura): el ancho y la altura de almacenamiento de las teselas del ST_Raster
nearest | bilinear | bicubic: el algoritmo de interpolación que se utilizará para crear la pirámide del objeto ST_Raster
log <nombre de archivo de registro>: el archivo de registro en el que el constructor escribirá los resultados.

Ejemplos

Oracle

En este ejemplo se introduce un archivo de imagen GeoTIFF en un objeto ST_Raster llamando explícitamente al constructor del ST_Raster.

INSERT INTO NOVA (image)  VALUES (sde.st_raster('nova.tif','compression=lz77'));

En este ejemplo se copian los valores del objeto ST_Raster desde la tabla de origen denominada mundo en una tabla objetivo denominada nova. En este caso, se llama implícitamente al constructor del ST_Raster mediante la declaración INSERT para crear los objetos ST_Raster en la tabla objetivo.

INSERT INTO NOVA (image) SELECT image  FROM WORLD;

En este ejemplo, se completa un objeto ST_PixelData con los píxeles de un objeto ST_Raster y se introduce en otro objeto ST_Raster.

DECLARE   	  data sde.ST_PixelData; BEGIN   	  SELECT t.image.getPixelData('level=1') INTO DATA FROM NOVA t;   	  INSERT INTO NOVA VALUES (sde.st_raster(data, 'compression=lz77'));      END;       /

PostgreSQL

En este ejemplo se introduce un archivo de imagen GeoTIFF en un objeto ST_Raster llamando explícitamente al constructor del ST_Raster.

INSERT INTO nova (image) VALUES (sde.st_raster('nova.tif','compression=lz77'));

En este ejemplo se copian los valores del objeto ST_Raster desde la tabla de origen denominada mundo en una tabla objetivo denominada nova. En este caso, se llama implícitamente al constructor del ST_Raster mediante la declaración INSERT para crear los objetos ST_Raster en la tabla objetivo.

INSERT INTO nova (image) SELECT image  FROM world;

En este ejemplo, se completa un objeto ST_PixelData con los píxeles de un objeto ST_Raster y se introduce en otro objeto ST_Raster.

DECLARE data st_pixeldata;  BEGIN  		SELECT getPixelData(image, 'level=1')    INTO data    FROM nova;    INSERT into nova    VALUES (sde.st_raster(data,''compression=lz77''));  END;

SQL Server

En este ejemplo se introduce un archivo de imagen GeoTIFF en un objeto ST_Raster llamando explícitamente al constructor del ST_Raster.

 INSERT INTO nova (image)  VALUES (ST_Raster::construct('nova.tif',NULL,'compression=lz77'));

En este ejemplo se copian los valores del objeto ST_Raster desde la tabla de origen denominada mundo en una tabla objetivo denominada nova. En este caso, se llama implícitamente al constructor del ST_Raster mediante la declaración INSERT para crear los objetos ST_Raster en la tabla objetivo.

INSERT INTO nova (image) SELECT image  FROM world;

En este ejemplo, se completa un objeto ST_PixelData con los píxeles de un objeto ST_Raster y se introduce en otro objeto ST_Raster.

DECLARE @data ST_Pixeldata; SET @data = (SELECT image.getPixelData('level=1')  FROM nova);  INSERT INTO nova   VALUES (ST_Raster::construct(NULL, @data, 'compression=lz77')) ;