cannam@127: /*
cannam@127:  * Copyright (c) 2003, 2007-14 Matteo Frigo
cannam@127:  * Copyright (c) 2003, 2007-14 Massachusetts Institute of Technology
cannam@127:  *
cannam@127:  * This program is free software; you can redistribute it and/or modify
cannam@127:  * it under the terms of the GNU General Public License as published by
cannam@127:  * the Free Software Foundation; either version 2 of the License, or
cannam@127:  * (at your option) any later version.
cannam@127:  *
cannam@127:  * This program is distributed in the hope that it will be useful,
cannam@127:  * but WITHOUT ANY WARRANTY; without even the implied warranty of
cannam@127:  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
cannam@127:  * GNU General Public License for more details.
cannam@127:  *
cannam@127:  * You should have received a copy of the GNU General Public License
cannam@127:  * along with this program; if not, write to the Free Software
cannam@127:  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
cannam@127:  *
cannam@127:  */
cannam@127: 
cannam@127: #ifndef __RDFT_H__
cannam@127: #define __RDFT_H__
cannam@127: 
cannam@127: #include "ifftw.h"
cannam@127: #include "codelet-rdft.h"
cannam@127: 
cannam@127: #ifdef __cplusplus
cannam@127: extern "C"
cannam@127: {
cannam@127: #endif /* __cplusplus */
cannam@127: 
cannam@127: /* problem.c: */
cannam@127: typedef struct {
cannam@127:      problem super;
cannam@127:      tensor *sz, *vecsz;
cannam@127:      R *I, *O;
cannam@127: #if defined(STRUCT_HACK_KR)
cannam@127:      rdft_kind kind[1];
cannam@127: #elif defined(STRUCT_HACK_C99)
cannam@127:      rdft_kind kind[];
cannam@127: #else
cannam@127:      rdft_kind *kind;
cannam@127: #endif
cannam@127: } problem_rdft;
cannam@127: 
cannam@127: void X(rdft_zerotens)(tensor *sz, R *I);
cannam@127: problem *X(mkproblem_rdft)(const tensor *sz, const tensor *vecsz,
cannam@127: 			   R *I, R *O, const rdft_kind *kind);
cannam@127: problem *X(mkproblem_rdft_d)(tensor *sz, tensor *vecsz,
cannam@127: 			     R *I, R *O, const rdft_kind *kind);
cannam@127: problem *X(mkproblem_rdft_0_d)(tensor *vecsz, R *I, R *O);
cannam@127: problem *X(mkproblem_rdft_1)(const tensor *sz, const tensor *vecsz,
cannam@127: 			     R *I, R *O, rdft_kind kind);
cannam@127: problem *X(mkproblem_rdft_1_d)(tensor *sz, tensor *vecsz,
cannam@127: 			       R *I, R *O, rdft_kind kind);
cannam@127: 
cannam@127: const char *X(rdft_kind_str)(rdft_kind kind);
cannam@127: 
cannam@127: /* solve.c: */
cannam@127: void X(rdft_solve)(const plan *ego_, const problem *p_);
cannam@127: 
cannam@127: /* plan.c: */
cannam@127: typedef void (*rdftapply) (const plan *ego, R *I, R *O);
cannam@127: 
cannam@127: typedef struct {
cannam@127:      plan super;
cannam@127:      rdftapply apply;
cannam@127: } plan_rdft;
cannam@127: 
cannam@127: plan *X(mkplan_rdft)(size_t size, const plan_adt *adt, rdftapply apply);
cannam@127: 
cannam@127: #define MKPLAN_RDFT(type, adt, apply) \
cannam@127:   (type *)X(mkplan_rdft)(sizeof(type), adt, apply)
cannam@127: 
cannam@127: /* various solvers */
cannam@127: 
cannam@127: solver *X(mksolver_rdft_r2c_direct)(kr2c k, const kr2c_desc *desc);
cannam@127: solver *X(mksolver_rdft_r2c_directbuf)(kr2c k, const kr2c_desc *desc);
cannam@127: solver *X(mksolver_rdft_r2r_direct)(kr2r k, const kr2r_desc *desc);
cannam@127: 
cannam@127: void X(rdft_rank0_register)(planner *p);
cannam@127: void X(rdft_vrank3_transpose_register)(planner *p);
cannam@127: void X(rdft_rank_geq2_register)(planner *p);
cannam@127: void X(rdft_indirect_register)(planner *p);
cannam@127: void X(rdft_vrank_geq1_register)(planner *p);
cannam@127: void X(rdft_buffered_register)(planner *p);
cannam@127: void X(rdft_generic_register)(planner *p);
cannam@127: void X(rdft_rader_hc2hc_register)(planner *p);
cannam@127: void X(rdft_dht_register)(planner *p);
cannam@127: void X(dht_r2hc_register)(planner *p);
cannam@127: void X(dht_rader_register)(planner *p);
cannam@127: void X(dft_r2hc_register)(planner *p);
cannam@127: void X(rdft_nop_register)(planner *p);
cannam@127: void X(hc2hc_generic_register)(planner *p);
cannam@127: 
cannam@127: /****************************************************************************/
cannam@127: /* problem2.c: */
cannam@127: /* 
cannam@127:    An RDFT2 problem transforms a 1d real array r[n] with stride is/os
cannam@127:    to/from an "unpacked" complex array {rio,iio}[n/2 + 1] with stride
cannam@127:    os/is.  R0 points to the first even element of the real array.  
cannam@127:    R1 points to the first odd element of the real array.
cannam@127: 
cannam@127:    Strides on the real side of the transform express distances
cannam@127:    between consecutive elements of the same array (even or odd).
cannam@127:    E.g., for a contiguous input
cannam@127: 
cannam@127:      R0 R1 R2 R3 ...
cannam@127: 
cannam@127:    the input stride would be 2, not 1.  This convention is necessary
cannam@127:    for hc2c codelets to work, since they transpose even/odd with
cannam@127:    real/imag.
cannam@127:    
cannam@127:    Multidimensional transforms use complex DFTs for the
cannam@127:    noncontiguous dimensions.  vecsz has the usual interpretation.  
cannam@127: */
cannam@127: typedef struct {
cannam@127:      problem super;
cannam@127:      tensor *sz;
cannam@127:      tensor *vecsz;
cannam@127:      R *r0, *r1;
cannam@127:      R *cr, *ci;
cannam@127:      rdft_kind kind; /* assert(kind < DHT) */
cannam@127: } problem_rdft2;
cannam@127: 
cannam@127: problem *X(mkproblem_rdft2)(const tensor *sz, const tensor *vecsz,
cannam@127: 			    R *r0, R *r1, R *cr, R *ci, rdft_kind kind);
cannam@127: problem *X(mkproblem_rdft2_d)(tensor *sz, tensor *vecsz,
cannam@127: 			      R *r0, R *r1, R *cr, R *ci, rdft_kind kind);
cannam@127: problem *X(mkproblem_rdft2_d_3pointers)(tensor *sz, tensor *vecsz,
cannam@127: 					R *r, R *cr, R *ci, rdft_kind kind);
cannam@127: int X(rdft2_inplace_strides)(const problem_rdft2 *p, int vdim);
cannam@127: INT X(rdft2_tensor_max_index)(const tensor *sz, rdft_kind k);
cannam@127: void X(rdft2_strides)(rdft_kind kind, const iodim *d, INT *rs, INT *cs);
cannam@127: INT X(rdft2_complex_n)(INT real_n, rdft_kind kind);
cannam@127: 
cannam@127: /* verify.c: */
cannam@127: void X(rdft2_verify)(plan *pln, const problem_rdft2 *p, int rounds);
cannam@127: 
cannam@127: /* solve.c: */
cannam@127: void X(rdft2_solve)(const plan *ego_, const problem *p_);
cannam@127: 
cannam@127: /* plan.c: */
cannam@127: typedef void (*rdft2apply) (const plan *ego, R *r0, R *r1, R *cr, R *ci);
cannam@127: 
cannam@127: typedef struct {
cannam@127:      plan super;
cannam@127:      rdft2apply apply;
cannam@127: } plan_rdft2;
cannam@127: 
cannam@127: plan *X(mkplan_rdft2)(size_t size, const plan_adt *adt, rdft2apply apply);
cannam@127: 
cannam@127: #define MKPLAN_RDFT2(type, adt, apply) \
cannam@127:   (type *)X(mkplan_rdft2)(sizeof(type), adt, apply)
cannam@127: 
cannam@127: /* various solvers */
cannam@127: 
cannam@127: solver *X(mksolver_rdft2_direct)(kr2c k, const kr2c_desc *desc);
cannam@127: 
cannam@127: void X(rdft2_vrank_geq1_register)(planner *p);
cannam@127: void X(rdft2_buffered_register)(planner *p);
cannam@127: void X(rdft2_rdft_register)(planner *p);
cannam@127: void X(rdft2_nop_register)(planner *p);
cannam@127: void X(rdft2_rank0_register)(planner *p);
cannam@127: void X(rdft2_rank_geq2_register)(planner *p);
cannam@127: 
cannam@127: /****************************************************************************/
cannam@127: 
cannam@127: /* configurations */
cannam@127: void X(rdft_conf_standard)(planner *p);
cannam@127: 
cannam@127: #ifdef __cplusplus
cannam@127: }  /* extern "C" */
cannam@127: #endif /* __cplusplus */
cannam@127: 
cannam@127: #endif /* __RDFT_H__ */