ast/api/DataGroupMagField_8hpp_source.html

#pragma once


#include "AstGlobal.h"

#include "AstReport/DataGroupTimeVar.hpp"

#include "AstCore/Point.hpp"

#include "AstCore/CelestialBody.hpp"

#include "AstCore/GeodeticPoint.hpp"

#include "AstMath/Vector.hpp"

#include "AstUtil/Span.hpp"


AST_NAMESPACE_BEGIN


class AST_REPORT_API DataGroupMagField : public DataGroupTimeVar

{

public:


    struct Data

    {

        TimePoint time_{};


        // -- NEZ 当地分量 [T] --

        double totalIntensityF_{};     // F  = 总强度

        double northIntensityX_{};     // X  = 北向分量

        double eastIntensityY_{};      // Y  = 东向分量

        double verticalIntensityZ_{};  // Z  = 垂直向下分量


        // -- 推导标量 --

        double horizontalIntensityH_{}; // H = √(X²+Y²) [T]

        double declinationD_{};         // D = atan2(Y,X) [rad]

        double inclinationI_{};         // I = atan2(Z,H) [rad]  向下为正


        // -- L 壳参数 [无量纲] --

        double dipoleL_{};      // Ldip  = 偶极子 L

        double mcIlwainL_{};    // Lm    = McIlwain L

        double absMcIlwainL_{}; // |Lm|


        // -- 磁镜比 --

        double bOverBeq_{};     // B/Beq [无量纲]

        double beq_{};          // Beq [T]  赤道磁场强度


        // -- ECF 矢量分量 [T] --

        double ecfX_{};

        double ecfY_{};

        double ecfZ_{};


        // -- ECI 矢量分量 [T] --

        double eciX_{};

        double eciY_{};

        double eciZ_{};


        // ---- getter ----

        const TimePoint& getTime()                  const { return time_; }

        double           getTotalIntensityF()       const { return totalIntensityF_; }

        double           getNorthIntensityX()       const { return northIntensityX_; }

        double           getEastIntensityY()        const { return eastIntensityY_; }

        double           getVerticalIntensityZ()    const { return verticalIntensityZ_; }

        double           getHorizontalIntensityH()  const { return horizontalIntensityH_; }

        double           getDeclinationD()          const { return declinationD_; }

        double           getInclinationI()          const { return inclinationI_; }

        double           getDipoleL()               const { return dipoleL_; }

        double           getMcIlwainL()             const { return mcIlwainL_; }

        double           getAbsMcIlwainL()          const { return absMcIlwainL_; }

        double           getBOverBeq()              const { return bOverBeq_; }

        double           getBeq()                   const { return beq_; }

        double           getEcfX()                  const { return ecfX_; }

        double           getEcfY()                  const { return ecfY_; }

        double           getEcfZ()                  const { return ecfZ_; }

        double           getEciX()                  const { return eciX_; }

        double           getEciY()                  const { return eciY_; }

        double           getEciZ()                  const { return eciZ_; }

    };


    static DataElements Elements();


    DataGroupMagField();

    ~DataGroupMagField() = default;

public:

    errc_t calculate(const TimeList& timeList, VariantVector& result) const override;

    const DataElements& getElements() const override;

public:

    errc_t calculate(const TimeList& timeList, std::vector<Data>& result) const;

    errc_t calculate(const TimeList& timeList, Span<Data> result) const;

public:

    Point* getPoint() const { return point_.get(); }

    Body*  getBody()  const { return body_.get(); }

    void   setPoint(Point* p) { point_ = p; }

    void   setBody(Body* b)   { body_ = b; }

private:

    WeakPtr<Point> point_{};

    WeakPtr<Body>  body_{};

};


AST_NAMESPACE_END

ast::CelestialBody
天体
定义 CelestialBody.hpp:72

ast::DataElements
数据元素容器
定义 DataElements.hpp:90

ast::DataGroupMagField
地磁场数据组
定义 DataGroupMagField.hpp:43

ast::DataGroupTimeVar
随时间变化的数据组
定义 DataGroupTimeVar.hpp:37

ast::DataGroupTimeVar::calculate
virtual errc_t calculate(const TimeList &timeList, VariantVector &result) const =0
计算数据组

ast::Point
点抽象基类
定义 Point.hpp:41

ast::Span
非拥有的连续对象序列视图
定义 Span.hpp:71

ast::TimeList
时间点列表
定义 TimeList.hpp:49

ast::TimePoint
绝对时间点
定义 TimePoint.hpp:108

ast::VariantVector
变类型向量容器
定义 VariantVector.hpp:59

ast::DataGroupMagField::Data
定义 DataGroupMagField.hpp:46