.\" 
.\" Copyright (c) 2003, 2007-14 Matteo Frigo
.\" Copyright (c) 2003, 2007-14 Massachusetts Institute of Technology
.\" 
.\" This program is free software; you can redistribute it and/or modify
.\" it under the terms of the GNU General Public License as published by
.\" the Free Software Foundation; either version 2 of the License, or
.\" (at your option) any later version.
.\" 
.\" This program is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
.\" GNU General Public License for more details.
.\" 
.\" You should have received a copy of the GNU General Public License
.\" along with this program; if not, write to the Free Software
.\" Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
.\"
.TH FFTW-WISDOM 1 "February, 2003" "fftw" "fftw"
.SH "نام (NAME)"
fftwq\-wisdom \- ایجاد وِزدوم (تبدیل‌های فوریه از پیش بهینه‌سازی‌شده)
.SH "خلاصه دستور (SYNOPSIS)"
.B fftwq\-wisdom
[\fIگزینه\fR]... [\fIاندازه\fR]...
.SH "توضیحات (DESCRIPTION)"
.PP
دستور
.I fftwq\-wisdom
ابزاری برای تولید فایل‌های
.B wisdom
در FFTW است؛ این فایل‌ها حاوی اطلاعات ذخیره‌شده درباره نحوه محاسبه بهینه تبدیل‌های (فوریه) در اندازه‌های مختلف هستند. FFTW یک کتابخانه آزاد برای محاسبه تبدیل‌های فوریه گسسته در یک یا چند بُعد، برای اندازه‌های دلخواه و هم برای داده‌های حقیقی و هم مختلط، به همراه سایر عملیات مرتبط است. اطلاعات بیشتر درباره FFTW در صفحه خانگی آن در دسترس است:
.I http://www.fftw.org
.PP
برنامه‌هایی که از FFTW استفاده می‌کنند می‌توانند طوری نوشته شوند که wisdom را از یک فایل، رشته یا منبع دلخواه دیگر بارگذاری نمایند. علاوه بر این، بسیاری از برنامه‌های مبتنی بر FFTW فایل \fBsystem wisdom\fR را بارگذاری می‌کنند که به طور پیش‌فرض در مسیر
.I /etc/fftw/wisdomq
ذخیره شده است. از
.I fftwq\-wisdom
می‌توان برای ایجاد یا افزودن به چنین فایل‌های wisdom استفاده کرد. در متداول‌ترین حالت استفاده، می‌توان فایل wisdom را با پیش‌برنامه‌ریزی مجموعه‌ای کانونیکال (استاندارد) از اندازه‌ها (توضیح داده شده در زیر) از طریق دستور زیر ایجاد نمود:

.ce
fftwq\-wisdom \-v \-c \-o wisdomq

(این فرایند ساعت‌ها زمان خواهد برد، اما این زمان را می‌توان با استفاده از گزینه
.B \-t
محدود کرد) و سپس فایل خروجی
.I wisdomq
را می‌توان (با دسترسی مدیر سیستم / root) در مسیر
.I /etc/fftw/
یا هر مسیر دیگر کپی کرد.
.PP
برنامه
.I fftwq\-wisdom
به طور معمول wisdom را مستقیماً در خروجی استاندارد می‌نویسد، اما این رفتار را می‌توان با استفاده از گزینه
.B \-o
تغییر داد، همان‌طور که در مثال بالا نشان داده شده است.
.PP
اگر فایل wisdom سیستمی
.I /etc/fftw/wisdomq
از قبل وجود داشته باشد،
.I fftwq\-wisdom
این wisdom موجود را می‌خواند (مگر اینکه گزینه
.B \-n
مشخص شده باشد) و هم wisdom قدیمی و هم هر wisdom جدید تولیدشده را در خروجی قرار می‌دهد. به این ترتیب، می‌توان از آن برای افزودن اندازه‌های تبدیل جدید به wisdom موجود سیستم (یا فایل wisdom دیگر، با استفاده از گزینه
.BR \-w )
استفاده کرد.
.SH "تعیین اندازه‌ها (SPECIFYING SIZES)"
اگرچه یک مجموعه کانونیکال از اندازه‌ها برای بهینه‌سازی از طریق گزینه
.B \-c
مشخص می‌شود، اما کاربر می‌تواند صفر یا چند اندازه و نوع تبدیل غیرکانونیکال را نیز برای بهینه‌سازی از طریق آرگومان‌های
.I SIZE
پس از گزینه‌ها تعیین کند. همچنین در صورتی که آرگومان
.I SIZE
برابر با "\-" داده شود، اندازه‌های مورد نظر برای بهینه‌سازی را می‌توان از ورودی استاندارد (جداشده با فاصله) خواند.
.PP
اندازه‌ها با نحو (سینتکس) زیر مشخص می‌شوند:

