.\" 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 "Pgmmedian User Manual" 0 "20 January 2022" "netpbm documentation"

.SH "نام (NAME)"
pgmmedian \- اعمال فیلتر میانه (Median Filter) بر روی تصویر خاکستری PGM

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

\fBpgmmedian\fP

[\fB-width=\fP\fIn\fP]

[\fB-height=\fP\fIn\fP]

[\fB-type=\fP\fImedian_type\fP]

[\fB-cutoff=\fP\fIint\fP]

[\fIpnmfile\fP]
.PP
حداقل مخفف یکتای هر گزینه پذیرفته می‌شود. می‌توانید به جای یک خط تیره از دو خط تیره برای مشخص کردن گزینه‌ها استفاده کنید. همچنین می‌توانید از فاصله خالی به جای علامت مساوی برای جدا کردن نام گزینه از مقدار آن استفاده نمایید.


.UN description
.SH "توضیحات (DESCRIPTION)"
.PP
این برنامه بخشی از
.BR "Netpbm" (1)\c
\& است.
.PP
برنامه
\fBpgmmedian\fP
یک فیلتر میانه را بر روی تصویر PGM اعمال می‌کند و از روش مرتب‌سازی هیستوگرام (histogram sort) یا انتخاب مقدار kام (select kth value) برای تعیین میانه استفاده می‌نماید.
.PP
فیلتر میانه یک فیلتر کانولوشن (همگشت) است که در آن مقدار یک پیکسل در خروجی، برابر با میانه مقادیر مجموعه‌ای از پیکسل‌ها در همسایگی پیکسل متناظر در ورودی است. اثر این فیلتر حذف مقادیر با انحراف شدید محلی است. چنین پیکسل‌هایی معمولاً به صورت لکه یا نویز دانه‌ای (speckles) در تصویر ظاهر می‌شوند.
.PP
پیکسل‌های واقع در لبه‌های تصویر (پیکسل‌هایی که هسته کانولوشن از لبه تصویر بیرون می‌زند) صرفاً کپی می‌شوند. برای نمونه، اگر
\fB-height\fP
برابر با ۹ باشد، ۴ سطر نخست و ۴ سطر پایانی تصویر ورودی بدون تغییر به خروجی کپی می‌شوند.

.PP
برای اطلاعات درباره نحوه تصمیم‌گیری
\fBpgmmedian\fP
بین این دو روش، توضیحات مربوط به گزینه‌های
\fB-type\fP
و
\fB-cutoff\fP
را مشاهده کنید.


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


.TP
\fB-cutoff\fP \fIint\fP
این گزینه مقدار آستانه برشی (cutoff) را تعیین می‌کند که
\fBpgmmedian\fP
از آن برای تصمیم‌گیری بین روش مرتب‌سازی هیستوگرام یا روش انتخاب مقدار kام جهت یافتن میانه استفاده می‌کند.

اگر مقدار عبارت
(\fImaxval\fP / ((\fIwidth\fP * \fIheight\fP) - 1))
که در آن
\fImaxval\fP
بیشینه مقدار روشنایی تصویر و
\fIwidth\fP
و
\fIheight\fP
ابعاد ماسک هستند، کمتر از مقدار cutoff باشد،
\fBpgmmedian\fP
از روش مرتب‌سازی هیستوگرام استفاده می‌کند؛ در غیر این صورت از روش انتخاب مقدار kام استفاده می‌نماید.
.sp
اگر گزینه
\fB-type\fP
را مشخص کنید، این گزینه هیچ اثری نخواهد داشت.
.sp
مقدار پیش‌فرض 250 است.

.TP
\fB-width=\fP\fIn\fP
عرض ماسک میانه جهت اعمال.
.sp
حداکثر مقدار مجاز، عرض تصویر ورودی است.
.sp
مقدار پیش‌فرض 3 است.

.TP
\fB-height=\fP\fIn\fP
ارتفاع ماسک میانه جهت اعمال.
.sp
حداکثر مقدار مجاز، ارتفاع تصویر ورودی است.
.sp
مقدار پیش‌فرض 3 است.

.TP
\fB-type\fP \fImedian_type\fP
این گزینه روش مورد استفاده برای یافتن میانه را صرف‌نظر از مقدار cutoff مشخص می‌کند. گزینه‌های انتخابی عبارتند از
\fBhistogram_sort\fP
و
\fBselect\fP\c
\&.
.sp
به طور پیش‌فرض،
\fBpgmmedian\fP
بر اساس توضیحات داده‌شده ذیل گزینه
\fB-cutoff\fP
درباره روش انتخابی تصمیم می‌گیرد.



.UN references
.SH "مراجع (REFERENCES)"



.IP \(bu
"Collected Algorithms from ACM" Volume II, Algorithm 489
by Robert W. Floyd

.IP \(bu
"A Fast Two-Dimensional Median Filtering Algorithm" in
"IEEE Transactions on Acoustics, Speech, and Signal
Processing" Vol. ASSP-27, No. 1, February 1979

.IP \(bu
"Digital Image Processing Algorithms" by Ioannis
Pitas, Prentice Hall, 1993 ISBN 0-13-145814-0




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

.UN history
.SH "تاریخچه (HISTORY)"
.PP
برنامه
\fBpgmmedian\fP
در نسخه 10.29 (اوت 2005) به Netpbm افزوده شد. پیش از آن توسط Mike Burns از طریق وب‌سایت شخصی‌اش توزیع می‌شد (و پس از آن نیز ادامه یافت).


.UN author
.SH "نویسنده (AUTHOR)"
.PP
حق نشر \(co 1996 متعلق به Mike Burns <\fIburns@cac.psu.edu\fP> است.

.SH "منبع سند (DOCUMENT SOURCE)"
این صفحه راهنما توسط ابزار Netpbm با نام 'makeman' از کد منبع HTML تولید شده است. مستندات اصلی در نشانی زیر قرار دارد:
.IP
.B http://netpbm.sourceforge.net/doc/pgmmedian.html
.PP