عيّنات من البيانات العامة لتضمينات القمر الصناعي المخصّصة

تحتوي حزمة GCS في gs://alphaearth_foundations_custom على عيّنات من مجموعات بيانات Custom Satellite Embeddings المكوّنة من ملفات COG (Cloud Optimized GeoTIFF) التي تم إنشاؤها بواسطة AlphaEarth Foundations.

الترخيص

تم ترخيص هذه المجموعة من البيانات بموجب CC-BY 4.0، وتتطلّب نص تحديد المصدر التالي: "تُنتج Google وGoogle DeepMind تضمينات مخصّصة من الأقمار الصناعية من AlphaEarth Foundations". يخضع استخدام مجموعات البيانات العامة هذه لسياسة الاستخدام المقبول في Google Cloud.

مجموعات البيانات المتاحة

في ما يلي قائمة بمجموعات البيانات في هذا المستودع. ويحتوي على اسم مجموعة البيانات ووصفها والمنطقة العامة التي تشملها مجموعة البيانات. يُرجى العِلم أنّ الفواصل الزمنية هنا تستخدم وقت بدء شاملاً ووقت انتهاء حصريًا.

  • name: corcoran_city_2026_agricultural_change
    area: Corcoran and surrounding agricultural region, California, USA
    description: Winter bare soil (Dec 15, 2025 - Feb 15, 2026) and spring peak greenness (Mar 15 - May 15, 2026) embeddings capturing agricultural crop dynamics over two seasonal windows.

  • الاسم: futaleufu_argentina_2026_fire_scar
    المنطقة: منتزه "لوس أليرسيس" الوطني والمنطقة المحيطة به، مقاطعة "فوتاليوفو"، محافظة "تشوبوت"، الأرجنتين
    الوصف: تضمينات ما قبل الحريق (من 1 إلى 31 ديسمبر 2025) وما بعد الحريق (من 1 إلى 31 مارس 2026) التي ترصد مدى آثار حريق الغابات واضطراب غطاء الغابات من حريق غابات "لوس أليرسيس" لعام 2026.

  • name: king_county_2025_monthly
    area: King County, Washington, USA
    description: Calendar-month embeddings for the King County administrative area for the first six months of 2025, covering diverse urban city infrastructure and forested land.

  • الاسم: meloland_california_2026_crop_cycles
    المنطقة: ميلولاند والحقول الزراعية المحيطة بها، وادي إمبيريال، كاليفورنيا، الولايات المتحدة الأمريكية
    الوصف: ست خطوات زمنية متسلسلة للتضمين الشهري (من اليوم الخامس عشر إلى اليوم الخامس عشر) (من منتصف نوفمبر 2025 إلى منتصف مايو 2026) لتتبُّع دورات تناوب المحاصيل المتعددة.

  • name: pacific_palisades_2025_fire
    area: Pacific Palisades and surrounding coastal hills, Los Angeles, California, USA
    description: Pre-fire (Dec 7, 2024 - Jan 7, 2025) and post-fire (Jan 7 - Feb 7, 2025) 31-day embeddings capturing Palisades Fire wildfire impact and land cover change.

  • name: theewaterskloof_dam_2026_water_change
    area: سد ثيواترسكلوف، بلدية ثيواترسكلوف المحلية، جنوب أفريقيا
    description: تضمينات لموسم الجفاف (من 1 إلى 31 يناير 2026) وموسم الأمطار (من 15 أبريل إلى 15 مايو 2026) ترصد التغييرات في مساحة سطح مياه الخزان.

بنية الدليل

يتم تنظيم جميع مجموعات البيانات النموذجية ضمن البادئة 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

تحتوي كل مجموعة بيانات على دليل خاص بها يتضمّن ملف فهرس GeoParquet على مستوى مجموعة البيانات aef_index.parquet، وملف manifest.txt على مستوى مجموعة البيانات، ودليل فرعي واحد أو أكثر للفترات الزمنية.

