earthengine aracı, Earth Engine öğelerini ve görevlerini komut satırından yönetmenize olanak tanıyan bir yardımcı programdır. Python API'sini yüklediğinizde otomatik olarak yüklenir. Aracın yüklü olup olmadığını ve düzgün çalışıp çalışmadığını kontrol etmek için komut satırına aşağıdakileri yazın:
earthengine
Araç düzgün bir şekilde yüklenmişse kullanılabilir komutların kısa bir özetini yazdırır. Belirli bir komutla ilgili yardım almak için:
earthengine command -h
Python API'yi ilk kez yüklediğinizde aşağıda açıklanan authenticate komutunu kullanarak oturum açmanız gerekir. Aşağıdaki bölümlerde, kullanılabilen komutlar daha ayrıntılı olarak açıklanmıştır.
Hizmet hesabı kimlik bilgileri
CLI'yi bir hizmet hesabının kimlik bilgileriyle kullanmak için service_account_file işaretçisini kullanarak hizmet hesabının anahtarını içeren bir JSON dosyasını işaretleyin.
earthengine --service_account_file=service_account_creds.json
Colab'de kullanım
Earth Engine Komut Satırı Aracı, Google Colab'a önceden yüklenmiş ve kullanıma hazırdır.
Kimlik doğrulama
Her yeni Colab oturumunda veya sanal makine etkinlik olmaması nedeniyle oturum süresi sona erdiğinde kimlik doğrulama (kimlik bilgileri oturumlar arasında kaydedilmez).
Python istemci kitaplığını içe aktarın ve kimlik doğrulama akışını tetiklemek için ee.Authenticate() işlevini çağırın. Kimlik doğrulama işlemini tamamlamak için talimatları uygulayın. Colab'da varsayılan auth_mode colab'dır. Diğer seçenekler için Kimlik doğrulama kılavuzuna göz atın.
import ee
ee.Authenticate()
Komut yürütme
Earth Engine CLI gibi komut satırı yardımcı programlarını çalıştırmak için komut çağrılarının başına ünlem işareti eklemeniz gerekir.
!earthengine -h
Cloud projesi ayarlama
Her bir earthengine komutu için bir Cloud projesi ayarlamak üzere --project seçeneğini kullanın.
!earthengine --project my-project <command>
Alternatif olarak, set_project komutunu kullanarak tüm earthengineçağrıları tarafından kullanılacak varsayılan bir proje ayarlayın. Proje, --project
!earthengine set_project my-project
Komut Referansı
kimlik doğrulamak
Komut satırı aracının ve Python istemci kitaplığının Earth Engine ile kimliğini doğrular. Örnek:
earthengine authenticate
Earth Engine, istemcilerin kimliğini doğrulamak için OAuth 2.0 protokolünü kullanır. earthengine authenticate komutu, web tarayıcınızı kullanarak kimlik doğrulama işlemini tamamlamanızı ister.
Varsayılan gcloud kimlik doğrulama modunu kullanıyorsanız gcloud'u yüklemeniz gerekir. Kimlik doğrulama kılavuzundaki auth_mode parametresi aracılığıyla kullanılabilen diğer kimlik doğrulama modlarına bakın.
acl
Bir Earth Engine öğesinin erişim kontrol listesini (EKL) yazdırır veya günceller. ACL, bir öğeyi kimlerin okuyabileceğini veya öğeye kimlerin yazabileceğini kontrol eder. Örnekler:
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
get alt komutu, ACL'nin JSON açıklamasını yazdırır. set
alt komutu, aynı JSON biçimindeki bir dosyada sağlanan bir ACL ayarlar. get'teki çıkışı kaydedip set'a sağlayarak bir ACL'yi bir öğeden diğerine kopyalayabilirsiniz.
set alt komutu, iki özel ACL adını da kabul eder:
private: Sahibi dışındaki tüm kullanıcıların izinlerini kaldırır.public: Tüm kullanıcılara okuma izni verir.
ch alt komutu, ACL'de tek tek değişiklik yapmanıza olanak tanır. Okuma izni vermek için -u username@gmail.com:R, yazma izni vermek için -u username@gmail.com:W ve kullanıcının izinlerini kaldırmak için -d
username@gmail.com değerini belirtin. Özel kullanıcı tanımlayıcısı AllUsers, tüm kullanıcılara okuma izni vermek veya tüm kullanıcılardan okuma iznini iptal etmek için kullanılabilir. (AllUsers izinlerinin iptal edilmesinin, ayrı ayrı kullanıcılara verdiğiniz ek izinleri iptal etmediğini unutmayın.)
öğe
Bir Earth Engine öğesiyle ilişkili meta verileri yazdırır veya günceller. Örnekler:
earthengine asset info projects/my-project/assets/asset_id
earthengine asset set -p name=value projects/my-project/assets/asset_id
info alt komutu, meta verileri de dahil olmak üzere öğeyle ilgili ayrıntılı bilgileri JSON biçiminde yazdırır. set alt komutu, bir öğedeki meta veri özelliklerini tek tek ayarlar.
Ayarladığınız meta veri özelliklerinin değerleri sayı veya dize olabilir.
--property veya -p işaretini kullanarak özellik adlarını ayarlarken özellik adını ve değerini eşittir işaretiyle ayırın. Veri türü otomatik olarak algılanır veya mülk adına (string), (number) veya (date) ön ekleyerek açıkça belirtebilirsiniz. Örneğin, aşağıdaki kod "42" değerine sahip bir dize değerli mülk ayarlar:
earthengine asset set -p '(string)name=42' projects/my-project/assets/asset_id
(Bu örnekteki tırnak işaretleri, kabuğun parantezleri yorumlamasını engeller. Kabuğunuza ve platformunuza bağlı olarak bunlar gerekli olabilir veya olmayabilir.)
Bir mülkü silmek için türünü belirtmeden null olarak ayarlayın:
earthengine asset set -p name=null projects/my-project/assets/asset_id
Tarih özellikleri, Unix başlangıç tarihinden (ör. 1 Ocak 1970 gece yarısı) itibaren geçen milisaniye sayısını temsil eden sayılardır ve doğrudan bir sayı olarak veya aşağıdaki biçimlerden birinde belirtilebilir:
YYYY-MM-DD
YYYY-MM-DDThh:mm:ss
YYYY-MM-DDThh:mm:ss.f
Saat diliminin UTC olduğu varsayılır. --time_start ve --time_end işaretlerini kullanarak özel başlangıç ve bitiş zamanı özelliklerini ayarlayabilirsiniz:
earthengine asset set --time_start 1978-10-15T12:34:56 projects/my-project/assets/asset_id
cp
Bir öğeyi kopyalar. Örnek:
earthengine cp projects/my-project/assets/asset_id projects/my-project/assets/new_asset_id
create
Yeni klasörler ve resim koleksiyonları oluşturur. Örnek:
earthengine create folder projects/my-project/assets/folder_id
earthengine create collection projects/my-project/assets/collection_id
Klasör oluşturmak için folder alt komutunu, resim koleksiyonu oluşturmak için collection komutunu kullanın. Gerekirse üst klasörleri yinelenen bir şekilde oluşturmak için -p seçeneğini belirtebilirsiniz. Yeni oluşturulan klasörler ve resimler varsayılan olarak özel ACL'lere sahiptir.
ls
Bir veya daha fazla klasörün ya da koleksiyonun içeriğini listeler. Örnek:
earthengine ls users/username
-l seçeneği, her öğe hakkında daha fazla bilgi (şu anda yalnızca türü) içeren uzun bir biçim ister. Listelediğiniz her klasör veya koleksiyondaki öğe sayısını sınırlamak için --max_items number (veya kısaca -m) belirtebilirsiniz:
earthengine ls -m 10 projects/my-project/assets/my_large_collection
ls komutunu hiçbir bağımsız değişken olmadan çalıştırdığınızda, sahip olduğunuz üst düzey klasörler listelenir.
model
TensorFlow'un kayıtlı modellerini değiştirmek için kullanılan araç.
model prepare
Kayıtlı bir modeli Earth Engine'da yayınlanmak üzere hazırlama Daha açık belirtmek gerekirse bu işlem, SavedModel öğenizi Earth Engine'dan gelen istekleri işlemeye uygun bir forma dönüştürür. (SavedModel hakkında daha fazla bilgi edinin.)
earthengine model prepare my_source_dir my_dest_dir '{"Conv2D:0":"my_input_band"}' '{"Sigmoid:0":"my_output_band"}'
AI Platform modelleri hakkında daha fazla bilgiyi burada bulabilirsiniz. Tam örneği burada bulabilirsiniz.
mv
Bir öğeyi taşır veya yeniden adlandırır. Örnek:
earthengine mv projects/my-project/assets/asset_id projects/my-project/assets/new_asset_id
project_config
Proje yapılandırma değerlerini ayarlar. Bu komutu kullanmadan önce set_project kullanarak bir proje oluşturduğunuzdan emin olun.
get
Proje yapılandırmasını görüntülemek için get alt komutunu kullanın:
earthengine alpha project_config get
Projenin toplu görev ayarlarını görüntüleme izniniz varsa çıkış şunları içerir:
maxConcurrentExports: Belirli bir proje için tüm kullanıcılar arasında paralel olarak çalıştırılabilecek maksimum toplu görev sayısını belirten bir sayı. Bu değer varsayılan olarak, ilişkili faturalandırma hesabının abonelik planı tarafından izin verilen maksimum değere ayarlanır.
Ayrıca, plan yapılandırmasını görüntüleme izniniz varsa çıkışta şunlar yer alır:
planMaxConcurrentExports: Faturalandırma hesabını kullanan tüm kullanıcılar ve projelerde paralel olarak çalıştırılabilecek maksimum toplu görev sayısını belirten bir sayı.
grup
Projenin yapılandırmasını güncellemek için set alt komutunu kullanın. Aşağıdaki ayarlar yapılandırılabilir:
max_concurrent_exports, projenin maksimum grup görevi paralelliğini kontrol etmek için- Doğru izinlerin verilmesi gerekir.
Örneğin, bir projeyi yalnızca 10 görevin paralel olarak çalışacağı şekilde yapılandırmak için:
earthengine alpha project_config set --max_concurrent_exports=10
Çıktı, get tarafından döndürülenle aynı olan güncellenmiş proje yapılandırmasını gösterir.
Toplu görev paralelliği hakkında daha fazla bilgi için Earth Engine kotaları sayfasına bakın.
rm
Bir veya daha fazla öğeyi siler. Örnek:
earthengine rm projects/my-project/assets/asset_id
earthengine rm -r projects/my-project/assets/folder_id
Bir klasörün veya koleksiyonun içeriğini yinelemeli olarak silmek için -r işaretini kullanabilirsiniz. Birden fazla öğeyi silerken güvenliği sağlamak için, hiçbir öğeyi silmeden tam olarak nelerin silineceğini doğrulamak üzere --dry_run işaretini kullanabilirsiniz.
set_project
Hesaplama isteklerinin yönlendirildiği Google Cloud projesini belirler.
earthengine set_project foo-project
Bu komut, Cloud işlevselliği gerektiren komutları (ör. model) çalıştırmadan önce gereklidir.
görev
Uzun süren görevlerle ilgili bilgileri yazdırır veya bu görevleri yönetir. Örnekler:
earthengine task list
earthengine task list -l
earthengine task info TASK_ID
earthengine task cancel TASK_ID
list alt komutu, yakın zamanda gönderdiğiniz görevlerle ilgili temel bilgileri listeler. -l seçeneği, her görevle ilgili daha fazla bilgi içeren uzun bir biçim ister. info alt komutu, tek tek görevlerle ilgili ayrıntılı bilgileri yazdırır. cancel alt komutu, çalışan bir veya daha fazla görevi iptal eder.
yükle
Google Cloud Storage'daki resimleri veya tabloları Earth Engine'a yükler ya da harici resimlerle desteklenen öğeler oluşturur.
resim
Varsayılan ayarları kullanarak resim öğesi yüklemek için:
earthengine upload image --asset_id=projects/my-project/assets/asset_id gs://bucket/image.tif
Birden fazla giriş resim dosyası belirtirseniz bunlar tek bir resim öğesinin karoları olarak yorumlanır. Earth Engine'a resim yükleme seçenekleri hakkında daha fazla bilgiyi Resim öğeleri yükleme: Gelişmiş seçenekler başlıklı makalede bulabilirsiniz.
Piramit azaltma politikasını --pyramiding_policy işaretini kullanarak belirtebilirsiniz. Bu işaret mean (varsayılan), sample, mode, min veya max olarak ayarlanabilir. Bu, Earth Engine'ın resminizin düşük çözünürlüklü sürümlerinden oluşan piramidi nasıl oluşturacağını kontrol eder:
earthengine upload image --asset_id=projects/my-project/assets/asset_id --pyramiding_policy=sample gs://bucket/image.tif
Resmin maskesinin son banttaki bir alfa kanalından alınması gerektiğini belirtmek için --last_band_alpha simgesini kullanabilirsiniz:
earthengine upload image --asset_id=projects/my-project/assets/asset_id --last_band_alpha gs://bucket/image.tif
--nodata_value işaretini kullanarak veri yok değerini belirtebilirsiniz. Bu işlem, resimdeki tüm pikselleri bu değerle maskeler:
earthengine upload image --asset_id=users/myuser/asset --nodata_value=255 gs://bucket/image.tif
Yukarıda açıklanan asset set komutu tarafından kabul edilen aynı işaretleri kullanarak öğede ayarlanacak meta veri özelliklerini de belirtebilirsiniz.
Bu seçenekler Resim Manifesti kılavuzunda da açıklanmıştır.
masa
Google Cloud Storage'dan bir Shapefile, CSV veya TFRecord dosyasını Earth Engine tablo öğesine yüklemek için aşağıdakilerden birini kullanabilirsiniz:
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
CSV ve TFRecord dosyalarının yorumlanma şekliyle ilgili birçok seçenek vardır. Tablo yükleme seçeneklerinin tam listesini görmek için Tablo Manifesti kılavuzunu ziyaret edebilir veya aşağıdakileri kullanabilirsiniz:
earthengine upload table -h
external_image
Harici bir resimle desteklenen bir öğe oluşturmak için upload_image komutunu bir manifest ile çalıştırın:
earthengine alpha upload external_image --manifest /tmp/foo.json
Örnek bir manifest:
{
"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"
}
Manifest oluşturma hakkında daha fazla bilgi için Cloud GeoTIFF kılavuzuna ve Görüntü Manifesti kılavuzuna bakın.