Penginstalan Python - Penginstalan Conda

Earth Engine Python API dapat diinstal ke komputer lokal melalui conda, pengelola paket dan lingkungan Python. Conda dibundel dengan distribusi Python Anaconda dan Miniconda. Anaconda adalah platform pemrograman sains data yang mencakup lebih dari 1.500 paket, sedangkan Miniconda hanya mencakup conda dan dependensinya. Salah satu distribusi Python ini cocok untuk menginstal dan menggunakan Earth Engine API. Jika Anda belum memahami distribusi ini, buka linknya untuk mempelajari lebih lanjut.

Panduan ini akan mengarahkan Anda melalui:

• Memeriksa penginstalan conda yang ada
• Menginstal conda di komputer lokal
• Menginstal Earth Engine Python API
• Menyiapkan kredensial autentikasi
• Menguji API

Catatan: Langkah-langkah berikut akan diselesaikan di command prompt Windows atau terminal Unix (Linux/Mac). Gunakan tab di bagian atas setiap bagian kode untuk beralih ke perintah yang relevan dengan sistem operasi Anda.

Periksa penginstalan conda

Jika conda sudah diinstal di sistem Anda, lanjutkan ke bagian Instal API. Jika Anda tidak yakin apakah conda sudah diinstal, verifikasi dengan memasukkan perintah berikut di antarmuka command line Anda.

conda --help

Jika conda telah diinstal dan jalur sistemnya terdaftar dalam variabel lingkungan PATH, konten bantuan conda akan muncul di terminal. Jika konten bantuan muncul, lanjutkan ke bagian Instal API. Jika conda tidak dikenali, hasilnya akan terlihat seperti: conda not found or not recognized as a command. Kemungkinan program ada di sistem Anda, tetapi tidak terdaftar dalam variabel lingkungan PATH. Meskipun demikian, untuk konsistensi, lanjutkan dengan bagian Instal conda, karena sulit untuk mengatasi semua kemungkinan konfigurasi sistem. Selama folder 'miniconda3' tidak ada di folder Home Anda, petunjuk penginstalan conda berikut akan berhasil. Untuk mengetahui informasi selengkapnya tentang lokasi penginstalan dan pendaftaran conda, lihat halaman Penginstalan Miniconda dan Penginstalan Anaconda.

Instal conda

Catatan: Lanjutkan ke bagian Install API jika conda sudah diinstal di sistem Anda.

Di bagian ini, Anda akan mendownload dan menginstal Miniconda, yang akan berfungsi sebagai platform Python untuk mengakses Earth Engine API. Seperti yang dijelaskan di atas, Anda dapat menggunakan Miniconda atau Anaconda, tetapi untuk meminimalkan dampak pada sistem Anda, panduan ini akan menjelaskan penginstalan Miniconda tanpa mengubah variabel lingkungan sistem Anda. Jika Anda lebih memilih Anaconda, lihat petunjuk penginstalan yang diberikan di sini, lalu lanjutkan ke bagian Menginstal API.

Instal Miniconda

Mendownload dan menginstal Miniconda dilakukan dalam tiga langkah:

1. Download penginstal Miniconda Python 3 64-bit ke direktori Home Anda
2. Jalankan penginstal
3. Menghapus penginstal

Selesaikan langkah-langkah ini dengan menyalin dan menempelkan baris berikut ke antarmuka command line yang sesuai untuk sistem Anda. Penginstalan akan menghasilkan folder bernama 'miniconda3' yang ditambahkan ke direktori Beranda Anda.

1. Download penginstal Miniconda ke direktori Home Anda.

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. Instal Miniconda secara diam-diam, dengan menerima setelan default, ke direktori Beranda Anda.

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. Hapus penginstal Miniconda dari direktori Beranda Anda.

Linux

rm ~/miniconda.sh

Mac

rm ~/miniconda.sh

Windows

del %UserProfile%\miniconda.exe

