GyotoKerrBL.h

Go to the documentation of this file.

 
/*
    Copyright 2011, 2018 Frederic Vincent, Thibaut Paumard
 
    This file is part of Gyoto.
 
    Gyoto 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 3 of the License, or
    (at your option) any later version.
 
    Gyoto 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 Gyoto.  If not, see <http://www.gnu.org/licenses/>.
 */
 
#ifndef __GyotoKerrBL_H_
#define __GyotoKerrBL_H_ 
 
namespace Gyoto {
  namespace Metric { class KerrBL; }
}
 
#include <GyotoMetric.h>
#include <GyotoWorldline.h>
 
#ifdef GYOTO_USE_XERCES
#include <GyotoRegister.h>
#endif
 
 
#define GYOTO_KERRBL_DEFAULT_DIFFTOL 1e-2
 
class Gyoto::Metric::KerrBL : public Metric::Generic {
  friend class Gyoto::SmartPointer<Gyoto::Metric::KerrBL>;
  
  // Data : 
  // -----
 protected:
  double spin_ ;  
  double a2_ ; 
  double a3_ ; 
  double a4_ ; 
 
 
  double difftol_;
  double rsink_;  
  double drhor_;  
  bool   generic_integrator_; 
  
  // Constructors - Destructor
  // -------------------------
 public: 
  GYOTO_OBJECT;
  KerrBL(); 
  virtual KerrBL * clone () const ;
 
  // Accessors
  // ---------
 public:
  void spin(const double spin); 
  double spin() const ; 
 
  double difftol() const; 
  void difftol(double t); 
 
  void horizonSecurity(double drhor);
  double horizonSecurity() const;
  void genericIntegrator(bool);
  bool genericIntegrator() const ;
 
  virtual double getRms() const; 
 
  virtual double getRmb() const; 
 
  virtual double getSpecificAngularMomentum(double rr) const;
  
  virtual double getPotential(double const pos[4], double l_cst) const;
 
  void gmunu(double g[4][4], const double * pos) const ;
  double gmunu(const double * const x, int mu, int nu) const ;
 
  void gmunu_up(double gup[4][4], const double * pos) const ;
  double gmunu_up(const double * const x, int mu, int nu) const ;
 
  using Generic::christoffel;
  int christoffel(double dst[4][4][4], const double pos[4]) const ;
  
  double ScalarProd(const double pos[4],
                    const double u1[4], const double u2[4]) const ;
 
  void nullifyCoord(double coord[8], double & tdot2) const;
  void nullifyCoord(double coord[8]) const;
 
  //  friend std::ostream& operator<<(std::ostream& , const KerrBL& ) ;
  //  std::ostream& print(std::ostream&) const ;
  virtual void circularVelocity(double const pos[4], double vel [4],
                                double dir=1.) const ;
 
  virtual void zamoVelocity(double const pos[4], double vel[4]) const ;
 
 public:
  virtual void MakeCoord(const double coordin[8], const double cst[5], double coordout[8]) const ;
 
  void MakeMomentum(const double coordin[8], const double cst[5], double coordout[8]) const;
 
 protected:
 
  // outside the API
  /* RK4 : y=[r,theta,phi,t,pr,ptheta], 
     cst=[a,E,L,Q,1/Q],dy/dtau=F(y,cst), h=proper time step. 
     For KerrBL geodesic computation.
   */
  int myrk4(Worldline * line, Gyoto::state_t const &coordin, double h, Gyoto::state_t &res) const; //external-use RK4
  
 public:
  int myrk4(const double coor[8], const double cst[5], double h, double res[8]) const;
  int myrk4_adaptive(Gyoto::Worldline* line, Gyoto::state_t const &coor, double lastnorm, double normref, Gyoto::state_t &coor1, double h0, double& h1, double h1max=GYOTO_DEFAULT_DELTA_MAX) const; 
 private:
  int CheckCons(const double coor_init[8], const double cst[5], double coor_fin[8]) const;
 
  void Normalize4v(double coord[8], const double part_mass) const;
 
 public:
  using Metric::Generic::diff;
 private:
  virtual int diff(const double y[8], const double cst[5], 
                   double res[8]) const ;
  virtual void computeCst(const double coord[8], double cst[5]) const;
 public:
  void setParticleProperties(Worldline* line, const double* coord) const;
  virtual int isStopCondition(double const * const coord) const;
  
  virtual void observerTetrad(double const pos[4], double fourvel[4],
                              double screen1[4], double screen2[4],
                              double screen3[4]) const ;
 
};
 
#endif