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

\fBaubionotes\fP \fIمنبع\fP
\fBaubionotes\fP [[\fB-i\fP] \fIمنبع\fP]
           [\fB-r\fP \fIنرخ\fP] [\fB-B\fP \fIپنجره\fP] [\fB-H\fP \fIگام\fP]
           [\fB-O\fP \fIروش\fP] [\fB-t\fP \fIآستانه\fP] [\fB-d\fP \fIافت\fP]
           [\fB-p\fP \fIروش\fP] [\fB-u\fP \fIواحد\fP] [\fB-l\fP \fIآستانه\fP]
           [\fB-T\fP \fIقالب-زمان\fP]
           [\fB-s\fP \fIسکوت\fP]
           [\fB-j\fP] [\fB-v\fP] [\fB-h\fP]

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

ابزار \fBaubionotes\fP تلاش می‌کند نت‌ها را با جستجوی شروع نت‌ها (onsets) و زیروبمی (pitches) شناسایی کند.
رویدادهای متوالی با استفاده از تشخیص شروع قطعه‌بندی می‌شوند، در حالی که الگوریتم استخراج فرکانس بنیادین، زیروبمی آنها را مشخص می‌کند.
.PP
هنگامی که با یک \fIمنبع\fP ورودی (\fB-i\fP/\fB--input\fP) اجرا شود، نت‌های شناسایی‌شده بر روی خروجی استاندارد، بر حسب ثانیه و شماره نت میدی (midi) چاپ می‌شوند.
.PP
هنگامی که بدون منبع ورودی، یا با گزینه جک (\fB-j\fP/\fB--jack\fP) آغاز شود، \fBaubionotes\fP در حالت jack اجرا می‌شود.
.SH "گزینه‌ها (OPTIONS)"

این برنامه از ساختار نحوی معمول خط فرمان گنو پیروی می‌کند که در آن گزینه‌های طولانی با دو خط تیره (--) آغاز می‌شوند. خلاصه‌ای از گزینه‌ها در زیر آمده است.
.TP
.B
\fB-i\fP, \fB--input\fP \fIمنبع\fP
اجرای تحلیل بر روی این فایل صوتی. بیشتر قالب‌های غیرفشرده و فشرده، بسته به نحوه ساخت aubio، پشتیبانی می‌شوند.
.TP
.B
\fB-r\fP, \fB--samplerate\fP \fIنرخ\fP
خواندن \fIمنبع\fP ورودی، بازنمونه‌برداری‌شده در \fIنرخ\fP نمونه‌برداری مشخص‌شده. \fIنرخ\fP باید بر حسب هرتز به صورت عدد صحیح تعیین شود. در صورت مقدار ۰، از نرخ نمونه‌برداری منبع اصلی استفاده خواهد شد. پیش‌فرض ۰ است.
.TP
.B
\fB-B\fP, \fB--bufsize\fP \fIپنجره\fP
اندازه بافر برای تحلیل، که همان طول پنجره مورد استفاده برای محاسبات طیفی و زمانی است. پیش‌فرض ۵۱۲ است.
.TP
.B
\fB-H\fP, \fB--hopsize\fP \fIگام\fP
تعداد نمونه‌های میان دو تحلیل متوالی. پیش‌فرض ۲۵۶ است.
.TP
.B
\fB-O\fP, \fB--onset\fP \fIروش\fP
\fIروش\fP تشخیص شروع نت جهت استفاده. بخش «روش‌های شروع» را در زیر ببینید. پیش‌فرض 'default' است.
.TP
.B
\fB-t\fP, \fB--onset-threshold\fP \fIآستانه\fP
تنظیم مقدار آستانه برای گزینش قله شروع. مقادیر معمول عموماً بین ۰.۰۰۱ و ۰.۹۰۰ هستند. پیش‌فرض ۰.۱ است. مقادیر آستانه پایین‌تر به معنی تشخیص شروع‌های بیشتر است. در صورت تشخیص بیش از حد، مقدار ۰.۵ را امتحان کنید. پیش‌فرض ۰.۳ است.
.TP
.B
\fB-M\fP, \fB--minioi\fP مقدار
تنظیم حداقل فاصله میان دو شروع متوالی، بر حسب ثانیه؛ کوتاه‌ترین فاصله زمانی میان دو نت متوالی. پیش‌فرض ۰.۰۳۰ است.
.TP
.B
\fB-p\fP, \fB--pitch\fP \fIروش\fP
\fIروش\fP تشخیص زیروبمی صدا جهت استفاده. بخش «روش‌های زیروبمی» را در زیر ببینید. پیش‌فرض 'default' است.
.TP
.B
\fB-u\fP, \fB--pitch\fP-\fIunit\fP \fIواحد\fP
\fIواحد\fP مورد استفاده برای چاپ فرکانس‌ها. مقادیر ممکن عبارتند از midi، bin، cent و Hz. پیش‌فرض 'Hz' است.
.TP
.B
\fB-l\fP, \fB--pitch-tolerance\fP \fIآستانه\fP
تنظیم میزان رواداری (تلرانس) برای الگوریتم تشخیص زیروبمی صدا. مقادیر معمول بین ۰.۲ و ۰.۹ متغیر است. نامزدهای زیروبمی که با اطمینانی کمتر از این آستانه یافت شوند انتخاب نخواهند شد. هر چه آستانه بالاتر باشد، اطمینان به نامزدها بیشتر است. پیش‌فرض تنظیم‌نشده است.
.TP
.B
\fB-s\fP, \fB--silence\fP \fIسکوت\fP
تنظیم آستانه سکوت بر حسب دسی‌بل (dB) که در کمتر از آن زیروبمی تشخیص داده نخواهد شد. مقدار \fB-20.0\fP بیشتر شروع‌ها را به جز بلندترین‌ها حذف می‌کند. مقدار \fB-90.0\fP همه شروع‌ها را برمی‌گزیند. پیش‌فرض \fB-90.0\fP است.
.TP
.B
\fB-d\fP, \fB--release\fP-\fIdrop\fP
تنظیم آستانه افت رهایش (release drop) بر حسب دسی‌بل. اگر سطح صدا از زمان شروع آخرین نت بیش از این مقدار افت کند، نت خاموش خواهد شد. پیش‌فرض ۱۰ است.
.TP
.B
\fB-T\fP, \fB--timeformat\fP قالب
تنظیم قالب زمان (samples، ms، seconds). پیش‌فرض seconds است.
.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 "روش‌های شروع (ONSET METHODS)"

روش‌های موجود: default، energy، hfc، complex، phase، specdiff، kl، mkl، specflux.
.PP
برای جزئیات درباره این روش‌ها به \fBaubioonset\fP(1) مراجعه کنید.
.SH "روش‌های زیروبمی (PITCH METHODS)"

روش‌های موجود: default، schmitt، fcomb، mcomb، specacf، yin، yinfft، yinfast.
.PP
برای جزئیات درباره این روش‌ها به \fBaubiopitch\fP(1) مراجعه کنید.
.SH "همچنین ببینید (SEE ALSO)"

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

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