Name

ST_Aspect — 返回高程栅格标注栏的纵横比(默认情况下以度为单位)。对于分析地形非常有用。

Synopsis

raster ST_Aspect(raster rast, integer band=1, text pixeltype=32BF, text units=DEGREES, boolean interpolate_nodata=FALSE);

raster ST_Aspect(raster rast, integer band, raster customextent, text pixeltype=32BF, text units=DEGREES, boolean interpolate_nodata=FALSE);

描述

返回高程栅格标注栏的纵横比(默认情况下以度为单位)。利用地图代数并将纵横比方程应用于相邻像素。

units 指示纵横比的单位。可能的值为:弧度、度数(默认)。

什么时候 units =弧度,值介于0和2*圆周率弧度之间,从北向顺时针测量。

什么时候 units =度,值在0到360度之间,从北向顺时针测量。

如果像素斜率为零,则像素纵横比为-1。

[Note]

有关坡度、坡向和山体阴影的更多信息,请参阅 ESRI-山体阴影的工作原理 ERDAS现场指南-纵横比图像

可用性:2.0.0

增强版:2.1.0使用ST_MapAlgebra()并添加了可选 interpolate_nodata 函数参数

更改:2.1.0在以前的版本中,返回值以弧度为单位。现在,返回值默认为度

示例:变体1

WITH foo AS (
    SELECT ST_SetValues(
        ST_AddBand(ST_MakeEmptyRaster(5, 5, 0, 0, 1, -1, 0, 0, 0), 1, '32BF', 0, -9999),
        1, 1, 1, ARRAY[
            [1, 1, 1, 1, 1],
            [1, 2, 2, 2, 1],
            [1, 2, 3, 2, 1],
            [1, 2, 2, 2, 1],
            [1, 1, 1, 1, 1]
        ]::double precision[][]
    ) AS rast
)
SELECT
    ST_DumpValues(ST_Aspect(rast, 1, '32BF'))
FROM foo

                                                                                                    st_dumpvalues

------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
----------------------------------
 (1,"{{315,341.565063476562,0,18.4349479675293,45},{288.434936523438,315,0,45,71.5650482177734},{270,270,-1,90,90},{251.565048217773,225,180,135,108.434951782227},{225,198.43495178
2227,180,161.565048217773,135}}")
(1 row)
                    

示例:变体2

Coverage平铺的完整示例。此查询仅适用于PostgreSQL 9.1或更高版本。

WITH foo AS (
    SELECT ST_Tile(
        ST_SetValues(
            ST_AddBand(
                ST_MakeEmptyRaster(6, 6, 0, 0, 1, -1, 0, 0, 0),
                1, '32BF', 0, -9999
            ),
            1, 1, 1, ARRAY[
                [1, 1, 1, 1, 1, 1],
                [1, 1, 1, 1, 2, 1],
                [1, 2, 2, 3, 3, 1],
                [1, 1, 3, 2, 1, 1],
                [1, 2, 2, 1, 2, 1],
                [1, 1, 1, 1, 1, 1]
            ]::double precision[]
        ),
        2, 2
    ) AS rast
)
SELECT
    t1.rast,
    ST_Aspect(ST_Union(t2.rast), 1, t1.rast)
FROM foo t1
CROSS JOIN foo t2
WHERE ST_Intersects(t1.rast, t2.rast)
GROUP BY t1.rast;
                    

另请参阅

ST_MapAlgebra(回调函数版本), ST_TRI, ST_TPI, ST_Roughness, ST_HillShade, ST_Slope