Penginstalan Python - Penginstalan Conda

Earth Engine Python API dapat diinstal ke komputer lokal melalui conda, pengelola lingkungan dan paket Python. Conda dipaketkan dengan distribusi Python Anaconda dan Miniconda. Anaconda adalah platform pemrograman data science yang menyertakan lebih dari 1.500 paket, sedangkan Miniconda hanya menyertakan conda dan dependensinya. Salah satu distribusi Python ini cocok untuk menginstal dan menggunakan Earth Engine API. Jika Anda tidak memahami distribusi ini, buka link-nya untuk mempelajari lebih lanjut.

Panduan ini akan memandu 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.

Memeriksa penginstalan conda

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

conda --help

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

Menginstal conda

Catatan: Langsung ke bagian Instal 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, 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.

Menginstal Miniconda

Mendownload dan menginstal Miniconda dilakukan dalam tiga langkah:

1. Download penginstal Miniconda Python 3 64-bit ke direktori Home Anda
2. Menjalankan 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 otomatis, 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 harus mengaktifkan conda terlebih dahulu untuk sesi ini dengan memanggil perintah activate dengan jalur sistem lengkapnya. Pengujian yang berhasil akan menghasilkan konten bantuan conda yang muncul 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 harus 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.

Menambahkan Miniconda ke variabel PATH

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

Secara opsional, Anda dapat menambahkan jalur penginstalan Miniconda ke variabel PATH sistem, yang akan memungkinkan Anda berinteraksi dengan conda melalui panggilan sederhana ke conda tanpa harus menjalankan perintah activate terlebih dahulu dengan 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 ditemukan 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 ditemukan 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 untuk diedit.

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

4. Tambahkan string berikut ke akhir nilai variabel 'Path' yang ada. Pastikan titik koma (;) mengelilingi 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 terbuka agar perubahan variabel lingkungan dapat diterapkan.

Melakukan inisialisasi conda

Lakukan inisialisasi conda untuk interaksi shell. Jalankan perintah berikutnya untuk mengetahui 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 akan memastikan bahwa API tersebut dan paket dependennya tidak akan menyebabkan masalah pembuatan versi dengan lingkungan dasar atau lingkungan lain yang telah Anda siapkan sebelumnya dan sebaliknya. Untuk informasi selengkapnya tentang cara mengelola lingkungan conda, kunjungi situs ini.

Catatan: Langkah pertama berikut mengasumsikan bahwa Anda baru saja menyelesaikan bagian Instal conda tanpa mengubah variabel lingkungan atau melakukan inisialisasi conda untuk penggunaan shell; perintah disusun sesuai dengan hal tersebut. Jika sebelumnya Anda telah menginstal conda dengan cara lain atau telah mendaftarkan conda untuk digunakan di shell, lakukan hal 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 hal tersebut.

3. Aktifkan lingkungan ee conda.

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 kini akan memiliki lingkungan conda yang disebut 'ee' dengan semua persyaratan untuk mengakses API, serta alat command line earthengine.

Dapatkan kredensial

Sebelum menggunakan Earth Engine API atau alat command line earthengine, Anda harus melakukan autentikasi 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, jalankan perintah berikut dan ikuti petunjuk yang dicetak. URL akan diberikan yang menghasilkan kode otorisasi setelah perjanjian. 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 berikutnya dari perintah ee.Initialize() API dan alat command line earthengine akan mencari file ini untuk melakukan autentikasi. 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. Tindakan ini akan mencetak objek JSON ke konsol.

1. Mulai penafsir python dari lingkungan ee conda Anda.

python

2. Jalankan baris Python berikut satu per satu untuk mencetak metadata untuk 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 conda ee berikut mengasumsikan bahwa conda telah diinstal dengan mengikuti petunjuk di bagian Menginstal 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 conda ee berikut mengasumsikan bahwa conda telah terdaftar 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 untuk 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. Ingatlah untuk mengaktifkan lingkungan ee conda terlebih dahulu, jika belum aktif.

conda update -c conda-forge earthengine-api

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

import ee
print(ee.__version__)

Membagikan lingkungan ee

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

Dari lingkungan ee conda, jalankan perintah berikut untuk menyimpan file YAML yang disebut 'ee-shared-env' ke direktori Beranda, 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.