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

\fBaubio\fP [\fB-h\fP] [\fB-V\fP] <command> \.\.\.

.fam T
.fi
.fam T
.fi
.SH "دستورها (COMMANDS)"

نحو کلی دستور "\fBaubio\fP <command> <soundfile> [options]" است. دستورهای زیر در دسترس هستند:
.TP
.B
onset
دریافت زمان‌های شروع رویداد صوتی (onset)
.TP
.B
pitch
استخراج فرکانس پایه (کوک)
.TP
.B
beat
دریافت مکان‌های ضرب‌ها
.TP
.B
tempo
دریافت ضرب‌آهنگ (تمپو) کلی بر حسب ضرب در دقیقه (bpm)
.TP
.B
notes
دریافت نت‌های شبه‌میدی (midi-like)
.TP
.B
mfcc
استخراج ضرایب کپستروم مقیاس مل (MFCC)
.TP
.B
melbands
استخراج انرژی‌های فرکانس مل در هر باند
.PP
برای مشاهده فهرست دستورهای موجود، از "\fBaubio\fP \fB-h\fP" استفاده کنید. برای اطلاعات بیشتر درباره هر دستور، از "\fBaubio\fP <command> \fB--help\fP" استفاده کنید.
.SH "گزینه‌های عمومی (GENERAL OPTIONS)"

این گزینه‌ها می‌توانند پیش از تعیین هر دستوری استفاده شوند.
.TP
.B
\fB-h\fP, \fB--help\fP
نمایش پیام راهنما و خروج
.TP
.B
\fB-V\fP, \fB--version\fP
نمایش نسخه
.SH "گزینه‌های مشترک (COMMON OPTIONS)"

گزینه‌های زیر را می‌توان با تمام دستورها استفاده کرد:
.TP
.B
<source_uri>, \fB-i\fP <source_uri>, \fB--input\fP <source_uri>
پرونده صوتی ورودی برای تحلیل (الزامی)
.TP
.B
\fB-r\fP <freq>, \fB--samplerate\fP <freq>
نرخ نمونه‌برداری که پرونده باید در آن بازنمایی شود (پیش‌فرض: 0، یعنی نرخ نمونه‌برداری صدای ورودی)
.TP
.B
\fB-H\fP <size>, \fB--hopsize\fP <size>
اندازه هم‌پوشانی، تعداد نمونه‌های بین دو تحلیل پیاپی (پیش‌فرض: 256)
.TP
.B
\fB-B\fP <size>, \fB--bufsize\fP <size>
اندازه میانگیر، تعداد نمونه‌های استفاده‌شده برای هر تحلیل (مثلاً طول FFT، پیش‌فرض: 512)
.TP
.B
\fB-h\fP, \fB--help\fP
نمایش پیام راهنما و خروج
.TP
.B
\fB-T\fP format, \fB--time-format\fP format
انتخاب قالب خروجی مقادیر زمانی (samples, ms, seconds) (پیش‌فرض: seconds)
.TP
.B
\fB-v\fP, \fB--verbose\fP
نمایش خروجی مفصل (افزایش پرگویی به اندازه ۱، پیش‌فرض: 1)
.TP
.B
\fB-q\fP, \fB--quiet\fP
حالت بی‌صدا (تنظیم پرگویی روی 0)
.SH "شروع صدا (ONSET)"

گزینه‌های اضافی زیر می‌توانند با زیردستور "onset" استفاده شوند.
.TP
.B
\fB-m\fP <method>, \fB--method\fP <method>
تابع نوآوری onset
<default|energy|hfc|complex|phase|specdiff|kl|mkl|specflux> (پیش‌فرض: default)
.TP
.B
\fB-t\fP <threshold>, \fB--threshold\fP <threshold>
آستانه (پیش‌فرض: تنظیم‌نشده)
.TP
.B
\fB-s\fP <value>, \fB--silence\fP <value>
آستانه سکوت، به دسی‌بل (پیش‌فرض: \fB-70\fP)
.TP
.B
\fB-M\fP <value>, \fB--minioi\fP <value>
حداقل بازه زمانی بین دو آغاز رویداد (Inter-Onset Interval) (پیش‌فرض: 12ms)
.SH "کوک (PITCH)"

گزینه‌های اضافی زیر می‌توانند با زیردستور "pitch" استفاده شوند.
.TP
.B
\fB-m\fP <method>, \fB--method\fP <method>
روش تشخیص کوک
<default|yinfft|yin|mcomb|fcomb|schmitt> (پیش‌فرض: default، مثلاً yinfft)
.TP
.B
\fB-t\fP <threshold>, \fB--threshold\fP <threshold>
رواداری (پیش‌فرض: تنظیم‌نشده)
.TP
.B
\fB-s\fP <value>, \fB--silence\fP <value>
آستانه سکوت، به دسی‌بل (پیش‌فرض: \fB-70\fP)
.PP
اندازه میانگیر پیش‌فرض برای الگوریتم ضرب ۲048 است. اندازه گام (hop size) پیش‌فرض ۲56 است.
.SH "ضرب (BEAT)"

دستور "beat" تمامی گزینه‌های مشترک را می‌پذیرد و هیچ گزینه اضافی ندارد.
.PP
اندازه میانگیر پیش‌فرض برای الگوریتم ضرب ۱۰24 است. اندازه گام پیش‌فرض ۵12 است.
.SH "ضرب‌آهنگ (TEMPO)"

دستور "tempo" تمامی گزینه‌های مشترک را می‌پذیرد و هیچ گزینه اضافی ندارد.
.PP
اندازه میانگیر پیش‌فرض برای الگوریتم ضرب ۱۰24 است. اندازه گام پیش‌فرض ۵12 است.
.SH "نت‌ها (NOTES)"

گزینه‌های اضافی زیر می‌توانند با زیردستور "notes" استفاده شوند.
.TP
.B
\fB-s\fP <value>, \fB--silence\fP <value>
آستانه سکوت، به دسی‌بل (پیش‌فرض: \fB-70\fP)
.TP
.B
\fB-d\fP <value>, \fB--release-drop\fP <value>
سطح افت رهایش، به دسی‌بل. اگر سطح صدا از زمان شروع آخرین نت بیشتر از این مقدار افت کند، نت خاموش خواهد شد (پیش‌فرض: 10).
.SH "ضرایب کپستروم (MFCC)"

دستور "mfcc" تمامی گزینه‌های مشترک را می‌پذیرد و هیچ گزینه اضافی ندارد.
.SH "باندهای مل (MELBANDS)"

دستور "melbands" تمامی گزینه‌های مشترک را می‌پذیرد و هیچ گزینه اضافی ندارد.
.SH "مثال‌ها (EXAMPLES)"

استخراج زمان‌های شروع رویداد با استفاده از حداقل بازه بین‌رویدادی ۳۰ میلی‌ثانیه:
.PP
.nf
.fam C
    aubio onset /path/to/input_file -M 30ms

.fam T
.fi
استخراج کوک با روش "mcomb" و آستانه سکوت \fB-90dB\fP:
.PP
.nf
.fam C
    aubio pitch /path/to/input_file -m mcomb -s -90.0

.fam T
.fi
استخراج MFCC با پیاده‌سازی استاندارد Slaney:
.PP
.nf
.fam C
    aubio mfcc /path/to/input_file -r 44100


.fam T
.fi
.SH "همچنین ببینید (SEE ALSO)"

\fBaubiocut\fP(1)
.SH "نویسنده (AUTHOR)"

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