ST_Raster.getValue

Definición

La función ST_Raster.getValue devuelve el valor de un único píxel dado que la ubicación de píxel se encuentra dentro del objeto ST_Raster. La ubicación se puede especificar en coordenadas de píxel o mediante coordenadas geográficas. La función muestra un error cuando la ubicación especificada se encuentra fuera de la dimensión del píxel de ráster o de la extensión geográfica. ST_Raster.GetValue devuelve NULL si el valor de píxel en la ubicación especificada es NoData.

Sintaxis

Oracle

 getValue (band INTEGER,            level INTEGER,            x INTEGER,            y INTEGER)  getValue (band INTEGER,            level INTEGER,            point SE_COORD)

PostgreSQL

 getValue (raster IN ST_RASTER,            band INT,            level INT,            x INT,            y INT)  getValue (raster IN ST_RASTER,            band INT,            level INT,            point SE_COORD)

SQL Server

 getValue (band IN NUMBER,            level IN NUMBER,            x IN NUMBER,            y IN NUMBER)  getValueByLoc (band IN NUMBER,                 level IN NUMBER,                 x IN DOUBLE,                 y IN DOUBLE)

Devuelve

Oracle

Número

PostgreSQL

Float8

SQL Server

Doble

Parámetros

Parámetro

Descripción

band

Número de banda (a partir de 1) del píxel

level

Nivel de pirámide del píxel

x

Coordenada de píxel x

y

Coordenada de píxel y

point

Coordenadas geográficas del píxel

raster

El objeto ST_Raster que contiene el valor de píxel

Ejemplos

El primer ejemplo devuelve los valores de píxel de la banda 1, 2 y 3 para el nivel de pirámide básico en la ubicación de píxel (0,0).

El segundo ejemplo devuelve los valores de píxel para el nivel de pirámide básico para las bandas 1, 2 y 3 en una ubicación geográfica (100.5, 20.5).

Oracle

  1.  SELECT t.image.getValue(1,0,0,0) r,        t.image.getValue(2,0,0,0) g,        t.image.getValue(3,0,0,0) b FROM VEG t  WHERE t.image.raster_id = 1;           R          G          B ---------- ---------- ----------         83         49        173
  2.  SELECT t.image.getValue(1,0,se_coord(100.5,20.5)) r,        t.image.getValue(2,0,se_coord(100.5,20.5)) g,        t.image.getValue(3,0,se_coord(100.5,20.5)) b FROM VEG t WHERE t.image.raster_id = 1;           R          G          B ---------- ---------- ----------         83         49        173

PostgreSQL

  1.  SELECT getValue(image,1,0,0,0) r,        getValue(image,2,0,0,0) g,        getValue(image,3,0,0,0) b FROM veg  WHERE raster_id(image) = 1;           R          G          B ---------- ---------- ----------         83         49        173
  2.  SELECT getValue(image,1,0,se_coord(100.5,20.5)) r,        getValue(image,2,0,se_coord(100.5,20.5)) g,        getValue(image,3,0,se_coord(100.5,20.5)) b FROM veg  WHERE raster_id(image) = 1;           R          G          B ---------- ---------- ----------         83         49        173

SQL Server

  1.  SELECT image.getValue(1,0,0,0) r,        image.getValue(2,0,0,0) g,        image.getValue(3,0,0,0) b FROM veg  WHERE image.raster_id = 1;           R          G          B ---------- ---------- ----------         83         49        173
  2.  SELECT getValueByLoc(image,1,0,100.5,20.5) as r,        getValueByLoc(image,2,0,100.5,20.5) as g,        getValueByLoc(image,3,0,100.5,20.5) as b FROM veg WHERE image.raster_id = 1;          R          G          B ---------- ---------- ----------         83         49        173

7/11/2012