SIMDIS SDK SimCore

SIMDIS SDK SimCore代码库功能分析

一、概述

这套 SDK SimCore 代码系统提供了从低层数学运算、插值求根，到高层地理坐标转换、导航航向处理，再到应用层的随机仿真及单位管理的完整功能链。SIMDIS SDK SimCore 能在无人机仿真、舰载武器模拟、地理信息可视化、科学研究等多领域中，提供一套完整且高效的底层运算＋坐标处理＋应用服务解决方案。适用于航空航天、仿真可视化、地图测绘、科学计算等多种场景。

代码组成

  1. 数学与插值工具
    • 数学常量和基本运算（Math, Angle）
    • 3D向量和矩阵运算（Vec3, SquareMatrix, Dcm）
    • Interpolation：提供最近邻、线性、多点、向量及角度插值，并处理周期跳变与时间驱动插值。
    • NumericalAnalysis：实现二分法（Bisection）、割线法（Secant）、二阶 Newton 插值及反向插值算法。
    • SquareMatrix：方阵的构造、单位化、置零、转置、缩放、加法及矩阵乘法，支持元素访问和近似比较。
  2. 坐标系统
    • 坐标定义和转换（Coordinate, CoordinateConverter）
    • 特殊坐标系统（GARS）
    • MultiFrameCoordinate：在 LLA（经纬高）与 ECEF（地心地固）等多坐标系间双向转换，支持缓存与懒更新。
    • Mgrs：MGRS ↔ UTM/UPS ↔ 地理坐标的全流程双向转换，含特殊区域（Svalbard/Norway）兼容。
    • MagneticVariance：基于 NOAA 世界磁场模型（WMM）计算地磁偏角，并提供真/磁航向互转。
    • VerticalDatum：枚举不同垂直基准（WGS-84、MSL、用户自定义）。
  3. 随机数与数值环境
    • Random：生成均匀、正态（实/复）、指数、Poisson、几何、二项及离散均匀分布样本，支持全局与手动种子。
    • Units：定义各种物理量单位及其相互转换，提供注册表和查询接口。
    • UnitContext：管理当前应用的单位和显示格式（时间、坐标、角度、距离、速度、磁偏、高程等），可动态修改精度与格式。
  4. 几何计算
    • 基础几何体和相交测试（Geometry）
    • 地理围栏（GeoFence）
  5. 应用层
    • 距离、角度、高度等计算（Calculations）
    • 磁偏角和垂直基准面转换（DatumConvert）
    • 多边形转换为地理围栏（GogToGeoFence）

使用场景

  1. 航空航天／无人机仿真

    • 路径规划、姿态平滑、真磁航向转换、传感器噪声注入与多坐标系数据融合。

  2. 地理信息系统（GIS）与测绘

    • MGRS/UTM/UPS 与地理坐标互转、地理围栏判定、GOG 图形转围栏等大规模地图服务。

  3. 军事与舰船导航

    • 高精度地磁偏角计算、各种坐标系（NED/ENU/ECEF/ECI）转换、Sodano 测地线计算。

  4. 科学计算与可视化

    • 数值根查找（Bisection、Secant、Newton 插值）、方阵与 DCM 操作、随机分布采样、物理量单位管理与格式化。

编译器要求

从代码中可以看出：

  1. C++11或更高：使用了 noexcept、= default 等C++11特性
  2. MSVC版本检测：代码检查 _MSC_VER < 1800 来处理旧版MSVC的兼容性

外部依赖

这是一个相对独立的数学计算模块，外部依赖很少，主要依赖标准库。这种设计使得代码具有良好的可移植性和独立性。这些代码不依赖：

  • 第三方数学库（如Eigen、BLAS等）
  • 图形库（如OpenGL、DirectX）
  • 其他第三方框架

二、代码文件功能分析

1. MathConstants.h

功能：定义常用数学常量

  • 主要常量：M_PI, M_E, M_TWOPI, M_PI_2等
  • 跨平台兼容性处理（Windows/Linux）

2. Vec3.h

功能：三维向量类

  • 数据结构：包含3个double元素的向量
  • 主要操作：
    • 构造函数和赋值操作
    • 向量运算：加减、标量乘除、点积、叉积
    • 访问器：x/y/z, lat/lon/alt, range/azimuth/elevation等
    • 工具函数：length(), normalize(), zero()

3. Angle.h/cpp

