L'API Python di Earth Engine può essere installata su una macchina locale tramite conda, un gestore di pacchetti e ambienti Python. Conda è incluso nelle distribuzioni Python Anaconda e Miniconda. Anaconda è una piattaforma di programmazione di data science che include più di 1500 pacchetti, mentre Miniconda include solo conda e le relative dipendenze. Entrambe queste distribuzioni Python sono adatte per l'installazione e l'utilizzo dell'API Earth Engine. Se non hai familiarità con queste distribuzioni, visita i link per saperne di più.
Questa guida ti illustrerà come:
- Verificare se esiste già un'installazione di conda
- Installare conda su una macchina locale
- Installare l'API Python di Earth Engine
- Configurare le credenziali di autenticazione
- Testare l'API
Verificare l'installazione di conda
Se conda è già installato sul tuo sistema, vai alla sezione Installare l'API. Se non sai con certezza se conda è installato, verifica inserendo il seguente comando nell'interfaccia a riga di comando.
conda --help
Se conda è installato e il relativo percorso di sistema è registrato nella variabile di ambiente PATH, i contenuti della guida di conda dovrebbero essere visualizzati nel terminale. Se vengono visualizzati i contenuti della guida, vai alla sezione Installare l'API. Se conda non viene riconosciuto, il risultato sarà simile a: conda not found or not recognized as a command. È possibile che il programma esista sul tuo sistema, ma non sia registrato nella variabile di ambiente PATH. Anche in questo caso, per coerenza, ti preghiamo di continuare con la sezione Installare conda, poiché è difficile affrontare tutte le possibili configurazioni di sistema. Se la cartella "miniconda3" non esiste nella tua cartella Home, le seguenti istruzioni di installazione di conda dovrebbero essere eseguite correttamente. Per ulteriori informazioni sulla posizione di installazione e sulla registrazione di conda, consulta le pagine Installazione di Miniconda e Installazione di Anaconda.
Installare conda
In questa sezione scaricherai e installerai Miniconda, che fungerà da piattaforma Python per accedere all'API Earth Engine. Come descritto sopra, puoi utilizzare Miniconda o Anaconda, ma per ridurre al minimo l'impatto sul sistema, questa guida descrive un'installazione di Miniconda senza modificare le variabili di ambiente del sistema. Se preferisci Anaconda, consulta le istruzioni di installazione fornite qui e poi vai alla sezione Installare l'API.
Installare Miniconda
Il download e l'installazione di Miniconda vengono eseguiti in tre passaggi:
- Scarica il programma di installazione di Miniconda Python 3 a 64 bit nella tua directory home
- Esegui il programma di installazione
- Elimina il programma di installazione
Completa questi passaggi copiando e incollando le seguenti righe nell'interfaccia a riga di comando appropriata per il tuo sistema. L'installazione comporta l'aggiunta di una cartella denominata "miniconda3" alla tua directory home.
1. Scarica il programma di installazione di Miniconda nella tua directory home.
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. Installa Miniconda in modalità silenziosa, accettando le impostazioni predefinite, nella tua directory home.
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. Rimuovi il programma di installazione di Miniconda dalla tua directory home.
Linux
rm ~/miniconda.sh
Mac
rm ~/miniconda.sh
Windows
del %UserProfile%\miniconda.exe
Testare l'installazione di Miniconda
Stampa il menu di guida del comando conda per testare l'installazione di Miniconda.
Poiché Miniconda non è stato aggiunto alla variabile di ambiente PATH del sistema, dovrai prima attivare conda per questa sessione chiamando il comando activate con il relativo percorso di sistema completo. Se il test ha esito positivo, i contenuti della guida di conda verranno visualizzati nel terminale. Esegui le seguenti righe nell'interfaccia a riga di comando del sistema.
Linux
source $HOME/miniconda3/bin/activate conda --help
Mac
source $HOME/miniconda3/bin/activate conda --help
Windows
%UserProfile%\miniconda3\condabin\activate conda --help
Aggiungere Miniconda alla variabile PATH
Facoltativamente, puoi aggiungere il percorso di installazione di Miniconda alla variabile PATH del sistema, il che ti consentirà di interagire con conda con una semplice chiamata a conda senza dover prima eseguire il comando activate con il relativo percorso completo. Le seguenti istruzioni illustrano come aggiungere l'installazione di Miniconda alla variabile PATH del sistema.
Linux
Aggiungi il seguente percorso alla variabile di ambiente "PATH" completando le istruzioni della GUI o della riga di comando riportate di seguito.
$HOME/miniconda3/bin
GUI
1. Apri il file .bashrc che si trova nella directory $HOME in un editor di testo.
xdg-open ~/.bashrc
2. Copia e incolla le seguenti righe nella parte inferiore del file.
# add path to conda export PATH="$HOME/miniconda3/bin:$PATH"
3. Salva il file e chiudi l'editor di testo.
Riga di comando
Inserisci il seguente comando in un terminale per aggiungere il percorso conda al file ~/.bashrc.
printf '\n# add path to conda\nexport PATH="$HOME/miniconda3/bin:$PATH"\n' >> ~/.bashrc
Mac
Aggiungi il seguente percorso alla variabile di ambiente "PATH" completando le istruzioni della GUI o della riga di comando riportate di seguito.
$HOME/miniconda3/bin
GUI
1. Apri il file .bashrc che si trova nella directory $HOME in un editor di testo.
touch ~/.bashrc; open -t ~/.bashrc
2. Copia e incolla le seguenti righe nella parte inferiore del file.
# add path to conda export PATH="$HOME/miniconda3/bin:$PATH"
3. Salva il file e chiudi l'editor di testo.
Riga di comando
Inserisci il seguente comando in un terminale per aggiungere il percorso conda al file ~/.bashrc.
printf '\n# add path to conda\nexport PATH="$HOME/miniconda3/bin:$PATH"\n' >> ~/.bashrc
Windows
Aggiungi il seguente percorso alla variabile di ambiente "Path" completando le istruzioni della GUI o della riga di comando riportate di seguito.
%UserProfile%\miniconda3\condabin
GUI
1. Inserisci la seguente riga in un prompt dei comandi per aprire la finestra di dialogo "Variabile di ambiente".
rundll32 sysdm.cpl,EditEnvironmentVariables
2. Fai doppio clic sulla variabile "Path" nella sezione "Utente" per selezionarla per la modifica.
3. Fai clic sul pulsante "Modifica testo" nella nuova finestra di dialogo "Modifica" per aprire l'editor.
4. Aggiungi la seguente stringa alla fine del valore della variabile "Path" esistente. Assicurati che la voce sia racchiusa tra punti e virgola (;) per distinguerla dalle voci adiacenti.
%UserProfile%\miniconda3\condabin;
5. Fai clic sui pulsanti "Ok" finché non vengono chiuse tutte le finestre di dialogo.
Riga di comando
Utilizza il comando setx per aggiungere il percorso. Da un prompt dei comandi, inserisci:
setx Path "%Path%%UserProfile%\miniconda3\condabin;"
Inizializzare conda
Inizializza conda per l'interazione con la shell. Esegui il comando seguente per informazioni sull'inizializzazione per varie shell. Segui le istruzioni successive stampate nella console dopo aver inserito il comando.
conda init --help
Dopo aver riavviato l'interfaccia a riga di comando, dovresti essere in grado di attivare l'ambiente conda di base con il seguente comando.
conda activate
Installare l'API
L'API Python di Earth Engine viene distribuita come pacchetto conda-forge all'indirizzo:
https://anaconda.org/conda-forge/earthengine-api.
Viene installata con il comando conda install. Prima dell'installazione, crea un ambiente conda specifico per Earth Engine.
L'installazione dell'API Earth Engine nel proprio ambiente garantisce che l'API e i relativi pacchetti dipendenti non causino problemi di controllo delle versioni con l'ambiente di base o con qualsiasi altro ambiente configurato in precedenza e viceversa. Per ulteriori informazioni sulla gestione degli ambienti conda, ti preghiamo di
visitare questo sito.
1. Attiva l'ambiente conda di base, se non è già attivo.
Linux
source $HOME/miniconda3/bin/activate
Mac
source $HOME/miniconda3/bin/activate
Windows
%UserProfile%\miniconda3\condabin\activate
2. Crea un ambiente virtuale conda per l'API Earth Engine.
conda create --name ee
Ti verrà chiesto di confermare la creazione dell'ambiente, quindi fallo.
3. Attiva l'ambiente conda ee.
conda activate ee
4. Installa l'API nell'ambiente conda ee. Assicurati che (ee) venga visualizzato all'inizio della riga di comando, a indicare che stai lavorando dall'ambiente ee.
conda install -c conda-forge earthengine-api
Ti verrà chiesto di confermare l'installazione dell'API e delle relative dipendenze. Dopo la conferma, conda scaricherà e installerà le dipendenze. Se tutto va bene, ora avrai un ambiente conda
denominato "ee" con tutti i requisiti per accedere all'API, nonché
lo earthengine strumento a riga di comando.
Recuperare le credenziali
Prima di utilizzare l'API Earth Engine o lo strumento a riga di comando earthengine, devi eseguire un'autenticazione una tantum che autorizza l'accesso a Earth Engine per conto del tuo Account Google. Per eseguire l'autenticazione, utilizza il comando authenticate dello strumento a riga di comando earthengine.
Nell'ambiente conda ee esegui il seguente comando e segui le istruzioni stampate risultanti. Verrà fornito un URL che genera un codice di autorizzazione dopo l'accettazione. Copia il codice di autorizzazione e inseriscilo come input della riga di comando.
earthengine authenticate
Dopo aver inserito il codice di autorizzazione, un token di autorizzazione viene salvato in un file di credenziali che puoi trovare di seguito. L'utilizzo successivo del comando ee.Initialize() dell'API e dello strumento a riga di comando earthengine cercherà questo file per l'autenticazione. Se vuoi revocare l'autorizzazione, elimina il file delle credenziali.
Linux
ls $HOME/.config/earthengine/credentials
Mac
ls $HOME/.config/earthengine/credentials
Windows
dir %UserProfile%\.config\earthengine\credentials
Testare l'API
Esegui un semplice script Python che stampa i metadati per un set di dati DEM per testare l'installazione dell'API. Dovrebbe stampare un oggetto JSON nella console.
1. Avvia un interprete python dall'ambiente conda ee.
python
2. Esegui le seguenti righe Python una alla volta per stampare i metadati di un set di dati DEM
import ee # Initialize the Earth Engine module. ee.Initialize() # Print metadata for a DEM dataset. print(ee.Image('USGS/SRTMGL1_003').getInfo())
Utilizzo successivo dell'API
Ogni volta che vuoi utilizzare l'API Earth Engine, devi prima attivare l'ambiente conda ee. La procedura di attivazione dipende dal fatto che conda sia registrato per l'utilizzo nella shell o meno. Segui le istruzioni pertinenti all'installazione di conda riportate di seguito.
Conda non registrato
Il seguente comando di attivazione dell'ambiente conda ee presuppone che conda sia stato installato seguendo le istruzioni riportate nella sezione Installare conda sopra, ovvero il percorso di installazione viene presupposto in base ai passaggi precedenti. Esegui il seguente comando in un'interfaccia a riga di comando.
Linux
source $HOME/miniconda3/bin/activate ee
Mac
source $HOME/miniconda3/bin/activate ee
Windows
%UserProfile%\miniconda3\condabin\activate ee
Conda registrato
Il seguente comando di attivazione dell'ambiente conda ee presuppone che conda sia stato registrato per l'utilizzo nella shell o nel prompt dei comandi seguendo le istruzioni riportate in questa guida o con altri mezzi. Esegui il seguente comando in un'interfaccia a riga di comando.
conda activate ee
Dopo aver eseguito il comando, dovresti vedere (ee) all'inizio della riga di comando, a indicare che stai lavorando dall'ambiente ee.
Ora puoi avviare un interprete Python e accedere all'API Python di Earth Engine. Per indicazioni generali sull'utilizzo dell'API Python, consulta la pagina Installazione di Python.
Aggiornare l'API
Utilizza il comando conda update per aggiornare l'ambiente ee all'ultima versione dell'API. Ricorda di attivare prima l'ambiente conda ee, se non è già attivo.
conda update -c conda-forge earthengine-api
Recupera il numero di versione attualmente installata in Python stampando la proprietà __version__ della libreria ee. Avvia un interprete Python inserendo python nella riga di comando dell'ambiente conda ee e poi inserisci i seguenti comandi.
import ee print(ee.__version__)
Condividere l'ambiente ee
Può essere utile condividere l'ambiente Python conda con altri utenti per ottenere risultati riproducibili e replicabili, soprattutto se hai installato pacchetti Python aggiuntivi. Conda offre un modo pratico per consentire ad altri utenti di replicare il tuo ambiente.
Dall'ambiente conda ee, esegui il seguente comando per salvare un file YAML denominato "ee-shared-env" nella tua directory home, che elenca le specifiche dell'ambiente.
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
Condividi il file risultante e il destinatario può replicare l'ambiente eseguendo il seguente comando conda.
conda env create -f path-to-ee-shared-env.yml