.\" Text automatically generated by txt2man
.TH AUBIOCUT 1 "04 August 2026" "aubio 0.4.9" "راهنمای کاربر aubio"
.SH "نام (NAME)"
aubiocut \- ابزار قطعهبندی و برش فایلهای صوتی در نقاط شروع صدا یا ضربها

.SH "خلاصه دستور (SYNOPSIS)"
.nf
.fam C

\fBaubiocut\fP \fIsource\fP
\fBaubiocut\fP [[\fB\-i\fP] \fIsource\fP]
         [\fB\-r\fP \fIrate\fP] [\fB\-B\fP \fIwin\fP] [\fB\-H\fP \fIhop\fP]
         [\fB\-O\fP \fImethod\fP] [\fB\-t\fP \fIthres\fP]
         [\fB\-b\fP] [\fB\-c\fP]
         [\fB\-v\fP] [\fB\-q\fP] [\fB\-h\fP]

.fam T
.fi
.SH "گزینه‌ها (OPTIONS)"

این برنامه از ساختار نحوی معمول خط فرمان گنو پیروی می‌کند که در آن گزینه‌های طولانی با دو خط تیره (\-\-) آغاز می‌شوند. خلاصه‌ای از گزینه‌ها در زیر آمده است:
.TP
.B
\fB\-i\fP, \fB\-\-input\fP \fIsource\fP
اجرای تحلیل بر روی این فایل صوتی. بیشتر قالب‌های فشرده و غیرفشرده، بسته به نحوه کامپایل aubio، پشتیبانی می‌شوند.
.TP
.B
\fB\-r\fP, \fB\-\-samplerate\fP \fIrate\fP
خواندن \fIsource\fP ورودی، بازنمونه‌برداری‌شده در نرخ نمونه‌برداری (\fIrate\fP) مشخص‌شده. مقدار \fIrate\fP باید بر حسب هرتز و به صورت یک عدد صحیح مشخص شود. در صورت تنظیم روی 0، نرخ نمونه‌برداری منبع اصلی (\fIsource\fP) استفاده خواهد شد. مقدار پیش‌فرض 0 است.
.TP
.B
\fB\-B\fP, \fB\-\-bufsize\fP \fIwin\fP
اندازه بافر برای تحلیل، که همان طول پنجره مورد استفاده برای محاسبات طیفی و زمانی است. مقدار پیش‌فرض 512 است.
.TP
.B
\fB\-H\fP, \fB\-\-hopsize\fP \fIhop\fP
تعداد نمونه‌های میان دو تحلیل متوالی. مقدار پیش‌فرض 256 است.
.TP
.B
\fB\-O\fP, \fB\-\-onset\fP \fImethod\fP
روش تشخیص شروع صدا (\fImethod\fP) جهت استفاده. بخش «روش‌های شروع صدا (ONSET METHODS)» در زیر را ببینید. مقدار پیش‌فرض 'default' است.
.TP
.B
\fB\-b\fP, \fB\-\-beat\fP
استفاده از موقعیت‌های ضرب (beat) به جای موقعیت‌های شروع صدا (onset).
.TP
.B
\fB\-t\fP, \fB\-\-onset\-threshold\fP \fIthres\fP
تنظیم مقدار آستانه برای گزینش قله شروع صدا (onset peak picking). مقادیر معمولاً در بازه [0.001, 0.900] هستند. مقادیر آستانه پایین‌تر به معنای تشخیص شروع‌های بیشتر است. افزایش این آستانه باید تعداد تشخیص‌های نادرست را کاهش دهد. مقدار پیش‌فرض 0.3 است.
.TP
.B
\fB\-c\fP, \fB\-\-cut\fP
برش فایل صوتی ورودی در برچسب‌های شناسایی‌شده. یک فایل صوتی جدید برای هر قطعه در دایرکتوری جاری ایجاد خواهد شد.
.TP
.B
\fB\-o\fP, \fB\-\-output\fP \fIdirectory\fP
مشخص کردن مسیر دایرکتوری که قطعات فایل صوتی اصلی (\fIsource\fP) باید در آنجا ایجاد شوند.
.TP
.B
\fB\-\-cut\-until\-nsamples\fP \fIn\fP
تعیین تعداد نمونه‌های اضافی که باید به انتهای هر قطعه اضافه شوند (پیش‌فرض 0).
.TP
.B
\fB\-\-cut\-until\-nslices\fP \fIn\fP
تعیین تعداد قطعات اضافی که باید به انتهای هر قطعه اضافه شوند (پیش‌فرض 0).
.TP
.B
\fB\-\-create\-first\fP
همیشه قطعه اول ایجاد شود.
.TP
.B
\fB\-h\fP, \fB\-\-help\fP
چاپ یک پیام راهنمای کوتاه و خروج.
.TP
.B
\fB\-v\fP, \fB\-\-verbose\fP
حالت پرگو (نمایش جزئیات بیشتر).
.TP
.B
\fB\-q\fP, \fB\-\-quiet\fP
حالت بی‌صدا (عدم نمایش پیام‌ها).

.SH "روش‌های شروع صدا (ONSET METHODS)"

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

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

\fBaubioonset\fP(1)،
\fBaubiopitch\fP(1)،
\fBaubiotrack\fP(1)،
\fBaubionotes\fP(1)،
\fBaubioquiet\fP(1)،
و
\fBaubiomfcc\fP(1).

.SH "نویسنده (AUTHOR)"

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