功能：角度处理和转换

  • 角度规范化：
    • angFix2PI(): 调整到[0, 2π)
    • angFixPI(): 调整到[-π, π]
    • angFixPI2(): 钳制到[-π/2, π/2]
    • 度数版本：angFix360(), angFix180(), angFix90()
  • 角度比较：
    • areAnglesEqual(): 考虑周期性的角度相等判断
    • angleDifference(): 计算两角度间最短差值
  • 角度计算：
    • isAngleBetween(): 判断角度是否在扇形范围内
    • rotateEulerAngle(): 欧拉角旋转
  • 特殊函数：
    • inverseCosine(), inverseSine(): 带误差容忍的反三角函数

Angle模块

函数输入输出说明
angFix2PI角度(弧度)[0, 2π)范围的角度角度规范化
angFixPI角度(弧度)[-π, π]范围的角度角度规范化
areAnglesEqual两个角度+容差bool考虑周期性的相等判断
angleDifferencefrom角度, to角度(-π, π]范围的差值最短路径角度差
isAngleBetween测试角, 起始角, 扫描角bool扇形范围判断

4. Math.h/cpp

功能：通用数学和矩阵运算

  • 基础数学函数：
    • sdkMin/Max(), clamp(), square(), sign()
    • areEqual(): 浮点数相等比较
    • toScientific(): 科学计数法转换
  • 向量操作：
    • v3Distance(), v3Unit(), v3Angle()
    • v3RotX/Y(): 绕坐标轴旋转
    • v3SphtoRec(): 球坐标到直角坐标转换
  • 矩阵运算：
    • d3MMmult(): 3×3矩阵乘法
    • d3Mv3Mult(): 矩阵向量乘法
    • d3MMTmult(): 矩阵与转置矩阵相乘
  • 坐标系转换：
    • d3DCMtoEuler(): 方向余弦矩阵转欧拉角
    • d3EulertoDCM(): 欧拉角转方向余弦矩阵
    • d3EulertoQ(): 欧拉角转四元数
    • d3QtoEuler(): 四元数转欧拉角
  • 四元数运算：
    • dQNorm(): 四元数归一化
    • dQMult(): 四元数乘法

5. CoordinateSystem.h/cpp

功能：定义坐标系统枚举和相关常量

  • 坐标系统枚举：
    • COORD_SYS_NED: 北东下坐标系
    • COORD_SYS_NWU: 北西上坐标系
    • COORD_SYS_ENU: 东北上坐标系
    • COORD_SYS_LLA: 经纬度高度坐标系
    • COORD_SYS_ECEF: 地心地固坐标系
    • COORD_SYS_ECI: 地心惯性坐标系
    • COORD_SYS_XEAST: X轴向东的切平面
    • COORD_SYS_GTP: 通用切平面
  • 地球模型：
    • WGS_84: WGS-84椭球模型
    • FLAT_EARTH: 平面地球模型
    • TANGENT_PLANE_WGS_84: WGS-84切平面
    • PERFECT_SPHERE: 完美球体模型
  • 常量定义：WGS-84参数、地球旋转速率等

6. Coordinate.h

功能：坐标数据容器类

  • 成员数据：
    • 位置(position): Vec3
    • 方向(orientation): Vec3
    • 速度(velocity): Vec3
    • 加速度(acceleration): Vec3
    • 坐标系类型
    • ECI时间
  • 主要接口：
    • 设置/获取各种状态量
    • 坐标系统管理
    • 数据有效性标志

7. CoordinateConverter.h/cpp

功能：坐标系转换核心类

  • 主要功能：

    • 各种坐标系之间的转换
    • 参考原点管理
    • 切平面偏移和旋转

  • 支持的转换：

    • LLA ↔ ECEF ↔ ECI
    • LLA ↔ NED/NWU/ENU
    • ECEF ↔ NED/NWU/ENU
    • XEAST ↔ 其他坐标系

  • 关键方法：

    convert(const Coordinate& in, Coordinate& out, CoordinateSystem sys)
setReferenceOrigin(lat, lon, alt)
convertGeodeticToEcef()
convertEcefToGeodetic()

CoordinateConverter模块

函数输入输出说明
convertCoordinate + 目标坐标系Coordinate通用坐标转换
setReferenceOrigin纬度、经度、高度无设置参考原点
convertGeodeticToEcefLLA坐标ECEF坐标大地坐标转地心地固
convertEcefToGeodeticECEF坐标LLA坐标地心地固转大地坐标

8. Calculations.h/cpp

