citlegpp.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
 *
 */
 
 
 
 
/*
 * Transformation inverse fonctions de Legendre associees sur le deuxieme indice
 *  (theta) d'un tableau 3-D representant une fonction symetrique par rapport
 *  au plan z=0 et 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* dimc  : tableau du nombre d'elements de cc dans chacune des trois 
 *            dimensions.
 *        On doit avoir  dimc[1] >= deg[1] = nt. 
 *
 *   double* cf :  tableau des coefficients a_l du develop. en fonctions de
 *          Legendre associees P_n^m (n et m pairs) : 
 *
 *      f(theta) = som_{l=m/2}^{nt-1} 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) 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/2,  a_l = 0
 *
 *   int* dimf  : tableau du nombre d'elements de ff dans chacune des trois 
 *            dimensions.
 *        On doit avoir  dimf[1] >= deg[1] = nt. 
 *
 * Sortie:
 * -------
 *   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 
 *            avoir ete alloue avant l'appel a la routine.   
 *            Les valeurs de la fonction sont 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: Si le pointeur cf est egal a ff, la routine ne travaille que sur un 
 *     seul tableau, qui constitue une entree/sortie.
 *
 */
 
/*
 * $Id: citlegpp.C,v 1.7 2016/12/05 16:18:01 j_novak Exp $
 * $Log: citlegpp.C,v $
 * Revision 1.7  2016/12/05 16:18:01  j_novak
 * Suppression of some global variables (file names, loch, ...) to prevent redefinitions
 *
 * Revision 1.6  2014/10/13 08:53:12  j_novak
 * Lorene classes and functions now belong to the namespace Lorene.
 *
 * Revision 1.5  2014/10/06 15:16:02  j_novak
 * Modified #include directives to use c++ syntax.
 *
 * Revision 1.4  2005/02/18 13:14:12  j_novak
 * Changing of malloc/free to new/delete + suppression of some unused variables
 * (trying to avoid compilation warnings).
 *
 * Revision 1.3  2003/01/31 10:31:24  e_gourgoulhon
 * Suppressed the directive #include <malloc.h> for malloc is defined
 * in <stdlib.h>
 *
 * Revision 1.2  2002/10/16 14:36:54  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:29  e_gourgoulhon
 * LORENE
 *
 * Revision 2.0  1999/02/22  15:41:29  hyc
 * *** empty log message ***
 *
 *
 * $Header: /cvsroot/Lorene/C++/Source/Non_class_members/Coef/citlegpp.C,v 1.7 2016/12/05 16:18:01 j_novak Exp $
 *
 */
 
 
// headers du C
#include <cassert>
#include <cstdlib>
 
// headers bien de chez nous
#include "headcpp.h"
#include "proto.h"
namespace Lorene {
//*****************************************************************************
 
void citlegpp(const int* deg, const int* dimc, double* cf, const int* dimf,
           double* ff)
{
 
    // 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 Legendre ---> cos(2l theta)
//------------------------------------------------
 
    chb_legpp_cosp(deg , cf, cf_cs) ;  
 
//--------------------------------------------------------------
// 2/ Transformation cos(2l theta) ---> esp. des configurations
//--------------------------------------------------------------
 
    citcosp(deg, dimc, cf_cs, dimf, ff) ;
 
    // Menage
    delete [] cf_cs ;
    
}
}