\
.\" 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 "Pgmhist User Manual" 0 "18 December 2021" "netpbm documentation"

.SH "نام (NAME)"

pgmhist \- چاپ هیستوگرام مقادیر در یک تصویر PGM

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

\fBpgmhist\fP

[\fB-median\fP, \fB-quartile\fP, \fB-decile\fP]

[\fB-forensic\fP]

[\fB-machine\fP]

[\fIpgmfile\fP]

.UN description
.SH "توضیحات (DESCRIPTION)"
.PP
این برنامه بخشی از
.BR "Netpbm" (1)\c
\& است.
.PP
دستور \fBpgmhist\fP یک تصویر PGM را به عنوان ورودی خوانده و هیستوگرام مقادیر خاکستری یا سایر معیارهای توزیع مقادیر خاکستری را چاپ می‌کند.
.PP
اگر هیچ‌یک از گزینه‌های \fB-median\fP، \fB-quartile\fP یا \fB-decile\fP را مشخص نکنید، \fBpgmhist\fP یک هیستوگرام کامل چاپ می‌کند که نشان می‌دهد چه تعداد پیکسل از هر مقدار خاکستری ممکن در تصویر وجود دارد. همچنین در کنار هر مقدار خاکستری، مشخص می‌کند که چه تعداد پیکسل دست‌کم به همان اندازه سیاه و چه تعداد پیکسل دست‌کم به همان اندازه سفید هستند.
.PP
گزینه‌های \fB-median\fP، \fB-quartile\fP و \fB-decile\fP باعث می‌شوند که \fBpgmhist\fP به جای آن، چندک‌های مشخص‌شده را چاپ کند. هر چندک یک مقدار خاکستری است که عملاً در تصویر وجود دارد (برخلاف مقادیر کسری که گاهی برای چندک‌ها استفاده می‌شوند). چارک سوم کمترین مقدار خاکستری است که برای آن دست‌کم ۷۵٪ پیکسل‌ها به همان اندازه یا تیره‌تر از آن هستند. چارک چهارم روشن‌ترین مقدار خاکستری موجود در تصویر است.


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


.TP
\fB-median\fP
.sp
این گزینه باعث می‌شود \fBpgmhist\fP مقدار میانه (median) خاکستری را چاپ کند.
.sp
این گزینه در Netpbm 10.61 (دسامبر 2012) جدید بود.

.TP
\fB-quartile\fP
.sp
این گزینه باعث می‌شود \fBpgmhist\fP مقادیر خاکستری مربوط به چهار چارک (quartile) را چاپ کند.
.sp
این گزینه در Netpbm 10.61 (دسامبر 2012) جدید بود.

.TP
\fB-decile\fP
.sp
این گزینه باعث می‌شود \fBpgmhist\fP مقادیر خاکستری مربوط به ده دهک (decile) را چاپ کند.
.sp
این گزینه در Netpbm 10.61 (دسامبر 2012) جدید بود.

.TP
\fB-forensic\fP
.sp
با این گزینه، \fBpgmhist\fP بر روی تصاویری که حاوی مقادیر خاکستری نامعتبر هستند نیز کار می‌کند. در حالت عادی، مانند اکثر برنامه‌های Netpbm، اگر \fBpgmhist\fP با مقدار خاکستری بزرگ‌تر از maxval اعلام‌شده توسط تصویر مواجه شود با خطا متوقف می‌شود. وجود چنین مقداری به معنی نامعتبر بودن تصویر است و پیکسل‌ها معنایی ندارند. اما با گزینه \fB-forensic\fP، دستور \fBpgmhist\fP بدون در نظر گرفتن maxval، هیستوگرامی از مقادیر خاکستری واقعی تولید می‌کند. همچنین در صورت وجود پیکسل‌های نامعتبر، پیام‌هایی در خلاصه وضعیت آن‌ها صادر می‌نماید.
.sp
یکی از کاربردهای این گزینه، عیب‌یابی مشکلی است که باعث به وجود آمدن تصویر نامعتبر Netpbm شده است.
.sp
یک استثنای کوچک در توانایی \fBpgmhist\fP برای پردازش پیکسل‌های نامعتبر حتی با \fB-forensic\fP وجود دارد: هرگز نمی‌تواند مقادیر خاکستری بزرگ‌تر از 65535 را پردازش کند. توجه داشته باشید که در فرمت به ندرت استفاده‌شده Plain PGM، ممکن است عددی بزرگ‌تر از این مقدار در جایی که مقدار خاکستری قرار دارد ظاهر شود.
.sp
این گزینه در Netpbm 10.66 (مارس 2014) معرفی شد. اما نسخه‌های Netpbm قدیمی‌تر از 10.66 مقادیر نامعتبر نمونه را به درستی رد نمی‌کردند، بنابراین عملکرد آن‌ها بسیار شبیه به \fB-forensic\fP بود.

.TP
\fB-machine\fP
.sp
این گزینه باعث می‌شود \fBpgmhist\fP اطلاعات را به گونه‌ای چاپ کند که به جای انسان، برای ماشین به راحتی قابل خواندن و پردازش باشد.
.sp
برای چندک‌ها، برای هر چندک یک خط به ترتیب چندک‌ها وجود دارد که شامل مقدار خاکستری چندک در مبنای ده‌دهی (decimal) بدون صفرهای آغازین است.
.sp
برای خروجی کامل هیستوگرام، شامل یک خط به ازای هر مقدار خاکستری ممکن است (چه آن مقدار در تصویر ظاهر شده باشد و چه نشده باشد)، که به ترتیب مقادیر خاکستری مرتب شده‌اند. هر خط شامل دو مقدار است که با یک فاصله از هم جدا شده‌اند: اولی مقدار خاکستری و دومی تعداد پیکسل‌های موجود در تصویر است که آن مقدار خاکستری را دارند. هر دو مقدار به صورت اعداد ده‌دهی بدون صفرهای آغازین هستند.
.sp
این گزینه در Netpbm 10.61 (دسامبر 2012) جدید بود.




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

.UN author
.SH "نویسنده (AUTHOR)"

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