功能：高级计算功能

  • 距离计算：
    • calculateSlant(): 斜距
    • calculateGroundDist(): 地面距离
    • calculateAltitude(): 高度差
  • 角度计算：
    • calculateRelAzEl(): 相对方位角/俯仰角
    • calculateAbsAzEl(): 绝对方位角/俯仰角
    • calculateAspectAngle(): 纵横角
  • 速度计算：
    • calculateClosingVelocity(): 接近速度
    • calculateVelocityDelta(): 速度差
    • calculateRangeRate(): 距离变化率
  • 特殊计算：
    • calculateGeodesicDRCR(): 测地线下行程/横程
    • calculateHorizonDist(): 地平线距离
    • sodanoDirect/Inverse(): Sodano算法
  • 实用功能：
    • positionInGate(): 判断位置是否在门内
    • laserInGate(): 判断激光是否在门内

Calculations模块

函数输入输出说明
calculateSlant两个LLA位置 + 地球模型距离(m)计算斜距
calculateRelAzElfrom/to位置 + 方向方位角、俯仰角相对角度
calculateGeodesicDRCRfrom位置 + 方向 + to位置下行程、横程测地线计算
sodanoInverse两个LLA位置距离 + 方位角反向Sodano算法
calculateHorizonDistLLA位置 + 地平线类型距离(m)地平线距离

9. Geometry.h/cpp

功能：几何计算和相交测试

  • 基本几何体：

    • Plane: 3D平面（ax + by + cz + d = 0）
    • Polytope: 凸多面体（多个平面的集合）
    • Triangle: 三角形
    • Ray: 射线（原点+方向）
    • Sphere: 球体
    • Ellipsoid: 椭球体
    • QuadricSurface: 二次曲面

  • 相交测试：

    • rayIntersectsTriangle(): 射线-三角形相交
    • rayIntersectsPlane(): 射线-平面相交
    • rayIntersectsSphere(): 射线-球体相交
    • rayIntersectsEllipsoid(): 射线-椭球体相交
    • rayIntersectsQuadricSurface(): 射线-二次曲面相交

  • 其他功能：

    • reflectVector(): 向量反射
    • reflectRay(): 射线反射
    • ellipsoidNormalAtIntersection(): 椭球体表面法线

Geometry模块

函数输入输出说明
rayIntersectsTriangleRay + TriangleIntersectResultsRT射线三角形相交测试
rayIntersectsPlaneRay + Planeoptional返回相交距离t
rayIntersectsSphereRay + Sphereoptional返回最近相交距离
reflectVector向量 + 法线Vec3反射向量

10. GeoFence.h/cpp

功能：地理围栏（地理区域边界）

  • 主要功能：

    • 支持任意多边形区域定义
    • 使用射线投射算法判断点是否在围栏内
    • 支持3D空间的围栏（考虑高度）

  • 实现原理：

    • 将地表多边形扩展为3D"咖啡滤纸"形状
    • 使用偶数/奇数规则进行内外判断
    • 支持ECEF和LLA坐标系输入

GeoFence模块

函数输入输出说明
set点集 + 坐标系无设置围栏边界
contains坐标/ECEF点bool判断点是否在围栏内
triangles无vector获取构成围栏的三角形

11. Gars.h/cpp

功能：全球区域参考系统（GARS）坐标转换

  • GARS坐标格式：

    • 5-7个字符：经度带(3位) + 纬度带(2字母) + 可选的15分钟象限 + 可选的5分钟键
    • 例如：“180AA”、“180AA1”、“180AA19”

  • 主要功能：

    • isValidGars(): 验证GARS坐标字符串
    • convertGarsToGeodetic(): GARS转经纬度
    • convertGeodeticToGars(): 经纬度转GARS

  • 精度级别：

    • GARS_30: 30分钟级别（5字符）
    • GARS_15: 15分钟级别（6字符）
    • GARS_5: 5分钟级别（7字符）

Gars模块

函数输入输出说明
isValidGarsGARS字符串bool + 分解值验证并解析GARS
convertGarsToGeodeticGARS字符串纬度/经度(弧度)GARS转经纬度
convertGeodeticToGars纬度/经度 + 精度GARS字符串经纬度转GARS

12. Dcm.h/cpp

功能：方向余弦矩阵（DCM）操作

  • 继承关系：继承自SquareMatrix（3×3方阵）

  • 主要功能：

    • determinant(): 计算行列式（应为1）
    • isValid(): 验证是否为有效旋转矩阵
    • toEuler(): DCM转欧拉角
    • fromEuler(): 欧拉角转DCM
    • toQ(): DCM转四元数
    • fromQ(): 四元数转DCM

