Python इंस्टॉल करना - Conda इंस्टॉल करना

Earth Engine Python API को लोकल मशीन पर इंस्टॉल किया जा सकता है. इसके लिए, conda का इस्तेमाल करें. यह Python पैकेज और एनवायरमेंट मैनेजर है. Conda, Python के Anaconda और Miniconda डिस्ट्रिब्यूशन के साथ बंडल किया जाता है. Anaconda, डेटा साइंस प्रोग्रामिंग का एक प्लैटफ़ॉर्म है. इसमें 1,500 से ज़्यादा पैकेज शामिल हैं. वहीं, Miniconda में सिर्फ़ conda और इसकी डिपेंडेंसी शामिल होती हैं. इनमें से कोई भी Python डिस्ट्रिब्यूशन, Earth Engine API को इंस्टॉल करने और उसके साथ काम करने के लिए सही है. अगर आपको इन डिस्ट्रिब्यूशन के बारे में नहीं पता है, तो ज़्यादा जानने के लिए कृपया इनके लिंक पर जाएं.

इस गाइड में, आपको इनके बारे में जानकारी मिलेगी:

• conda के मौजूदा इंस्टॉलेशन की जांच की जा रही है
• किसी लोकल मशीन पर conda इंस्टॉल करना
• Earth Engine Python API इंस्टॉल करना
• पुष्टि करने वाले क्रेडेंशियल सेट अप करना
• एपीआई की जांच करना

ध्यान दें: नीचे दिए गए चरण, Windows कमांड प्रॉम्प्ट या Unix टर्मिनल (Linux/Mac) में पूरे किए जाएंगे. अपने ऑपरेटिंग सिस्टम से जुड़ी कमांड पर स्विच करने के लिए, हर कोड सेक्शन के सबसे ऊपर मौजूद टैब का इस्तेमाल करें.

conda install की जांच करें

अगर आपके सिस्टम पर conda पहले से इंस्टॉल है, तो API इंस्टॉल करें सेक्शन पर जाएं. अगर आपको पक्के तौर पर नहीं पता है कि conda इंस्टॉल है या नहीं, तो कमांड-लाइन इंटरफ़ेस पर यह कमांड डालकर पुष्टि करें.

conda --help

अगर conda इंस्टॉल है और इसका सिस्टम पाथ, PATH एनवायरमेंटल वैरिएबल में रजिस्टर है, तो conda से जुड़ी मदद का कॉन्टेंट टर्मिनल में दिखना चाहिए. अगर सहायता से जुड़ा कॉन्टेंट दिखता है, तो एपीआई इंस्टॉल करें सेक्शन पर जाएं. अगर conda की पहचान नहीं हो पाती है, तो नतीजे में कुछ ऐसा दिखेगा: conda not found or not recognized as a command. ऐसा हो सकता है कि प्रोग्राम आपके सिस्टम पर मौजूद हो, लेकिन PATH एनवायरमेंटल वैरिएबल में रजिस्टर न हो. अगर ऐसा है, तो कृपया conda इंस्टॉल करें सेक्शन में दिए गए निर्देशों का पालन करें. ऐसा इसलिए, क्योंकि सभी संभावित सिस्टम कॉन्फ़िगरेशन के बारे में जानकारी देना मुश्किल है. जब तक आपके होम फ़ोल्डर में 'miniconda3' फ़ोल्डर मौजूद नहीं है, तब तक conda इंस्टॉल करने के ये निर्देश काम करेंगे. conda को इंस्टॉल करने की जगह और रजिस्ट्रेशन के बारे में ज़्यादा जानने के लिए, कृपया Miniconda Installation और Anaconda Installation पेज देखें.

conda इंस्टॉल करना

ध्यान दें: अगर आपके सिस्टम पर conda पहले से इंस्टॉल है, तो एपीआई इंस्टॉल करें सेक्शन पर जाएं.

