.\" $Header$
.nr yr \n(yr+1900
.af mo 01
.af dy 01
.TH ncmpidiff 1 "PnetCDF 1.14.1" "Printed: \n(yr-\n(mo-\n(dy" "PnetCDF utilities"
.SH "نام (NAME)"
ncmpidiff \- مقایسه موازی دو فایل netCDF
.SH "خلاصه دستور (SYNOPSIS)"
.ft B
.HP
mpiexec -n np ncmpidiff
.nh
\%[-b]
\%[-q]
\%[-h]
\%[-v var1,...,varn]
\%[-t diff,ratio]
\%\fIfile1 file2\fP
.hy
.ft
.SH "توضیحات (DESCRIPTION)"
دستور
.B ncmpidiff
به‌صورت موازی روی تعداد np فرایند MPI اجرا می‌شود تا محتویات دو فایل را با یکدیگر مقایسه کرده و نخستین تفاوت را در خروجی استاندارد گزارش کند.
.PP
برای متغیرها و مشخصه‌ها، در صورت عدم استفاده از گزینه
.BR \-t ،
اندیس‌های آرایه‌ای نخستین عنصری که دارای تفاوت باشد گزارش می‌شود. هنگامی که از گزینه
.B \-t
استفاده شود، عنصری با بیشترین اختلاف که شرایط تلورانس (آستانه تحمل خطا) را برآورده نکند گزارش خواهد شد.
.PP
اگر علاوه بر نام دو فایل، هیچ‌کدام از آرگومان‌های
.B \-v
یا
.B \-h
داده نشوند، کل فایل‌ها با یکدیگر مقایسه می‌شوند.
.PP
هنگام مقایسه کامل دو فایل، تفاوت میان
.B ncmpidiff
و دستور یونیکس
.B diff
این است که
.B ncmpidiff
از فاصله‌های خالی (شکاف‌های) میان متغیرها صرف‌نظر می‌کند. این شکاف‌ها ممکن است هنگام استفاده از قابلیت ترازسازی (هم‌ترازی) جهت ساخت یک فایل جدید رخ دهند. این ترازسازی امکان تخصیص فضای بزرگ‌تر برای هدر فایل و تراز کردن آفست‌های شروع فایلی متغیرهای با اندازه ثابت را فراهم می‌کند (رابط برنامه‌نویسی
.B ncmpi__enddef
و
.B PnetCDF hints
را ببینید). در بیشتر موارد، محتوای این شکاف‌ها بایت‌های دلخواه غیرصفر هستند. بنابراین، دو فایل netCDF (با اندازه یکسان یا متفاوت) ممکن است توسط
.B ncmpidiff
یکسان گزارش شوند در حالی که توسط
.B diff
یکسان تلقی نشوند.
.SH "گزینه‌ها (OPTIONS)"
.IP "\fB-b\fP"
حالت پرجزئیات \- چاپ نتایج (یکسان یا متفاوت) برای تمام بخش‌ها (فایل، هدر، یا متغیرها) در مقایسه.
.IP "\fB-q\fP"
حالت بی‌صدا \- چاپ نشدن هیچ پیامی در خروجی خط فرمان. این گزینه همچنین حالت پرجزئیات را غیرفعال می‌کند. در حالت بی‌صدا، کاربران باید وضعیت خروج را بررسی کنند. بخش «وضعیت خروج (EXIT STATUS)» در ادامه را ببینید.
.IP "\fB-h\fP"
تنها مقایسه هدر فایل.
.IP "\fB-v\fP var1,...,varn"
تنها مقایسه فهرست مشخص‌شده از متغیرها (نام‌ها با کاما و بدون فاصله از یکدیگر جدا می‌شوند).
.IP "\fB-t\fP diff,ratio"
مقایسه عنصر به عنصر متغیرها با در نظر گرفتن تلورانس (مقادیر diff و ratio با کاما و بدون فاصله جدا می‌شوند).
.I diff
مقدار مطلق اختلاف عنصر به عنصر دو متغیر با نام یکسان اما ذخیره‌شده در دو فایل ورودی است.
.I ratio
نسبت اختلاف نسبی عنصر به عنصر است که به‌صورت |x - y|/max(|x|, |y|) تعریف می‌شود؛ به طوری که x عنصری از آرایه متغیر در فایل نخست و y عنصر متناظر در همان متغیر از فایل دوم است. |x| نشان‌دهنده مقدار مطلق x است. توجه داشته باشید هنگام استفاده از این گزینه، خروجی تنها نخستین عنصر آرایه‌ای را گزارش می‌کند که موفق به برآورده کردن هر دو شرط تلورانس نشود.
.SH "وضعیت خروج (EXIT STATUS)"
وضعیت خروج 0 به معنای پیدا نشدن تفاوت است، و وضعیت 1 نشان‌دهنده یافتن تفاوت میان فایل‌ها است. توجه داشته باشید در سیستم‌های مبتنی بر VMS، مقادیر وضعیت خروج معکوس هستند.
.SH "همچنین ببینید (SEE ALSO)"
.LP
.BR ncmpidump (1),
.BR cdfdiff (1),
.BR diff (1),
.BR pnetcdf (3)
.SH "تاریخ (DATE)"
۳۱ ژوئیه ۲۰۲۵
.LP