نام (NAME)

ncmpidiff - مقایسه موازی دو فایل netCDF

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

mpiexec -n np ncmpidiff [-b] [-q] [-h] [-v var1,...,varn] [-t diff,ratio] file1 file2

توضیحات (DESCRIPTION)

دستور ncmpidiff به‌صورت موازی روی تعداد np فرایند MPI اجرا می‌شود تا محتویات دو فایل را با یکدیگر مقایسه کرده و نخستین تفاوت را در خروجی استاندارد گزارش کند.

برای متغیرها و مشخصه‌ها، در صورت عدم استفاده از گزینه -t، اندیس‌های آرایه‌ای نخستین عنصری که دارای تفاوت باشد گزارش می‌شود. هنگامی که از گزینه -t استفاده شود، عنصری با بیشترین اختلاف که شرایط تلورانس (آستانه تحمل خطا) را برآورده نکند گزارش خواهد شد.

اگر علاوه بر نام دو فایل، هیچ‌کدام از آرگومان‌های -v یا -h داده نشوند، کل فایل‌ها با یکدیگر مقایسه می‌شوند.

هنگام مقایسه کامل دو فایل، تفاوت میان ncmpidiff و دستور یونیکس diff این است که ncmpidiff از فاصله‌های خالی (شکاف‌های) میان متغیرها صرف‌نظر می‌کند. این شکاف‌ها ممکن است هنگام استفاده از قابلیت ترازسازی (هم‌ترازی) جهت ساخت یک فایل جدید رخ دهند. این ترازسازی امکان تخصیص فضای بزرگ‌تر برای هدر فایل و تراز کردن آفست‌های شروع فایلی متغیرهای با اندازه ثابت را فراهم می‌کند (رابط برنامه‌نویسی ncmpi__enddef و PnetCDF hints را ببینید). در بیشتر موارد، محتوای این شکاف‌ها بایت‌های دلخواه غیرصفر هستند. بنابراین، دو فایل netCDF (با اندازه یکسان یا متفاوت) ممکن است توسط ncmpidiff یکسان گزارش شوند در حالی که توسط diff یکسان تلقی نشوند.

گزینه‌ها (OPTIONS)

-b

حالت پرجزئیات - چاپ نتایج (یکسان یا متفاوت) برای تمام بخش‌ها (فایل، هدر، یا متغیرها) در مقایسه.

-q

حالت بی‌صدا - چاپ نشدن هیچ پیامی در خروجی خط فرمان. این گزینه همچنین حالت پرجزئیات را غیرفعال می‌کند. در حالت بی‌صدا، کاربران باید وضعیت خروج را بررسی کنند. بخش «وضعیت خروج (EXIT STATUS)» در ادامه را ببینید.

-h

تنها مقایسه هدر فایل.

-v var1,...,varn

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

-t diff,ratio

مقایسه عنصر به عنصر متغیرها با در نظر گرفتن تلورانس (مقادیر diff و ratio با کاما و بدون فاصله جدا می‌شوند). diff مقدار مطلق اختلاف عنصر به عنصر دو متغیر با نام یکسان اما ذخیره‌شده در دو فایل ورودی است. ratio نسبت اختلاف نسبی عنصر به عنصر است که به‌صورت |x - y|/max(|x|, |y|) تعریف می‌شود؛ به طوری که x عنصری از آرایه متغیر در فایل نخست و y عنصر متناظر در همان متغیر از فایل دوم است. |x| نشان‌دهنده مقدار مطلق x است. توجه داشته باشید هنگام استفاده از این گزینه، خروجی تنها نخستین عنصر آرایه‌ای را گزارش می‌کند که موفق به برآورده کردن هر دو شرط تلورانس نشود.

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

وضعیت خروج 0 به معنای پیدا نشدن تفاوت است، و وضعیت 1 نشان‌دهنده یافتن تفاوت میان فایل‌ها است. توجه داشته باشید در سیستم‌های مبتنی بر VMS، مقادیر وضعیت خروج معکوس هستند.

همچنین ببینید (SEE ALSO)

ncmpidump(1), cdfdiff(1), diff(1), pnetcdf(3)

تاریخ (DATE)

۳۱ ژوئیه ۲۰۲۵