इस सेक्शन में, Miniconda को डाउनलोड और इंस्टॉल किया जाएगा. यह Earth Engine API को ऐक्सेस करने के लिए, Python प्लैटफ़ॉर्म के तौर पर काम करेगा. ऊपर बताए गए तरीके से, Miniconda या Anaconda का इस्तेमाल किया जा सकता है. हालांकि, आपके सिस्टम पर कम से कम असर पड़े, इसके लिए इस गाइड में Miniconda को इंस्टॉल करने का तरीका बताया गया है. इससे आपके सिस्टम के एनवायरमेंट वैरिएबल में कोई बदलाव नहीं होगा. अगर आपको Anaconda का इस्तेमाल करना है, तो कृपया यहां दिए गए इंस्टॉलेशन के निर्देश देखें. इसके बाद, एपीआई इंस्टॉल करें सेक्शन पर जाएं.

Miniconda इंस्टॉल करना

Miniconda को तीन चरणों में डाउनलोड और इंस्टॉल किया जा सकता है:

1. 64-बिट Python 3 Miniconda इंस्टॉलर को अपनी होम डायरेक्ट्री में डाउनलोड करें
2. इंस्टॉलर चलाएं
3. इंस्टॉलर मिटाएं

इन चरणों को पूरा करने के लिए, यहां दी गई लाइनों को कॉपी करें और अपने सिस्टम के लिए सही कमांड लाइन इंटरफ़ेस में चिपकाएं. इंस्टॉल करने पर, आपकी होम डायरेक्ट्री में 'miniconda3' नाम का फ़ोल्डर जुड़ जाता है.

1. 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"

2. डिफ़ॉल्ट सेटिंग स्वीकार करके, अपनी होम डायरेक्ट्री में 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

3. अपनी होम डायरेक्ट्री से 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

ध्यान दें: चालू किए गए conda एनवायरमेंट को बंद करने के लिए, यह कमांड चलाएं: conda deactivate.

ध्यान दें: अगर Miniconda का पाथ, एनवायरमेंट वैरिएबल के तौर पर सेट नहीं किया गया है, जैसा कि इस इंस्टॉलेशन के मामले में है, तो आपको आने वाले समय में हर नए कमांड लाइन सेशन के लिए Miniconda को चालू करना होगा. इसमें API का इस्तेमाल भी शामिल है. ज़रूरत के मुताबिक Miniconda को चालू करने के लिए, ऊपर दिए गए कोड स्निपेट में से पहले निर्देश का इस्तेमाल करें.

PATH वैरिएबल में Miniconda जोड़ना

चेतावनी: अपने सिस्टम के PATH वैरिएबल में बदलाव करने से, अनचाहे नतीजे मिल सकते हैं.

आपके पास अपने सिस्टम के PATH वैरिएबल में Miniconda के इंस्टॉलेशन पाथ को जोड़ने का विकल्प होता है. इससे, आपको conda कमांड को उसके पूरे पाथ के साथ चलाने की ज़रूरत नहीं होगी. इसके बजाय, conda को कॉल करके conda के साथ इंटरैक्ट किया जा सकेगा.activate यहां दिए गए निर्देशों में, आपके सिस्टम के PATH वैरिएबल में Miniconda इंस्टॉल करने का तरीका बताया गया है.

Linux

नीचे दिए गए जीयूआई या कमांड लाइन के निर्देशों का पालन करके, अपने 'PATH' एनवायरमेंटल वैरिएबल में यह पाथ जोड़ें.

$HOME/miniconda3/bin

जीयूआई

1. टेक्स्ट एडिटर में, अपनी $HOME डायरेक्ट्री में मौजूद .bashrc फ़ाइल खोलें.

xdg-open ~/.bashrc

2. यहां दी गई लाइनों को कॉपी करें और फ़ाइल के सबसे नीचे चिपकाएं.

# add path to conda
export PATH="$HOME/miniconda3/bin:$PATH"