.ce
<\fItype\fR><\fIinplace\fR><\fIdirection\fR><\fIgeometry\fR>
.PP
بخش <\fItype\fR> برابر با \'c\' (مختلط / complex)، \'r\' (حقیقی / real, r2c/c2r) یا \'k\' (تبدیل‌های r2r بر حسب نوع هر بُعد، مشخص‌شده در هندسه در ادامه) است.
.PP
بخش <\fIinplace\fR> برابر با \'i\' (درجا / in-place) یا \'o\' (نادرجا / out-of-place) است.
.PP
بخش <\fIdirection\fR> برابر با \'f\' (مستقیم / forward) یا \'b\' (معکوس / backward) است. بخش <\fIdirection\fR> باید برای تبدیل‌های \'k\' حذف شود، زیرا جهت آن در بخش هندسه تعیین می‌شود.
.PP
بخش <\fIgeometry\fR> نشان‌دهنده اندازه و ابعاد تبدیل است، که در آن ابعاد مختلف با \'x\' از یکدیگر جدا می‌شوند (برای مثال \'16x32\' برای یک تبدیل دوبعدی ۱۶ در ۳۲). در مورد تبدیل‌های \'k\'، اندازه هر بُعد با یک رشته "نوع" همراه است که می‌تواند یکی از مقادیر f/b/h/e00/e01/e10/e11/o00/o01/o10/o11 به ترتیب برای R2HC/HC2R/DHT/REDFT00/.../RODFT11 باشد، همان‌گونه که در راهنمای FFTW تعریف شده است.
.PP
به عنوان مثال، \'cif12x13x14\' یک تبدیل فوریه گسسته (DFT) مختلط سه‌بعدی ۱۲ در ۱۳ در ۱۴ است که به صورت درجا عمل می‌کند. عبارت \'rob65536\' یک تبدیل یک‌بعدی با اندازه ۶۵۵۳۶ از مختلط به حقیقی (معکوس) و نادرجا است که روی ورودی دارای تقارن هرمیتی اعمال می‌شود. همچنین \'ki10hx20e01\' یک تبدیل دوبعدی ۱۰ در ۲۰ از نوع r2r است که بُعد اول آن DHT و بُعد دوم آن REDFT01 (یا DCT-III) است.
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-h\fR, \fB\-\-help\fR
نمایش راهنمای گزینه‌ها و نحوه استفاده از خط فرمان.
.TP
\fB\-V\fR, \fB\-\-version\fR
چاپ شماره نسخه و اطلاعات حق نشر.
.TP
\fB\-v\fR, \fB\-\-verbose\fR
خروجی پرجزئیات. (می‌توانید این گزینه را چند بار مشخص کنید یا یک آرگومان عددی بزرگتر از ۱ بدهید تا سطح جزئیات افزایش یابد.) توجه داشته باشید که خروجی پرجزئیات با خروجی wisdom ترکیب خواهد شد (که ایمپورت آن را غیرممکن می‌سازد)، مگر اینکه wisdom را با استفاده از گزینه
.B \-o
در یک فایل بنویسید.
.TP
\fB\-c\fR, \fB\-\-canonical\fR
بهینه‌سازی/پیش‌برنامه‌ریزی مجموعه‌ای کانونیکال از اندازه‌ها: تمام توان‌های دو و ده تا 2^20 (۱۰۴۸۵۷۶)، شامل تبدیلات حقیقی و مختلط، مستقیم و معکوس، درجا و نادرجا. همچنین شامل تبدیلات دو و سه‌بعدی با ابعاد هم‌اندازه (مانند 16x16x16).
.TP
\fB\-t\fR \fIhours\fR, \fB\-\-time\-limit\fR=\fIhours\fR
توقف پس از سپری شدن زمان
.I hours
(به ساعت)، و خروجی دادن wisdom انباشته‌شده. (مسائل به ترتیب صعودی اندازه برنامه‌ریزی می‌شوند.) مقدار پیش‌فرض 0 است که به معنای عدم وجود محدودیت زمانی است.
.TP
\fB\-o\fR \fIfile\fR, \fB\-\-output-file\fR=\fIfile\fR
ارسال خروجی wisdom به
.I file
به جای خروجی استاندارد (حالت پیش‌فرض).
.TP
\fB\-m\fR, \fB\-\-measure\fR; \fB\-e\fR, \fB\-\-estimate\fR; \fB\-x\fR, \fB\-\-exhaustive\fR
به طور معمول،
.I fftwq\-wisdom
برنامه‌ها را در حالت FFTW_PATIENT ایجاد می‌کند، اما با این گزینه‌ها می‌توانید به ترتیب از حالت‌های FFTW_MEASURE، FFTW_ESTIMATE یا FFTW_EXHAUSTIVE استفاده کنید، همان‌طور که در راهنمای FFTW با جزئیات بیشتری توضیح داده شده است.
.IP
توجه داشته باشید که wisdom با سطح صبر برنامه‌ریزی برچسب‌گذاری می‌شود و یک فایل واحد می‌تواند سطوح مختلفی از wisdom را در خود ترکیب کند (به عنوان مثال، می‌توانید اکثراً از حالت پیش‌فرض صبورانه استفاده کنید، اما برای چند اندازه که اهمیت ویژه‌ای دارند در حالت
.B \-\-exhaustive
برنامه‌ریزی انجام دهید).
.TP
\fB\-n\fR, \fB\-\-no\-system\-wisdom\fR
عدم ایمپورت wisdom سیستم از
.I /etc/fftw/wisdomq
(که معمولاً به طور پیش‌فرض خوانده می‌شود).
.TP
\fB\-w\fR \fIfile\fR, \fB\-\-wisdom\-file\fR=\fIfile\fR
ایمپورت wisdom از
.I file
(علاوه بر wisdom سیستم، مگر اینکه
.B \-n
مشخص شده باشد). می‌توان چندین فایل wisdom را با تکرار گزینه
.B \-w
خواند. اگر
.I file
برابر با "\-" باشد، wisdom از ورودی استاندارد خوانده می‌شود.
.TP
\fB\-T\fR \fIN\fR, \fB\--threads\fR=\fIN\fR
برنامه‌ریزی با
.I N
نخ (Thread). این گزینه تنها در صورتی فعال است که FFTW با پشتیبانی از نخ‌ها پیکربندی شده باشد.
.SH "گزارش باگ‌ها (BUGS)"
گزارش‌های اشکال را به fftw@fftw.org ارسال کنید.
.SH "نویسندگان (AUTHORS)"
نوشته‌شده توسط Steven G. Johnson و Matteo Frigo.
.PP
Copyright (c) 2003, 2007-14 Matteo Frigo
.br
Copyright (c) 2003, 2007-14 Massachusetts Institute of Technology
.SH "همچنین ببینید (SEE ALSO)"
.BR fftw-wisdom-to-conf (1)