LORENE
FFT991/circhebi.C
1 /*
2  * Copyright (c) 1999-2002 Eric Gourgoulhon
3  *
4  * This file is part of LORENE.
5  *
6  * LORENE is free software; you can redistribute it and/or modify
7  * it under the terms of the GNU General Public License as published by
8  * the Free Software Foundation; either version 2 of the License, or
9  * (at your option) any later version.
10  *
11  * LORENE is distributed in the hope that it will be useful,
12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14  * GNU General Public License for more details.
15  *
16  * You should have received a copy of the GNU General Public License
17  * along with LORENE; if not, write to the Free Software
18  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
19  *
20  */
21 
22 
23 
24 
25 
26 /*
27  * Transformation de Tchebyshev inverse (cas rare) sur le troisieme indice
28  * (indice correspondant a r) d'un tableau 3-D decrivant une fonction impaire.
29  * Utilise la routine FFT Fortran FFT991
30  *
31  * Entree:
32  * -------
33  * int* deg : tableau du nombre effectif de degres de liberte dans chacune
34  * des 3 dimensions: le nombre de points de collocation
35  * en r est nr = deg[2] et doit etre de la forme
36  * nr = 2^p 3^q 5^r + 1
37  * int* dimc : tableau du nombre d'elements de cf dans chacune des trois
38  * dimensions.
39  * On doit avoir dimc[2] >= deg[2] = nr.
40  * NB: pour dimc[0] = 1 (un seul point en phi), la transformation
41  * est bien effectuee.
42  * pour dimc[0] > 1 (plus d'un point en phi), la
43  * transformation n'est effectuee que pour les indices (en phi)
44  * j != 1 et j != dimc[0]-1 (cf. commentaires sur borne_phi).
45  *
46  * double* cf : tableau des coefficients c_i de la fonction definis
47  * comme suit (a theta et phi fixes)
48  *
49  * f(x) = som_{i=0}^{nr-2} c_i T_{2i+1}(x) ,
50  *
51  * ou T_{2i+1}(x) designe le polynome de Tchebyshev de
52  * degre 2i+1.
53  * Les coefficients c_i (0 <= i <= nr-2) doivent etre stokes
54  * dans le tableau cf comme suit
55  * c_i = cf[ dimc[1]*dimc[2] * j + dimc[2] * k + i ]
56  * ou j et k sont les indices correspondant a phi et theta
57  * respectivement.
58  * L'espace memoire correspondant a ce pointeur doit etre
59  * dimc[0]*dimc[1]*dimc[2] et doit etre alloue avant l'appel a
60  * la routine.
61  *
62  * int* dimf : tableau du nombre d'elements de ff dans chacune des trois
63  * dimensions.
64  * On doit avoir dimf[2] >= deg[2] = nr.
65  *
66  * Sortie:
67  * -------
68  * double* ff : tableau des valeurs de la fonction aux nr points de
69  * de collocation
70  *
71  * x_i = sin( pi/2 i/(nr-1) ) 0 <= i <= nr-1
72  *
73  * Les valeurs de la fonction sont stokees dans le
74  * tableau ff comme suit
75  * f( x_i ) = ff[ dimf[1]*dimf[2] * j + dimf[2] * k + i ]
76  * ou j et k sont les indices correspondant a phi et theta
77  * respectivement.
78  * L'espace memoire correspondant a ce pointeur doit etre
79  * dimf[0]*dimf[1]*dimf[2] et doit avoir ete alloue avant
80  * l'appel a la routine.
81  *
82  * NB: Si le pointeur cf est egal a ff, la routine ne travaille que sur un
83  * seul tableau, qui constitue une entree/sortie.
84  */
85 
86 /*
87  * $Id: circhebi.C,v 1.5 2016/12/05 16:18:03 j_novak Exp $
88  * $Log: circhebi.C,v $
89  * Revision 1.5 2016/12/05 16:18:03 j_novak
90  * Suppression of some global variables (file names, loch, ...) to prevent redefinitions
91  *
92  * Revision 1.4 2014/10/15 12:48:21 j_novak
93  * Corrected namespace declaration.
94  *
95  * Revision 1.3 2014/10/13 08:53:16 j_novak
96  * Lorene classes and functions now belong to the namespace Lorene.
97  *
98  * Revision 1.2 2014/10/06 15:18:45 j_novak
99  * Modified #include directives to use c++ syntax.
100  *
101  * Revision 1.1 2004/12/21 17:06:01 j_novak
102  * Added all files for using fftw3.
103  *
104  * Revision 1.4 2003/01/31 10:31:23 e_gourgoulhon
105  * Suppressed the directive #include <malloc.h> for malloc is defined
106  * in <stdlib.h>
107  *
108  * Revision 1.3 2002/10/16 14:36:53 j_novak
109  * Reorganization of #include instructions of standard C++, in order to
110  * use experimental version 3 of gcc.
111  *
112  * Revision 1.2 2002/09/09 13:00:40 e_gourgoulhon
113  * Modification of declaration of Fortran 77 prototypes for
114  * a better portability (in particular on IBM AIX systems):
115  * All Fortran subroutine names are now written F77_* and are
116  * defined in the new file C++/Include/proto_f77.h.
117  *
118  * Revision 1.1.1.1 2001/11/20 15:19:29 e_gourgoulhon
119  * LORENE
120  *
121  * Revision 2.0 1999/02/22 15:43:39 hyc
122  * *** empty log message ***
123  *
124  *
125  * $Header: /cvsroot/Lorene/C++/Source/Non_class_members/Coef/FFT991/circhebi.C,v 1.5 2016/12/05 16:18:03 j_novak Exp $
126  *
127  */
128 
129 // headers du C
130 #include <cassert>
131 #include <cstdlib>
132 
133 #include "headcpp.h"
134 
135 // Prototypes of F77 subroutines
136 #include "proto_f77.h"
137 
138 // Prototypage des sous-routines utilisees:
139 namespace Lorene {
140 int* facto_ini(int ) ;
141 double* trigo_ini(int ) ;
142 double* cheb_ini(const int) ;
143 double* chebimp_ini(const int ) ;
144 //*****************************************************************************
145 
146 void circhebi(const int* deg, const int* dimc, double* cf,
147  const int* dimf, double* ff)
148 
149 {
150 
151 int i, j, k ;
152 
153 // Dimensions des tableaux ff et cf :
154  int n1f = dimf[0] ;
155  int n2f = dimf[1] ;
156  int n3f = dimf[2] ;
157  int n1c = dimc[0] ;
158  int n2c = dimc[1] ;
159  int n3c = dimc[2] ;
160 
161 // Nombres de degres de liberte en r :
162  int nr = deg[2] ;
163 
164 // Tests de dimension:
165  if (nr > n3c) {
166  cout << "circhebi: nr > n3c : nr = " << nr << " , n3c = "
167  << n3c << endl ;
168  abort () ;
169  exit(-1) ;
170  }
171  if (nr > n3f) {
172  cout << "circhebi: nr > n3f : nr = " << nr << " , n3f = "
173  << n3f << endl ;
174  abort () ;
175  exit(-1) ;
176  }
177  if (n1c > n1f) {
178  cout << "circhebi: n1c > n1f : n1c = " << n1c << " , n1f = "
179  << n1f << endl ;
180  abort () ;
181  exit(-1) ;
182  }
183  if (n2c > n2f) {
184  cout << "circhebi: n2c > n2f : n2c = " << n2c << " , n2f = "
185  << n2f << endl ;
186  abort () ;
187  exit(-1) ;
188  }
189 
190 // Nombre de points pour la FFT:
191  int nm1 = nr - 1;
192  int nm1s2 = nm1 / 2;
193 
194 // Recherche des tables pour la FFT:
195  int* facto = facto_ini(nm1) ;
196  double* trigo = trigo_ini(nm1) ;
197 
198 // Recherche de la table des sin(psi) :
199  double* sinp = cheb_ini(nr);
200 
201 // Recherche de la table des points de collocations x_k :
202  double* x = chebimp_ini(nr);
203 
204  // tableau de travail t1 et g
205  // (la dimension nm1+2 = nr+1 est exigee par la routine fft991)
206  double* g = (double*)( malloc( (nm1+2)*sizeof(double) ) ) ;
207  double* t1 = (double*)( malloc( (nm1+2)*sizeof(double) ) ) ;
208 
209 // Parametres pour la routine FFT991
210  int jump = 1 ;
211  int inc = 1 ;
212  int lot = 1 ;
213  int isign = 1 ;
214 
215 // boucle sur phi et theta
216 
217  int n2n3f = n2f * n3f ;
218  int n2n3c = n2c * n3c ;
219 
220 /*
221  * Borne de la boucle sur phi:
222  * si n1c = 1, on effectue la boucle une fois seulement.
223  * si n1c > 1, on va jusqu'a j = n1c-2 en sautant j = 1 (les coefficients
224  * j=n1c-1 et j=0 ne sont pas consideres car nuls).
225  */
226  int borne_phi = ( n1c > 1 ) ? n1c-1 : 1 ;
227 
228  for (j=0; j< borne_phi; j++) {
229 
230  if (j==1) continue ; // on ne traite pas le terme en sin(0 phi)
231 
232  for (k=0; k<n2c; k++) {
233 
234  int i0 = n2n3c * j + n3c * k ; // indice de depart
235  double* cf0 = cf + i0 ; // tableau des donnees a transformer
236 
237  i0 = n2n3f * j + n3f * k ; // indice de depart
238  double* ff0 = ff + i0 ; // tableau resultat
239 
240 // Calcul des coefficients du developpement en T_{2i}(x) de la fonction
241 // h(x) := x f(x) a partir des coefficients de f (resultat stoke dans le
242 // tableau t1 :
243  t1[0] = .5 * cf0[0] ;
244  for (i=1; i<nm1; i++) t1[i] = .5 * ( cf0[i] + cf0[i-1] ) ;
245  t1[nm1] = .5 * cf0[nr-2] ;
246 
247 /*
248  * NB: dans les commentaires qui suivent, psi designe la variable de [0, pi]
249  * reliee a x par x = cos(psi/2) et F(psi) = h(x(psi)).
250  */
251 
252 // Calcul des coefficients de Fourier de la fonction
253 // G(psi) = F+(psi) + F_(psi) sin(psi)
254 // en fonction des coefficients de Tchebyshev de f:
255 
256 // Coefficients impairs de G
257 //--------------------------
258 
259  double c1 = t1[1] ;
260 
261  double som = 0;
262  ff0[1] = 0 ;
263  for ( i = 3; i < nr; i += 2 ) {
264  ff0[i] = t1[i] - c1 ;
265  som += ff0[i] ;
266  }
267 
268 // Valeur en psi=0 de la partie antisymetrique de F, F_ :
269  double fmoins0 = nm1s2 * c1 + som ;
270 
271 // Coef. impairs de G
272 // NB: le facteur 0.25 est du a la normalisation de fft991; si fft991
273 // donnait exactement les coef. des sinus, ce facteur serait -0.5.
274  g[1] = 0 ;
275  for ( i = 3; i < nr; i += 2 ) {
276  g[i] = 0.25 * ( ff0[i] - ff0[i-2] ) ;
277  }
278  g[nr] = 0 ;
279 
280 
281 // Coefficients pairs de G
282 //------------------------
283 // Ces coefficients sont egaux aux coefficients pairs du developpement de
284 // f.
285 // NB: le facteur 0.5 est du a la normalisation de fft991; si fft991
286 // donnait exactement les coef. des cosinus, ce facteur serait 1.
287 
288  g[0] = t1[0] ;
289  for (i=2; i<nm1; i += 2 ) g[i] = 0.5 * t1[i] ;
290  g[nm1] = t1[nm1] ;
291 
292 // Transformation de Fourier inverse de G
293 //---------------------------------------
294 
295 // FFT inverse
296  F77_fft991( g, t1, trigo, facto, &inc, &jump, &nm1, &lot, &isign) ;
297 
298 // Valeurs de f deduites de celles de G
299 //-------------------------------------
300 
301  for ( i = 1; i < nm1s2 ; i++ ) {
302 // ... indice (dans le tableau g) du pt symetrique de psi par rapport a pi/2:
303  int isym = nm1 - i ;
304 // ... indice (dans le tableau ff0) du point x correspondant a psi
305  int ix = nm1 - i ;
306 // ... indice (dans le tableau ff0) du point x correspondant a sym(psi)
307  int ixsym = nm1 - isym ;
308 
309  double fp = .5 * ( g[i] + g[isym] ) ;
310  double fm = .5 * ( g[i] - g[isym] ) / sinp[i] ;
311 
312  ff0[ix] = ( fp + fm ) / x[ix];
313  ff0[ixsym] = ( fp - fm ) / x[ixsym] ;
314  }
315 
316 //... cas particuliers:
317  ff0[0] = 0 ;
318  ff0[nm1] = g[0] + fmoins0 ;
319  ff0[nm1s2] = g[nm1s2] / x[nm1s2] ;
320 
321  } // fin de la boucle sur theta
322  } // fin de la boucle sur phi
323 
324  // Menage
325  free (t1) ;
326  free (g) ;
327 }
328 }
Lorene prototypes.
Definition: app_hor.h:67