3. फ़ाइल को सेव करें और टेक्स्ट एडिटर को बंद करें.

ध्यान दें: जोड़े गए conda पाथ को हटाने के लिए, अभी जोड़ी गई लाइनों को मिटाएं.

कमांड लाइन

conda पाथ को ~/.bashrc फ़ाइल में जोड़ने के लिए, टर्मिनल में यह कमांड डालें.

printf '\n# add path to conda\nexport PATH="$HOME/miniconda3/bin:$PATH"\n' >> ~/.bashrc

Mac

नीचे दिए गए जीयूआई या कमांड लाइन के निर्देशों का पालन करके, अपने 'PATH' एनवायरमेंटल वैरिएबल में यह पाथ जोड़ें.

$HOME/miniconda3/bin

जीयूआई

1. टेक्स्ट एडिटर में, अपनी $HOME डायरेक्ट्री में मौजूद .bashrc फ़ाइल खोलें.

touch ~/.bashrc; open -t ~/.bashrc

2. यहां दी गई लाइनों को कॉपी करें और फ़ाइल के सबसे नीचे चिपकाएं.

# add path to conda
export PATH="$HOME/miniconda3/bin:$PATH"

3. फ़ाइल को सेव करें और टेक्स्ट एडिटर को बंद करें.

ध्यान दें: जोड़े गए conda पाथ को हटाने के लिए, अभी जोड़ी गई लाइनों को मिटाएं.

कमांड लाइन

conda पाथ को ~/.bashrc फ़ाइल में जोड़ने के लिए, टर्मिनल में यह कमांड डालें.

printf '\n# add path to conda\nexport PATH="$HOME/miniconda3/bin:$PATH"\n' >> ~/.bashrc

Windows

नीचे दिए गए जीयूआई या कमांड लाइन के निर्देशों का पालन करके, अपने 'पाथ' एनवायरमेंटल वैरिएबल में यह पाथ जोड़ें.

%UserProfile%\miniconda3\condabin

जीयूआई

1. 'एनवायरमेंट वैरिएबल' डायलॉग बॉक्स खोलने के लिए, कमांड प्रॉम्प्ट में यह लाइन डालें.

rundll32 sysdm.cpl,EditEnvironmentVariables

2. बदलाव करने के लिए, 'उपयोगकर्ता' सेक्शन में जाकर 'पाथ' वैरिएबल पर डबल-क्लिक करें.

3. एडिटर खोलने के लिए, नई 'बदलाव करें' डायलॉग विंडो में मौजूद, 'टेक्स्ट में बदलाव करें' बटन पर क्लिक करें.

4. मौजूदा 'पाथ' वैरिएबल की वैल्यू के आखिर में यह स्ट्रिंग जोड़ें. पक्का करें कि एंट्री के आस-पास सेमीकोलन (;) मौजूद हों, ताकि उसे आस-पास की एंट्री से अलग किया जा सके.

%UserProfile%\miniconda3\condabin;

5. जब तक सभी डायलॉग विंडो बंद न हो जाएं, तब तक 'ठीक है' बटन पर क्लिक करें.

ध्यान दें: जोड़े गए conda पाथ को हटाने के लिए, बदलाव करने का यही तरीका अपनाएं.

कमांड लाइन

पाथ जोड़ने के लिए, setx कमांड का इस्तेमाल करें. कमांड प्रॉम्प्ट में यह डालें:

setx Path "%Path%%UserProfile%\miniconda3\condabin;"

ध्यान दें: एनवायरमेंट वैरिएबल में किए गए बदलावों को लागू करने के लिए, खुले हुए कमांड लाइन इंटरफ़ेस रीस्टार्ट करें.

conda को शुरू करना

शेल इंटरैक्शन के लिए conda को शुरू करें. अलग-अलग शेल के लिए, इनिशियलाइज़ेशन की जानकारी पाने के लिए, यह कमांड चलाएं. कमांड डालने के बाद, कंसोल पर दिए गए निर्देशों का पालन करें.

