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 
205 : public Gyoto::SmartPointee,
206  public Gyoto::Object
207 {
209 
210 
211  // Data :
212  // -----
213 private:
214 
223 
224  protected:
225 
229  SmartPointer<Gyoto::Metric::Generic> gg_;
230 
231 
241  double rmax_;
242 
250 
252 
253  int shadow_;
255 
256  std::string magneticConfig_; // Magnetic field geometry (toroidal, vertical)
257  // Constructors - Destructor
258  // -------------------------
259  public:
260  GYOTO_OBJECT;
261 
265  Generic();
266 
270  Generic(double radmax);
271 
275  Generic(std::string kind);
276 
280  Generic(const Generic& ) ;
281 
298  virtual Generic* clone() const = 0 ;
299 
300  virtual ~Generic() ;
301 
302  // Accessors
303  // ---------
304  public:
308  virtual SmartPointer<Metric::Generic> metric() const;
309 
313  virtual void metric(SmartPointer<Metric::Generic>) ;
314 
326  virtual double rMax();
327  virtual double rMax() const;
328 
335  virtual double rMax(std::string const &unit);
336  virtual double rMax(std::string const &unit) const;
337 
339 
343  virtual double deltaMax(double coord[8]);
344 
351  virtual void rMax(double val);
352 
360  virtual void rMax(double val, std::string const &unit);
361 
362  GYOTO_OBJECT_ACCESSORS_UNIT(deltaMaxInsideRMax);
363 
369  void opticallyThin(bool flag);
371 
374  bool opticallyThin() const ;
376 
377  void showshadow(bool flag);
378  bool showshadow() const ;
379 
380  void redshift(bool flag);
381  bool redshift() const ;
382 
391 
392  //XML I/O
393  public:
394 
395 #ifdef GYOTO_USE_XERCES
396 
417  virtual void setParameters(FactoryMessenger *fmp);
418 
419 
420 #endif
421 
422  // Outputs
423  // -------
424  public:
459  virtual int Impact(Gyoto::Photon* ph, size_t index,
460  Astrobj::Properties *data=NULL) = 0 ;
462 
475  virtual void processHitQuantities(Photon * ph, state_t const &coord_ph_hit,
476  double const * coord_obj_hit, double dt,
477  Astrobj::Properties* data) const;
478  virtual void processHitQuantities(Photon* ph, double* coord_ph_hit,
479  double* coord_obj_hit, double dt,
480  Astrobj::Properties* data) const = delete ;
481 
531  virtual double emission(double nu_em, double dsem, state_t const &coord_ph,
532  double const coord_obj[8]=NULL)
533  const ;
534  virtual double emission(double nu_em, double dsem, double coord_ph[8],
535  double coord_obj[8]=NULL)
536  const = delete;
537 
560  virtual void emission(double Inu[], double const nu_em[], size_t nbnu,
561  double dsem, state_t const &coord_ph,
562  double const coord_obj[8]=NULL) const ;
563  virtual void emission(double Inu[], double nu_em[], size_t nbnu,
564  double dsem, double coord_ph[8],
565  double coord_obj[8]=NULL) const = delete ;
566 
570  virtual void radiativeQ(double Inu[], double Taunu[],
571  double const nu_em[], size_t nbnu,
572  double dsem, state_t const &coord_ph,
573  double const coord_obj[8]=NULL) const ;
574  virtual void radiativeQ(double Inu[], double Taunu[],
575  double nu_em[], size_t nbnu,
576  double dsem, double coord_ph[8],
577  double coord_obj[8]=NULL) const = delete ;
611  virtual void radiativeQ(double *Inu, double *Qnu, double *Unu, double *Vnu,
612  Eigen::Matrix4d *Onu, double const *nuem , size_t nbnu, double dsem,
613  state_t const &cph, double const *co) const ;
614 
626  virtual double integrateEmission(double nu1, double nu2, double dsem,
627  state_t const &c_ph, double const c_obj[8]=NULL) const;
629  virtual double integrateEmission(double nu1, double nu2, double dsem,
630  double c_ph[8], double c_obj[8]=NULL) const=delete;
631 
637  virtual void integrateEmission(double * I, double const * boundaries,
638  size_t const * chaninds, size_t nbnu,
639  double dsem, state_t const &cph, double const *co) const;
641  virtual void integrateEmission(double * I, double const * boundaries,
642  size_t const * chaninds, size_t nbnu,
643  double dsem, double *cph, double *co) const = delete;
645 
655  virtual double transmission(double nuem, double dsem, state_t const &coord_ph, double const coord_obj[8]) const ;
657  virtual double transmission(double nuem, double dsem, state_t const &coord) const = delete;
658  virtual double transmission(double nuem, double dsem, double coord[8]) const = delete;
660 
672  Eigen::Matrix4d Omatrix(double alphanu[4], double rnu[3], double Chi, double dsem) const;
673  Eigen::Matrix4d Omatrix(double alphaInu, double alphaQnu, double alphaUnu, double alphaVnu,
674  double rQnu, double rUnu, double rVnu, double Chi, double dsem) const;
675  Eigen::Matrix4d Omatrix(double alphanu[4], double rnu[3], double sin2Chi, double cos2Chi, double dsem) const;
676  Eigen::Matrix4d Omatrix(double alphaInu, double alphaQnu, double alphaUnu, double alphaVnu,
677  double rQnu, double rUnu, double rVnu, double sin2Chi, double cos2Chi, double dsem) const;
678 
679  Eigen::Matrix4d Pmatrix(double alphaInu, double alphaQnu, double alphaUnu, double alphaVnu,
680  double rQnu, double rUnu, double rVnu, double sin2Chi, double cos2Chi, double dsem) const;
681 
686  Eigen::Vector4d rotateJs(double jInu, double jQnu, double jUnu, double jVnu, double sin2Chi, double cos2Chi) const;
687  Eigen::Vector4d rotateJs(double jInu, double jQnu, double jUnu, double jVnu, double Chi) const;
688 
698  double getChi(double const fourvect[4], state_t const &cph, double const vel[4], bool elec=false) const;
699 
707  double get_theta_mag(double const fourvect[4], state_t const &coord_ph, double const vel[4]) const;
717  void getSinCos2Chi(double const fourvect[4], state_t const &cph, double const vel[4], double* sin2Chi, double* cos2Chi, bool elec=false) const;
727  void computeB4vect(double B4vect[4], std::string const magneticConfig, double const co[8], state_t const &cph, double const par=0.75) const;
728 
729  void computeB4vect_ipole(double B4vect[4], std::string const magneticConfig, double const co[8], state_t const &cph, double spin) const;
740  double interpolate(int const N, double* const array, double* const Xq, double** const X, int* const X_params, std::string const *cond_limits) const;
750  double interpolate(int const N, double* const array, double* const Xq, double** const X_params, std::string const *cond_limits) const;
751 
757  void magneticConfiguration(const std::string &config);
758 
762  std::string magneticConfiguration() const;
763 
764  private :
772  double interp1d(double const x, double const y0, double const y1) const;
782  double interpNd(int const N, double* const Xq, double** const X, double* const Y, std::string const *cond_limit) const;
791  int getIndice(double &xq, std::string const cond_limit, double const X_params[3], double* const X=NULL) const;
792 
793 };
794 
825  public:
826  double *intensity;
827  double *time;
828 
834  double *distance;
835 
839  double * first_dmin;
840 
846  int first_dmin_found;
847 
852  double *redshift;
853 
857  double *nbcrosseqplane;
858 
862  double *spectrum;
863 
864  double *stokesQ;
865  double *stokesU;
866  double *stokesV;
867 
873  double *binspectrum;
874 
879  ptrdiff_t offset;
880 
884  double * impactcoords;
885 
890  double *user1;
891 
896  double *user2;
897 
902  double *user3;
903 
908  double *user4;
909 
914  double *user5;
915 # ifdef HAVE_UDUNITS
916 
919  Gyoto::SmartPointer<Gyoto::Units::Converter> intensity_converter_ ;
923  Gyoto::SmartPointer<Gyoto::Units::Converter> spectrum_converter_ ;
927  Gyoto::SmartPointer<Gyoto::Units::Converter> binspectrum_converter_ ;
928 # endif
929 
931  bool alloc;
932 
933  public:
934  Properties();
935  Properties (double*, double*);
936 
948  void init(size_t nbnuobs=0);
949 
956  Properties& operator++();
957 
964  Properties& operator+=(ptrdiff_t offset);
965 
966  operator Gyoto::Quantity_t () const;
967 
968 # ifdef HAVE_UDUNITS
969  void intensityConverter(Gyoto::SmartPointer<Gyoto::Units::Converter>);
971  void intensityConverter(std::string);
973  void spectrumConverter(Gyoto::SmartPointer<Gyoto::Units::Converter>);
975  void spectrumConverter(std::string);
977  void binSpectrumConverter(Gyoto::SmartPointer<Gyoto::Units::Converter>);
979  void binSpectrumConverter(std::string);
981 # endif
982 };
983 
984 #endif
int noredshift_
1 to impose redshift factor g = 1
Definition: GyotoAstrobj.h:254
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:229
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:241
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:253
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:249
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
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:251
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:204
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:222
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:823
Entry in a register (or a full register)
Definition: GyotoRegister.h:132