Python 설치 - Conda 설치


Earth Engine Python API는 Python 패키지 및 환경 관리자인 conda를 통해 로컬 머신에 설치할 수 있습니다. Conda는 Anaconda 및 Miniconda Python 배포와 번들로 제공됩니다. Anaconda는 1, 500개가 넘는 패키지가 포함된 데이터 사이언스 프로그래밍 플랫폼인 반면 Miniconda는 conda와 그 종속 항목만 포함합니다. 이러한 Python 배포 중 하나는 Earth Engine API를 설치하고 사용하는 데 적합합니다. 이러한 배포에 익숙하지 않다면 링크를 방문하여 자세히 알아보세요.

이 가이드에서는 다음을 안내합니다.

  • 기존 conda 설치 확인
  • 로컬 머신에 conda 설치
  • Earth Engine Python API 설치
  • 인증 사용자 인증 정보 설정
  • API 테스트

conda 설치 확인

시스템에 conda가 이미 설치되어 있으면 API 설치 섹션으로 건너뜁니다. conda가 설치되어 있는지 확실하지 않으면 명령줄 인터페이스에 다음 명령어를 입력하여 확인합니다.

conda --help

conda가 설치되어 있고 시스템 경로가 PATH 환경 변수에 등록되어 있으면 conda 도움말 콘텐츠가 터미널에 표시됩니다. 도움말 콘텐츠가 표시되면 API 설치 섹션으로 건너뜁니다. conda가 인식되지 않으면 conda를 찾을 수 없거나 명령어로 인식되지 않음과 같은 결과가 표시됩니다. 프로그램이 시스템에 있지만 PATH 환경 변수에 등록되지 않았을 수 있습니다. 이 경우에도 일관성을 위해 가능한 모든 시스템 구성을 해결하기는 어렵으므로 conda 설치 섹션을 계속 진행하세요. Home 폴더에 'miniconda3' 폴더가 없는 한 다음 conda 설치 안내를 실행하면 됩니다. conda 설치 위치 및 등록에 관한 자세한 내용은 Miniconda 설치 및 Anaconda 설치 페이지를 참고하세요.

conda 설치

이 섹션에서는 Earth Engine API에 액세스하는 Python 플랫폼 역할을 하는 Miniconda를 다운로드하여 설치합니다. 위에서 설명한 대로 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

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"

2. 기본값을 수락하여 홈 디렉터리에 Miniconda를 자동으로 설치합니다.

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

3. 홈 디렉터리에서 Miniconda 설치 프로그램을 삭제합니다.

Linux

rm ~/miniconda.sh

Mac

rm ~/miniconda.sh

Windows

del %UserProfile%\miniconda.exe

Miniconda 설치 테스트

conda 명령어의 도움말 메뉴를 출력하여 Miniconda 설치를 테스트합니다. Miniconda가 시스템의 PATH 환경 변수에 추가되지 않았으므로 먼저 전체 시스템 경로로 activate 명령어를 호출하여 이 세션의 conda를 활성화해야 합니다. 테스트에 성공하면 터미널에 conda 도움말 콘텐츠가 표시됩니다. 시스템의 명령줄 인터페이스에서 다음 줄을 실행합니다.

Linux

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

Mac

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

Windows

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

PATH 변수에 Miniconda 추가

원하는 경우 Miniconda 설치 경로를 시스템의 PATH 변수에 추가할 수 있습니다. 이렇게 하면 먼저 전체 경로로 activate 명령어를 실행하지 않고도 간단하게 conda를 호출하여 conda와 상호작용할 수 있습니다. 다음 안내에서는 Miniconda 설치를 시스템의 PATH 변수에 추가하는 방법을 설명합니다.

Linux

아래의 GUI 또는 명령줄 안내를 완료하여 'PATH' 환경 변수에 다음 경로를 추가합니다.

$HOME/miniconda3/bin

GUI

1. 텍스트 편집기에서 $HOME 디렉터리에 있는 .bashrc 파일을 엽니다.

xdg-open ~/.bashrc

2. 다음 줄을 복사하여 파일 하단에 붙여넣습니다.

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

3. 파일을 저장하고 텍스트 편집기를 닫습니다.

명령줄

터미널에 다음 명령어를 입력하여 ~/.bashrc 파일에 conda 경로를 추가합니다.

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

Mac

아래의 GUI 또는 명령줄 안내를 완료하여 'PATH' 환경 변수에 다음 경로를 추가합니다.

$HOME/miniconda3/bin

GUI

1. 텍스트 편집기에서 $HOME 디렉터리에 있는 .bashrc 파일을 엽니다.

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

2. 다음 줄을 복사하여 파일 하단에 붙여넣습니다.

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

3. 파일을 저장하고 텍스트 편집기를 닫습니다.

명령줄

터미널에 다음 명령어를 입력하여 ~/.bashrc 파일에 conda 경로를 추가합니다.

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

Windows

아래의 GUI 또는 명령줄 안내를 완료하여 '경로' 환경 변수에 다음 경로를 추가합니다.

%UserProfile%\miniconda3\condabin

GUI

1. 명령 프롬프트에 다음 줄을 입력하여 '환경 변수' 대화상자를 엽니다.

rundll32 sysdm.cpl,EditEnvironmentVariables

2. '사용자' 섹션에서 '경로' 변수를 더블클릭하여 수정할 변수를 선택합니다.

