ST_Quantile - ApsaraDB RDS: Central de Documentação do Alibaba Cloud

Pré-requisitos

Execute ST_StatsQuantile para calcular os quantis do objeto raster antes de chamar ST_Quantile.

Sintaxe

setof record ST_Quantile(raster raster_obj,
                   float8[] quantiles default NULL,
                   cstring bands default '',
                   boolean exclude_nodata_value default true,
                   out integer band,
                   out float8 quantile,
                   out float8 value)

Parâmetros

Parâmetros de entrada

Parâmetro	Tipo	Padrão	Descrição
`raster_obj`	raster	—	Objeto raster a consultar.
`quantiles`	float8[]	NULL	Quantis a retornar. Valores válidos: `0.25`, `0.5` e `0.75`. Passe `NULL` para retornar todos os três quantis.
`bands`	cstring	`''`	Números de série das bandas a incluir. Formatos suportados: `'0-2'` (intervalo) e `'1,2,3'` (lista). A numeração começa em `0`. Uma string vazia (padrão) inclui todas as bandas.
`exclude_nodata_value`	boolean	true	Define se valores NoData devem ser excluídos da consulta.

Parâmetros de saída

Parâmetro	Tipo	Descrição
`band`	integer	Número de série da banda.
`quantile`	float8	Valor do quantil.
`value`	float8	Valor do pixel no quantil correspondente.

Exemplos

Exemplo 1: Retorna o valor de pixel no quantil 0,25 para todas as bandas (bandas 0–2).

SELECT (ST_Quantile(rast, ARRAY[0.25], '0-2', true)).* FROM rat_quantile WHERE id = 1;

Saída:

 band | quantile | value
------+----------+-------
    0 |     0.25 |    11
    1 |     0.25 |    10
    2 |     0.25 |    50
(3 rows)

Exemplo 2: Retorna os valores de pixel em todos os quantis (0,25, 0,5, 0,75) para a banda 0.

SELECT (ST_Quantile(rast, NULL, '0', true)).* FROM rat_quantile WHERE id = 1;

Saída:

 band | quantile | value
------+----------+-------
    0 |     0.25 |    11
    0 |      0.5 |    11
    0 |     0.75 |    65
(3 rows)