Python সংক্রান্ত সহায়তা
Earth Engine Python ক্লায়েন্ট লাইব্রেরি Google Cloud-এ কাজ করে এমন Python ভার্সন-এর সাথে মানানসই। Python পয়েন্ট রিলিজ শিডিউল (PEP 602; Python ভার্সনের স্ট্যাটাস) অনুযায়ী প্রতি বছর সহায়তা আপডেট করা হয়। কাজ করে না এমন Python ভার্সন ব্যবহার করলে, যাচাইকরণে সমস্যা, অপ্রত্যাশিত আচরণ বা নির্দিষ্ট কিছু অপারেশন কাজ না করার মতো সমস্যা হতে পারে।
ইনস্টল করার বিকল্প
আপনি Google Colab ব্যবহার করলে, Earth Engine Python ক্লায়েন্ট লাইব্রেরির লেটেস্ট ভার্সন আগে থেকেই ইনস্টল করা আছে (pip-এর মাধ্যমে)। Earth Engine ও Colab ব্যবহার শুরু করতে নিম্নলিখিত নোটবুক ব্যবহার করে দেখুন:
আপনি Colab ব্যবহার না করলে, Earth Engine ক্লায়েন্ট লাইব্রেরি ম্যানুয়ালি ইনস্টল করা যেতে পারে এবং conda (সাজেস্ট করা) বা pip ব্যবহার করে আপনার সিস্টেমে আপডেট করা যেতে পারে:
প্যাকেজ ইমপোর্ট
Python API প্যাকেজকে ee বলা হয়। প্রতিটি নতুন Python সেশন ও স্ক্রিপ্টের জন্য এটি ইমপোর্ট ও ইনিশিয়ালাইজ করতে হবে:
import ee
যাচাইকরণ ও ইনিশিয়ালাইজেশন
Earth Engine Python ক্লায়েন্ট লাইব্রেরি ব্যবহার করার আগে, আপনাকে যাচাই করতে হবে এবং Python ক্লায়েন্ট শুরু করার জন্য ফলাফল সংক্রান্ত ক্রেডেনশিয়াল ব্যবহার করতে হবে। রান করুন:
ee.Authenticate()
এটি আপনার এনভায়রনমেন্টের জন্য সেরা যাচাইকরণ মোড বেছে নেবে এবং আপনার স্ক্রিপ্টের জন্য অ্যাক্সেস কনফার্ম করতে আপনাকে প্রম্পট করবে। শুরু করতে, আপনাকে এমন একটি প্রোজেক্ট প্রদান করতে হবে যার মালিক আপনি, অথবা সেটি ব্যবহার করার অনুমতি আপনার কাছে আছে। এই প্রোজেক্টটি Earth Engine-এর সব অপারেশন চালানোর জন্য ব্যবহার করা হবে:
ee.Initialize(project='my-project')
সমস্যার সমাধান করতে এবং যাচাইকরণ মোড ও Cloud প্রোজেক্ট সম্পর্কে আরও জানতে যাচাইকরণ গাইড দেখুন।
হ্যালো ওয়ার্ল্ড!
Earth Engine-এর সাথে কাজ করার জন্য আপনি প্রস্তুত কিনা তা পরীক্ষা করার জন্য এখানে একটি ছোট স্ক্রিপ্ট দেওয়া হল।
import ee ee.Authenticate() ee.Initialize(project='my-project') print(ee.String('Hello from the Earth Engine servers!').getInfo())
সিন্ট্যাক্স
Python এবং JavaScript API দুটিই একই সার্ভার-সাইড কার্যকারিতা অ্যাক্সেস করে, কিন্তু ক্লায়েন্ট-সাইড এক্সপ্রেশন (ক্লায়েন্ট বনাম সার্ভার সম্পর্কে আরও জানুন) ল্যাঙ্গুয়েজ সিনট্যাক্সের পার্থক্যের কারণে আলাদা হতে পারে। JavaScript API-এর তুলনায় Python API নিয়ে কাজ করার সময় আপনি যেসব সাধারণ সিনট্যাক্সগত পার্থক্য দেখতে পাবেন তার তালিকা নিম্নলিখিত টেবিলে দেওয়া হল।
| প্রপার্টি | জাভাস্ক্রিপ্ট | Python |
|---|---|---|
| ফাংশনের সংজ্ঞা |
function myFun(arg) { return arg; } var myFun = function(arg) { return arg; }; |
def my_fun(arg): return arg |
| নামহীন ফাংশন ম্যাপিং |
var foo = col.map(function(arg) { return arg; }); |
foo = col.map(lambda arg: arg) |
| ভেরিয়েবল সংক্রান্ত সংজ্ঞা |
var myVar = 'var'; |
my_var = 'var' |
| লজিক্যাল অপারেটর |
var match = such.and(that); var match = such.or(that); var match = such.not(that); |
match = such.And(that) match = such.Or(that) match = such.Not(that) |
| মাল্টি-লাইন মেথড চেইন |
var foo = my.really() .reallyLong() .methodChain(); |
foo = (my.really() .reallyLong() .methodChain()) |
| ডিকশনারি কী |
var dic = {'key': value}; var dic = {key: value}; |
dic = {'key': value} |
| ডিকশনারি অবজেক্ট অ্যাক্সেস |
var value = dic.key; var value = dic['key']; |
value = dic['key'] |
| ফাংশন আর্গুমেন্টের সংজ্ঞা |
// Positional arguments. var foo = fun(argX, argY, argZ); // Keyword arguments object. var foo = fun({y: argY}); |
# Positional arguments. foo = fun(arg_x, arg_y, arg_z) # Keyword arguments dictionary. foo = fun(**{'y': arg_y}) # Keyword arguments. foo = fun(x=arg_x, z=arg_z) |
| বুলিয়ান |
var t = true; var f = false; |
t = True f = False |
| Null ভ্যালু |
var na = null; |
na = None |
| মন্তব্য |
// |
# |
তারিখ অবজেক্ট
datetime মডিউলের সাহায্যে ক্লায়েন্ট-সাইড ডেট অবজেক্ট নির্ধারণ ও ম্যানিপুলেট করুন। আপনার স্ক্রিপ্টে মডিউলটি অন্তর্ভুক্ত করুন:
import datetime
ee.Date-কে ক্লায়েন্ট-সাইড তারিখে কনভার্ট করুন:
ee_date = ee.Date('2020-01-01') py_date = datetime.datetime.utcfromtimestamp(ee_date.getInfo()['value']/1000.0)
ক্লায়েন্ট-সাইড তারিখ ee.Date:-এ কনভার্ট করুন
py_date = datetime.datetime.utcnow() ee_date = ee.Date(py_date)
ডেটা এক্সপোর্ট করুন
Python API-এর মাধ্যমে ডেটা এক্সপোর্ট করতে ee.batch
মডিউল ব্যবহার করতে হয়, যা
Export
ফাংশনের জন্য ইন্টারফেস প্রদান করে। JavaScript API-এর মতোই প্যারামিটার আর্গুমেন্ট পাস করুন, তবে উপরে সিনট্যাক্স টেবিলে
উল্লেখ করা পার্থক্যগুলি মনে রাখবেন। নির্দিষ্ট টাস্কে start() মেথড কল করে
এক্সপোর্ট টাস্ক শুরু করতে হবে। টাস্কের স্ট্যাটাস সম্পর্কে জানতে
status() মেথড কল করুন। নিম্নলিখিত উদাহরণে ee.Image অবজেক্ট
এক্সপোর্ট করার পদ্ধতি দেখানো হয়েছে।
এক্সপোর্ট টাস্ক তৈরি করুন:
task = ee.batch.Export.image.toDrive(image=my_image, # an ee.Image object. region=my_geometry, # an ee.Geometry object. description='mock_export', folder='gdrive_folder', fileNamePrefix='mock_export', scale=1000, crs='EPSG:4326')
এক্সপোর্ট টাস্ক শুরু করুন:
task.start()
এক্সপোর্ট টাস্কের স্ট্যাটাস চেক করুন:
task.status()
task.status()-এর ফলাফল হল একটি ডিকশনারি যাতে টাস্কের স্ট্যাটাস এবং এর আইডির মতো তথ্য থাকে।
{ 'state': 'READY', 'description': 'my_export_task', 'creation_timestamp_ms': 1647567508236, 'update_timestamp_ms': 1647567508236, 'start_timestamp_ms': 0, 'task_type': 'EXPORT_IMAGE', 'id': '56TVJIZABUMTD5CJ5YHTMYK4', 'name': 'projects/earthengine-legacy/operations/56TVJIZABUMTX5CJ5HHTMYK4' }
state ফিল্ড ব্যবহার করে আপনি টাস্কের অগ্রগতি মনিটর করতে পারবেন।
state ভ্যালুর তালিকা এবং
টাস্ক লাইফসাইকেল সম্পর্কে আরও তথ্যের জন্য
প্রসেসিং এনভায়রনমেন্ট পৃষ্ঠা দেখুন।
অবজেক্ট প্রিন্ট করুন
Python-এ Earth Engine অবজেক্ট প্রিন্ট করলে অবজেক্টের জন্য সিরিয়ালাইজ করা অনুরোধ প্রিন্ট হয়, অবজেক্ট নিজে নয়। এর কারণ বুঝতে ক্লায়েন্ট বনাম সার্ভার পৃষ্ঠা দেখুন।
সার্ভার থেকে ক্লায়েন্টে কাঙ্ক্ষিত অবজেক্ট পেতে Earth Engine অবজেক্টে getInfo() কল করুন:
# Load a Landsat image. img = ee.Image('LANDSAT/LT05/C02/T1_L2/LT05_034033_20000913') # Print image object WITHOUT call to getInfo(); prints serialized request instructions. print(img) # Print image object WITH call to getInfo(); prints image metadata. print(img.getInfo())
getInfo() হল একটি সিঙ্ক্রোনাস অপারেশন, যার অর্থ হল getInfo() কলের পরে এক্সপ্রেশনের এক্সিকিউশন
ক্লায়েন্টের কাছে ফলাফল ফেরত না আসা পর্যন্ত ব্লক করা থাকে।
এছাড়াও, অনেক ডেটা বা জটিল গণনার জন্য অনুরোধ করা হলে, তা কোনও সমস্যা দেখাতে পারে এবং/অথবা
হ্যাং করতে পারে। সাধারণত, পেশাদার পদ্ধতি হল
আপনার ফলাফল এক্সপোর্ট করা,
এবং একবার সম্পূর্ণ হয়ে গেলে, আরও বিশ্লেষণের জন্য সেগুলিকে একটি নতুন স্ক্রিপ্টে ইমপোর্ট করা।
UI অবজেক্ট
Earth Engine ui মডিউল শুধুমাত্র JavaScript API কোড এডিটরের মাধ্যমে
উপলভ্য। Python-এ UI এলিমেন্টের জন্য থার্ড-পার্টি লাইব্রেরি ব্যবহার করুন। geemap,
Folium এবং
ipyleaflet-এর মতো
লাইব্রেরি ইন্টার্যাক্টিভ ম্যাপ ডিসপ্লে প্রদান করে, যেখানে
Matplotlib,
Altair বা
seaborn-এর মতো লাইব্রেরি ব্যবহার করে চার্ট তৈরি করা যায়। geemap ও Matplotlib ব্যবহার করার জন্য
Colab সেট-আপ নোটবুকে Earth Engine-এ উদাহরণ দেখুন।
ডেভেলপার নির্দেশিকায় Python
Earth Engine ডেভেলপার নির্দেশিকা জুড়ে Python কোড অন্তর্ভুক্ত করা হয়েছে। যেখানে উপলভ্য,
কোড ব্লকের উপরে "Colab (Python)" ট্যাবে ক্লিক করে কোডের উদাহরণ দেখা যেতে পারে।
এছাড়াও, গাইড পৃষ্ঠার উপরের দিকে Colab নোটবুক হিসেবে পৃষ্ঠাটি রান করা বা GitHub-এ দেখার জন্য
বোতাম থাকতে পারে। Python কোডের উদাহরণগুলি
Google Colab ব্যবহার করে চালানোর জন্য তৈরি করা হয়েছে। ইন্টার্যাক্টিভ ম্যাপ ও অবজেক্ট এক্সপ্লোরেশন
geemap
লাইব্রেরি দ্বারা ম্যানেজ করা হয়। Earth Engine Python ক্লায়েন্ট লাইব্রেরি এবং geemap দুটিই Colab-এ আগে থেকে ইনস্টল করা
থাকে।
Earth Engine সেট-আপ
Python কোড রান করার জন্য আপনাকে Earth Engine লাইব্রেরি ইমপোর্ট, যাচাইকরণ ও শুরু করতে হবে। উদাহরণে নিম্নলিখিত কমান্ড ব্যবহার করা হয় (বিকল্পের জন্য যাচাইকরণ ও শুরু করা পৃষ্ঠা দেখুন)।
import ee ee.Authenticate() ee.Initialize(project='my-project')
geemap-এর সাথে ইন্টার্যাক্টিভ এক্সপ্লোরেশন
ম্যাপ টাইল দেখাতে এবং Earth Engine অবজেক্টের সমৃদ্ধ উপস্থাপনা প্রিন্ট করতে
geemap লাইব্রেরি ব্যবহার করা হয়।
এইসব ফিচারের জন্য লাইব্রেরি যথাক্রমে
ipyleaflet
এবং eerepr-এর উপর নির্ভর করে।
geemap লাইব্রেরি এবং এর ডিপেন্ডেন্সি Google Colab-এ আগে থেকেই ইনস্টল করা থাকে;
প্রতিটি সেশনে এটি ইমপোর্ট করুন।
import geemap.core as geemap
geemap.Map অবজেক্ট ব্যবহার করে ee.Image এবং
ee.FeatureCollection-এর মতো ভৌগোলিক Earth Engine ডেটা ক্লাস দেখা যেতে পারে।
প্রথমে, ম্যাপ অবজেক্ট নির্ধারণ করুন। তারপর, এতে লেয়ার যোগ করুন বা এর ভিউপোর্ট পরিবর্তন করুন।
# Initialize a map object. m = geemap.Map() # Define an example image. img = ee.Image.random() # Add the image to the map. m.add_layer(img, None, 'Random image') # Display the map (you can call the object directly if it is the final line). display(m)
Google Colab-এ রান করুন
GitHub-এ সোর্স দেখুন