.\" Text automatically generated by txt2man
.TH AUBIOPITCH 1 "04 August 2026" "aubio 0.4.9" "aubio User's manual"
.SH "نام (NAME)"
\fBaubiopitch \fP\- ابزار خط فرمان برای استخراج زیروبمی موسیقی (pitch)
\fB
.SH "خلاصه دستور (SYNOPSIS)"
.nf
.fam C

\fBaubiopitch\fP \fIsource\fP
\fBaubiopitch\fP [[\fB-i\fP] \fIsource\fP] [\fB-o\fP \fIsink\fP]
           [\fB-r\fP \fIrate\fP] [\fB-B\fP \fIwin\fP] [\fB-H\fP \fIhop\fP]
           [\fB-p\fP \fImethod\fP] [\fB-u\fP \fIunit\fP] [\fB-l\fP \fIthres\fP]
           [\fB-T\fP \fItime-format\fP]
           [\fB-s\fP \fIsil\fP] [\fB-f\fP]
           [\fB-v\fP] [\fB-h\fP] [\fB-j\fP]

.fam T
.fi
.fam T
.fi
.SH "توضیحات (DESCRIPTION)"

\fBaubiopitch\fP تلاش می‌کند زیروبمی صدا (pitch)، یعنی ارتفاع درک‌شده از یک نت موسیقی را شناسایی کند.
.PP
هنگام اجرا با یک پرونده ورودی \fIsource\fP (\fB-i\fP/\fB--input\fP)، مقادیر زیروبمی شناسایی‌شده به همراه یک برچسب زمانی بر حسب ثانیه در کنسول چاپ می‌شوند. اگر هیچ نامزدی برای زیروبمی یافت نشود، خروجی 0 خواهد بود.
.PP
هنگام اجرا بدون منبع ورودی \fIsource\fP، یا با گزینه جک (\fB-j\fP/\fB--jack\fP)، برنامه \fBaubiopitch\fP در حالت jack اجرا می‌شود.
.SH "گزینه‌ها (OPTIONS)"

این برنامه از قواعد مرسوم خط فرمان GNU پیروی می‌کند که در آن گزینه‌های طولانی با دو خط تیره (--) آغاز می‌شوند. خلاصه‌ای از گزینه‌ها در زیر آمده است.
.TP
.B
\fB-i\fP, \fB--input\fP \fIsource\fP
اجرای تحلیل بر روی این پرونده صوتی. بیشتر قالب‌های فشرده و غیرفشرده پشتیبانی می‌شوند، بسته به نحوه ساخت aubio.
.TP
.B
\fB-o\fP, \fB--output\fP \fIsink\fP
ذخیره نتایج در این پرونده. پرونده بر پایه مدل پرونده ورودی ایجاد خواهد شد. بسامد (فرکانس) شناسایی‌شده با بلندی صدای شناسایی‌شده پخش می‌شود.
.TP
.B
\fB-r\fP, \fB--samplerate\fP \fIrate\fP
دریافت منبع ورودی \fIsource\fP، نمونه‌برداری مجدد با نرخ نمونه‌برداری داده‌شده \fIrate\fP. نرخ باید به عنوان یک عدد صحیح بر حسب هرتز مشخص شود. اگر 0 باشد، نرخ نمونه‌برداری منبع اصلی \fIsource\fP استفاده خواهد شد. پیش‌فرض 0 است.
.TP
.B
\fB-B\fP, \fB--bufsize\fP \fIwin\fP
اندازه بافر برای تحلیل، یعنی طول پنجره مورد استفاده برای محاسبات طیفی و زمانی. پیش‌فرض 2048 است.
.TP
.B
\fB-H\fP, \fB--hopsize\fP \fIhop\fP
تعداد نمونه‌ها بین دو تحلیل متوالی. پیش‌فرض 256 است.
.TP
.B
\fB-p\fP, \fB--pitch\fP \fImethod\fP
روش تشخیص زیروبمی \fImethod\fP مورد استفاده. بخش روش‌های زیروبمی (PITCH METHODS) را در زیر ببینید. پیش‌فرض 'default' است.
.TP
.B
\fB-u\fP, \fB--pitch\fP-\fIunit\fP \fIunit\fP
واحد \fIunit\fP مورد استفاده برای چاپ بسامدها. مقادیر ممکن عبارتند از midi، bin، cent و Hz. پیش‌فرض 'Hz' است.
.TP
.B
\fB-l\fP, \fB--pitch-tolerance\fP \fIthres\fP
تنظیم میزان رواداری (tolerance) برای الگوریتم تشخیص زیروبمی. مقادیر معمول بین 0.2 و 0.9 متغیر هستند. نامزدهای زیروبمی که با اطمینان کمتر از این آستانه یافت شوند، انتخاب نخواهند شد. هرچه آستانه بالاتر باشد، اطمینان به نامزدها بیشتر است. پیش‌فرض تنظیم‌نشده است.
.TP
.B
\fB-s\fP, \fB--silence\fP \fIsil\fP
تنظیم آستانه سکوت بر حسب دسی‌بل (dB) که پایین‌تر از آن، شروع صدا (onset) تشخیص داده نخواهد شد. مقدار \fB-20.0\fP بیشتر صداها به جز بلندترین آن‌ها را حذف می‌کند. مقدار \fB-90.0\fP همه شروع‌های صدا را انتخاب می‌کند. پیش‌فرض \fB-90.0\fP است.
.TP
.B
\fB-T\fP, \fB--timeformat\fP format
تنظیم قالب زمان (samples، ms، seconds). پیش‌فرض seconds است.
.TP
.B
\fB-m\fP, \fB--mix-input\fP
مخلوط کردن سیگنال ورودی \fIsource\fP با سیگنال خروجی پیش از نوشتن در \fIsink\fP.
.TP
.B
\fB-f\fP, \fB--force-overwrite\fP
بازنویسی پرونده خروجی در صورتی که از قبل وجود داشته باشد.
.TP
.B
\fB-j\fP, \fB--jack\fP
استفاده از ورودی/خروجی Jack. برای ارسال سیگنال به aubio و شنیدن خروجی آن به یک کنترل‌کننده اتصال Jack نیاز خواهید داشت.
.TP
.B
\fB-h\fP, \fB--help\fP
چاپ یک پیام راهنمای کوتاه و خروج.
.TP
.B
\fB-v\fP, \fB--verbose\fP
حالت پرگو (نمایش جزئیات بیشتر).
.SH "روش‌های تشخیص زیروبمی (PITCH METHODS)"

