Earth Engine Python API, Python প্যাকেজ ও এনভায়রনমেন্ট ম্যানেজার conda-এর মাধ্যমে লোকাল মেশিনে ইনস্টল করা যেতে পারে। Conda-কে Anaconda এবং Miniconda Python ডিস্ট্রিবিউশনের সাথে বান্ডেল করা হয়। Anaconda হল একটি ডেটা সায়েন্স প্রোগ্রামিং প্ল্যাটফর্ম যার মধ্যে ১৫০০+ প্যাকেজ রয়েছে, যেখানে Miniconda-তে শুধুমাত্র conda এবং তার নির্ভরতা রয়েছে। Earth Engine API ইনস্টল করা ও তার সাথে কাজ করার জন্য এই Python ডিস্ট্রিবিউশনের যেকোনও একটি উপযুক্ত। আপনি যদি এই ডিস্ট্রিবিউশন সম্পর্কে না জানেন, তাহলে আরও জানতে তাদের লিঙ্কে যান।
এই নির্দেশিকা আপনাকে এগুলি সম্পর্কে জানাবে:
- আগে থেকে থাকা conda ইনস্টল চেক করা হচ্ছে
- লোকাল মেশিনে conda ইনস্টল করা
- Earth Engine Python API ইনস্টল করা
- যাচাইকরণ সংক্রান্ত ক্রেডেনশিয়াল সেট-আপ করা হচ্ছে
- API পরীক্ষা করা
conda ইনস্টল করা আছে কিনা চেক করুন
আপনার সিস্টেমে conda আগে থেকেই ইনস্টল করা থাকলে, API ইনস্টল করুন বিভাগে যান। conda ইনস্টল করা আছে কিনা সেই বিষয়ে নিশ্চিত না হলে, আপনার কমান্ড লাইন ইন্টারফেসে নিম্নলিখিত কমান্ড লিখে যাচাই করুন।
conda --help
conda ইনস্টল করা থাকলে এবং PATH এনভায়রনমেন্টাল ভেরিয়েবলে এর সিস্টেম পাথ রেজিস্টার করা থাকলে, conda সহায়তা কন্টেন্ট টার্মিনালে দেখা যাবে। সহায়তা কন্টেন্ট দেখতে পেলে, API ইনস্টল করুন বিভাগে যান। conda শনাক্ত করা না গেলে, ফলাফলে এই ধরনের কিছু লেখা থাকবে: conda খুঁজে পাওয়া যায়নি বা কমান্ড হিসেবে শনাক্ত করা যায়নি। এমন হতে পারে যে, প্রোগ্রামটি আপনার সিস্টেমে আছে কিন্তু PATH এনভায়রনমেন্টাল ভেরিয়েবলে রেজিস্টার করা নেই। এমনটা হলেও, ধারাবাহিকতা বজায় রাখতে, conda ইনস্টল করুন বিভাগটি অনুসরণ করা চালিয়ে যান, কারণ সম্ভাব্য সব সিস্টেম কনফিগারেশন সম্পর্কে বলা কঠিন। আপনার হোম ফোল্ডারে 'miniconda3' ফোল্ডারটি না থাকলে, নিম্নলিখিত conda ইনস্টল করার নির্দেশাবলী সফলভাবে কাজ করবে। conda ইনস্টল করার লোকেশন ও রেজিস্ট্রেশন সম্পর্কে আরও জানতে, Miniconda ইনস্টলেশন ও Anaconda ইনস্টলেশন পৃষ্ঠা দেখুন।
conda ইনস্টল করুন
এই বিভাগে আপনি Miniconda ডাউনলোড ও ইনস্টল করবেন, যা Earth Engine API অ্যাক্সেস করার জন্য Python প্ল্যাটফর্ম হিসেবে কাজ করবে। উপরে বর্ণনা করা হয়েছে, আপনি Miniconda বা Anaconda ব্যবহার করতে পারেন, তবে আপনার সিস্টেমে প্রভাব কমাতে, এই নির্দেশিকা আপনার সিস্টেমের এনভায়রনমেন্ট ভেরিয়েবলে কোনও পরিবর্তন না করে Miniconda ইনস্টলেশন বর্ণনা করবে। আপনি Anaconda পছন্দ করলে, এখানে দেওয়া ইনস্টলেশন সংক্রান্ত নির্দেশাবলী দেখুন এবং তারপরে API ইনস্টল করুন বিভাগে যান।
Miniconda ইনস্টল করুন
Miniconda ডাউনলোড ও ইনস্টল করার প্রক্রিয়া তিনটি ধাপে সম্পন্ন হয়:
- আপনার হোম ডিরেক্টরিতে ৬৪-বিট Python 3 Miniconda ইনস্টলার ডাউনলোড করুন
- ইনস্টলার রান করুন
- ইনস্টলার মুছে দিন
আপনার সিস্টেমের জন্য উপযুক্ত কমান্ড লাইন ইন্টারফেসে নিম্নলিখিত লাইনগুলি কপি ও পেস্ট করে এই ধাপগুলি সম্পূর্ণ করুন। ইনস্টল করার ফলে আপনার হোম ডিরেক্টরিতে 'miniconda3' নামের একটি ফোল্ডার যোগ করা হয়।
১. আপনার হোম ডিরেক্টরিতে Miniconda ইনস্টলার ডাউনলোড করুন।
Linux
wget https://repo.continuum.io/miniconda/Miniconda3-latest-Linux-x86_64.sh -O ~/miniconda.sh
Mac
curl https://repo.anaconda.com/miniconda/Miniconda3-latest-MacOSX-x86_64.sh -o ~/miniconda.sh
Windows
powershell -command "Invoke-WebRequest -Uri https://repo.anaconda.com/miniconda/Miniconda3-latest-Windows-x86_64.exe -OutFile ~\miniconda.exe"
২. আপনার হোম ডিরেক্টরিতে ডিফল্ট সেটিংস গ্রহণ করে Miniconda ইনস্টল করুন।
Linux
bash ~/miniconda.sh -b
Mac
bash ~/miniconda.sh -b
Windows
start /B /WAIT %UserProfile%\miniconda.exe /InstallationType=JustMe /AddToPath=0 /RegisterPython=0 /S /D=%UserProfile%\miniconda3
৩. আপনার হোম ডিরেক্টরি থেকে Miniconda ইনস্টলার সরিয়ে দিন।
Linux
rm ~/miniconda.sh
Mac
rm ~/miniconda.sh
Windows
del %UserProfile%\miniconda.exe
Miniconda ইনস্টল করা হয়েছে কিনা তা পরীক্ষা করুন
Miniconda ইনস্টল করা হয়েছে কিনা তা পরীক্ষা করতে conda কমান্ডের সহায়তা মেনু প্রিন্ট করুন।
Miniconda আপনার সিস্টেমের PATH এনভায়রনমেন্ট ভেরিয়েবলে যোগ করা হয়নি, তাই আপনাকে প্রথমে এই সেশনের জন্য conda অ্যাক্টিভেট করতে হবে। এর জন্য সম্পূর্ণ সিস্টেম পাথ ব্যবহার করে activate কমান্ড কল করতে হবে। পরীক্ষা সফল হলে
টার্মিনালে condaটি সহায়তা কন্টেন্ট দেখা যাবে। আপনার সিস্টেমের কমান্ড লাইন ইন্টারফেসে
নিম্নলিখিত লাইনগুলি রান করুন।
Linux
source $HOME/miniconda3/bin/activate conda --help
Mac
source $HOME/miniconda3/bin/activate conda --help
Windows
%UserProfile%\miniconda3\condabin\activate conda --help
PATH ভেরিয়েবেলে Miniconda যোগ করুন
আপনি চাইলে Miniconda ইনস্টলেশন পাথ আপনার সিস্টেমের
PATH ভেরিয়েবলে যোগ করতে পারেন, যার ফলে আপনি conda-র সাথে ইন্টার্যাক্ট করতে পারবেন
conda-এ একটি সাধারণ কল করে, যেখানে আপনাকে প্রথমে activate
কমান্ডটি তার সম্পূর্ণ পাথ দিয়ে রান করতে হবে না। নিম্নলিখিত নির্দেশাবলী আপনার সিস্টেমের PATH ভেরিয়েবলে
Miniconda ইনস্টল যোগ করার মাধ্যমে আপনাকে গাইড করে।
Linux
নিচে দেওয়া GUI বা কমান্ড লাইন নির্দেশাবলী সম্পূর্ণ করে আপনার 'PATH' এনভায়রনমেন্টাল ভেরিয়েবলে নিম্নলিখিত পাথ যোগ করুন।
$HOME/miniconda3/bin
Government Uniform Invoice
১. আপনার $HOME ডিরেক্টরিতে পাওয়া .bashrc ফাইলটি টেক্সট এডিটরে
খুলুন।
xdg-open ~/.bashrc
২. ফাইলের নিচে নিম্নলিখিত লাইনগুলি কপি করে পেস্ট করুন।
# add path to conda export PATH="$HOME/miniconda3/bin:$PATH"
৩. ফাইলটি সেভ করে টেক্সট এডিটর বন্ধ করুন।
কমান্ড লাইন
~/.bashrc ফাইলে conda পাথ যোগ করতে টার্মিনালে নিম্নলিখিত কমান্ড লিখুন।
printf '\n# add path to conda\nexport PATH="$HOME/miniconda3/bin:$PATH"\n' >> ~/.bashrc
Mac
নিচে দেওয়া GUI বা কমান্ড লাইন নির্দেশাবলী সম্পূর্ণ করে আপনার 'PATH' এনভায়রনমেন্টাল ভেরিয়েবলে নিম্নলিখিত পাথ যোগ করুন।
$HOME/miniconda3/bin
Government Uniform Invoice
১. আপনার $HOME ডিরেক্টরিতে পাওয়া .bashrc ফাইলটি টেক্সট এডিটরে
খুলুন।
touch ~/.bashrc; open -t ~/.bashrc
২. ফাইলের নিচে নিম্নলিখিত লাইনগুলি কপি করে পেস্ট করুন।
# add path to conda export PATH="$HOME/miniconda3/bin:$PATH"
৩. ফাইলটি সেভ করে টেক্সট এডিটর বন্ধ করুন।
কমান্ড লাইন
~/.bashrc ফাইলে conda পাথ যোগ করতে টার্মিনালে নিম্নলিখিত কমান্ড লিখুন।
printf '\n# add path to conda\nexport PATH="$HOME/miniconda3/bin:$PATH"\n' >> ~/.bashrc
Windows
নিচে দেওয়া GUI বা কমান্ড লাইন নির্দেশাবলী সম্পূর্ণ করে আপনার 'পাথ' এনভায়রনমেন্টাল ভেরিয়েবলে নিচে উল্লেখ করা পাথ যোগ করুন।
%UserProfile%\miniconda3\condabin
GUI
১. 'এনভায়রনমেন্টাল ভেরিয়েবল' ডায়ালগ খুলতে কমান্ড প্রম্পটে নিম্নলিখিত লাইনটি লিখুন।
rundll32 sysdm.cpl,EditEnvironmentVariables
২. এডিট করার জন্য বেছে নিতে 'ব্যবহারকারী' বিভাগের অধীনে 'পাথ' ভেরিয়েবলে ডবল-ক্লিক করুন।
৩. এডিটর খুলতে নতুন 'এডিট করুন' ডায়ালগ উইন্ডোতে 'টেক্সট এডিট করুন' বোতামে ক্লিক করুন।
৪. আগে থেকে থাকা 'Path' ভেরিয়েবেল ভ্যালুর শেষে নিম্নলিখিত স্ট্রিং যোগ করুন। নিশ্চিত করুন যে সেমিকোলন (;) এন্ট্রিকে ঘিরে রেখেছে যাতে এটি আশেপাশের এন্ট্রি থেকে আলাদা করা যায়।
%UserProfile%\miniconda3\condabin;
৫. সব ডায়ালগ উইন্ডো বন্ধ না হওয়া পর্যন্ত 'ঠিক আছে' বোতামে ক্লিক করুন।
কমান্ড লাইন
পাথ যোগ করতে setx কমান্ড ব্যবহার করুন। কমান্ড প্রম্পট থেকে এটি লিখুন:
setx Path "%Path%%UserProfile%\miniconda3\condabin;"
conda শুরু করুন
শেল ইন্টার্যাকশনের জন্য conda ইনিশিয়ালাইজ করুন। বিভিন্ন শেলের জন্য ইনিশিয়ালাইজেশন সংক্রান্ত তথ্যের জন্য প্রোসিডিং কমান্ড রান করুন। কমান্ড লেখার পরে কনসোলে প্রিন্ট করা পরবর্তী নির্দেশাবলী অনুসরণ করুন।
conda init --help
আপনার কমান্ড লাইন ইন্টারফেস রিস্টার্ট করার পরে, আপনি নিম্নলিখিত কমান্ডের সাহায্যে বেস conda এনভায়রনমেন্ট অ্যাক্টিভেট করতে পারবেন।
conda activate
API ইনস্টল করুন
Earth Engine Python API, conda-forge প্যাকেজ হিসেবে এখানে ডিস্ট্রিবিউট করা হয়:
https://anaconda.org/conda-forge/earthengine-api.
এটি conda install কমান্ডের মাধ্যমে ইনস্টল করা হয়। তবে, ইনস্টল করার আগে, Earth Engine-এর জন্য বিশেষভাবে একটি conda এনভায়রনমেন্ট তৈরি করুন।
Earth Engine API-কে নিজস্ব এনভায়রনমেন্টে ইনস্টল করলে, এটি এবং এর উপর নির্ভরশীল প্যাকেজগুলি আপনার বেস এনভায়রনমেন্ট বা আগে সেট-আপ করা অন্য কোনও এনভায়রনমেন্টের সাথে ভার্সন সংক্রান্ত সমস্যা তৈরি করবে না এবং এর উল্টোটাও হবে না। conda এনভায়রনমেন্ট ম্যানেজ করার ব্যাপারে আরও জানতে,
এই সাইট দেখুন।
১. আপনার বেস conda এনভায়রনমেন্ট আগে থেকে অ্যাক্টিভেট করা না থাকলে, তা অ্যাক্টিভেট করুন।
Linux
source $HOME/miniconda3/bin/activate
Mac
source $HOME/miniconda3/bin/activate
Windows
%UserProfile%\miniconda3\condabin\activate
২. Earth Engine API-এর জন্য conda ভার্চুয়াল এনভায়রনমেন্ট তৈরি করুন।
conda create --name ee
আপনাকে এনভায়রনমেন্ট তৈরি করার বিষয়টি কনফার্ম করতে বলা হবে, সেটি করুন।
৩. conda ee এনভায়রনমেন্ট অ্যাক্টিভেট করুন।
conda activate ee
৪. conda ee এনভায়রনমেন্টে API ইনস্টল করুন। কমান্ড লাইনের শুরুতে (ee)
আছে কিনা তা নিশ্চিত করুন, যা নির্দেশ করে যে আপনি ee এনভায়রনমেন্ট
থেকে কাজ করছেন।
conda install -c conda-forge earthengine-api
আপনাকে API এবং এর ডিপেন্ডেন্সি ইনস্টল করার বিষয়টি কনফার্ম করতে বলা হবে। কনফার্ম করার পরে, conda ডিপেন্ডেন্সি ডাউনলোড ও ইনস্টল করবে। সবকিছু ঠিকঠাক থাকলে, আপনার কাছে এখন 'ee' নামে একটি conda এনভায়রনমেন্ট থাকবে
যেখানে API অ্যাক্সেস করার জন্য প্রয়োজনীয় সব কিছু এবং
earthengine কমান্ড লাইন টুল থাকবে।
ক্রেডেনশিয়াল পান
Earth Engine API বা earthengine কমান্ড লাইন টুল ব্যবহার করার আগে, আপনাকে একবার যাচাইকরণ করতে হবে যা আপনার Google অ্যাকাউন্টের হয়ে Earth
Engine-এ অ্যাক্সেস অনুমোদন করে। যাচাই করতে, earthengine কমান্ড লাইন টুল থেকে
authenticate কমান্ড ব্যবহার করুন।
আপনার conda ee এনভায়রনমেন্টে নিম্নলিখিত কমান্ড রান করুন এবং ফলাফল হিসেবে প্রিন্ট করা নির্দেশাবলী অনুসরণ করুন। একটি URL প্রদান করা হবে যা চুক্তির পরে একটি অনুমোদনের কোড জেনারেট করে। অথরাইজেশন কোড কপি করে কমান্ড লাইন ইনপুট হিসেবে লিখুন।
earthengine authenticate
অনুমোদন কোড লেখার পরে, একটি অনুমোদন টোকেন ক্রেডেনশিয়াল ফাইলে সেভ হয়ে যায়
যা নিচে দেখতে পাবেন। এর পরে
API-এর ee.Initialize() কমান্ড এবং earthengine কমান্ড লাইন টুল
যাচাইকরণের জন্য এই ফাইলটি দেখবে। আপনি যদি অনুমোদন প্রত্যাহার করতে চান, তাহলে শুধু ক্রেডেনশিয়াল ফাইলটি মুছে দিন।
Linux
ls $HOME/.config/earthengine/credentials
Mac
ls $HOME/.config/earthengine/credentials
Windows
dir %UserProfile%\.config\earthengine\credentials
API পরীক্ষা করা
API ইনস্টলেশন পরীক্ষা করতে, DEM ডেটাসেটের জন্য মেটাডেটা প্রিন্ট করে এমন একটি সাধারণ Python স্ক্রিপ্ট রান করুন। এটি কনসোলে একটি JSON অবজেক্ট প্রিন্ট করবে।
১. আপনার conda ee এনভায়রনমেন্ট থেকে python ইন্টারপ্রেটার চালু করুন।
python
২. DEM ডেটাসেটের জন্য মেটাডেটা প্রিন্ট করতে নিম্নলিখিত Python লাইনগুলি এক এক করে রান করুন
import ee # Initialize the Earth Engine module. ee.Initialize() # Print metadata for a DEM dataset. print(ee.Image('NASA/NASADEM_HGT/001').getInfo())
পরবর্তী API ব্যবহার
আপনি যখনই Earth Engine API ব্যবহার করতে চাইবেন, আপনাকে প্রথমে conda ee এনভায়রনমেন্ট অ্যাক্টিভেট করতে হবে। অ্যাক্টিভেশন পদ্ধতি নির্ভর করে conda শেল-এ ব্যবহারের জন্য রেজিস্টার করা আছে কিনা তার উপর। আপনার conda ইনস্টল করার জন্য নিচে প্রাসঙ্গিক নির্দেশাবলী অনুসরণ করুন।
Conda রেজিস্টার করা নেই
নিম্নলিখিত conda ee এনভায়রনমেন্ট অ্যাক্টিভেশন কমান্ড ধরে নেয় যে উপরে conda ইনস্টল করুন বিভাগে দেওয়া নির্দেশাবলী অনুসরণ করে conda ইনস্টল করা হয়েছে, অর্থাৎ আগের ধাপের উপর ভিত্তি করে ইনস্টল করার পাথ ধরে নেওয়া হয়েছে। কমান্ড লাইন ইন্টারফেসে এই কমান্ড রান করুন।
Linux
source $HOME/miniconda3/bin/activate ee
Mac
source $HOME/miniconda3/bin/activate ee
Windows
%UserProfile%\miniconda3\condabin\activate ee
Conda রেজিস্টার করা হয়েছে
নিম্নলিখিত conda ee এনভায়রনমেন্ট অ্যাক্টিভেশন কমান্ড ধরে নেয় যে conda শেল বা কমান্ড প্রম্পটে ব্যবহারের জন্য রেজিস্টার করা হয়েছে এই গাইডের নির্দেশাবলী বা অন্য উপায়ে। কমান্ড লাইন ইন্টারফেসে নিম্নলিখিত কমান্ড রান করুন।
conda activate ee
কমান্ড রান করার পরে, কমান্ড লাইনের শুরুতে আপনাকে (ee) দেখতে হবে, যা ইঙ্গিত করে যে আপনি ee
এনভায়রনমেন্ট থেকে কাজ করছেন।
আপনি এখন Python ইন্টারপ্রেটার চালু করতে এবং Earth Engine Python API অ্যাক্সেস করতে প্রস্তুত। Python API-এর সাথে কাজ করার বিষয়ে সাধারণ নির্দেশিকার জন্য Python ইনস্টল পৃষ্ঠা দেখুন।
API আপডেট করা হচ্ছে
লেটেস্ট API ভার্সনে আপনার ee এনভায়রনমেন্ট আপডেট করতে
conda update কমান্ড ব্যবহার করুন। মনে রাখবেন, আপনার conda ee
এনভায়রনমেন্ট আগে থেকে অ্যাক্টিভ না থাকলে, প্রথমে সেটি অ্যাক্টিভ করতে হবে।
conda update -c conda-forge earthengine-api
ee
লাইব্রেরি __version__ প্রপার্টি প্রিন্ট করে Python-এ বর্তমানে ইনস্টল করা ভার্সনের নম্বর পান। ee conda এনভায়রনমেন্ট কমান্ড লাইনে
python লিখে Python ইন্টারপ্রেটার চালু করুন এবং তারপর নিম্নলিখিত কমান্ড
লিখুন।
import ee print(ee.__version__)
আপনার ee এনভায়রনমেন্ট শেয়ার করা হচ্ছে
আপনার conda Python এনভায়রনমেন্ট অন্যদের সাথে শেয়ার করলে, পুনরুৎপাদনযোগ্য ও প্রতিলিপিযোগ্য ফলাফল পেতে সুবিধা হতে পারে, বিশেষ করে আপনি অতিরিক্ত Python প্যাকেজ ইনস্টল করে থাকলে। Conda অন্যদের আপনার এনভায়রনমেন্ট রেপ্লিকেট করার সুবিধাজনক উপায় প্রদান করে।
আপনার conda ee এনভায়রনমেন্ট থেকে, আপনার হোম ডিরেক্টরিতে 'ee-shared-env' নামের YAML ফাইল সেভ করতে, নিম্নলিখিত কমান্ড রান করুন, যা আপনার এনভায়রনমেন্টের স্পেসিফিকেশন তালিকাভুক্ত করে।
Linux
conda env export > $HOME/ee-shared-env.yml
Mac
conda env export > $HOME/ee-shared-env.yml
Windows
conda env export > %UserProfile%\ee-shared-env.yml
ফলাফল ফাইলটি শেয়ার করুন এবং প্রাপক নিম্নলিখিত conda কমান্ড রান করে এনভায়রনমেন্ট রেপ্লিকেট করতে পারবেন।
conda env create -f path-to-ee-shared-env.yml