نصب Python - نصب Conda


‫Earth Engine Python API را می‌توان ازطریق conda (مدیر محیط و بسته Python) در دستگاه محلی نصب کرد. Conda با توزیع‌های پایتون Anaconda و Miniconda بسته‌بندی شده است. Anaconda پلاتفرم برنامه‌نویسی علم داده است که شامل بیش‌از ۱۵۰۰ بسته است، درحالی‌که Miniconda فقط شامل conda و وابستگی‌های آن است. هرکدام از این توزیع‌های Python برای نصب و کار با Earth Engine API مناسب هستند. اگر با این توزیع‌ها آشنا نیستید، لطفاً برای کسب اطلاعات بیشتر به پیوندهای آن‌ها مراجعه کنید.

این راهنما شما را در موارد زیر راهنمایی می‌کند:

  • درحال بررسی نصب conda موجود
  • نصب conda در ماشین محلی
  • درحال نصب Earth Engine Python API
  • درحال راه‌اندازی اعتبارنامه‌های اصالت‌سنجی
  • آزمایش کردن میانای برنامه‌سازی کاربردی

بررسی نصب conda

اگر conda ازقبل در سیستم شما نصب شده است، به بخش نصب API بروید. اگر مطمئن نیستید conda نصب شده است یا نه، با وارد کردن فرمان زیر در میانای خط فرمان، آن را درستی‌سنجی کنید.

conda --help

اگر conda نصب شده باشد و مسیر سیستم آن در متغیر محیطی PATH ثبت شده باشد، محتوای راهنمای conda باید در پایانه ظاهر شود. اگر محتوای راهنما نشان داده شد، به بخش نصب API بروید. اگر conda شناسایی نشود، نتیجه چیزی شبیه به این خواهد بود: conda پیدا نشد یا به‌عنوان فرمان شناسایی نشد. ممکن است برنامه در سیستم شما وجود داشته باشد اما در متغیر محیطی PATH ثبت نشده باشد. حتی اگر این‌طور باشد، برای حفظ ثبات، لطفاً با بخش نصب conda ادامه دهید، زیرا رسیدگی به همه پیکربندی‌های ممکن سیستم دشوار است. تا زمانی که پوشه «miniconda3» در پوشه Home شما وجود نداشته باشد، دستورالعمل‌های نصب conda زیر باید موفقیت‌آمیز باشد. برای کسب اطلاعات بیشتر درباره مکان نصب و ثبت conda، لطفاً به صفحه‌های نصب Miniconda و نصب Anaconda مراجعه کنید.

نصب conda

در این بخش، Miniconda را بارگیری و نصب خواهید کرد که به‌عنوان پلاتفرم Python برای دسترسی به Earth Engine API عمل خواهد کرد. همان‌طور که در بالا توضیح داده شد، می‌توانید از Miniconda یا Anaconda استفاده کنید، اما برای به‌حداقل رساندن تأثیر بر سیستم، این راهنما نصب Miniconda را بدون تغییر در متغیرهای محیطی سیستم شما شرح می‌دهد. اگر Anaconda را ترجیح می‌دهید، لطفاً دستورالعمل‌های نصب ارائه‌شده در اینجا را ببینید و سپس به بخش نصب API بروید.

نصب Miniconda

بارگیری و نصب Miniconda در سه مرحله انجام می‌شود:

  1. نصب‌کننده Miniconda نسخه Python 3‏ ۶۴ بیتی را در فهرست Home بارگیری کنید
  2. اجرا کردن نصب‌کننده
  3. حذف نصب‌کننده

این مراحل را با کپی و جای‌گذاری کردن خطوط زیر در میانای خط فرمان مناسب برای سیستم خود تکمیل کنید. نصب منجر به اضافه شدن پوشه‌ای به‌نام «miniconda3» به فهرست راهنمای «صفحه اصلی» شما می‌شود.

۱. نصب‌کننده 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"

۲. 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

