.\" 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 "Pnmpsnr User Manual" 0 "06 January 2018" "netpbm documentation"

.SH "نام (NAME)"
pnmpsnr \- محاسبه تفاوت بین دو تصویر (PSNR)

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

\fBpnmpsnr\fP

[\fIpnmfile1\fP]

[\fIpnmfile2\fP]

[\fB-rgb\fP]
[\fB-machine\fP]
[\fB-max=\fP\fIn\fP]
[\fB-target=\fP\fIn\fP]
[\fB-target1=\fP\fIn\fP]
[\fB-target2=\fP\fIn\fP]
[\fB-target3=\fP\fIn\fP]
.PP
کوتاه‌ترین مخفف غیرمبهم از گزینه‌ها پذیرفته می‌شود. می‌توانید به جای یک خط تیره از دو خط تیره برای مشخص کردن گزینه‌ها استفاده کنید. همچنین می‌توانید به جای علامت مساوی، از فاصله خالی برای جدا کردن نام یک گزینه از مقدار آن استفاده نمایید.


.UN description
.SH "توضیحات (DESCRIPTION)"
.PP
این برنامه بخشی از
.BR "Netpbm" (1)\c
\& است.
.PP
برنامه \fBpnmpsnr\fP دو فایل PBM، PGM یا PPM، یا معادل‌های PAM را به عنوان ورودی می‌خواند و میزان تفاوت بین دو تصویر را به صورت نسبت بیشینه سیگنال به نویز (PSNR) محاسبه می‌کند. این معیار معمولاً در مقالات فشرده‌سازی تصویر برای سنجش میزان اعوجاج بین تصویر اصلی و تصویر رمزگشایی‌شده به کار می‌رود.
.PP
\fBpnmpsnr\fP این مقادیر را چاپ می‌کند یا آن‌ها را با آستانه‌هایی که شما تعیین کرده‌اید مقایسه می‌نماید.
  
.PP
مقدار PSNR یک مؤلفه مشخص، نسبت بیشینه میانگین مربعات اختلافی است که می‌تواند بین مقادیر مؤلفه دو تصویر وجود داشته باشد (معیاری از محتوای اطلاعات در تصویر) به میانگین مربعات اختلاف واقعی میان مؤلفه‌های دو تصویر مورد نظر. این مقدار بر حسب دسی‌بل بیان می‌شود.
.PP
میانگین مربعات اختلاف یک مؤلفه برای دو تصویر، میانگین مربعات اختلاف مقدار آن مؤلفه با مقایسه هر پیکسل با پیکسل متناظر در همان موقعیت از تصویر دیگر است. به منظور انجام این محاسبات، مؤلفه‌ها در مقیاس [0..1] نرمال‌سازی می‌شوند.
.PP
بیشینه میانگین مربعات اختلاف دقیقاً برابر با ۱ است.
.PP
بنابراین هر چه مقدار PSNR بالاتر باشد، تصاویر به یکدیگر شبیه‌ترند. یک PSNR روشنایی (luminance) با مقدار ۲۰ بدان معناست که میانگین مربعات اختلاف روشنایی پیکسل‌ها ۱۰۰ برابر کمتر از بیشینه اختلاف ممکن، یعنی ۰٫۰۱ است.
.PP
توجه داشته باشید که کلمه «اوج/بیشینه» (peak) یک نام‌گذاری نادقیق است؛ چرا که هیچ مقداری در بیشینه دخیل نیست و این معیار یک میانگین به حساب می‌آید. اما به دلایلی عبارت «peak signal to noise ratio» اصطلاح رایج برای این نوع اندازه‌گیری است.
.PP
اگر ورودی‌ها PBM یا PGM باشند، \fBpnmpsnr\fP تنها PSNR روشنایی را محاسبه می‌کند. در غیر این صورت، سه PSNR جداگانه را محاسبه می‌نماید: یا مؤلفه‌های روشنایی (luminance) و رنگ‌مایه (chrominance شامل Cb و Cr)، یا مؤلفه‌های قرمز (red)، سبز (green) و آبی (blue).
.PP
به‌طور پیش‌فرض، این برنامه مقادیر PSNR را در قالبی خوانا برای انسان در خروجی استاندارد چاپ می‌کند.
.PP
با استفاده از گزینه \fB-machine\fP، برنامه مقادیر PSNR را در قالبی مناسب پردازش ماشین چاپ می‌کند.
.PP
با استفاده از گزینه \fB-target\fP[\fIx\fP]، برنامه بسته به اینکه آیا مقادیر PSNR از اهداف تعیین‌شده فراتر رفته‌اند یا خیر، صرفاً عبارت 'match' یا 'nomatch' را چاپ می‌کند.
  
