File: graceL1b2Magnetometer.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 (126 lines) | stat: -rw-r--r-- 4,276 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
119
120
121
122
123
124
125
126
/***********************************************/
/**
* @file graceL1b2Magnetometer.cpp
*
* @brief Read GRACE L1B data.
*
* @author Beate Klinger
* @date 2014-05-26
*
*/
/***********************************************/

// Latex documentation
#define DOCSTRING docstring
static const char *docstring = R"(
This program converts magnetometer data (MAG1B or MAG1A) from the GRACE SDS format into \file{instrument file (MAGNETOMETER)}{instrument}.
For further information see \program{GraceL1b2Accelerometer}.
)";

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

#include "programs/program.h"
#include "files/fileInstrument.h"
#include "fileGrace.h"

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

/** @brief Read GRACE L1B data.
* @ingroup programsConversionGroup */
class GraceL1b2Magnetometer
{
public:
  void run(Config &config, Parallel::CommunicatorPtr comm);
};

GROOPS_REGISTER_PROGRAM(GraceL1b2Magnetometer, SINGLEPROCESS, "read GRACE L1B data (MAG1B or MAG1A)", Conversion, Grace, Instrument)

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

void GraceL1b2Magnetometer::run(Config &config, Parallel::CommunicatorPtr /*comm*/)
{
  try
  {
    FileName              fileNameOut;
    std::vector<FileName> fileNameIn;

    readConfig(config, "outputfileMagnetometer", fileNameOut, Config::MUSTSET,  "", "MAGNETOMETER");
    readConfig(config, "inputfile",              fileNameIn,  Config::MUSTSET,  "", "MAG1B or MAG1A");
    if(isCreateSchema(config)) return;

    // =============================================

    logStatus<<"read input files"<<Log::endl;
    Arc arc;
    for(UInt idFile=0; idFile<fileNameIn.size(); idFile++)
    {
      logStatus<<"read file <"<<fileNameIn.at(idFile)<<">"<<Log::endl;
      UInt numberOfRecords;
      FileInGrace file(fileNameIn.at(idFile), numberOfRecords);

      for(UInt idEpoch=0; idEpoch<numberOfRecords; idEpoch++)
      {
        Int32    seconds, time_frac;
        Char     time_ref, GRACE_id;
        Float    MfvX_RAW, MfvY_RAW, MfvZ_RAW;
        Float    torque1A, torque2A, torque3A, torque1B, torque2B, torque3B;
        Float    MF_BCalX, MF_BCalY, MF_BCalZ, torque_cal;
        Byte     qualflg;

        try
        {
          file>>seconds>>time_frac>>time_ref>>GRACE_id; // GRACEFO: time_ref and GRACE_id are interschanged
          file>>MfvX_RAW>>MfvY_RAW>>MfvZ_RAW;
          file>>torque1A>>torque2A>>torque3A>>torque1B>>torque2B>>torque3B;
          file>>MF_BCalX>>MF_BCalY>>MF_BCalZ>>torque_cal>>FileInGrace::flag(qualflg);
        }
        catch(std::exception &/*e*/)
        {
          // GRACE-FO number of records issue
          logWarning<<arc.back().time.dateTimeStr()<<": file ended at "<<idEpoch<<" of "<<numberOfRecords<<" expected records"<<Log::endl;
          break;
        }

        const Time time = mjd2time(51544.5) + seconds2time(seconds) + seconds2time(1e-6*time_frac);
        if(arc.size() && (time <= arc.back().time))
          logWarning<<"epoch("<<time.dateTimeStr()<<") <= last epoch("<<arc.back().time.dateTimeStr()<<")"<<Log::endl;

        MagnetometerEpoch epoch;
        epoch.time                     = time;
        epoch.magneticField            = Vector3d(MfvX_RAW, MfvY_RAW, MfvZ_RAW);
        epoch.torquerA                 = Vector3d(torque1A, torque2A, torque3A);
        epoch.torquerB                 = Vector3d(torque1B, torque2B, torque3B);
        epoch.magneticFieldCalibration = Vector3d(MF_BCalX, MF_BCalY, MF_BCalZ);
        epoch.torquerCalibration       = torque_cal;
        arc.push_back(epoch);
      } // for(idEpoch)
    } // for(idFile)

    // =============================================

    logStatus<<"sort epochs"<<Log::endl;
    arc.sort();

    logStatus<<"eliminate duplicates"<<Log::endl;
    const UInt oldSize = arc.size();
    arc.removeDuplicateEpochs(TRUE/*keepFirst*/);
    if(arc.size() < oldSize)
      logInfo<<" "<<oldSize-arc.size()<<" duplicates removed!"<<Log::endl;

    Arc::printStatistics(arc);
    if(arc.size() == 0)
      return;

    if(!fileNameOut.empty())
    {
      logInfo<<"write data to <"<<fileNameOut<<">"<<Log::endl;
      InstrumentFile::write(fileNameOut, arc);
    }
  }
  catch(std::exception &e)
  {
    GROOPS_RETHROW(e)
  }
}

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