تثبيت Python - تثبيت Conda


يمكن تثبيت واجهة برمجة التطبيقات Earth Engine Python API على جهاز محلي من خلال conda، وهو مدير حِزم وبيئة Python. يتم تجميع Conda مع موزّعات Python الخاصة ب Anaconda و Miniconda. Anaconda هي منصّة برمجة لعلوم البيانات تتضمّن أكثر من 1500 حزمة، في حين لا تتضمّن Miniconda سوى conda ومكوّناته التابعة. إنّ أيّ من توزيعات Python هذه مناسب ل تثبيت Earth Engine API والعمل معها. إذا لم تكن على دراية بهذه التوزيعات، يُرجى الانتقال إلى الروابط الخاصة بها لمعرفة المزيد من المعلومات.

سيرشدك هذا الدليل خلال:

  • التحقّق من تثبيت conda الحالي
  • تثبيت conda على جهاز محلي
  • تثبيت واجهة برمجة التطبيقات Python API في Earth Engine
  • إعداد بيانات اعتماد المصادقة
  • اختبار واجهة برمجة التطبيقات

التحقّق من تثبيت conda

إذا كان conda مثبّتًا على نظامك، انتقِل إلى القسم تثبيت واجهة برمجة التطبيقات. إذا لم تكن متأكّدًا مما إذا كان conda مثبّتًا، يمكنك التحقّق من ذلك عن طريق إدخال الأمر التالي في واجهة سطر الأوامر.

conda --help

إذا تم تثبيت conda وتم تسجيل مسار النظام في المتغيّر البيئي PATH ، من المفترض أن تظهر محتويات مساعدة conda في الترميز الطرفي. إذا ظهرت محتويات المساعدة، انتقِل إلى القسم تثبيت واجهة برمجة التطبيقات. إذا لم يتم التعرّف على conda، ستظهر العبارة التالية في النتيجة: لم يتم العثور على conda أو لم يتم التعرّف عليه كأمر. من المحتمل أن يكون البرنامج متوفّرًا على نظامك ولكن لم يتم تسجيله في المتغيّر البيئي PATH. حتى إذا كان الأمر كذلك، يُرجى متابعة قسم تثبيت conda من أجل الاتساق، لأنّه من الصعب معالجة جميع إعدادات النظام المحتملة. طالما أنّ المجلد "miniconda3" غير متوفّر في مجلد "المنزل"، من المفترض أن تنجح تعليمات تثبيت conda التالية. لمزيد من المعلومات حول موقع تثبيت conda وتسجيله، يُرجى الاطّلاع على صفحتَي تثبيت Miniconda وتثبيت Anaconda.

تثبيت conda

في هذا القسم، ستنزِّل حزمة Miniconda وتثبِّتها، والتي ستُستخدَم كنظام أساسي لـ Python للوصول إلى واجهة برمجة التطبيقات Earth Engine API. كما هو описан أعلاه، يمكنك استخدام Miniconda أو Anaconda، ولكن لتقليل التأثير على نظامك، سيوضّح هذا الدليل عملية تثبيت Miniconda بدون أي تغيير في متغيّرات بيئة النظام. إذا كنت تفضّل Anaconda، يُرجى الاطّلاع على تعليمات التثبيت المقدَّمة هنا ثم الانتقال إلى القسم تثبيت Search Console API.

تثبيت Miniconda

يتم تنزيل Miniconda وتثبيته في ثلاث خطوات:

  1. تنزيل أداة تثبيت Miniconda لإصدار Python 3 بسعة 64 بت في الدليل الرئيسي
  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

اطبع قائمة مساعدة الأمر conda لاختبار تثبيت Miniconda. بما أنّه لم تتم إضافة 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

إضافة Miniconda إلى متغيّر PATH

يمكنك اختياريًا إضافة مسار تثبيت Miniconda إلى متغيّر SYSTEM's PATH، ما سيتيح لك التفاعل مع conda من خلال طلب بسيط إلى conda بدون الحاجة إلى تشغيل الأمرactivate أولاً من خلال مساره الكامل. توضِّح التعليمات التالية كيفية إضافة تثبيت Miniconda إلى متغيّر PATH في نظامك.

Linux

أضِف المسار التالي إلى متغيّر البيئة PATH من خلال إكمال تعليمات واجهة المستخدم أو سطر الأوامر أدناه.

$HOME/miniconda3/bin

الفاتورة الرسمية الموحّدة

1. افتح ملف .bashrc في دليل $HOME باستخدام محرِّر نصوص.

xdg-open ~/.bashrc

2. انسخ الأسطر التالية والصقها في أسفل الملف.

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

3- احفظ الملف وأغلق محرِّر النصوص.

سطر الأوامر

أدخِل الأمر التالي في وحدة طرفية لإلحاق مسار conda بملف ~/.bashrc.

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

Mac

أضِف المسار التالي إلى متغيّر البيئة PATH من خلال إكمال تعليمات واجهة المستخدم أو سطر الأوامر أدناه.

$HOME/miniconda3/bin

الفاتورة الرسمية الموحّدة

1. افتح ملف .bashrc في دليل $HOME باستخدام محرِّر نصوص.

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

2. انسخ الأسطر التالية والصقها في أسفل الملف.

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

3- احفظ الملف وأغلق محرِّر النصوص.

سطر الأوامر

أدخِل الأمر التالي في وحدة طرفية لإلحاق مسار 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- انقر على الزر "حسنًا" إلى أن يتم إغلاق جميع نوافذ الحوار.

