Установка Python – установка Conda

Earth Engine Python API можно установить на локальный компьютер с помощью conda – менеджера пакетов и сред Python. Conda входит в состав дистрибутивов Python Anaconda и Miniconda. Anaconda – это платформа для программирования в области науки о данных, которая включает более 1500 пакетов, а Miniconda включает только conda и его зависимости. Любой из этих дистрибутивов Python подходит для установки и работы с Earth Engine API. Если вы не знакомы с этими дистрибутивами, перейдите по ссылкам, чтобы узнать больше.

В этом руководстве вы найдете:

• Проверка наличия установленной среды conda
• Как установить Conda на локальный компьютер
• Установка Earth Engine Python API
• Настройка учетных данных
• Тестирование API

Примечание. Описанные ниже действия выполняются в командной строке Windows или терминале Unix (Linux/Mac). Чтобы переключаться между командами для разных операционных систем, используйте вкладки в верхней части каждого раздела с кодом.

Проверьте, установлен ли Conda

Если conda уже установлен, перейдите к разделу Установка API. Если вы не уверены, установлен ли conda, проверьте это, введя следующую команду в интерфейсе командной строки.

conda --help

Если conda установлена и ее системный путь зарегистрирован в переменной среды PATH, в терминале должно появиться справочное содержимое conda. Если вы увидите справочные материалы, перейдите к разделу Установка API. Если conda не распознается, результат будет выглядеть примерно так: conda не найдена или не распознана как команда. Возможно, программа установлена на вашем компьютере, но не зарегистрирована в переменной среды PATH. Даже если это так, для единообразия перейдите к разделу Установка conda, поскольку учесть все возможные конфигурации системы сложно. Если в вашей домашней папке нет папки miniconda3, то приведенные ниже инструкции по установке conda должны сработать. Дополнительную информацию о месте установки и регистрации conda можно найти на страницах Установка Miniconda и Установка Anaconda.

Установите conda

Примечание. Если в вашей системе уже установлен conda, перейдите к разделу Установка API.

В этом разделе вы скачаете и установите Miniconda, которая будет служить платформой Python для доступа к Earth Engine API. Как описано выше, вы можете использовать Miniconda или Anaconda, но чтобы минимизировать влияние на вашу систему, в этом руководстве будет описана установка Miniconda без изменения переменных среды вашей системы. Если вы предпочитаете Anaconda, ознакомьтесь с инструкциями по установке, а затем перейдите к разделу Установка API.

Установите Miniconda

Скачивание и установка Miniconda выполняется в три этапа:

1. Скачайте 64-разрядный установщик Miniconda для Python 3 в домашний каталог.
2. Запустите установщик
3. Удалите установщик

Для этого скопируйте и вставьте следующие строки в интерфейс командной строки. В результате установки в домашнем каталоге появится папка miniconda3.

1. Скачайте установщик Miniconda в домашний каталог.

Linux

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

macOS

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

macOS

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

macOS

rm ~/miniconda.sh

Windows

del %UserProfile%\miniconda.exe

Проверьте установку Miniconda

Чтобы проверить установку Miniconda, выведите на экран меню справки для команды conda. Поскольку Miniconda не добавлена в переменную среды PATH, сначала нужно активировать conda для этого сеанса, вызвав команду activate по полному системному пути. Если тест пройдет успешно, в терминале появится conda справочных материалов. Выполните следующие строки в интерфейсе командной строки вашей системы.

Linux

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

macOS

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

Windows

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

Примечание. Чтобы деактивировать среду conda, выполните команду: conda deactivate.

Примечание. Если путь к Miniconda не задан как переменная среды, как в случае с этой установкой, вам нужно будет активировать Miniconda для каждого нового сеанса командной строки в будущем, включая использование API. Чтобы активировать Miniconda, используйте первую команду из фрагмента кода выше.

Добавьте Miniconda в переменную PATH

Внимание! Изменение системной переменной PATH может привести к непредвиденным последствиям.

При желании вы можете добавить путь установки Miniconda в переменную PATH вашей системы. Это позволит вам взаимодействовать с conda, просто вызывая conda, без необходимости сначала запускать команду activate по ее полному пути. Ниже приведены инструкции по добавлению Miniconda в переменную PATH.

Linux

Добавьте следующий путь к переменной среды PATH, выполнив инструкции для графического интерфейса пользователя или командной строки.

$HOME/miniconda3/bin

GUI

1. Откройте файл .bashrc в каталоге $HOME в текстовом редакторе.

xdg-open ~/.bashrc