Dcm模块

函数输入输出说明
fromEulerVec3欧拉角无(修改自身)欧拉角转DCM
toEuler无Vec3欧拉角DCM转欧拉角
fromQ四元数[4]int(错误码)四元数转DCM
toQ无array<double,4>DCM转四元数

13. DatumConvert.h/cpp

功能：基准面转换（磁偏角和垂直基准）

  • 磁偏角转换：

    • 支持TRUE（真北）、WMM（世界磁场模型）、USER（用户定义）之间转换
    • 使用WorldMagneticModel进行磁偏角计算

  • 垂直基准转换：

    • 支持WGS84和USER之间转换

  • 不支持MSL（平均海平面）转换

14. GogToGeoFence.h/cpp

功能：将GOG（Geo-Object Graphics）转换为地理围栏

  • 支持的GOG类型：

    • LINE（闭合线）
    • POLYGON（多边形）

  • 限制条件：

    • 只支持绝对坐标
    • LINE必须闭合（首尾点相同）
    • 不支持凹多边形

15. Interpolation.h/cpp

功能：提供多种插值算法，用于在标量、向量和角度数据间平滑过渡。该模块支持：

  • 最近邻插值：快速获取相邻数据点的值，适用于不需要平滑过渡的简单场景。
  • 线性插值：对标量和泛型类型实现一维和三点映射插值，可应用于数值分析与参数调节。
  • Map 容器插值：在键值映射中寻找上下界并进行插值，常用于时序数据或离散样本间的数据估算。
  • 三维向量插值：对 Vec3 对象的三个分量分别插值，适用于实体位置动画与轨迹平滑。
  • 角度插值：处理周期跳变（跨 0/2π）情形，并支持基于时间戳的动态插值，适用于航姿和方向数据平滑。
函数输入输出说明
getFactorlowVal, highVal, exactVal (double)factor (double)计算 exactVal 在 [lowVal, highVal] 范围内的比例因子 (0–1)
nearestNeighborInterpolatea, b (Type), factor (double)result (Type)最近邻插值，factor<0.5 返回 a，否则返回 b
linearInterpolate(a,b,xFactor)a, b (Type), xFactor (double)result (Type)两点线性插值
linearInterpolate(a,b,x1,xVal,x2)a, b (Type), x1, xVal, x2 (double)result (Type)三点映射插值
linearInterpolate(map, value, clamp)mp(std::map<T1,T2>&), value (T1), clamp (bool)result (T2)Map 容器插值，边界可钳制
linearInterpolate(prev,next,mixFactor)prev, next (Vec3), mixFactor (double)result (Vec3)三维向量各分量线性插值
linearInterpolateAngle(a,b,factor)a, b (double), factor (double)angle (double)角度插值，处理 0/2π 周期跳变
linearInterpolateAngle(a,b,ta,t,tb)a, b (double), ta, t, tb (double)angle (double)时间驱动的角度插值

16. MagneticVariance.h/cpp

功能：基于 NOAA 世界磁场模型（WMM）计算地磁偏角，并提供真航向与磁航向之间的双向转换接口。该模块特点包括：

  • 时序敏感：支持按日序和日期时间戳计算，满足不同时间粒度的导航需求。
  • 转换精度：结合高精度模型，确保航空与海洋导航中的航向转换误差最小。
  • 错误处理：通过返回码和日志通知机制反馈计算异常或输入错误。
函数输入输出说明
calculateMagneticVariance(lla, day, year)lla (Vec3), ordinalDay (int), year (int)varianceRad (double&)根据日序和年份计算磁偏角
calculateMagneticVariance(lla, ts)lla (Vec3), timeStamp (TimeStamp)varianceRad (double&)使用时间戳计算磁偏角
calculateMagneticBearing(lla, ts)lla (Vec3), timeStamp (TimeStamp)bearingRad (double&)真航向转换为磁航向
calculateTrueBearing(lla, ts)lla (Vec3), timeStamp (TimeStamp)bearingRad (double&)磁航向转换为真航向

17. Mgrs.h/cpp

功能：实现 MGRS（陆地网格参考系统）、UTM、UPS 与大地坐标之间的高效双向转换。模块特性：

  • 全流程覆盖：从字符串解析到投影转换，涵盖 MGRS→UTM/UPS→地理坐标及反向流程。
  • 特殊区处理：针对 Svalbard 和 Norway 区域的特殊规则，提供兼容性处理。
  • 输入校验：细化错误信息输出，帮助调用方定位格式或数值异常。