conda init --help

कमांड लाइन इंटरफ़ेस को फिर से चालू करने के बाद, आपको यहां दी गई कमांड का इस्तेमाल करके, बेस कॉन्डा एनवायरमेंट को चालू करना होगा.

conda activate

एपीआई इंस्टॉल करना

Earth Engine Python API को conda-forge पैकेज के तौर पर यहां डिस्ट्रिब्यूट किया जाता है: https://anaconda.org/conda-forge/earthengine-api. इसे conda install कमांड से इंस्टॉल किया जाता है. हालांकि, इंस्टॉल करने से पहले, खास तौर पर Earth Engine के लिए conda एनवायरमेंट बनाएं. Earth Engine API को अपने एनवायरमेंट में इंस्टॉल करने से यह पक्का होता है कि इससे और इससे जुड़े पैकेज से, आपके बेस एनवायरमेंट या पहले से सेट अप किए गए किसी अन्य एनवायरमेंट में वर्शन से जुड़ी समस्याएं नहीं होंगी. इसके उलट भी ऐसा ही होगा. conda एनवायरमेंट को मैनेज करने के बारे में ज़्यादा जानकारी के लिए, कृपया इस साइट पर जाएं.

ध्यान दें: पहले चरण में यह माना गया है कि आपने अभी-अभी conda इंस्टॉल करें सेक्शन पूरा किया है. इसमें एनवायरमेंटल वैरिएबल में बदलाव नहीं किया गया है और न ही शेल के इस्तेमाल के लिए conda को शुरू किया गया है. इसलिए, कमांड को इसी के मुताबिक बनाया गया है. अगर आपने पहले किसी दूसरे तरीके से conda इंस्टॉल किया है या आपने conda को शेल में इस्तेमाल करने के लिए रजिस्टर किया है, तो कृपया conda को चालू करने के लिए ज़रूरी कार्रवाई करें. इसके बाद, दूसरे चरण से निर्देशों का पालन करना शुरू करें.

1. अगर आपका बुनियादी conda एनवायरमेंट पहले से चालू नहीं है, तो उसे चालू करें.

Linux

source $HOME/miniconda3/bin/activate

Mac

source $HOME/miniconda3/bin/activate

Windows

%UserProfile%\miniconda3\condabin\activate

2. Earth Engine API के लिए, conda वर्चुअल एनवायरमेंट बनाएं.

conda create --name ee

आपसे एनवायरमेंट बनाने की पुष्टि करने के लिए कहा जाएगा. ऐसा करें.

3. conda ee एनवायरमेंट को चालू करें.

conda activate ee

4. एपीआई को conda ee एनवायरमेंट में इंस्टॉल करें. पक्का करें कि (ee), कमांड लाइन की शुरुआत में दिखे. इससे पता चलता है कि ee एनवायरमेंट में काम किया जा रहा है.

conda install -c conda-forge earthengine-api

एपीआई और उसकी डिपेंडेंसी इंस्टॉल करने की पुष्टि करने के लिए, आपसे कहा जाएगा. पुष्टि करने के बाद, conda डिपेंडेंसी को डाउनलोड और इंस्टॉल करेगा. अगर सब कुछ ठीक रहा, तो अब आपके पास 'ee' नाम का conda एनवायरमेंट होगा. इसमें एपीआई को ऐक्सेस करने के लिए ज़रूरी सभी चीज़ें होंगी. साथ ही, earthengine कमांड लाइन टूल भी होगा.

क्रेडेंशियल पाएं

Earth Engine API या earthengine कमांड लाइन टूल का इस्तेमाल करने से पहले, आपको एक बार पुष्टि करनी होगी. इससे आपके Google खाते के ज़रिए Earth Engine को ऐक्सेस करने की अनुमति मिल जाएगी. पुष्टि करने के लिए, earthengine कमांड लाइन टूल से authenticate कमांड का इस्तेमाल करें.

