Instalacja Pythona – instalacja Conda

Interfejs Python API Earth Engine można zainstalować na komputerze lokalnym za pomocą condy, czyli menedżera pakietów i środowiska Pythona. Conda jest dostarczana w pakiecie z dystrybucjami Anaconda i Miniconda Pythona. Anaconda to platforma programistyczna do badania danych, która zawiera ponad 1500 pakietów, a Miniconda zawiera tylko conda i jego zależności. Każda z tych dystrybucji Pythona nadaje się do instalowania interfejsu Earth Engine API i korzystania z niego. Jeśli nie znasz tych dystrybucji, kliknij odpowiednie linki, aby dowiedzieć się więcej.

W tym przewodniku znajdziesz informacje o:

• Sprawdzanie, czy instalacja conda jest już obecna
• Instalowanie conda na komputerze lokalnym
• Instalowanie interfejsu Python API Earth Engine
• Konfigurowanie danych logowania
• Testowanie interfejsu API

Uwaga: wykonaj podane niżej czynności w wierszu poleceń systemu Windows lub w terminalu Unix (Linux/Mac). Aby przełączyć się na polecenia odpowiednie dla Twojego systemu operacyjnego, użyj kart u góry każdej sekcji kodu.

Sprawdź instalację conda

Jeśli conda jest już zainstalowana w Twoim systemie, przejdź do sekcji Instalowanie interfejsu API. Jeśli nie masz pewności, czy conda jest zainstalowana, sprawdź to, wpisując to polecenie w interfejsie wiersza poleceń.

conda --help

Jeśli conda jest zainstalowana, a jej ścieżka systemowa jest zarejestrowana w zmiennej środowiskowej PATH, w terminalu powinna się wyświetlić pomoc dotycząca conda. Jeśli pojawi się materiał pomocy, przejdź do sekcji Instalowanie interfejsu API. Jeśli conda nie zostanie rozpoznana, wynik będzie wyglądać mniej więcej tak: conda nie została znaleziona lub nie została rozpoznana jako polecenie. Możliwe, że program istnieje w Twoim systemie, ale nie jest zarejestrowany w zmiennej środowiskowej PATH. Nawet jeśli tak jest, zachowaj spójność i przeczytaj sekcję Instalowanie conda, ponieważ trudno jest uwzględnić wszystkie możliwe konfiguracje systemu. Jeśli w folderze domowym nie ma folderu „miniconda3”, instalacja pakietu conda powinna się udać. Więcej informacji o lokalizacji instalacji i rejestracji conda znajdziesz na stronach Instalacja Miniconda oraz Instalacja Anaconda.

Instalowanie conda

Uwaga: jeśli conda jest już zainstalowana w Twoim systemie, przejdź do sekcji Zainstaluj interfejs API.

W tej sekcji pobierzesz i zainstalujesz Miniconda, który będzie służyć jako platforma Pythona do uzyskiwania dostępu do interfejsu Earth Engine API. Jak opisano powyżej, możesz użyć Miniconda lub Anaconda, ale aby zminimalizować wpływ na system, w tym przewodniku opisujemy instalację Miniconda bez zmiany zmiennych środowiskowych systemu. Jeśli wolisz Anaconda, przeczytaj instrukcje instalacji podane tutaj, a potem przejdź do sekcji Instalowanie interfejsu API.

Instalowanie Miniconda

Pobieranie i instalowanie Miniconda odbywa się w 3 kroki:

1. Pobierz 64-bitowy instalator Miniconda Pythona 3 do katalogu domowego.
2. Uruchom instalator
3. Usuń instalator

Aby wykonać te czynności, skopiuj i wklej podane niżej wiersze do odpowiedniego interfejsu wiersza poleceń w swoim systemie. Instalacja powoduje dodanie folderu „miniconda3” do katalogu domowego.

1. Pobierz instalator Miniconda do katalogu domowego.

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. Zainstaluj Miniconda bez wyświetlania komunikatów, akceptując domyślne ustawienia, w katalogu domowym.

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. Usuń instalator Miniconda z katalogu domowego.

Linux

rm ~/miniconda.sh

Mac

rm ~/miniconda.sh

Windows