函数输入输出说明
convertMgrsToGeodeticmgrs (std::string)lat, lon (double&)解析 MGRS 字符串并输出纬度/经度（弧度）
breakMgrsStringmgrs (std::string)zone (int), gzdLetters (std::string), easting, northing (double)拆分 MGRS 为区域号、网格设计子与偏移量
convertMgrsToUtmzone, gzdLetters, easting, northingutmZone (int), easting, northing (double)MGRS 转 UTM，含 Svalbard/Norway 特例处理
convertUtmToGeodeticutmZone (int), easting, northing (double)lat, lon (double&)UTM 投影坐标转换为纬度/经度
convertMgrsToUpsmgrs (std::string)easting, northing (double), northPole (bool)MGRS 转极地 UPS 投影

18. MultiFrameCoordinate.h/cpp

功能：缓存并在多坐标系（LLA 与 ECEF）间转换坐标，支持懒更新与错误处理。模块特点：

  • 双向缓存：设置 LLA 或 ECEF 后，可按需转换并缓存结果，避免重复计算。
  • 系统兼容：支持 LLA、ECEF 及通过 CoordinateConverter 进行 ECI、局部机体系或其他系统转换。
  • 错误反馈：对无效系统或未初始化转换器输入提供返回码。
函数输入输出说明
setCoordinate(coord)coordinate (simCore::Coordinate)return code (int)设置 LLA 或 ECEF 坐标，其他系统返回错误
setCoordinate(coord,conv)coordinate (simCore::Coordinate), converter (simCore::CoordinateConverter)return code (int)使用转换器设置并转换到 LLA/ECEF
clear()——清除缓存坐标，置为无效
isValid()—bool返回当前是否有有效坐标
llaCoordinate()—coordinate (const simCore::Coordinate&)获取 LLA 坐标，必要时从 ECEF 懒转换
ecefCoordinate()—coordinate (const simCore::Coordinate&)获取 ECEF 坐标，必要时从 LLA 懒转换

19. NumericalAnalysis.h/cpp

功能：数值根查找与插值算法集合，提供二分法、割线法及 Newton 插值/反向插值，适用于求根与时间映射。模块特点：

  • 多方法支持：同时提供 Bisection 和 Secant 迭代算法。
  • 高阶插值：实现二阶 Newton 插值与反向线性插值。
  • 收敛控制：迭代次数与误差容限可配置，返回状态码指示结果。
函数输入输出说明
BisectionSearch::searchXx (double&), y (double), xlo (double&), xhi (double&), type (NumericalSearchType)state (NumericalSearchType)二分法迭代求根
BisectionSearch::count—count (int)获取二分法迭代次数
LinearSearch::searchXx (double&), y (double), xlo (double), xhi (double), fdx (double), type (NumericalSearchType)state (NumericalSearchType)割线法迭代求根
LinearSearch::count—count (int)获取割线法迭代次数
newtonInterpt0 (double), t[3] (const double[]), f[3] (const double[]), funcAtT0 (double&)return code (int)二阶 Newton 插值求值
invLinearInterpfuncAtT0 (double), t[3] (double[]), f[3] (double[]), tol (double), t0 (double&)return code (int)反向线性/高阶插值求时间

20. Random.h/cpp

功能：多种伪随机分布生成，包括均匀、正态、复正态、指数、Poisson、几何、二项和离散均匀，及全局种子初始化。模块特点：

  • 统一接口：所有分布通过 operator() 返回随机样本。
  • 算法多样：支持 Box-Muller、极坐标、插值法等多种基础生成方法。
  • 可复现性：可设置种子确保结果可重复。
函数输入输出说明
initializeRandomSeedWithTime——用系统时钟初始化全局随机种子
basicUniformVariableseed (double*)value (double)生成 [0,1] 区间均匀值
NormalVariable::operator()—sample (double)生成正态分布随机数
GaussianVariable::operator()—sample (Complex)生成复正态分布随机数
UniformVariable::operator()—sample (double)生成均匀分布随机数
ExponentialVariable::operator()—sample (double)生成指数分布随机数
PoissonVariable::operator()—sample (int)生成 Poisson 分布随机数
GeometricVariable::operator()—sample (int)生成几何分布随机数
BinomialVariable::operator()—sample (int)生成二项分布随机数
DiscreteUniformVariable::operator()—sample (int)生成离散均匀分布随机数

21. SquareMatrix.h/cpp

