ক্লায়েন্ট বনাম সার্ভার

Earth Engine ক্লায়েন্ট লাইব্রেরি Python এবং JavaScript-এর জন্য জটিল জিওস্পেশিয়াল বিশ্লেষণকে Earth Engine অনুরোধে অনুবাদ করে। ক্লায়েন্ট লাইব্রেরির জন্য আপনার লেখা কোডে ক্লায়েন্ট-সাইড অবজেক্ট এবং ভেরিয়েবলের রেফারেন্সের মিশ্রণ থাকতে পারে যা সার্ভার-সাইড অবজেক্টকে দেখায়।

আপনার কোডে থাকতে পারে এমন অন্যান্য Python বা JavaScript অবজেক্ট বা প্রিমিটিভ থেকে Earth Engine অবজেক্টকে আলাদা করা গুরুত্বপূর্ণ। আপনার স্ক্রিপ্টে ক্লায়েন্ট-সাইড "প্রক্সি" অবজেক্ট ম্যানিপুলেট করে আপনি সার্ভারে অবজেক্ট ম্যানিপুলেট করতে পারবেন। আপনি ee দিয়ে শুরু হওয়া যেকোনও কিছুকে প্রক্সি অবজেক্ট হিসেবে শনাক্ত করতে পারবেন। এই Earth Engine প্রক্সি অবজেক্টে কোনও আসল ডেটা থাকে না এবং এগুলি সার্ভারে অবজেক্টের জন্য শুধু হ্যান্ডেল হিসেবে কাজ করে। শুরু করতে, ক্লায়েন্ট-সাইড স্ট্রিং অবজেক্ট (যা প্রক্সি অবজেক্ট নয়) বিবেচনা করুন:

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

var clientString = 'I am a String';
print(typeof clientString);  // string

Python সেট-আপ

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

import ee
import geemap.core as geemap

Colab (Python)

client_string = 'I am a String'
print(type(client_string))  # str

আউটপুট থেকে লক্ষ্য করুন যে ক্লায়েন্ট (ওয়েব ব্রাউজার বা নোটবুক) এই কোডটি ব্যাখ্যা করেছে এবং এটি রান করেছে, ভেরিয়েবেলটি string টাইপের তা নির্ধারণ করেছে। এখন ধরুন, আপনি চান যে Earth Engine এই স্ট্রিংয়ের সাথে কিছু করতে পারুক। এটি করতে, আপনাকে স্ট্রিংটি একটি সুন্দর কন্টেনারে মুড়ে Google-এ পাঠাতে হবে। সেই কন্টেনারটি হল প্রক্সি অবজেক্ট। একটা উদাহরণ দেওয়া হল:

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

var serverString = ee.String('I am not a String!');
print(typeof serverString);  // object
print('Is this an EE object?',
    serverString instanceof ee.ComputedObject);  // true

Python সেট-আপ

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

import ee
import geemap.core as geemap

Colab (Python)

server_string = ee.String('I am not a String!')
print(type(server_string))  # ee.ee_string.String
print(
    'Is this an EE object?', isinstance(server_string, ee.ee_string.String)
)  # True

আউটপুট থেকে লক্ষ্য করুন যে ee.String হল একটি object, string নয়। আরও নির্দিষ্টভাবে বলতে গেলে, এটি হল একটি ee.computedObject, যার অর্থ হল এটি সার্ভারে থাকা কোনও কিছুর জন্য একটি প্রক্সি অবজেক্ট। ee.Thing-কে Google-এ পাঠানোর জন্য কোনও জিনিস কন্টেনারে রাখার উপায় হিসেবে ভাবুন। আপনার ক্লায়েন্ট জানে না যে কন্টেনারে কী আছে, তবে আপনি এটি প্রিন্ট করে জানতে পারবেন যে এতে কী আছে:

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

print(serverString);  // I am not a String

Python সেট-আপ

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

import ee
import geemap.core as geemap

Colab (Python)

print(server_string.getInfo())  # I am not a String

কন্টেনারটি দেখতে কেমন তা জানতে, অবজেক্টের স্ট্রিং রিপ্রেজেন্টেশন প্রিন্ট করুন:

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

print(serverString.toString());  // ee.String("I am not a String!")

Python সেট-আপ

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

