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


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

سيرشدك هذا الدليل إلى ما يلي:

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

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

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

conda --help

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

تثبيت conda

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

تثبيت Miniconda

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

  1. نزِّل أداة تثبيت 64 بت من Python 3 Miniconda إلى دليل Home
  2. تشغيل أداة التثبيت
  3. حذف أداة التثبيت

أكمِل هذه الخطوات من خلال نسخ الأسطر التالية ولصقها في واجهة سطر الأوامر المناسبة لنظامك. يؤدي التثبيت إلى إضافة مجلد باسم "miniconda3" إلى دليل الصفحة الرئيسية.

1. نزِّل أداة تثبيت Miniconda إلى دليل Home.

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 بدون إظهار أي إشعارات، مع قبول الإعدادات التلقائية، في دليل Home.

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 من دليل Home.

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 إلى متغير 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. انقر مرّتين على المتغيّر "المسار" (Path) ضمن قسم "المستخدم" (User) لاختياره للتعديل.

‫3. انقر على الزر "تعديل النص" في مربّع الحوار الجديد "تعديل" لفتح أداة التعديل.

4. أضِف السلسلة التالية إلى نهاية قيمة المتغيّر "المسار" الحالية. تأكَّد من وضع فواصل منقوطة (;) حول الإدخال لتمييزه عن الإدخالات المجاورة.

%UserProfile%\miniconda3\condabin;

5- انقر على أزرار "حسنًا" إلى أن يتم إغلاق جميع مربّعات الحوار.

سطر الأوامر

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

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

إعداد conda

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

conda init --help

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

conda activate

Install API

يتم توزيع Earth Engine Python API كحزمة 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 يعرض البيانات الوصفية لمجموعة بيانات نموذج الارتفاع الرقمي لاختبار عملية تثبيت واجهة برمجة التطبيقات يجب أن تطبع كائن JSON في وحدة التحكّم.

1. ابدأ تشغيل python المترجم الفوري من بيئة ee في conda.

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.

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

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

conda update -c conda-forge earthengine-api

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

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