Alat earthengine adalah program utilitas yang memungkinkan Anda mengelola aset dan tugas Earth Engine dari command line. Alat ini diinstal secara otomatis saat Anda
menginstal Python API. Untuk memeriksa apakah alat sudah diinstal dan berfungsi dengan benar, ketik perintah berikut di command line:
earthengine
Jika alat diinstal dengan benar, alat akan mencetak ringkasan singkat perintah yang tersedia. Untuk mendapatkan bantuan terkait perintah tertentu, gunakan:
earthengine command -h
Saat pertama kali menginstal Python API, Anda harus login menggunakan perintah authenticate yang dijelaskan di bawah. Bagian berikut menjelaskan perintah yang tersedia secara lebih mendetail.
Kredensial akun layanan
Untuk menggunakan CLI dengan kredensial akun layanan, gunakan flag service_account_file untuk mengarah ke file JSON yang berisi kunci akun layanan.
earthengine --service_account_file=service_account_creds.json
Penggunaan di Colab
Alat Command Line Earth Engine sudah diinstal dan siap digunakan di Google Colab.
Autentikasi
Lakukan autentikasi untuk setiap sesi Colab baru atau jika mesin virtual berakhir karena tidak ada aktivitas (kredensial tidak disimpan di seluruh sesi).
Impor library klien Python dan panggil ee.Authenticate() untuk memicu alur autentikasi. Ikuti petunjuk untuk menyelesaikan autentikasi. `auth_mode` default
auth_mode di Colab adalah colab. Lihat
panduan Autentikasi
untuk opsi lainnya.
import ee
ee.Authenticate()
Eksekusi perintah
Untuk menjalankan utilitas command line, seperti Earth Engine CLI, Anda harus menambahkan tanda seru di awal panggilan perintah.
!earthengine -h
Menetapkan project Cloud
Gunakan opsi --project untuk menetapkan project Cloud untuk setiap perintah earthengine.
!earthengine --project my-project <command>
Atau, tetapkan project default yang akan digunakan oleh semua earthengine
panggilan menggunakan set_project perintah. Project akan ditambahkan
ke file kredensial (~/.config/earthengine/credentials) dan digunakan untuk
perintah berikutnya, kecuali jika diganti oleh opsi --project
!earthengine set_project my-project
Referensi Perintah
autentikasi
Mengautentikasi alat command line dan library klien Python ke Earth Engine. Contoh:
earthengine authenticate
Earth Engine menggunakan protokol OAuth 2.0 untuk mengautentikasi klien. Perintah autentikasi earthengine akan memandu Anda melalui proses autentikasi menggunakan browser web.
Anda harus menginstal gcloud jika
menggunakan mode autentikasi gcloud default. Lihat mode autentikasi lainnya
yang tersedia melalui parameter auth_mode dalam panduan autentikasi.
acl
Mencetak atau memperbarui daftar kontrol akses (ACL) aset Earth Engine. ACL mengontrol siapa yang dapat membaca atau menulis ke aset. Contoh:
earthengine acl get projects/my-project/assets/asset_id
earthengine acl set public projects/my-project/assets/asset_id
earthengine acl ch -u username@gmail.com:R projects/my-project/assets/asset_id
Sub-perintah get mencetak deskripsi JSON ACL. Sub-perintah set menetapkan ACL yang disediakan dalam file dengan format JSON yang sama. Anda dapat menyalin ACL dari satu aset ke aset lainnya dengan menyimpan output dari get dan memberikannya ke set.
Sub-perintah set juga menerima dua nama ACL khusus:
private: Menghapus izin dari semua orang kecuali pemilik.public: Memberikan izin baca kepada semua pengguna.
Sub-perintah ch memungkinkan Anda melakukan perubahan individual pada ACL. Untuk memberikan izin baca
tentukan -u username@gmail.com:R, untuk memberikan izin tulis tentukan
-u username@gmail.com:W, dan untuk menghapus izin pengguna tentukan -d
username@gmail.com. ID pengguna khusus AllUsers dapat digunakan untuk memberikan atau mencabut izin baca kepada atau dari semua pengguna. (Perhatikan bahwa mencabut izin AllUsers tidak mencabut izin tambahan yang mungkin juga telah Anda berikan kepada pengguna tertentu.)
aset
Mencetak atau memperbarui metadata yang terkait dengan aset Earth Engine. Contoh:
earthengine asset info projects/my-project/assets/asset_id
earthengine asset set -p name=value projects/my-project/assets/asset_id
earthengine asset setbands projects/my-project/assets/asset_id band1 band2
Sub-perintah info mencetak informasi mendetail tentang aset, termasuk metadatanya, dalam bentuk JSON. Sub-perintah set menetapkan properti metadata individual pada aset. Sub-perintah setbands memperbarui nama band aset.
Nilai properti metadata yang Anda tetapkan dapat berupa angka atau string.
Saat menetapkan nama properti menggunakan flag --property atau -p, pisahkan
nama dan nilai properti dengan tanda sama dengan. Jenis data terdeteksi secara otomatis, atau Anda dapat menentukannya secara eksplisit dengan menambahkan awalan nama properti dengan (string), (number), atau (date). Misalnya, perintah ini menetapkan properti bernilai string
dengan nilai "42":
earthengine asset set -p '(string)name=42' projects/my-project/assets/asset_id
(Tanda kutip dalam contoh ini mencegah shell menafsirkan tanda kurung. Tanda kutip mungkin atau mungkin tidak diperlukan, bergantung pada shell dan platform Anda.)
Untuk membuat properti khusus untuk visualisasi band klasifikasi, Anda dapat menyimpan daftar nilai dan warna sebagai string yang dipisahkan koma. Misalnya, untuk menetapkan nilai palet dan class untuk band bernama landcover:
earthengine asset set -p 'landcover_class_palette=ff0000,00ff00,0000ff' projects/my-project/assets/asset_id
earthengine asset set -p 'landcover_class_values=1,2,3' projects/my-project/assets/asset_id
Untuk menghapus properti, tetapkan ke null tanpa jenis:
earthengine asset set -p name=null projects/my-project/assets/asset_id
Properti tanggal hanyalah angka yang mewakili jumlah milidetik sejak epoch Unix (yaitu tengah malam pada 1 Januari 1970) dan dapat ditentukan langsung sebagai angka atau dalam salah satu format berikut:
YYYY-MM-DD
YYYY-MM-DDThh:mm:ss
YYYY-MM-DDThh:mm:ss.f
Zona waktu diasumsikan sebagai UTC. Anda dapat menetapkan properti waktu mulai dan waktu berakhir khusus menggunakan flag --time_start dan --time_end:
earthengine asset set --time_start 1978-10-15T12:34:56 projects/my-project/assets/asset_id
cp
Menyalin aset. Contoh:
earthengine cp projects/my-project/assets/asset_id projects/my-project/assets/new_asset_id
create
Membuat folder dan koleksi gambar baru. Contoh:
earthengine create folder projects/my-project/assets/folder_id
earthengine create collection projects/my-project/assets/collection_id
Gunakan sub-perintah folder untuk membuat folder dan collection untuk membuat koleksi gambar. Anda dapat menentukan opsi -p untuk membuat folder induk secara rekursif sesuai kebutuhan. Folder dan gambar yang baru dibuat memiliki ACL pribadi secara default.
ls
Mencantumkan konten satu atau beberapa folder atau koleksi. Contoh:
earthengine ls users/username
Opsi -l meminta format panjang dengan informasi selengkapnya tentang setiap aset (saat ini hanya jenisnya). Anda dapat menentukan --max_items number (atau -m untuk
singkatnya) untuk membatasi jumlah item dari setiap folder atau koleksi yang Anda cantumkan:
earthengine ls -m 10 projects/my-project/assets/my_large_collection
Menjalankan perintah ls tanpa argumen akan mencantumkan folder tingkat atas yang Anda miliki.
model
Alat untuk memanipulasi model tersimpan TensorFlow.
model prepare
Menyiapkan model tersimpan untuk ditayangkan di Earth Engine. Secara khusus, perintah ini mengubah SavedModel Anda menjadi bentuk yang sesuai untuk memproses permintaan dari Earth Engine. (Pelajari lebih lanjut tentang
SavedModel.)
earthengine model prepare my_source_dir my_dest_dir '{"Conv2D:0":"my_input_band"}' '{"Sigmoid:0":"my_output_band"}'
Pelajari model AI Platform lebih lanjut di sini. Lihat contoh lengkapnya di sini.
mv
Memindahkan atau mengganti nama aset. Contoh:
earthengine mv projects/my-project/assets/asset_id projects/my-project/assets/new_asset_id
project_config
Menetapkan nilai konfigurasi project. Sebelum menggunakan perintah ini, pastikan untuk menetapkan a
project menggunakan set_project.
get
Untuk melihat konfigurasi project, gunakan sub-perintah get:
earthengine alpha project_config get
Jika Anda memiliki izin untuk melihat setelan tugas batch project, output akan berisi:
maxConcurrentExports: angka yang menunjukkan jumlah maksimum tugas batch yang dapat dijalankan secara paralel di semua pengguna untuk project tertentu. Secara default, nilai ini ditetapkan ke nilai maksimum yang diizinkan oleh paket langganan akun penagihan terkait.
Selain itu, jika Anda memiliki izin untuk melihat konfigurasi paket, output akan berisi:
planMaxConcurrentExports, angka yang menunjukkan jumlah maksimum tugas batch yang dapat dijalankan secara paralel di semua pengguna dan project yang menggunakan akun penagihan.
set
Untuk memperbarui konfigurasi project, gunakan sub-perintah set. Setelan berikut dapat dikonfigurasi:
max_concurrent_exports, untuk mengontrol paralelisme tugas batch maksimum- project
- memerlukan izin yang benar permissions
Misalnya, untuk mengonfigurasi project agar hanya mengizinkan 10 tugas berjalan secara paralel untuk project tertentu:
earthengine alpha project_config set --max_concurrent_exports=10
Output menampilkan konfigurasi project yang diperbarui, yang identik dengan yang ditampilkan
get.
Untuk mengetahui informasi selengkapnya tentang paralelisme tugas batch, lihat halaman kuota Earth Engine.
rm
Menghapus satu atau beberapa aset. Contoh:
earthengine rm projects/my-project/assets/asset_id
earthengine rm -r projects/my-project/assets/folder_id
Anda dapat menggunakan flag -r untuk menghapus konten folder atau koleksi secara rekursif. Untuk keamanan saat menghapus beberapa aset, Anda dapat menggunakan flag --dry_run untuk memverifikasi dengan tepat apa yang akan dihapus tanpa benar-benar menghapus apa pun.
set_project
Menetapkan project Google Cloud yang digunakan untuk merutekan permintaan komputasi.
earthengine set_project foo-project
Perintah ini diperlukan sebelum menjalankan perintah yang memerlukan fungsi Cloud
functionality, misalnya model.
tugas
Mencetak informasi tentang atau mengelola tugas yang berjalan lama. Contoh:
earthengine task list
earthengine task list -l
earthengine task info TASK_ID
earthengine task cancel TASK_ID
Sub-perintah list mencantumkan informasi dasar tentang tugas yang baru-baru ini Anda kirimkan. Opsi -l meminta format panjang dengan informasi selengkapnya tentang setiap tugas. Sub-perintah info mencetak informasi mendetail tentang tugas individual. Sub-perintah cancel membatalkan satu atau beberapa tugas yang sedang berjalan.
upload
Mengupload gambar atau tabel dari Google Cloud Storage ke Earth Engine, atau membuat aset yang didukung oleh gambar eksternal.
gambar
Untuk mengupload aset gambar menggunakan setelan default:
earthengine upload image --asset_id=projects/my-project/assets/asset_id gs://bucket/image.tif
Jika Anda menentukan beberapa file gambar input, file tersebut akan ditafsirkan sebagai petak dari satu aset gambar. Anda dapat mempelajari lebih lanjut opsi untuk mengupload gambar ke Earth Engine di Mengupload aset gambar: Opsi lanjutan.
Anda dapat menentukan kebijakan pengurangan piramida menggunakan flag --pyramiding_policy, yang dapat ditetapkan ke salah satu dari mean (default), sample, mode, min, atau max. Tindakan ini akan mengontrol cara Earth Engine membuat piramida versi gambar Anda yang beresolusi lebih rendah:
earthengine upload image --asset_id=projects/my-project/assets/asset_id --pyramiding_policy=sample gs://bucket/image.tif
Anda dapat menggunakan --last_band_alpha untuk menunjukkan bahwa mask untuk gambar harus diambil dari saluran alfa di band terakhir:
earthengine upload image --asset_id=projects/my-project/assets/asset_id --last_band_alpha gs://bucket/image.tif
Anda dapat menentukan nilai tanpa data menggunakan flag --nodata_value. Tindakan ini akan menutupi piksel apa pun dalam gambar dengan nilai tersebut:
earthengine upload image --asset_id=users/myuser/asset --nodata_value=255 gs://bucket/image.tif
Anda juga dapat menentukan properti metadata yang akan ditetapkan pada aset menggunakan
flag yang sama yang diterima oleh perintah asset set yang dijelaskan di atas.
Opsi ini juga dijelaskan dalam
panduan Manifes Gambar.
tabel
Untuk mengupload Shapefile, CSV, atau TFRecord dari Google Cloud Storage ke aset tabel Earth Engine, Anda dapat menggunakan salah satu dari:
earthengine upload table --asset_id=projects/my-project/assets/myUploadedShapefile gs://bucket/foo.shp
earthengine upload table --asset_id=projects/my-project/assets/myUploadedCSV gs://bucket/foo.csv
earthengine upload table --asset_id=projects/my-project/assets/myUploadedTFRecord gs://bucket/foo.tfrecord
Ada banyak opsi yang berkaitan dengan cara file CSV dan TFRecord ditafsirkan. Anda dapat melihat daftar lengkap opsi upload tabel dengan membuka panduan Manifes Tabel atau dengan:
earthengine upload table -h
external_image
Untuk membuat aset yang didukung oleh gambar eksternal, jalankan perintah upload_image dengan manifes:
earthengine upload external_image --manifest /tmp/foo.json
Contoh manifes adalah:
{
"name": "projects/{project}/assets/cogdemo1",
"tilesets": [
{ "id": "0", "sources": [{ "uris": ["gs://ee-docs-demos/COG_demo.tif"] }] }
],
"properties": {
"source": "https://code.earthengine.google.com/d541cf8b268b2f9d8f834c255698201d"
},
"startTime": "2016-01-01T00:00:00.000000000Z",
"endTime": "2016-12-31T15:01:23.000000000Z"
}
Lihat panduan Cloud GeoTIFF dan panduan Manifes Gambar untuk mengetahui detail selengkapnya tentang cara membuat manifes.