ST_AsHMT - PolarDB - Centro de documentación de Alibaba Cloud

Agrega un conjunto de objetos geométricos en un mosaico de mapa de calor (HMT) con base en una extensión y una resolución específicas.

Sintaxis

bytea ST_AsHMT(geometry geometry_set, geometry extent, int4 width, int4 height, int4 value default 1, boolean point_mode default false);
bytea ST_AsHMT(geometry geometry_set, geometry extent, int4 width, int4 height, int4 value);
bytea ST_AsHMT(geometry geometry_set, geometry extent, int4 width, int4 height, int4 value, boolean point_mode);
bytea ST_AsHMT(geometry geometry_set, geometry extent, int4 width, int4 height, float8 value);
bytea ST_AsHMT(geometry geometry_set, geometry extent, int4 width, int4 height, float8 value, boolean point_mode);
bytea ST_AsHMT(geometry geometry_set, geometry extent, int4 width, int4 height, int4 value, cstring config);
bytea ST_AsHMT(geometry geometry_set, geometry extent, int4 width, int4 height, float8 value, cstring config);

Valor de retorno

Devuelve una estructura de datos binaria basada en Protocol Buffers (Protobuf) que representa el valor agregado de cada celda de la cuadrícula. El esquema es a continuación:

syntax = "proto2";
option optimize_for = LITE_RUNTIME;

message HMT {
    required Type type = 1; // data value type
    required uint32 rows = 2;   // rows of matrix
    required uint32 columns = 3; // columns of matrix
    required uint32 srid = 4; // spatial reference identifier
    required float  xmin = 5; // xmin
    required float  ymin = 6; // ymin
    required float  xmax = 7; // xmax
    required float  ymax = 8; // ymax

    oneof matrix {
        intMatrix intValues = 10;
        doubleMatrix doubleValues = 11;
    }

    message intMatrix {
        repeated sint32 values = 12 [packed = true];
    }

    message doubleMatrix {
        repeated double values = 13 [packed = true];
    }

    enum Type {
        INT32 = 0;
        DOUBLE = 1;
    }
}

Nota

El objeto HMT devuelto contiene los siguientes campos:

El campo type depende del tipo de dato del valor de entrada. Se establece en INT32 para contar cantidades y en DOUBLE para calcular métricas.
Los campos rows y columns corresponden a los parámetros height y width, respectivamente.
El campo matrix contiene una matriz de valores organizados por filas (row-major order).
La cuadrícula se organiza con los valores x en aumento de izquierda a derecha y los valores y en disminución de arriba hacia abajo. Esta disposición es estándar para renderizar imágenes.
Para convertir el resultado binario en una matriz legible, utilice la función ST_HMTAsArray.

Parámetros

Parámetro	Descripción
geometry_set	La columna de geometría que utiliza la función de agregación.
extent	El rango geográfico para la agregación. Solo se usa el cuadro delimitador de esta geometría. Para generar una extensión, use la función `ST_TileEnvelope`.
width	El ancho de la cuadrícula de salida. Este valor corresponde al campo `columns` del resultado.
height	La altura de la cuadrícula de salida. Este valor corresponde al campo `rows` del resultado.
value	El valor numérico que se va a agregar. La función calcula la suma de este valor.
point_mode	Indica si se usa el modo de puntos. Si es `true`, la función agrega únicamente los puntos que caen dentro de una celda de la cuadrícula.
config	Una cadena con formato JSON que especifica las opciones avanzadas de agregación para el mapa de calor.

Descripción

Esta función convierte un conjunto de objetos geométricos en un mosaico de mapa de calor (HMT) con base en un rango geográfico y una resolución específicos.

Si las geometrías de entrada difieren de la referencia espacial del parámetro extent, la función las transforma automáticamente para que coincidan.

El parámetro config es una cadena JSON que especifica el método de cálculo. A continuación se describen las opciones disponibles.

Parámetro

Descripción

Tipo

Predeterminado

Descripción

type

El tipo de función de agregación.

string

sum

Valores válidos:

sum
min
max
avg

point_mod

Indica si se usa el modo de puntos.

boolean

false

Observe la ortografía point_mod, ya que difiere del parámetro de función point_mode.

Nota

Cuando se usa el tipo int4 para calcular una suma, la operación puede provocar un desbordamiento si el resultado supera el límite de INT32 (-2147483648 a 2147483647). Para evitar desbordamientos con números grandes, utilice el tipo float8.

Ejemplos

-- The following examples use a sample table named test_table, which is created with this statement.
CREATE TABLE test_table AS
SELECT i num,
    ST_SetSrid(st_makepoint((i-0.5)::numeric, (i-0.5)::numeric), 4326) geom,
    i*100::int4 weight,
    i*i*i::float8 volume
FROM generate_series(1, 10) i;

-- Count the number of geometries in each grid cell.
-- This is the simplest use case and does not require a `value` parameter.
SELECT ST_AsHMT(geom, -- geometry column
    ST_MakeEnvelope(0, 0, 10, 10, 4326), -- Extent
    1024,        -- Width, in pixels
    800        -- height
)
FROM test_table;

---------
\x080010a0061880083284...

-- Sum the values in the `weight` column for each grid cell.
SELECT ST_AsHMT(geom, -- geometry column
    ST_MakeEnvelope(0, 0, 10, 10, 4326), -- Extent
    1024,        -- Width
    800,       -- height
    weight     -- value column
)
FROM test_table;
---------
\x080010a0061880...

-- Sum the result of a computed expression for each grid cell.
-- The function returns a DOUBLE type matrix because the expression returns a float8 value.
SELECT ST_AsHMT(geom, -- geometry column
    ST_MakeEnvelope(0, 0, 10, 10, 4326), -- Extent
    1024,        -- Width
    800,        -- height
    weight / volume * 1.2     -- complex value
)
FROM test_table;
---------
\x080110a0061880083a85...

-- Use point mode to count only geometries whose centers are in a grid cell.
SELECT ST_AsHMT(geom, -- geometry column
    ST_MakeEnvelope(0, 0, 10, 10, 4326), -- Extent
    1024,        -- Width, in pixels
    800,        -- height
    1::integer,  -- value
    true        -- point mode
)
FROM test_table;
---------
\x080010a0061880083...

-- Filter the input data before aggregation by using a WHERE clause.
SELECT ST_AsHMT(geom, -- geometry column
    ST_MakeEnvelope(0, 0, 10, 10, 4326), -- Extent
    1024,        -- Width, in pixels
    800        -- height
)
FROM test_table
WHERE num <5;
---------
\x080010a00618...

-- Calculate the average weight by using the `config` parameter.
SELECT ST_AsHMT(geom,
    ST_MakeEnvelope(0, 0, 10, 10, 4326), -- Extent
    256,        -- Width, in pixels
    256,        -- height
    weight, 
    '{"type":"avg"}'::cstring)
FROM test_table;
---------
\x080010a00618...

-- Find the minimum weight in point mode by using the `config` parameter.
SELECT ST_AsHMT(geom,
    ST_MakeEnvelope(0, 0, 10, 10, 4326), -- Extent
    256,        -- Width, in pixels
    256,        -- height
    weight, 
    '{"type":"min", "point_mod":true}'::cstring)
FROM test_table;
---------
\x080010a00618...