.\" 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 "Pamsumm User Manual" 0 "26 October 2012" "netpbm documentation"

.SH "نام (NAME)"
pamsumm \- خلاصه‌سازی محاسباتی مقادیر نمونه‌ها در یک تصویر Netpbm

.UN synopsis
.SH "خلاصه دستور (SYNOPSIS)"
\fBpamsumm\fP
{
\fB-sum\fP |
\fB-mean\fP |
\fB-min\fP |
\fB-max\fP
}
[\fB-normalize\fP]
[\fB-brief\fP]
[\fIimagefile\fP]
.PP
تمامی گزینه‌ها را می‌توان به کوتاه‌ترین پیشوند یکتای آن‌ها مخفف کرد.
می‌توانید به جای یک خط تیره از دو خط تیره استفاده کنید. می‌توانید نام یک گزینه و مقدار آن را به جای علامت مساوی با فاصله جدا کنید.

.UN description
.SH "توضیحات (DESCRIPTION)"
.PP
این برنامه بخشی از
.BR "Netpbm" (1)\c
\& است.
.PP
دستور \fBpamsumm\fP یک تصویر Netpbm (از نوع PNM یا PAM) را می‌خواند و یک تابع خلاصه‌سازی را بر روی تمام نمونه‌ها در تمام سطرها، ستون‌ها و صفحه‌ها اعمال کرده و نتیجه را در خروجی استاندارد چاپ می‌کند.
.PP
دستور \fBpamsumm\fP این عملیات را بر روی مقادیر واقعی نمونه‌ها انجام می‌دهد. در مورد یک PGM یا PPM یا معادل PAM آن (یعنی یک تصویر بصری)، این مقادیر با شدت‌های نور نمایش داده شده توسط آن نمونه‌ها یکسان نیستند. برای معانی دقیق نمونه‌ها در این قالب‌ها، مشخصات قالب‌های
.BR "PGM" (1)\c
\&،
.BR "PPM" (1)\c
\& و
.BR "PAM" (1)\c
\& را ببینید. اگر می‌خواهید محاسبات حسابی را بر روی شدت‌های نور چنین تصویر بصری انجام دهید، می‌توانید از \fBpnmgamma\fP برای تبدیل آن به تصویری با نمونه‌های متناسب با شدت نور استفاده کنید، و سپس \fBpamsumm\fP را روی نتیجه به کار ببرید.
.PP
اگر می‌خواهید خلاصه‌سازی را بر اساس ستون انجام دهید (برای مثال، جمع زدن ستون‌ها به صورت جداگانه)، از \fBpamsummcol\fP استفاده کنید. اگر می‌خواهید خلاصه‌سازی را بر اساس سطر انجام دهید، از ترکیبی از \fBpamsummcol\fP و \fBpamflip\fP استفاده کنید. اگر قصد دارید یک صفحه خاص را خلاصه‌سازی کنید، از \fBpamchannel\fP برای استخراج آن و سپس از \fBpamsumm\fP استفاده نمایید.


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


.TP
\fB-sum\fP
.sp
این گزینه تابع خلاصه‌سازی را عمل جمع قرار می‌دهد.

.TP
\fB-mean\fP
.sp
این گزینه تابع خلاصه‌سازی را میانگین حسابی قرار می‌دهد.

.TP
\fB-min\fP
.sp
این گزینه تابع خلاصه‌سازی را کمینه حسابی قرار می‌دهد.

.TP
\fB-max\fP
.sp
این گزینه تابع خلاصه‌سازی را بیشینه حسابی قرار می‌دهد.

.TP
\fB-normalize\fP
.sp
این گزینه باعث می‌شود که هر نمونه به یک کسر (در بازه 0..1) نرمال‌سازی شود تا نتیجه مستقل از maxval تصویر باشد. برای مثال، اگر میانگین تصویری با maxval برابر با ۲۰۰ را درخواست کنید که تمامی نمونه‌های آن مقدار ۵۰ دارند، \fBpamsumm\fP مقدار ۵۰ را به عنوان پاسخ خواهد داد. اما \fBpamsumm -normalize\fP مقدار .25 را به عنوان پاسخ می‌دهد.
.sp
اگر در عوض نتیجه‌ای می‌خواهید که مستقل از maxval باشد اما همچنان به صورت عدد صحیح باقی بماند، می‌توانید از \fBpamdepth\fP برای تبدیل ورودی به یک maxval استاندارد استفاده کرده و از \fB-normalize\fP استفاده نکنید. به عنوان مثال، اگر میانگین روشنایی یک تصویر PPM را در مقیاس ۰ تا ۹۹ می‌خواهید، دستور زیر را اجرا کنید:

.nf
\f(CW
    pamdepth 99 myimage.ppm | pamsumm -mean
\fP
.fi
.sp
این گزینه در Netpbm 10.22 (آوریل ۲۰۰۴) اضافه شد.
     
.TP
\fB-brief\fP
.sp
این گزینه باعث می‌شود \fBpamsumm\fP پاسخ را صرفاً به صورت یک عدد خام، به جای یک جمله کامل نمایش دهد.
.sp
این گزینه در Netpbm 10.22 (آوریل ۲۰۰۴) اضافه شد.



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

.UN history
.SH "تاریخچه (HISTORY)"
.PP
ابزار \fBpamsumm\fP در نگارش 10.21 از Netpbm (مارس ۲۰۰۴) افزوده شد.
.SH "منبع مستندات (DOCUMENT SOURCE)"
این صفحه راهنما توسط ابزار 'makeman' از Netpbm و از روی منبع HTML تولید شده است. مستندات اصلی در نشانی زیر قرار دارد:
.IP
.B http://netpbm.sourceforge.net/doc/pamsumm.html
.PP