نام (NAME)

pamsumm - خلاصه‌سازی محاسباتی مقادیر نمونه‌ها در یک تصویر Netpbm

خلاصه دستور (SYNOPSIS)

pamsumm { -sum | -mean | -min | -max } [-normalize] [-brief] [imagefile]

تمامی گزینه‌ها را می‌توان به کوتاه‌ترین پیشوند یکتای آن‌ها مخفف کرد. می‌توانید به جای یک خط تیره از دو خط تیره استفاده کنید. می‌توانید نام یک گزینه و مقدار آن را به جای علامت مساوی با فاصله جدا کنید.

توضیحات (DESCRIPTION)

این برنامه بخشی از Netpbm(1) است.

دستور pamsumm یک تصویر Netpbm (از نوع PNM یا PAM) را می‌خواند و یک تابع خلاصه‌سازی را بر روی تمام نمونه‌ها در تمام سطرها، ستون‌ها و صفحه‌ها اعمال کرده و نتیجه را در خروجی استاندارد چاپ می‌کند.

دستور pamsumm این عملیات را بر روی مقادیر واقعی نمونه‌ها انجام می‌دهد. در مورد یک PGM یا PPM یا معادل PAM آن (یعنی یک تصویر بصری)، این مقادیر با شدت‌های نور نمایش داده شده توسط آن نمونه‌ها یکسان نیستند. برای معانی دقیق نمونه‌ها در این قالب‌ها، مشخصات قالب‌های PGM(1)، PPM(1) و PAM(1) را ببینید. اگر می‌خواهید محاسبات حسابی را بر روی شدت‌های نور چنین تصویر بصری انجام دهید، می‌توانید از pnmgamma برای تبدیل آن به تصویری با نمونه‌های متناسب با شدت نور استفاده کنید، و سپس pamsumm را روی نتیجه به کار ببرید.

اگر می‌خواهید خلاصه‌سازی را بر اساس ستون انجام دهید (برای مثال، جمع زدن ستون‌ها به صورت جداگانه)، از pamsummcol استفاده کنید. اگر می‌خواهید خلاصه‌سازی را بر اساس سطر انجام دهید، از ترکیبی از pamsummcol و pamflip استفاده کنید. اگر قصد دارید یک صفحه خاص را خلاصه‌سازی کنید، از pamchannel برای استخراج آن و سپس از pamsumm استفاده نمایید.

گزینه‌ها (OPTIONS)

علاوه بر گزینه‌های مشترک بین تمامی برنامه‌های مبتنی بر libnetpbm (به‌ویژه -quiet، به گزینه‌های مشترک مراجعه کنید)، pamsumm گزینه‌های خط فرمان زیر را می‌شناسد:

باید دقیقاً یکی از گزینه‌های -sum، -mean، -min یا -max را مشخص کنید.

-sum

این گزینه تابع خلاصه‌سازی را عمل جمع قرار می‌دهد.

-mean

این گزینه تابع خلاصه‌سازی را میانگین حسابی قرار می‌دهد.

-min

این گزینه تابع خلاصه‌سازی را کمینه حسابی قرار می‌دهد.

-max

این گزینه تابع خلاصه‌سازی را بیشینه حسابی قرار می‌دهد.

-normalize

این گزینه باعث می‌شود که هر نمونه به یک کسر (در بازه 0..1) نرمال‌سازی شود تا نتیجه مستقل از maxval تصویر باشد. برای مثال، اگر میانگین تصویری با maxval برابر با ۲۰۰ را درخواست کنید که تمامی نمونه‌های آن مقدار ۵۰ دارند، pamsumm مقدار ۵۰ را به عنوان پاسخ خواهد داد. اما pamsumm -normalize مقدار .25 را به عنوان پاسخ می‌دهد.

اگر در عوض نتیجه‌ای می‌خواهید که مستقل از maxval باشد اما همچنان به صورت عدد صحیح باقی بماند، می‌توانید از pamdepth برای تبدیل ورودی به یک maxval استاندارد استفاده کرده و از -normalize استفاده نکنید. به عنوان مثال، اگر میانگین روشنایی یک تصویر PPM را در مقیاس ۰ تا ۹۹ می‌خواهید، دستور زیر را اجرا کنید:

    pamdepth 99 myimage.ppm | pamsumm -mean

این گزینه در Netpbm 10.22 (آوریل ۲۰۰۴) اضافه شد.

-brief

این گزینه باعث می‌شود pamsumm پاسخ را صرفاً به صورت یک عدد خام، به جای یک جمله کامل نمایش دهد.

این گزینه در Netpbm 10.22 (آوریل ۲۰۰۴) اضافه شد.

همچنین ببینید (SEE ALSO)

pamsummcol(1)، pam(1)

تاریخچه (HISTORY)

ابزار pamsumm در نگارش 10.21 از Netpbm (مارس ۲۰۰۴) افزوده شد.

منبع مستندات (DOCUMENT SOURCE)

این صفحه راهنما توسط ابزار 'makeman' از Netpbm و از روی منبع HTML تولید شده است. مستندات اصلی در نشانی زیر قرار دارد:

http://netpbm.sourceforge.net/doc/pamsumm.html