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

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

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

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

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

conda इंस्टॉल है या नहीं

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

conda --help

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

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

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

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

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 को चालू करना होगा. इसमें एपीआई का इस्तेमाल भी शामिल है. ज़रूरत के हिसाब से Miniconda को चालू करने के लिए, ऊपर दिए गए कोड स्निपेट के पहले निर्देश का इस्तेमाल करें.

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

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

आपके पास अपने सिस्टम के PATH वैरिएबल में, Miniconda के इंस्टॉलेशन पाथ को जोड़ने का विकल्प है. इससे, 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 पाथ को हटाने के लिए, अभी जोड़ी गई लाइनों को मिटाएं.

कमांड लाइन

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

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 पाथ को हटाने के लिए, अभी जोड़ी गई लाइनों को मिटाएं.

कमांड लाइन

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

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 एनवायरमेंट को चालू किया जा सकता है.

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 स्क्रिप्ट चलाएं. यह स्क्रिप्ट, डीईएम डेटासेट का मेटाडेटा प्रिंट करती है. इससे कंसोल पर JSON ऑब्जेक्ट प्रिंट होना चाहिए.

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

python

2. किसी डीईएम डेटासेट के मेटाडेटा को प्रिंट करने के लिए, यहां दी गई 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

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

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

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