import ee
import geemap.core as geemap

Colab (Python)

print(server_string)  # ee.String({"constantValue": "I am not a String!"})

কোনও কারণে, কন্টেনারে যা আছে তা ম্যানিপুলেট করার জন্য ক্লায়েন্টে রান করা Python বা JavaScript ব্যবহার করতে হলে, কন্টেনারের কন্টেন্ট পেতে এবং এটি একটি ভেরিয়েবলে অ্যাসাইন করতে getInfo() ব্যবহার করুন:

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

var someString = serverString.getInfo();
var strings = someString + '  Am I?';
print(strings);  // I am not a String!  Am I?

Python সেট-আপ

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

import ee
import geemap.core as geemap

Colab (Python)

some_string = server_string.getInfo()
strings = some_string + '  Am I?'
print(strings)  # I am not a String!  Am I?

লুপ

সার্ভার-সাইড ee.Thing অবজেক্টে কী আছে তা ক্লায়েন্ট জানে না বলে, কন্ডিশনাল ও for-loops-এর মতো ক্লায়েন্ট-সাইড অপারেশন এগুলির সাথে কাজ করে না। সেই কারণে এবং getInfo()-এ সিঙ্ক্রোনাস কল এড়াতে, যতটা সম্ভব সার্ভার ফাংশন ব্যবহার করুন। যেমন, তালিকা তৈরি করার নিম্নলিখিত দুটি উপায় বিবেচনা করুন:

সাজেস্ট করা হয় না — ক্লায়েন্ট-সাইড for-loop

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

var clientList = [];
for(var i = 0; i < 8; i++) {
  clientList.push(i + 1);
}
print(clientList);

Python সেট-আপ

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

import ee
import geemap.core as geemap

Colab (Python)

client_list = []
for i in range(8):
  client_list.append(i + 1)
print(client_list)

সাজেস্ট করা — সার্ভার-সাইড ম্যাপিং

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

var serverList = ee.List.sequence(0, 7);
serverList = serverList.map(function(n) {
  return ee.Number(n).add(1);
});
print(serverList);

Python সেট-আপ

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

import ee
import geemap.core as geemap

Colab (Python)

server_list = ee.List.sequence(0, 7)
server_list = server_list.map(lambda n: ee.Number(n).add(1))
print(server_list.getInfo())

সার্ভার-সাইড ম্যাপিংয়ের উদাহরণটি একটু বোকা বোকা কারণ আপনি একই তালিকা সহজেই ee.List.sequence(1, 8) দিয়ে তৈরি করতে পারতেন, তবে এটি কিছু গুরুত্বপূর্ণ ধারণা ব্যাখ্যা করে। প্রথম ধারণাটি হল map() যা তালিকার সবকিছুর উপর একই ফাংশন প্রয়োগ করে। এই ফাংশন সার্ভারে এক্সিকিউট করা হয় বলে, ম্যাপ করা ফাংশনে getInfo() এবং print()-এর মতো ক্লায়েন্ট-সাইড ফাংশন কাজ করবে না। সেই কারণে, i + 1 কোডটি সমতুল্য সার্ভার-সাইড কোড দিয়ে পরিবর্তন করতে হবে: ee.Number(n).add(1)। n অবজেক্টটি শুধুমাত্র সার্ভারে উপলভ্য। যেহেতু ফাংশনটি তার আর্গুমেন্টের ধরন জানে না, তাই এটিকে ee.Number-এ কাস্ট করতে হবে।

(কোন ফাংশন ক্লায়েন্টে রান করে তার বিবরণের জন্য ক্লায়েন্ট ও সার্ভার ফাংশন সংক্রান্ত বিভাগ দেখুন।)

এছাড়াও, এটি মনে রাখা দরকার যে মাঝে মাঝে ক্লায়েন্ট-সাইড কার্যকারিতা সুবিধাজনক হয়। যেমন, আগের for লুপটি একটি তালিকা তৈরি করতে এবং এটিকে একটি সার্ভার-সাইড অবজেক্টের সাথে র‌্যাপ করতে ব্যবহার করা যেতে পারে:

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

var toServerList = ee.List(clientList);

Python সেট-আপ

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

import ee
import geemap.core as geemap

Colab (Python)

