इमेज का इस्तेमाल करके कैलकुलेशन करना

अब आपको इमेज लोड करने और उसे दिखाने का तरीका पता चल गया है. इसलिए, अब उस पर कंप्यूटेशन लागू करें. उदाहरण के लिए, slope पैकेज के ee.Terrain तरीके में एसआरटीएम एलिवेशन इमेज को पास करके, इलाके की ढलान का हिसाब लगाया जा सकता है.

कोड एडिटर (JavaScript)

// Load the SRTM image.
var srtm = ee.Image('CGIAR/SRTM90_V4');

// Apply an algorithm to an image.
var slope = ee.Terrain.slope(srtm);

// Display the result.
Map.setCenter(-112.8598, 36.2841, 9); // Center on the Grand Canyon.
Map.addLayer(slope, {min: 0, max :60}, 'slope');

ध्यान दें कि कोड ee.Terrain.slope(srtm) में, srtm इमेज को स्लोप एल्गोरिदम के लिए आर्ग्युमेंट के तौर पर दिया गया है. नतीजा कुछ-कुछ इमेज 3 जैसा दिखना चाहिए.

Tutorial_api_03_slope.png
तीसरी इमेज. स्लोप इमेज.

इमेज मैथ

ee.Image क्लास में ऐसे तरीके भी हैं जिन्हें इमेज ऑब्जेक्ट पर लागू किया जा सकता है. उदाहरण के लिए, मान लें कि आपको इमेज बैंड का इस्तेमाल करके कुछ गणितीय गणनाएं करनी हैं. इसे कभी-कभी बैंड मैथ या मैप अलजे़ब्रा भी कहा जाता है. उदाहरण के लिए, हो सकता है कि आपको किसी आसपेक्ट इमेज पर त्रिकोणमितीय ऑपरेशन करने हों. इसके लिए, पहले किसी एस्पेक्ट इमेज को रेडियन में बदलें. इसके बाद, उस पर sin() को कॉल करें. हमारी srtm इमेज का फिर से इस्तेमाल करना,

कोड एडिटर (JavaScript)

// Get the aspect (in degrees).
var aspect = ee.Terrain.aspect(srtm);

// Convert to radians, compute the sin of the aspect.
var sinImage = aspect.divide(180).multiply(Math.PI).sin();

// Display the result.
Map.addLayer(sinImage, {min: -1, max: 1}, 'sin');

नतीजा, इमेज 4 जैसा दिखना चाहिए. aspect.divide(180).multiply(Math.PI).sin() कोड को ध्यान से देखना ज़रूरी है. इस तरह कई तरीकों को जोड़कर, कोड कहता है, 'ऐस्पेक्ट को 180 से भाग दें, उसके नतीजे को π से गुणा करें, और आखिर में sin लें'. इस तरह से तरीकों को जोड़कर, इमेज पर मुश्किल गणितीय संक्रियाएं की जा सकती हैं. गणित से जुड़े सभी ऑपरेशन, add(), subtract(), multiply() वगैरह की पूरी सूची देखने के लिए, Image दस्तावेज़ देखें.

Tutorial_api_04_sin.png
चौथी इमेज. इलाके के आसपेक्ट का साइन.

इमेज के आंकड़े

इमेज पर की जाने वाली कार्रवाइयों की एक और काम की क्लास में, इमेज के इलाकों में पिक्सल के आंकड़ों की कंप्यूटिंग या रास्टर-वेक्टर ओवरले शामिल हैं. Earth Engine में आंकड़ों का हिसाब लगाने के लिए, रिड्यूसर का इस्तेमाल करें. इसे ee.Reducer पैकेज में क्लास के तौर पर दिखाया जाता है. उदाहरण के लिए, मान लें कि आपको किसी इलाके की औसत ऊंचाई जाननी है. ज्यामिति ड्रॉइंग टूल का इस्तेमाल करके, पॉलीगॉन बनाकर किसी क्षेत्र को तय किया जा सकता है. इंटरैक्टिव तरीके से कोई इलाका ड्रॉ करने के लिए, पॉलीगॉन ड्रॉइंग टूल () का इस्तेमाल करें. इसके बाद, अपनी पसंद के इलाके पर पॉलीगॉन को डिजिटाइज़ करें. इसके बाद, बाहर निकलें पर क्लिक करें. ध्यान दें कि नतीजे के तौर पर मिलने वाले ee.Geometry ऑब्जेक्ट को अपने-आप geometry नाम दिया जाता है. साथ ही, इसे आपकी स्क्रिप्ट के सबसे ऊपर इंपोर्ट के तौर पर जोड़ा जाता है. इंपोर्ट में वैरिएबल के नाम पर क्लिक करके और नया नाम टाइप करके, उस वैरिएबल का नाम बदलकर 'polygon' करें.

इसके बाद, इस कोड का इस्तेमाल करके पॉलीगॉन में मौजूद पिक्सल की औसत वैल्यू पाएं:

कोड एडिटर (JavaScript)

