EarthFrame.hpp

浏览该文件的文档.

 
 
#pragma once
 
#include "AstGlobal.h"
 
AST_NAMESPACE_BEGIN
 
class TimePoint;
class Rotation;
class KinematicRotation;
 
 
//----------------
// ECI -> ECF
//----------------
 
 
 
AST_CORE_API void aECIToECFTransform(const TimePoint& tp, Rotation& rotation);
 
 
AST_CORE_API void aECIToECFTransform(const TimePoint& tp, KinematicRotation& rotation);
 
 
AST_CORE_CAPI void aECIToECFMatrix(const TimePoint& tp, Matrix3d& matrix);
 
 
AST_CORE_API void aECIToECF(const TimePoint& tp, const Vector3d& vecECI, Vector3d& vecECF);
 
 
 
AST_CORE_API void aECIToECF(
    const TimePoint& tp,
    const Vector3d& vecECI,
    const Vector3d& velECI,
    Vector3d& vecECF,
    Vector3d& velECF
);
 
//----------------
// ECF -> ECI
//----------------
 
 
AST_CORE_API void aECFToECITransform(const TimePoint& tp, Rotation& rotation);
 
 
AST_CORE_API void aECFToECITransform(const TimePoint& tp, KinematicRotation& rotation);
 
 
AST_CORE_CAPI void aECFToECIMatrix(const TimePoint& tp, Matrix3d& matrix);
 
 
AST_CORE_API void aECFToECI(const TimePoint& tp, const Vector3d& vecECF, Vector3d& vecECI);
 
 
AST_CORE_API void aECFToECI(
    const TimePoint& tp,
    const Vector3d& vecECF,
    const Vector3d& velECF,
    Vector3d& vecECI,
    Vector3d& velECI
);
 
 
//----------------
// J2000 -> ECF
//----------------
 
AST_CORE_API void aJ2000ToECFTransform(const TimePoint& tp, Rotation& rotation);
 
 
AST_CORE_API void aJ2000ToECFTransform(const TimePoint& tp, KinematicRotation& rotation);
 
 
 
AST_CORE_API void aJ2000ToECFMatrix(const TimePoint& tp, Matrix3d& matrix);
 
 
AST_CORE_API void aJ2000ToECF(const TimePoint& tp, const Vector3d& vecJ2000, Vector3d& vecECF);
 
 
 
AST_CORE_API void aJ2000ToECF(
    const TimePoint& tp,
    const Vector3d& vecJ2000,
    const Vector3d& velJ2000,
    Vector3d& vecECF,
    Vector3d& velECF
);
 
 
//----------------
// ECF -> J2000
//----------------
 
AST_CORE_API void aECFToJ2000Transform(const TimePoint& tp, Rotation& rotation);
 
AST_CORE_API void aECFToJ2000Transform(const TimePoint& tp, KinematicRotation& rotation);
 
AST_CORE_API void aECFToJ2000Matrix(const TimePoint& tp, Matrix3d& matrix);
 
 
AST_CORE_API void aECFToJ2000(const TimePoint& tp, const Vector3d& vecECF, Vector3d& vecJ2000);
 
 
AST_CORE_API void aECFToJ2000(
    const TimePoint& tp, 
    const Vector3d& vecECF, 
    const Vector3d& velECF, 
    Vector3d& vecJ2000, 
    Vector3d& velJ2000
);
 
 
//----------------
// J2000 -> MOD
//----------------
 
 
AST_CORE_CAPI void aJ2000ToMODTransform(const TimePoint& tp, Rotation& rotation);
 
 
AST_CORE_CAPI void aJ2000ToMODMatrix(const TimePoint& tp, Matrix3d& matrix);
 
 
 
AST_CORE_CAPI void aJ2000ToMOD(const TimePoint& tp, const Vector3d& vecJ2000, Vector3d& vecMOD); 
 
 
//----------------
// MOD -> TOD
//----------------
 
 
AST_CORE_CAPI void aMODToTODTransform(const TimePoint& tp, Rotation& rotation);
 
 
AST_CORE_CAPI void aMODToTODMatrix(const TimePoint& tp, Matrix3d& matrix);
 
 
AST_CORE_CAPI void aMODToTOD(const TimePoint& tp, const Vector3d& vecMOD, Vector3d& vecTOD);
 
 
 
 
//----------------
// TOD -> GTOD
//----------------
 
 
AST_CORE_API void aTODToGTODTransform(const TimePoint& tp, Rotation& rotation);
 
 
AST_CORE_API void aTODToGTODTransform(const TimePoint& tp, KinematicRotation& rotation);
 
 
AST_CORE_API void aTODToGTODMatrix(const TimePoint& tp, Matrix3d& matrix);
 
 
AST_CORE_API void aTODToGTOD(const TimePoint& tp, const Vector3d& vecTOD, Vector3d& vecGTOD);
 
 
 