功能：提供方阵操作，包括构造、身份矩阵、置零、转置、缩放、加法和左右乘法，支持行列访问与比较。

函数输入输出说明
SquareMatrix(dimension)dimension(unsigned int)—构造指定维度的零矩阵
SquareMatrix()——构造 3×3 全零矩阵
SquareMatrix(rhs)rhs(const SquareMatrix&)—复制构造
makeIdentity()—return code (int)将矩阵置为单位矩阵
makeZero()—return code (int)将矩阵置零
transpose()—return code (int)矩阵转置
set(row,col,value)row, col(unsigned int), value(double)return code (int)设置指定元素
get(row,col)row, col(unsigned int)value (double)获取指定元素，越界返回 NaN
row(index)index(unsigned int)std::vector获取指定行
column(index)index(unsigned int)std::vector获取指定列
data()—const double*获取内部数据指针，维度<2 时返回 nullptr
scale(factor)factor(double)return code (int)矩阵数值缩放
add(m)m(const SquareMatrix&)return code (int)矩阵元素逐一相加
postMultiply(m)m(const SquareMatrix&)return code (int)this = this * m
preMultiply(m)m(const SquareMatrix&)return code (int)this = m * this
areEqual(m1,m2,t)m1,m2(const SquareMatrix&), t(double)bool矩阵按容差 t 比较是否相等

22. UnitContext.h/cpp

功能：维护并格式化各种单位与格式设置，包括时间、坐标、角度、距离、速度及地理/磁偏/垂直基准。

函数输入输出说明
timeFormat()—TimeFormat获取时间格式
setTimeFormat(unit)unit(TimeFormat)—设置时间格式
timePrecision()—unsigned int获取时间精度
setTimePrecision(prec)prec(unsigned int)—设置时间精度
geodeticFormat()—GeodeticFormat获取地理坐标格式
setGeodeticFormat(format)format(GeodeticFormat)—设置地理坐标格式
geodeticPrecision()—unsigned int获取地理坐标精度
setGeodeticPrecision(prec)prec(unsigned int)—设置地理坐标精度
distanceUnits()—const Units&获取距离单位
setDistanceUnits(unit)unit(const Units&)—设置距离单位
distancePrecision()—unsigned int获取距离精度
setDistancePrecision(prec)prec(unsigned int)—设置距离精度
altitudeUnits()—const Units&获取高度单位
setAltitudeUnits(unit)unit(const Units&)—设置高度单位
altitudePrecision()—unsigned int获取高度精度
setAltitudePrecision(prec)prec(unsigned int)—设置高度精度
angleUnits()—const Units&获取角度单位
setAngleUnits(unit)unit(const Units&)—设置角度单位
anglePrecision()—unsigned int获取角度精度
setAnglePrecision(prec)prec(unsigned int)—设置角度精度
speedUnits()—const Units&获取速度单位
setSpeedUnits(unit)unit(const Units&)—设置速度单位
speedPrecision()—unsigned int获取速度精度
setSpeedPrecision(prec)prec(unsigned int)—设置速度精度
genericPrecision()—unsigned int获取通用精度
setGenericPrecision(prec)prec(unsigned int)—设置通用精度
coordinateSystem()—CoordinateSystem获取坐标系类型
setCoordinateSystem(coordSys)coordSys(CoordinateSystem)—设置坐标系类型
magneticVariance()—MagneticVariance获取磁偏角模式
setMagneticVariance(mv)mv(MagneticVariance)—设置磁偏角模式
verticalDatum()—VerticalDatum获取垂直基准
setVerticalDatum(vd)vd(VerticalDatum)—设置垂直基准
referenceYear()—int获取参考年份
setReferenceYear(refYear)refYear(int)—设置参考年份
datumConvert()—DatumConvertPtr获取基准转换器
setDatumConvert(convert)convert(DatumConvertPtr)—设置基准转换器

23. Units.h/cpp

功能：定义并管理各类单位及其转换，包括时间、角度、长度、速度、加速度、温度、频率、体积、压力和电位等，同时提供注册与查询功能。

