ST_Raster.subset

Определение

ST_Raster.subset возвращает поднабор объекта ST_Raster.

Синтаксис

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

Возвраты

ST_Raster

Параметры

Параметр	Описание
растр	ST_Raster, из которого будет генерироваться поднабор
parameter_list	Список параметров с разделителем запятая, заключенный в одинарные кавычки, который может включать следующие параметры: band <1st band number>[,<2nd band number>],…,[nth band number]>—Список порядковых номеров канала для каналов, которые будут возвращены, с разделителем запятая Данные пикселов возвращаются в том порядке, в каком идут порядковые номера канала. Если этот параметр не определен, все каналы объекта ST_Raster экспортируются в обычном последовательном порядке канала. window (minx,miny,maxx,maxy)—Площадь ST_Raster, заданная в координатах пикселов Параметр window является исключительным для параметра extent; только один из них может использоваться для определения области поднабора, но не оба одновременно. Если присутствуют оба параметра, будет выдано сообщение об ошибке. Если ни один из параметров не задан, будет возвращена вся площадь исходного объекта ST_Raster. window (minx,miny,maxx,maxy)—Площадь ST_Raster, заданная в географических координатах Параметр extent является исключительным для параметра window; только один из них может использоваться для определения области поднабора, но не оба одновременно. Если присутствуют оба параметра, будет выдано сообщение об ошибке. Если ни один из параметров не задан, будет возвращена вся площадь исходного объекта ST_Raster.
options	Список опций с разделителем запятая, заключенный в одинарные кавычки, который может включать следующее: compression <lz77 | jpeg | jp2>—Алгоритм сжатия, который будет применен к ST_Raster; по умолчанию установлено не применять сжатие к данным. interleave <separate | contiguous>—Данная опция применяется к объектам ST_Raster, которые хранят трехканальные 8-битные данные пикселов. Указание последовательного чередования показывает, что данные пикселов будут выделены в отдельные каналы RGB, в то время как установка непрерывного чередования показывает, что данные пикселов будут выделены в непрерывные серии красных, зеленых и голубых пикселов. conversion <rgb | grayscale>—Если установлено на rgb, параметр преобразования предписывает функции поднабора subset вернуть одноканальный ST_Raster с цветовой картой как трехканальный RGB объект ST_Raster. Если параметр преобразования установлен на grayscale, то входной 1-битный черно-белый объект ST_Raster будет возвращен, как 8-битный ST_Raster в оттенках серого. quality <value>—Качество для сжатия JPEG или для переменного сжатия JPEG 2000 bitrate <value>—Битовая скорость передачи данных для фиксированного сжатия JPEG 2000 nodata (r,g,b) | <value>—Те значения пикселов объекта ST_Raster, которые будут возвращены как nodata nocolormap—Показывает, что цветовая карта не будет возвращена edge <value>:<tolerance>—Удаляет ненужные пикселы границы вокруг ST_Raster, отмеченные как NoData; edge показывает, что только пикселы заданного диапазона значений будут удалены, и только из внешней границы растра. Это предотвращает удаление пикселов внутри растра, имеющих то же значение. level <pyramid level>—Уровень пирамидного слоя объекта ST_Raster, который будет возвращен; значением по умолчанию является базовый уровень пирамидного слоя. skipLevel1—Показывает, что объект ST_Raster будет возвращен без первого уровня пирамидного слоя; пирамидный слой будет начинаться со второго уровня. tile (width,height)—Ширина и высота листов возвращаемого ST_Raster, в пикселах nearest | bilinear | bicubic—Интерполяция пирамидного слоя для возвращаемого ST_Raster log <logfile name>—Файл журнала, хранящий результаты выполнения функции subset

Примеры

В первом примере функция ST_Raster.subset используется для создания копии существующего объекта ST_Raster с фиксированной последовательностью каналов.

Во втором примере результат функции ST_Raster.subset используется в качестве входных растровых данных для функции ST_Raster.mosaic. Второй уровень пирамидного слоя извлекается из столбца image в таблице world, используя функцию ST_Raster.subset, и затем выполняется его мозаика со столбцом column в таблице 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');