نام (NAME)

gdal-raster-compare - مقایسه دو مجموعه‌داده رستر

افزوده‌شده در نسخه 3.12.

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

Usage: gdal raster compare [OPTIONS] <REFERENCE> <INPUT>
Compare two raster datasets.
Positional arguments:
  --reference <REFERENCE>              Reference dataset [required]
  -i, --input <INPUT>                  Input raster dataset [required] [not available in pipelines]
Common Options:
  -h, --help                           Display help message and exit
  --json-usage                         Display usage as JSON document and exit
  --config <KEY>=<VALUE>               Configuration option [may be repeated]
  -q, --quiet                          Quiet mode (no progress bar or warning message) [not available in pipelines]
Options:
  --skip-all-optional                  Skip all optional comparisons
  --skip-binary                        Skip binary file comparison
  --skip-crs                           Skip CRS comparison
  --skip-geotransform                  Skip geotransform comparison
  --skip-overview                      Skip overview comparison
  --skip-metadata                      Skip metadata comparison
  --skip-rpc                           Skip RPC metadata comparison
  --skip-geolocation                   Skip Geolocation metadata comparison
  --skip-subdataset                    Skip subdataset comparison
Advanced Options:
  --if, --input-format <INPUT-FORMAT>  Input formats [may be repeated] [not available in pipelines]
  --oo, --open-option <KEY>=<VALUE>    Open options [may be repeated] [not available in pipelines]

توضیحات (DESCRIPTION)

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

به عنوان یک قاعده کلی، فرض می‌شود نخستین مجموعه‌داده مشخص‌شده به عنوان آرگومان موضعی یا از طریق --reference، مجموعه‌داده مرجع/دقیق/اصلی است. مجموعه‌داده دوم مشخص‌شده به عنوان آرگومان موضعی یا از طریق --input، مجموعه‌داده‌ای است که با مجموعه‌داده مرجع مقایسه می‌شود.

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

این برنامه می‌تواند به عنوان آخرین مرحله یک خط لوله رستر (raster pipeline) نیز به کار رود.

گزینه‌های زیر در دسترس هستند:

گزینه‌های اختصاصی برنامه (PROGRAM-SPECIFIC OPTIONS)

--input <input-dataset>: مجموعه‌داده‌ای که با مجموعه‌داده مرجع مقایسه می‌شود، که با عنوان مجموعه‌داده ورودی نامیده می‌شود.

--reference <reference-dataset>: مجموعه‌داده‌ای که صحیح و مبنا در نظر گرفته می‌شود، که با عنوان مجموعه‌داده مرجع شناخته می‌شود.

--skip-all-optional: صرف‌نظر کردن از تمام آزمون‌های اختیاری. این گزینه نام مستعاری برای تعیین تمامی گزینه‌های دیگر --skip-XXXX است.
آزمون‌های غیراختیاری باقی‌مانده عبارتند از:

بررسی عرض، ارتفاع و تعداد باندهای مجموعه‌داده
بررسی شرح باند، نوع داده، تفسیر رنگ و مقدار nodata
بررسی محتوای پیکسل‌ها

--skip-binary: صرف‌نظر کردن از مقایسه دقیق محتوای باینری (دودویی).

--skip-crs: صرف‌نظر کردن از مقایسه سیستم‌های مرجع مختصات (CRS).

--skip-geolocation: صرف‌نظر کردن از مقایسه دامنه فراداده GEOLOCATION.

--skip-geotransform: صرف‌نظر کردن از مقایسه ماتریس تبدیل مختصات جغرافیایی (geotransform).

--skip-metadata: صرف‌نظر کردن از مقایسه فراداده (متادیتا).

--skip-overview: صرف‌نظر کردن از مقایسه پیش‌نمایش‌ها (overviews).

--skip-rpc: صرف‌نظر کردن از مقایسه دامنه فراداده ضرایب چندجمله‌ای منطقی (RPC).

--skip-subdataset: صرف‌نظر کردن از مقایسه تمامی زیرمجموعه‌داده‌هایی که بخشی از مجموعه‌داده هستند.

گزینه‌های استاندارد (STANDARD OPTIONS)

--if, --input-format <format>: نام قالب/درایور مورد تلاش برای باز کردن فایل(های) ورودی. معمولاً نیازی به مشخص کردن آن نیست، اما می‌توان از آن برای صرف‌نظر کردن از تشخیص خودکار درایور، در مواقعی که در انتخاب درایور مناسب ناموفق است، استفاده کرد. این گزینه را می‌توان برای مشخص کردن چندین درایور کاندید چندین بار تکرار کرد. توجه داشته باشید که این گزینه آن درایورها را مجبور به باز کردن مجموعه‌داده نمی‌کند؛ به‌ویژه برخی درایورها نیازمندی‌هایی برای پسوند فایل دارند.
قابل تکرار است.

--oo, --open-option <NAME>=<VALUE>: گزینه باز کردن مجموعه‌داده (وابسته به قالب).
قابل تکرار است.

کد وضعیت بازگشتی (RETURN STATUS CODE)

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

مثال‌ها (EXAMPLES)

مثال ۱: مقایسه دو مجموعه‌داده که نوع داده متفاوتی دارند

$ gdal raster compare autotest/gcore/data/byte.tif autotest/gcore/data/uint16.tif
Reference file has size 736 bytes, whereas input file has size 1136 bytes.
Reference band 1 has data type Byte, but input band has data type UInt16
$ echo $?
2

مثال ۲: مقایسه دو مجموعه‌داده در شرایطی که مقادیر دارای واحدهای متفاوتی هستند

$ gdal raster pipeline read test_in_foot.tif ! calc --calc "X * 0.3048" ! compare --reference=reference_in_meter.tif

نویسنده (AUTHOR)

Even Rouault <even.rouault@spatialys.com>

حق نشر (COPYRIGHT)

1998-2026