نام (NAME)

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

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

pgmhist

[-median, -quartile, -decile]

[-forensic]

[-machine]

[pgmfile]

توضیحات (DESCRIPTION)

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

دستور pgmhist یک تصویر PGM را به عنوان ورودی خوانده و هیستوگرام مقادیر خاکستری یا سایر معیارهای توزیع مقادیر خاکستری را چاپ می‌کند.

اگر هیچ‌یک از گزینه‌های -median، -quartile یا -decile را مشخص نکنید، pgmhist یک هیستوگرام کامل چاپ می‌کند که نشان می‌دهد چه تعداد پیکسل از هر مقدار خاکستری ممکن در تصویر وجود دارد. همچنین در کنار هر مقدار خاکستری، مشخص می‌کند که چه تعداد پیکسل دست‌کم به همان اندازه سیاه و چه تعداد پیکسل دست‌کم به همان اندازه سفید هستند.

گزینه‌های -median، -quartile و -decile باعث می‌شوند که pgmhist به جای آن، چندک‌های مشخص‌شده را چاپ کند. هر چندک یک مقدار خاکستری است که عملاً در تصویر وجود دارد (برخلاف مقادیر کسری که گاهی برای چندک‌ها استفاده می‌شوند). چارک سوم کمترین مقدار خاکستری است که برای آن دست‌کم ۷۵٪ پیکسل‌ها به همان اندازه یا تیره‌تر از آن هستند. چارک چهارم روشن‌ترین مقدار خاکستری موجود در تصویر است.

گزینه‌ها (OPTIONS)

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

می‌توانید حداکثر یکی از گزینه‌های -median، -quartile و -decile را مشخص کنید. اگر هیچ‌یک از این موارد مشخص نشوند، pgmhist هیستوگرام مقادیر خاکستری را چاپ می‌کند.

-median

این گزینه باعث می‌شود pgmhist مقدار میانه (median) خاکستری را چاپ کند.

این گزینه در Netpbm 10.61 (دسامبر 2012) جدید بود.

-quartile

این گزینه باعث می‌شود pgmhist مقادیر خاکستری مربوط به چهار چارک (quartile) را چاپ کند.

این گزینه در Netpbm 10.61 (دسامبر 2012) جدید بود.

-decile

این گزینه باعث می‌شود pgmhist مقادیر خاکستری مربوط به ده دهک (decile) را چاپ کند.

این گزینه در Netpbm 10.61 (دسامبر 2012) جدید بود.

-forensic

با این گزینه، pgmhist بر روی تصاویری که حاوی مقادیر خاکستری نامعتبر هستند نیز کار می‌کند. در حالت عادی، مانند اکثر برنامه‌های Netpbm، اگر pgmhist با مقدار خاکستری بزرگ‌تر از maxval اعلام‌شده توسط تصویر مواجه شود با خطا متوقف می‌شود. وجود چنین مقداری به معنی نامعتبر بودن تصویر است و پیکسل‌ها معنایی ندارند. اما با گزینه -forensic، دستور pgmhist بدون در نظر گرفتن maxval، هیستوگرامی از مقادیر خاکستری واقعی تولید می‌کند. همچنین در صورت وجود پیکسل‌های نامعتبر، پیام‌هایی در خلاصه وضعیت آن‌ها صادر می‌نماید.

یکی از کاربردهای این گزینه، عیب‌یابی مشکلی است که باعث به وجود آمدن تصویر نامعتبر Netpbm شده است.

یک استثنای کوچک در توانایی pgmhist برای پردازش پیکسل‌های نامعتبر حتی با -forensic وجود دارد: هرگز نمی‌تواند مقادیر خاکستری بزرگ‌تر از 65535 را پردازش کند. توجه داشته باشید که در فرمت به ندرت استفاده‌شده Plain PGM، ممکن است عددی بزرگ‌تر از این مقدار در جایی که مقدار خاکستری قرار دارد ظاهر شود.

این گزینه در Netpbm 10.66 (مارس 2014) معرفی شد. اما نسخه‌های Netpbm قدیمی‌تر از 10.66 مقادیر نامعتبر نمونه را به درستی رد نمی‌کردند، بنابراین عملکرد آن‌ها بسیار شبیه به -forensic بود.

-machine

این گزینه باعث می‌شود pgmhist اطلاعات را به گونه‌ای چاپ کند که به جای انسان، برای ماشین به راحتی قابل خواندن و پردازش باشد.

برای چندک‌ها، برای هر چندک یک خط به ترتیب چندک‌ها وجود دارد که شامل مقدار خاکستری چندک در مبنای ده‌دهی (decimal) بدون صفرهای آغازین است.

برای خروجی کامل هیستوگرام، شامل یک خط به ازای هر مقدار خاکستری ممکن است (چه آن مقدار در تصویر ظاهر شده باشد و چه نشده باشد)، که به ترتیب مقادیر خاکستری مرتب شده‌اند. هر خط شامل دو مقدار است که با یک فاصله از هم جدا شده‌اند: اولی مقدار خاکستری و دومی تعداد پیکسل‌های موجود در تصویر است که آن مقدار خاکستری را دارند. هر دو مقدار به صورت اعداد ده‌دهی بدون صفرهای آغازین هستند.

این گزینه در Netpbm 10.61 (دسامبر 2012) جدید بود.

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

pnmnorm(1), ppmhist(1), pgm(1)

نویسنده (AUTHOR)

حق نشر (C) 1989 توسط Jef Poskanzer.

منبع سند (DOCUMENT SOURCE)

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

http://netpbm.sourceforge.net/doc/pgmhist.html قرار دارد.