Installazione di Python - Installazione di Conda

L'API Python Earth Engine può essere installata su un computer locale tramite conda, un gestore di pacchetti e ambienti Python. Conda è in bundle con le distribuzioni Python Anaconda e Miniconda. Anaconda è una piattaforma di programmazione per la data science che include oltre 1500 pacchetti, mentre Miniconda include solo conda e le relative dipendenze. Entrambe queste distribuzioni Python sono adatte per installare e utilizzare l'API Earth Engine. Se non hai familiarità con queste distribuzioni, visita i relativi link per saperne di più.

Questa guida ti illustrerà:

• Verificare se è presente un'installazione conda esistente
• Installazione di conda su una macchina locale
• Installazione dell'API Python di Earth Engine
• Configurazione delle credenziali di autenticazione
• Test dell'API

Nota: i passaggi che seguono verranno completati in un prompt dei comandi Windows o in un terminale Unix (Linux/Mac). Utilizza le schede nella parte superiore di ogni sezione di codice per passare ai comandi pertinenti al tuo sistema operativo.

Controlla l'installazione di conda

Se conda è già installato nel tuo sistema, vai alla sezione Installa 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 Installa l'API. Se conda non viene riconosciuto, il risultato sarà simile al seguente: conda not found or not recognized as a command. È possibile che il programma esista sul sistema, ma non sia registrato nella variabile di ambiente PATH. Anche in questo caso, per coerenza, continua con la sezione Installa conda, poiché è difficile gestire tutte le possibili configurazioni di sistema. Se la directory "miniconda3" non esiste nella tua home directory, le seguenti istruzioni di installazione di conda dovrebbero riuscire. Per ulteriori informazioni sulla posizione di installazione e sulla registrazione di conda, consulta le pagine Installazione di Miniconda e Installazione di Anaconda.

Installa conda

Nota: vai alla sezione Installa l'API se conda è già installato sul tuo sistema.

In questa sezione scaricherai e installerai Miniconda, che fungerà da piattaforma Python per accedere all'API Earth Engine. Come описано выше, puoi utilizzare Miniconda o Anaconda, ma per minimizzare l'impatto sul sistema, questa guida descriverà un'installazione di Miniconda senza alterazioni alle variabili di ambiente del sistema. Se preferisci Anaconda, consulta le istruzioni di installazione riportate qui e poi vai alla sezione Installa l'API.

Installa Miniconda

Il download e l'installazione di Miniconda vengono eseguiti in tre passaggi:

1. Scarica il programma di installazione di Miniconda per Python 3 a 64 bit nella tua home directory
2. Esegui il programma di installazione
3. Eliminare 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 genera una cartella denominata "miniconda3" aggiunta alla home directory.

1. Scarica il programma di installazione di Miniconda nella home directory.

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 silenzio, accettando i valori predefiniti, nella home directory.

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 home directory.

Linux

rm ~/miniconda.sh

Mac

rm ~/miniconda.sh

Windows

del %UserProfile%\miniconda.exe

Verifica 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, devi prima attivare conda per questa sessione chiamando il comando activate con il percorso di sistema completo. Se il test è andato a buon fine, nel terminale verranno visualizzati i contenuti della guida di conda. 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

Nota: un ambiente conda attivato può essere disattivato eseguendo: conda deactivate.

Nota: se il percorso a Miniconda non è impostato come variabile di ambiente, come in questo caso di installazione, devi attivare Miniconda per ogni nuova sessione della riga di comando in futuro, incluso l'utilizzo dell'API. Utilizza il primo comando dello snippet di codice riportato sopra per attivare Miniconda in base alle tue esigenze.

Aggiungi Miniconda alla variabile PATH

Attenzione: la modifica della variabile PATH del sistema può avere conseguenze indesiderate.

Se vuoi, puoi aggiungere il percorso di installazione di Miniconda alla variabile PATH del sistema, in modo da interagire con conda tramite una semplice chiamata a conda senza dover prima eseguire il comando activate con il relativo percorso completo. Le istruzioni riportate di seguito illustrano la procedura per 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

interfaccia grafica

1. Apri il file .bashrc 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.

Nota: il percorso conda aggiunto può essere rimosso eliminando le righe appena aggiunte.

Riga di comando

Inserisci il seguente comando in un terminale per aggiungere il percorso di 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

interfaccia grafica

1. Apri il file .bashrc 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.

Nota: il percorso conda aggiunto può essere rimosso eliminando le righe appena aggiunte.

Riga di comando

Inserisci il seguente comando in un terminale per aggiungere il percorso di 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 "Percorso" completando le istruzioni della GUI o della riga di comando riportate di seguito.

%UserProfile%\miniconda3\condabin

interfaccia grafica

1. Inserisci la riga seguente in un prompt dei comandi per aprire la finestra di dialogo "Variabile di ambiente".

rundll32 sysdm.cpl,EditEnvironmentVariables

2. Fai doppio clic sulla variabile "Percorso" 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 "Percorso" 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.

Nota: il percorso conda aggiunto può essere rimosso seguendo lo stesso metodo di modifica.

