.\" 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 "Pgmkernel User Manual" 0 "19 December 2013" "netpbm documentation"

.SH "نام (NAME)"
pgmkernel \- تولید یک کرنل کانولوشن

.UN synopsis
.SH "خلاصه دستور (SYNOPSIS)"
.PP
\fBpgmkernel\fP
[\fB-weight=\fP\fInumber\fP]
[\fB-maxval=\fP] {\fIsize\fP | \fIwidth\fP \fIheight\fP}
.PP
کوتاه‌ترین اختصار یکتا برای گزینه‌ها پذیرفته می‌شود. می‌توانید به جای یک خط پیوند، از دو خط پیوند برای مشخص کردن گزینه‌ها استفاده کنید. همچنین می‌توانید به جای علامت مساوی، از نویسه فاصله برای جدا کردن نام گزینه از مقدار آن استفاده نمایید.


.UN description
.SH "توضیحات (DESCRIPTION)"
.PP
این برنامه بخشی از
.BR "Netpbm" (1)\c
\& است.
.PP
دستور \fBpgmkernel\fP یک کرنل کانولوشن تولید می‌کند که می‌توانید آن را با \fBpnmconvol\fP به کار ببرید. این کرنل به گونه‌ای است که وزن هر نقطه با فاصله آن از مرکز کرنل نسبت عکس دارد.
.PP
در صورت مشخص کردن یک آرگومان، \fBpgmkernel\fP یک تصویر PGM با عرض و ارتفاع \fIsize\fP تولید می‌کند، و در صورت تعیین دو آرگومان، تصویری با عرض \fIwidth\fP و ارتفاع \fIheight\fP ایجاد می‌نماید.
.PP
دستور \fBpgmkernel\fP تابع کانولوشن K را به صورت زیر محاسبه می‌کند:

.RS
K(i,j) = 1 / ( 1 + w * sqrt(i^2 + j^2)) 
.RE

که در آن \fIw\fP ضریبی است که از طریق گزینه \fB-weight\fP تعیین می‌شود. مقادیر \fIi\fP و \fIj\fP بر حسب پیکسل سنجیده می‌شوند. مقدار K در همه‌جای فراتر از عرض و ارتفاع تعیین‌شده برای کرنل، صفر است.
.PP
مقادیر نمونه در خروجی PGM با استفاده از شیوه‌نامه‌ای که \fBpnmconvol\fP برای نمایش اعداد حقیقی K در قالب PGM مشخص می‌کند، مقیاس‌بندی شده و انحراف (بایاس) می‌یابند.


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


.TP
\fB-weight=\fP\fInumber\fP
فاصله از مرکز با این مقدار وزن‌دهی می‌شود؛ یک عدد بزرگ‌تر به این معنی است که با دور شدن از مرکز، مقادیر با سرعت بیشتری افت می‌کنند.
.sp
این مقدار باید یک عدد حقیقی مثبت باشد.
.sp
مقدار پیش‌فرض 6.0 است.

.TP
\fB-maxval=\fP\fImaxval\fP
بیشینه مقدار (maxval) برای کرنل PGM.
.sp
پیش‌فرض 255 است.
.sp
این گزینه در Netpbm 10.65 (دسامبر ۲۰۱۳) اضافه شد. پیش از آن، مقدار maxval همواره ۲۵۵ بود.
    



.UN limitations
.SH "محدودیت‌ها (LIMITATIONS)"
.PP
زمان محاسبات متناسب با \fIwidth\fP*\fIheight\fP است. این زمان با افزایش اندازه کرنل به‌سرعت بالا می‌رود. در چنین مواردی، استفاده از FFT (تبدیل فوریه سریع) می‌تواند رویکرد بهتری باشد.

.UN history
.SH "تاریخچه (HISTORY)"
.PP
پیش از Netpbm 10.65 (دسامبر ۲۰۱۳)، خروجی همواره در قالب متنی PGM (یا Plain) بود. (اکنون، همانند برنامه‌های استاندارد Netpbm، حالت پیش‌فرض PGM خام یا raw است و می‌توانید با گزینه \fB-plain\fP به قالب متنی دست یابید).
.PP
پیش از Netpbm 10.65 (دسامبر ۲۰۱۳)، در این راهنما ذکر شده بود که مقادیر منفی برای \fB-weight\fP مجاز هستند (تا زمانی که بزرگ‌تر از \-1.0 باشند). اما این برنامه هرگز با اعداد منفی کار نمی‌کرد و مشخص نیست که خروجی آن مفید باشد؛ بنابراین اکنون الزامی است که مقدار \fB-weight\fP غیرمنفی باشد و در صورت تعیین مقدار منفی، برنامه به‌درستی با خطا متوقف می‌شود.

.UN seealso
.SH "همچنین ببینید (SEE ALSO)"
.BR "pnmconvol" (1)\c
\&,
.BR "pnmsmooth" (1)\c
\&
.BR "pamgauss" (1)\c
\&
.BR "pgm" (1)\c
\&


.UN author
.SH "نویسندگان (AUTHORS)"

Alberto Accomazzi (\fIalberto@cfa.harvard.edu\fP).
.SH "منبع سند (DOCUMENT SOURCE)"
این صفحه راهنما توسط ابزار Netpbm با نام 'makeman' از منبع HTML تولید شده است. مستندات اصلی در نشانی زیر قرار دارد:
.IP
.B http://netpbm.sourceforge.net/doc/pgmkernel.html
.PP