File: gravityfield2PotentialCoefficientsTimeSeries.cpp

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 (100 lines) | stat: -rw-r--r-- 4,080 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
/***********************************************/
/**
* @file gravityfield2PotentialCoefficientsTimeSeries.cpp
*
* @brief Time series of potential coefficients.
*
* @author Torsten Mayer-Guerr
* @date 2020-10-02
*/
/***********************************************/

// Latex documentation
#define DOCSTRING docstring
static const char *docstring = R"(
This program computes a \configClass{timeSeries}{timeSeriesType}
of a time variable \configClass{gravityfield}{gravityfieldType}
and converts to coefficients of a spherical harmonics expansion.
The expansion is limited in the range between \config{minDegree}
and \config{maxDegree} inclusivly.
The coefficients are related to the reference radius~\config{R}
and the Earth gravitational constant \config{GM}.

The \configFile{outputfileTimeSeries}{instrument} contains the potential coefficients
as data columns for each epoch in the sequence given by
\configClass{numbering}{sphericalHarmonicsNumberingType}.
)";

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

#include "programs/program.h"
#include "base/sphericalHarmonics.h"
#include "files/fileInstrument.h"
#include "classes/gravityfield/gravityfield.h"
#include "classes/timeSeries/timeSeries.h"
#include "classes/sphericalHarmonicsNumbering/sphericalHarmonicsNumbering.h"

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

/** @brief Time series of potential coefficients.
* @ingroup programsGroup */
class Gravityfield2PotentialCoefficientsTimeSeries
{
public:
  void run(Config &config, Parallel::CommunicatorPtr comm);
};

GROOPS_REGISTER_PROGRAM(Gravityfield2PotentialCoefficientsTimeSeries, SINGLEPROCESS, "time series of potential coefficients", Gravityfield, TimeSeries)

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

void Gravityfield2PotentialCoefficientsTimeSeries::run(Config &config, Parallel::CommunicatorPtr /*comm*/)
{
  try
  {
    FileName                       fileNameOut;
    GravityfieldPtr                gravityfield;
    TimeSeriesPtr                  timeSeries;
    UInt                           minDegree, maxDegree;
    Double                         GM, R;
    SphericalHarmonicsNumberingPtr numbering;

    readConfig(config, "outputfileTimeSeries", fileNameOut,  Config::MUSTSET, "",  "instrument file (MISCVALUES)");
    readConfig(config, "gravityfield",         gravityfield, Config::MUSTSET, "",  "");
    readConfig(config, "timeSeries",           timeSeries,   Config::MUSTSET, "",  "");
    readConfig(config, "minDegree",            minDegree,    Config::MUSTSET, "0", "");
    readConfig(config, "maxDegree",            maxDegree,    Config::MUSTSET, "",  "");
    readConfig(config, "GM",                   GM,           Config::DEFAULT, STRING_DEFAULT_GM, "Geocentric gravitational constant");
    readConfig(config, "R",                    R,            Config::DEFAULT, STRING_DEFAULT_R,  "reference radius");
    readConfig(config, "numbering",            numbering,    Config::MUSTSET, "",  "numbering scheme");
    if(isCreateSchema(config)) return;

    const std::vector<Time>        times = timeSeries->times();
    std::vector<std::vector<UInt>> idxC, idxS;
    numbering->numbering(maxDegree, minDegree, idxC, idxS);

    Matrix A(times.size(), 1+numbering->parameterCount(maxDegree, minDegree));
    for(UInt idEpoch=0; idEpoch<times.size(); idEpoch++)
    {
      SphericalHarmonics harm = gravityfield->sphericalHarmonics(times.at(idEpoch), maxDegree, minDegree, GM, R);
      for(UInt n=minDegree; n<=maxDegree; n++)
      {
        if(idxC[n][0]!=NULLINDEX) A(idEpoch, 1+idxC[n][0]) = harm.cnm()(n, 0);
        for(UInt m=1; m<=n; m++)
        {
          if(idxC[n][m]!=NULLINDEX) A(idEpoch, 1+idxC[n][m]) = harm.cnm()(n, m);
          if(idxS[n][m]!=NULLINDEX) A(idEpoch, 1+idxS[n][m]) = harm.snm()(n, m);
        }
      }
    }

    logStatus<<"write time series of potential coefficients to file <"<<fileNameOut<<">"<<Log::endl;
    InstrumentFile::write(fileNameOut, Arc(times, A));
  }
  catch(std::exception &e)
  {
    GROOPS_RETHROW(e)
  }
}

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