ছবির ম্যানিফেস্ট আপলোড করা

Google Earth Engine (EE)-এ ছবি আপলোড করার জন্য কোড এডিটর UI বা 'earthengine' কমান্ড-লাইন টুলের upload কমান্ডের থেকে বেশি নমনীয়তার প্রয়োজন হলে, আপনি "ম্যানিফেস্ট" নামে পরিচিত JSON ফাইল ব্যবহার করে ছবি আপলোড করার বিবরণ দিয়ে এবং কমান্ড-লাইন টুলের upload image --manifest কমান্ড ব্যবহার করে তা করতে পারেন।

এই Colab নোটবুকে একটি সম্পূর্ণ উদাহরণ দেখুন যা ম্যানিফেস্ট ব্যবহার করে একটি অ্যাসেট হিসেবে ইমেজ টাইল আপলোড করার বিষয়টি দেখায়।

এককালীন সেট-আপ

  1. ম্যানিফেস্ট আপলোড শুধুমাত্র Google Cloud Storage-এ থাকা ফাইলের ক্ষেত্রে কাজ করে। Google Cloud Storage ব্যবহার করা শুরু করতে, একটি Google Cloud প্রোজেক্ট তৈরি করুন, যদি আপনার আগে থেকে কোনও প্রোজেক্ট না থাকে। মনে রাখবেন, সেট-আপ করার জন্য বিলিংয়ের উদ্দেশ্যে ক্রেডিট কার্ড উল্লেখ করতে হবে। EE এই মুহূর্তে কাউকে চার্জ করছে না, তবে EE-তে আপলোড করার আগে Google Cloud Storage-এ ফাইল ট্রান্সফার করার জন্য সামান্য খরচ হবে। সাধারণত আপলোড করা ডেটার সাইজের (দশ বা শত শত গিগাবাইট) জন্য খরচ বেশ কম হবে।
  2. আপনার প্রোজেক্টের মধ্যে, Cloud Storage API চালু করুন এবং বাকেট তৈরি করুন।
  3. Earth Engine Python ক্লায়েন্ট ইনস্টল করুন। এতে earthengine কমান্ড-লাইন টুল অন্তর্ভুক্ত আছে, যা আমরা ডেটা আপলোড করার জন্য ব্যবহার করব।
  4. অটোমেটিক আপলোডের জন্য, আপনার প্রোজেক্টের সাথে যুক্ত Google Cloud পরিষেবা অ্যাকাউন্ট ব্যবহার করতে চাইতে পারেন। পরীক্ষা করার জন্য আপনার কোনও পরিষেবা অ্যাকাউন্টের প্রয়োজন নেই, তবে সময় পেলে, সেগুলি ব্যবহার করার ব্যাপারে নিজেকে পরিচিত করতে শুরু করুন।

খুব বড় সোর্স ফাইল (১০০ জিবি বা তার বেশি) একাধিক টাইলসে ভাগ করে নিলে আরও দ্রুত আপলোড করা যেতে পারে।

অ্যাসেট আইডি ও নাম

ক্লাউড প্রোজেক্টের মালিকানাধীন অ্যাসেটের ক্ষেত্রে, অ্যাসেটের নামের জন্য এই কনভেনশন ব্যবহার করুন: projects/some-project-id/assets/some-asset-id.

পুরনো প্রোজেক্ট ও ব্যবহারকারীর মালিকানাধীন অ্যাসেটের জন্য অ্যাসেটের নাম সম্পর্কে জানুন

পুরনো লিগ্যাসি প্রোজেক্টের ক্ষেত্রে, ম্যানিফেস্টে অ্যাসেটের নাম Earth Engine-এর অন্য কোথাও দেখা অ্যাসেট আইডির থেকে সামান্য আলাদা হতে হবে। যেসব অ্যাসেটের আইডি users/some_user বা projects/some_project দিয়ে শুরু হয়, সেগুলি আপলোড করতে, ম্যানিফেস্টে অ্যাসেটের নামের আইডির আগে projects/earthengine-legacy/assets/ স্ট্রিং থাকতে হবে। যেমন, EE অ্যাসেট আইডি users/username/my_geotiff, projects/earthengine-legacy/assets/users/username/my_geotiff নাম ব্যবহার করে আপলোড করতে হবে।

হ্যাঁ, এর অর্থ হল projects/some_projects/some_asset-এর মতো আইডি এমন নামে পরিবর্তিত হয় যেখানে projects দুবার উল্লেখ করা হয়েছে: projects/earthengine-legacy/assets/projects/some_projects/some_asset। এটি বিভ্রান্তিকর হলেও Google Cloud API স্ট্যান্ডার্ড মেনে চলার জন্য প্রয়োজনীয়।

ম্যানিফেস্ট ব্যবহার করা

নিম্নলিখিত কোড ব্লকে একটি বেসিক ম্যানিফেস্ট দেখানো হয়েছে। এটি gs://earthengine-test নামের Google Cloud Storage বাকেট থেকে small.tif নামের ফাইল আপলোড করে।

