ST_Raster.describe

Definition

ST_Raster.describe stellt die Eigenschaftenliste eines ST_Raster-Objekts zur Verfügung. Zu den optionalen Eingabeparametern gehören entweder "storage", wodurch die "describe"-Funktion angewiesen wird, die Speichergröße der einzelnen Bändern nach Pyramidenebene anzuzeigen, oder "color map", was darauf hinweist, dass mit der "describe"-Funktion der Colormap-Index aufgelistet werden soll, falls vorhanden. Die "describe"-Funktion ist allein zur Verwendung als Teil der Auswahlliste einer SQL-SELECT-Anweisung ausgelegt.

Syntax

Oracle

describe () RETURN CLOB
describe (parameter IN VARCHAR2) RETURN CLOB

PostgreSQL

describe (raster IN ST_RASTER) RETURN TEXT
describe (raster IN ST_RASTER, 
          parameter IN TEXT) RETURN TEXT

SQL Server

describe (parameter IN NVARCHAR) RETURN NVARCHAR

Rückgaben

CLOB

Parameter

Wenn kein Parameter angegeben wird, werden mit der "describe"-Funktion grundlegende Eigenschaften des ST_Raster-Objekts angezeigt.

Parameter

Beschreibung

Speicherung

Weist die "describe"-Funktion an, den tatsächlichen komprimierten Speicherversatz für die einzelnen Bänder und Pyramidenebenen des Colormap-ST_Raster-Objekts aufzulisten.

Colormap

Weist die "describe"-Funktion an, den Colormap-Index des Colormap-ST_Raster-Objekts aufzulisten.

Beispiele

In diesen Beispielen wird Folgendes veranschaulicht:

  1. Das erste Beispiel ist eine SELECT-Anweisung und stellt eine Liste mit ST_Raster-Eigenschaften aus der Funktion "ST_Raster.describe()" bereit.
  2. Im nächsten Beispiel wird die Verwendung des "storage"-Parameters mit der Funktion "ST_Raster.describe()" veranschaulicht.
  3. Im letzten Beispiel wird gezeigt, wie die Raster-Colormap-Informationen zurückgegeben werden.

Oracle

  1. SELECT n.image.describe() FROM NOVA n;
    
    Raster ID ...................: 2
    Raster Column ID ............: 268
    Raster Dimension ............: 6000, 6000, 1
    Raster Tile Dimension .......: 128, 128
    Pixel Type ..................: int16
    Compression .................: lz77
    Image Pyramid ...............: 6, bilinear
    Extent ......................: <NONE>
    Statistics ..................:
      min     :              4271.0000000000
      max     :              6751.0000000000
      mean    :              5024.6673817222
      std dev :               272.5172958117
  2. SELECT n.image.describe('storage') FROM NOVA n;
    
    Raster Tile Storage .........:
                 min    max      mean   std dev      count                   total
    Level  0:
      Band  1     61  23802  16818.32   3681.83       2209  36,281 KB
    Level  1:
      Band  1   2506  24028  17958.37   3836.54        576  10,102 KB
    Level  2:
      Band  1   6786  23245  19566.38   2732.57        144   2,752 KB
    Level  3:
      Band  1  16547  23232  20919.81   1736.37         36     735 KB
    Level  4:
      Band  1  19764  23620  21993.11   1271.31          9     193 KB
    Level  5:
      Band  1   5854  23853  13186.50   7596.00          4      52 KB
    Level  6:
      Band  1  13563  13563  13563.00      0.00          1      13 KB
    
                                                                         50,128 KB
    51,330,596 bytes
    Compression Ratio ...........: 1.40267
  3. SELECT n.image.describe('colormap')
    FROM NOVA n
    WHERE n.image.raster_id = 1;
    
    
    Raster ID ...................: 1
    Raster Column ID ............: 329
    Raster Dimension ............: 512, 512, 1
    Raster Tile Dimension .......: 128, 128
    Pixel Type ..................: uint8
    Compression .................: lz77
    Image Pyramid ...............: <NONE>
    Extent ......................: <NONE>
    Colormap ....................: rgb, uint16, 256
      index      red  green   blue
          0    14906      0      0
          1     8738      0      0
          2     5654      0      0
          3     2570      0      0
          4    27242  23901  31868
          5    51143  50886  51400
          6    19018  13878  23644
          7     6168   2056   6168
          8    55512  51400  55512
          9    63736  59624  63736
         10    60138  55512  59624
    
    ...      ...    ...    ...
    
    250    63736  63736  63736
    251    59624  59624  59624
    252    55512  55512  55512
    253     6168   6168   6168
    254     2056   2056   2056
    255    65535  65535  65535