تتم تسمية هذه الأدلة الفرعية للفواصل الزمنية باستخدام النمط {start_date}_{end_date}، حيث يكون تاريخ البدء شاملاً وتاريخ الانتهاء غير شامل. يتم تنسيق كلا التاريخين على النحو التالي: yyyyMMdd، وهما بالتوقيت العالمي المتفق عليه (UTC). على سبيل المثال، سيكون اسم الدليل الفرعي لشهر يونيو 2025 هو 20250601_20250701، وهو ما يتوافق مع فترة زمنية من 2025-06-01T00:00:00Z (شاملة) إلى 2025-07-01T00:00:00Z (غير شاملة).

يحتوي كل دليل فاصل زمني على دليل فرعي لكل تضمين صورة ضمن هذا الفاصل الزمني، ويتم تسميته بمعرّف صورة ({image_id}) يحدّد الصورة بشكل فريد ضمن مجموعة البيانات. يحتوي كل دليل فرعي {image_id} على ملف COG data.tiff لبيانات وحدات البكسل وملف image_manifest.json مصاحب يُستخدَم لتسجيل البيانات في Earth Engine.

بنية الملف

تتطابق البنية الداخلية لكل ملف COG مع ملفات COG السنوية لتضمين صور القمر الصناعي، بما في ذلك أبعادها التي تبلغ 8192×8192 بكسل، و64 قناة (من A00 إلى A63)، وأهرامات النظرة العامة التي تمت تسويتها، والقياس الكمي للأعداد الصحيحة الموقَّعة ذات 8 بت، وقيمة القناع -128 NoData. على عكس ملفات COG السنوية، فإنّ وحدات البكسل الصالحة في كل مربّع عيّنة تغطي عادةً مجموعة فرعية فقط من شبكة 8192x8192 التي تتوافق مع المنطقة محل الاهتمام، مع حجب جميع وحدات البكسل المتبقية كـ -128 (NoData). للحصول على تفاصيل كاملة حول تنسيق COG، يُرجى الاطّلاع على قسم بنية الملفات في دليل بيانات AlphaEarth Foundations GCS.

يحمل مسار كل ملف COG أيضًا بعض المعلومات. على سبيل المثال، لنفترض أنّ الملف موجود على الرابط gs://alphaearth_foundations_custom/custom_satellite_embedding/v1/pacific_palisades_2025_fire/20250107_20250207/x1evicvaet1mupt13-0000008192-0000000000/data.tiff. كما يتضح من المسار، هذا الملف هو جزء من التضمينات الخاصة بحريق باليسيدز لعام 2025 في مقاطعة لوس أنجلوس. يحتوي هذا الملف تحديدًا على تضمينات تلخّص فترة زمنية من 7 يناير 2025 (شاملة) إلى 7 فبراير 2025 (غير شاملة). يحدّد اسم الدليل الفرعي x1evicvaet1mupt13-0000008192-0000000000 بشكل فريد ملف COG الخاص بـ data.tiff في مجموعة بيانات pacific_palisades_2025_fire. هذا المعرّف هو معرّف فريد عالمي (UUID) غير شفاف.

بدلاً من ذلك، يمكن استخراج البيانات الوصفية لهذا الملف والمزيد من ملف COG's image_manifest.json الموجود في gs://alphaearth_foundations_custom/custom_satellite_embedding/v1/pacific_palisades_2025_fire/20250107_20250207/x1evicvaet1mupt13-0000008192-0000000000/image_manifest.json. هذا الملف هو تمثيل JSON لبيان صورة في Earth Engine. يتم تحديد بنية JSON لبيان الصورة في دليل بيان الصورة. للحصول على وصف كامل للمحتوى في ملف image_manifest.json معيّن، يُرجى الاطّلاع على قسم بيان الصورة.

إلغاء التكميم

