cftlegmp.C

/*
 *   Copyright (c) 1999-2001 Eric Gourgoulhon
 *                 2009 Jerome Novak
 *
 *   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
 *
 */


 

/*
 * Transformation en fonctions de Legendre associees sur le deuxieme indice
 *  (theta) d'un tableau 3-D representant une fonction symetrique invariante 
 *  par le retournement (x, y, z) --> (-x, -y, z).
 *
 *
 * 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 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] * k + i + dimf[2] * l ]
 *           ou k et i 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 P_n^m (m pair) : 
 *
 *      f(theta) =  som_{l=m}^{nt-1} a_l P_l^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) doit etre stoke dans le 
 *          tableau cfi comme suit
 *                a_l = cfi[ nr*nt* k + i + nr* l ]
 *          ou k et i sont les indices correspondant a phi et r 
 *          respectivement: m = 2 (k/2).
 *          NB: pour l < m,  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: cftlegmp.C,v 1.4 2016/12/05 16:18:00 j_novak Exp $
 * $Log: cftlegmp.C,v $
 * Revision 1.4  2016/12/05 16:18:00  j_novak
 * Suppression of some global variables (file names, loch, ...) to prevent redefinitions
 *
 * Revision 1.3  2014/10/13 08:53:09  j_novak
 * Lorene classes and functions now belong to the namespace Lorene.
 *
 * Revision 1.2  2014/10/06 15:15:59  j_novak
 * Modified #include directives to use c++ syntax.
 *
 * Revision 1.1  2009/10/13 13:49:36  j_novak
 * New base T_LEG_MP.
 *
 *
 * $Header: /cvsroot/Lorene/C++/Source/Non_class_members/Coef/cftlegmp.C,v 1.4 2016/12/05 16:18:00 j_novak Exp $
 *
 */

// headers du C
#include <cassert>
#include <cstdlib>

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

void cftlegmp(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(2l theta)
//--------------------------------------------------------------

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

//--------------------------------------------------------------
// 2/ Transformation  cos(2l theta) ---> Legendre 
//--------------------------------------------------------------

    chb_cos_legmp(deg , cf_cs, cf) ;

    // Menage
    delete [] cf_cs ;
}
}