\
.\" 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 "Pamgauss User Manual" 0 "18 May 2017" "netpbm documentation"

.SH "نام (NAME)"
pamgauss \- تولید ماتریس تصویر دوبعدی توزیع گاوسی در قالب Netpbm

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

\fBpamgauss\fP
\fIwidth\fP
\fIheight\fP
\fB-sigma=\fP\fInumber\fP
[\fB-maxval=\fP\fInumber\fP]
[\fB-tupletype=\fP\fIstring\fP]
[\fB-maximize\fP]
[\fB-oversample=\fP\fInumber\fP]
.PP
حداقل مخفف یکتای گزینه‌ها پذیرفته می‌شود. می‌توانید به جای یک خط تیره از دو خط تیره برای مشخص کردن گزینه‌ها استفاده کنید. همچنین می‌توانید به جای علامت مساوی، از فاصله خالی برای جداسازی نام گزینه از مقدار آن استفاده کنید.


.UN examples
.SH "مثال‌ها (EXAMPLES)"

.nf
     pamgauss 7 7 -sigma=.5 -maximize -tupletype=GRAYSCALE | pamtopnm >gauss.pgm
     pnmconvol -nooffset -normalize gauss.pgm myimage.ppm >blurred.ppm
.fi

.UN description
.SH "توضیحات (DESCRIPTION)"
.PP
این برنامه بخشی از
.BR "Netpbm" (1)\c
\& است.
.PP
دستور \fBpamgauss\fP یک تصویر PAM تک‌صفحه‌ای تولید می‌کند که مقادیر نمونه‌های آن تابعی گاوسی از فاصله آن‌ها تا مرکز تصویر هستند. به عبارت دیگر، مقدار نمونه در مرکز بیشترین مقدار را دارد و با دور شدن از مرکز، به صورت یک منحنی زنگوله‌ای کاهش می‌یابد.
.PP
می‌توانید از این تصویر به عنوان هسته کانولوشن (convolution kernel) همراه با \fBpnmconvol\fP برای محو کردن یک تصویر استفاده کنید (این روش به عنوان مات‌سازی گاوسی یا Gaussian blurring شناخته می‌شود).
.PP
شناسه‌های \fIwidth\fP و \fIheight\fP ابعاد تصویری هستند که \fBpamgauss\fP تولید می‌کند. از نظر ریاضی، این‌ها دامنه تابع گاوسی دوبعدی هستند. اگر می‌خواهید مطمئن شوید که یک تابع گاوسی کامل را دریافت می‌کنید، انحراف معیار و ابعاد تصویر را طوری انتخاب کنید که اگر تصویر بزرگ‌تر می‌شد، مقادیر نمونه‌ها در لبه‌ها صفر می‌بودند.
.PP
تصویر خروجی در قالب PAM است. برای قابل استفاده کردن آن با \fBpnmconvol\fP، گزینه \fB-tupletype=GRAYSCALE\fP را تعیین کنید تا \fBpnmconvol\fP بتواند همانند یک تصویر PGM با آن رفتار کند. همچنین باید از گزینه \fB-nooffset\fP در \fBpnmconvol\fP استفاده کنید زیرا در تصویر PAM تولیدشده توسط \fBpamgauss\fP، صفر به معنای صفر واقعی است.
.PP
بدون گزینه \fB-maximize\fP، مجموع تمام نمونه‌ها برابر با مقدار بیشینه (maxval) تصویر خواهد بود (با در نظر گرفتن خطای گرد کردن). این امر حتی اگر با کوچک انتخاب کردن ابعاد تصویر تابع گاوسی را برش دهید نیز برقرار است. این همان رفتاری است که معمولاً برای هسته کانولوشن مورد نیاز است.
.PP
دستور \fBpamgauss\fP برای نمایش تابع گاوسی پیوسته در قالب نمونه‌های گسسته در خروجی PAM، از تکنیک بیش‌نمونه‌برداری (oversampling) و میانگین‌گیری استفاده می‌کند. تصویری با عرض ۱۱ نمونه و ضریب بیش‌نمونه‌برداری ۱۰ را در نظر بگیرید. نمونه‌ها را می‌توان به صورت مربع‌های پیوسته به عرض یک واحد فرض کرد. بنابراین مرکز تصویر، همان مرکز نمونه ششم از سمت چپ خواهد بود. نمونه سوم از چپ بازه‌ای از فواصل بین ۳ تا ۴ واحد از مرکز تصویر را پوشش می‌دهد. از آنجا که ضریب بیش‌نمونه‌برداری ۱۰ است، \fBpamgauss\fP مقدار تابع گاوسی را در ۱۰ نقطه با فواصل مساوی بین ۳ و ۴ واحد از مرکز تصویر محاسبه کرده و میانگین آن ۱۰ مقدار را به نمونه سوم از چپ اختصاص می‌دهد.