del %UserProfile%\miniconda.exe

Testowanie instalacji Miniconda

Wydrukuj menu pomocy polecenia conda, aby przetestować instalację Miniconda. Ponieważ Miniconda nie została dodana do zmiennej środowiskowej PATH systemu, musisz najpierw aktywować conda na potrzeby tej sesji, wywołując polecenie activate z pełną ścieżką systemową. Pomyślnie przeprowadzony test spowoduje wyświetlenie w terminalu treści pomocy conda. Uruchom te wiersze w interfejsie wiersza poleceń systemu.

Linux

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

Mac

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

Windows

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

Uwaga: aktywowane środowisko conda można dezaktywować, wykonując polecenie: conda deactivate.

Uwaga: jeśli ścieżka do Miniconda nie jest ustawiona jako zmienna środowiskowa, jak w tym przypadku instalacji, musisz aktywować Miniconda w przypadku każdej nowej sesji wiersza poleceń w przyszłości, w tym podczas korzystania z interfejsu API. W razie potrzeby użyj pierwszego polecenia z powyższego fragmentu kodu, aby aktywować Miniconda.

Dodawanie Miniconda do zmiennej PATH

Uwaga: zmiana zmiennej PATH systemu może mieć niezamierzone konsekwencje.

Opcjonalnie możesz dodać ścieżkę instalacji Miniconda do zmiennej PATH systemu, co pozwoli Ci korzystać z conda za pomocą prostego wywołania conda bez konieczności uruchamiania polecenia activate z pełną ścieżką. W podanych niżej instrukcjach dowiesz się, jak dodać zainstalowaną Minicondę do zmiennej PATH systemu.

Linux

Dodaj tę ścieżkę do zmiennej środowiskowej „PATH”, wykonując instrukcje podane poniżej w interfejsie graficznym lub w wierszu poleceń.

$HOME/miniconda3/bin

GUI

1. Otwórz plik .bashrc w katalogu $HOME w edytorze tekstu.

xdg-open ~/.bashrc

2. Skopiuj i wklej te wiersze na końcu pliku.

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

3. Zapisz plik i zamknij edytor tekstu.

Uwaga: dodaną ścieżkę conda można usunąć, usuwając właśnie dodane wiersze.

Wiersz poleceń

Aby dołączyć ścieżkę do conda do pliku ~/.bashrc, wpisz to polecenie w terminalu.

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

Mac

Dodaj tę ścieżkę do zmiennej środowiskowej „PATH”, wykonując instrukcje podane poniżej w interfejsie graficznym lub w wierszu poleceń.

$HOME/miniconda3/bin

GUI

1. Otwórz plik .bashrc w katalogu $HOME w edytorze tekstu.

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

2. Skopiuj i wklej te wiersze na końcu pliku.

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

3. Zapisz plik i zamknij edytor tekstu.

Uwaga: dodaną ścieżkę conda można usunąć, usuwając właśnie dodane wiersze.

Wiersz poleceń

Aby dołączyć ścieżkę do conda do pliku ~/.bashrc, wpisz to polecenie w terminalu.

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

Windows

Dodaj tę ścieżkę do zmiennej środowiskowej „Ścieżka”, wykonując czynności opisane poniżej w interfejsie graficznym lub w wierszu poleceń.

%UserProfile%\miniconda3\condabin

GUI

1. Aby otworzyć okno „Zmienna środowiskowa”, wpisz ten wiersz w wierszu poleceń.

rundll32 sysdm.cpl,EditEnvironmentVariables

2. Kliknij dwukrotnie zmienną „Ścieżka” w sekcji „Użytkownik”, aby ją wybrać do edycji.

3. Aby otworzyć edytor, w nowym oknie „Edytuj” kliknij przycisk „Edytuj tekst”.

4. Dodaj ten ciąg znaków na końcu dotychczasowej wartości zmiennej „Ścieżka”. Pamiętaj, aby wpisy były otoczone średnikami (;), aby odróżnić je od sąsiednich wpisów.

%UserProfile%\miniconda3\condabin;

5. Klikaj przyciski „OK”, aż wszystkie okna dialogowe zostaną zamknięte.

Uwaga: dodaną ścieżkę conda można usunąć za pomocą tej samej metody edycji.

