نصب پایتون - Conda Install


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

این راهنما شما را از طریق:

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

نصب conda را بررسی کنید

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

conda --help

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

conda را نصب کنید

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

Miniconda را نصب کنید

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

  1. نصب کننده 64 بیتی Python 3 Miniconda را در فهرست اصلی خود دانلود کنید
  2. نصب کننده را اجرا کنید
  3. نصب کننده را حذف کنید

این مراحل را با کپی و چسباندن خطوط زیر در رابط خط فرمان مناسب برای سیستم خود تکمیل کنید. نتیجه نصب پوشه ای به نام 'miniconda3' به فهرست اصلی شما اضافه می شود.

1. نصب کننده Miniconda را در فهرست اصلی خود دانلود کنید.

لینوکس 

wget https://repo.continuum.io/miniconda/Miniconda3-latest-Linux-x86_64.sh -O ~/miniconda.sh

مک 

curl https://repo.anaconda.com/miniconda/Miniconda3-latest-MacOSX-x86_64.sh -o ~/miniconda.sh

ویندوز 

powershell -command "Invoke-WebRequest -Uri https://repo.anaconda.com/miniconda/Miniconda3-latest-Windows-x86_64.exe -OutFile ~\miniconda.exe"

2. Miniconda را بی سر و صدا، با پذیرش پیش فرض ها، در فهرست اصلی خود نصب کنید.

لینوکس 

bash ~/miniconda.sh -b

مک 

bash ~/miniconda.sh -b

ویندوز 

start /B /WAIT %UserProfile%\miniconda.exe /InstallationType=JustMe /AddToPath=0 /RegisterPython=0 /S /D=%UserProfile%\miniconda3

3. نصب کننده Miniconda را از فهرست اصلی خود حذف کنید.

لینوکس 

rm ~/miniconda.sh

مک 

rm ~/miniconda.sh

ویندوز 

del %UserProfile%\miniconda.exe

نصب Miniconda را تست کنید

برای آزمایش نصب Miniconda، منوی راهنمای فرمان conda را چاپ کنید. از آنجایی که Miniconda به متغیر محیطی PATH سیستم شما اضافه نشده است، ابتدا باید conda را برای این جلسه با فراخوانی دستور activate توسط مسیر کامل سیستم آن فعال کنید. یک آزمایش موفقیت آمیز منجر به نمایش محتویات کمکی conda در ترمینال می شود. خطوط زیر را در رابط خط فرمان سیستم خود اجرا کنید.

لینوکس 

source $HOME/miniconda3/bin/activate
conda --help

مک 

source $HOME/miniconda3/bin/activate
conda --help

ویندوز 

%UserProfile%\miniconda3\condabin\activate
conda --help

Miniconda را به متغیر PATH اضافه کنید

شما می توانید به صورت اختیاری مسیر نصب Miniconda را به متغیر PATH سیستم خود اضافه کنید، که به شما این امکان را می دهد تا با یک تماس ساده با conda بدون نیاز به اجرای دستور activate در مسیر کامل آن، با conda تعامل داشته باشید. دستورالعمل‌های زیر با افزودن نصب Miniconda به متغیر PATH سیستم شما آشنا می‌شوند.

لینوکس

با تکمیل GUI یا دستورالعمل های خط فرمان زیر، مسیر زیر را به متغیر محیطی «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

مک

با تکمیل GUI یا دستورالعمل های خط فرمان زیر، مسیر زیر را به متغیر محیطی «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

ویندوز

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

%UserProfile%\miniconda3\condabin

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

1. خط زیر را در خط فرمان وارد کنید تا گفتگوی "متغیر محیطی" باز شود. 

rundll32 sysdm.cpl,EditEnvironmentVariables

2. روی متغیر "مسیر" در زیر بخش "کاربر" دوبار کلیک کنید تا آن را برای ویرایش انتخاب کنید.

3. روی دکمه "ویرایش متن" در پنجره گفتگوی جدید "ویرایش" کلیک کنید تا ویرایشگر باز شود.

4. رشته زیر را به انتهای مقدار متغیر "Path" موجود اضافه کنید. اطمینان حاصل کنید که نقطه ویرگول (;) ورودی را احاطه کرده است تا آن را از ورودی های همسایه متمایز کند. 

%UserProfile%\miniconda3\condabin;

5. دکمه های 'Okay' را کلیک کنید تا تمام پنجره های گفتگو بسته شوند.

خط فرمان

از دستور setx برای اضافه کردن مسیر استفاده کنید. از یک خط فرمان وارد کنید: 

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

