وارد کردن داده‌های شطرنجی

می‌توانید از مدیر دارایی یا میانای خط فرمان (CLI) برای بارگذاری تصویر یا دیگر مجموعه‌داده‌های شطرنجی زمین‌مرجع در قالب GeoTIFF یا TFRecord استفاده کنید. (برای جزئیات مربوط به وارد کردن بردارها بااستفاده از «ویرایشگر کد»، وارد کردن داده‌های برداری را ببینید.)

بارگذاری دارایی‌های تصویری

GeoTIFF

در «ویرایشگر کد»، می‌توانید فایل‌های تصویری GeoTIFF با اندازه حداکثر ۱۰ گیگابایت را در پوشه کاربر Earth Engine بارگذاری کنید. (برای فایل‌های بزرگ‌تر، از گزینه بارگذاری خط فرمان استفاده کنید.)

برای بارگذاری GeoTIFF بااستفاده از «ویرایشگر کد»، برگه «دارایی‌ها» را در گوشه بالا سمت راست انتخاب کنید، روی دکمه کلیک کنید، سپس بارگذاری تصویر را انتخاب کنید. Earth Engine کادر گفتگوی بارگذاری را نشان می‌دهد که باید شبیه به شکل ۱ باشد. روی دکمه انتخاب کلیک کنید و به GeoTIFF در سیستم فایل محلی خود بروید.

شناسه دارایی مناسبی (که ازقبل وجود نداشته باشد) در پوشه کاربر به تصویر بدهید. اگر می‌خواهید تصویر را در پوشه یا مجموعه موجودی بارگذاری کنید، شناسه دارایی را با شناسه پوشه یا مجموعه پیشوند کنید، برای مثال projects/myproject/folder-or-collection-id/new-asset.

روی بارگذاری کلیک کنید تا بارگذاری شروع شود.

دارایی‌ها
شکل ۱. کادر گفتگوی بارگذاری تصویر مدیر دارایی

وقتی بارگذاری را شروع کردید، تکلیف «دریافت دارایی» در برگه «تکالیف» در سمت راست «ویرایشگر کد» ظاهر می‌شود. نگه داشتن نشانگر روی تکلیف در مدیر وظایف، ؟ را نشان می‌دهد نماد که می‌توانید از آن برای بررسی وضعیت بارگذاری استفاده کنید. برای لغو بارگذاری، روی نماد چرخان در کنار تکلیف کلیک کنید. پس‌از تکمیل فرایند دریافت، دارایی با نماد در پوشه کاربر شما ظاهر می‌شود.

فشرده‌سازی GeoTIFF

فایل‌های GeoTIFF را می‌توان با DEFLATE،‏ JPEG،‏ JPEG-XL/JXL،‏ LERC،‏ LERC_DEFLATE،‏ LERC_ZSTD،‏ LZMA،‏ LZW،‏ WEBP، یا ZSTD فشرده کرد. GeoTIFFهای بهینه‌شده ابری (COG) که Earth Engine به‌جای دریافت، در محل می‌خواند، مجموعه محدودتری را می‌پذیرد؛ به فشرده‌سازی COG مراجعه کنید.

توصیه‌هایی برای بهترین تجربه بارگذاری فایل‌های بزرگ:

  • بهترین انتخاب: ZSTD تعادل خوبی بین سرعت و فشرده‌سازی ارائه می‌دهد.
  • اجتناب کنید: LZMA با وجود فشرده‌سازی خوب می‌تواند بسیار کند باشد.
  • فایل‌های فشرده‌نشده: منجر به فایل‌های بزرگ‌تر و زمان بارگذاری طولانی‌تر می‌شود.
  • فشرده‌سازی پراتلاف (مثلاً JPEG): ممکن است مقادیر پیکسل را تغییر دهد. از فشرده‌سازی بدون اتلاف (مثلاً DEFLATE،‏ LZMA،‏ LZW،‏ ZSTD) به‌جای فشرده‌سازی پراتلاف استفاده کنید، مگراینکه از تأثیر احتمالی آن بر داده‌هایتان مطلع باشید.

TFRecord

برای بارگذاری تصویر از فایل TFRecord، باید فایل میکسر مرتبطی را داشته باشید که هنگام صادر کردن تصاویر مورداستفاده برای استنتاج تولید شده است. برای جزئیات مربوط به فایل میکسر، صفحه صادر کردن را ببینید. به‌طور دقیق‌تر، برای وارد کردن پیش‌بینی‌ها (به‌صورت تصویر) که روی تصاویر صادرشده انجام شده است،

  1. تصاویر را در یک یا چند فایل TFRecord صادر کنید.
  2. انجام استنتاج روی تصاویر (یعنی model.predict()).
  3. برونداد model.predict() را در فایل TFRecord بنویسید. پیش‌بینی‌ها باید به همان ترتیب صادر کردن تصویر باشد که استنتاج را روی آن انجام داده‌اید. ترتیب را می‌توان با نوعی مرتب‌سازی نام فایل‌های تولیدشده توسط برون‌برد اعمال کرد. برای جزئیات، بخش صادر کردن فایل‌های بزرگ را ببینید.
  4. فایل(های) TFRecord و میکسر مرتبط را در Earth Engine بارگذاری کنید.