.PP
\fBpnmpsnr\fP مقادیر PSNR را یا در قالبی خوانا برای انسان و یا در قالبی مناسب ماشین گزارش می‌دهد (گزینه \fB-machine\fP را ببینید).


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


.TP
\fB-rgb\fP
این گزینه باعث می‌شود \fBpnmpsnr\fP مؤلفه‌های قرمز، سبز و آبی رنگ را به جای مؤلفه‌های روشنایی و رنگ‌مایه مقایسه کند. این گزینه بر روی تصویر تک‌رنگ (monotone) اثری ندارد.
.sp
این گزینه از Netpbm 10.71 (ژوئن ۲۰۱۵) اضافه شد.

.TP
\fB-machine\fP
این گزینه باعث می‌شود \fBpnmpsnr\fP مقادیر PSNR را در قالبی مناسب پردازش ماشین گزارش دهد، به طوری که برنامه‌ای دیگر بتواند به راحتی از این اطلاعات استفاده کند.
.sp
خروجی یک خط واحد است. این خط برای هر مؤلفه رنگ شامل یک عدد اعشاری ممیز شناور است که با یک فاصله خالی از یکدیگر جدا شده‌اند. (این یعنی خروجی شامل ۱ یا ۳ عدد خواهد بود). برای فضای رنگی YCbCr (بدون \fB-rgb\fP)، اعداد به ترتیب Y، Cb و Cr هستند. برای فضای رنگی RGB (با \fB-rgb\fP)، به ترتیب R، G و B هستند. برای یک تصویر تک‌رنگ، یک عدد وجود دارد.
.sp
در صورتی که مؤلفه‌ای در دو تصویر هیچ تفاوتی نداشته باشد، مقدار PSNR بی‌نهایت خواهد بود و عدد به صورت \fBinf\fP نمایش می‌یابد.
.sp
اما توجه داشته باشید که عدد نمایش‌داده‌شده تحت تأثیر گزینه \fB-max\fP نیز تغییر می‌کند. به‌ویژه، در صورت استفاده از \fB-max\fP، هرگز مقدار \fBinf\fP را مشاهده نخواهید کرد.
.sp
این گزینه هنگامی که از \fB-target\fP[\fIn\fP] نیز استفاده کنید، هیچ اثری ندارد.
.sp
این گزینه از Netpbm 10.74 (مارس ۲۰۱۶) اضافه شد.

.TP
\fB-max=\fP\fIn\fP
این گزینه تنها همراه با \fB-machine\fP معنادار است.
.sp
این گزینه بیشینه عددی را که \fBpnmpsnr\fP به عنوان PSNR چاپ خواهد کرد مشخص می‌کند. اگر PSNR بزرگ‌تر از \fIn\fP باشد، \fBpnmpsnr\fP صرفاً \fIn\fP را چاپ می‌کند. مقدار \fIn\fP یک عدد اعشاری ممیز شناور است. مقدار PSNR بی‌نهایت، بزرگ‌تر از هر عددی در نظر گرفته می‌شود.
.sp
این گزینه عمدتاً برای مدیریت مقادیر بی‌نهایت PSNR کاربرد دارد. معمولاً پردازش صرفاً اعداد برای یک برنامه بسیار راحت‌تر از مدیریت مقدار بی‌نهایت است، و در اغلب موارد یک عدد بسیار بزرگ همان اثر بی‌نهایت را بر عملکرد برنامه دارد.
.sp
توجه داشته باشید که خروجی لگاریتمی است، به این معنی که اعداد بسیار بزرگ اما متناهی را مشاهده نخواهید کرد. اگر \fB-max=1000\fP را تعیین کنید، تنها در صورتی عدد 1000 را در خروجی خواهید دید که PSNR واقعاً بی‌نهایت باشد. دو تصویر با تعداد پیکسل‌هایی به اندازه تعداد الکترون‌های جهان هستی، که تنها در یک پیکسل و فقط به کمترین مقدار قابل نمایش در قالب Netpbm با یکدیگر تفاوت دارند، دارای PSNR کمتر از 1000 هستند.
.sp
این گزینه از Netpbm 10.74 (مارس ۲۰۱۶) اضافه شد.