کوندا را اولیه کنید

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

conda init --help

پس از راه اندازی مجدد رابط خط فرمان، باید بتوانید محیط پایه conda را با دستور زیر فعال کنید. 

conda activate

API را نصب کنید

Earth Engine Python API به عنوان یک بسته conda-forge در: https://anaconda.org/conda-forge/earthengine-api توزیع شده است. با دستور conda install نصب می شود. با این حال، قبل از نصب، یک محیط conda به طور خاص برای Earth Engine ایجاد کنید. نصب Earth Engine API در محیط خود تضمین می‌کند که آن و بسته‌های وابسته به آن باعث ایجاد مشکل در نسخه‌سازی با محیط پایه شما یا هر محیط دیگری که قبلاً تنظیم کرده‌اید و بالعکس نیست. برای اطلاعات بیشتر در مورد مدیریت محیط های کوندا، لطفاً از این سایت دیدن کنید.

1. محیط پایه کوندای خود را فعال کنید، اگر قبلاً وجود نداشته است.

لینوکس 

source $HOME/miniconda3/bin/activate

مک 

source $HOME/miniconda3/bin/activate

ویندوز 

%UserProfile%\miniconda3\condabin\activate

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

conda create --name ee

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

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

conda activate ee

4. API را در محیط 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 خود دستور زیر را اجرا کنید و دستورالعمل های چاپ شده را دنبال کنید. URL ارائه خواهد شد که در صورت توافق، کد مجوز تولید می کند. کد مجوز را کپی کنید و آن را به عنوان ورودی خط فرمان وارد کنید. 

earthengine authenticate

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

لینوکس 

ls $HOME/.config/earthengine/credentials

مک 

ls $HOME/.config/earthengine/credentials

ویندوز 

dir %UserProfile%\.config\earthengine\credentials

تست API

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

1. یک مترجم python را از محیط conda ee خود راه اندازی کنید. 

python

2. خطوط پایتون زیر را یک به یک اجرا کنید تا متادیتا برای یک مجموعه داده DEM چاپ شود. 

import ee

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

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

استفاده بعدی از API

هر زمان که مایل به استفاده از Earth Engine API هستید، ابتدا باید محیط conda ee خود را فعال کنید. روش فعال سازی بستگی به این دارد که آیا conda برای استفاده در پوسته ثبت شده است یا خیر. دستورالعمل های مربوط به نصب conda خود را در زیر دنبال کنید.

کوندا ثبت نام نکرده است

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

لینوکس 

source $HOME/miniconda3/bin/activate ee

مک 

source $HOME/miniconda3/bin/activate ee

ویندوز 

%UserProfile%\miniconda3\condabin\activate ee

کوندا ثبت نام کرد

دستور فعال‌سازی محیط conda ee زیر فرض می‌کند که conda برای استفاده در پوسته یا خط فرمان توسط دستورالعمل‌های این راهنما یا به وسیله‌های دیگر ثبت شده است. دستور زیر را در یک رابط خط فرمان اجرا کنید. 

conda activate ee

پس از اجرای دستور باید (ee) در ابتدای خط فرمان مشاهده کنید که نشان می دهد از محیط ee کار می کنید.

اکنون آماده راه اندازی یک مفسر پایتون و دسترسی به Earth Engine Python API هستید. لطفاً برای راهنمایی کلی در مورد کار با Python API به صفحه نصب پایتون مراجعه کنید.

به روز رسانی API

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

conda update -c conda-forge earthengine-api

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

import ee
print(ee.__version__)

محیط ee خود را به اشتراک بگذارید

به اشتراک گذاری محیط conda Python خود با دیگران برای دستیابی به نتایج قابل تکرار و تکرار می تواند مفید باشد، به خصوص زمانی که بسته های Python اضافی را نصب کرده اید. کوندا راه مناسبی را برای دیگران فراهم می کند تا محیط شما را تکرار کنند.

از محیط conda ee خود، دستور زیر را اجرا کنید تا یک فایل YAML به نام 'ee-shared-env' را در فهرست خانه خود ذخیره کنید، که مشخصات محیط شما را فهرست می کند.

لینوکس 

conda env export > $HOME/ee-shared-env.yml

مک 

conda env export > $HOME/ee-shared-env.yml

ویندوز 

conda env export > %UserProfile%\ee-shared-env.yml

فایل حاصل را به اشتراک بگذارید و گیرنده می‌تواند با اجرای دستور conda زیر محیط را تکرار کند. 

conda env create -f path-to-ee-shared-env.yml