अपने conda ee एनवायरमेंट में, यहां दिया गया निर्देश चलाएं और प्रिंट किए गए निर्देशों का पालन करें. आपको एक यूआरएल दिया जाएगा. इस पर क्लिक करके, कानूनी समझौते को स्वीकार करने के बाद अनुमति कोड जनरेट किया जा सकेगा. ऑथराइज़ेशन कोड को कॉपी करें और इसे कमांड लाइन इनपुट के तौर पर डालें.

earthengine authenticate

ऑथराइज़ेशन कोड डालने पर, ऑथराइज़ेशन टोकन को क्रेडेंशियल फ़ाइल में सेव कर दिया जाता है. यह फ़ाइल यहां दी गई है. इसके बाद, एपीआई की ee.Initialize() कमांड और earthengine कमांड लाइन टूल का इस्तेमाल करने पर, पुष्टि करने के लिए इस फ़ाइल का इस्तेमाल किया जाएगा. अगर आपको अनुमति रद्द करनी है, तो क्रेडेंशियल फ़ाइल मिटा दें.

Linux

ls $HOME/.config/earthengine/credentials

Mac

ls $HOME/.config/earthengine/credentials

Windows

dir %UserProfile%\.config\earthengine\credentials

एपीआई की जांच करना

एपीआई इंस्टॉलेशन की जांच करने के लिए, एक सामान्य Python स्क्रिप्ट चलाएं. यह स्क्रिप्ट, DEM डेटासेट के लिए मेटाडेटा प्रिंट करती है. इससे कंसोल पर एक JSON ऑब्जेक्ट प्रिंट होना चाहिए.

1. अपने conda ee एनवायरमेंट से python इंटरप्रेटर शुरू करें.

python

2. किसी DEM डेटासेट के मेटाडेटा को प्रिंट करने के लिए, Python की इन लाइनों को एक-एक करके चलाएं

import ee

# Initialize the Earth Engine module.
ee.Initialize()

# Print metadata for a DEM dataset.
print(ee.Image('USGS/SRTMGL1_003').getInfo())

एपीआई का बाद में इस्तेमाल करना

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 इंस्टॉल करें पेज देखें.

एपीआई को अपडेट करना

अपने ee एनवायरमेंट को एपीआई के नए वर्शन पर अपडेट करने के लिए, conda update कमांड का इस्तेमाल करें. अगर conda ee एनवायरमेंट पहले से चालू नहीं है, तो उसे चालू करना न भूलें.

conda update -c conda-forge earthengine-api

Python में, फ़िलहाल इंस्टॉल किए गए वर्शन का नंबर पाने के लिए, ee लाइब्रेरी की __version__ प्रॉपर्टी को प्रिंट करें. 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

ध्यान दें: ee-shared-env.yml फ़ाइल की पहली लाइन में, बनाए जाने वाले एनवायरमेंट का नाम तय किया जाता है. Conda, किसी मौजूदा एनवायरमेंट को नहीं बदलेगा. इसलिए, ee-shared-env.yml फ़ाइल में एनवायरमेंट का नाम बदला जा सकता है. इसके अलावा, एनवायरमेंट के नाम मैनेज करने के लिए, conda के remove कमांड या conda के create कमांड के --clone फ़्लैग का इस्तेमाल करें.

ध्यान दें: अलग-अलग ऑपरेटिंग सिस्टम पर एनवायरमेंट को डुप्लीकेट करने में समस्या आ सकती है. ऐसा इसलिए, क्योंकि ओएस के हिसाब से पैकेज के अलग-अलग बिल्ड और वर्शन होते हैं. ये उपलब्ध नहीं हो सकते या इनसे निर्भरता से जुड़ी समस्याएं हो सकती हैं.