سطر الأوامر

استخدِم الأمر setx لإلحاق المسار. من موجه الأوامر، أدخِل:

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

إعداد conda

شغِّل conda للتفاعل مع shell. يمكنك تنفيذ الأمر التالي للحصول على معلومات عن عملية الإعداد لمختلف أنظمة التشغيل. اتّبِع التعليمات التالية التي يتم طباعتها على وحدة التحكّم عند إدخال الأمر.

conda init --help

بعد إعادة تشغيل واجهة سطر الأوامر، من المفترض أن تتمكّن من تفعيل بيئة conda الأساسية باستخدام الأمر التالي.

conda activate

تثبيت واجهة برمجة التطبيقات

يتم توزيع واجهة برمجة التطبيقات Python API في Earth Engine كحزمة conda-forge على الرابط: https://anaconda.org/conda-forge/earthengine-api. يتم تثبيته باستخدام الأمر conda install. قبل التثبيت، عليك إنشاء بيئة conda مخصّصة لخدمة Earth Engine. يضمن تثبيت Earth Engine API في بيئته الخاصة أنّه لن تتسبب الحِزم التابعة له في حدوث مشاكل في الإصدارات مع البيئات الأساسية أو أي بيئات أخرى سبق لك إعدادها، والعكس صحيح. لمزيد من المعلومات حول إدارة بيئات conda، يُرجى الانتقال إلى هذا الموقع الإلكتروني.

1. فعِّل بيئة conda الأساسية إذا لم تكن مفعَّلة.

Linux

source $HOME/miniconda3/bin/activate

Mac

source $HOME/miniconda3/bin/activate

Windows

%UserProfile%\miniconda3\condabin\activate

2. أنشئ بيئة افتراضية باستخدام conda لواجهة برمجة التطبيقات Earth Engine API.

conda create --name ee

سيُطلب منك تأكيد إنشاء البيئة، يُرجى إجراء ذلك.

3- فعِّل بيئة conda ee.

conda activate ee

4. ثبِّت واجهة برمجة التطبيقات في بيئة conda ee. تأكَّد من ظهور (ee) في بداية سطر الأوامر، ما يشير إلى أنّك تعمل من بيئة ee.

conda install -c conda-forge earthengine-api

سيُطلب منك تأكيد تثبيت واجهة برمجة التطبيقات ومكوّنات الربط التي تعتمد عليها. بعد التأكيد، ستنزِّل أداة conda التبعيات وتثبِّتها. إذا سارت الأمور على ما يرام، ستحصل الآن على بيئة conda تُسمى ee تتضمّن جميع متطلبات الوصول إلى واجهة برمجة التطبيقات، بالإضافة إلى earthengine أداة سطر الأوامر.

الحصول على بيانات الاعتماد

قبل استخدام Earth Engine API أو أداة سطر الأوامر earthengine، يجب إجراء مصادقة لمرة واحدة تمنح الإذن بالوصول إلى Earth Engine نيابةً عن حسابك على Google. لتأكيد الهوية، استخدِم الأمر authenticate من أداة سطر الأوامر earthengine.

ضمن بيئة conda ee، نفِّذ الأمر التالي واتّبِع التعليمات المطبوعة الناتجة. سيتم توفير عنوان URL ينشئ رمز تفويض عند الموافقة. انسخ رمز التفويض وأدخِله كإدخال سطر أوامر.

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. ابدأ مترجم python من بيئة conda ee.

python

2. شغِّل أسطر Python التالية الواحد تلو الآخر لطباعة البيانات الوصفية لمجموعة بيانات DEM.

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 مسجَّلاً للاستخدام في shell أم لا. اتّبِع التعليمات المتعلقة بتثبيت 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 لاستخدامه في shell أو موجّه الأوامر باتّباع التعليمات الواردة في هذا الدليل أو باستخدام وسائل أخرى. نفِّذ الأمر التالي في واجهة سطر الأوامر.

conda activate ee

بعد تنفيذ الأمر، من المفترض أن يظهر الرمز (ee) في بداية سطر الأوامر، ما يشير إلى أنّك تعمل من بيئة ee.

أصبحت الآن جاهزًا لبدء مترجم Python والوصول إلى واجهة برمجة التطبيقات Earth Engine Python API. يُرجى الرجوع إلى صفحة تثبيت Python للحصول على إرشادات عامة حول العمل مع Python API.

تعديل واجهة برمجة التطبيقات

استخدِم الأمر conda update لتعديل بيئة ee إلى أحدث إصدار من واجهة برمجة التطبيقات. تذكَّر أولاً تفعيل بيئة conda ee إذا لم تكن نشطة.

conda update -c conda-forge earthengine-api

يمكنك الحصول على رقم الإصدار المثبَّت حاليًا في Python من خلال طباعة سمة ee library __version__. ابدأ مترجم Python من خلال إدخال python في سطر أوامر بيئة conda في ee، ثم أدخِل الأوامر التالية.

import ee
print(ee.__version__)

مشاركة بيئة ee

قد يكون من المفيد مشاركة بيئة Python في conda مع الآخرين لمحاولة تحقيق نتائج قابلة للتكرار، خاصةً عند تثبيت حِزم Python إضافية. توفّر Conda طريقة ملائمة للمستخدمين الآخرين لتكرار بيئتك.

من بيئة conda ee، نفِّذ الأمر التالي لحفظ ملف YAML باسم ee-shared-env في الدليل الرئيسي الذي يسرد مواصفات بيئتك.

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