Wiersz poleceń

Aby dołączyć ścieżkę, użyj polecenia setx. W wierszu polecenia wpisz:

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

Uwaga: aby zmiany zmiennych środowiskowych zaczęły obowiązywać, uruchom ponownie otwarte interfejsy wiersza poleceń.

Inicjowanie conda

Inicjalizacja conda do interakcji z powłoką. Uruchom podane niżej polecenie, aby uzyskać informacje o inicjalizacji różnych powłok. Po wpisaniu polecenia postępuj zgodnie z kolejnowymi instrukcjami wyświetlanymi na konsoli.

conda init --help

Po ponownym uruchomieniu interfejsu wiersza poleceń możesz aktywować podstawowe środowisko conda za pomocą tego polecenia.

conda activate

Instalowanie interfejsu API

Interfejs API Earth Engine w Pythonie jest dystrybuowany jako pakiet conda-forge pod adresem: https://anaconda.org/conda-forge/earthengine-api. Jest on instalowany za pomocą polecenia conda install. Zanim jednak zainstalujesz pakiet, utwórz środowisko conda specjalnie dla Earth Engine. Instalowanie interfejsu API Earth Engine w osobnym środowisku gwarantuje, że ono i zależne od niego pakiety nie spowodują problemów z wersjami w Twoim środowisku bazowym ani w żadnym innym środowisku skonfigurowanym wcześniej. Odwrotnie też. Więcej informacji o zarządzaniu środowiskami conda znajdziesz tutaj.

Uwaga: w pierwszym kroku zakładamy, że masz już za sobą sekcję Instalowanie conda bez zmiany zmiennych środowiskowych ani inicjowania conda do użycia w powłoce. Polecenie jest odpowiednio sformułowane. Jeśli conda została zainstalowana wcześniej w inny sposób lub została zarejestrowana do użycia w powłoce, wykonaj czynności niezbędne do aktywacji conda, a następnie zacznij wykonywać instrukcje od kroku 2.

1. Aktywuj podstawowe środowisko conda, jeśli nie zostało jeszcze aktywowane.

Linux

source $HOME/miniconda3/bin/activate

Mac

source $HOME/miniconda3/bin/activate

Windows

%UserProfile%\miniconda3\condabin\activate

2. Utwórz środowisko wirtualne conda dla interfejsu API Earth Engine.

conda create --name ee

Pojawi się prośba o potwierdzenie utworzenia środowiska.

3. Aktywuj środowisko conda ee.

conda activate ee

4. Zainstaluj interfejs API w środowisku ee w conda. Sprawdź, czy na początku wiersza polecenia znajduje się znak (ee), co oznacza, że pracujesz w środowisku ee.

conda install -c conda-forge earthengine-api

Pojawi się prośba o potwierdzenie instalacji interfejsu API i jego zależności. Po potwierdzeniu conda pobierze i zainstaluje zależności. Jeśli wszystko pójdzie zgodnie z planem, będziesz mieć teraz środowisko conda o nazwie „ee” ze wszystkimi wymaganiami dotyczącymi dostępu do interfejsu API oraz narzędziem wiersza poleceń earthengine .

Uzyskaj dane logowania

Zanim użyjesz interfejsu Earth Engine API lub narzędzia wiersza poleceń earthengine, musisz przeprowadzić jednorazowe uwierzytelnienie, które autoryzuje dostęp do Earth Engine w imieniu Twojego konta Google. Aby uwierzytelnić się, użyj polecenia authenticate w narzędziu wiersza poleceń earthengine.

W środowisku ee w conda uruchom to polecenie i postępuj zgodnie z wydrukowanymi instrukcjami. Po zawarciu umowy otrzymasz adres URL, który wygeneruje kod autoryzacji. Skopiuj kod autoryzacji i wpisz go w wierszu polecenia.

earthengine authenticate

Po wpisaniu kodu autoryzacji token autoryzacji zostanie zapisany w pliku danych uwierzytelniających, który znajdziesz poniżej. Kolejne użycie polecenia ee.Initialize() interfejsu API i narzędzia wiersza poleceń earthengine będzie sprawdzać ten plik w celu uwierzytelnienia. Jeśli chcesz cofnąć autoryzację, po prostu usuń plik z danymi logowania.

