GISarabia.org
PostGIS › الدليل الرسمي › 11. مرجع الرستر › 11.6. دوال الوصول إلى بكسلات الرستر وضبطها
PostGIS 3.6 · Official Manual · ترجمة عربية

ST_PixelAsCentroids

الصفحة الأصلية بالإنجليزية postgis.net ↗

الاسم

ST_PixelAsCentroids — تُعيد المركز الهندسي (شكلًا هندسيًا نقطيًا) لكل بكسل في نطاق رستر مع القيمة وإحداثيَّي الرستر X وY لكل بكسل. الشكل الهندسي النقطي هو المركز الهندسي للمساحة التي يمثّلها البكسل.

المختصر

setof record ST_PixelAsCentroids(raster rast, integer band=1, boolean exclude_nodata_value=TRUE);

الوصف

تُعيد المركز الهندسي (شكلًا هندسيًا نقطيًا) لكل بكسل في نطاق رستر مع القيمة وإحداثيَّي الرستر X وY لكل بكسل. الشكل الهندسي النقطي هو المركز الهندسي للمساحة التي يمثّلها البكسل.

صيغة السجل المُعاد: geom geometry، val double precision، x integer، y integers.

[ملاحظة]

عندما يكون exclude_nodata_value = TRUE، تُعاد في صورة نقاط فقط البكسلات التي ليست قيمها NODATA.

حُسّنت في: 3.2.0 أصبحت أسرع إذ باتت مُنفّذة بلغة C.

تغيّرت في: 2.1.1 تغيّر سلوك exclude_nodata_value.

متاحة منذ: 2.1.0

أمثلة

--LATERAL syntax requires PostgreSQL 9.3+
SELECT x, y, val, ST_AsText(geom)
    FROM (SELECT dp.* FROM dummy_rast, LATERAL ST_PixelAsCentroids(rast, 1) AS dp WHERE rid = 2) foo;
 x | y | val |           st_astext
---+---+-----+--------------------------------
 1 | 1 | 253 | POINT(3427927.775 5793243.975)
 2 | 1 | 254 | POINT(3427927.825 5793243.975)
 3 | 1 | 253 | POINT(3427927.875 5793243.975)
 4 | 1 | 254 | POINT(3427927.925 5793243.975)
 5 | 1 | 254 | POINT(3427927.975 5793243.975)
 1 | 2 | 253 | POINT(3427927.775 5793243.925)
 2 | 2 | 254 | POINT(3427927.825 5793243.925)
 3 | 2 | 254 | POINT(3427927.875 5793243.925)
 4 | 2 | 253 | POINT(3427927.925 5793243.925)
 5 | 2 | 249 | POINT(3427927.975 5793243.925)
 1 | 3 | 250 | POINT(3427927.775 5793243.875)
 2 | 3 | 254 | POINT(3427927.825 5793243.875)
 3 | 3 | 254 | POINT(3427927.875 5793243.875)
 4 | 3 | 252 | POINT(3427927.925 5793243.875)
 5 | 3 | 249 | POINT(3427927.975 5793243.875)
 1 | 4 | 251 | POINT(3427927.775 5793243.825)
 2 | 4 | 253 | POINT(3427927.825 5793243.825)
 3 | 4 | 254 | POINT(3427927.875 5793243.825)
 4 | 4 | 254 | POINT(3427927.925 5793243.825)
 5 | 4 | 253 | POINT(3427927.975 5793243.825)
 1 | 5 | 252 | POINT(3427927.775 5793243.775)
 2 | 5 | 250 | POINT(3427927.825 5793243.775)
 3 | 5 | 254 | POINT(3427927.875 5793243.775)
 4 | 5 | 254 | POINT(3427927.925 5793243.775)
 5 | 5 | 254 | POINT(3427927.975 5793243.775)