Menguji penginstalan Miniconda

Cetak menu bantuan perintah conda untuk menguji penginstalan Miniconda. Karena Miniconda belum ditambahkan ke variabel lingkungan PATH sistem Anda, Anda harus mengaktifkan conda terlebih dahulu untuk sesi ini dengan memanggil perintah activate berdasarkan jalur sistem lengkapnya. Pengujian yang berhasil akan menampilkan konten bantuan conda di terminal. Jalankan baris berikut di antarmuka command line sistem Anda.

Linux

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

Mac

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

Windows

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

Catatan: Lingkungan conda yang diaktifkan dapat dinonaktifkan dengan menjalankan: conda deactivate.

Catatan: Jika jalur ke Miniconda tidak ditetapkan sebagai variabel lingkungan, seperti dalam kasus penginstalan ini, Anda perlu mengaktifkan Miniconda untuk setiap sesi command line baru di masa mendatang, termasuk penggunaan API. Gunakan perintah pertama dari cuplikan kode di atas untuk mengaktifkan Miniconda sesuai kebutuhan.

Tambahkan Miniconda ke variabel PATH

Perhatian: Mengubah variabel PATH sistem dapat menimbulkan konsekuensi yang tidak diinginkan.

Anda dapat menambahkan jalur penginstalan Miniconda ke variabel PATH sistem secara opsional, yang akan memungkinkan Anda berinteraksi dengan conda dengan panggilan sederhana ke conda tanpa harus menjalankan perintah activate terlebih dahulu berdasarkan jalur lengkapnya. Petunjuk berikut menjelaskan cara menambahkan penginstalan Miniconda ke variabel PATH sistem Anda.

Linux

Tambahkan jalur berikut ke variabel lingkungan 'PATH' dengan menyelesaikan petunjuk GUI atau command line di bawah.

$HOME/miniconda3/bin

GUI

1. Buka file .bashrc yang ada di direktori $HOME di editor teks.

xdg-open ~/.bashrc

2. Salin dan tempel baris berikut ke bagian bawah file.

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

3. Simpan file dan tutup editor teks.

Catatan: Jalur conda yang ditambahkan dapat dihapus dengan menghapus baris yang baru saja ditambahkan.

Command line

Masukkan perintah berikut di terminal untuk menambahkan jalur conda ke file ~/.bashrc.

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

Mac

Tambahkan jalur berikut ke variabel lingkungan 'PATH' dengan menyelesaikan petunjuk GUI atau command line di bawah.

$HOME/miniconda3/bin

GUI

1. Buka file .bashrc yang ada di direktori $HOME di editor teks.

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

2. Salin dan tempel baris berikut ke bagian bawah file.

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

3. Simpan file dan tutup editor teks.

Catatan: Jalur conda yang ditambahkan dapat dihapus dengan menghapus baris yang baru saja ditambahkan.

Command line

Masukkan perintah berikut di terminal untuk menambahkan jalur conda ke file ~/.bashrc.

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

Windows

Tambahkan jalur berikut ke variabel lingkungan 'Path' dengan menyelesaikan petunjuk GUI atau command line di bawah.

%UserProfile%\miniconda3\condabin

GUI

1. Masukkan baris berikut di command prompt untuk membuka dialog 'Environmental Variable'.

rundll32 sysdm.cpl,EditEnvironmentVariables

2. Klik dua kali variabel 'Path' di bagian 'User' untuk memilihnya guna diedit.

3. Klik tombol 'Edit teks' di jendela dialog 'Edit' baru untuk membuka editor.

4. Tambahkan string berikut ke akhir nilai variabel 'Path' yang ada. Pastikan titik koma (;) mengapit entri untuk membedakannya dari entri di sekitarnya.

%UserProfile%\miniconda3\condabin;

5. Klik tombol 'Oke' hingga semua jendela dialog ditutup.

Catatan: Jalur conda yang ditambahkan dapat dihapus dengan mengikuti metode pengeditan yang sama.