.TP
\fB-target\fP=\fIn\fP
                        
این گزینه باعث می‌شود \fBpnmpsnr\fP در حالت مقایسه اجرا شود؛ به جای چاپ مقادیر PSNR، صرفاً مشخص می‌کند که آیا مقادیر PSNR از \fIn\fP (یک عدد ممیز شناور) فراتر می‌روند یا خیر، یعنی آیا تصاویر مقایسه‌شده در یک حاشیه خطای مشخص یکسان هستند یا نه. اگر تمام مقادیر PSNR محاسبه‌شده (روشنایی برای PBM یا PGM؛ روشنایی و رنگ‌مایه یا قرمز، سبز و آبی برای PPM) از \fIn\fP فراتر روند، برنامه عبارت 'match' را در خروجی استاندارد چاپ می‌کند. در غیر این صورت، 'nomatch' چاپ می‌شود.
.sp
اگر هر یک از گزینه‌های \fB-target1\fP، \fB-target2\fP یا \fB-target3\fP را نیز مشخص کنید و تصاویر رنگی باشند، \fBpnmpsnr\fP گزینه \fB-target\fP را نادیده می‌گیرد.
.sp
این ویژگی عمدتاً برای استفاده در برنامه‌ها و اسکریپت‌ها کاربرد دارد. اگر \fBpnmpsnr\fP را به صورت دستی اجرا می‌کنید، می‌توانید آن را بدون \fB-target\fP اجرا نموده و خودتان مقادیر PSNR را با مقادیر مد نظر مقایسه کنید.
.sp
این گزینه از Netpbm 10.82 (مارس ۲۰۱۸) اضافه شد.

.TP
\fB-target\fP{\fB1\fP,\fB2\fP,\fB3\fP}=\fIn\fP
همانند \fB-target\fP، این گزینه‌ها نیز باعث می‌شوند \fBpnmpsnr\fP در حالت مقایسه اجرا شود؛ اما اهداف جداگانه‌ای را برای PSNR هر یک از مؤلفه‌های رنگ به صورت مجزا تعیین می‌کنند. گزینه‌های \fB-target1\fP، \fBtarget-2\fP و \fB-target3\fP بسته به اینکه آیا \fB-rgb\fP را مشخص کرده باشید یا خیر، به ترتیب برای مؤلفه‌های Y، Cb و Cr، یا مؤلفه‌های قرمز، سبز و آبی اعمال می‌شوند.
.sp
اگر گزینه \fB-target\fP\fIn\fP متناظر برای یک مؤلفه را مشخص نکنید، \fBpnmpsnr\fP در تصمیم‌گیری برای تطابق تصاویر، مقدار PSNR آن مؤلفه را نادیده می‌گیرد.
.sp
اگر تصویر ورودی PBM یا PGM باشد، این گزینه‌ها هیچ اثری نخواهند داشت، جز اینکه همچنان حالت مقایسه را فعال می‌کنند؛ بنابراین اگر \fIهمچنین\fP گزینه \fB-target\fP را مشخص نکرده باشید و تصویر PBM یا PGM باشد، برنامه با خطا متوقف می‌شود.
.sp
توجه داشته باشید که این گزینه‌ها به گونه‌ای تعریف شده‌اند که بتوانید یک دستور \fBpnmpsnr\fP را در برنامه‌ای بنویسید که هم روی تصاویر رنگی و هم تصاویر تک‌رنگ کار کند؛ با تعیین اهداف جداگانه برای تصاویر رنگی و یک هدف واحد برای تصاویر تک‌رنگ.
.sp
این گزینه‌ها از Netpbm 10.82 (مارس ۲۰۱۸) اضافه شدند.
    



.UN seealso
.SH "همچنین ببینید (SEE ALSO)"
.BR "pnm" (1)\c
\&
.SH "منبع سند (DOCUMENT SOURCE)"
این صفحه راهنما توسط ابزار Netpbm به نام 'makeman' از روی منبع HTML تولید شده است. مستندات اصلی در نشانی زیر در دسترس است:
.IP
.B http://netpbm.sourceforge.net/doc/pnmpsnr.html
.PP