{
  "name": "projects/some-project-id/assets/some-asset-id",
  "tilesets": [
    {
      "sources": [
        {
          "uris": [
            "gs://earthengine-test/small.tif"
          ]
        }
      ]
    }
  ]
}

এটি ব্যবহার করতে, manifest.json নামের ফাইলে সেভ করে রান করুন:

earthengine upload image --manifest /path/to/manifest.json

(gs://earthengine-test/small.tif ফাইলটি আছে এবং সর্বজনীনভাবে পড়া যায়-আপনি এটি পরীক্ষা করার জন্য ব্যবহার করতে পারেন।)

টাইলসেট

JSON-এর কিছুটা জটিল ম্যানিফেস্ট স্ট্রাকচার প্রয়োজন যাতে আপলোড করার সময় হওয়া সাধারণ সমস্যার সমাধান করার জন্য যথেষ্ট নমনীয়তা পাওয়া যায়: একাধিক সোর্স ফাইল থেকে পিক্সেল একত্রিত করে একটি অ্যাসেট তৈরি করার সব সম্ভাব্য উপায় কীভাবে বর্ণনা করা যায়। বিশেষ করে, ফাইল একসাথে গ্রুপ করার দুটি স্বতন্ত্র উপায় আছে:

  • মোজাইক। কখনও কখনও একাধিক ফাইল একাধিক টাইলকে উপস্থাপন করে (যেমন, প্রতিটি টাইল হল ১x১ ডিগ্রি বর্গক্ষেত্র)। এই ধরনের ফাইল অবশ্যই মোসাইক (একসাথে মার্জ করা) করে EE অ্যাসেটের একই ব্যান্ডে রাখতে হবে।
  • আলাদা ব্যান্ড। কখনও কখনও, একাধিক ফাইল একাধিক ব্যান্ডকে উপস্থাপন করে। এই ধরনের ফাইল অবশ্যই EE অ্যাসেটে ব্যান্ড হিসেবে একসাথে স্ট্যাক করতে হবে।

(একই সময়ে দুটি পদ্ধতিই ব্যবহার করতে হতে পারে, তবে এমন পরিস্থিতি খুব কমই হয়।)

এইসব বিকল্পের বিবরণ দিতে, ম্যানিফেস্ট টাইলসেট-এর ধারণা নিয়ে আসে। একটি টাইলসেট একটি GDAL সোর্সের সাথে সম্পর্কিত। এই কারণে, একটি টাইলসেটের সব সোর্সের GDAL স্ট্রাকচার একই হতে হবে (ব্যান্ডের সংখ্যা ও ধরন, প্রোজেকশন, ট্রান্সফর্ম, অনুপস্থিত ভ্যালু)। যেহেতু একটি GDAL সোর্সে একাধিক ব্যান্ড থাকতে পারে, তাই একটি টাইলসেটে একাধিক EE ব্যান্ডের ডেটা থাকতে পারে।

মোজাইক ইনজেশন-এর জন্য, ম্যানিফেস্ট এইরকম দেখতে হবে:

{
  "name": "projects/some-project-id/assets/some-asset-id",
  "tilesets": [
    {
      "sources": [
        {
          "uris": [
            "gs://bucket/N30W22.tif"
          ]
        },
        {
          "uris": [
            "gs://bucket/N31W22.tif"
          ]
        }
      ]
    }
  ]
}

আলাদা ব্যান্ডের জন্য, ম্যানিফেস্টটি এইরকম দেখতে হবে (আপনাকে নিচে ব্যাখ্যা করা bands বিভাগও যোগ করতে হবে):

{
  "name": "projects/some-project-id/assets/some-asset-id",
  "bands": ...,
  "tilesets": [
    {
      "id": "tileset_for_band1",
      "sources": [
        {
          "uris": [
            "gs://bucket/band1.tif"
          ]
        }
      ]
    },
    {
      "id": "tileset_for_band2",
      "sources": [
        {
          "uris": [
            "gs://bucket/band2.tif"
          ]
        }
      ]
    }
  ]
}

মনে রাখবেন, আলাদা ব্যান্ডের ক্ষেত্রে, স্বচ্ছতার জন্য আমাদের প্রতিটি টাইলসেটকে একটি আলাদা টাইলসেট আইডি দিতে হবে। টাইলসেট আইডি যেকোনও স্ট্রিং হতে পারে - এই স্ট্রিংগুলি আপলোড করা অ্যাসেটে রাখা হয় না। টাইলসেট আইডি শুধুমাত্র ইনজেশনে ব্যবহার করা হয় স্ট্যাক করা টাইলসেট একে অপরের থেকে আলাদা করতে।

ব্যান্ড

দ্বিতীয় গুরুত্বপূর্ণ ধারণা হল, EE অ্যাসেট ব্যান্ডের সাথে সোর্স ফাইল ম্যাচ করা। ম্যানিফেস্টের bands বিভাগ ব্যবহার করে এটি করা হয়।

bands বিভাগটি বাদ দেওয়া যেতে পারে, সেক্ষেত্রে ব্যান্ডগুলি প্রথমে প্রথম টাইলসেটের ফাইলগুলি থেকে তৈরি করা হয়, তারপরে পরবর্তী টাইলসেট থেকে এবং আরও অনেক কিছু। সাধারণত, ব্যান্ডগুলির নাম "b1", "b2" ইত্যাদি হয়। ডিফল্ট ব্যান্ডের নাম ওভাররাইড করতে, শেষে "ব্যান্ড" বিভাগ যোগ করুন, যেমন:

{
  "name": "projects/earthengine-legacy/assets/users/username/some_folder/some_id",
  "tilesets": [
    {
      "sources": [
        {
          "uris": [
            "gs://bucket/rgb.tif"
          ]
        }
      ]
    }
  ],
  "bands": [
    {
      "id": "R",
      "tilesetBandIndex": 0
    },
    {
      "id": "G",
      "tilesetBandIndex": 1
    },
    {
      "id": "B",
      "tilesetBandIndex": 2
    }
  ]
}

EE ব্যান্ডের সংখ্যা অবশ্যই সব টাইলসেটের মোট ব্যান্ডের সংখ্যার সমান হতে হবে।

আপনি যদি কোনও ফাইল থেকে সব ব্যান্ড ইনজেস্ট করতে না চান, তাহলে কোন GDAL ব্যান্ড ইনজেস্ট করা উচিত তা নির্দেশ করতে tilesetBandIndex ফিল্ড ব্যবহার করতে পারেন। প্রথম ব্যান্ডের tilesetBandIndex হল ০।

উদাহরণ:

ধরা যাক, সোর্স ফাইলে চারটি ব্যান্ড আছে: "tmin", "tmin_error", "tmax", "tmax_error"। আমরা শুধু "tmin" এবং "tmax" ইনজেস্ট করতে চাই। প্রাসঙ্গিক ম্যানিফেস্ট বিভাগগুলি এইরকম দেখাবে:

{
  "name": "projects/earthengine-legacy/assets/users/username/some_folder/some_id",
  "tilesets": [
    {
      "id": "temperature",
      "sources": [
        {
          "uris": [
            "gs://bucket/temperature.tif"
          ]
        }
      ]
    }
  ],
  "bands": [
    {
      "id": "tmin",
      "tilesetBandIndex": 0,
      "tilesetId": "temperature"
    },
    {
      "id": "tmax",
      "tilesetBandIndex": 2,
      "tilesetId": "temperature"
    }
  ]
}

মাস্ক ব্যান্ড

ব্যান্ড মাস্কিং ম্যানিফেস্টের maskBands কম্পোনেন্ট দ্বারা নিয়ন্ত্রিত হয়। তিনটি সম্ভাব্য মাস্ক কনফিগারেশন কাজ করে (তবে মাস্ক ব্যান্ডকে সবসময় নির্দিষ্ট ফাইলের শেষ ব্যান্ড হিসেবে ধরা হয়)।

  1. একই ফাইলে সব ডেটা ব্যান্ডের জন্য মাস্ক।
  2. অন্য সব ফাইল থেকে আসা সব ডেটা ব্যান্ডের জন্য মাস্ক।
  3. কিছু ডেটা ব্যান্ডের জন্য মাস্ক।

১. সবচেয়ে সাধারণ ঘটনা হল একটি GeoTIFF যার শেষ ব্যান্ডটি অন্য ব্যান্ডের জন্য মাস্ক হিসেবে ব্যবহার করা হয়। এটি শুধু বাইট ধরনের GeoTIFF-এর ক্ষেত্রে কাজ করে। নিম্নলিখিত ম্যানিফেস্ট ব্যবহার করুন:

{
  "name": "projects/earthengine-legacy/assets/users/username/some_folder/some_id",
  "tilesets": [
    {
      "id": "data_tileset",
      "sources": [
        {
          "uris": [
            "gs://bucket/data_file.tif"
          ]
        }
      ]
    }
  ],
  "bands": [
    {
      "id": "data_band",
      "tilesetId": "data_tileset"
    },
    {
      "id": "qa_band",
      "tilesetId": "data_tileset"
    }
  ],
  "maskBands": [
    {
      "tilesetId": "data_tileset"
    }
  ]
}

২. অন্য GeoTIFF-এর সব ব্যান্ডের জন্য মাস্ক হিসেবে GeoTIFF মাস্ক ব্যবহার করতে, নিম্নলিখিত ম্যানিফেস্ট ব্যবহার করুন:

{
  "name": "projects/earthengine-legacy/assets/users/username/some_folder/some_id",
  "tilesets": [
    {
      "id": "data_tileset",
      "sources": [
        {
          "uris": [
            "gs://bucket/data_file.tif"
          ]
        }
      ]
    },
    {
      "id": "mask_tileset",
      "sources": [
        {
          "uris": [
            "gs://bucket/mask_file.tif"
          ]
        }
      ]
    }
  ],
  "bands": [
    {
      "id": "data_band",
      "tilesetId": "data_tileset"
    },
    {
      "id": "qa_band",
      "tilesetId": "data_tileset"
    }
  ],
  "maskBands": [
    {
      "tilesetId": "mask_tileset"
    }
  ]
}

৩. অন্য ফাইলে নির্দিষ্ট ব্যান্ডের জন্য মাস্ক হিসেবে GeoTIFF ব্যবহার করতে, নিম্নলিখিত ম্যানিফেস্ট ব্যবহার করুন (আগের ক্ষেত্রের সাথে পার্থক্য হল যে maskBands-এ bandIds ফিল্ড সেট করা আছে):

{
  "name": "projects/earthengine-legacy/assets/users/username/some_folder/some_id",
  "tilesets": [
    {
      "id": "data_tileset",
      "sources": [
        {
          "uris": [
            "gs://bucket/data_file.tif"
          ]
        }
      ]
    },
    {
      "id": "mask_tileset",
      "sources": [
        {
          "uris": [
            "gs://bucket/mask_file.tif"
          ]
        }
      ]
    }
  ],
  "bands": [
    {
      "id": "data_band",
      "tilesetId": "data_tileset"
    },
    {
      "id": "qa_band",
      "tilesetId": "data_tileset"
    }
  ],
  "maskBands": [
    {
      "tilesetId": "mask_tileset",
      "bandIds": ["data_band"]
    }
  ]
}

শেষ উদাহরণে, আমরা data_tileset টাইলসেট থেকে দুটি ব্যান্ডের সাথে কাজ করছি, কিন্তু শুধুমাত্র একটি ব্যান্ডে (data_band) মাস্ক প্রয়োগ করছি, যেটি শুধুমাত্র প্রদান করা maskBands তালিকা অবজেক্টের bandIds ফিল্ড দ্বারা নির্দিষ্ট করা হয়েছে।

মনে রাখবেন, maskBands-এ উল্লেখ করা টাইলসেটের শুধুমাত্র শেষ ব্যান্ডটি মাস্ক ব্যান্ড হিসেবে ব্যবহার করা হয়।

পিরামিডিং সংক্রান্ত নীতি

ইনজেশনের সময় Earth Engine যখন ইমেজ পিরামিড তৈরি করে, তখন এটিকে বারবার ২x২-পিক্সেল গ্রিডকে একটি পিক্সেলে কমাতে হয়, পিক্সেল ভ্যালুকে কোনওভাবে পরিবর্তন করে। সাধারণত, পিক্সেল ভ্যালুর গড় করা হয়, যা বেশিরভাগ ক্ষেত্রে সঠিক পদ্ধতি, যখন রাস্টার ব্যান্ড কম-বেশি ধারাবাহিক ডেটা দেখায়। তবে, দুটি পরিস্থিতিতে ডিফল্ট ভ্যালুর উপর নির্ভর করলে ভুল ফলাফল পাওয়া যাবে, সেক্ষেত্রে ব্যান্ড সংজ্ঞায় pyramidingPolicy ফিল্ড অবশ্যই সেট করতে হবে (সেট করা না থাকলে, ডিফল্ট হিসেবে এর ভ্যালু "MEAN" ধরে নেওয়া হয়)।

রাস্টার ছবির শ্রেণীবিভাগের জন্য (যেমন, ল্যান্ড কভার শ্রেণীবিভাগের জন্য) পিক্সেল পিরামিডিংয়ের সবচেয়ে যৌক্তিক উপায় হল চারটি মানের মধ্যে সংখ্যাগরিষ্ঠ মান নিয়ে পরবর্তী মান তৈরি করা। "MODE" পিরামিডিং নীতি ব্যবহার করে এটি করা হয়:

{
  "name": "projects/earthengine-legacy/assets/users/username/some_folder/some_id",
  "tilesets": [
    {
      "sources": [
        {
          "uris": [
            "gs://bucket/landcover.tif"
          ]
        }
      ]
    }
  ],
  "bands": [
    {
      "id": "landcover",
      "pyramidingPolicy": "MODE"
    }
  ]
}

যেসব রাস্টার ব্যান্ডের ক্ষেত্রে "MEAN" বা "MODE" কোনওটিই অর্থপূর্ণ নয় (যেমন, বিটপ্যাক করা পিক্সেল), সেগুলির ক্ষেত্রে "SAMPLE" পিরামিডিং নীতি ব্যবহার করা উচিত। "SAMPLE" সবসময় প্রতিটি ২x২ গ্রিডের উপরের বাঁদিকের পিক্সেলের ভ্যালু নেয়। নিচের উদাহরণে "MEAN" পিরামিডিং নীতিকে একটি ব্যান্ডে অ্যাসাইন করা হয়েছে যা একটি অবিচ্ছিন্ন ভেরিয়েবল ("NDVI") এবং ডেটার "QA" ব্যান্ডে "SAMPLE" দেখায়।

{
  "name": "projects/earthengine-legacy/assets/users/username/some_folder/some_id",
  "tilesets": [
    {
      "sources": [
        {
          "uris": [
            "gs://bucket/ndvi.tif"
          ]
        }
      ]
    }
  ],
  "bands": [
    {
      "id": "NDVI",
      "tilesetBandIndex": 0,
      "pyramidingPolicy": "MEAN"
    },
    {
      "id": "QA",
      "tilesetBandIndex": 1,
      "pyramidingPolicy": "SAMPLE"
    }
  ]
}

শুরু এবং শেষ হওয়ার সময়

ডেটার আরও প্রসঙ্গ দিতে সব অ্যাসেটের শুরু ও শেষ হওয়ার সময় উল্লেখ করতে হবে, বিশেষ করে সেগুলি যদি সংগ্রহে অন্তর্ভুক্ত থাকে। এইসব ফিল্ডের প্রয়োজন নেই, তবে আমরা সাজেস্ট করি যে সম্ভব হলে এগুলি ব্যবহার করুন।

শুরু ও শেষ হওয়ার সময় বলতে সাধারণত পর্যবেক্ষণের সময়কে বোঝায়, সোর্স ফাইল তৈরি হওয়ার সময়কে নয়।

সহজ করার জন্য শেষ হওয়ার সময়কে এক্সক্লুসিভ বাউন্ডারি হিসেবে বিবেচনা করা হয়। যেমন, ঠিক একদিনের জন্য অ্যাসেট থাকলে, শুরু ও শেষ হওয়ার সময় হিসেবে পরপর দুই দিনের মধ্যরাত (যেমন, 1980-01-31T00:00:00 এবং 1980-02-01T00:00:00) ব্যবহার করুন। অ্যাসেটের কোনও সময়সীমা না থাকলে, শেষ হওয়ার সময় শুরুর সময়ের সমান হিসেবে সেট করুন। ম্যানিফেস্টে সময় ISO 8601 স্ট্রিং হিসেবে দেখান। তারিখের ভ্যালু সহজ করার জন্য আমরা সাজেস্ট করি যে শেষ হওয়ার সময় এক্সক্লুসিভ (যেমন, দৈনিক অ্যাসেটের জন্য পরের দিনের মধ্যরাত) হিসেবে ধরে নিন।

উদাহরণ:

{
  "name": "projects/some-project-id/assets/some-asset-id",
  "tilesets": [
    {
      "sources": [
        {
          "uris": [
            "gs://bucket/img_20190612.tif"
          ]
        }
      ]
    }
  ],
  "startTime": "1980-01-31T00:00:00Z",
  "endTime": "1980-02-01T00:00:00Z"
}

ম্যানিফেস্ট স্ট্রাকচার রেফারেন্স

নিম্নলিখিত JSON স্ট্রাকচারে সব সম্ভাব্য ছবি আপলোড ম্যানিফেস্ট ফিল্ড অন্তর্ভুক্ত আছে। নিম্নলিখিত ম্যানিফেস্ট ফিল্ডের সংজ্ঞা বিভাগে ফিল্ডের সংজ্ঞা খুঁজুন।

{
  "name": <string>,
  "tilesets": [
    {
      "dataType": <string>,
      "id": <string>,
      "crs": <string>,
      "sources": [
        {
          "uris": [
            <stringn>>
          ],
          "affineTransform": {
            "scaleX": <double>,
            "shearX": <double>,
            "translateX": <double>,
            "shearY": <double>,
            "scaleY": <double>,
            "translateY": <double>
          }
        }
      ]
    }
  ],
  "bands": [
    {
      "id": <string>,
      "tilesetId": <string>,
      "tilesetBandIndex": <int32>,
      "missingData": {
        "values": [<doublen>>]
      },
      "pyramindingPolicy": <string>
    }
  ],
  "maskBands": [
    {
      "tilesetId": <string>,
      "bandIds": [
        <stringn>>
      ]
    }
  ],
  "footprint": {
    "points": [
      {
        "x": <double>,
        "y": <doublen>>
      }
    ],
    "bandId": <string>
  },
  "missingData": {
     "values": [<double>]
  },
  "pyramidingPolicy": <string>,
  "uriPrefix": <string>,
  "startTime": {
    "seconds": <integer>
  },
  "endTime": {
    "seconds": <integer>
  },
  "properties": {
    <unspecified>
  }
}

ম্যানিফেস্ট ফিল্ডের সংজ্ঞা

নাম

string

যে অ্যাসেট তৈরি করা হবে তার নাম। name "projects/*/assets/**" ফর্ম্যাটে আছে (যেমন, "projects/earthengine-legacy/assets/users/USER/ASSET")।

টাইলসেট

list

ডিকশনারির তালিকা যা টাইল সেটের জন্য প্রপার্টি নির্ধারণ করে। আরও তথ্যের জন্য নিম্নলিখিত tilesets ডিকশনারি এলিমেন্ট ফিল্ড দেখুন।

tilesets[i].dataType

string

ডেটার সংখ্যাসূচক ডেটার ধরন নির্দিষ্ট করে। ডিফল্ট হল GDAL যে ধরনের রিপোর্ট করে, যে ক্ষেত্রে সংজ্ঞায়িত করার প্রয়োজন নেই।

ডেটার ধরন ভ্যালু
অনির্দিষ্ট "DATA_TYPE_UNSPECIFIED"
৮-বিট সাইনড ইন্টিজার "INT8"
৮-বিট আনসাইনড ইন্টিজার "UINT8"
১৬-বিট সাইনড ইন্টিজার "INT16"
১৬-বিট আনসাইনড ইন্টিজার "UINT16"
৩২-বিট সাইনড ইন্টিজার "INT32"
৩২-বিট আনসাইনড ইন্টিজার "UINT32"
32-bit float "FLOAT32"
64-বিট ফ্লোট "FLOAT64"

tilesets[i].id

string

টাইলসেটের আইডি। অ্যাসেট ম্যানিফেস্টে উল্লেখ করা টাইলসেটের মধ্যে অনন্য হতে হবে। প্রসেসিংয়ের সময় এই আইডি বাতিল করা হয়; এটি শুধুমাত্র ব্যান্ডে টাইলসেট লিঙ্ক করার জন্য ব্যবহার করা হয়। খালি স্ট্রিং হল একটি সঠিক আইডি।

tilesets[i].crs

string

পিক্সেল গ্রিডের কোঅর্ডিনেট রেফারেন্স সিস্টেম, যেখানে সম্ভব সেখানে স্ট্যান্ডার্ড কোড হিসেবে নির্দিষ্ট করা হয়েছে (যেমন, EPSG কোড), এবং অন্যথায় WKT ফর্ম্যাটে।

tilesets[i].sources

list

একটি ছবির ফাইল এবং তার সাইডকারের বৈশিষ্ট্য সংজ্ঞায়িত করে এমন অভিধানের একটি তালিকা। আরও তথ্যের জন্য নিম্নলিখিত sources ডিকশনারি এলিমেন্ট ফিল্ড দেখুন।

tilesets[i].sources[j].uris

list

ইনজেস্ট করার জন্য ডেটার URI-এর তালিকা। শুধুমাত্র Google Cloud Storage URI কাজ করে। প্রতিটি URI নিম্নলিখিত ফর্ম্যাটে উল্লেখ করতে হবে: gs://bucket-id/object-id. প্রাথমিক অবজেক্টটি তালিকার প্রথম এলিমেন্ট হতে হবে এবং সাইডকারগুলি পরে তালিকাভুক্ত করতে হবে। সেট করা থাকলে, প্রতিটি URI-এর আগে ImageManifest.uriPrefix থাকে।

tilesets[i].sources[j].affineTransform

dictionary

একটি ঐচ্ছিক অ্যাফাইন ট্রান্সফর্ম। পিক্সেল প্লেস করার জন্য uris (যেকোনও সাইডকার সহ) থেকে পাওয়া ডেটা পর্যাপ্ত না হলে তবেই এটি উল্লেখ করতে হবে। নিম্নলিখিত কী সহ ডিকশনারি হিসেবে প্রদান করা হয়েছে: "scaleX", "shearX", "translateX", "shearY", "scaleY", "translateY"। আরও তথ্যের জন্য এই রেফারেন্স দেখুন।

উদাহরণ হিসেবে দেওয়া কী ও ভ্যালু:

{
  "scaleX": 0.1,
  "shearX": 0.0,
  "translateX": -180.0,
  "shearY": 0.0,
  "scaleY": -0.1,
  "translateY": 90.0
}

ব্যান্ড

list

টাইলসেট থেকে সোর্স করা একটি ব্যান্ডের প্রপার্টি সংজ্ঞায়িত করে এমন ডিকশনারির তালিকা। মনে রাখবেন, অ্যাসেটের ব্যান্ড অর্ডার bands-এর অর্ডারের মতোই। আরও তথ্যের জন্য নিম্নলিখিত bands ডিকশনারি এলিমেন্ট ফিল্ড দেখুন।

bands[i].id

string

ব্যান্ডের আইডি (নাম)।

bands[i].tilesetId

string

ব্যান্ডের সাথে সম্পর্কিত টাইলসেটের আইডি।

bands[i].tilesetBandIndex

int32

ব্যান্ডের সাথে সম্পর্কিত টাইলসেট থেকে শূন্য-ভিত্তিক ব্যান্ড ইন্ডেক্স।

bands[i].missingData.values

list

ভ্যালুর তালিকা (ডবল টাইপ) যা ব্যান্ডে কোনও ডেটা দেখায় না।

bands[i].pyramidingPolicy

string

পিরামিডিং নীতি। আরও তথ্যের জন্য এই লিঙ্ক দেখুন। বিকল্পগুলি হল:

  • "MEAN" (ডিফল্ট)
  • "মোড"
  • "স্যাম্পেল"

maskBands

list

টাইলসেট থেকে সোর্স করা একটি মাস্ক ব্যান্ডের প্রপার্টি সংজ্ঞায়িত করে এমন ডিকশনারির তালিকা। সর্বাধিক ১টি মাস্ক ব্যান্ড প্রদান করা যেতে পারে। আরও তথ্যের জন্য নিম্নলিখিত maskBands ডিকশনারি এলিমেন্ট ফিল্ড দেখুন।

maskBands[i].tilesetId

string

মাস্ক ব্যান্ডের সাথে সম্পর্কিত টাইলসেটের আইডি। টাইলসেটের শেষ ব্যান্ডটি সবসময় মাস্ক ব্যান্ড হিসেবে ব্যবহার করা হয়।

maskBands[i].bandIds

list of strings

মাস্ক ব্যান্ড প্রযোজ্য হয় এমন ব্যান্ডের আইডির তালিকা। খালি থাকলে, অ্যাসেটের সব ব্যান্ডে মাস্ক ব্যান্ড প্রয়োগ করা হয়। প্রতিটি ব্যান্ডের সাথে শুধুমাত্র একটি মাস্ক ব্যান্ড থাকতে পারে।

ফুটপ্রিন্ট

dictionary

একটি ডিকশনারি যা কোনও ছবির সমস্ত বৈধ পিক্সেলের ফুটপ্রিন্টের বৈশিষ্ট্যগুলিকে সংজ্ঞায়িত করে। ফাঁকা থাকলে, ডিফল্ট ফুটপ্রিন্ট হল সম্পূর্ণ ছবি। আরও তথ্যের জন্য নিম্নলিখিত footprint ডিকশনারি এলিমেন্ট ফিল্ড দেখুন।

footprint.points

list

একটি ছবিতে সমস্ত বৈধ পিক্সেলের ফুটপ্রিন্ট সংজ্ঞায়িত করে এমন পয়েন্টের একটি তালিকা। একটি পয়েন্ট "x" এবং "y" কী সহ একটি ডিকশনারি দ্বারা সংজ্ঞায়িত করা হয় যার ফ্লোট ভ্যালু রয়েছে। পয়েন্টের একটি তালিকা একটি রিংকে বর্ণনা করে যা একটি সাধারণ বহুভুজের বাইরের অংশ গঠন করে যাতে অবশ্যই ছবির সমস্ত সঠিক পিক্সেলের কেন্দ্র থাকতে হবে। এটি অবশ্যই একটি লিনিয়ার রিং হতে হবে: শেষ পয়েন্টটি প্রথমটির সমান হতে হবে। স্থানাঙ্কগুলি bandId দ্বারা নির্দিষ্ট করা ব্যান্ডের প্রজেকশনে রয়েছে।

মনে রাখবেন: প্রতিটি পিক্সেলের কেন্দ্রের মতো নন-ইন্টিজার কোঅর্ডিনেট ব্যবহার করুন কারণ footprint-কে পিক্সেল অন্তর্ভুক্ত করার জন্য নেওয়া হয় যদি পিক্সেল (একটি ১x১ আয়তক্ষেত্র) ফুটপ্রিন্টকে ইন্টারসেক্ট করে। ভুল করে আশেপাশের পিক্সেল বেছে নেওয়া এড়াতে, পূর্ণসংখ্যা-মানের কোঅর্ডিনেট ব্যবহার করবেন না, কারণ সেগুলি হল পিক্সেলের মধ্যেকার সীমানা। পিক্সেল সেন্টারের সাথে ফুটপ্রিন্ট আঁকলে অনিচ্ছাকৃত পিক্সেল অন্তর্ভুক্ত করা আটকানো যায়, যা ইচ্ছাকৃত পিক্সেল অ্যান্টিমেরিডিয়ান বা মেরুর মতো ম্যাপের সীমানার সাথে লেগে থাকলে সমস্যা সৃষ্টি করতে পারে।

যেমন, চারটি সঠিক পিক্সেল সহ ২x২ ছবির জন্য, নিম্নলিখিতটি হল একটি সম্ভাব্য রিং:

[
  {
    "x": 0.5,
    "y": 0.5
  },
  {
    "x": 0.5,
    "y": 1.5
  },
  {
    "x": 1.5,
    "y": 1.5
  },
  {
    "x": 1.5,
    "y": 0.5
  },
  {
    "x": 0.5,
    "y": 0.5
  }
]

footprint.bandId

string

ব্যান্ডের আইডি যার CRS ফুটপ্রিন্টের কোঅর্ডিনেট নির্ধারণ করে। খালি থাকলে, প্রথম ব্যান্ড ব্যবহার করা হয়।

missingData.values

list

মানের তালিকা (ডবল টাইপ) যা ছবির সব ব্যান্ডে কোনও ডেটা দেখায় না। যেসব ব্যান্ড তাদের নিজস্ব missingData উল্লেখ করে না, তাদের সকলের ক্ষেত্রে প্রযোজ্য।

pyramidingPolicy

string

পিরামিডিং নীতি। অনির্দিষ্ট থাকলে, সাধারণত "MEAN" নীতি প্রয়োগ করা হয়। যেসব ব্যান্ড নিজেদের ব্যান্ড উল্লেখ করে না, তাদের ক্ষেত্রে প্রযোজ্য। আরও তথ্যের জন্য এই লিঙ্ক দেখুন। বিকল্পগুলি হল:

  • "MEAN" (ডিফল্ট)
  • "মোড"
  • "স্যাম্পেল"

uriPrefix

string

ম্যানিফেস্টে উল্লেখ করা সব uris-এর আগে একটি ঐচ্ছিক প্রিফিক্স যোগ করা হয়।

startTime

integer

অ্যাসেটের সাথে যুক্ত টাইমস্ট্যাম্প, যদি থাকে। এটি সাধারণত সেই সময়কে বোঝায় যখন স্যাটেলাইট ইমেজ তোলা হয়েছিল। যেসব অ্যাসেট কোনও সময়সীমার সাথে সম্পর্কিত, যেমন এক মাস বা এক বছরের গড় ভ্যালু, এই টাইমস্ট্যাম্প সেই সময়সীমার শুরুর সাথে সম্পর্কিত। যুগ (০১-০১-১৯৭০) থেকে সেকেন্ড এবং (ঐচ্ছিক) ন্যানোসেকেন্ড হিসেবে নির্দিষ্ট করা হয়েছে। UTC টাইম জোনে আছে বলে ধরে নেওয়া হয়েছে।

endTime

integer

যেসব অ্যাসেট কোনও সময়সীমার সাথে সম্পর্কিত, যেমন এক মাস বা এক বছরের গড় ভ্যালু, সেইসব ক্ষেত্রে এই টাইমস্ট্যাম্প সেই সময়সীমার শেষ (এক্সক্লুসিভ) সম্পর্কিত। যুগ (০১-০১-১৯৭০) থেকে সেকেন্ড এবং (ঐচ্ছিক) ন্যানোসেকেন্ড হিসেবে নির্দিষ্ট করা হয়েছে। UTC টাইম জোনে আছে বলে ধরে নেওয়া হয়েছে।

প্রপার্টি

dictionary

কী-ভ্যালু পেয়ারের একটি ইচ্ছামতো ফ্ল্যাট ডিকশনারি। কী অবশ্যই স্ট্রিং হতে হবে এবং ভ্যালু হয় সংখ্যা অথবা স্ট্রিং হতে পারে। ব্যবহারকারীর আপলোড করা অ্যাসেটের জন্য তালিকার মান এখনও কাজ করে না।

সীমাবদ্ধতা

JSON ম্যানিফেস্ট সাইজ

JSON ম্যানিফেস্ট ফাইলের সাইজের সীমা হল ১০ এমবি। আপলোড করার জন্য আপনার কাছে অনেক ফাইল থাকলে, ডেটাসেট বর্ণনা করার জন্য প্রয়োজনীয় অক্ষরের সংখ্যা কমানোর উপায় বিবেচনা করুন। যেমন, uris তালিকায় প্রতিটি URI-এর জন্য Google Cloud বাকেট পাথ দেওয়ার প্রয়োজনীয়তা এড়াতে uriPrefix ফিল্ড ব্যবহার করুন। আরও সাইজ কমানোর প্রয়োজন হলে, ফাইলের নাম ছোট করে দেখুন।

ছবির ফাইলের ফর্ম্যাট

প্রতিটি ছবির ফাইল TIFF ছবি হতে হবে। ম্যানিফেস্টে CRS উল্লেখ করা না থাকলে, ফাইলটি অবশ্যই এম্বেড করা CRS সহ GeoTIFF হতে হবে।

TIFF ফাইল DEFLATE, JPEG-XL/JXL, LERC, LERC_DEFLATE, LERC_ZSTD, LZMA, LZW, WEBP, বা ZSTD-এর মাধ্যমে কম্প্রেস করা যেতে পারে।

বড় ফাইল আপলোড করার সেরা অভিজ্ঞতার জন্য সাজেশন:

  • সেরা বিকল্প: ZSTD স্পিড ও কম্প্রেশনের মধ্যে ভালো ব্যালেন্স অফার করে।
  • এড়িয়ে চলুন: LZMA-তে ভালো কম্প্রেশন হলেও এটি খুব ধীরগতির হতে পারে।
  • আনকমপ্রেসড ফাইল: এর ফলে ফাইলের সাইজ বড় হবে এবং আপলোড করতে বেশি সময় লাগবে।
  • লসি কম্প্রেশন (যেমন, JPEG): পিক্সেল ভ্যালু পরিবর্তন করতে পারে। আপনার ডেটার উপর সম্ভাব্য প্রভাব সম্পর্কে না বুঝলে, lossless কম্প্রেশন (যেমন, DEFLATE, LZMA, LZW, ZSTD) ব্যবহার করুন।