File: miscAccelerations.h

package info (click to toggle)
groops 0%2Bgit20250907%2Bds-1
  • links: PTS, VCS
  • area: non-free
  • in suites: forky, sid
  • size: 11,140 kB
  • sloc: cpp: 135,607; fortran: 1,603; makefile: 20
file content (105 lines) | stat: -rw-r--r-- 3,598 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
/***********************************************/
/**
* @file miscAccelerations.h
*
* @brief Non conservative forces acting on satellites.
*
* @author Torsten Mayer-Guerr
* @date 2013-02-09
*
*/
/***********************************************/

#ifndef __GROOPS_MISCACCELERATIONS__
#define __GROOPS_MISCACCELERATIONS__

// Latex documentation
#ifdef DOCSTRING_MiscAccelerations
static const char *docstringMiscAccelerations = R"(
\section{MiscAccelerations}\label{miscAccelerationsType}
This class gives the non conservative forces acting on satellites.
)";
#endif

/***********************************************/

#include "base/import.h"
#include "config/config.h"
#include "files/fileSatelliteModel.h"
#include "classes/ephemerides/ephemerides.h"

/**
* @defgroup miscAccelerationsGroup MiscAccelerations
* @brief Non conservative forces acting on satellites.
* @ingroup classesGroup
* The interface is given by @ref MiscAccelerations. */
/// @{

/***** TYPES ***********************************/

class MiscAccelerations;
class MiscAccelerationsBase;
typedef std::shared_ptr<MiscAccelerations> MiscAccelerationsPtr;

/***** CLASS ***********************************/

/** @brief Non conservative forces acting on satellites.
* An Instance of this class can be created by @ref readConfig. */
class MiscAccelerations
{
  std::vector<MiscAccelerationsBase*> acc;

public:
  /// Constructor.
  MiscAccelerations(Config &config, const std::string &name);

  /// Destructor.
  ~MiscAccelerations();

  /** @brief Acceleration.
  * @param satellite Macro model.
  * @param time Time.
  * @param position in CRF [m].
  * @param velocity in CRF [m/s].
  * @param rotSat   Sat -> CRF
  * @param rotEarth CRF -> TRF
  * @param ephemerides Position of Sun and Moon.
  * @return acceleration in TRF(!) [m/s^2] */
  Vector3d acceleration(SatelliteModelPtr satellite, const Time &time, const Vector3d &position, const Vector3d &velocity,
                        const Rotary3d &rotSat, const Rotary3d &rotEarth, EphemeridesPtr ephemerides);

  /** @brief creates an derived instance of this class. */
  static MiscAccelerationsPtr create(Config &config, const std::string &name) {return MiscAccelerationsPtr(new MiscAccelerations(config, name));}
};


/***** FUNCTIONS *******************************/

/** @brief Creates an instance of the class MiscAccelerations.
* Search for a node with @a name in the Config node.
* if @a name is not found the function returns FALSE and @a acceleration without forces is created.
* @param config The config node which includes the node with the options for this class
* @param name Tag name in the config.
* @param[out] acceleration Created class.
* @param mustSet If is MUSTSET and @a name is not found, this function throws an exception instead of returning with FALSE.
* @param defaultValue Ignored at the moment.
* @param annotation Description of the function of this class.
* @relates MiscAccelerations */
template<> Bool readConfig(Config &config, const std::string &name, MiscAccelerationsPtr &acceleration, Config::Appearance mustSet, const std::string &defaultValue, const std::string &annotation);

/// @}

/***** CLASS ***********************************/

// Internal class
class MiscAccelerationsBase
{
public:
virtual ~MiscAccelerationsBase() {}
virtual  Vector3d acceleration(SatelliteModelPtr satellite, const Time &time, const Vector3d &position, const Vector3d &velocity,
                               const Rotary3d &rotSat, const Rotary3d &rotEarth, EphemeridesPtr ephemerides) = 0;
};

/***********************************************/

#endif