ویرایش مشخصه‌ها

فراداده دارایی را با مشخص کردن یک یا چند ویژگی فراداده ویرایش کنید. در منو مشخصات، روی افزودن مشخصه کلیک کنید تا نام و مقدار مشخصه را تعریف کنید (شکل ۲). مقدار می‌تواند رشته یا عدد باشد. رشته‌ها را بدون علامت نقل‌قول وارد کنید. برای قالب‌بندی عدد به‌عنوان رشته، یک علامت نقل‌قول تکی (') قبل‌از عدد وارد کنید.

به‌طور پیش‌فرض، دارایی system:time_start بدون مقدار اضافه می‌شود. این ویژگی را Earth Engine هنگام اعمال ImageCollection فیلترهای تاریخ استفاده می‌کند. تاریخ را در قالب نشان‌داده‌شده در شکل ۲ یا عددی که نشان‌دهنده میلی‌ثانیه از ۱ ژانویه ۱۹۷۰ است وارد کنید. (برای اطلاعات بیشتر درباره مُهرهای زمان در Earth Engine، به واژه‌نامه مراجعه کنید). «مدیر دارایی» عددی را که به‌عنوان مقدار برای دارایی‌ای به‌نام system:time_start یا system:time_end وارد شده است به‌عنوان میلی‌ثانیه تفسیر می‌کند و آن را به‌صورت تاریخ قالب‌بندی می‌کند.

روی نماد کلیک کنید تا دارایی را بردارید.

گزینه‌های پیشرفته

در منو پیشرفته، خط‌مشی هرمی و حالت ماسک‌گذاری را برای داده‌هایتان انتخاب کنید.

خط‌مشی هرمی مشخص می‌کند که Earth Engine چگونه نسخه‌های با وضوح پایین‌تر تصویر را تولید می‌کند. در سند مقیاس درباره نحوه مدیریت وضوح‌های چندگانه توسط Earth Engine بیشتر بدانید. یک خط‌مشی هرمی «میانگین»، «حداقل»، یا «حداکثر» را انتخاب کنید تا سطوح وضوح پایین‌تر هرم تصویر را به‌عنوان میانگین، حداقل، یا حداکثر هر گروه ۲×۲ از پیکسل‌های با وضوح بالاتر محاسبه کنید. این گزینه برای تصاویر با مقدار پیوسته مناسب است. برای داده‌های طبقه‌بندی‌شده (مثلاً پوشش زمین) یا تضمین کیفیت، خط‌مشی هرمی «نمونه» (پیکسل بالا سمت چپ) یا «حالت» (مقداری که بیشترین تکرار را دارد، یا نمونه اگر حالتی وجود نداشته باشد) را انتخاب کنید.

حالت ماسک‌گذاری نشان می‌دهد که تصویر بارگذاری‌شده چگونه ماسک‌گذاری شده است (اگر اصلاً ماسک‌گذاری شده باشد). برای مشخص کردن مقدار بدون داده، «مقدار بدون داده» را انتخاب کنید و مقدار را وارد کنید. پیکسل‌های دارای این مقدار در تصویر بارگذاری‌شده ماسک خواهند شد. این مقدار به‌طور مستقل برای هر باند تصویر اعمال می‌شود. برای استفاده از آخرین باند تصویرتان به‌عنوان ماسک برای باندهای دیگر تصویر، «استفاده از آخرین باند به‌عنوان باند آلفا» را انتخاب کنید. باند آلفا باید باند ۸ بیتی بدون علامت باشد که در آن ۰ داده‌های ماسک‌شده (کاملاً شفاف) و ۲۵۵ کاملاً مات است.

بارگذاری‌های کاشی‌کاری‌شده

برای بارگذاری یک تصویر به‌عنوان چند کاشی، که هر کاشی در فایل منبع متفاوتی ذخیره شده است، روی افزودن فایل دیگر کلیک کنید تا فایل‌های بیشتری به بارگذاری اضافه شود. Earth Engine کاشی‌ها را ترکیب می‌کند تا یک تصویر واحد در پوشه کاربر شما ایجاد کند.

چند محدودیت برای انواع فایل‌هایی که می‌توانند در دارایی تصویری بارگذاری شوند وجود دارد. بطور خاص:

  1. تصاویر باید تعداد باند، عمق بیت، طرح‌افکنی، وضوح، و مقادیر پر کردن یکسانی داشته باشند.
  2. فاصله از یک فایل تا فایل بعدی باید مضرب صحیحی از اندازه پیکسل باشد.
  3. شکاف‌های بین کاشی‌ها با پیکسل‌های پوشانده‌شده در تصویر نهایی پر خواهد شد، بنابراین کاشی‌ها باید در حالت ایده‌آل مجاور باشند و به‌صورت پراکنده پخش نشده باشند. تصاویر دارای فاصله که بیش‌از ۹۹٪ از فضای تصویر را اشغال می‌کنند، دریافت نخواهند شد.