2. Скопируйте и вставьте в конец файла следующие строки:

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

3. Сохраните файл и закройте текстовый редактор.

Примечание. Чтобы удалить добавленный путь conda, удалите только что добавленные строки.

Командная строка

Чтобы добавить путь conda в файл ~/.bashrc, введите в терминале следующую команду:

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

macOS

Добавьте следующий путь к переменной среды PATH, выполнив инструкции для графического интерфейса пользователя или командной строки.

$HOME/miniconda3/bin

GUI

1. Откройте файл .bashrc в каталоге $HOME в текстовом редакторе.

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

2. Скопируйте и вставьте в конец файла следующие строки:

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

3. Сохраните файл и закройте текстовый редактор.

Примечание. Чтобы удалить добавленный путь conda, удалите только что добавленные строки.

Командная строка

Чтобы добавить путь conda в файл ~/.bashrc, введите в терминале следующую команду:

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

Windows

Добавьте следующий путь к переменной среды Path, выполнив инструкции для графического интерфейса пользователя или командной строки.

%UserProfile%\miniconda3\condabin

GUI

1. Чтобы открыть диалоговое окно "Переменные среды", введите в командной строке следующую команду:

rundll32 sysdm.cpl,EditEnvironmentVariables

2. Нажмите дважды на переменную Path в разделе User, чтобы выбрать ее для редактирования.

3. Нажмите кнопку "Изменить текст" в новом диалоговом окне "Изменить", чтобы открыть редактор.

4. Добавьте следующую строку в конец существующего значения переменной Path. Убедитесь, что запись отделена от соседних точкой с запятой (;).

%UserProfile%\miniconda3\condabin;

5. Нажимайте кнопку "ОК", пока не закроются все диалоговые окна.

Примечание. Добавленный путь conda можно удалить тем же способом.

Командная строка

Чтобы добавить путь, используйте команду setx. В командной строке введите:

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

Примечание. Чтобы изменения переменных среды вступили в силу, перезапустите открытые интерфейсы командной строки.

Инициализация conda

Инициализируйте conda для взаимодействия с оболочкой. Чтобы узнать, как инициализировать различные оболочки, выполните следующую команду: Следуйте инструкциям, которые появятся в консоли после ввода команды.

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 можно найти на этом сайте.

Примечание. В первом шаге предполагается, что вы только что выполнили инструкции из раздела Установка conda, не изменяя переменные среды и не инициализируя conda для использования оболочки. Команда составлена соответствующим образом. Если вы ранее установили conda другим способом или зарегистрировали conda для использования в оболочке, выполните необходимые действия, чтобы активировать conda, а затем начните следовать инструкциям с шага 2.

1. Активируйте базовую среду conda, если она ещё не активирована.

Linux

source $HOME/miniconda3/bin/activate

macOS

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. Установите 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 аутентификация будет выполняться с помощью этого файла. Если вы хотите отозвать авторизацию, просто удалите файл с учетными данными.

Linux

ls $HOME/.config/earthengine/credentials

macOS

ls $HOME/.config/earthengine/credentials

Windows

dir %UserProfile%\.config\earthengine\credentials

Тестирование API

Чтобы проверить установку API, запустите простой скрипт 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('NASA/NASADEM_HGT/001').getInfo())

Последующее использование API

Каждый раз, когда вы хотите использовать Earth Engine API, вы должны сначала активировать среду conda ee. Процедура активации зависит от того, зарегистрирована ли conda для использования в оболочке. Следуйте инструкциям ниже.

Conda не зарегистрирован

Приведенная ниже команда активации среды conda ee предполагает, что conda была установлена в соответствии с инструкциями в разделе Установка conda выше, то есть путь установки предполагается на основе предыдущих шагов. Выполните следующую команду в интерфейсе командной строки:

Linux

source $HOME/miniconda3/bin/activate ee

macOS

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.

Обновление API

Используйте команду conda update, чтобы обновить среду ee до последней версии API. Не забудьте сначала активировать среду conda ee, если она ещё не активна.

conda update -c conda-forge earthengine-api

Чтобы узнать номер установленной версии в Python, выведите свойство __version__ библиотеки ee. Запустите интерпретатор Python, введя python в командной строке среды conda ee, а затем введите следующие команды.

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

macOS

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. Вы также можете использовать команду remove или флаг --clone команды create, чтобы управлять названиями сред.

Примечание. При репликации сред в разных операционных системах могут возникать ошибки, поскольку сборки и версии пакетов для разных ОС могут быть недоступны или создавать конфликты зависимостей.