.UN options
.SH "گزینه‌ها (OPTIONS)"
.PP
علاوه بر گزینه‌های مشترک میان تمام برنامه‌های مبتنی بر libnetpbm (به‌ویژه \fB-quiet\fP، به
.UR index.html#commonoptions
گزینه‌های عمومی
.UE
مراجعه کنید)، دستور \fBpamgauss\fP گزینه‌های خط فرمان زیر را می‌شناسد:


.TP
\fB-sigma=\fP\fInumber\fP
این مقدار انحراف معیار تابع گاوسی است. هرچه عدد بزرگ‌تر باشد، تابع گستردگی بیشتری خواهد داشت. به طور معمول، باید این عدد را به اندازه‌ای کوچک انتخاب کنید که تابع قبل از رسیدن به لبه‌های تصویر به مقدار صفر برسد.
.sp
مقدار \fInumber\fP بر حسب واحد نمونه‌ها است.
.sp
این گزینه اجباری است و مقدار پیش‌فرضی ندارد.

.TP
\fB-maximize\fP
باعث می‌شود \fBpamgauss\fP با انتخاب دامنه‌ای برای تابع گاوسی که در آن بیشترین مقدار تصویر برابر با maxval تصویر شود، از کل دامنه پویای موجود در تصویر PAM خروجی استفاده کند.
.sp
اگر این گزینه را انتخاب کنید، احتمالاً تمایل خواهید داشت پیش از استفاده، خروجی را نرمال‌سازی کنید (مقیاس نمونه‌ها را کاهش دهید تا حجم زیر سطح تابع گاوسی دوبعدی برابر با maxval شود)، برای مثال با استفاده از گزینه \fB-normalize\fP در دستور \fBpnmconvol\fP. دلیل تفاوت این کار با عدم استفاده از \fB-maximize\fP این است که این نرمال‌سازی بعدی می‌تواند با دقتی بسیار بیشتر از آنچه در تصویر PAM قابل ذخیره است انجام پذیرد.
.sp
بدون این گزینه، \fBpamgauss\fP از دامنه‌ای استفاده می‌کند که حجم زیر سطح تابع گاوسی دوبعدی را برابر با maxval تصویر قرار دهد. این بدان معناست که تمام نمونه‌های تصویر معمولاً بسیار کمتر از maxval خواهند بود.
.sp
این گزینه در Netpbm نسخه 10.79 (ژوئن 2017) معرفی شد.

.TP
\fB-maxval=\fP\fInumber\fP
این مقدار بیشینه (maxval) را برای تصویر خروجی مشخص می‌کند. مقدار ۶۵۵۳۵ تقریباً همیشه بهترین مقدار است. با این حال ممکن است برنامه‌هایی (خارج از مجموعه Netpbm) وجود داشته باشند که توانایی پردازش maxval بیشتر از ۲۵۵ را نداشته باشند.
.sp
مقدار پیش‌فرض ۲۵۵ است.

.TP
\fB-tupletype=\fP\fIstring\fP
این مقدار ویژگی "tuple_type" تصویر PAM تولیدشده است. می‌تواند هر رشته‌ای تا حداکثر ۲۵۵ کاراکتر باشد.
.sp
اگر این گزینه را مشخص نکنید، \fBpamgauss\fP یک تصویر PAM با نوع تاپل نامشخص تولید می‌کند.

.TP
\fB-oversample=\fP\fInumber\fP
این گزینه ضریب بیش‌نمونه‌برداری (oversampling factor) را تنظیم می‌کند. \fBpamgauss\fP تابع گاوسی را هم به صورت افقی و هم عمودی به همین تعداد دفعات نمونه‌برداری می‌کند تا مقدار هر نمونه در خروجی به دست آید.
.sp
ضریب بیش‌نمونه‌برداری ۱ به معنی عدم بیش‌نمونه‌برداری است، به این معنی که مقدار هر نمونه تنها بر اساس مقدار تابع گاوسی در مرکز آن نمونه محاسبه می‌شود.
.sp
مقدار پیش‌فرض برابر با ۵ تقسیم بر انحراف معیار است که به سمت نزدیک‌ترین عدد صحیح بزرگ‌تر گرد می‌شود.
.sp
این گزینه در Netpbm نسخه 10.79 (ژوئن 2017) اضافه شد. پیش از آن، مقدار عملاً ۱ بود و هیچ بیش‌نمونه‌برداری انجام نمی‌شد.



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

.UN history
.SH "تاریخچه (HISTORY)"
.PP
دستور \fBpamgauss\fP در Netpbm نسخه 10.23 (ژوئیه 2004) اضافه شد.
.SH "منبع سند (DOCUMENT SOURCE)"
این صفحه راهنما از منبع HTML توسط ابزار 'makeman' نت‌پم تولید شده است. مستندات مرجع در
.IP
.B http://netpbm.sourceforge.net/doc/pamgauss.html
.PP
قرار دارد.