۳. نصب‌کننده 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 را به متغیر PATH سیستم خود اضافه کنید، که به شما امکان می‌دهد با یک فراخوانی ساده به conda با conda تعامل داشته باشید، بدون اینکه ابتدا نیاز به اجرای فرمان activate ازطریق مسیر کامل آن باشد. دستورالعمل‌های زیر مراحل افزودن نصب Miniconda به متغیر PATH سیستم را نشان می‌دهد.

Linux

با تکمیل دستورالعمل‌های میانای نگاره‌ای کاربر یا خط فرمان زیر، مسیر زیر را به متغیر محیطی «PATH» خود اضافه کنید.

$HOME/miniconda3/bin

رابط کاربری گرافیکی

۱. فایل .bashrc را که در دایرکتوری $HOME قرار دارد در ویرایشگر نوشتار باز کنید.

xdg-open ~/.bashrc

۲. خطوط زیر را کپی کنید و در پایین فایل جای‌گذاری کنید.

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

۳. فایل را ذخیره کنید و ویرایشگر نوشتار را ببندید.

خط فرمان

دستور زیر را در پایانه وارد کنید تا مسیر conda به فایل ~/.bashrc اضافه شود.

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

Mac

با تکمیل دستورالعمل‌های میانای نگاره‌ای کاربر یا خط فرمان زیر، مسیر زیر را به متغیر محیطی «PATH» خود اضافه کنید.

$HOME/miniconda3/bin

رابط کاربری گرافیکی

۱. فایل .bashrc را که در دایرکتوری $HOME قرار دارد در ویرایشگر نوشتار باز کنید.

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

۲. خطوط زیر را کپی کنید و در پایین فایل جای‌گذاری کنید.

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

۳. فایل را ذخیره کنید و ویرایشگر نوشتار را ببندید.

خط فرمان

دستور زیر را در پایانه وارد کنید تا مسیر conda به فایل ~/.bashrc اضافه شود.

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

Windows

مسیر زیر را با تکمیل دستورالعمل‌های GUI یا خط فرمان زیر به متغیر محیطی «مسیر» خود اضافه کنید.

%UserProfile%\miniconda3\condabin

رابط کاربری گرافیکی

۱. خط زیر را در پیام‌واره فرمان وارد کنید تا کادر گفتگوی «متغیر محیطی» باز شود.

rundll32 sysdm.cpl,EditEnvironmentVariables

۲. روی متغیر «مسیر» در بخش «کاربر» دوکلیک کنید تا آن را برای ویرایش انتخاب کنید.

۳. روی دکمه «ویرایش نوشتار» در پنجره کادر گفتگوی جدید «ویرایش» کلیک کنید تا ویرایشگر باز شود.

۴. رشته زیر را به انتهای مقدار متغیر «مسیر» موجود اضافه کنید. مطمئن شوید که نقطه‌ویرگول (;) در دو طرف ورودی قرار دارد تا از ورودی‌های مجاور متمایز شود.

%UserProfile%\miniconda3\condabin;

۵. روی دکمه‌های «تأیید» کلیک کنید تا همه پنجره‌های گفتگو بسته شوند.

خط فرمان

از فرمان 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 نصب می‌شود. اما قبل‌از نصب، یک محیط conda به‌طور خاص برای Earth Engine ایجاد کنید. نصب Earth Engine API در محیط خودش تضمین می‌کند که این میانای برنامه‌سازی کاربردی و بسته‌های وابسته به آن باعث ایجاد مشکلات نسخه‌بندی در محیط پایه شما یا هر محیط دیگری که قبلاً راه‌اندازی کرده‌اید نمی‌شوند و برعکس. برای اطلاعات بیشتر درباره مدیریت محیط‌های conda، لطفاً به این سایت مراجعه کنید.

۱. محیط conda پایه را فعال کنید، اگر ازقبل فعال نیست.

Linux

source $HOME/miniconda3/bin/activate

Mac

source $HOME/miniconda3/bin/activate

Windows

%UserProfile%\miniconda3\condabin\activate