函数输入输出说明
Units()––构造无效单位
Units(name, abbrev, toBase, family)name: stringabbrev: stringtoBase: doublefamily: string–构造带偏移与转换因子的单位
offsetThenScaleUnit(…)name, abbrevoffset: doubletoBase: doublefamily: stringUnits构造偏移缩放单位
name()–string&获取单位名称
abbreviation()–string&获取单位缩写
family()–string&获取单位族
isValid()–bool判断单位是否有效
canConvert(toUnits)toUnits: Unitsbool判断是否可转换
convertTo(toUnits, value, output)toUnits: Unitsvalue: doubleoutput: double&int转换并输出结果，失败返回非0
convertTo(toUnits, value)toUnits: Unitsvalue: doubledouble转换并返回结果，错误返回原值
toBaseScalar()–double获取缩放因子
toBaseOffset()–double获取基准偏移
operator==(other)other: Unitsbool单位等价比较
operator!=(other)other: Unitsbool单位不等比较
UnitsRegistry::registerDefaultUnits()––注册所有内置单位
UnitsRegistry::registerUnits(units)units: Unitsint添加新单位
UnitsRegistry::units(family)family: stringUnitsVector&获取指定族单位列表
UnitsRegistry::families()–vector获取所有单位族名称
UnitsRegistry::unitsByName(name)name: stringUnits&按名称查询单位
UnitsRegistry::unitsByName(name, out)name: stringout: Units&int按名称查询并输出，失败返回0
UnitsRegistry::unitsByAbbreviation(abbrev)abbrev: stringUnits&按缩写查询单位
UnitsRegistry::unitsByAbbreviation(abbrev, out)abbrev: stringout: Units&int按缩写查询并输出，失败返回0

24. VerticalDatum.h

功能：定义垂直基准枚举，用于指定地理高度参考面。

枚举值说明
VERTDATUM_WGS84WGS-84 椭球体垂直基准
VERTDATUM_MSL基于 EGM-96 的平均海平面基准
VERTDATUM_USER用户自定义垂直基准偏移

三、模块依赖关系图

下图展示了该代码库之间的依赖关系：

graph TD
    MathConstants.h --> Vec3.h
    Vec3.h --> Geometry.h
    Vec3.h --> GeoFence.h
    Vec3.h --> Coordinate.h
    Vec3.h --> MagneticVariance.h
    
    CoordinateSystem.h --> Coordinate.h
    CoordinateSystem.h --> CoordinateConverter.h
    CoordinateSystem.h --> DatumConvert.h
    CoordinateSystem.h --> GeoFence.h
    CoordinateSystem.h --> Mgrs.h
    
    Coordinate.h --> CoordinateConverter.h
    CoordinateConverter.h --> Calculations.h
    
    Angle.h --> Gars.h
    Angle.h --> Dcm.h
    Angle.h --> Interpolation.h
    Angle.h --> MagneticVariance.h
    Angle.h --> Mgrs.h
    
    Math.h --> Dcm.h
    Math.h --> Geometry.h
    Math.h --> Interpolation.h
    Math.h --> Mgrs.h
    
    Geometry.h --> Geometry.cpp
    Geometry.h --> GeoFence.h
    
    GeoFence.h --> GeoFence.cpp
    GeoFence.h --> GogToGeoFence.h
    
    Gars.h --> Gars.cpp
    Dcm.h --> Dcm.cpp
    DatumConvert.h --> DatumConvert.cpp
    GogToGeoFence.h --> GogToGeoFence.cpp
    
    SquareMatrix.h --> Dcm.h
    MagneticVariance.h --> DatumConvert.h
    VerticalDatum.h --> DatumConvert.h
    WorldMagneticModel.h --> DatumConvert.h
    GOG/Parser.h --> GogToGeoFence.h
    
    %% 旧有模块依赖
    Interpolation.h --> Interpolation.cpp
    MagneticVariance.h --> MagneticVariance.cpp
    Mgrs.h --> Mgrs.cpp
    MultiFrameCoordinate.h --> MultiFrameCoordinate.cpp
    NumericalAnalysis.h --> NumericalAnalysis.cpp
    Random.h --> Random.cpp
    
    %% Interpolation依赖
    Common/Export.h --> Interpolation.h
    
    %% MagneticVariance依赖
    Time/TimeClass.h --> MagneticVariance.h
    simNotify/Notify.h --> MagneticVariance.h
    Common/Common.h --> MagneticVariance.h
    
    %% Mgrs依赖
    String/Tokenizer.h --> Mgrs.h
    String/Utils.h --> Mgrs.h
    String/ValidNumber.h --> Mgrs.h
    Common/Export.h --> Mgrs.h
    
    %% 新增模块依赖
    SquareMatrix.h --> SquareMatrix.cpp
    UnitContext.h --> UnitContext.cpp
    Units.h --> Units.cpp
    VerticalDatum.h
    
    %% SquareMatrix依赖
    simCore/Common/Common.h --> SquareMatrix.h
    simCore/Calc/Math.h --> SquareMatrix.h
    
    %% UnitContext依赖
    simCore/Common/Common.h --> UnitContext.h
    simCore/Calc/CoordinateSystem.h --> UnitContext.h
    simCore/Calc/DatumConvert.h --> UnitContext.h
    simCore/Calc/MagneticVariance.h --> UnitContext.h
    simCore/Calc/VerticalDatum.h --> UnitContext.h
    simCore/Calc/Units.h --> UnitContext.h
    simCore/String/Angle.h --> UnitContext.h
    simCore/Time/Constants.h --> UnitContext.h
    
    %% Units模块依赖
    simCore/Common/Common.h --> Units.h
    simCore/String/Format.h --> Units.h
    simCore/Calc/Angle.h --> Units.h
    simCore/Time/Constants.h --> Units.h

