.\" 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 "GDAL-RASTER-COMPARE" "1" "Aug 18, 2026" "" "GDAL" .SH "نام (NAME)" gdal-raster-compare \- مقایسه دو مجموعه‌داده رستر .sp افزوده‌شده در نسخه 3.12. .SH "خلاصه دستور (SYNOPSIS)" .INDENT 0.0 .INDENT 3.5 .sp .EX Usage: gdal raster compare [OPTIONS] Compare two raster datasets. Positional arguments: \-\-reference Reference dataset [required] \-i, \-\-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 = 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 formats [may be repeated] [not available in pipelines] \-\-oo, \-\-open\-option = Open options [may be repeated] [not available in pipelines] .EE .UNINDENT .UNINDENT .SH "توضیحات (DESCRIPTION)" .sp دستور \fBgdal raster compare\fP دو مجموعه‌داده پشتیبانی‌شده توسط GDAL را مقایسه کرده و تفاوت‌ها را گزارش می‌دهد. علاوه بر گزارش تفاوت‌ها در خروجی استاندارد، برنامه تعداد تفاوت‌ها را در مقدار وضعیت خروج خود نیز برمی‌گرداند. .sp به عنوان یک قاعده کلی، فرض می‌شود نخستین مجموعه‌داده مشخص‌شده به عنوان آرگومان موضعی یا از طریق \fI\%\-\-reference\fP، مجموعه‌داده مرجع/دقیق/اصلی است. مجموعه‌داده دوم مشخص‌شده به عنوان آرگومان موضعی یا از طریق \fI\%\-\-input\fP، مجموعه‌داده‌ای است که با مجموعه‌داده مرجع مقایسه می‌شود. .sp پیکسل‌های تصویر و فراداده‌های گوناگون بررسی می‌شوند. همچنین مقایسه‌ای بایت به بایت انجام می‌شود که به عنوان یک تفاوت محاسبه خواهد شد. بنابراین، اگر تنها یکسان بودن داده‌های قابل مشاهده GDAL اهمیت دارد، تعداد تفاوت 1 (تفاوت باینری) باید قابل قبول در نظر گرفته شود، یا می‌توانید گزینه \fI\%\-\-skip\-binary\fP را برای صرف‌نظر کردن از مقایسه بایت به بایت تعیین کنید. .sp این برنامه می‌تواند به عنوان آخرین مرحله یک خط لوله رستر (\fI\%raster pipeline\fP) نیز به کار رود. .sp گزینه‌های زیر در دسترس هستند: .SH "گزینه‌های اختصاصی برنامه (PROGRAM-SPECIFIC OPTIONS)" .INDENT 0.0 .TP .B \-\-input مجموعه‌داده‌ای که با مجموعه‌داده مرجع مقایسه می‌شود، که با عنوان مجموعه‌داده ورودی نامیده می‌شود. .UNINDENT .INDENT 0.0 .TP .B \-\-reference مجموعه‌داده‌ای که صحیح و مبنا در نظر گرفته می‌شود، که با عنوان مجموعه‌داده مرجع شناخته می‌شود. .UNINDENT .INDENT 0.0 .TP .B \-\-skip\-all\-optional صرف‌نظر کردن از تمام آزمون‌های اختیاری. این گزینه نام مستعاری برای تعیین تمامی گزینه‌های دیگر \fB\-\-skip\-XXXX\fP است. .sp آزمون‌های غیراختیاری باقی‌مانده عبارتند از: .INDENT 7.0 .IP \(bu 2 بررسی عرض، ارتفاع و تعداد باندهای مجموعه‌داده .IP \(bu 2 بررسی شرح باند، نوع داده، تفسیر رنگ و مقدار nodata .IP \(bu 2 بررسی محتوای پیکسل‌ها .UNINDENT .UNINDENT .INDENT 0.0 .TP .B \-\-skip\-binary صرف‌نظر کردن از مقایسه دقیق محتوای باینری (دودویی). .UNINDENT .INDENT 0.0 .TP .B \-\-skip\-crs صرف‌نظر کردن از مقایسه سیستم‌های مرجع مختصات (CRS). .UNINDENT .INDENT 0.0 .TP .B \-\-skip\-geolocation صرف‌نظر کردن از مقایسه دامنه فراداده GEOLOCATION. .UNINDENT .INDENT 0.0 .TP .B \-\-skip\-geotransform صرف‌نظر کردن از مقایسه ماتریس تبدیل مختصات جغرافیایی (geotransform). .UNINDENT .INDENT 0.0 .TP .B \-\-skip\-metadata صرف‌نظر کردن از مقایسه فراداده (متادیتا). .UNINDENT .INDENT 0.0 .TP .B \-\-skip\-overview صرف‌نظر کردن از مقایسه پیش‌نمایش‌ها (overviews). .UNINDENT .INDENT 0.0 .TP .B \-\-skip\-rpc صرف‌نظر کردن از مقایسه دامنه فراداده ضرایب چندجمله‌ای منطقی (RPC). .UNINDENT .INDENT 0.0 .TP .B \-\-skip\-subdataset صرف‌نظر کردن از مقایسه تمامی زیرمجموعه‌داده‌هایی که بخشی از مجموعه‌داده هستند. .UNINDENT .SH "گزینه‌های استاندارد (STANDARD OPTIONS)" .INDENT 0.0 .TP .B \-\-if, \-\-input\-format نام قالب/درایور مورد تلاش برای باز کردن فایل(های) ورودی. معمولاً نیازی به مشخص کردن آن نیست، اما می‌توان از آن برای صرف‌نظر کردن از تشخیص خودکار درایور، در مواقعی که در انتخاب درایور مناسب ناموفق است، استفاده کرد. این گزینه را می‌توان برای مشخص کردن چندین درایور کاندید چندین بار تکرار کرد. توجه داشته باشید که این گزینه آن درایورها را مجبور به باز کردن مجموعه‌داده نمی‌کند؛ به‌ویژه برخی درایورها نیازمندی‌هایی برای پسوند فایل دارند. .sp قابل تکرار است. .UNINDENT .INDENT 0.0 .TP .B \-\-oo, \-\-open\-option = گزینه باز کردن مجموعه‌داده (وابسته به قالب). .sp قابل تکرار است. .UNINDENT .SH "کد وضعیت بازگشتی (RETURN STATUS CODE)" .sp برنامه در صورت موفقیت کد وضعیت 0، و در صورت بروز خطا مقداری غیرصفر برمی‌گرداند (خطاهای غیرمسدودکننده که به صورت هشدار صادر می‌شوند به عنوان اجرای موفق در نظر گرفته می‌شوند). .SH "مثال‌ها (EXAMPLES)" .SS مثال ۱: مقایسه دو مجموعه‌داده که نوع داده متفاوتی دارند .INDENT 0.0 .INDENT 3.5 .sp .EX $ 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 .EE .UNINDENT .UNINDENT .SS مثال ۲: مقایسه دو مجموعه‌داده در شرایطی که مقادیر دارای واحدهای متفاوتی هستند .INDENT 0.0 .INDENT 3.5 .sp .EX $ gdal raster pipeline read test_in_foot.tif ! calc \-\-calc \(dqX * 0.3048\(dq ! compare \-\-reference=reference_in_meter.tif .EE .UNINDENT .UNINDENT .SH "نویسنده (AUTHOR)" Even Rouault .SH "حق نشر (COPYRIGHT)" 1998-2026 .\" Generated by docutils manpage writer. .