// Compute the mean elevation in the polygon.
var meanDict = srtm.reduceRegion({
  reducer: ee.Reducer.mean(),
  geometry: polygon,
  scale: 90
});

// Get the mean from the dictionary and print it.
var mean = meanDict.get('elevation');
print('Mean elevation', mean);

यहां कई बातों का ध्यान रखना ज़रूरी है. सबसे पहले, ध्यान दें कि reduceRegion(), Image ऑब्जेक्ट के लिए उपलब्ध एक तरीका है. रीजन को कम करने के बारे में ज़्यादा जानने के लिए यहां जाएं. दूसरा, तरीके के आर्ग्युमेंट, JavaScript ऑब्जेक्ट में दिए जाते हैं. इसे एक आर्ग्युमेंट के तौर पर पास किया जाता है. खास तौर पर, ऑब्जेक्ट की कुंजियां, तरीके के पैरामीटर के नाम होती हैं. वैल्यू, तरीके के आर्ग्युमेंट हैं). तीसरा, reducer पैरामीटर से यह तय होता है कि किस तरह के आंकड़े का हिसाब लगाना है. साथ ही, geometry पैरामीटर से यह तय होता है कि किस इलाके के लिए आंकड़े का हिसाब लगाना है. scale पैरामीटर, पिक्सल का साइज़ मीटर में दिखाता है. किसी भी तरह की गड़बड़ी से बचने के लिए, रिडक्शन करते समय हमेशा स्केल तय करें. ऐसा इसलिए, क्योंकि हो सकता है कि Earth Engine, इनपुट से सही स्केल का पता अपने-आप न लगा पाए. Earth Engine में स्केल के बारे में ज़्यादा जानें.

आखिर में, reduceRegion() की रिटर्न वैल्यू एक डिक्शनरी होती है. इसमें कुंजियां, बैंड के नाम होती हैं और वैल्यू, बैंड के लिए पिक्सल के आंकड़े होती हैं. डिक्शनरी में मौजूद get() तरीका, आर्ग्युमेंट के तौर पर दी गई कुंजी से जुड़ी वैल्यू दिखाता है. इस मामले में, srtm इमेज में एक बैंड, 'एलिवेशन' है. इसलिए, उदाहरण के तौर पर दिया गया कोड, डिक्शनरी से वह आंकड़ा लेता है और उसे प्रिंट करता है.

इस कोड को चलाने पर, अगर आपको इस तरह की गड़बड़ी मिलती है:

चिंता न करें! गड़बड़ी को ठीक करने के लिए, कई तरीके अपनाए जा सकते हैं. reduceRegion() तरीके में यह जांच की जाती है कि आपको अपनी गणना में इतने सारे पिक्सल शामिल करने हैं या नहीं. इसका मकसद आपको गलती से कोई बेवकूफ़ी करने से रोकना है. जैसे, दुनिया के हर एक मीटर पिक्सल का औसत निकालने की कोशिश करना (ऐसा न करें). इस गड़बड़ी को ठीक करने के लिए, पैरामीटर की डिक्शनरी में bestEffort: true जोड़कर, bestEffort पैरामीटर को true पर सेट करें या maxPixels पैरामीटर को डिफ़ॉल्ट वैल्यू (एक करोड़ पिक्सल) से ज़्यादा पर सेट करें या दोनों काम करें. अगर bestEffort की वैल्यू सही है, तो Earth Engine स्केल को अपने-आप फिर से कैलकुलेट करेगा, ताकि maxPixels की वैल्यू ज़्यादा न हो.

विषय से हटकर: Earth Engine में स्केल

पिछले उदाहरण में, scale को एसआरटीएम इमेज के नेटिव रिज़ॉल्यूशन के आस-पास सेट किया गया है. किसी इमेज के नेटिव रिज़ॉल्यूशन का पता लगाने के लिए, ये तरीके अपनाए जा सकते हैं:

कोड एडिटर (JavaScript)

var scale = srtm.projection().nominalScale();
print('SRTM scale in meters', scale);

अगर नेटिव रिज़ॉल्यूशन से छोटा स्केल तय किया जाता है, तो Earth Engine, इनपुट इमेज को फिर से सैंपल करेगा. इसके लिए, वह सबसे नज़दीकी पड़ोसी का इस्तेमाल करेगा. इसके बाद, वह उन सभी छोटे पिक्सल को कंप्यूटेशन में शामिल करेगा. अगर स्केल को बड़ा सेट किया जाता है, तो Earth Engine इनपुट के एग्रीगेट किए गए वर्शन से इनपुट पिक्सल का इस्तेमाल करेगा. इसका मतलब है कि इमेज पिरामिड के ज़्यादा लेवल से पिक्सल लेगा. इस दस्तावेज़ में, इस बारे में ज़्यादा जानें कि Earth Engine, स्केल को कैसे मैनेज करता है.

अब तक, आपने एक बैंड वाली एक इमेज के साथ काम किया है. अगले पेज पर, आपको मल्टी-बैंड इमेज और इमेज कलेक्शन के बारे में जानकारी मिलेगी.