تكون قيم وحدات البكسل الأولية في كل قناة عبارة عن أعداد صحيحة موقَّعة من 8 بت في النطاق [-127، 127] (مع حجز -128 كقيمة "لا توجد بيانات") ويجب إلغاء تكميمها لإنتاج قيم فاصلة عائمة جاهزة للتحليل في النطاق [-1، 1]. للاطّلاع على عملية الربط لإلغاء التكميم والتعليمات حول إنشاء أهرامات تم تقليل حجمها، يُرجى مراجعة قسمَي إلغاء التكميم وإنشاء أهرامات تم تقليل حجمها في دليل بيانات AlphaEarth Foundations GCS.

ملفات البيانات والفهارس

لتسهيل عملية اكتشاف مربّعات التضمين وتكرارها وتسجيلها، توفّر كل مجموعة بيانات نوعَين من ملفات البيان: قائمة على مستوى مجموعة البيانات لملفات COG (manifest.txt) وملف بيان للبيانات الوصفية لكل صورة (image_manifest.json)، بالإضافة إلى فهرس مكاني GeoParquet على مستوى مجموعة البيانات (aef_index.parquet).

بيان مجموعة البيانات

تتضمّن كل مجموعة بيانات ملف manifest.txt في جذر الدليل: gs://alphaearth_foundations_custom/custom_satellite_embedding/v1/{dataset_name}/manifest.txt

هذا ملف نصي عادي يحتوي على معرّف الموارد المنتظم (URI) الكامل لخدمة Google Cloud Storage لكل ملف data.tiff في مجموعة البيانات، مفصولاً بأسطر جديدة.

بيان الصورة

إلى جانب كل ملف data.tiff، يتوفّر ملف image_manifest.json مصاحب: gs://alphaearth_foundations_custom/custom_satellite_embedding/v1/{dataset_name}/{start_date}_{end_date}/{image_id}/image_manifest.json

يتبع ملف JSON هذا مواصفات بيان صور Earth Engine ويصف ملفات مصدر المربّعات وبنية النطاق والحدود الزمنية والتغطية المكانية.

تتّبع حقول البيان العادية (مثل tilesets وbands) قواعد Earth Engine العادية، ولكن هناك بعض التفاصيل الرئيسية التي يجب مراعاتها:

  • name: تم ترك هذا الحقل فارغًا ("") في GCS. عند استخدام هذا البيان لتسجيل صورة في مجموعة مواد عرض في Earth Engine، يجب أن يوفّر العميل رقم تعريف مادة العرض المستهدَفة (مثلاً، projects/{project}/assets/{collection}/{image_id}). يُرجى الاطّلاع على تحميل مجموعة بيانات إلى Earth Engine لمعرفة التفاصيل.
  • ‫start_time وend_time: حدِّد الطوابع الزمنية للبداية (شاملة) والنهاية (غير شاملة) للفترة الزمنية المركّبة بالتوقيت العالمي المنسّق (UTC) بتنسيق ISO 8601 (مثلاً، 2026-03-15T00:00:00+00:00).
  • ‫footprint: مضلّع مغلق في إحداثيات البكسل يحدّد منطقة تحتوي على وحدات بكسل صالحة. يُرجى العِلم أنّ وحدات البكسل المفقودة يمكن أن تظل موجودة داخل المضلّع، كما هو الحال في الأشكال الهندسية المعقّدة المضمّنة مثل king_county_2025_monthly.
  • ‫properties: بيانات وصفية تتألف من مفتاح وقيمة خاصة بالتضمين، بما في ذلك:
    • IMAGE_ID: المعرّف الفريد للصورة ضمن مجموعة البيانات
    • ‫DATASET: اسم مجموعة البيانات
    • ‫DATASET_VERSION: إصدار مجموعة البيانات
    • ‫START_DATE وEND_DATE: تاريخا البدء (مشمول) والانتهاء (غير مشمول) للفاصل الزمني الذي تغطّيه الصورة، بتنسيق YYYY-MM-DD.
    • ‫MODEL_VERSION: سلسلة الإصدار التي تحدّد بشكل فريد إصدار النموذج المستخدَم لإنشاء الصورة
    • ‫PROCESSING_SOFTWARE_VERSION: سلسلة الإصدار التي تحدّد بشكل فريد برنامج معالجة بيانات النموذج المستخدَم لإنشاء الصورة
    • ‫UTM_ZONE: منطقة نظام مراقبة الزيارات من Urchin لنظام الإحداثيات المرجعي المستخدَم لإنشاء الصورة

