نام (NAME)

aubio - ابزار خط فرمان برای استخراج اطلاعات از پرونده‌های صوتی

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

aubio [-h] [-V] <command> ...

دستورها (COMMANDS)

نحو کلی دستور "aubio <command> <soundfile> [options]" است. دستورهای زیر در دسترس هستند:

onset: دریافت زمان‌های شروع رویداد صوتی (onset)
pitch: استخراج فرکانس پایه (کوک)
beat: دریافت مکان‌های ضرب‌ها
tempo: دریافت ضرب‌آهنگ (تمپو) کلی بر حسب ضرب در دقیقه (bpm)
notes: دریافت نت‌های شبه‌میدی (midi-like)
mfcc: استخراج ضرایب کپستروم مقیاس مل (MFCC)
melbands: استخراج انرژی‌های فرکانس مل در هر باند

برای مشاهده فهرست دستورهای موجود، از "aubio -h" استفاده کنید. برای اطلاعات بیشتر درباره هر دستور، از "aubio <command> --help" استفاده کنید.

گزینه‌های عمومی (GENERAL OPTIONS)

این گزینه‌ها می‌توانند پیش از تعیین هر دستوری استفاده شوند.

-h, --help: نمایش پیام راهنما و خروج
-V, --version: نمایش نسخه

گزینه‌های مشترک (COMMON OPTIONS)

گزینه‌های زیر را می‌توان با تمام دستورها استفاده کرد:

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

شروع صدا (ONSET)

گزینه‌های اضافی زیر می‌توانند با زیردستور "onset" استفاده شوند.

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

کوک (PITCH)

گزینه‌های اضافی زیر می‌توانند با زیردستور "pitch" استفاده شوند.

-m <method>, --method <method>: روش تشخیص کوک <default|yinfft|yin|mcomb|fcomb|schmitt> (پیش‌فرض: default، مثلاً yinfft)
-t <threshold>, --threshold <threshold>: رواداری (پیش‌فرض: تنظیم‌نشده)
-s <value>, --silence <value>: آستانه سکوت، به دسی‌بل (پیش‌فرض: -70)

اندازه میانگیر پیش‌فرض برای الگوریتم ضرب ۲048 است. اندازه گام (hop size) پیش‌فرض ۲56 است.

ضرب (BEAT)

دستور "beat" تمامی گزینه‌های مشترک را می‌پذیرد و هیچ گزینه اضافی ندارد.

اندازه میانگیر پیش‌فرض برای الگوریتم ضرب ۱۰24 است. اندازه گام پیش‌فرض ۵12 است.

ضرب‌آهنگ (TEMPO)

دستور "tempo" تمامی گزینه‌های مشترک را می‌پذیرد و هیچ گزینه اضافی ندارد.

اندازه میانگیر پیش‌فرض برای الگوریتم ضرب ۱۰24 است. اندازه گام پیش‌فرض ۵12 است.

نت‌ها (NOTES)

گزینه‌های اضافی زیر می‌توانند با زیردستور "notes" استفاده شوند.

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

ضرایب کپستروم (MFCC)

دستور "mfcc" تمامی گزینه‌های مشترک را می‌پذیرد و هیچ گزینه اضافی ندارد.

باندهای مل (MELBANDS)

دستور "melbands" تمامی گزینه‌های مشترک را می‌پذیرد و هیچ گزینه اضافی ندارد.

مثال‌ها (EXAMPLES)

استخراج زمان‌های شروع رویداد با استفاده از حداقل بازه بین‌رویدادی ۳۰ میلی‌ثانیه:

aubio onset /path/to/input_file -M 30ms

استخراج کوک با روش "mcomb" و آستانه سکوت -90dB:

aubio pitch /path/to/input_file -m mcomb -s -90.0

استخراج MFCC با پیاده‌سازی استاندارد Slaney:

aubio mfcc /path/to/input_file -r 44100

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

aubiocut(1)

نویسنده (AUTHOR)

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