ee.Image.sampleRegions

একটি ইমেজের (একটি নির্দিষ্ট স্কেলে) এক বা একাধিক অঞ্চলের সাথে ছেদকারী প্রতিটি পিক্সেলকে একটি ফিচারে রূপান্তর করে এবং সেগুলোকে একটি ফিচার কালেকশন হিসেবে ফেরত দেয়। প্রতিটি আউটপুট ফিচারে ইনপুট ইমেজের প্রতিটি ব্যান্ডের জন্য একটি করে প্রপার্টি থাকবে, সেইসাথে ইনপুট ফিচার থেকে কপি করা যেকোনো নির্দিষ্ট প্রপার্টিও থাকবে।

মনে রাখবেন যে জ্যামিতিগুলো পিক্সেল কেন্দ্রে স্ন্যাপ করা হবে।

ব্যবহার	ফেরত
Image. sampleRegions (collection, properties , scale , projection , tileScale , geometries )	ফিচার কালেকশন

যুক্তি	প্রকার	বিস্তারিত
এই: image	ছবি	নমুনা হিসেবে ব্যবহৃত চিত্র।
collection	ফিচার কালেকশন	যে অঞ্চলগুলো থেকে নমুনা সংগ্রহ করতে হবে।
properties	তালিকা, ডিফল্ট: নাল	প্রতিটি ইনপুট ফিচার থেকে কপি করার জন্য প্রপার্টিগুলোর তালিকা। ডিফল্টরূপে এটি সমস্ত নন-সিস্টেম প্রপার্টি হয়ে থাকে।
scale	ফ্লোট, ডিফল্ট: নাল	স্যাম্পল নেওয়ার জন্য প্রজেকশনের একটি নামমাত্র স্কেল, যা মিটারে পরিমাপ করা হয়। যদি এটি নির্দিষ্ট না করা থাকে, তবে ইমেজটির প্রথম ব্যান্ডের স্কেল ব্যবহার করা হয়।
projection	প্রক্ষেপণ, ডিফল্ট: নাল	যে প্রজেকশনে স্যাম্পল নেওয়া হবে। যদি নির্দিষ্ট না করা থাকে, তাহলে ইমেজের প্রথম ব্যান্ডের প্রজেকশন ব্যবহার করা হয়। যদি স্কেলের পাশাপাশি এটিও নির্দিষ্ট করা থাকে, তবে নির্দিষ্ট স্কেলে রিস্কেল করা হয়।
tileScale	ফ্লোট, ডিফল্ট: ১	অ্যাগ্রিগেশন টাইলের আকার কমাতে ব্যবহৃত একটি স্কেলিং ফ্যাক্টর; একটি বৃহত্তর টাইলসকেল (যেমন, ২ বা ৪) ব্যবহার করলে এমন গণনা সক্ষম হতে পারে যা ডিফল্ট সেটিংসে মেমোরি শেষ হয়ে যাওয়ার সমস্যায় পড়ে।
geometries	বুলিয়ান, ডিফল্ট: ফলস	যদি সত্য হয়, তাহলে ফলাফলে প্রতিটি নমুনা করা পিক্সেলের জন্য একটি বিন্দু জ্যামিতি অন্তর্ভুক্ত থাকবে। অন্যথায়, জ্যামিতিগুলি বাদ দেওয়া হবে (মেমরি সাশ্রয়ের জন্য)।

উদাহরণ

কোড এডিটর (জাভাস্ক্রিপ্ট)

// A Sentinel-2 surface reflectance image.
var img = ee.Image('COPERNICUS/S2_SR/20210109T185751_20210109T185931_T10SEG');
Map.setCenter(-122.503881, 37.765588, 18);
Map.addLayer(img, {bands: ['B11', 'B8', 'B3'], min: 100, max: 4500}, 'img');

