.\" 
.\" 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-TO-CONF 1 "February, 2003" "fftw" "fftw"
.SH "نام (NAME)"
fftw\-wisdom\-to\-conf \- تولید فایل‌های پیکربندی C بر اساس خرد محاسباتی (wisdom) کتابخانه FFTW
.SH "خلاصه دستور (SYNOPSIS)"
\fBfftw\-wisdom\-to\-conf\fR [< \fIINPUT\fR] [> \fIOUTPUT\fR]
.SH "توضیحات (DESCRIPTION)"
.PP
.\" Add any additional description here
ابزار
.I fftw\-wisdom\-to\-conf
یک ابزار کمکی برای تولید روتین‌های
.B پیکربندی
زبان C از روی فایل‌های
.B خرد محاسباتی (wisdom)
کتابخانه FFTW است؛ فایل‌های wisdom حاوی اطلاعات ذخیره‌شده درباره نحوه محاسبه بهینه تبدیل‌های (فوریه) در اندازه‌های گوناگون هستند. یک روتین پیکربندی، زیرروالی به زبان C است که آن را به برنامه خود پیوند (link) می‌دهید تا جایگزین روتینی به همین نام در کتابخانه FFTW شود؛ این روتین مشخص می‌کند چه بخش‌هایی از FFTW توسط برنامه شما قابل فراخوانی هستند.

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

کتابخانه FFTW یک کتابخانه آزاد برای محاسبه تبدیلات گسسته فوریه در یک یا چند بعد، برای اندازه‌های دلخواه و هم برای داده‌های حقیقی و هم مختلط در کنار سایر عملیات مرتبط است. اطلاعات بیشتر درباره FFTW را می‌توانید در وبگاه رسمی FFTW بیابید:
.I http://www.fftw.org

ابزار
.I fftw\-wisdom\-to\-conf
اطلاعات wisdom را از ورودی استاندارد می‌خواند و پیکربندی حاصل را در خروجی استاندارد می‌نویسد. این برنامه به آسانی با ابزار
.I fftw\-wisdom
ترکیب می‌شود؛ برای نمونه:

fftw\-wisdom \-n \-o wisdom cof1024 cob1024
.br
fftw\-wisdom\-to\-conf < wisdom > conf.c

یک فایل پیکربندی "conf.c" ایجاد می‌کند که تنها حاوی آن بخش‌هایی از FFTW است که برای تبدیلات برون‌جایگاهی (out-of-place) بهینه‌شده مختلط رفت و برگشت با اندازه ۱۰۲۴ مورد نیاز است (و همچنین خود wisdom را در فایل "wisdom" ذخیره می‌کند).

به عنوان روشی دیگر، می‌توانید برنامه واقعی خود را اجرا کنید، wisdom را برای همه برنامه‌ریزی‌های (plans) ایجادشده برون‌ریزی کنید (ترجیحاً در حالت FFTW_PATIENT یا FFTW_EXHAUSTIVE)، از آن به عنوان ورودی برای \fIfftw\-wisdom\-to\-conf\fR استفاده نمایید، و سپس برنامه خود را مجدداً با روتین پیکربندی حاصل پیوند دهید.

توجه داشته باشید که روتین پیکربندی حاوی خود wisdom نیست، بلکه فقط شامل روتین‌های لازم برای پیاده‌سازی wisdom است؛ بنابراین برنامه شما باید خود wisdom را نیز درون‌ریزی کند تا بتواند از برنامه‌ریزی‌های از پیش بهینه‌شده بهره‌مند شود.
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-h\fR, \fB\-\-help\fR
نمایش راهنما درباره گزینه‌های خط فرمان و نحوه استفاده.
.TP
\fB\-V\fR, \fB\-\-version\fR
چاپ شماره نسخه و اطلاعات حق نشر.
.SH "اشکالات (BUGS)"
گزارش‌های اشکال را به fftw@fftw.org ارسال کنید.
.SH "نویسندگان (AUTHORS)"
نوشته‌شده توسط Steven G. Johnson و Matteo Frigo.

Copyright (c) 2003, 2007-14 Matteo Frigo
.br
Copyright (c) 2003, 2007-14 Massachusetts Institute of Technology
.SH "همچنین ببینید (SEE ALSO)"
fftw-wisdom(1)