نام (NAME)

pamtofits - تبدیل تصویر با فرمت Netpbm (PAM/PNM) به فرمت نجومی FITS

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

pamtofits [-max f] [-min f] [pamfile]

توضیحات (DESCRIPTION)

این برنامه بخشی از Netpbm(1)است.

دستور pamtofits یک تصویر PNM یا PAM را به عنوان ورودی می‌خواند و یک فایل با فرمت FITS (Flexible Image Transport System یا سامانه انعطاف‌پذیر انتقال تصویر) به عنوان خروجی تولید می‌کند. وضوح و دقت فایل خروجی بسته به مقدار maxval در فایل ورودی، ۸ بیت به ازای هر پیکسل یا ۱۶ بیت به ازای هر پیکسل خواهد بود. اگر فایل ورودی یک تصویر PBM یا PGM باشد، فایل خروجی شامل یک تصویر تک‌صفحه‌ای خواهد بود (NAXIS = 2). اگر در عوض فایل ورودی یک تصویر PPM باشد، فایل خروجی شامل یک تصویر سه‌صفحه‌ای خواهد بود (NAXIS = 3, NAXIS3 = 3).

گزینه‌ها (OPTIONS)

علاوه بر گزینه‌های مشترک بین تمامی برنامه‌های مبتنی بر libnetpbm (به ویژه -quiet، به گزینه‌های عمومی مراجعه کنید)، دستور pamtofits گزینه‌های خط فرمان زیر را می‌شناسد:

گزینه‌های -min و -max به pamtofits مشخص می‌کنند که مقادیر نمونه صفر و maxval در تصویر ورودی به ترتیب نمایانگر چه «مقادیر فیزیکی» هستند. مقادیر فیزیکی یکی از مفاهیم فرمت FITS هستند. برنامه pamtofits کارت‌های هدر FITS شامل BSCALE و BZERO را جهت ثبت این اطلاعات تنظیم می‌کند.

مقدار پیش‌فرض برای -min برابر 0 و برای -max برابر maxval است؛ این بدان معناست که اگر این گزینه‌ها را مشخص نکنید، مقادیر فیزیکی FITS در واقع همان مقادیر نمونه اصلی Netpbm خواهند بود.

برنامه pamtofits همیشه کارت‌های هدر FITS شامل DATAMIN و DATAMAX را طوری تنظیم می‌کند که نشان دهد بیشترین مقدار فیزیکی در تصویر متناظر با maxval در Netpbm و کمترین مقدار متناظر با صفر در Netpbm است. این در واقع نحوه استفاده واقعی و دقیق این کارت‌ها نیست، چرا که تصویر ورودی لزوماً شامل تمام بازه ممکن مقادیر نمونه نیست. این یک تخمین محتاطانه است.

نکات (NOTES)

ترتیب پیکسل‌ها (Pixel Order)

مشخصات استاندارد FITS مشخص نمی‌کند که کدام داده در فایل متناظر با کدام پیکسل در تصویر است (یعنی کدام بایت‌ها پیکسل بالا سمت چپ و غیره هستند). ابزار Netpbm از چینش منطقی و رایج‌تر استفاده می‌کند: سطرمحور، از بالا به پایین، از چپ به راست. این بدان معناست که در یک تصویر با عرض ۱۰ و ارتفاع ۲۰، ۱۰ پیکسل اول در فایل سطر بالا و ۱۰ پیکسل آخر سطر پایین هستند. در هر سطر، اولین پیکسل، چپ‌ترین پیکسل و آخرین پیکسل، راست‌ترین پیکسل است.

ابزار Netpbm از زمان پشتیبانی اولیه از فرمت FITS در سال ۱۹۸۹ همواره این‌گونه عمل کرده است، بنابراین نوعی استاندارد دوفاکتو محسوب می‌شود. تا سال ۲۰۰۸ هیچ‌کس مشکلی در این مورد گزارش نکرده بود.

با این حال، دست‌کم برخی از نسخه‌های ImageMagick و Gimp (بر اساس مشاهدات سال ۲۰۰۸) از ترتیب پایین به بالا استفاده می‌کنند، بنابراین اگر از یکی از این برنامه‌ها برای نمایش یک تصویر FITS تولیدشده توسط pamtofits استفاده کنید، تصویر وارونه نمایش داده خواهد شد. برای رفع این مشکل، قبل از ارسال تصویر به pamtofits، دستور pamflip -topbottom را روی آن اعمال کنید.

از سال ۲۰۰۸ به بعد، مشخص شده است که ناسا (NASA) فایل‌های FITS را با ترتیب پایین به بالا توزیع می‌کند.

تاریخچه (HISTORY)

دستور pamtofits در ابتدا pnmtofits نام داشت و ورودی‌های PAM را پردازش نمی‌کرد. این ابزار در Netpbm نسخه 10.30 (اکتبر ۲۰۰۵) گسترش یافت و تغییر نام داد.

ابزار pnmtofits خود نسخه‌ای گسترش‌یافته از pgmtofits بود که در سال ۱۹۸۹ به Pbmplus اضافه شده بود.

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

fitstopnm(1), pam(1)

نویسنده (AUTHOR)

حق نشر (C) ۱۹۸۹ توسط Wilson H. Bent (whb@hoh-2.att.com)، همراه با اصلاحات توسط Alberto Accomazzi (alberto@cfa.harvard.edu).

منبع سند (DOCUMENT SOURCE)

این صفحه راهنما توسط ابزار 'makeman' از Netpbm و از روی منبع HTML تولید شده است. مستندات اصلی در نشانی زیر قرار دارند:

: http://netpbm.sourceforge.net/doc/pamtofits.html