نام (NAME)

cdfdiff - مقایسه دو فایل کلاسیک netCDF به‌صورت موازی

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

cdfdiff [-b] [-q] [-h] [-v var1,...,varn] [-t diff,ratio] file1 file2

توضیحات (DESCRIPTION)

دستور cdfdiff، نسخه ترتیبی ncmpidiff، محتویات دو فایل کلاسیک netCDF را مقایسه کرده و نخستین تفاوت یافت‌شده را در خروجی استاندارد گزارش می‌دهد. قالب‌های کلاسیک فایل شامل CDF-1، CDF-2 و CDF-5 هستند.

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

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

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

گزینه‌ها (OPTIONS)

-b

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

-q

حالت بی‌صدا (Quiet) - هیچ چیزی در خروجی خط فرمان چاپ نمی‌شود. این گزینه همچنین حالت با جزئیات را غیرفعال می‌کند. در حالت بی‌صدا، کاربران باید وضعیت خروج را بررسی کنند. بخش "وضعیت خروج (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)

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

تاریخ (DATE)

۳۱ ژوئیه ۲۰۲۵