نام (NAME)

fftw-wisdom-to-conf - تولید فایل‌های پیکربندی C بر اساس خرد محاسباتی (wisdom) کتابخانه FFTW

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

fftw-wisdom-to-conf [< INPUT] [> OUTPUT]

توضیحات (DESCRIPTION)

ابزار fftw-wisdom-to-conf یک ابزار کمکی برای تولید روتین‌های پیکربندی زبان C از روی فایل‌های خرد محاسباتی (wisdom) کتابخانه FFTW است؛ فایل‌های wisdom حاوی اطلاعات ذخیره‌شده درباره نحوه محاسبه بهینه تبدیل‌های (فوریه) در اندازه‌های گوناگون هستند. یک روتین پیکربندی، زیرروالی به زبان C است که آن را به برنامه خود پیوند (link) می‌دهید تا جایگزین روتینی به همین نام در کتابخانه FFTW شود؛ این روتین مشخص می‌کند چه بخش‌هایی از FFTW توسط برنامه شما قابل فراخوانی هستند.

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

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

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

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

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

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

توجه داشته باشید که روتین پیکربندی حاوی خود wisdom نیست، بلکه فقط شامل روتین‌های لازم برای پیاده‌سازی wisdom است؛ بنابراین برنامه شما باید خود wisdom را نیز درون‌ریزی کند تا بتواند از برنامه‌ریزی‌های از پیش بهینه‌شده بهره‌مند شود.

گزینه‌ها (OPTIONS)

-h, --help

نمایش راهنما درباره گزینه‌های خط فرمان و نحوه استفاده.

-V, --version

چاپ شماره نسخه و اطلاعات حق نشر.

اشکالات (BUGS)

گزارش‌های اشکال را به fftw@fftw.org ارسال کنید.

نویسندگان (AUTHORS)

نوشته‌شده توسط Steven G. Johnson و Matteo Frigo.

Copyright (c) 2003, 2007-14 Matteo Frigo
Copyright (c) 2003, 2007-14 Massachusetts Institute of Technology

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

fftw-wisdom(1)