Linux

ls $HOME/.config/earthengine/credentials

Mac

ls $HOME/.config/earthengine/credentials

Windows

dir %UserProfile%\.config\earthengine\credentials

Testowanie interfejsu API

Uruchom prosty skrypt Pythona, który wypisuje metadane zbioru danych DEM, aby przetestować instalację interfejsu API. Powinien on wydrukować obiekt JSON do konsoli.

1. Uruchom interpreter python w środowisku ee w conda.

python

2. Aby wydrukować metadane zbioru danych DEM, uruchom po kolei te wiersze kodu Pythona

import ee

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

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

Kolejne użycie interfejsu API

Za każdym razem, gdy chcesz użyć interfejsu Earth Engine API, musisz najpierw aktywować środowisko ee w kondzie. Procedura aktywacji zależy od tego, czy conda jest zarejestrowana do użycia w powłoce. Poniżej znajdziesz instrukcje dotyczące instalacji conda.

Conda nie jest zarejestrowany

Poniższe polecenie aktywacji środowiska conda ee zakłada, że conda została zainstalowana zgodnie z instrukcjami w sekcji Instalowanie conda, czyli że ścieżka instalacji jest założona na podstawie poprzednich kroków. Uruchom to polecenie w interfejsie wiersza poleceń.

Linux

source $HOME/miniconda3/bin/activate ee

Mac

source $HOME/miniconda3/bin/activate ee

Windows

%UserProfile%\miniconda3\condabin\activate ee

Conda zarejestrowana

Podane niżej polecenie aktywacji środowiska conda ee zakłada, że conda została zarejestrowana do użycia w powłoce lub wierszu poleceń zgodnie z instrukcjami w tym przewodniku lub innymi środkami. Uruchom to polecenie w interfejsie wiersza poleceń.

conda activate ee

Po wykonaniu polecenia na początku wiersza poleceń powinien pojawić się znak (ee), co oznacza, że pracujesz w środowisku ee.

Teraz możesz uruchomić interpreter Pythona i uzyskać dostęp do interfejsu Earth Engine Python API. Ogólne wskazówki dotyczące pracy z interfejsem Python API znajdziesz na stronie Instalacja Pythona.

Aktualizowanie interfejsu API

Użyj polecenia conda update, aby zaktualizować środowisko ee do najnowszej wersji interfejsu API. Pamiętaj, aby najpierw aktywować środowisko ee w conda, jeśli nie jest jeszcze aktywne.

conda update -c conda-forge earthengine-api

Aby uzyskać numer aktualnie zainstalowanej wersji w Pythonie, wydrukuj właściwość ee biblioteki __version__. Uruchom interpreter Pythona, wpisując python w wierszu poleceń środowiska conda ee, a następnie wpisz te polecenia.

import ee
print(ee.__version__)

Udostępnianie środowiska ee

Udostępnianie innym użytkownikom środowiska Pythona conda może być przydatne w osiąganiu powtarzalnych i powtarzalnych wyników, zwłaszcza gdy masz zainstalowane dodatkowe pakiety Pythona. Conda zapewnia wygodny sposób na powielanie środowiska.

W środowisku conda ee uruchom podane niżej polecenie, aby zapisać plik YAML o nazwie „ee-shared-env” w katalogu domowym. Zawiera on specyfikacje środowiska.

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

Udostępnij utworzony plik, a odbiorca będzie mógł odtworzyć środowisko, wykonując to polecenie conda.

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

Uwaga: pierwszy wiersz pliku ee-shared-env.yml określa nazwę tworzonego środowiska. Conda nie nadpisuje istniejącego środowiska, więc może być konieczna zmiana nazwy środowiska w pliku ee-shared-env.yml. Możesz też użyć polecenia remove w pakiecie conda lub opcji --clone w komandach create, aby zarządzać nazwami środowisk.

Uwaga: powielanie środowisk w różnych systemach operacyjnych może się nie udać, ponieważ istnieją kompilacje i wersje pakietów specyficzne dla systemu operacyjnego, które mogą być niedostępne lub powodować konflikty zależności.