cannam@95: /*
cannam@95:  * Copyright (c) 2003, 2007-11 Matteo Frigo
cannam@95:  * Copyright (c) 2003, 2007-11 Massachusetts Institute of Technology
cannam@95:  *
cannam@95:  * This program is free software; you can redistribute it and/or modify
cannam@95:  * it under the terms of the GNU General Public License as published by
cannam@95:  * the Free Software Foundation; either version 2 of the License, or
cannam@95:  * (at your option) any later version.
cannam@95:  *
cannam@95:  * This program is distributed in the hope that it will be useful,
cannam@95:  * but WITHOUT ANY WARRANTY; without even the implied warranty of
cannam@95:  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
cannam@95:  * GNU General Public License for more details.
cannam@95:  *
cannam@95:  * You should have received a copy of the GNU General Public License
cannam@95:  * along with this program; if not, write to the Free Software
cannam@95:  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
cannam@95:  *
cannam@95:  */
cannam@95: 
cannam@95: #include "rdft.h"
cannam@95: 
cannam@95: /*
cannam@95:  * Compute DHTs of prime sizes using Rader's trick: turn them
cannam@95:  * into convolutions of size n - 1, which we then perform via a pair
cannam@95:  * of FFTs.   (We can then do prime real FFTs via rdft-dht.c.)
cannam@95:  *
cannam@95:  * Optionally (determined by the "pad" field of the solver), we can
cannam@95:  * perform the (cyclic) convolution by zero-padding to a size
cannam@95:  * >= 2*(n-1) - 1.  This is advantageous if n-1 has large prime factors.
cannam@95:  *
cannam@95:  */
cannam@95: 
cannam@95: typedef struct {
cannam@95:      solver super;
cannam@95:      int pad;
cannam@95: } S;
cannam@95: 
cannam@95: typedef struct {
cannam@95:      plan_rdft super;
cannam@95: 
cannam@95:      plan *cld1, *cld2;
cannam@95:      R *omega;
cannam@95:      INT n, npad, g, ginv;
cannam@95:      INT is, os;
cannam@95:      plan *cld_omega;
cannam@95: } P;
cannam@95: 
cannam@95: static rader_tl *omegas = 0;
cannam@95: 
cannam@95: /***************************************************************************/
cannam@95: 
cannam@95: /* If R2HC_ONLY_CONV is 1, we use a trick to perform the convolution
cannam@95:    purely in terms of R2HC transforms, as opposed to R2HC followed by H2RC.
cannam@95:    This requires a few more operations, but allows us to share the same
cannam@95:    plan/codelets for both Rader children. */
cannam@95: #define R2HC_ONLY_CONV 1
cannam@95: 
cannam@95: static void apply(const plan *ego_, R *I, R *O)
cannam@95: {
cannam@95:      const P *ego = (const P *) ego_;
cannam@95:      INT n = ego->n; /* prime */
cannam@95:      INT npad = ego->npad; /* == n - 1 for unpadded Rader; always even */
cannam@95:      INT is = ego->is, os;
cannam@95:      INT k, gpower, g;
cannam@95:      R *buf, *omega;
cannam@95:      R r0;
cannam@95: 
cannam@95:      buf = (R *) MALLOC(sizeof(R) * npad, BUFFERS);
cannam@95: 
cannam@95:      /* First, permute the input, storing in buf: */
cannam@95:      g = ego->g; 
cannam@95:      for (gpower = 1, k = 0; k < n - 1; ++k, gpower = MULMOD(gpower, g, n)) {
cannam@95: 	  buf[k] = I[gpower * is];
cannam@95:      }
cannam@95:      /* gpower == g^(n-1) mod n == 1 */;
cannam@95: 
cannam@95:      A(n - 1 <= npad);
cannam@95:      for (k = n - 1; k < npad; ++k) /* optionally, zero-pad convolution */
cannam@95: 	  buf[k] = 0;
cannam@95: 
cannam@95:      os = ego->os;
cannam@95: 
cannam@95:      /* compute RDFT of buf, storing in buf (i.e., in-place): */
cannam@95:      {
cannam@95: 	    plan_rdft *cld = (plan_rdft *) ego->cld1;
cannam@95: 	    cld->apply((plan *) cld, buf, buf);
cannam@95:      }
cannam@95: 
cannam@95:      /* set output DC component: */
cannam@95:      O[0] = (r0 = I[0]) + buf[0];
cannam@95: 
cannam@95:      /* now, multiply by omega: */
cannam@95:      omega = ego->omega;
cannam@95:      buf[0] *= omega[0];
cannam@95:      for (k = 1; k < npad/2; ++k) {
cannam@95: 	  E rB, iB, rW, iW, a, b;
cannam@95: 	  rW = omega[k];
cannam@95: 	  iW = omega[npad - k];
cannam@95: 	  rB = buf[k];
cannam@95: 	  iB = buf[npad - k];
cannam@95: 	  a = rW * rB - iW * iB;
cannam@95: 	  b = rW * iB + iW * rB;
cannam@95: #if R2HC_ONLY_CONV
cannam@95: 	  buf[k] = a + b;
cannam@95: 	  buf[npad - k] = a - b;
cannam@95: #else
cannam@95: 	  buf[k] = a;
cannam@95: 	  buf[npad - k] = b;
cannam@95: #endif
cannam@95:      }
cannam@95:      /* Nyquist component: */
cannam@95:      A(k + k == npad); /* since npad is even */
cannam@95:      buf[k] *= omega[k];
cannam@95:      
cannam@95:      /* this will add input[0] to all of the outputs after the ifft */
cannam@95:      buf[0] += r0;
cannam@95: 
cannam@95:      /* inverse FFT: */
cannam@95:      {
cannam@95: 	    plan_rdft *cld = (plan_rdft *) ego->cld2;
cannam@95: 	    cld->apply((plan *) cld, buf, buf);
cannam@95:      }
cannam@95: 
cannam@95:      /* do inverse permutation to unshuffle the output: */
cannam@95:      A(gpower == 1);
cannam@95: #if R2HC_ONLY_CONV
cannam@95:      O[os] = buf[0];
cannam@95:      gpower = g = ego->ginv;
cannam@95:      A(npad == n - 1 || npad/2 >= n - 1);
cannam@95:      if (npad == n - 1) {
cannam@95: 	  for (k = 1; k < npad/2; ++k, gpower = MULMOD(gpower, g, n)) {
cannam@95: 	       O[gpower * os] = buf[k] + buf[npad - k];
cannam@95: 	  }
cannam@95: 	  O[gpower * os] = buf[k];
cannam@95: 	  ++k, gpower = MULMOD(gpower, g, n);
cannam@95: 	  for (; k < npad; ++k, gpower = MULMOD(gpower, g, n)) {
cannam@95: 	       O[gpower * os] = buf[npad - k] - buf[k];
cannam@95: 	  }
cannam@95:      }
cannam@95:      else {
cannam@95: 	  for (k = 1; k < n - 1; ++k, gpower = MULMOD(gpower, g, n)) {
cannam@95: 	       O[gpower * os] = buf[k] + buf[npad - k];
cannam@95: 	  }
cannam@95:      }
cannam@95: #else
cannam@95:      g = ego->ginv;
cannam@95:      for (k = 0; k < n - 1; ++k, gpower = MULMOD(gpower, g, n)) {
cannam@95: 	  O[gpower * os] = buf[k];
cannam@95:      }
cannam@95: #endif
cannam@95:      A(gpower == 1);
cannam@95: 
cannam@95:      X(ifree)(buf);
cannam@95: }
cannam@95: 
cannam@95: static R *mkomega(enum wakefulness wakefulness,
cannam@95: 		  plan *p_, INT n, INT npad, INT ginv)
cannam@95: {
cannam@95:      plan_rdft *p = (plan_rdft *) p_;
cannam@95:      R *omega;
cannam@95:      INT i, gpower;
cannam@95:      trigreal scale;
cannam@95:      triggen *t;
cannam@95: 
cannam@95:      if ((omega = X(rader_tl_find)(n, npad + 1, ginv, omegas))) 
cannam@95: 	  return omega;
cannam@95: 
cannam@95:      omega = (R *)MALLOC(sizeof(R) * npad, TWIDDLES);
cannam@95: 
cannam@95:      scale = npad; /* normalization for convolution */
cannam@95: 
cannam@95:      t = X(mktriggen)(wakefulness, n);
cannam@95:      for (i = 0, gpower = 1; i < n-1; ++i, gpower = MULMOD(gpower, ginv, n)) {
cannam@95: 	  trigreal w[2];
cannam@95: 	  t->cexpl(t, gpower, w);
cannam@95: 	  omega[i] = (w[0] + w[1]) / scale;
cannam@95:      }
cannam@95:      X(triggen_destroy)(t);
cannam@95:      A(gpower == 1);
cannam@95: 
cannam@95:      A(npad == n - 1 || npad >= 2*(n - 1) - 1);
cannam@95: 
cannam@95:      for (; i < npad; ++i)
cannam@95: 	  omega[i] = K(0.0);
cannam@95:      if (npad > n - 1)
cannam@95: 	  for (i = 1; i < n-1; ++i)
cannam@95: 	       omega[npad - i] = omega[n - 1 - i];
cannam@95: 
cannam@95:      p->apply(p_, omega, omega);
cannam@95: 
cannam@95:      X(rader_tl_insert)(n, npad + 1, ginv, omega, &omegas);
cannam@95:      return omega;
cannam@95: }
cannam@95: 
cannam@95: static void free_omega(R *omega)
cannam@95: {
cannam@95:      X(rader_tl_delete)(omega, &omegas);
cannam@95: }
cannam@95: 
cannam@95: /***************************************************************************/
cannam@95: 
cannam@95: static void awake(plan *ego_, enum wakefulness wakefulness)
cannam@95: {
cannam@95:      P *ego = (P *) ego_;
cannam@95: 
cannam@95:      X(plan_awake)(ego->cld1, wakefulness);
cannam@95:      X(plan_awake)(ego->cld2, wakefulness);
cannam@95:      X(plan_awake)(ego->cld_omega, wakefulness);
cannam@95: 
cannam@95:      switch (wakefulness) {
cannam@95: 	 case SLEEPY:
cannam@95: 	      free_omega(ego->omega);
cannam@95: 	      ego->omega = 0;
cannam@95: 	      break;
cannam@95: 	 default:
cannam@95: 	      ego->g = X(find_generator)(ego->n);
cannam@95: 	      ego->ginv = X(power_mod)(ego->g, ego->n - 2, ego->n);
cannam@95: 	      A(MULMOD(ego->g, ego->ginv, ego->n) == 1);
cannam@95: 
cannam@95: 	      A(!ego->omega);
cannam@95: 	      ego->omega = mkomega(wakefulness, 
cannam@95: 				   ego->cld_omega,ego->n,ego->npad,ego->ginv);
cannam@95: 	      break;
cannam@95:      }
cannam@95: }
cannam@95: 
cannam@95: static void destroy(plan *ego_)
cannam@95: {
cannam@95:      P *ego = (P *) ego_;
cannam@95:      X(plan_destroy_internal)(ego->cld_omega);
cannam@95:      X(plan_destroy_internal)(ego->cld2);
cannam@95:      X(plan_destroy_internal)(ego->cld1);
cannam@95: }
cannam@95: 
cannam@95: static void print(const plan *ego_, printer *p)
cannam@95: {
cannam@95:      const P *ego = (const P *) ego_;
cannam@95: 
cannam@95:      p->print(p, "(dht-rader-%D/%D%ois=%oos=%(%p%)",
cannam@95:               ego->n, ego->npad, ego->is, ego->os, ego->cld1);
cannam@95:      if (ego->cld2 != ego->cld1)
cannam@95:           p->print(p, "%(%p%)", ego->cld2);
cannam@95:      if (ego->cld_omega != ego->cld1 && ego->cld_omega != ego->cld2)
cannam@95:           p->print(p, "%(%p%)", ego->cld_omega);
cannam@95:      p->putchr(p, ')');
cannam@95: }
cannam@95: 
cannam@95: static int applicable(const solver *ego, const problem *p_, const planner *plnr)
cannam@95: {
cannam@95:      const problem_rdft *p = (const problem_rdft *) p_;
cannam@95:      UNUSED(ego);
cannam@95:      return (1
cannam@95: 	     && p->sz->rnk == 1
cannam@95: 	     && p->vecsz->rnk == 0
cannam@95: 	     && p->kind[0] == DHT
cannam@95: 	     && X(is_prime)(p->sz->dims[0].n)
cannam@95: 	     && p->sz->dims[0].n > 2
cannam@95: 	     && CIMPLIES(NO_SLOWP(plnr), p->sz->dims[0].n > RADER_MAX_SLOW)
cannam@95: 	     /* proclaim the solver SLOW if p-1 is not easily
cannam@95: 		factorizable.  Unlike in the complex case where
cannam@95: 		Bluestein can solve the problem, in the DHT case we
cannam@95: 		may have no other choice */
cannam@95: 	     && CIMPLIES(NO_SLOWP(plnr), X(factors_into_small_primes)(p->sz->dims[0].n - 1))
cannam@95: 	  );
cannam@95: }
cannam@95: 
cannam@95: static INT choose_transform_size(INT minsz)
cannam@95: {
cannam@95:      static const INT primes[] = { 2, 3, 5, 0 };
cannam@95:      while (!X(factors_into)(minsz, primes) || minsz % 2)
cannam@95: 	  ++minsz;
cannam@95:      return minsz;
cannam@95: }
cannam@95: 
cannam@95: static plan *mkplan(const solver *ego_, const problem *p_, planner *plnr)
cannam@95: {
cannam@95:      const S *ego = (const S *) ego_;
cannam@95:      const problem_rdft *p = (const problem_rdft *) p_;
cannam@95:      P *pln;
cannam@95:      INT n, npad;
cannam@95:      INT is, os;
cannam@95:      plan *cld1 = (plan *) 0;
cannam@95:      plan *cld2 = (plan *) 0;
cannam@95:      plan *cld_omega = (plan *) 0;
cannam@95:      R *buf = (R *) 0;
cannam@95:      problem *cldp;
cannam@95: 
cannam@95:      static const plan_adt padt = {
cannam@95: 	  X(rdft_solve), awake, print, destroy
cannam@95:      };
cannam@95: 
cannam@95:      if (!applicable(ego_, p_, plnr))
cannam@95: 	  return (plan *) 0;
cannam@95: 
cannam@95:      n = p->sz->dims[0].n;
cannam@95:      is = p->sz->dims[0].is;
cannam@95:      os = p->sz->dims[0].os;
cannam@95: 
cannam@95:      if (ego->pad)
cannam@95: 	  npad = choose_transform_size(2 * (n - 1) - 1);
cannam@95:      else
cannam@95: 	  npad = n - 1;
cannam@95: 
cannam@95:      /* initial allocation for the purpose of planning */
cannam@95:      buf = (R *) MALLOC(sizeof(R) * npad, BUFFERS);
cannam@95: 
cannam@95:      cld1 = X(mkplan_f_d)(plnr, 
cannam@95: 			  X(mkproblem_rdft_1_d)(X(mktensor_1d)(npad, 1, 1),
cannam@95: 						X(mktensor_1d)(1, 0, 0),
cannam@95: 						buf, buf,
cannam@95: 						R2HC),
cannam@95: 			  NO_SLOW, 0, 0);
cannam@95:      if (!cld1) goto nada;
cannam@95: 
cannam@95:      cldp =
cannam@95:           X(mkproblem_rdft_1_d)(
cannam@95:                X(mktensor_1d)(npad, 1, 1),
cannam@95:                X(mktensor_1d)(1, 0, 0),
cannam@95: 	       buf, buf, 
cannam@95: #if R2HC_ONLY_CONV
cannam@95: 	       R2HC
cannam@95: #else
cannam@95: 	       HC2R
cannam@95: #endif
cannam@95: 	       );
cannam@95:      if (!(cld2 = X(mkplan_f_d)(plnr, cldp, NO_SLOW, 0, 0)))
cannam@95: 	  goto nada;
cannam@95: 
cannam@95:      /* plan for omega */
cannam@95:      cld_omega = X(mkplan_f_d)(plnr, 
cannam@95: 			       X(mkproblem_rdft_1_d)(
cannam@95: 				    X(mktensor_1d)(npad, 1, 1),
cannam@95: 				    X(mktensor_1d)(1, 0, 0),
cannam@95: 				    buf, buf, R2HC),
cannam@95: 			       NO_SLOW, ESTIMATE, 0);
cannam@95:      if (!cld_omega) goto nada;
cannam@95: 
cannam@95:      /* deallocate buffers; let awake() or apply() allocate them for real */
cannam@95:      X(ifree)(buf);
cannam@95:      buf = 0;
cannam@95: 
cannam@95:      pln = MKPLAN_RDFT(P, &padt, apply);
cannam@95:      pln->cld1 = cld1;
cannam@95:      pln->cld2 = cld2;
cannam@95:      pln->cld_omega = cld_omega;
cannam@95:      pln->omega = 0;
cannam@95:      pln->n = n;
cannam@95:      pln->npad = npad;
cannam@95:      pln->is = is;
cannam@95:      pln->os = os;
cannam@95: 
cannam@95:      X(ops_add)(&cld1->ops, &cld2->ops, &pln->super.super.ops);
cannam@95:      pln->super.super.ops.other += (npad/2-1)*6 + npad + n + (n-1) * ego->pad;
cannam@95:      pln->super.super.ops.add += (npad/2-1)*2 + 2 + (n-1) * ego->pad;
cannam@95:      pln->super.super.ops.mul += (npad/2-1)*4 + 2 + ego->pad;
cannam@95: #if R2HC_ONLY_CONV
cannam@95:      pln->super.super.ops.other += n-2 - ego->pad;
cannam@95:      pln->super.super.ops.add += (npad/2-1)*2 + (n-2) - ego->pad;
cannam@95: #endif
cannam@95: 
cannam@95:      return &(pln->super.super);
cannam@95: 
cannam@95:  nada:
cannam@95:      X(ifree0)(buf);
cannam@95:      X(plan_destroy_internal)(cld_omega);
cannam@95:      X(plan_destroy_internal)(cld2);
cannam@95:      X(plan_destroy_internal)(cld1);
cannam@95:      return 0;
cannam@95: }
cannam@95: 
cannam@95: /* constructors */
cannam@95: 
cannam@95: static solver *mksolver(int pad)
cannam@95: {
cannam@95:      static const solver_adt sadt = { PROBLEM_RDFT, mkplan, 0 };
cannam@95:      S *slv = MKSOLVER(S, &sadt);
cannam@95:      slv->pad = pad;
cannam@95:      return &(slv->super);
cannam@95: }
cannam@95: 
cannam@95: void X(dht_rader_register)(planner *p)
cannam@95: {
cannam@95:      REGISTER_SOLVER(p, mksolver(0));
cannam@95:      REGISTER_SOLVER(p, mksolver(1));
cannam@95: }