۲. یک محیط مجازی conda برای Earth Engine API ایجاد کنید.

conda create --name ee

از شما خواسته می‌شود ایجاد محیط را تأیید کنید، این کار را انجام دهید.

۳. محیط conda ee را فعال کنید.

conda activate ee

۴. میانای برنامه‌سازی کاربردی را در محیط conda ee نصب کنید. مطمئن شوید که (ee) در ابتدای خط فرمان ظاهر می‌شود، که نشان می‌دهد شما از محیط ee کار می‌کنید.

conda install -c conda-forge earthengine-api

از شما خواسته می‌شود نصب API و وابستگی‌های آن را تأیید کنید. پس‌از تأیید، conda وابستگی‌ها را بارگیری و نصب خواهد کرد. اگر همه چیز خوب پیش برود، اکنون یک محیط conda به نام «ee» خواهید داشت که همه الزامات دسترسی به API و همچنین earthengine ابزار خط فرمان را دارد.

دریافت اعتبارنامه

قبل‌از استفاده از Earth Engine API یا ابزار خط فرمان earthengine، باید یک‌بار اصالت‌سنجی انجام دهید که دسترسی به Earth Engine را ازطرف حساب Google شما مجاز می‌کند. برای اصالت‌سنجی، از فرمان authenticate در ابزار خط فرمان earthengine استفاده کنید.

در محیط conda ee، فرمان زیر را اجرا کنید و دستورالعمل‌های چاپ‌شده حاصل را دنبال کنید. نشانی وبی ارائه خواهد شد که پس‌از موافقت، کد مجوزی تولید می‌کند. کد مجوز را کپی کنید و آن را به‌عنوان ورودی خط فرمان وارد کنید.

earthengine authenticate

پس‌از وارد کردن کد مجوز، یک توکن مجوز در فایل اعتبارنامه‌ای که در زیر می‌بینید ذخیره می‌شود. استفاده بعدی از فرمان ee.Initialize() API و ابزار خط فرمان earthengine برای اصالت‌سنجی به این فایل مراجعه خواهد کرد. اگر می‌خواهید مجوز را لغو کنید، کافی است فایل اطلاعات کاربری را حذف کنید.

Linux

ls $HOME/.config/earthengine/credentials

Mac

ls $HOME/.config/earthengine/credentials

Windows

dir %UserProfile%\.config\earthengine\credentials

آزمایش کردن میانای برنامه‌سازی کاربردی

دستورگان ساده Python را که فراداده‌های مجموعه داده DEM را چاپ می‌کند اجرا کنید تا نصب API را آزمایش کنید. باید شیء JSON را در کنسول چاپ کند.

۱. مفسر python را از محیط conda ee خود راه‌اندازی کنید.

python

۲. خطوط Python زیر را یکی‌یکی اجرا کنید تا فراداده‌های مجموعه داده DEM چاپ شود

import ee

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

# Print metadata for a DEM dataset.
print(ee.Image('NASA/NASADEM_HGT/001').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 مراجعه کنید.

به‌روزرسانی میانای برنامه‌سازی کاربردی

از فرمان conda update برای به‌روزرسانی محیط ee به جدیدترین نسخه API استفاده کنید. به‌یاد داشته باشید که ابتدا محیط conda ee خود را فعال کنید، اگر قبلاً فعال نشده است.

conda update -c conda-forge earthengine-api

با چاپ کردن ویژگی ee کتابخانه __version__، شماره نسخه نصب‌شده فعلی را در Python دریافت کنید. با وارد کردن python در خط فرمان محیط conda‏ ee، مفسر Python را راه‌اندازی کنید و سپس دستورات زیر را وارد کنید.

import ee
print(ee.__version__)

درحال هم‌رسانی محیط ee

هم‌رسانی محیط conda Python با دیگران می‌تواند برای دستیابی به نتایج تکرارپذیر و قابل‌تکثیر مفید باشد، به‌ویژه زمانی که بسته‌های 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