cftlegi.C

/*
 *   Copyright (c) 1999-2001 Eric Gourgoulhon
 *
 *   This file is part of LORENE.
 *
 *   LORENE 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.
 *
 *   LORENE 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 LORENE; if not, write to the Free Software
 *   Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 *
 */


char cftlegi_C[] = "$Header: /cvsroot/Lorene/C++/Source/Non_class_members/Coef/cftlegi.C,v 1.3 2005/02/18 13:14:10 j_novak Exp $" ;

/*
 * Transformation en fonctions de Legendre associees impaires sur le deuxieme 
 *  indice (theta) d'un tableau 3-D representant une fonction antisymetrique 
 *  par rapport au plan z=0.
 *
 * Entree:
 * -------
 *   int* deg   : tableau du nombre effectif de degres de liberte dans chacune 
 *        des 3 dimensions: le nombre de points de collocation
 *        en theta est  nt = deg[1] et doit etre de la forme
 *          nt = 2^p 3^q 5^r + 1 
 *   int* dimf  : tableau du nombre d'elements de ff dans chacune des trois 
 *            dimensions.
 *        On doit avoir  dimf[1] >= deg[1] = nt. 
 *
 *   double* ff : tableau des valeurs de la fonction aux nt points de
 *                        de collocation
 *
 *            theta_l =  pi/2 l/(nt-1)       0 <= l <= nt-1 
 *
 *            L'espace memoire correspondant a ce
 *                        pointeur doit etre dimf[0]*dimf[1]*dimf[2] et doit 
 *            etre alloue avant l'appel a la routine.    
 *            Les valeurs de la fonction doivent etre stokees
 *            dans le tableau ff comme suit
 *          f( theta_l ) = ff[ dimf[1]*dimf[2] * m + k + dimf[2] * l ]
 *           ou m et k sont les indices correspondant a
 *           phi et r respectivement.
 *  NB: cette routine suppose que la transformation en phi a deja ete
 *      effectuee: ainsi m est un indice de Fourier, non un indice de
 *      point de collocation en phi.
 *
 *   int* dimc  : tableau du nombre d'elements de cf dans chacune des trois 
 *            dimensions.
 *        On doit avoir  dimc[1] >= deg[1] = nt. 
 * Sortie:
 * -------
 *   double* cf :  tableau des coefficients a_l du develop. en fonctions de
 *          Legendre associees impaires P_n^m:
 *
 *  pour m pair:    f(theta) = 
 *              som_{l=m/2}^{nt-2} a_l P_{2l+1}^m( cos(theta) )
 *            
 *  pour m impair:  f(theta) = 
 *              som_{l=(m+1)/2}^{nt-2} a_l P_{2l}^m( cos(theta) )
 *
 *          ou P_n^m(x) represente la fonction de Legendre associee
 *             de degre n et d'ordre m normalisee de facon a ce que
 *
 *          int_0^pi [ P_n^m(cos(theta)) ]^2  sin(theta) dtheta = 1
 *
 *          L'espace memoire correspondant au pointeur cfi doit etre 
 *              nr*nt*(np+2) et doit avoir ete alloue avant 
 *          l'appel a la routine.    
 *          Le coefficient a_l (0 <= l <= nt-1) est stoke dans le 
 *          tableau cf comme suit
 *                a_l = cf[ nr*nt* k + i + nr* l ]
 *          ou k et i sont les indices correspondant a phi et r 
 *          respectivement: m = k/2.
 *          NB: pour m pair: pour  l < m/2 et l=nt-1,  a_l = 0
 *          pour m impair: pour l < (m+1)/2 et l=nt-1,  a_l = 0
 *
 * NB: Si le pointeur cf est egal a ff, la routine ne travaille que sur un 
 *     seul tableau, qui constitue une entree/sortie.
 *
 */

/*
 * $Id: cftlegi.C,v 1.3 2005/02/18 13:14:10 j_novak Exp $
 * $Log: cftlegi.C,v $
 * Revision 1.3  2005/02/18 13:14:10  j_novak
 * Changing of malloc/free to new/delete + suppression of some unused variables
 * (trying to avoid compilation warnings).
 *
 * Revision 1.2  2002/10/16 14:36:52  j_novak
 * Reorganization of #include instructions of standard C++, in order to
 * use experimental version 3 of gcc.
 *
 * Revision 1.1.1.1  2001/11/20 15:19:28  e_gourgoulhon
 * LORENE
 *
 * Revision 2.0  1999/02/22  15:46:55  hyc
 * *** empty log message ***
 *
 *
 * $Header: /cvsroot/Lorene/C++/Source/Non_class_members/Coef/cftlegi.C,v 1.3 2005/02/18 13:14:10 j_novak Exp $
 *
 */

// headers du C
#include <assert.h>
#include <stdlib.h>

// headers bien de chez nous
#include "headcpp.h"
#include "proto.h"
//*****************************************************************************

void cftlegi(const int* deg, const int* dimf, double* ff, const int* dimc,
        double* cf)
{

// Limitations de la routine:
    assert(dimc[0]==deg[0]+2) ;
    assert(dimc[1]==deg[1]) ;
    assert(dimc[2]==deg[2]) ;


    // Tableau de travail :
    int taille = dimc[0]*dimc[1]*dimc[2] ;
    double* cf_cs =  new double[taille] ; 

//--------------------------------------------------------------
// 1/ Transformation esp. des configurations --> cos((2j+1) theta)/sin(2j theta) 
//--------------------------------------------------------------

    cftcossinci(deg, dimf, ff, dimc, cf_cs) ;

//--------------------------------------------------------------
// 2/ Transformation  cos((2j+1) theta)/sin(2j theta) ---> Legendre 
//--------------------------------------------------------------

    chb_cossinci_legi(deg , cf_cs, cf) ;

    // Menage
    delete [] cf_cs ;
}

---