File: timeSeries2PotentialCoefficients.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 (118 lines) | stat: -rw-r--r-- 5,750 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
106
107
108
109
110
111
112
113
114
115
116
117
118
/***********************************************/
/**
* @file timeSeries2PotentialCoefficients.cpp
*
* @brief Write time series as potential coefficients for each epoch.
*
* @author Torsten Mayer-Guerr
* @date 2020-07-20
*/
/***********************************************/

// Latex documentation
#define DOCSTRING docstring
static const char *docstring = R"(
Interpret the data columns of \configFile{inputfileTimeSeries}{instrument}
as potential coefficients. The sequence of coefficients is given by
\configClass{numbering}{sphericalHarmonicsNumberingType} starting from data column \config{startDataFields}.

For each epoch a \configFile{outputfilesPotentialCoefficients}{potentialCoefficients}
is written where the \config{variableLoopTime} and \config{variableLoopIndex} are expanded for
each point of the given time series to create the file name for this epoch,
see \reference{text parser}{general.parser:text}.

See also \program{Gravityfield2PotentialCoefficientsTimeSeries}.
)";

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

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

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

/** @brief Write time series as potential coefficients for each epoch.
* @ingroup programsGroup */
class TimeSeries2PotentialCoefficients
{
public:
  void run(Config &config, Parallel::CommunicatorPtr comm);
};

GROOPS_REGISTER_PROGRAM(TimeSeries2PotentialCoefficients, SINGLEPROCESS, "write time series as potential coefficients for each epoch.", Misc, TimeSeries, PotentialCoefficients)

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

void TimeSeries2PotentialCoefficients::run(Config &config, Parallel::CommunicatorPtr /*comm*/)
{
  try
  {
    FileName    fileNameOut, fileNameInstrument;
    std::string nameTime, nameIndex, nameCount;
    UInt        startData;
    UInt        minDegree, maxDegree;
    Double      GM, R;
    SphericalHarmonicsNumberingPtr numbering;

    readConfig(config, "outputfilesPotentialCoefficients", fileNameOut,        Config::MUSTSET,  "coeff_{loopTime:%y-%m}.gfc", "for each epoch");
    readConfig(config, "variableLoopTime",                 nameTime,           Config::OPTIONAL, "loopTime",        "variable with time of each epoch");
    readConfig(config, "variableLoopIndex",                nameIndex,          Config::OPTIONAL, "",                "variable with index of current epoch (starts with zero)");
    readConfig(config, "variableLoopCount",                nameCount,          Config::OPTIONAL, "",                "variable with total number of epochs");
    readConfig(config, "inputfileTimeSeries",              fileNameInstrument, Config::MUSTSET,  "",                "each epoch: multiple data for points (MISCVALUES)");
    readConfig(config, "startDataFields",                  startData,          Config::DEFAULT,  "0",               "first data column");
    readConfig(config, "minDegree",                        minDegree,          Config::MUSTSET,  "0",               "minimal degree");
    readConfig(config, "maxDegree",                        maxDegree,          Config::MUSTSET,  "",                "maximal degree");
    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;

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

    logStatus<<"read time series <"<<fileNameInstrument<<">"<<Log::endl;
    MiscValuesArc arc = InstrumentFile::read(fileNameInstrument);
    Arc::printStatistics(arc);
    const UInt dataCount = Epoch::dataCount(arc.getType(), TRUE/*mustDefined*/);
    if(dataCount < startData + parameterCount)
      throw(Exception("file contains not enough data columns: "+dataCount%"%i < "s+startData%"%i + "s+parameterCount%"%i"s));

    // write data
    // ----------
    const std::vector<Time> times = arc.times();
    VariableList varList;
    if(!nameTime.empty())  varList.undefineVariable(nameTime);
    if(!nameIndex.empty()) varList.undefineVariable(nameIndex);
    if(!nameCount.empty()) varList.setVariable(nameCount, times.size());

    for(UInt idEpoch=0; idEpoch<times.size(); idEpoch++)
    {
      Matrix cnm(maxDegree+1, Matrix::SYMMETRIC, Matrix::LOWER);
      Matrix snm(maxDegree+1, Matrix::SYMMETRIC, Matrix::LOWER);
      for(UInt n=minDegree; n<=maxDegree; n++)
      {
        if(idxC[n][0] != NULLINDEX) cnm(n,0) = arc.at(idEpoch).values(startData+idxC[n][0]);
        for(UInt m=1; m<=n; m++)
        {
          if(idxC[n][m] != NULLINDEX) cnm(n,m) = arc.at(idEpoch).values(startData+idxC[n][m]);
          if(idxS[n][m] != NULLINDEX) snm(n,m) = arc.at(idEpoch).values(startData+idxS[n][m]);
        }
      }

      if(!nameTime.empty())  varList.setVariable(nameTime, times.at(idEpoch).mjd());
      if(!nameIndex.empty()) varList.setVariable(nameIndex, idEpoch);
      logStatus<<"write potential coefficients <"<<fileNameOut(varList)<<">"<<Log::endl;
      writeFileSphericalHarmonics(fileNameOut(varList), SphericalHarmonics(GM, R, cnm, snm));
    }
  }
  catch(std::exception &e)
  {
    GROOPS_RETHROW(e)
  }
}

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