داده‌های GCS مربوط به Forest Data Partnership

باکت GCS‏ gs://earth-engine-public-requester-pays/forestdatapartnership حاوی فایل‌های COG (Cloud Optimized GeoTIFF) است که باهم مجموعه‌داده‌های کالای Forest Data Partnership را تشکیل می‌دهند.

برای انتشار مدل 2026a، این مدل حاوی شطرنجی‌های احتمال حضور کالا برای سال‌های ۲۰۱۸، ۲۰۲۰، ۲۰۲۲، و ۲۰۲۴ است.

برای نسخه مدل 2025b، این مجموعه داده حاوی شطرنجی‌های احتمال حضور کالا برای سال‌های ۲۰۱۷ تا ۲۰۲۵ است.

گواهینامه رانندگی

این داده‌ها به‌طور رایگان برای استفاده تحت پروانه ارجاع مشترکات خلاقانه نسخه ۴.۰ (CC-BY 4.0) دردسترس قرار گرفته است.

اگر از این مجموعه داده در کارتان استفاده می‌کنید، ارجاع زیر را اضافه کنید: «تولیدشده توسط Google برای Forest Data Partnership»

این سطل به‌عنوان «پرداخت‌کننده درخواست‌کننده» راه‌اندازی شده است — برای جزئیات، این سند GCS را ببینید. به‌طور خلاصه، این یعنی اگرچه خود داده رایگان است، شما مسئول هرگونه هزینه مرتبط با بارگیری فایل‌ها (هزینه‌های خروج) خواهید بود.

ساختار فهرست راهنما

بالاترین سطح دایرکتوری براساس نسخه انتشار (مثلاً 2025b) تقسیم می‌شود. در هر نسخه انتشار، داده‌ها براساس کالا و سپس سال تقسیم می‌شوند. درون هر دایرکتوری برگ، COGهایی وجود دارد که باهم کل محدوده همه‌گرمسیری (از ۲۴ درجه جنوبی تا ۲۴ درجه شمالی) بروندادهای مدل را پوشش می‌دهند. مقادیر منفی به‌ترتیب برای عرض‌های جغرافیایی جنوبی و طول‌های جغرافیایی غربی استفاده می‌شود. توجه داشته باشید که جفت طول و عرض جغرافیایی نشان‌داده‌شده در نام فایل، گوشه جنوب غربی کاشی را مشخص می‌کند.

ساختار فایل

هر فایل یک GeoTIFF بهینه‌شده برای Cloud است که ۱۱۱۳۳ در ۱۱۱۳۳ پیکسل است و کاشی‌ای را پوشش می‌دهد که یک درجه عرض جغرافیایی در یک درجه طول جغرافیایی اندازه دارد. فایل‌ها دارای یک باند با برچسب probability هستند و از تصویر EPSG:4326 (WGS84) استفاده می‌کنند. هر فایل حاوی لایه‌های نمای کلی برای ۵۵۶۷×۵۵۶۷، ۲۷۸۴×۲۷۸۴، تا ۳۴۸×۳۴۸ پیکسل برای نمای کلی سطح بالا است. روش نمونه‌گیری مجدد لایه نمای کلی به نسخه مدل بستگی دارد. برای نسخه 2026a، لایه‌های نمای کلی با نمونه‌گیری میانگین محاسبه می‌شوند؛ برای نسخه 2025b، آن‌ها با نمونه‌گیری نزدیک‌ترین همسایه یا مکعبی (برای دارایی‌های جدیدتر) محاسبه می‌شوند. برای جلوگیری از ابهام، یا از داده‌ها با وضوح ۱۰ متر استفاده کنید یا نمای کلی را درصورت لزوم برای مورد استفاده‌تان بازسازی کنید.

هر پیکسل یک عدد ممیز شناور ۳۲ بیتی غیرکمی بین ۰ و ۱ است که نشان‌دهنده احتمال استنباط‌شده مدل است که منطقه زیر پیکسل بخشی از منطقه کاشته‌شده برای کالای نشان‌داده‌شده در مسیر کامل است.

هر مسیر نشان‌دهنده انتشار، کالا، سال، و جفت طول و عرض جغرافیایی است که به آن مربوط می‌شود. برای مثال: gs://earth-engine-public-requester-pays/forestdatapartnership/2025b/coffee/2024/lng_-10_lat_9.tif نشان‌دهنده کاشی‌ای است که استنتاج‌های مدل حضور قهوه 2025b را برای سال ۲۰۲۴ برای کاشی ۱ درجه در ۱ درجه در ۱۰ درجه غربی و ۹ درجه شمالی نشان می‌دهد. همان‌طور که گفته شد، مقدار طول و عرض جغرافیایی نشان‌دهنده مکان گوشه پایین سمت چپ (جنوب غربی) کاشی است.

نمایه‌های فایل

نمایه‌ای از فایل‌های موجود در این مجموعه داده برای هر نسخه (مثلاً 2025b) در سه قالب (GeoParquet،‏ GeoPackage، و CSV) در فایل‌های زیر ارائه شده است:

  • gs://earth-engine-public-requester-pays/forestdatapartnership/{release}/fdap_index.parquet
  • gs://earth-engine-public-requester-pays/forestdatapartnership/{release}/fdap_index.gpkg
  • gs://earth-engine-public-requester-pays/forestdatapartnership/{release}/fdap_index.csv

‫{release} را با نسخه پخش خاصی که استفاده می‌کنید (برای مثال، 2025b) جایگزین کنید.

این نمایه حاوی یک ورودی برای هر فایل در مجموعه داده است. اطلاعات ارائه‌شده برای هر فایل عبارت است از:

  • release: انتشار مجموعه داده (مثلاً 2025b).
  • ‫commodity: کالا (مثلاً cocoa، coffee، palm، rubber).
  • ‫year: سالی که تصویر پوشش می‌دهد.
  • ‫lng،‏ lat: طول و عرض جغرافیایی گوشه جنوب غربی کاشی.
  • path: مسیر GCS فایل.
  • ‫geometry: هندسه کاشی به‌عنوان WGS84 (یعنی، چندضلعی EPSG:4326.
  • ‫wgs84_west،‏ wgs84_south،‏ wgs84_east،‏ wgs84_north: حداقل و حداکثر طول و عرض جغرافیایی کاشی.