Riga di comando

Utilizza il comando setx per aggiungere il percorso. Da un prompt dei comandi, inserisci:

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

Nota: per applicare le modifiche alle variabili di ambiente, riavvia le interfacce a riga di comando aperte.

Inizializza conda

Inizializza conda per l'interazione con la shell. Esegui il comando successivo 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

Installa l'API

L'API Python Earth Engine è distribuita come pacchetto conda-forge all'indirizzo: https://anaconda.org/conda-forge/earthengine-api. Viene installato con il comando conda install. Tuttavia, prima di installarlo, crea un ambiente conda specifico per Earth Engine. L'installazione dell'API Earth Engine nel proprio ambiente garantisce che essa e i relativi pacchetti dipendenti non causino problemi di gestione 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, visita questo sito.

Nota: il primo passaggio che segue presuppone che tu abbia appena completato la sezione Installa conda senza modificare le variabili di ambiente o inizializzare conda per l'utilizzo della shell. Il comando è strutturato di conseguenza. Se hai già installato conda con altri mezzi o lo hai registrato per l'utilizzo nella shell, fai ciò che è necessario per attivarlo, quindi inizia a seguire le istruzioni dal passaggio 2.

1. Attiva l'ambiente conda di base, se non l'hai ancora fatto.

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.

3. Attiva l'ambiente conda ee.

conda activate ee

4. Installa l'API nell'ambiente conda ee. Assicurati che (ee) appaia 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 sue dipendenze. Dopo la conferma, conda scaricherà e installerà le dipendenze. Se tutto va bene, ora avrai un ambiente conda chiamato "ee" con tutti i requisiti per accedere all'API, nonché lo strumento a riga di comando earthengine.

Recupera le credenziali

Prima di utilizzare l'API Earth Engine o lo strumento a riga di comando earthengine, devi eseguire un'autenticazione una tantum che autorizzi l'accesso a Earth Engine per conto del tuo Account Google. Per 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. Ti verrà fornito un URL che genera un codice di autorizzazione al momento del contratto. 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 delle credenziali che puoi trovare di seguito. L'utilizzo successivo del comando ee.Initialize() dell'API e dello strumento a riga di comando earthengine farà riferimento a questo file per l'autenticazione. Se vuoi revocare l'autorizzazione, elimina semplicemente il file delle credenziali.

Linux

ls $HOME/.config/earthengine/credentials

Mac

ls $HOME/.config/earthengine/credentials

Windows

dir %UserProfile%\.config\earthengine\credentials

Test dell'API

Esegui un semplice script Python che stampa i metadati di un set di dati DEM per testare l'installazione dell'API. Dovrebbe essere stampato un oggetto JSON nella console.

1. Avvia un interprete python dall'ambiente conda ee.

python

2. Esegui le seguenti righe di 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 o meno registrato per l'utilizzo nella shell. Segui le istruzioni riportate di seguito relative all'installazione di conda.

Conda non registrato

Il seguente comando di attivazione dell'ambiente conda ee presuppone che conda sia stato installato seguendo le istruzioni riportate nella sezione Installa conda precedente, ovvero che il percorso di installazione sia assunto in base ai passaggi precedenti. Esegui il seguente comando in un'interfaccia della 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 nella riga di comando 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 nell'ambiente ee.

Ora puoi avviare un interprete Python e accedere all'API Earth Engine per Python. Per indicazioni generali sull'utilizzo dell'API Python, consulta la pagina Installazione di Python.

Aggiornamento dell'API

Utilizza il comando conda update per aggiornare l'ambiente ee alla versione più recente dell'API. Ricordati di attivare prima l'ambiente conda ee, se non è già attivo.

conda update -c conda-forge earthengine-api

Per ottenere il numero della versione attualmente installata in Python, stampa la proprietà ee libreria __version__. Avvia un interprete Python inserendo python nella riga di comando dell'ambiente conda ee, quindi inserisci i seguenti comandi.

import ee
print(ee.__version__)

Condividere l'ambiente ee

Può essere utile condividere l'ambiente Python conda con altri per ottenere risultati riproducibili e replicabili, in particolare se hai installato pacchetti Python aggiuntivi. Conda offre un modo pratico per consentire ad altri di replicare il tuo ambiente.

Dall'ambiente conda ee, esegui il seguente comando per salvare un file YAML denominato "ee-shared-env" nella home directory, 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 potrà replicare l'ambiente eseguendo il seguente comando conda.

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

Nota: la prima riga del file ee-shared-env.yml definisce il nome dell'ambiente da creare. Conda non sovrascriverà un ambiente esistente, pertanto potrebbe essere necessario modificare il nome dell'ambiente nel file ee-shared-env.yml. In alternativa, utilizza il comando remove di conda o il flag --clone del comando create di conda per gestire i nomi degli ambienti.

Nota: la replica degli ambienti tra sistemi operativi potrebbe non riuscire, poiché esistono build e versioni dei pacchetti specifici per il sistema operativo che potrebbero non essere disponibili o creare conflitti di dipendenza.