فهرس GeoParquet

تتضمّن كل مجموعة بيانات ملف فهرس مكاني بتنسيق GeoParquet في جذر الدليل: gs://alphaearth_foundations_custom/custom_satellite_embedding/v1/{dataset_name}/aef_index.parquet

يحتوي هذا الفهرس على إدخال واحد لكل ملف data.tiff في مجموعة البيانات، ويوفّر بيانات وصفية مكانية وزمنية للمساعدة في تحديد الملفات التي تغطي منطقة وفترة زمنية معيّنتَين:

  • geometry: الشكل الهندسي للملف كمضلّع WGS84 (EPSG:4326). لمعرفة تفاصيل حول كيفية احتساب هذا المضلّع من المربّع المحيطي لنظام الإحداثيات المستعرض العالمي لميركاتور (UTM) الخاص بمصفوفة وحدات البكسل واقتصاصه وفقًا لحدود منطقة UTM، يُرجى الاطّلاع على قسم معالجة الأشكال الهندسية في دليل بيانات GCS الخاص بنموذج AlphaEarth Foundations. يُرجى العِلم أنّ هذا المضلّع يعكس حدود مصفوفة البكسل الكاملة التي تبلغ 8192×8192 ولا يأخذ في الاعتبار صلاحية وحدات البكسل الفردية.
  • ‫crs: نظام الإحداثيات المرجعي (CRS) لمنطقة نظام مراقبة الزيارات من Urchin التي تنتمي إليها الصورة كرمز EPSG، مثل EPSG:32610.
  • path: معرّف الموارد المنتظم (URI) في Google Cloud Storage (gs://...) لملف COG data.tiff
  • dataset: اسم مجموعة البيانات
  • ‫start_date وend_date: تاريخا البدء (مشمول) والانتهاء (غير مشمول) للفاصل الزمني الذي تغطّيه الصورة، بتنسيق YYYY-MM-DD.
  • image_id: المعرّف الفريد للصورة ضمن مجموعة البيانات.
  • ‫utm_zone: منطقة نظام مراقبة الزيارات من Urchin للصورة، مثل 10N.
  • ‫utm_west, utm_south, utm_east, utm_north: حدود نظام الإحداثيات المستعرض العالمي (UTM) لمصفوفة وحدات البكسل الأولية لا يعكس هذا أي معالجة هندسية ويتضمّن جميع وحدات البكسل سواء كانت صالحة أم لا.
  • ‫wgs84_west وwgs84_south وwgs84_east وwgs84_north: الحد الأدنى والحد الأقصى لخطوط الطول والعرض في نظام WGS84 geometry

تحميل مجموعة بيانات إلى Earth Engine

ملاحظة: لتسهيل الأمر، ستتم إضافة جميع مجموعات البيانات النموذجية لـ "تضمينات القمر الصناعي المخصّصة" إلى Google Earth Engine كمجموعات صور علنية باستخدام الطريقة الموضّحة في دليل ورقة الملاحظات المرتبطة، وستتم إزالة التكميم منها مسبقًا. يمكن للمستخدمين الذين يسجّلون مجموعات بيانات Custom Satellite Embedding التي تم تسليمها حديثًا استخدام الدليل المرتبط بها كمجموعات صور في Google Earth Engine.

يمكن تحميل ملفات COG إلى Earth Engine إما من خلال تسجيلها كمواد عرض مستندة إلى COG أو تحميلها مباشرةً. يُرجى الاطّلاع على دفتر ملاحظات الوصول إلى بيانات تضمينات الأقمار الصناعية المخصّصة على GitHub للحصول على دليل كامل لكلتا الطريقتَين. للحصول على نظرة عامة ومقارنة بين هاتين الطريقتَين، يُرجى الاطّلاع على ملفات GeoTIFF المحسّنة للسحابة الإلكترونية (COGs) في Earth Engine.