3. 새 '수정' 대화상자 창에서 '텍스트 수정' 버튼을 클릭하여 편집기를 엽니다.

4. 기존 '경로' 변수 값 끝에 다음 문자열을 추가합니다. 항목을 인접한 항목과 구별하기 위해 세미콜론 (;)으로 항목을 묶습니다.

%UserProfile%\miniconda3\condabin;

5. 모든 대화상자 창이 닫힐 때까지 '확인' 버튼을 클릭합니다.

명령줄

setx 명령어를 사용하여 경로를 추가합니다. 명령 프롬프트에서 다음을 입력합니다.

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

conda 초기화

셸 상호작용을 위해 conda를 초기화합니다. 다양한 셸의 초기화에 관한 정보를 확인하려면 다음 명령어를 실행합니다. 명령어를 입력하면 콘솔에 출력되는 후속 안내를 따릅니다.

conda init --help

명령줄 인터페이스를 다시 시작한 후 다음 명령어로 기본 conda 환경을 활성화할 수 있습니다.

conda activate

API 설치

Earth Engine Python API는 https://anaconda.org/conda-forge/earthengine-api에서 conda-forge 패키지로 배포됩니다. conda install 명령어로 설치됩니다. 하지만 설치하기 전에 Earth Engine 전용 conda 환경을 만드세요. Earth Engine API를 자체 환경에 설치하면 Earth Engine API와 종속 패키지가 기본 환경 또는 이전에 설정한 다른 환경에서 버전 관리 문제를 일으키지 않으며 그 반대의 경우도 마찬가지입니다. conda 환경 관리에 관한 자세한 내용은 이 사이트를 참고하세요.

1. 기본 conda 환경이 아직 활성화되어 있지 않으면 활성화합니다.

Linux

source $HOME/miniconda3/bin/activate

Mac

source $HOME/miniconda3/bin/activate

Windows

%UserProfile%\miniconda3\condabin\activate

2. Earth Engine API용 conda 가상 환경을 만듭니다.

conda create --name ee

환경 생성을 확인하라는 메시지가 표시되면 확인합니다.

3. conda ee 환경을 활성화합니다.

conda activate ee

4. conda ee 환경에 API를 설치합니다. 명령줄 시작 부분에 (ee)이 표시되어 ee 환경에서 작업 중임을 나타내는지 확인합니다.

conda install -c conda-forge earthengine-api

API 및 종속 항목의 설치를 확인하라는 메시지가 표시됩니다. 확인하면 conda에서 종속 항목을 다운로드하여 설치합니다. 문제가 없다면 이제 API에 액세스하는 데 필요한 모든 요구사항과 earthengine 명령줄 도구가 포함된 'ee'라는 conda 환경이 생성됩니다.

사용자 인증 정보 가져오기

Earth Engine API 또는 earthengine 명령줄 도구를 사용하기 전에 Google 계정을 대신하여 Earth Engine에 대한 액세스를 승인하는 일회성 인증을 실행해야 합니다. 인증하려면 earthengine 명령줄 도구의 authenticate 명령어를 사용합니다.

conda ee 환경에서 다음 명령어를 실행하고 표시되는 안내를 따릅니다. 동의 시 승인 코드를 생성하는 URL이 제공됩니다. 승인 코드를 복사하여 명령줄 입력으로 입력합니다.

earthengine authenticate

승인 코드를 입력하면 승인 토큰이 아래에서 확인할 수 있는 사용자 인증 정보 파일에 저장됩니다. 이후 API의 ee.Initialize() 명령어와 earthengine 명령줄 도구를 사용하면 이 파일을 보고 인증합니다. 승인을 취소하려면 사용자 인증 정보 파일을 삭제하면 됩니다.

Linux

ls $HOME/.config/earthengine/credentials

Mac

ls $HOME/.config/earthengine/credentials

Windows

dir %UserProfile%\.config\earthengine\credentials

API 테스트

DEM 데이터 세트의 메타데이터를 출력하는 간단한 Python 스크립트를 실행하여 API 설치를 테스트합니다. JSON 객체가 콘솔에 출력됩니다.

1. conda ee 환경에서 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 사용

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 설치 페이지를 참고하세요.

API 업데이트

conda update 명령어를 사용하여 ee 환경을 최신 API 버전으로 업데이트합니다. conda ee 환경이 아직 활성화되어 있지 않은 경우 먼저 활성화해야 합니다.

conda update -c conda-forge earthengine-api

ee 라이브러리 __version__ 속성을 출력하여 Python에서 현재 설치된 버전 번호를 가져옵니다. ee conda 환경 명령줄에 python를 입력하여 Python 인터프리터를 시작한 다음 다음 명령어를 입력합니다.

import ee
print(ee.__version__)

ee 환경 공유

특히 추가 Python 패키지를 설치한 경우 재현 가능하고 재현 가능한 결과를 얻으려면 conda Python 환경을 다른 사용자와 공유하는 것이 좋습니다. Conda는 다른 사용자가 내 환경을 복제할 수 있는 편리한 방법을 제공합니다.

conda ee 환경에서 다음 명령어를 실행하여 'ee-shared-env'라는 YAML 파일을 홈 디렉터리에 저장합니다. 이 파일에는 환경 사양이 나열되어 있습니다.

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