PostgreSQL

  1. SELECT describe(image) FROM nova;
    
    Raster ID ...................: 2
    Raster Column ID ............: 268
    Raster Dimension ............: 6000, 6000, 1
    Raster Tile Dimension .......: 128, 128
    Pixel Type ..................: int16
    Compression .................: lz77
    Image Pyramid ...............: 6, bilinear
    Extent ......................: <NONE>
    Statistics ..................:
      min     :              4271.0000000000
      max     :              6751.0000000000
      mean    :              5024.6673817222
      std dev :               272.5172958117
  2. SELECT describe(image,'storage') FROM nova;
    
    Raster Tile Storage .........:
                 min    max      mean   std dev      count                   total
    Level  0:
      Band  1     61  23802  16818.32   3681.83       2209  36,281 KB
    Level  1:
      Band  1   2506  24028  17958.37   3836.54        576  10,102 KB
    Level  2:
      Band  1   6786  23245  19566.38   2732.57        144   2,752 KB
    Level  3:
      Band  1  16547  23232  20919.81   1736.37         36     735 KB
    Level  4:
      Band  1  19764  23620  21993.11   1271.31          9     193 KB
    Level  5:
      Band  1   5854  23853  13186.50   7596.00          4      52 KB
    Level  6:
      Band  1  13563  13563  13563.00      0.00          1      13 KB
                                                                       50,128 KB
    51,330,596 bytes
    Compression Ratio ...........: 1.40267
  3. SELECT describe(image,'colormap')
    FROM nova
    WHERE image.raster_id = 1;
    
    Raster ID ...................: 1
    Raster Column ID ............: 329
    Raster Dimension ............: 512, 512, 1
    Raster Tile Dimension .......: 128, 128
    Pixel Type ..................: uint8
    Compression .................: lz77
    Image Pyramid ...............: <NONE>
    Extent ......................: <NONE>
    Colormap ....................: rgb, uint16, 256
      index      red  green   blue
          0    14906      0      0
          1     8738      0      0
          2     5654      0      0
          3     2570      0      0
          4    27242  23901  31868
          5    51143  50886  51400
          6    19018  13878  23644
          7     6168   2056   6168
          8    55512  51400  55512
          9    63736  59624  63736
         10    60138  55512  59624
    
    ...      ...    ...    ...
    
    250    63736  63736  63736
    251    59624  59624  59624
    252    55512  55512  55512
    253     6168   6168   6168
    254     2056   2056   2056
    255    65535  65535  65535

SQL Server

  1. SELECT image.describe(NULL) FROM nova;
    
    Raster ID ...................: 2
    Raster Column ID ............: 268
    Raster Dimension ............: 6000, 6000, 1
    Raster Tile Dimension .......: 128, 128
    Pixel Type ..................: int16
    Compression .................: lz77
    Image Pyramid ...............: 6, bilinear
    Extent ......................: <NONE>
    Statistics ..................:
      min     :              4271.0000000000
      max     :              6751.0000000000
      mean    :              5024.6673817222
      std dev :               272.5172958117
  2.  SELECT image.describe('storage') FROM nova;
    
    Raster Tile Storage .........:
                 min    max      mean   std dev      count                   total
    Level  0:
      Band  1     61  23802  16818.32   3681.83       2209  36,281 KB
    Level  1:
      Band  1   2506  24028  17958.37   3836.54        576  10,102 KB
    Level  2:
      Band  1   6786  23245  19566.38   2732.57        144   2,752 KB
    Level  3:
      Band  1  16547  23232  20919.81   1736.37         36     735 KB
    Level  4:
      Band  1  19764  23620  21993.11   1271.31          9     193 KB
    Level  5:
      Band  1   5854  23853  13186.50   7596.00          4      52 KB
    Level  6:
      Band  1  13563  13563  13563.00      0.00          1      13 KB
                                                                       50,128 KB
    51,330,596 bytes
    Compression Ratio ...........: 1.40267
  3. SELECT image.describe('colormap')
    FROM nova
    WHERE image.raster_id = 1;
    
    Raster ID ...................: 1
    Raster Column ID ............: 329
    Raster Dimension ............: 512, 512, 1
    Raster Tile Dimension .......: 128, 128
    Pixel Type ..................: uint8
    Compression .................: lz77
    Image Pyramid ...............: <NONE>
    Extent ......................: <NONE>
    Colormap ....................: rgb, uint16, 256
      index      red  green   blue
          0    14906      0      0
          1     8738      0      0
          2     5654      0      0
          3     2570      0      0
          4    27242  23901  31868
          5    51143  50886  51400
          6    19018  13878  23644
          7     6168   2056   6168
          8    55512  51400  55512
          9    63736  59624  63736
         10    60138  55512  59624
    
    ...      ...    ...    ...
    
    250    63736  63736  63736
    251    59624  59624  59624
    252    55512  55512  55512
    253     6168   6168   6168
    254     2056   2056   2056
    255    65535  65535  65535

7/10/2012