GISarabia.org
PostGIS › الدليل الرسمي › 11. مرجع الرستر › 11.9. إحصاءات نطاقات الرستر وتحليلاتها
PostGIS 3.6 · Official Manual · ترجمة عربية

ST_ValueCount

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

الاسم

ST_ValueCount — تُعيد مجموعة من السجلات تحتوي على قيمة نطاق البكسل وعدد البكسلات في نطاق معيّن من رستر (أو تغطية رستر) التي تملك مجموعة معيّنة من القيم. إذا لم يُحدَّد نطاق فالافتراضي هو النطاق 1. افتراضيًا لا تُعدّ البكسلات ذات قيمة nodata، وتُخرَج جميع القيم الأخرى في البكسل، وتُقرَّب قيم نطاق البكسل إلى أقرب عدد صحيح.

المختصر

SETOF record ST_ValueCount(raster rast, integer nband=1, boolean exclude_nodata_value=true, double precision[] searchvalues=NULL, double precision roundto=0, double precision OUT value, integer OUT count);

SETOF record ST_ValueCount(raster rast, integer nband, double precision[] searchvalues, double precision roundto=0, double precision OUT value, integer OUT count);

SETOF record ST_ValueCount(raster rast, double precision[] searchvalues, double precision roundto=0, double precision OUT value, integer OUT count);

bigint ST_ValueCount(raster rast, double precision searchvalue, double precision roundto=0);

bigint ST_ValueCount(raster rast, integer nband, boolean exclude_nodata_value, double precision searchvalue, double precision roundto=0);

bigint ST_ValueCount(raster rast, integer nband, double precision searchvalue, double precision roundto=0);

SETOF record ST_ValueCount(text rastertable, text rastercolumn, integer nband=1, boolean exclude_nodata_value=true, double precision[] searchvalues=NULL, double precision roundto=0, double precision OUT value, integer OUT count);

SETOF record ST_ValueCount(text rastertable, text rastercolumn, double precision[] searchvalues, double precision roundto=0, double precision OUT value, integer OUT count);

SETOF record ST_ValueCount(text rastertable, text rastercolumn, integer nband, double precision[] searchvalues, double precision roundto=0, double precision OUT value, integer OUT count);

bigintST_ValueCount(text rastertable, text rastercolumn, integer nband, boolean exclude_nodata_value, double precision searchvalue, double precision roundto=0);

bigint ST_ValueCount(text rastertable, text rastercolumn, double precision searchvalue, double precision roundto=0);

bigint ST_ValueCount(text rastertable, text rastercolumn, integer nband, double precision searchvalue, double precision roundto=0);

الوصف

تُعيد مجموعة من السجلات ذات العمودين value count اللذين يحتويان على قيمة نطاق البكسل وعدد البكسلات في بلاطة الرستر أو تغطية الرستر للنطاق المحدد.

إذا لم يُحدَّد نطاق فالقيمة الافتراضية لـ nband هي 1. إذا لم تُحدَّد searchvalues، فستُعيد جميع قيم البكسلات الموجودة في الرستر أو تغطية الرستر. وإذا أُعطيت قيمة بحث واحدة، فستُعيد عددًا صحيحًا بدلًا من السجلات يدل على عدد البكسلات التي تملك قيمة نطاق البكسل تلك

[ملاحظة]

إذا ضُبط exclude_nodata_value على false، فستُعدّ أيضًا البكسلات التي لا تحتوي على بيانات.

متاحة منذ: 2.0.0

أمثلة

UPDATE dummy_rast SET rast = ST_SetBandNoDataValue(rast,249) WHERE rid=2;
--Example will count only pixels of band 1 that are not 249. --

SELECT (pvc).*
FROM (SELECT ST_ValueCount(rast) As pvc
    FROM dummy_rast WHERE rid=2) As foo
    ORDER BY (pvc).value;

 value | count
-------+-------
   250 |     2
   251 |     1
   252 |     2
   253 |     6
   254 |    12

-- Example will coount all pixels of band 1 including 249 --
SELECT (pvc).*
FROM (SELECT ST_ValueCount(rast,1,false) As pvc
    FROM dummy_rast WHERE rid=2) As foo
    ORDER BY (pvc).value;

 value | count
-------+-------
   249 |     2
   250 |     2
   251 |     1
   252 |     2
   253 |     6
   254 |    12

-- Example will count only non-nodata value pixels of band 2
SELECT (pvc).*
FROM (SELECT ST_ValueCount(rast,2) As pvc
    FROM dummy_rast WHERE rid=2) As foo
    ORDER BY (pvc).value;
 value | count
-------+-------
    78 |     1
    79 |     1
    88 |     1
    89 |     1
    96 |     1
    97 |     1
    98 |     1
    99 |     2
   112 |     2
:

                
--real live example.  Count all the pixels in an aerial raster tile band 2 intersecting a geometry
-- and return only the pixel band values that have a count > 500
SELECT (pvc).value, SUM((pvc).count) As total
FROM (SELECT ST_ValueCount(rast,2) As pvc
    FROM o_4_boston
        WHERE ST_Intersects(rast,
            ST_GeomFromText('POLYGON((224486 892151,224486 892200,224706 892200,224706 892151,224486 892151))',26986)
             )
        ) As foo
    GROUP BY (pvc).value
    HAVING SUM((pvc).count) > 500
    ORDER BY (pvc).value;

 value | total
-------+-----
    51 | 502
    54 | 521
-- Just return count of pixels in each raster tile that have value of 100 of tiles that intersect  a specific geometry --
SELECT rid, ST_ValueCount(rast,2,100) As count
    FROM o_4_boston
        WHERE ST_Intersects(rast,
            ST_GeomFromText('POLYGON((224486 892151,224486 892200,224706 892200,224706 892151,224486 892151))',26986)
             ) ;

 rid | count
-----+-------
   1 |    56
   2 |    95
  14 |    37
  15 |    64

انظر أيضًا

ST_Count, ST_SetBandNoDataValue