.TH GR_PLOT_PSD "1" "2026-08-16" "gr_plot_psd 3.10.12.0" "User Commands"
.SH "نام (NAME)"
gr_plot_psd \- رسم چگالی طیفی توان گنو رادیو (GNU Radio)
.SH "خلاصه دستور (SYNOPSIS)"
.B gr_plot_psd:
[\fIoptions\fR] \fIinput_filename\fR
.SH "توضیحات (DESCRIPTION)"
یک فایل باینری گنو رادیو (GNU Radio) را (با نوع داده مشخص‌شده توسط گزینه \fB\-\-data\-type\fR) دریافت کرده و داده‌های I&Q را در برابر زمان و همچنین نمودار چگالی طیفی توان (PSD) نمایش می‌دهد. مقادیر محور y با فرض ولت به عنوان دامنه جریان‌های I&Q رسم شده و در حوزه فرکانس به dBm تبدیل می‌شوند (تعدیل توان 1/N حاصل از FFT به‌صورت داخلی انجام می‌گیرد). این اسکریپت هر بار بلوک مشخصی از داده‌ها را رسم می‌کند که در خط فرمان با \fB\-B\fR یا \fB\-\-block\fR مشخص می‌شود. موقعیت شروع در فایل را می‌توان با تعیین \fB\-s\fR یا \fB\-\-start\fR تنظیم کرد که به‌طور پیش‌فرض 0 (ابتدای فایل) است. به‌طور پیش‌فرض، سیستم نرخ نمونه‌برداری را برابر با 1 در نظر می‌گیرد، بنابراین در بعد زمان، هر نمونه در برابر شماره نمونه رسم می‌شود. برای تنظیم یک محور زمانی و فرکانسی واقعی، نرخ نمونه‌برداری (\fB\-R\fR یا \fB\-\-sample\-rate\fR) را روی همان نرخ نمونه‌برداری استفاده‌شده هنگام ضبط نمونه‌ها تنظیم کنید. در نهایت، اندازه FFT مورد استفاده برای نمودارهای PSD و اسپکتوگرام (spectrogram) را می‌توان به ترتیب و به‌طور مستقل با \fB\-\-psd\-size\fR و \fB\-\-spec\-size\fR مشخص کرد. نمودار اسپکتوگرام به‌طور پیش‌فرض نمایش داده نمی‌شود و با \fB\-S\fR یا \fB\-\-enable\-spec\fR فعال می‌شود.
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-h\fR, \fB\-\-help\fR
نمایش این پیام راهنما و خروج
.TP
\fB\-d\fR DATA_TYPE, \fB\-\-data\-type\fR=\fIDATA_TYPE\fR
مشخص کردن نوع داده (complex64, float32, (u)int32, (u)int16, (u)int8) [پیش‌فرض: complex64]
.TP
\fB\-B\fR BLOCK, \fB\-\-block\fR=\fIBLOCK\fR
مشخص کردن اندازه بلوک [پیش‌فرض: 8192]
.TP
\fB\-s\fR START, \fB\-\-start\fR=\fISTART\fR
مشخص کردن محل شروع در فایل [پیش‌فرض: 0]
.TP
\fB\-R\fR SAMPLE_RATE, \fB\-\-sample\-rate\fR=\fISAMPLE_RATE\fR
تنظیم نرخ نمونه‌برداری داده‌ها [پیش‌فرض: 1.0]
.TP
\fB\-\-psd\-size\fR=\fIPSD_SIZE\fR
تنظیم اندازه FFT برای PSD [پیش‌فرض: 1024]
.TP
\fB\-\-spec\-size\fR=\fISPEC_SIZE\fR
تنظیم اندازه FFT برای اسپکتوگرام [پیش‌فرض: 256]
.TP
\fB\-S\fR, \fB\-\-enable\-spec\fR
فعال‌سازی رسم اسپکتوگرام [پیش‌فرض: False]
.SH "همچنین ببینید (SEE ALSO)"
gr_plot_psd_c(1) gr_plot_psd_f(1)