نام (NAME)

aubionotes - ابزار خط فرمانی برای استخراج نت‌های موسیقی

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

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

توضیحات (DESCRIPTION)

ابزار aubionotes تلاش می‌کند نت‌ها را با جستجوی شروع نت‌ها (onsets) و زیروبمی (pitches) شناسایی کند. رویدادهای متوالی با استفاده از تشخیص شروع قطعه‌بندی می‌شوند، در حالی که الگوریتم استخراج فرکانس بنیادین، زیروبمی آنها را مشخص می‌کند.

هنگامی که با یک منبع ورودی (-i/--input) اجرا شود، نت‌های شناسایی‌شده بر روی خروجی استاندارد، بر حسب ثانیه و شماره نت میدی (midi) چاپ می‌شوند.

هنگامی که بدون منبع ورودی، یا با گزینه جک (-j/--jack) آغاز شود، aubionotes در حالت jack اجرا می‌شود.

گزینه‌ها (OPTIONS)

این برنامه از ساختار نحوی معمول خط فرمان گنو پیروی می‌کند که در آن گزینه‌های طولانی با دو خط تیره (--) آغاز می‌شوند. خلاصه‌ای از گزینه‌ها در زیر آمده است.

-i, --input منبع: اجرای تحلیل بر روی این فایل صوتی. بیشتر قالب‌های غیرفشرده و فشرده، بسته به نحوه ساخت aubio، پشتیبانی می‌شوند.
-r, --samplerate نرخ: خواندن منبع ورودی، بازنمونه‌برداری‌شده در نرخ نمونه‌برداری مشخص‌شده. نرخ باید بر حسب هرتز به صورت عدد صحیح تعیین شود. در صورت مقدار ۰، از نرخ نمونه‌برداری منبع اصلی استفاده خواهد شد. پیش‌فرض ۰ است.
-B, --bufsize پنجره: اندازه بافر برای تحلیل، که همان طول پنجره مورد استفاده برای محاسبات طیفی و زمانی است. پیش‌فرض ۵۱۲ است.
-H, --hopsize گام: تعداد نمونه‌های میان دو تحلیل متوالی. پیش‌فرض ۲۵۶ است.
-O, --onset روش: روش تشخیص شروع نت جهت استفاده. بخش «روش‌های شروع» را در زیر ببینید. پیش‌فرض 'default' است.
-t, --onset-threshold آستانه: تنظیم مقدار آستانه برای گزینش قله شروع. مقادیر معمول عموماً بین ۰.۰۰۱ و ۰.۹۰۰ هستند. پیش‌فرض ۰.۱ است. مقادیر آستانه پایین‌تر به معنی تشخیص شروع‌های بیشتر است. در صورت تشخیص بیش از حد، مقدار ۰.۵ را امتحان کنید. پیش‌فرض ۰.۳ است.
-M, --minioi مقدار: تنظیم حداقل فاصله میان دو شروع متوالی، بر حسب ثانیه؛ کوتاه‌ترین فاصله زمانی میان دو نت متوالی. پیش‌فرض ۰.۰۳۰ است.
-p, --pitch روش: روش تشخیص زیروبمی صدا جهت استفاده. بخش «روش‌های زیروبمی» را در زیر ببینید. پیش‌فرض 'default' است.
-u, --pitch-unit واحد: واحد مورد استفاده برای چاپ فرکانس‌ها. مقادیر ممکن عبارتند از midi، bin، cent و Hz. پیش‌فرض 'Hz' است.
-l, --pitch-tolerance آستانه: تنظیم میزان رواداری (تلرانس) برای الگوریتم تشخیص زیروبمی صدا. مقادیر معمول بین ۰.۲ و ۰.۹ متغیر است. نامزدهای زیروبمی که با اطمینانی کمتر از این آستانه یافت شوند انتخاب نخواهند شد. هر چه آستانه بالاتر باشد، اطمینان به نامزدها بیشتر است. پیش‌فرض تنظیم‌نشده است.
-s, --silence سکوت: تنظیم آستانه سکوت بر حسب دسی‌بل (dB) که در کمتر از آن زیروبمی تشخیص داده نخواهد شد. مقدار -20.0 بیشتر شروع‌ها را به جز بلندترین‌ها حذف می‌کند. مقدار -90.0 همه شروع‌ها را برمی‌گزیند. پیش‌فرض -90.0 است.
-d, --release-drop: تنظیم آستانه افت رهایش (release drop) بر حسب دسی‌بل. اگر سطح صدا از زمان شروع آخرین نت بیش از این مقدار افت کند، نت خاموش خواهد شد. پیش‌فرض ۱۰ است.
-T, --timeformat قالب: تنظیم قالب زمان (samples، ms، seconds). پیش‌فرض seconds است.
-j, --jack: استفاده از ورودی/خروجی Jack. برای هدایت سیگنال به aubio و شنیدن خروجی آن به یک کنترل‌کننده اتصال Jack نیاز خواهید داشت.
-h, --help: چاپ پیام راهنمای کوتاه و خروج.
-v, --verbose: خروجی با جزئیات کامل.

روش‌های شروع (ONSET METHODS)

روش‌های موجود: default، energy، hfc، complex، phase، specdiff، kl، mkl، specflux.

برای جزئیات درباره این روش‌ها به aubioonset(1) مراجعه کنید.

روش‌های زیروبمی (PITCH METHODS)

روش‌های موجود: default، schmitt، fcomb، mcomb، specacf، yin، yinfft، yinfast.

برای جزئیات درباره این روش‌ها به aubiopitch(1) مراجعه کنید.

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

aubioonset(1)، aubiopitch(1)، aubiotrack(1)، aubioquiet(1)، aubiomfcc(1)، و aubiocut(1).

نویسنده (AUTHOR)

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