\
.\" This man page was generated by the Netpbm tool 'makeman' from HTML source.
.\" Do not hand-hack it!  If you have bug fixes or improvements, please find
.\" the corresponding HTML page on the Netpbm website, generate a patch
.\" against that, and send it to the Netpbm maintainer.
.TH "راهنمای کاربر Pamtofits" 0 "25 September 2005" "netpbm documentation"

.SH "نام (NAME)"

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

.UN synopsis
.SH "خلاصه دستور (SYNOPSIS)"

\fBpamtofits\fP
[\fB-max\fP \fIf\fP]
[\fB-min\fP \fIf\fP]
[\fIpamfile\fP]

.UN description
.SH "توضیحات (DESCRIPTION)"
.PP
این برنامه بخشی از
.BR "Netpbm" (1)\c
است.
.PP
دستور \fBpamtofits\fP یک تصویر PNM یا PAM را به عنوان ورودی می‌خواند و یک فایل با فرمت FITS
(Flexible Image Transport System یا سامانه انعطاف‌پذیر انتقال تصویر) به عنوان خروجی تولید می‌کند. وضوح و دقت فایل خروجی بسته به مقدار maxval در فایل ورودی، ۸ بیت به ازای هر پیکسل یا ۱۶ بیت به ازای هر پیکسل خواهد بود. اگر فایل ورودی یک تصویر PBM یا PGM باشد، فایل خروجی شامل یک تصویر تک‌صفحه‌ای خواهد بود (NAXIS = 2). اگر در عوض فایل ورودی یک تصویر PPM باشد، فایل خروجی شامل یک تصویر سه‌صفحه‌ای خواهد بود (NAXIS = 3, NAXIS3 = 3).

.UN options
.SH "گزینه‌ها (OPTIONS)"
.PP
علاوه بر گزینه‌های مشترک بین تمامی برنامه‌های مبتنی بر libnetpbm
(به ویژه \fB-quiet\fP، به
.UR index.html#commonoptions
گزینه‌های عمومی
.UE
مراجعه کنید)، دستور \fBpamtofits\fP گزینه‌های خط فرمان زیر را می‌شناسد:
.PP
گزینه‌های \fB-min\fP و \fB-max\fP به \fBpamtofits\fP مشخص می‌کنند که مقادیر نمونه صفر و maxval در تصویر ورودی به ترتیب نمایانگر چه «مقادیر فیزیکی» هستند. مقادیر فیزیکی یکی از مفاهیم فرمت FITS هستند. برنامه \fBpamtofits\fP کارت‌های هدر FITS شامل \fBBSCALE\fP و \fBBZERO\fP را جهت ثبت این اطلاعات تنظیم می‌کند.
.PP
مقدار پیش‌فرض برای \fB-min\fP برابر 0 و برای \fB-max\fP برابر maxval است؛ این بدان معناست که اگر این گزینه‌ها را مشخص نکنید، مقادیر فیزیکی FITS در واقع همان مقادیر نمونه اصلی Netpbm خواهند بود.
.PP
برنامه \fBpamtofits\fP همیشه کارت‌های هدر FITS شامل \fBDATAMIN\fP و \fBDATAMAX\fP را طوری تنظیم می‌کند که نشان دهد بیشترین مقدار فیزیکی در تصویر متناظر با maxval در Netpbm و کمترین مقدار متناظر با صفر در Netpbm است. این در واقع نحوه استفاده واقعی و دقیق این کارت‌ها نیست، چرا که تصویر ورودی لزوماً شامل تمام بازه ممکن مقادیر نمونه نیست. این یک تخمین محتاطانه است.

.UN notes
.SH "نکات (NOTES)"

.UN pixelorder
.SS "ترتیب پیکسل‌ها (Pixel Order)"
.PP
مشخصات استاندارد FITS مشخص نمی‌کند که کدام داده در فایل متناظر با کدام پیکسل در تصویر است (یعنی کدام بایت‌ها پیکسل بالا سمت چپ و غیره هستند). ابزار Netpbm از چینش منطقی و رایج‌تر استفاده می‌کند: سطرمحور، از بالا به پایین، از چپ به راست. این بدان معناست که در یک تصویر با عرض ۱۰ و ارتفاع ۲۰، ۱۰ پیکسل اول در فایل سطر بالا و ۱۰ پیکسل آخر سطر پایین هستند. در هر سطر، اولین پیکسل، چپ‌ترین پیکسل و آخرین پیکسل، راست‌ترین پیکسل است.
.PP
ابزار \fBNetpbm\fP از زمان پشتیبانی اولیه از فرمت FITS در سال ۱۹۸۹ همواره این‌گونه عمل کرده است، بنابراین نوعی استاندارد دوفاکتو محسوب می‌شود. تا سال ۲۰۰۸ هیچ‌کس مشکلی در این مورد گزارش نکرده بود.
.PP
با این حال، دست‌کم برخی از نسخه‌های ImageMagick و Gimp (بر اساس مشاهدات سال ۲۰۰۸) از ترتیب پایین به بالا استفاده می‌کنند، بنابراین اگر از یکی از این برنامه‌ها برای نمایش یک تصویر FITS تولیدشده توسط \fBpamtofits\fP استفاده کنید، تصویر وارونه نمایش داده خواهد شد. برای رفع این مشکل، قبل از ارسال تصویر به \fBpamtofits\fP، دستور \fBpamflip -topbottom\fP را روی آن اعمال کنید.
.PP
از سال ۲۰۰۸ به بعد، مشخص شده است که ناسا (NASA) فایل‌های FITS را با ترتیب پایین به بالا توزیع می‌کند.


.UN history
.SH "تاریخچه (HISTORY)"
.PP
دستور \fBpamtofits\fP در ابتدا \fBpnmtofits\fP نام داشت و ورودی‌های PAM را پردازش نمی‌کرد. این ابزار در Netpbm نسخه 10.30 (اکتبر ۲۰۰۵) گسترش یافت و تغییر نام داد.
.PP
ابزار \fBpnmtofits\fP خود نسخه‌ای گسترش‌یافته از \fBpgmtofits\fP بود که در سال ۱۹۸۹ به Pbmplus اضافه شده بود.

.UN seealso
.SH "همچنین ببینید (SEE ALSO)"
.BR "fitstopnm" (1)\c
\&,
.BR "pam" (1)\c
\&

.UN author
.SH "نویسنده (AUTHOR)"

حق نشر (C) ۱۹۸۹ توسط Wilson H. Bent (\fIwhb@hoh-2.att.com\fP)، همراه با اصلاحات توسط Alberto Accomazzi (\fIalberto@cfa.harvard.edu\fP).
.SH "منبع سند (DOCUMENT SOURCE)"
این صفحه راهنما توسط ابزار 'makeman' از Netpbm و از روی منبع HTML تولید شده است. مستندات اصلی در نشانی زیر قرار دارند:
.IP
.B http://netpbm.sourceforge.net/doc/pamtofits.html
.PP