// A feature collection with two polygon regions each intersecting 36
// pixels at 10 m scale.
var fcPolygon = ee.FeatureCollection([
  ee.Feature(ee.Geometry.Rectangle(
    -122.50620929, 37.76502806, -122.50552264, 37.76556663), {id: 0}),
  ee.Feature(ee.Geometry.Rectangle(
    -122.50530270, 37.76565568, -122.50460533, 37.76619425), {id: 1})
]);
Map.addLayer(fcPolygon, {color: 'yellow'}, 'fcPolygon');

var fcPolygonSamp = img.sampleRegions({
  collection: fcPolygon,
  scale: 10,
  geometries: true
});
// Note that 7 pixels are missing from the sample. If a pixel contains a masked
// band value it will be excluded from the sample. In this case, the TCI_B band
// is masked for each unsampled pixel.
print('A feature per pixel (at given scale) in each region', fcPolygonSamp);
Map.addLayer(fcPolygonSamp, {color: 'purple'}, 'fcPolygonSamp');

// A feature collection with two points intersecting two different pixels.
// This example is included to show the behavior for point geometries. In
// practice, if the feature collection is all points, ee.Image.reduceRegions
// should be used instead to save memory.
var fcPoint = ee.FeatureCollection([
  ee.Feature(ee.Geometry.Point([-122.50309256, 37.76605006]), {id: 0}),
  ee.Feature(ee.Geometry.Point([-122.50344661, 37.76560903]), {id: 1})
]);
Map.addLayer(fcPoint, {color: 'cyan'}, 'fcPoint');

var fcPointSamp = img.sampleRegions({
  collection: fcPoint,
  scale: 10
});
print('A feature per point', fcPointSamp);

পাইথন সেটআপ

পাইথন এপিআই এবং ইন্টারেক্টিভ ডেভেলপমেন্টের জন্য geemap ব্যবহারের তথ্যের জন্য পাইথন এনভায়রনমেন্ট পেজটি দেখুন।

import ee
import geemap.core as geemap

কোলাব (পাইথন)

# A Sentinel-2 surface reflectance image.
img = ee.Image('COPERNICUS/S2_SR/20210109T185751_20210109T185931_T10SEG')
m = geemap.Map()
m.set_center(-122.503881, 37.765588, 18)
m.add_layer(
    img, {'bands': ['B11', 'B8', 'B3'], 'min': 100, 'max': 4500}, 'img'
)
display(m)

# A feature collection with two polygon regions each intersecting 36
# pixels at 10 m scale.
fc_polygon = ee.FeatureCollection([
    ee.Feature(
        ee.Geometry.Rectangle(
            -122.50620929, 37.76502806, -122.50552264, 37.76556663
        ),
        {'id': 0},
    ),
    ee.Feature(
        ee.Geometry.Rectangle(
            -122.50530270, 37.76565568, -122.50460533, 37.76619425
        ),
        {'id': 1},
    ),
])
m.add_layer(fc_polygon, {'color': 'yellow'}, 'fc_polygon')

fc_polygon_samp = img.sampleRegions(
    collection=fc_polygon, scale=10, geometries=True
)
# Note that 7 pixels are missing from the sample. If a pixel contains a masked
# band value it will be excluded from the sample. In this case, the TCI_B band
# is masked for each unsampled pixel.
display('A feature per pixel (at given scale) in each region', fc_polygon_samp)
m.add_layer(fc_polygon_samp, {'color': 'purple'}, 'fc_polygon_samp')

# A feature collection with two points intersecting two different pixels.
# This example is included to show the behavior for point geometries. In
# practice, if the feature collection is all points, ee.Image.reduceRegions
# should be used instead to save memory.
fc_point = ee.FeatureCollection([
    ee.Feature(ee.Geometry.Point([-122.50309256, 37.76605006]), {'id': 0}),
    ee.Feature(ee.Geometry.Point([-122.50344661, 37.76560903]), {'id': 1}),
])
m.add_layer(fc_point, {'color': 'cyan'}, 'fc_point')

fc_point_samp = img.sampleRegions(collection=fc_point, scale=10)
display('A feature per point', fc_point_samp)