Command line

Gunakan perintah setx untuk menambahkan jalur. Dari command prompt, masukkan:

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

Catatan: Mulai ulang antarmuka command line yang terbuka agar perubahan variabel lingkungan diterapkan.

Lakukan inisialisasi conda

Lakukan inisialisasi conda untuk interaksi shell. Jalankan perintah berikutnya untuk mendapatkan informasi tentang inisialisasi untuk berbagai shell. Ikuti petunjuk berikutnya yang dicetak ke konsol setelah memasukkan perintah.

conda init --help

Setelah memulai ulang antarmuka command line, Anda akan dapat mengaktifkan lingkungan conda dasar dengan perintah berikut.

conda activate

Menginstal API

Earth Engine Python API didistribusikan sebagai paket conda-forge di: https://anaconda.org/conda-forge/earthengine-api. Aplikasi ini diinstal dengan perintah conda install. Namun, sebelum menginstal, buat lingkungan conda khusus untuk Earth Engine. Menginstal Earth Engine API ke lingkungannya sendiri memastikan bahwa API tersebut dan paket dependennya tidak akan menyebabkan masalah pembuatan versi dengan lingkungan dasar Anda atau lingkungan lain yang telah Anda siapkan sebelumnya dan sebaliknya. Untuk mengetahui informasi selengkapnya tentang cara mengelola lingkungan conda, buka situs ini.

Catatan: Langkah pertama berikut mengasumsikan Anda baru saja menyelesaikan bagian Menginstal conda tanpa mengubah variabel lingkungan atau menginisialisasi conda untuk penggunaan shell; perintahnya disusun dengan tepat. Jika Anda telah menginstal conda sebelumnya dengan cara lain atau telah mendaftarkan conda untuk digunakan di shell, lakukan apa yang diperlukan untuk mengaktifkan conda, lalu mulai ikuti petunjuk dengan langkah 2.

1. Aktifkan lingkungan conda dasar Anda, jika belum.

Linux

source $HOME/miniconda3/bin/activate

Mac

source $HOME/miniconda3/bin/activate

Windows

%UserProfile%\miniconda3\condabin\activate

2. Buat lingkungan virtual conda untuk Earth Engine API.

conda create --name ee

Anda akan diminta untuk mengonfirmasi pembuatan lingkungan, lakukan.

3. Aktifkan lingkungan conda ee.

conda activate ee

4. Instal API ke lingkungan ee conda. Pastikan (ee) muncul di awal command line, yang menunjukkan bahwa Anda bekerja dari lingkungan ee.

conda install -c conda-forge earthengine-api

Anda akan diminta untuk mengonfirmasi penginstalan API dan dependensinya. Setelah mengonfirmasi, conda akan mendownload dan menginstal dependensi. Jika semuanya berjalan lancar, Anda akan memiliki lingkungan conda bernama 'ee' dengan semua persyaratan untuk mengakses API, serta alat command lineearthengine.

Dapatkan kredensial

Sebelum menggunakan Earth Engine API atau alat command line earthengine, Anda harus melakukan otentikasi satu kali yang memberikan otorisasi akses ke Earth Engine atas nama akun Google Anda. Untuk melakukan autentikasi, gunakan perintah authenticate dari alat command line earthengine.

Dalam lingkungan ee conda Anda, jalankan perintah berikut dan ikuti petunjuk yang dihasilkan. URL akan diberikan yang menghasilkan kode otorisasi setelah persetujuan. Salin kode otorisasi dan masukkan sebagai input command line.

earthengine authenticate

Setelah memasukkan kode otorisasi, token otorisasi akan disimpan ke file kredensial yang dapat ditemukan di bawah. Penggunaan perintah ee.Initialize() API dan alat command line earthengine berikutnya akan mencari file ini untuk mengautentikasi. Jika Anda ingin mencabut otorisasi, cukup hapus file kredensial.

