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

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

Это руководство поможет вам во всем разобраться:

• Проверка наличия существующей установки conda.
• Установка conda на локальном компьютере
• Установка Python API для Earth Engine
• Настройка учетных данных для аутентификации
• Тестирование 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 для доступа к API Earth Engine. Как описано выше, вы можете использовать Miniconda или Anaconda, но для минимизации воздействия на вашу систему в этом руководстве будет описана установка Miniconda без изменения переменных окружения вашей системы. Если вы предпочитаете Anaconda, пожалуйста, ознакомьтесь с инструкциями по установке, приведенными здесь , а затем перейдите к разделу «Установка API» .

Установите Miniconda.

Загрузка и установка Miniconda осуществляется в три этапа:

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

Выполните следующие шаги, скопировав и вставив указанные ниже строки в соответствующий интерфейс командной строки вашей системы. В результате установки в ваш домашний каталог будет добавлена ​​папка с именем 'miniconda3'.

1. Загрузите установщик Miniconda в свою домашнюю директорию.

Linux

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

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

Мак

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

Мак

rm ~/miniconda.sh

Windows

del %UserProfile%\miniconda.exe

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

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

Linux

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

Мак

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

Графический интерфейс пользователя

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

Мак

Добавьте следующий путь в переменную среды '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 можно удалить, удалив только что добавленные строки.

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

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

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

Windows

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

%UserProfile%\miniconda3\condabin

Графический интерфейс пользователя

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

Установить API

API Earth Engine для Python распространяется в виде пакета conda-forge по адресу: https://anaconda.org/conda-forge/earthengine-api . Он устанавливается с помощью команды conda install . Однако перед установкой создайте среду conda специально для Earth Engine. Установка API Earth Engine в отдельную среду гарантирует, что он и зависимые от него пакеты не вызовут проблем с версионированием в вашей базовой среде или любой другой среде, которую вы ранее настроили, и наоборот. Для получения дополнительной информации об управлении средами conda посетите этот сайт .

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

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

Linux

source $HOME/miniconda3/bin/activate

Мак

source $HOME/miniconda3/bin/activate

Windows

%UserProfile%\miniconda3\condabin\activate

2. Создайте виртуальную среду conda для API Earth Engine.

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 .

Получить учетные данные

Перед использованием API Earth Engine или инструмента командной строки earthengine необходимо выполнить одноразовую аутентификацию, которая авторизует доступ к Earth Engine от имени вашей учетной записи Google. Для аутентификации используйте команду authenticate из инструмента командной строки earthengine .

В среде conda ee выполните следующую команду и следуйте инструкциям, которые появятся на экране. Вам будет предоставлен URL-адрес, который сгенерирует код авторизации после подтверждения. Скопируйте код авторизации и введите его в командной строке.

earthengine authenticate

После ввода кода авторизации токен авторизации сохраняется в файле учетных данных, который можно найти ниже. Последующее использование команды ee.Initialize() API и инструмента командной строки earthengine будет использовать этот файл для аутентификации. Если вы хотите отозвать авторизацию, просто удалите файл учетных данных.

Linux

ls $HOME/.config/earthengine/credentials

Мак

ls $HOME/.config/earthengine/credentials

Windows

dir %UserProfile%\.config\earthengine\credentials

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

Для проверки установки API запустите простой скрипт на Python, который выводит метаданные для набора данных DEM. Он должен вывести в консоль объект JSON.

1. Запустите интерпретатор python из вашей среды conda ee .

python

2. Выполните следующие строки кода Python по очереди, чтобы распечатать метаданные для набора данных ЦМР.

import ee

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

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

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

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

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

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

Linux

source $HOME/miniconda3/bin/activate ee

Мак

source $HOME/miniconda3/bin/activate ee

Windows

%UserProfile%\miniconda3\condabin\activate ee

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

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

conda activate ee

После выполнения команды в начале командной строки должно появиться (ee) , указывающее на то, что вы работаете в среде ee .

Теперь вы готовы запустить интерпретатор Python и получить доступ к API Python для Earth Engine. Общие рекомендации по работе с API Python см. на странице установки 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

Для получения воспроизводимых и повторяемых результатов может быть полезно поделиться своей средой Python, созданной с помощью conda, с другими пользователями, особенно если вы установили дополнительные пакеты Python. Conda предоставляет удобный способ для других пользователей воспроизвести вашу среду.

В среде conda ee выполните следующую команду, чтобы сохранить YAML-файл с именем 'ee-shared-env' в домашний каталог, в котором будут перечислены параметры вашей среды.

Linux

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

Мак

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 в Conda или флаг --clone в команде create Conda для управления именами сред.

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