Bucket GCS gs://alphaearth_foundations_custom berisi set data contoh
Sematan Satelit Kustom yang terdiri dari file COG (Cloud Optimized GeoTIFF)
yang dihasilkan oleh AlphaEarth Foundations.
Lisensi
Kumpulan set data ini dilisensikan berdasarkan CC-BY 4.0 dan memerlukan teks atribusi berikut: "Embedding Satelit Kustom dari AlphaEarth Foundations diproduksi oleh Google dan Google DeepMind." Penggunaan set data publik ini tunduk pada Kebijakan Penggunaan yang Dapat Diterima Google Cloud.
Set data yang tersedia
Berikut adalah daftar set data dalam bucket ini. Set data ini berisi nama, deskripsi, dan kisaran area yang dicakup oleh set data. Perhatikan bahwa interval waktu di sini menggunakan waktu mulai inklusif dan waktu akhir eksklusif.
name: corcoran_city_2026_agricultural_change
area: Corcoran dan wilayah pertanian sekitarnya, California, AS
description: Embedding tanah gundul musim dingin (15 Des 2025 - 15 Feb 2026) dan puncak kehijauan musim semi (15 Mar - 15 Mei 2026) yang menangkap dinamika tanaman pertanian selama dua periode musiman.name: futaleufu_argentina_2026_fire_scar
area: Taman Nasional Los Alerces dan wilayah sekitarnya, Departemen Futaleufú, Provinsi Chubut, Argentina
description: Embedding pra-kebakaran (1-31 Des 2025) dan pasca-kebakaran (1-31 Mar 2026) yang menangkap luas bekas kebakaran hutan dan gangguan kanopi hutan akibat Kebakaran Hutan Los Alerces 2026.name: king_county_2025_monthly
area: King County, Washington, USA
description: Embedding bulan kalender untuk wilayah administratif King County selama enam bulan pertama tahun 2025, yang mencakup beragam infrastruktur kota urban dan lahan berhutan.name: meloland_california_2026_crop_cycles
area: Meloland dan lahan pertanian di sekitarnya, Imperial Valley, California, AS
description: Enam langkah waktu embedding bulanan berurutan (tanggal 15 hingga 15) (pertengahan November 2025 hingga pertengahan Mei 2026) yang melacak siklus rotasi multi-tanaman.name: pacific_palisades_2025_fire
area: Pacific Palisades dan perbukitan pesisir di sekitarnya, Los Angeles, California, AS
description: Embedding 31 hari sebelum kebakaran (7 Des 2024 - 7 Jan 2025) dan setelah kebakaran (7 Jan - 7 Feb 2025) yang menangkap dampak kebakaran hutan Palisades Fire dan perubahan tutupan lahan.name: theewaterskloof_dam_2026_water_change
area: Bendungan Theewaterskloof, Kotamadya Lokal Theewaterskloof, Afrika Selatan
description: Embedding musim kemarau (1-31 Jan 2026) dan pengisian ulang musim hujan (15 Apr - 15 Mei 2026) yang menangkap perubahan luas permukaan air waduk.
Struktur direktori
Semua set data contoh diatur di bawah awalan gs://alphaearth_foundations_custom/custom_satellite_embedding/v1/:
gs://alphaearth_foundations_custom/custom_satellite_embedding/v1/
└── {dataset_name}/
├── aef_index.parquet
├── manifest.txt
└── {start_date}_{end_date}/
└── {image_id}/
├── data.tiff
└── image_manifest.json
Setiap set data memiliki direktori sendiri yang berisi file indeks GeoParquet aef_index.parquet tingkat set data, file manifest.txt tingkat set data, dan satu atau beberapa subdirektori interval waktu.
Subdirektori interval waktu ini diberi nama menggunakan pola
{start_date}_{end_date}, dengan tanggal mulai bersifat inklusif dan tanggal akhir bersifat
eksklusif. Kedua tanggal diformat sebagai yyyyMMdd dan berada dalam zona waktu UTC.
Misalnya, subdirektori untuk bulan Juni 2025 akan diberi nama
20250601_20250701, yang sesuai dengan interval waktu dari
2025-06-01T00:00:00Z (inklusif) hingga 2025-07-01T00:00:00Z (eksklusif).
Setiap direktori interval waktu berisi subdirektori untuk setiap embedding gambar
dalam interval waktu tersebut, yang diberi nama dengan ID gambar ({image_id}) yang
secara unik mengidentifikasi gambar dalam set data. Setiap subdirektori {image_id}
berisi file COG data.tiff dari data piksel dan file image_manifest.json
sidecar yang digunakan untuk mendaftarkan data di Earth Engine.
Struktur file
Struktur internal setiap file COG—termasuk dimensi piksel 8192x8192, 64 saluran (A00 hingga A63), piramida ringkasan yang dinormalisasi, kuantisasi bilangan bulat 8-bit bertanda, dan nilai mask -128 NoData—identik dengan COG Embedding Satelit tahunan. Tidak seperti COG tahunan, piksel yang valid di
setiap ubin sampel biasanya hanya mencakup subset dari petak 8192x8192
yang sesuai dengan wilayah minat, dengan semua piksel yang tersisa disamarkan sebagai
-128 (NoData). Untuk detail lengkap tentang tata letak COG, lihat bagian
Struktur file
dalam panduan data GCS AlphaEarth Foundations.
Jalur setiap file COG juga membawa beberapa informasi. Misalnya, pertimbangkan
file di
gs://alphaearth_foundations_custom/custom_satellite_embedding/v1/pacific_palisades_2025_fire/20250107_20250207/x1evicvaet1mupt13-0000008192-0000000000/data.tiff.
Seperti yang terlihat di jalur, file ini adalah bagian dari embedding untuk Kebakaran Palisades 2025 di Los Angeles County. File khusus ini berisi embedding
yang merangkum jangka waktu dari 7 Januari 2025 (inklusif) hingga 7 Februari
2025 (eksklusif). Nama subdirektori x1evicvaet1mupt13-0000008192-0000000000
secara unik mengidentifikasi COG data.tiff dalam
set data pacific_palisades_2025_fire. ID ini adalah UUID buram.
Atau, metadata file ini dan lainnya dapat diekstrak dari file image_manifest.json COG yang ditemukan di gs://alphaearth_foundations_custom/custom_satellite_embedding/v1/pacific_palisades_2025_fire/20250107_20250207/x1evicvaet1mupt13-0000008192-0000000000/image_manifest.json.
File ini adalah representasi JSON dari Manifes Image Earth Engine. Struktur JSON
Manifes Image ditentukan dalam
panduan Manifes Image. Untuk deskripsi lengkap konten dalam file image_manifest.json tertentu, lihat bagian Manifes image.
Dekuantisasi
Nilai piksel mentah di setiap saluran adalah bilangan bulat 8-bit bertanda dalam rentang [-127,
127] (dengan -128 dicadangkan sebagai nilai "tidak ada data") dan harus didekuantisasi untuk
menghasilkan nilai floating point yang siap dianalisis dalam rentang [-1, 1]. Untuk
pemetaan de-kuantisasi dan petunjuk tentang cara membuat piramida downsampled, lihat
bagian De-kuantisasi
dan
Membuat piramida downsampled
dalam panduan data GCS AlphaEarth Foundations.
Manifes dan indeks
Untuk memfasilitasi penemuan, iterasi, dan pendaftaran ubin embedding, setiap
set data menyediakan dua jenis manifes—daftar file COG tingkat set data
(manifest.txt) dan manifes metadata per gambar (image_manifest.json)—bersama
dengan indeks spasial GeoParquet tingkat set data (aef_index.parquet).
Manifes set data
Setiap set data menyertakan file manifest.txt yang terletak di root
direktorinya:
gs://alphaearth_foundations_custom/custom_satellite_embedding/v1/{dataset_name}/manifest.txt
Ini adalah file teks biasa yang berisi URI Google Cloud Storage lengkap untuk setiap file data.tiff dalam set data, yang dipisahkan oleh baris baru.
Manifes image
Di samping setiap file data.tiff, ada file image_manifest.json file bantuan:
gs://alphaearth_foundations_custom/custom_satellite_embedding/v1/{dataset_name}/{start_date}_{end_date}/{image_id}/image_manifest.json
File JSON ini mengikuti spesifikasi Manifes Gambar Earth Engine dan menjelaskan file sumber, struktur band, batas temporal, dan cakupan spasial ubin.
Meskipun kolom manifes standar (seperti tilesets dan bands) mengikuti konvensi Earth Engine standar, ada beberapa detail penting yang perlu diperhatikan:
name: Dikosongkan ("") di GCS. Saat menggunakan manifes ini untuk mendaftarkan gambar dalam koleksi aset Earth Engine, klien harus menyediakan ID aset target (misalnya,projects/{project}/assets/{collection}/{image_id}). Lihat Memuat set data ke Earth Engine untuk mengetahui detailnya.start_time&end_time: Tentukan stempel waktu mulai (inklusif) dan akhir (eksklusif) untuk jangka waktu gabungan dalam UTC yang diformat sebagai ISO 8601 (misalnya,2026-03-15T00:00:00+00:00).footprint: Poligon tertutup dalam koordinat piksel yang menguraikan wilayah yang berisi piksel yang valid. Perhatikan bahwa piksel yang hilang masih dapat ada di dalam poligon - seperti halnya untuk geometri penyematan yang kompleks sepertiking_county_2025_monthly.properties: Metadata nilai kunci khusus untuk embedding, termasuk:IMAGE_ID: ID unik gambar dalam set data.DATASET: Nama set data.DATASET_VERSION: Versi set data.START_DATE&END_DATE: Tanggal mulai (inklusif) dan akhir (eksklusif) interval waktu yang dicakup oleh gambar, yang diformat sebagaiYYYY-MM-DD.MODEL_VERSION: String versi yang secara unik mengidentifikasi versi model yang digunakan untuk menghasilkan gambar.PROCESSING_SOFTWARE_VERSION: String versi yang secara unik mengidentifikasi software pemrosesan data model yang digunakan untuk menghasilkan gambar.UTM_ZONE: Zona UTM dari sistem referensi koordinat yang digunakan untuk menghasilkan gambar.
Indeks GeoParquet
Setiap set data menyertakan file indeks spasial GeoParquet yang terletak di root
direktorinya:
gs://alphaearth_foundations_custom/custom_satellite_embedding/v1/{dataset_name}/aef_index.parquet
Indeks ini berisi satu entri untuk setiap file data.tiff dalam set data dan
menyediakan metadata spasial dan temporal untuk membantu menentukan file mana yang mencakup
area dan jangka waktu tertentu:
geometry: Geometri file sebagai poligon WGS84 (EPSG:4326). Untuk mengetahui detail tentang cara poligon ini dihitung dari kotak pembatas UTM array piksel dan dipangkas ke batas zona UTM, lihat bagian Pemrosesan geometri dalam panduan data GCS AlphaEarth Foundations. Perhatikan bahwa poligon ini mencerminkan batas array piksel 8192x8192 penuh dan tidak memperhitungkan validitas setiap piksel.crs: CRS zona UTM tempat gambar berada sebagai kode EPSG, sepertiEPSG:32610.path: URI Google Cloud Storage (gs://...) dari file COGdata.tiff.dataset: Nama set data.start_date&end_date: Tanggal mulai (inklusif) dan akhir (eksklusif) interval waktu yang dicakup oleh gambar, yang diformat sebagaiYYYY-MM-DD.image_id: ID unik gambar dalam set data.utm_zone: Zona UTM gambar, seperti10N.utm_west,utm_south,utm_east,utm_north: Batas UTM dari array piksel mentah. Hal ini tidak mencerminkan pemrosesan geometri apa pun dan mencakup semua piksel, baik valid maupun tidak.wgs84_west,wgs84_south,wgs84_east,wgs84_north: Bujur dan lintang minimum dan maksimumgeometryWGS84.
Memuat set data ke Earth Engine
CATATAN: Untuk memudahkan, semua set data sampel untuk Embedding Satelit Kustom akan ditambahkan ke Google Earth Engine sebagai ImageCollection publik menggunakan metode yang dijelaskan dalam panduan notebook tertaut dan sudah akan didekuantisasi. Panduan yang ditautkan dapat digunakan oleh pengguna yang mendaftarkan set data Penyematan Satelit Kustom yang baru dikirim sebagai ImageCollections Google Earth Engine.
COG dapat dimuat ke Earth Engine dengan mendaftarkannya sebagai aset yang didukung COG atau memuatnya secara langsung. Lihat notebook Custom Satellite Embeddings Data Access di GitHub untuk panduan lengkap tentang kedua metode tersebut. Untuk ringkasan umum dan perbandingan kedua metode ini, lihat Cloud Optimized GeoTIFF (COG) di Earth Engine.