ST_HillShade · دليل PostGIS 3.6

الاسم

ST_HillShade — تُعيد الإضاءة الافتراضية لنطاق رستر ارتفاعات باستخدام مُدخلات السمت والارتفاع والسطوع والمقياس المُعطاة.

المختصر

raster ST_HillShade(raster rast, integer band=1, text pixeltype=32BF, double precision azimuth=315, double precision altitude=45, double precision max_bright=255, double precision scale=1.0, boolean interpolate_nodata=FALSE);

raster ST_HillShade(raster rast, integer band, raster customextent, text pixeltype=32BF, double precision azimuth=315, double precision altitude=45, double precision max_bright=255, double precision scale=1.0, boolean interpolate_nodata=FALSE);

الوصف

تُعيد الإضاءة الافتراضية لنطاق رستر ارتفاعات باستخدام مُدخلات السمت والارتفاع والسطوع والمقياس. تستخدم الجبر الخرائطي وتطبّق معادلة تظليل التضاريس على البكسلات المجاورة. تكون قيم البكسلات المُعادة بين 0 و255.

azimuth قيمة بين 0 و360 درجة مقيسة باتجاه عقارب الساعة من الشمال.

altitude قيمة بين 0 و90 درجة، حيث 0 درجة عند الأفق و90 درجة عموديًا فوق الرأس مباشرة.

max_bright قيمة بين 0 و255، حيث 0 تعني انعدام السطوع و255 أقصى سطوع.

scale هي نسبة الوحدات الرأسية إلى الأفقية. للنسبة Feet:LatLon استخدم scale=370400، وللنسبة Meters:LatLon استخدم scale=111120.

إذا كانت interpolate_nodata تساوي TRUE، تُستكمَل قيم بكسلات NODATA من الرستر المُدخل باستخدام ST_InvDistWeight4ma قبل حساب إضاءة تظليل التضاريس.


	لمزيد من المعلومات عن تظليل التضاريس، راجع كيف يعمل تظليل التضاريس.

متاحة منذ: 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_Hillshade(rast, 1, '32BF'))
FROM foo

                                                                                                                       st_dumpvalues

------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
-----------------------------------------------------------------------
 (1,"{{NULL,NULL,NULL,NULL,NULL},{NULL,251.32763671875,220.749786376953,147.224319458008,NULL},{NULL,220.749786376953,180.312225341797,67.7497863769531,NULL},{NULL,147.224319458008
,67.7497863769531,43.1210060119629,NULL},{NULL,NULL,NULL,NULL,NULL}}")
(1 row)

أمثلة: الصيغة 2

مثال كامل لبلاطات تغطية. يعمل هذا الاستعلام فقط مع 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_Hillshade(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 (callback function version), ST_TRI, ST_TPI, ST_Roughness, ST_Aspect, ST_Slope