نام (NAME)

ncoffsets - چاپ آفست‌های آغازین و پایانی فایل برای متغیرهای netCDF

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

ncoffsets [-h] | [-x] | [-sgr] [-v var1[,...]] file

توضیحات (DESCRIPTION)

دستور ncoffsets اطلاعات آفست فایل متغیرهای تعریف‌شده در یک فایل مشخص netCDF را چاپ می‌کند. آفست پایانی گزارش‌شده یک آفست انحصاری (exclusive) است، یعنی ۱ بایت بیشتر از آخرین بایتی است که توسط متغیر اشغال شده است. به عبارت دیگر، آفست پایانی برابر است با مجموع آفست آغازین و اندازه متغیر. برای متغیرهای رکوردی (record variables)، تنها آفست‌های رکورد نخست چاپ می‌شوند. گزینه -r را برای چاپ آفست‌های تمام رکوردها اضافه کنید.

اگر هیچ آرگومانی داده نشود، اطلاعات نحوه استفاده از دستور چاپ می‌شود.

گزینه‌ها (OPTIONS)

-v var1[,...]

خروجی تنها اطلاعات آفست متغیرهای مشخص‌شده را نمایش می‌دهد. نام یک یا چند متغیر باید در یک فهرست جداشده با کاما ارائه شود که نباید حاوی فاصله یا نویسه‌های خالی دیگر باشد. متغیرهای نام‌برده باید متغیرهای معتبر netCDF در فایل ورودی باشند. حالت پیش‌فرض، یعنی بدون این گزینه، نمایش اطلاعات آفست برای تمام متغیرهای ذخیره‌شده در فایل ورودی است.

-s

چاپ اندازه متغیر به بایت. برای متغیرهای رکوردی، تنها اندازه یک رکورد چاپ می‌شود.

-g

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

-r

نمایش اطلاعات آفست در خروجی برای تمام رکوردهای متغیرهای رکوردی انتخاب‌شده. بدون این گزینه، تنها آفست‌های رکورد نخست چاپ می‌شوند.

-x

بررسی تمام متغیرهای با اندازه ثابت برای یافتن فاصله‌های فضای فایل میان هر دو متغیر بلافاصله مجاور هم. اگر فاصله‌ای یافت شود، مقدار "1" و در غیر این صورت "0" را در stdout چاپ می‌کند. این گزینه تمام گزینه‌های دیگر را غیرفعال می‌کند.

-h

چاپ گزینه‌های دردسترس خط فرمان.

مثال‌ها (EXAMPLES)

چاپ اطلاعات آفست فایل برای تمام متغیرهای موجود در یک فایل netCDF:

% ncoffsets -sg testfile.nc

netcdf testfile.nc {
// File format: CDF-1
// Number of dimensions: 4
// Number of variables: 4
// Number of global attributes: 0
file header:
    size   = 256 bytes
    extent = 512 bytes
dimensions:
    time = UNLIMITED // (101 currently)
    Z = 100
    Y = 100
    X = 100
fixed-size variables:
    float  square(Y, X):
           start file offset =         512
           end   file offset =       40512
           size in bytes     =       40000
           gap from prev var =         256
    double cube(Z, Y, X):
           start file offset =       40512
           end   file offset =     8040512
           size in bytes     =     8000000
           gap from prev var =           0
record variables:
    double time(time):
           start file offset =     8040512    (0th record)
           end   file offset =     8040520    (0th record)
           size in bytes     =           8    (of one record)
           gap from prev var =           0
    float  rec_var(time, Z, Y, X):
           start file offset =     8040520    (0th record)
           end   file offset =    12040520    (0th record)
           size in bytes     =     4000000    (of one record)
           gap from prev var =           0
}

بررسی اینکه آیا فاصله‌ای میان دو متغیر با اندازه ثابتِ مجاور هم وجود دارد یا خیر:
% ncoffsets -x testfile.nc
0

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

pnetcdf(3)

تاریخ (DATE)

۳۱ ژوئیه ۲۰۲۵