文本描述：

    MathConstants.h --> Vec3.h
    Vec3.h --> Geometry.h
    Vec3.h --> GeoFence.h
    Vec3.h --> Coordinate.h
    Vec3.h --> MagneticVariance.h
    
    CoordinateSystem.h --> Coordinate.h
    CoordinateSystem.h --> CoordinateConverter.h
    CoordinateSystem.h --> DatumConvert.h
    CoordinateSystem.h --> GeoFence.h
    CoordinateSystem.h --> Mgrs.h
    
    Coordinate.h --> CoordinateConverter.h
    CoordinateConverter.h --> Calculations.h
    
    Angle.h --> Gars.h
    Angle.h --> Dcm.h
    Angle.h --> Interpolation.h
    Angle.h --> MagneticVariance.h
    Angle.h --> Mgrs.h
    
    Math.h --> Dcm.h
    Math.h --> Geometry.h
    Math.h --> Interpolation.h
    Math.h --> Mgrs.h
    
    Geometry.h --> Geometry.cpp
    Geometry.h --> GeoFence.h
    
    GeoFence.h --> GeoFence.cpp
    GeoFence.h --> GogToGeoFence.h
    
    Gars.h --> Gars.cpp
    Dcm.h --> Dcm.cpp
    DatumConvert.h --> DatumConvert.cpp
    GogToGeoFence.h --> GogToGeoFence.cpp
    
    SquareMatrix.h --> Dcm.h
    MagneticVariance.h --> DatumConvert.h
    VerticalDatum.h --> DatumConvert.h
    WorldMagneticModel.h --> DatumConvert.h
    GOG/Parser.h --> GogToGeoFence.h
    
  
    Interpolation.h --> Interpolation.cpp
    MagneticVariance.h --> MagneticVariance.cpp
    Mgrs.h --> Mgrs.cpp
    MultiFrameCoordinate.h --> MultiFrameCoordinate.cpp
    NumericalAnalysis.h --> NumericalAnalysis.cpp
    Random.h --> Random.cpp
    
   
    Common/Export.h --> Interpolation.h
    
    %% MagneticVariance依赖
    Time/TimeClass.h --> MagneticVariance.h
    simNotify/Notify.h --> MagneticVariance.h
    Common/Common.h --> MagneticVariance.h
    
    %% Mgrs依赖
    String/Tokenizer.h --> Mgrs.h
    String/Utils.h --> Mgrs.h
    String/ValidNumber.h --> Mgrs.h
    Common/Export.h --> Mgrs.h
    

    SquareMatrix.h --> SquareMatrix.cpp
  
    Units.h --> Units.cpp
    VerticalDatum.h
    
    %% SquareMatrix依赖
    simCore/Common/Common.h --> SquareMatrix.h
    simCore/Calc/Math.h --> SquareMatrix.h
    
    %% UnitContext依赖
    simCore/Common/Common.h --> UnitContext.h
    simCore/Calc/CoordinateSystem.h --> UnitContext.h
    simCore/Calc/DatumConvert.h --> UnitContext.h
    simCore/Calc/MagneticVariance.h --> UnitContext.h
    simCore/Calc/VerticalDatum.h --> UnitContext.h
    simCore/Calc/Units.h --> UnitContext.h
    simCore/String/Angle.h --> UnitContext.h
    simCore/Time/Constants.h --> UnitContext.h
    
    UnitContext.h --> UnitContext.cpp
    
    %% Units模块依赖
    simCore/Common/Common.h --> Units.h
    simCore/String/Format.h --> Units.h
    simCore/Calc/Angle.h --> Units.h
    simCore/Time/Constants.h --> Units.h