propagator-hpop

name: propagator-hpop description: 通过 Astrox WebAPI 的 POST /Propagator/HPOP 计算高精度轨道递推(HPOP)轨迹,考虑多种摄动力,输出 CzmlPositionOut(CZML结构的位置序列)。当用户需要高精度轨道计算、考虑多种摄动因素、HPOP 时使用。

高精度轨道递推器技能 (HPOP Propagator)

核心指令 (Core Instructions)

1. 输入解析:识别用户提供的轨道历元、开始/结束时间以及轨道根数(经典根数或笛卡尔坐标)。
2. 坐标系匹配:默认使用 Inertial 系和 Earth 中心天体。
3. HpopPropagator 配置:识别并配置以下摄动模型:
   • 非球形引力位(GravityField)
   • 第三体引力(ThirdBodyForce)
   • 大气阻力(AtmosphericModel)
   • 太阳辐射压(SRPModel)
4. API 调用逻辑:向 {BASE_URL}/Propagator/HPOP 发送 POST,Content-Type: application/json。

API 规范 (Tool Definition)

接口地址

POST /Propagator/HPOP

输入参数结构 (JSON)

基础参数

HpopPropagator 配置对象

GravityModel(非球形引力位)

目前有两种

• GravityField

• TwoBody

ThirdBodyFunction(第三体引力)

AtmosphericModel(大气模型)

目前仅有 JacchiaRoberts 模型可用

• JacchiaRoberts

SRPModel(太阳辐射压模型)

目前仅有一种配置.

• SRPSpherical

响应数据结构(CzmlPositionOut)

详见 shared-docs/api-schemas/CzmlPositionOut.md

注意事项

• 单位检查:半长径必须是米(m),质量为千克,引力常数 m^3/s^2。
• 时间格式:首选为ISO8601 格式
• HPOP 是复杂的轨道传播器,建议使用预配置的 fixture 作为起点
• 不同中心天体有不同的默认引力场文件和参数

标准执行流程

1. 参数预检
   • 检查必填字段完整性
   • 检查 UTC 时间格式
   • 检查 Start < Stop
   • 检查 OrbitalElements 长度必须为 6
2. 模型判定
   • 未指定 CoordType 时默认 Classical
   • 验证 HpopPropagator 子配置的有效性
3. 请求构造
   • 按接口契约原样传参
   • 确保 $type 字段正确
4. 结果判定
   • 先判 HTTP 状态,再判 IsSuccess
   • IsSuccess = false 时优先返回 Message
5. 输出归一化
   • 给出关键输入摘要、执行状态、核心输出、限制说明

调用示例(最小可运行:地球默认 HPOP)

场景:使用 STK 默认 V10 配置的 Earth HPOP,传播 24 小时。

export BASE_URL=http://astrox.cn:8765
curl "${BASE_URL}/Propagator/HPOP" \
  --request POST \
  --header 'Content-Type: application/json' \
  --data-binary "@propagator-hpop/fixtures/hpop-earth-default-v10.json"

由于 HPOP 配置复杂,建议直接使用 fixture 文件。以下是 JSON 结构示例:

{
  "Description": "STK缺省的Propagator:Earth Default V10",
  "Start": "2018-12-01T00:00:00.000Z",
  "Stop": "2018-12-02T00:00:00.000Z",
  "OrbitEpoch": "2018-12-01T00:00:00.000Z",
  "CoordEpoch": "2000-01-01T11:58:55.81616Z",
  "CoordSystem": "Inertial",
  "CoordType": "Classical",
  "OrbitalElements": [6678137, 0, 28.5, 0, 0, 0],
  "GravitationalParameter": 3.986004415E14,
  "HpopPropagator": {
    "Name": "Earth_Hpop_default_v10",
    "CentralBodyName": "Earth",
    "GravityModel": {
      "$type": "GravityField",
      "GravityFileName": "EGM2008.grv",
      "Degree": 21,
      "Order": 21,
      "EOPfilePath": "EOP-v1.1.txt",
      "SolidTideType": "Permanent tide only"
    },
    "ThirdBodyForce": [
      { "ThirdBodyName": "Moon" },
      { "ThirdBodyName": "Sun" }
    ],
    "SRPModel": {
      "$type": "SRPSpherical",
      "ShadowModel": "DualCone",
      "SunPosition": "Apparent",
      "EclipsingBodies": ["Earth", "Moon"]
    }
  }
}

本地快速验证(可选)

export BASE_URL=http://astrox.cn:8765
curl "${BASE_URL}/Propagator/HPOP" \
  --request POST \
  --header 'Content-Type: application/json' \
  --data-binary "@propagator-hpop/fixtures/hpop-earth-default-v10.json"

更多示例与测试数据(fixtures)

说明:HPOP 配置较为复杂,推荐从 fixture 开始修改。

从响应中取末时刻位置速度:按 shared-docs/api-schemas/CzmlPositionOut.md 中 cartesianVelocity 平铺格式,取最后一组 [t, X, Y, Z, Vx, Vy, Vz]。