Linux

ls $HOME/.config/earthengine/credentials

Mac

ls $HOME/.config/earthengine/credentials

Windows

dir %UserProfile%\.config\earthengine\credentials

Menguji API

Jalankan skrip Python sederhana yang mencetak metadata untuk set data DEM guna menguji penginstalan API. Objek JSON akan dicetak ke konsol.

1. Mulai penafsir python dari lingkungan ee conda Anda.

python

2. Jalankan baris Python berikut satu per satu untuk mencetak metadata set data DEM

import ee

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

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

Penggunaan API berikutnya

Setiap kali ingin menggunakan Earth Engine API, Anda harus mengaktifkan lingkungan ee conda terlebih dahulu. Prosedur aktivasi bergantung pada apakah conda terdaftar untuk digunakan di shell atau tidak. Ikuti petunjuk yang relevan dengan penginstalan conda Anda di bawah.

Conda tidak terdaftar

Perintah aktivasi lingkungan ee conda berikut mengasumsikan bahwa conda telah diinstal dengan mengikuti petunjuk di bagian Instal conda di atas, yaitu jalur penginstalan diasumsikan berdasarkan langkah-langkah sebelumnya. Jalankan perintah berikut di antarmuka command line.

Linux

source $HOME/miniconda3/bin/activate ee

Mac

source $HOME/miniconda3/bin/activate ee

Windows

%UserProfile%\miniconda3\condabin\activate ee

Conda terdaftar

Perintah aktivasi lingkungan ee conda berikut mengasumsikan bahwa conda telah didaftarkan untuk digunakan di shell atau command prompt dengan petunjuk dalam panduan ini atau dengan cara lain. Jalankan perintah berikut di antarmuka command line.

conda activate ee

Setelah menjalankan perintah, Anda akan melihat (ee) di awal command line, yang menunjukkan bahwa Anda bekerja dari lingkungan ee.

Sekarang Anda siap memulai penafsir Python dan mengakses Earth Engine Python API. Lihat halaman Penginstalan Python untuk mendapatkan panduan umum tentang cara menggunakan Python API.

Memperbarui API

Gunakan perintah conda update untuk mengupdate lingkungan ee ke versi API terbaru. Jangan lupa untuk mengaktifkan lingkungan ee conda Anda terlebih dahulu, jika belum aktif.

conda update -c conda-forge earthengine-api

Dapatkan nomor versi yang saat ini diinstal di Python dengan mencetak properti ee library __version__. Mulai interpreter Python dengan memasukkan python di command line lingkungan conda ee, lalu masukkan perintah berikut.

import ee
print(ee.__version__)

Membagikan lingkungan ee Anda

Anda dapat membagikan lingkungan Python conda kepada orang lain untuk mendapatkan hasil yang dapat direproduksi dan direplikasi, terutama jika Anda telah menginstal paket Python tambahan. Conda menyediakan cara mudah bagi orang lain untuk mereplikasi lingkungan Anda.

Dari lingkungan ee conda, jalankan perintah berikut untuk menyimpan file YAML bernama 'ee-shared-env' ke direktori Beranda Anda, yang mencantumkan spesifikasi lingkungan Anda.

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

Bagikan file yang dihasilkan, dan penerima dapat mereplikasi lingkungan dengan menjalankan perintah conda berikut.

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

Catatan: Baris pertama file ee-shared-env.yml menentukan nama lingkungan yang akan dibuat. Conda tidak akan menimpa lingkungan yang ada, sehingga nama lingkungan dalam file ee-shared-env.yml mungkin perlu diubah. Atau, gunakan perintah remove conda atau tanda --clone dari perintah create conda untuk mengelola nama lingkungan.

Catatan: Mereplikasi lingkungan di seluruh sistem operasi dapat gagal, karena ada build dan versi paket khusus OS yang mungkin tidak tersedia atau menyebabkan konflik dependensi.