to_server_list = ee.List(client_list)

মনে রাখবেন যে ক্লায়েন্ট-সাইড প্রসেসিং আপনার নোটবুক বা ব্রাউজারে, হোস্ট মেশিনের CPU-তে করা হয়, তাই সার্ভারে কাজ করার জন্য Earth Engine ব্যবহার করার চেয়ে এটি কম দক্ষ হতে পারে। এছাড়াও, সম্ভাব্য অপ্রত্যাশিত ফলাফল এড়াতে, আপনার স্ক্রিপ্টে ক্লায়েন্ট এবং সার্ভার কার্যকারিতা মিশ্রিত করা এড়ানো ভাল অভ্যাস। শর্তাবলী বিভাগে সম্ভাব্য অনিচ্ছাকৃত ফলাফলের একটি উদাহরণ দেওয়া হয়েছে।

শর্তসাপেক্ষ বাক্য

সার্ভার-সাইড অবজেক্ট ক্লায়েন্ট-সাইড ফাংশনের সাথে কাজ নাও করতে পারে এবং এর বিপরীতও হতে পারে। যেমন, সার্ভার-সাইড বুলিয়ান ভেরিয়েবেলের ক্ষেত্রে:

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

var myList = ee.List([1, 2, 3]);
var serverBoolean = myList.contains(5);
print(serverBoolean);  // false

Python সেট-আপ

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

import ee
import geemap.core as geemap

Colab (Python)

my_list = ee.List([1, 2, 3])
server_boolean = my_list.contains(5)
print(server_boolean.getInfo())  # False

নিচের উদাহরণে যেমন দেখানো হয়েছে, ভেরিয়েবলটি ক্লায়েন্ট-সাইড কন্ডিশনে কাজ করে না কারণ এটি একটি সার্ভার-সাইড অবজেক্ট। সার্ভার-সাইড বুলিয়ান সঠিকভাবে চেক করতে, সার্ভার-সাইড ফাংশন ব্যবহার করুন:

সাজেস্ট করা হয় না — ক্লায়েন্ট-সাইড কন্ডিশনাল

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

var clientConditional;
if (serverBoolean) {
  clientConditional = true;
} else {
  clientConditional = false;
}
print('Should be false:', clientConditional);  // True!

Python সেট-আপ

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

import ee
import geemap.core as geemap

Colab (Python)

if server_boolean:
  client_conditional = True
else:
  client_conditional = False
print('Should be False:', client_conditional)  # True!

সাজেস্ট করা হয়েছে — সার্ভার-সাইড শর্তাধীন

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

var serverConditional = ee.Algorithms.If(serverBoolean, 'True!', 'False!');
print('Should be false:', serverConditional);  // False!

Python সেট-আপ

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

import ee
import geemap.core as geemap

Colab (Python)

server_conditional = ee.Algorithms.If(server_boolean, 'True!', 'False!')
print('Should be False:', server_conditional.getInfo())  # False!

ক্লায়েন্ট ও সার্ভার ফাংশন

ক্লায়েন্ট ও সার্ভার অবজেক্ট ও ফাংশন একসাথে ব্যবহার করা কেন অদক্ষ বা অযৌক্তিক, তার বিভিন্ন কারণ আগের বিভাগে বর্ণনা করা হয়েছে। কোন অবজেক্ট ও ফাংশন ক্লায়েন্ট-সাইড এবং কোনগুলি সার্ভার-সাইড? সাধারণত, ee.Thing হিসেবে শুরু করা যেকোনও কিছু হল সার্ভার অবজেক্ট এবং সেই অবজেক্টের যেকোনও পদ্ধতি, ee.Thing.method(), হল সার্ভার ফাংশন। Python বা JavaScript রেফারেন্সে দেখানো অবজেক্ট ও ফাংশন ক্লায়েন্ট-সাইড। আগে যেমন উল্লেখ করা হয়েছে, আপনি ক্লায়েন্ট-সাইড ফাংশনালিটি ব্যবহার করে অবজেক্ট তৈরি করতে পারেন, তারপর ক্লায়েন্ট-সাইড অবজেক্ট Earth Engine কনস্ট্রাক্টরে পাঠিয়ে সেটি র‍্যাপ করতে পারেন, যেমন ee.String()।