IrbemAPI.hpp

浏览该文件的文档.

 
 
#pragma once
 
#include "AstGlobal.h"
#include "AstUtil/StringView.hpp"
#include <mutex>
#include <array>
#include <string>
#include <vector>
 
AST_NAMESPACE_BEGIN
 
class AST_WEATHER_API IrbemAPI
{
public:
    enum FuncIndex {
        kIrbemFortranVersion, kGetIrbemNtimeMax,
        kMakeLstar, kGetField,
        kFlyInAfrlCrres, kGetCrresFlux, kNumFunctions
    };
    using FuncArray = std::array<void*, kNumFunctions>;
 
    static IrbemAPI* Instance();
 
    IrbemAPI() = default;
 
    explicit IrbemAPI(bool shouldLoad);
 
    ~IrbemAPI();
 
    errc_t load(StringView libPath);
 
    errc_t tryload(const std::vector<std::string>& libPaths);
 
    errc_t unload();
 
    bool isLoaded() const { return library_ != nullptr; }
 
public:
    // ---- 纯常量查询，不加锁 ----
 
    errc_t irbem_fortran_version1(int* version);
 
    errc_t get_irbem_ntime_max1(int* ntime_max);
 
    // ---- 涉及 COMMON 块共享状态，内部加锁 ----
 
    errc_t make_lstar1(int ntime, int kext, const std::array<int, 5>& options, int sysaxes,
                       const int* iyear, const int* idoy, const double* UT,
                       const double* x1, const double* x2, const double* x3,
                       const double* maginput,
                       double* Lm, double* Lstar, double* Blocal,
                       double* Bmin, double* J, double* MLT);
 
    errc_t get_field1(int kext, const std::array<int, 5>& options, int sysaxes,
                      int iyear, int idoy, double UT,
                      double x1, double x2, double x3,
                      const double* maginput,
                      double Bgeo[3], double& B);
 
    errc_t fly_in_afrl_crres1(int ntime, int sysaxes,
                              int whichm, int whatf, int nene,
                              const double* energy,
                              const int* iyear, const int* idoy, const double* UT,
                              const double* x1, const double* x2, const double* x3,
                              const double* Ap15, double* flux,
                              StringView ascii_path);
 
    errc_t get_crres_flux(int ntime, int whichm, int whatf,
                          int nene, const double* energy,
                          const double* BBo, const double* L, const double* Ap15,
                          double* flux, StringView ascii_path);
 
protected:
    A_DISABLE_COPY(IrbemAPI);
 
    void*       library_{nullptr};
    FuncArray   functions_{};
    std::mutex  mutex_{};
};
 
AST_NAMESPACE_END