روش‌های موجود عبارتند از:
.TP
.B
default
استفاده از روش پیش‌فرض \fImethod\fP
.PP
در حال حاضر، روش پیش‌فرض بر روی yinfft تنظیم شده است.
.TP
.B
schmitt
تریگر اشمیت (Schmitt trigger)
.PP
این روش استخراج زیروبمی از یک تریگر اشمیت برای تخمین دوره تناوب سیگنال استفاده می‌کند. از نظر محاسباتی بسیار کم‌هزینه است، اما به نویز نیز بسیار حساس است.
.TP
.B
fcomb
یک فیلتر شانه هارمونیک سریع (fast harmonic comb filter)
.PP
این روش استخراج زیروبمی از یک فیلتر شانه هارمونیک سریع برای تعیین بسامد پایه یک صدای هارمونیک استفاده می‌کند.
.TP
.B
mcomb
فیلتر چندشانه‌ای (multiple-comb filter)
.PP
این الگوریتم تخمین بسامد پایه، تسطیح طیفی، فیلتر چندشانه‌ای و هیستوگرام‌سازی قله‌ها را پیاده‌سازی می‌کند.
.TP
.B
specacf
تابع خودهمبستگی طیفی (Spectral auto-correlation function)
.TP
.B
yin
الگوریتم YIN
.PP
این الگوریتم توسط A. de Cheveigne و H. Kawahara توسعه یافته و اولین بار در مقاله زیر منتشر شد:
.PP
De Cheveigné, A., Kawahara, H. (2002) "YIN, a fundamental frequency
estimator for speech and music", J. Acoust. Soc. Am. 111, 1917-1930.
.TP
.B
yinfft
الگوریتم Yinfft
.PP
این الگوریتم از الگوریتم YIN مشتق شده است. در این پیاده‌سازی، از تبدیل فوریه برای محاسبه یک تابع تفاضل مربع مخروطی استفاده می‌شود که امکان وزن‌دهی طیفی را فراهم می‌سازد. به دلیل مخروطی بودن تابع تفاضل، انتخاب دوره تناوب ساده‌تر می‌شود.
.PP
Paul Brossier, Automatic annotation of musical audio for interactive systems,
Chapter 3, Pitch Analysis, PhD thesis, Centre for Digital music, Queen Mary
University of London, London, UK, 2006.
.TP
.B
yinfast
الگوریتم YIN (شتاب‌یافته)
.PP
یک پیاده‌سازی بهینه‌شده از الگوریتم YIN که نتایجی یکسان با الگوریتم اصلی YIN ارائه می‌دهد، در حالی که هزینه محاسباتی آن را از \fBO\fP(n^2) به \fBO\fP(n \fBlog\fP(n)) کاهش می‌دهد.
.SH "همچنین ببینید (SEE ALSO)"

\fBaubioonset\fP(1),
\fBaubiotrack\fP(1),
\fBaubionotes\fP(1),
\fBaubioquiet\fP(1),
\fBaubiomfcc\fP(1),
و
\fBaubiocut\fP(1).
.SH "نویسنده (AUTHOR)"

این صفحه راهنما توسط Paul Brossier <piem@aubio.org> نوشته شده است. اجازه کپی، توزیع و/یا تغییر این سند تحت شرایط مجوز عمومی همگانی گنو (GNU GPL) نسخه ۳ یا (به انتخاب شما) هر نسخه بالاتر منتشرشده توسط بنیاد نرم‌افزار آزاد داده می‌شود.