cftlegmi.C

/*
 *   Copyright (c) 1999-2001 Eric Gourgoulhon
 *   Copyright (c) 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 3-D antisymetrique 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 stockees
 *            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_j du develop. en fonctions de
 *          Legendre associees P_l^m (m impair)
 *
 *          f(theta) = 
 *              som_{l=m}^{nt-1} a_j P_j^m( cos(theta) )
 *
 *          avec m impair.        
 *
 *          P_l^m(x) represente la fonction de Legendre associee
 *             de degre l et d'ordre m normalisee de facon a ce que
 *
 *          int_0^pi [ P_l^m(cos(theta)) ]^2  sin(theta) dtheta = 1
 *
 *          L'espace memoire correspondant au pointeur cfo doit etre 
 *              nr*nt*(np+2) et doit avoir ete alloue avant 
 *          l'appel a la routine.    
 *          Le coefficient a_j (0 <= j <= nt-1) est stoke dans le 
 *          tableau cfo comme suit
 *                a_j = cfo[ nr*nt* k + i + nr* j ]
 *          ou k et i sont les indices correspondant a phi et r 
 *          respectivement: m = 2( k/2 ).
 *          NB: pour j< m,  a_j = 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: cftlegmi.C,v 1.4 2016/12/05 16:18:00 j_novak Exp $
 * $Log: cftlegmi.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/23 12:54:47  j_novak
 * New base T_LEG_MI
 *
 *
 * $Header: /cvsroot/Lorene/C++/Source/Non_class_members/Coef/cftlegmi.C,v 1.4 2016/12/05 16:18:00 j_novak Exp $
 *
 */

// headers du C
#include <cassert>

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

void cftlegmi(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 --> sin(j*theta) 
//--------------------------------------------------------------

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

//--------------------------------------------------------------
// 2/ Transformation  sin(j*theta)  ---> Legendre 
//--------------------------------------------------------------

    chb_sin_legmi(deg , cf_cs, cf) ;

    // Menage
    delete [] cf_cs ;
}
}