Gyoto
GyotoAstrobj.h
Go to the documentation of this file.
1 
8 /*
9  Copyright 2011-2024 Thibaut Paumard, Frederic Vincent
10 
11  This file is part of Gyoto.
12 
13  Gyoto is free software: you can redistribute it and/or modify
14  it under the terms of the GNU General Public License as published by
15  the Free Software Foundation, either version 3 of the License, or
16  (at your option) any later version.
17 
18  Gyoto is distributed in the hope that it will be useful,
19  but WITHOUT ANY WARRANTY; without even the implied warranty of
20  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
21  GNU General Public License for more details.
22 
23  You should have received a copy of the GNU General Public License
24  along with Gyoto. If not, see <http://www.gnu.org/licenses/>.
25  */
26 
27 
28 #ifndef __GyotoAstrobj_H_
29 #define __GyotoAstrobj_H_
30 
31 #include "GyotoConfig.h"
32 
33 #include <iostream>
34 #include <fstream>
35 #include <iomanip>
36 #include <string>
37 
38 #include <Eigen/Dense>
39 #include <unsupported/Eigen/MatrixFunctions>
40 
41 #include <GyotoDefs.h>
42 #include <GyotoSmartPointer.h>
43 #include <GyotoConverters.h>
44 #include <GyotoObject.h>
45 
46 namespace Gyoto{
47  class Photon;
48  namespace Register { class Entry; }
49  namespace Metric { class Generic; }
50  class FactoryMessenger;
51  namespace Astrobj {
52  class Generic;
53  class Properties;
54 
65  Subcontractor_t(Gyoto::FactoryMessenger*, std::vector<std::string> const &);
67 
79  (FactoryMessenger* fmp, std::vector<std::string> const &plugin) {
80  SmartPointer<T> ao = new T();
81  ao -> plugins(plugin) ;
82 #ifdef GYOTO_USE_XERCES
83  if (fmp) ao -> setParameters(fmp);
84 #endif
85  return ao;
86  }
88 
90 
112  std::vector<std::string> &plugin,
113  int errmode = 0);
114 
122 
126  void initRegister();
128 
140  void Register(std::string name, Gyoto::Astrobj::Subcontractor_t* scp);
142 
143  }
144 }
145 
206 : public Gyoto::SmartPointee,
207  public Gyoto::Object
208 {
210 
211 public:
213  static std::vector<std::string> registeredPluginsSlashKinds() ;
214 
215  // Data :
216  // -----
217 private:
218 
227 
228  protected:
229 
233  SmartPointer<Gyoto::Metric::Generic> gg_;
234 
235 
245  double rmax_;
246 
254 
256 
257  int shadow_;
259 
260  std::string magneticConfig_; // Magnetic field geometry (toroidal, vertical)
261  // Constructors - Destructor
262  // -------------------------
263  public:
264  GYOTO_OBJECT;
265 
269  Generic();
270 
274  Generic(double radmax);
275 
279  Generic(std::string kind);
280 
284  Generic(const Generic& ) ;
285 
302  virtual Generic* clone() const = 0 ;
303 
304  virtual ~Generic() ;
305 
306  // Accessors
307  // ---------
308  public:
312  virtual SmartPointer<Metric::Generic> metric() const;
313 
317  virtual void metric(SmartPointer<Metric::Generic>) ;
318 
330  virtual double rMax();
331  virtual double rMax() const;
332 
339  virtual double rMax(std::string const &unit);
340  virtual double rMax(std::string const &unit) const;
341 
343 
347  virtual double deltaMax(double coord[8]);
348 
355  virtual void rMax(double val);
356 
364  virtual void rMax(double val, std::string const &unit);
365 
366  GYOTO_OBJECT_ACCESSORS_UNIT(deltaMaxInsideRMax);
367 
373  void opticallyThin(bool flag);
375 
378  bool opticallyThin() const ;
380 
381  void showshadow(bool flag);
382  bool showshadow() const ;
383 
384  void redshift(bool flag);
385  bool redshift() const ;
386 
395 
396  //XML I/O
397  public:
398 
399 #ifdef GYOTO_USE_XERCES
400 
421  virtual void setParameters(FactoryMessenger *fmp);
422 
423 
424 #endif
425 
426  // Outputs
427  // -------
428  public:
463  virtual int Impact(Gyoto::Photon* ph, size_t index,
464  Astrobj::Properties *data=NULL) = 0 ;
466 
479  virtual void processHitQuantities(Photon * ph, state_t const &coord_ph_hit,
480  double const * coord_obj_hit, double dt,
481  Astrobj::Properties* data) const;
482  virtual void processHitQuantities(Photon* ph, double* coord_ph_hit,
483  double* coord_obj_hit, double dt,
484  Astrobj::Properties* data) const = delete ;
485 
535  virtual double emission(double nu_em, double dsem, state_t const &coord_ph,
536  double const coord_obj[8]=NULL)
537  const ;
538  virtual double emission(double nu_em, double dsem, double coord_ph[8],
539  double coord_obj[8]=NULL)
540  const = delete;
541 
564  virtual void emission(double Inu[], double const nu_em[], size_t nbnu,
565  double dsem, state_t const &coord_ph,
566  double const coord_obj[8]=NULL) const ;
567  virtual void emission(double Inu[], double nu_em[], size_t nbnu,
568  double dsem, double coord_ph[8],
569  double coord_obj[8]=NULL) const = delete ;
570 
574  virtual void radiativeQ(double Inu[], double Taunu[],
575  double const nu_em[], size_t nbnu,
576  double dsem, state_t const &coord_ph,
577  double const coord_obj[8]=NULL) const ;
578  virtual void radiativeQ(double Inu[], double Taunu[],
579  double nu_em[], size_t nbnu,
580  double dsem, double coord_ph[8],
581  double coord_obj[8]=NULL) const = delete ;
615  virtual void radiativeQ(double *Inu, double *Qnu, double *Unu, double *Vnu,
616  Eigen::Matrix4d *Onu, double const *nuem , size_t nbnu, double dsem,
617  state_t const &cph, double const *co) const ;
618 
630  virtual double integrateEmission(double nu1, double nu2, double dsem,
631  state_t const &c_ph, double const c_obj[8]=NULL) const;
633  virtual double integrateEmission(double nu1, double nu2, double dsem,
634  double c_ph[8], double c_obj[8]=NULL) const=delete;
635 
641  virtual void integrateEmission(double * I, double const * boundaries,
642  size_t const * chaninds, size_t nbnu,
643  double dsem, state_t const &cph, double const *co) const;
645  virtual void integrateEmission(double * I, double const * boundaries,
646  size_t const * chaninds, size_t nbnu,
647  double dsem, double *cph, double *co) const = delete;
649 
659  virtual double transmission(double nuem, double dsem, state_t const &coord_ph, double const coord_obj[8]) const ;
661  virtual double transmission(double nuem, double dsem, state_t const &coord) const = delete;
662  virtual double transmission(double nuem, double dsem, double coord[8]) const = delete;
664 
676  Eigen::Matrix4d Omatrix(double alphanu[4], double rnu[3], double Chi, double dsem) const;
677  Eigen::Matrix4d Omatrix(double alphaInu, double alphaQnu, double alphaUnu, double alphaVnu,
678  double rQnu, double rUnu, double rVnu, double Chi, double dsem) const;
679  Eigen::Matrix4d Omatrix(double alphanu[4], double rnu[3], double sin2Chi, double cos2Chi, double dsem) const;
680  Eigen::Matrix4d Omatrix(double alphaInu, double alphaQnu, double alphaUnu, double alphaVnu,
681  double rQnu, double rUnu, double rVnu, double sin2Chi, double cos2Chi, double dsem) const;
682 
683  Eigen::Matrix4d Pmatrix(double alphaInu, double alphaQnu, double alphaUnu, double alphaVnu,
684  double rQnu, double rUnu, double rVnu, double sin2Chi, double cos2Chi, double dsem) const;
685 
690  Eigen::Vector4d rotateJs(double jInu, double jQnu, double jUnu, double jVnu, double sin2Chi, double cos2Chi) const;
691  Eigen::Vector4d rotateJs(double jInu, double jQnu, double jUnu, double jVnu, double Chi) const;
692 
702  double getChi(double const fourvect[4], state_t const &cph, double const vel[4], bool elec=false) const;
703 
711  double get_theta_mag(double const fourvect[4], state_t const &coord_ph, double const vel[4]) const;
721  void getSinCos2Chi(double const fourvect[4], state_t const &cph, double const vel[4], double* sin2Chi, double* cos2Chi, bool elec=false) const;
731  void computeB4vect(double B4vect[4], std::string const magneticConfig, double const co[8], state_t const &cph, double const par=0.75) const;
732 
733  void computeB4vect_ipole(double B4vect[4], std::string const magneticConfig, double const co[8], state_t const &cph, double spin) const;
744  double interpolate(int const N, double* const array, double* const Xq, double** const X, int* const X_params, std::string const *cond_limits) const;
754  double interpolate(int const N, double* const array, double* const Xq, double** const X_params, std::string const *cond_limits) const;
755 
761  void magneticConfiguration(const std::string &config);
762 
766  std::string magneticConfiguration() const;
767 
768  private :
776  double interp1d(double const x, double const y0, double const y1) const;
786  double interpNd(int const N, double* const Xq, double** const X, double* const Y, std::string const *cond_limit) const;
795  int getIndice(double &xq, std::string const cond_limit, double const X_params[3], double* const X=NULL) const;
796 
797 };
798 
829  public:
830  double *intensity;
831  double *time;
832 
838  double *distance;
839 
843  double * first_dmin;
844 
850  int first_dmin_found;
851 
856  double *redshift;
857 
861  double *nbcrosseqplane;
862 
866  double *spectrum;
867 
868  double *stokesQ;
869  double *stokesU;
870  double *stokesV;
871 
877  double *binspectrum;
878 
883  ptrdiff_t offset;
884 
888  double * impactcoords;
889 
894  double *user1;
895 
900  double *user2;
901 
906  double *user3;
907 
912  double *user4;
913 
918  double *user5;
919 # ifdef HAVE_UDUNITS
920 
923  Gyoto::SmartPointer<Gyoto::Units::Converter> intensity_converter_ ;
927  Gyoto::SmartPointer<Gyoto::Units::Converter> spectrum_converter_ ;
931  Gyoto::SmartPointer<Gyoto::Units::Converter> binspectrum_converter_ ;
932 # endif
933 
935  bool alloc;
936 
937  public:
938  Properties();
939  Properties (double*, double*);
940 
952  void init(size_t nbnuobs=0);
953 
960  Properties& operator++();
961 
968  Properties& operator+=(ptrdiff_t offset);
969 
970  operator Gyoto::Quantity_t () const;
971 
972 # ifdef HAVE_UDUNITS
973  void intensityConverter(Gyoto::SmartPointer<Gyoto::Units::Converter>);
975  void intensityConverter(std::string);
977  void spectrumConverter(Gyoto::SmartPointer<Gyoto::Units::Converter>);
979  void spectrumConverter(std::string);
981  void binSpectrumConverter(Gyoto::SmartPointer<Gyoto::Units::Converter>);
983  void binSpectrumConverter(std::string);
985 # endif
986 };
987 
988 #endif
int noredshift_
1 to impose redshift factor g = 1
Definition: GyotoAstrobj.h:258
std::string magneticConfiguration() const
#define GYOTO_OBJECT
Declare class::properties and class::getProperties()
Definition: GyotoObject.h:84
virtual Gyoto::Quantity_t getDefaultQuantities()
Which quantities to compute if know was requested.
void getSinCos2Chi(double const fourvect[4], state_t const &cph, double const vel[4], double *sin2Chi, double *cos2Chi, bool elec=false) const
virtual void radiativeQ(double Inu[], double Taunu[], double const nu_em[], size_t nbnu, double dsem, state_t const &coord_ph, double const coord_obj[8]=NULL) const
emission and transmission together
virtual double deltaMax(double coord[8])
Get max step constraint for adaptive integration.
void computeB4vect(double B4vect[4], std::string const magneticConfig, double const co[8], state_t const &cph, double const par=0.75) const
virtual double transmission(double nuem, double dsem, state_t const &coord_ph, double const coord_obj[8]) const
Transmission: exp( αν * dsem )
Eigen::Matrix4d Omatrix(double alphanu[4], double rnu[3], double Chi, double dsem) const
A null geodesic transporting light.
Definition: GyotoPhoton.h:54
Base class for metrics.
Definition: GyotoMetric.h:163
Reference-counting pointers.
double interp1d(double const x, double const y0, double const y1) const
void Register(std::string name, Gyoto::Astrobj::Subcontractor_t *scp)
Make an Astrobj kind known to the Factory.
virtual double integrateEmission(double nu1, double nu2, double dsem, state_t const &c_ph, double const c_obj[8]=NULL) const
∫ν1ν2 Iν dν (or jν)
SmartPointer< Gyoto::Metric::Generic > gg_
The Metric in this end of the Universe.
Definition: GyotoAstrobj.h:233
Factory / SmartPointee::Subcontractor_t interface.
Definition: GyotoFactoryMessenger.h:92
int getIndice(double &xq, std::string const cond_limit, double const X_params[3], double *const X=NULL) const
double interpolate(int const N, double *const array, double *const Xq, double **const X, int *const X_params, std::string const *cond_limits) const
void init(char const *pluglist=NULL)
Initialise the various registers.
virtual double rMax()
Get maximal distance from center of coordinate system.
double rmax_
Maximum distance to the center of the coordinate system [geometrical units].
Definition: GyotoAstrobj.h:245
Gyoto ubiquitous macros and typedefs.
Compile-time configuration.
Gyoto::Register::Entry * Register_
The Astrobj register.
int shadow_
1 to highlight the shadow region in the image
Definition: GyotoAstrobj.h:257
void initRegister()
Empty the Astrobj register Astrobj::Register_.
Introspectable objects.
SmartPointer< Gyoto::Astrobj::Generic > Subcontractor_t(Gyoto::FactoryMessenger *, std::vector< std::string > const &)
A function to build instances of a specific Astrobj::Generic sub-class.
Definition: GyotoAstrobj.h:65
Namespace for the Gyoto library.
Definition: GyotoAstrobj.h:46
virtual void setParameters(FactoryMessenger *fmp)
Main loop in Subcontractor_t function.
unsigned int Quantity_t
Type for observabke quantities.
Definition: GyotoDefs.h:76
virtual void processHitQuantities(Photon *ph, state_t const &coord_ph_hit, double const *coord_obj_hit, double dt, Astrobj::Properties *data) const
Fills Astrobj::Properties.
double deltamaxinsidermax_
Maximum Photon integration step inside rmax_ [geometrical units].
Definition: GyotoAstrobj.h:253
Gyoto::Astrobj::Subcontractor_t * getSubcontractor(std::string name, std::vector< std::string > &plugin, int errmode=0)
Query the Astrobj register Astrobj::Register_.
double interpNd(int const N, double *const Xq, double **const X, double *const Y, std::string const *cond_limit) const
Can be pointed to by a SmartPointer.
Definition: GyotoSmartPointer.h:80
static std::vector< std::string > registeredPluginsSlashKinds()
Get list of "plugins/names" of all registered Astrobjs.
virtual int Impact(Gyoto::Photon *ph, size_t index, Astrobj::Properties *data=NULL)=0
Does a photon at these coordinates impact the object?
virtual SmartPointer< Metric::Generic > metric() const
Get the Metric gg_.
bool flag_radtransf_
1 if radiative transfer inside Astrobj, else 0
Definition: GyotoAstrobj.h:255
Eigen::Vector4d rotateJs(double jInu, double jQnu, double jUnu, double jVnu, double sin2Chi, double cos2Chi) const
GYOTO converters.
virtual Generic * clone() const =0
Cloner.
Base class for astronomical object.
Definition: GyotoAstrobj.h:205
Object with properties.
Definition: GyotoObject.h:151
bool opticallyThin() const
Query whether object is optically thin.
int __defaultfeatures
Whether some virtual methods are implemented.
Definition: GyotoAstrobj.h:226
SmartPointer< Astrobj::Generic > Subcontractor(FactoryMessenger *fmp, std::vector< std::string > const &plugin)
A template for Subcontractor_t functions.
Definition: GyotoAstrobj.h:79
double getChi(double const fourvect[4], state_t const &cph, double const vel[4], bool elec=false) const
#define GYOTO_OBJECT_ACCESSORS_UNIT(method)
Declare a quadruplet of accessors to double member that supports unit.
Definition: GyotoObject.h:70
virtual double emission(double nu_em, double dsem, state_t const &coord_ph, double const coord_obj[8]=NULL) const
Specific intensity Iν
double get_theta_mag(double const fourvect[4], state_t const &coord_ph, double const vel[4]) const
Observable properties of an Astronomical object.
Definition: GyotoAstrobj.h:827
Entry in a register (or a full register)
Definition: GyotoRegister.h:132