.\" Man page generated from reStructuredText.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "GDALCOMPARE" "1" "Aug 18, 2026" "" "GDAL"
.SH "نام (NAME)"
gdalcompare \- مقایسه دو تصویر
.SH "خلاصه دستور (SYNOPSIS)"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
gdalcompare [\-\-help] [\-\-help\-general]
               [\-dumpdiffs] [\-skip_binary] [\-skip_overviews]
               [\-skip_geolocation] [\-skip_geotransform]
               [\-skip_metadata] [\-skip_rpc] [\-skip_srs]
               [\-sds] <golden_file> <new_file>
.EE
.UNINDENT
.UNINDENT
.SH "توضیحات (DESCRIPTION)"
.sp
\fBgdalcompare\fP دو مجموعه داده پشتیبانی‌شده توسط GDAL را مقایسه کرده و
تفاوت‌ها را گزارش می‌دهد. علاوه بر گزارش تفاوت‌ها در
خروجی استاندارد، این اسکریپت تعداد تفاوت‌ها را در مقدار وضعیت خروج
خود نیز بازمی‌گرداند.
.sp
پیکسل‌های تصویر و متاداده‌های مختلف بررسی می‌شوند. همچنین یک مقایسه بایت‌به‌بایت
انجام می‌شود که به عنوان یک تفاوت شمرده خواهد شد. بنابراین اگر
تنها یکسان بودن داده‌های قابل مشاهده برای GDAL اهمیت داشته باشد، تعداد
تفاوت ۱ (تفاوت باینری) باید قابل قبول در نظر گرفته شود.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
ابزار gdalcompare یک ابزار پایتونی است و تنها در صورتی در دسترس است که اتصالات پایتون GDAL (Python bindings) موجود باشند.
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B \-\-help
نمایش این پیام راهنما و خروج
.UNINDENT
.INDENT 0.0
.TP
.B \-\-help\-general
نمایش پیامی مختصر درباره نحوه استفاده از گزینه‌های عمومی خط فرمان GDAL و خروج.
.UNINDENT
.INDENT 0.0
.TP
.B \-dumpdiffs
در نسخه 3.8 اضافه شده است.

.sp
تعیین اینکه آیا تفاوت در محتوای پیکسلی در یک فایل TIFF در
دایرکتوری جاری ذخیره شود یا خیر.
.UNINDENT
.INDENT 0.0
.TP
.B \-skip_binary
در نسخه 3.8 اضافه شده است.

.sp
تعیین اینکه آیا از مقایسه دقیق محتوای باینری صرف‌نظر شود یا خیر.
.UNINDENT
.INDENT 0.0
.TP
.B \-skip_overviews
در نسخه 3.8 اضافه شده است.

.sp
تعیین اینکه آیا از مقایسه نمای‌های کلی (overviews) صرف‌نظر شود یا خیر.
.UNINDENT
.INDENT 0.0
.TP
.B \-skip_geolocation
در نسخه 3.8 اضافه شده است.

.sp
تعیین اینکه آیا از مقایسه دامنه متاداده GEOLOCATION صرف‌نظر شود یا خیر.
.UNINDENT
.INDENT 0.0
.TP
.B \-skip_geotransform
در نسخه 3.8 اضافه شده است.

.sp
تعیین اینکه آیا از مقایسه ماتریس geotransform صرف‌نظر شود یا خیر.
.UNINDENT
.INDENT 0.0
.TP
.B \-skip_metadata
در نسخه 3.8 اضافه شده است.

.sp
تعیین اینکه آیا از مقایسه متاداده‌ها صرف‌نظر شود یا خیر.
.UNINDENT
.INDENT 0.0
.TP
.B \-skip_rpc
در نسخه 3.8 اضافه شده است.

.sp
تعیین اینکه آیا از مقایسه دامنه متاداده ضرایب چندجمله‌ای منطقی (RPC) صرف‌نظر شود یا خیر.
.UNINDENT
.INDENT 0.0
.TP
.B \-skip_srs
در نسخه 3.8 اضافه شده است.

.sp
تعیین اینکه آیا از مقایسه سامانه‌های مرجع مکانی (SRS) صرف‌نظر شود یا خیر.
.UNINDENT
.INDENT 0.0
.TP
.B \-sds
اگر این پرچم داده شود، اسکریپت تمام زیرمجموعه‌داده‌هایی (subdatasets) را که
بخشی از مجموعه داده هستند مقایسه خواهد کرد؛ در غیر این صورت از زیرمجموعه‌داده‌ها صرف‌نظر می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B <golden_file>
فایلی که به عنوان مرجع درست در نظر گرفته می‌شود و با عنوان فایل طلایی (golden file) نامیده می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B <new_file>
فایلی که با فایل طلایی مقایسه می‌شود و با عنوان فایل جدید (new file)
نامیده می‌شود.
.UNINDENT
.sp
توجه داشته باشید که اسکریپت \fBgdalcompare\fP (مانند سایر اسکریپت‌ها)
می‌تواند به عنوان یک کتابخانه از داخل کد پایتون نیز فراخوانی شود: \fIfrom osgeo_utils import gdalcompare\fP\&.
نقطه ورود اصلی تابع \fIgdalcompare.compare_db()\fP است که یک
\fIgdal.Dataset\fP طلایی و یک \fIgdal.Dataset\fP جدید را به عنوان آرگومان دریافت کرده و
تعداد تفاوت‌ها را (به استثنای مقایسه باینری) بازمی‌گرداند. از نقطه ورود
\fIgdalcompare.compare_sds()\fP می‌توان برای مقایسه
زیرمجموعه‌داده‌ها استفاده کرد.
.SH "وضعیت خروج (EXIT STATUS)"
.sp
این برنامه در صورت موفقیت کد وضعیت 0 و در صورت بروز
خطا مقداری غیر صفر بازمی‌گرداند (خطاهای غیرمسدودکننده که به صورت هشدار صادر می‌شوند به عنوان اجرای موفق
در نظر گرفته می‌شوند).
.SH "مثال‌ها (EXAMPLES)"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
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
.EE
.UNINDENT
.UNINDENT
.SH "نویسندگان (AUTHORS)"
Frank Warmerdam <warmerdam@pobox.com>
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
1998-2026
.\" Generated by docutils manpage writer.
.