نام (NAME)

gdalcompare - مقایسه دو تصویر

خلاصه دستور (SYNOPSIS)

gdalcompare [--help] [--help-general]
               [-dumpdiffs] [-skip_binary] [-skip_overviews]
               [-skip_geolocation] [-skip_geotransform]
               [-skip_metadata] [-skip_rpc] [-skip_srs]
               [-sds] <golden_file> <new_file>

توضیحات (DESCRIPTION)

gdalcompare دو مجموعه داده پشتیبانی‌شده توسط GDAL را مقایسه کرده و تفاوت‌ها را گزارش می‌دهد. علاوه بر گزارش تفاوت‌ها در خروجی استاندارد، این اسکریپت تعداد تفاوت‌ها را در مقدار وضعیت خروج خود نیز بازمی‌گرداند.

پیکسل‌های تصویر و متاداده‌های مختلف بررسی می‌شوند. همچنین یک مقایسه بایت‌به‌بایت انجام می‌شود که به عنوان یک تفاوت شمرده خواهد شد. بنابراین اگر تنها یکسان بودن داده‌های قابل مشاهده برای GDAL اهمیت داشته باشد، تعداد تفاوت ۱ (تفاوت باینری) باید قابل قبول در نظر گرفته شود.

نکته:

ابزار gdalcompare یک ابزار پایتونی است و تنها در صورتی در دسترس است که اتصالات پایتون GDAL (Python bindings) موجود باشند.

--help: نمایش این پیام راهنما و خروج

--help-general: نمایش پیامی مختصر درباره نحوه استفاده از گزینه‌های عمومی خط فرمان GDAL و خروج.

-dumpdiffs: در نسخه 3.8 اضافه شده است.
تعیین اینکه آیا تفاوت در محتوای پیکسلی در یک فایل TIFF در دایرکتوری جاری ذخیره شود یا خیر.

-skip_binary: در نسخه 3.8 اضافه شده است.
تعیین اینکه آیا از مقایسه دقیق محتوای باینری صرف‌نظر شود یا خیر.

-skip_overviews: در نسخه 3.8 اضافه شده است.
تعیین اینکه آیا از مقایسه نمای‌های کلی (overviews) صرف‌نظر شود یا خیر.

-skip_geolocation: در نسخه 3.8 اضافه شده است.
تعیین اینکه آیا از مقایسه دامنه متاداده GEOLOCATION صرف‌نظر شود یا خیر.

-skip_geotransform: در نسخه 3.8 اضافه شده است.
تعیین اینکه آیا از مقایسه ماتریس geotransform صرف‌نظر شود یا خیر.

-skip_metadata: در نسخه 3.8 اضافه شده است.
تعیین اینکه آیا از مقایسه متاداده‌ها صرف‌نظر شود یا خیر.

-skip_rpc: در نسخه 3.8 اضافه شده است.
تعیین اینکه آیا از مقایسه دامنه متاداده ضرایب چندجمله‌ای منطقی (RPC) صرف‌نظر شود یا خیر.

-skip_srs: در نسخه 3.8 اضافه شده است.
تعیین اینکه آیا از مقایسه سامانه‌های مرجع مکانی (SRS) صرف‌نظر شود یا خیر.

-sds: اگر این پرچم داده شود، اسکریپت تمام زیرمجموعه‌داده‌هایی (subdatasets) را که بخشی از مجموعه داده هستند مقایسه خواهد کرد؛ در غیر این صورت از زیرمجموعه‌داده‌ها صرف‌نظر می‌شود.

<golden_file>: فایلی که به عنوان مرجع درست در نظر گرفته می‌شود و با عنوان فایل طلایی (golden file) نامیده می‌شود.

<new_file>: فایلی که با فایل طلایی مقایسه می‌شود و با عنوان فایل جدید (new file) نامیده می‌شود.

توجه داشته باشید که اسکریپت gdalcompare (مانند سایر اسکریپت‌ها) می‌تواند به عنوان یک کتابخانه از داخل کد پایتون نیز فراخوانی شود: from osgeo_utils import gdalcompare. نقطه ورود اصلی تابع gdalcompare.compare_db() است که یک gdal.Dataset طلایی و یک gdal.Dataset جدید را به عنوان آرگومان دریافت کرده و تعداد تفاوت‌ها را (به استثنای مقایسه باینری) بازمی‌گرداند. از نقطه ورود gdalcompare.compare_sds() می‌توان برای مقایسه زیرمجموعه‌داده‌ها استفاده کرد.

وضعیت خروج (EXIT STATUS)

این برنامه در صورت موفقیت کد وضعیت 0 و در صورت بروز خطا مقداری غیر صفر بازمی‌گرداند (خطاهای غیرمسدودکننده که به صورت هشدار صادر می‌شوند به عنوان اجرای موفق در نظر گرفته می‌شوند).

مثال‌ها (EXAMPLES)

gdalcompare -dumpdiffs N.tiff S.tiff; echo $?
Files differ at the binary level.
Band 1 checksum difference:
  Golden: 36694
  New:    40645
  Pixels Differing: 1509
  Maximum Pixel Difference: 255.0
  Wrote Diffs to: 1.tif
Differences Found: 2
2
gdalcompare N.tiff N.tiff; echo $?
Differences Found: 0
0

نویسندگان (AUTHORS)

Frank Warmerdam <warmerdam@pobox.com>

کپی‌رایت و تکثیر (COPYRIGHT)

1998-2026