AST_CORE_API void aTODToGTOD(
    const TimePoint& tp, 
    const Vector3d& vecTOD, const Vector3d& velTOD,
    Vector3d& vecGTOC, Vector3d& velGTOC
);
 
 
//----------------
// TOD -> TEME
//----------------
 
/*
    IAU 1994 Resolution C7 春分点补正项控制宏（仅影响 TEME）：
 
    默认行为：采用IAU 1994 Resolution C7 春分点补正项公式（不定义宏 AST_TEME_NO_IAU1994_C7）：
    TEME 分点差使用完整公式：ee = dpsi*cos(eps) + eqecorr(C7补正项)
    与 SOFA iauEqeq94 、Orekit TEMEProvider 行为一致，精度更高。
 
    如需使用不含 C7 补正项的经典公式(老公式)：
    ee = dpsi*cos(eps + deps)
    请在编译选项中定义 AST_TEME_NO_IAU1994_C7 宏。
    此选项仅影响 TOD↔TEME 变换，不影响 TOD↔GTOD（该变换始终包含完整补正）。
 
    @see IAU 1994 Resolution C7, SOFA iauEqeq94
*/
 
//#define AST_TEME_NO_IAU1994_C7
 
AST_CORE_CAPI void aTODToTEMETransform(const TimePoint& tp, Rotation& rotation);
 
AST_CORE_API void aTODToTEMETransform(const TimePoint& tp, KinematicRotation& rotation);
 
AST_CORE_CAPI void aTODToTEMEMatrix(const TimePoint& tp, Matrix3d& matrix);
 
AST_CORE_CAPI void aTODToTEME(const TimePoint& tp, const Vector3d& vecTOD, Vector3d& vecTEME);
 
//----------------
// TEME -> TOD
//----------------
 
AST_CORE_CAPI void aTEMEToTODTransform(const TimePoint& tp, Rotation& rotation);
 
AST_CORE_CAPI void aTEMEToTODMatrix(const TimePoint& tp, Matrix3d& matrix);
 
AST_CORE_CAPI void aTEMEToTOD(const TimePoint& tp, const Vector3d& vecTEME, Vector3d& vecTOD);
 
 
//----------------
// J2000 -> TEME
//----------------
 
AST_CORE_API void aJ2000ToTEMETransform(const TimePoint& tp, Rotation& rotation);
 
 
AST_CORE_API void aJ2000ToTEMEMatrix(const TimePoint& tp, Matrix3d& matrix);
 
AST_CORE_API void aJ2000ToTEME(const TimePoint& tp, const Vector3d& vecJ2000, Vector3d& vecTEME);
 
 
//----------------
// TEME -> J2000
//----------------
 
AST_CORE_API void aTEMEToJ2000Transform(const TimePoint& tp, Rotation& rotation);
 
 
AST_CORE_API void aTEMEToJ2000Matrix(const TimePoint& tp, Matrix3d& matrix);
 
AST_CORE_API void aTEMEToJ2000(const TimePoint& tp, const Vector3d& vecTEME, Vector3d& vecJ2000);
 
 
 
//----------------
// GTOD -> ECF
//----------------
 
 
AST_CORE_CAPI void aGTODToECFTransform(const TimePoint& tp, Rotation& rotation);
 
 
AST_CORE_CAPI void aGTODToECFMatrix(const TimePoint& tp, Matrix3d& matrix);
 
 
 
AST_CORE_CAPI void aGTODToECF(const TimePoint& tp, const Vector3d& vecGTOD, Vector3d& vecECF);
 
 
 
//----------------
// ICRF -> ECF
//----------------
 
 
AST_CORE_API void aICRFToECFTransform(const TimePoint& tp, Rotation& rotation);
 
 
AST_CORE_API void aICRFToECFTransform(const TimePoint& tp, KinematicRotation& rotation);
 
 
AST_CORE_CAPI void aICRFToECFMatrix(const TimePoint& tp, Matrix3d& matrix);
 
 
AST_CORE_API void aICRFToECF(const TimePoint& tp, const Vector3d& vecICRF, Vector3d& vecECF);
 
