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

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

Это руководство проведет вас через:

• Проверка существующей установки conda
• Установка conda на локальную машину
• Установка API Python 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 .

Установить Конду

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

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

Установить Миниконду

Загрузка и установка 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

Распечатайте меню справки команды conda , чтобы проверить установку Miniconda. Поскольку 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

Примечание. Активированную среду conda можно деактивировать, запустив: conda deactivate .

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

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

Внимание: изменение переменной PATH вашей системы может иметь непредвиденные последствия.

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

Линукс

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

Окна

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

%UserProfile%\miniconda3\condabin

графический интерфейс

1. Введите следующую строку в командной строке, чтобы открыть диалоговое окно «Переменная среды».

rundll32 sysdm.cpl,EditEnvironmentVariables

2. Дважды щелкните переменную «Путь» в разделе «Пользователь», чтобы выбрать ее для редактирования.

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

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

%UserProfile%\miniconda3\condabin;

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

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

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

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

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

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

Инициализировать конду

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

conda init --help

После перезапуска интерфейса командной строки вы сможете активировать базовую среду conda с помощью следующей команды.

conda activate

Установить API

API Python Earth Engine распространяется в виде пакета 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, если это еще не сделано.

Линукс

source $HOME/miniconda3/bin/activate

Мак

source $HOME/miniconda3/bin/activate

Окна

%UserProfile%\miniconda3\condabin\activate

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

conda create --name ee

Вам будет предложено подтвердить создание среды, сделайте это.

3. Активируйте среду condaee .

conda activate ee

4. Установите API в среду condaee . Убедитесь, что (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

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

Линукс

ls $HOME/.config/earthengine/credentials

Мак

ls $HOME/.config/earthengine/credentials

Окна

dir %UserProfile%\.config\earthengine\credentials

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

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

1. Запустите интерпретатор python из среды вашего компьютера .

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())

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

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

Конда не зарегистрирована

Следующая команда активации среды conda ee предполагает, что conda была установлена ​​в соответствии с инструкциями, приведенными выше в разделе «Установка 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 .

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

Обновление API

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

conda update -c conda-forge earthengine-api

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

import ee
print(ee.__version__)

Совместное использование вашей среды ee

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

В вашей среде 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

Примечание. Первая строка файла ee-shared-env.yml определяет имя создаваемой среды. Conda не будет перезаписывать существующую среду, поэтому, возможно, придется изменить имя среды в файле ee-shared-env.yml . В качестве альтернативы используйте команду remove conda или флаг --clone команды create conda для управления именами сред.

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