AST_CORE_API void aECFToICRF(const TimePoint& tp, const Vector3d& vecECF, Vector3d& vecICRF);
 
AST_CORE_API void aICRFToECF(
    const TimePoint& tp, 
    const Vector3d& vecICRF, const Vector3d& velICRF, 
    Vector3d& vecECF, Vector3d& velECF
);
 
// ----------------
// ICRF -> CIRF
// ----------------
 
 
AST_CORE_CAPI void aICRFToCIRFTransform(const TimePoint& tp, Rotation& rotation);
 
 
AST_CORE_CAPI void aICRFToCIRFMatrix(const TimePoint& tp, Matrix3d& matrix);
 
 
AST_CORE_CAPI void aICRFToCIRF(const TimePoint& tp, const Vector3d& vecICRF, Vector3d& vecCIRF);
 
 
 
// ----------------
// CIRF -> TIRF
// ----------------
 
AST_CORE_API void aCIRFToTIRFTransform(const TimePoint& tp, Rotation& rotation);
 
AST_CORE_API void aCIRFToTIRFTransform(const TimePoint& tp, KinematicRotation& rotation);
 
AST_CORE_CAPI void aCIRFToTIRFMatrix(const TimePoint& tp, Matrix3d& matrix);
 
 
AST_CORE_API void aCIRFToTIRF(const TimePoint& tp, const Vector3d& vecCIRF, Vector3d& vecTIRF);
 
 
AST_CORE_API void aCIRFToTIRF(
    const TimePoint& tp, 
     const Vector3d& vecCIRF, const Vector3d& velCIRF,
     Vector3d& vecTIRF, Vector3d& velTIRF
);
 
 
// ----------------
// TIRF -> ECF
// ----------------
 
 
AST_CORE_CAPI void aTIRFToECFTransform(const TimePoint& tp, Rotation& rotation);
 
 
AST_CORE_CAPI void aTIRFToECFMatrix(const TimePoint& tp, Matrix3d& matrix);
 
AST_CORE_CAPI void aTIRFToECF(const TimePoint& tp, const Vector3d& vecTIRF, Vector3d& vecECF);
 
 
// ----------------
// ICRF -> J2000
// ----------------
 
 
AST_CORE_API void aICRFToJ2000Transform(const TimePoint& tp, Rotation& rotation);
 
 
AST_CORE_API void aICRFToJ2000Transform(const TimePoint& tp, KinematicRotation& rotation);
 
 
AST_CORE_CAPI void aICRFToJ2000Matrix(const TimePoint& tp, Matrix3d& matrix);
 
 
AST_CORE_API void aICRFToJ2000(const TimePoint& tp, const Vector3d& vecICRF, Vector3d& vecJ2000);
 
 
AST_CORE_API void aICRFToJ2000(
    const TimePoint& tp, 
    const Vector3d& vecICRF,
    const Vector3d& velICRF,
    Vector3d& vecJ2000,
    Vector3d& velJ2000
);
 
 
 
// ----------------
// J2000 -> ICRF
// ----------------
 
AST_CORE_API void aJ2000ToICRFTransform(const TimePoint& tp, Rotation& rotation);
 
AST_CORE_API void aJ2000ToICRFTransform(const TimePoint& tp, KinematicRotation& rotation);
 
AST_CORE_CAPI void aJ2000ToICRFMatrix(const TimePoint& tp, Matrix3d& matrix);
 
 
AST_CORE_API void aJ2000ToICRF(const TimePoint& tp, const Vector3d& vecJ2000, Vector3d& vecICRF);
 
 
AST_CORE_API void aJ2000ToICRF(
    const TimePoint& tp, 
    const Vector3d& vecJ2000,
    const Vector3d& velJ2000,
    Vector3d& vecICRF,
    Vector3d& velICRF
);
 
 
// ----------------
// Alias
// ----------------
 
 
A_ALWAYS_INLINE void aICRFToECFMatrix(const TimePoint& tp, double matrix[3][3])
{
    return aICRFToECFMatrix(tp, *((Matrix3d*)matrix));
}
 
AST_NAMESPACE_END