ootk 5.1.1 → 6.0.0-rc.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (543) hide show
  1. package/.claude/PROMPT.md +13 -0
  2. package/.claude/hooks/post-tool-use.ts +33 -0
  3. package/.claude/hooks/user-prompt-submit.ts +138 -0
  4. package/.claude/settings.local.json +13 -0
  5. package/.claude/skill-rules.json +11 -0
  6. package/.claude/skills/ootk-dev/SKILL.md +16 -0
  7. package/ADVANCED_FEATURES_GUIDE.md +1025 -0
  8. package/README.md +18 -0
  9. package/dist/body/Celestial.d.ts +1 -1
  10. package/dist/body/Celestial.js +1 -1
  11. package/dist/body/Celestial.js.map +1 -1
  12. package/dist/body/Earth.d.ts +3 -3
  13. package/dist/body/Earth.js +1 -1
  14. package/dist/body/Earth.js.map +1 -1
  15. package/dist/body/Moon.d.ts +3 -3
  16. package/dist/body/Moon.js +7 -7
  17. package/dist/body/Moon.js.map +1 -1
  18. package/dist/body/NutationAngles.d.ts +1 -1
  19. package/dist/body/PrecessionAngles.d.ts +1 -1
  20. package/dist/body/Sun.d.ts +1 -1
  21. package/dist/body/Sun.js +2 -2
  22. package/dist/body/Sun.js.map +1 -1
  23. package/dist/body/index.d.ts +4 -4
  24. package/dist/body/index.js +4 -4
  25. package/dist/body/index.js.map +1 -1
  26. package/dist/conjunction/ConjunctionAssessment.d.ts +156 -0
  27. package/dist/conjunction/ConjunctionAssessment.js +281 -0
  28. package/dist/conjunction/ConjunctionAssessment.js.map +1 -0
  29. package/dist/conjunction/ConjunctionEvent.d.ts +104 -0
  30. package/dist/conjunction/ConjunctionEvent.js +156 -0
  31. package/dist/conjunction/ConjunctionEvent.js.map +1 -0
  32. package/dist/conjunction/ProbabilityOfCollision.d.ts +102 -0
  33. package/dist/conjunction/ProbabilityOfCollision.js +240 -0
  34. package/dist/conjunction/ProbabilityOfCollision.js.map +1 -0
  35. package/dist/conjunction/index.d.ts +19 -0
  36. package/dist/conjunction/index.js +20 -0
  37. package/dist/conjunction/index.js.map +1 -0
  38. package/dist/coordinate/ClassicalElements.d.ts +6 -6
  39. package/dist/coordinate/ClassicalElements.js +6 -6
  40. package/dist/coordinate/ClassicalElements.js.map +1 -1
  41. package/dist/coordinate/EquinoctialElements.d.ts +4 -4
  42. package/dist/coordinate/EquinoctialElements.js +3 -3
  43. package/dist/coordinate/EquinoctialElements.js.map +1 -1
  44. package/dist/coordinate/FormatTle.d.ts +1 -1
  45. package/dist/coordinate/FormatTle.js +1 -1
  46. package/dist/coordinate/FormatTle.js.map +1 -1
  47. package/dist/coordinate/Geodetic.d.ts +3 -3
  48. package/dist/coordinate/Geodetic.js +6 -6
  49. package/dist/coordinate/Geodetic.js.map +1 -1
  50. package/dist/coordinate/Hill.d.ts +3 -3
  51. package/dist/coordinate/Hill.js +2 -2
  52. package/dist/coordinate/Hill.js.map +1 -1
  53. package/dist/coordinate/ITRF.d.ts +4 -4
  54. package/dist/coordinate/ITRF.js +4 -4
  55. package/dist/coordinate/ITRF.js.map +1 -1
  56. package/dist/coordinate/J2000.d.ts +4 -4
  57. package/dist/coordinate/J2000.js +4 -4
  58. package/dist/coordinate/J2000.js.map +1 -1
  59. package/dist/coordinate/RIC.d.ts +3 -3
  60. package/dist/coordinate/RIC.js +2 -2
  61. package/dist/coordinate/RIC.js.map +1 -1
  62. package/dist/coordinate/RelativeState.d.ts +4 -4
  63. package/dist/coordinate/RelativeState.js +1 -1
  64. package/dist/coordinate/RelativeState.js.map +1 -1
  65. package/dist/coordinate/StateVector.d.ts +1 -1
  66. package/dist/coordinate/StateVector.js +1 -1
  67. package/dist/coordinate/StateVector.js.map +1 -1
  68. package/dist/coordinate/TEME.d.ts +3 -3
  69. package/dist/coordinate/TEME.js +3 -3
  70. package/dist/coordinate/TEME.js.map +1 -1
  71. package/dist/coordinate/Tle.d.ts +4 -4
  72. package/dist/coordinate/Tle.js +8 -8
  73. package/dist/coordinate/Tle.js.map +1 -1
  74. package/dist/coordinate/index.d.ts +12 -12
  75. package/dist/coordinate/index.js +12 -12
  76. package/dist/coordinate/index.js.map +1 -1
  77. package/dist/covariance/CovarianceSample.d.ts +4 -4
  78. package/dist/covariance/CovarianceSample.js +4 -4
  79. package/dist/covariance/CovarianceSample.js.map +1 -1
  80. package/dist/covariance/StateCovariance.d.ts +1 -1
  81. package/dist/covariance/StateCovariance.js +1 -1
  82. package/dist/covariance/StateCovariance.js.map +1 -1
  83. package/dist/covariance/index.d.ts +2 -2
  84. package/dist/covariance/index.js +2 -2
  85. package/dist/covariance/index.js.map +1 -1
  86. package/dist/data/DataHandler.d.ts +3 -3
  87. package/dist/data/DataHandler.js +4 -4
  88. package/dist/data/DataHandler.js.map +1 -1
  89. package/dist/data/values/Egm96Data.js +2 -2
  90. package/dist/data/values/Egm96Data.js.map +1 -1
  91. package/dist/data/values/HpAtmosphereData.d.ts +1 -1
  92. package/dist/data/values/HpAtmosphereData.js +2 -2
  93. package/dist/data/values/HpAtmosphereData.js.map +1 -1
  94. package/dist/data/values/HpAtmosphereResult.d.ts +1 -1
  95. package/dist/data/values/Iau1980Data.js +1 -1
  96. package/dist/data/values/Iau1980Data.js.map +1 -1
  97. package/dist/data/values/LeapSecondData.d.ts +1 -1
  98. package/dist/data/values/LeapSecondData.js +1 -1
  99. package/dist/data/values/LeapSecondData.js.map +1 -1
  100. package/dist/data/values/egm96.d.ts +1 -1
  101. package/dist/data/values/hpAtmosphere.d.ts +1 -1
  102. package/dist/data/values/iau1980.d.ts +1 -1
  103. package/dist/enums/index.d.ts +7 -7
  104. package/dist/enums/index.js +7 -7
  105. package/dist/enums/index.js.map +1 -1
  106. package/dist/fetch/horizons-constants.d.ts +43 -0
  107. package/dist/fetch/horizons-constants.js +50 -0
  108. package/dist/fetch/horizons-constants.js.map +1 -0
  109. package/dist/fetch/horizons-interfaces.d.ts +37 -0
  110. package/dist/fetch/horizons-interfaces.js +2 -0
  111. package/dist/fetch/horizons-interfaces.js.map +1 -0
  112. package/dist/fetch/horizons.d.ts +86 -0
  113. package/dist/fetch/horizons.js +237 -0
  114. package/dist/fetch/horizons.js.map +1 -0
  115. package/dist/force/AtmosphericDrag.d.ts +2 -2
  116. package/dist/force/AtmosphericDrag.js +1 -1
  117. package/dist/force/AtmosphericDrag.js.map +1 -1
  118. package/dist/force/EarthGravity.d.ts +2 -2
  119. package/dist/force/EarthGravity.js +1 -1
  120. package/dist/force/EarthGravity.js.map +1 -1
  121. package/dist/force/Force.d.ts +2 -2
  122. package/dist/force/Force.js +0 -9
  123. package/dist/force/Force.js.map +1 -1
  124. package/dist/force/ForceModel.d.ts +2 -2
  125. package/dist/force/ForceModel.js +6 -6
  126. package/dist/force/ForceModel.js.map +1 -1
  127. package/dist/force/Gravity.d.ts +2 -2
  128. package/dist/force/Gravity.js +1 -1
  129. package/dist/force/Gravity.js.map +1 -1
  130. package/dist/force/SolarRadiationPressure.d.ts +2 -2
  131. package/dist/force/SolarRadiationPressure.js +3 -3
  132. package/dist/force/SolarRadiationPressure.js.map +1 -1
  133. package/dist/force/ThirdBodyGravity.d.ts +2 -2
  134. package/dist/force/ThirdBodyGravity.js +1 -1
  135. package/dist/force/ThirdBodyGravity.js.map +1 -1
  136. package/dist/force/Thrust.d.ts +2 -2
  137. package/dist/force/Thrust.js +1 -1
  138. package/dist/force/Thrust.js.map +1 -1
  139. package/dist/force/index.d.ts +1 -1
  140. package/dist/force/index.js +1 -1
  141. package/dist/force/index.js.map +1 -1
  142. package/dist/interfaces/BaseObjectParams.d.ts +1 -1
  143. package/dist/interfaces/ClassicalElementsParams.d.ts +1 -1
  144. package/dist/interfaces/EquinoctialElementsParams.d.ts +1 -1
  145. package/dist/interfaces/GroundPositionParams.d.ts +1 -1
  146. package/dist/interfaces/RfSensorParams.d.ts +2 -2
  147. package/dist/interfaces/SatelliteParams.d.ts +2 -2
  148. package/dist/interfaces/SensorParams.d.ts +2 -2
  149. package/dist/interfaces/StarObjectParams.d.ts +1 -1
  150. package/dist/interfaces/TimeVariables.d.ts +1 -1
  151. package/dist/interfaces/index.d.ts +9 -9
  152. package/dist/interpolator/ChebyshevCoefficients.d.ts +1 -1
  153. package/dist/interpolator/ChebyshevCoefficients.js +1 -1
  154. package/dist/interpolator/ChebyshevCoefficients.js.map +1 -1
  155. package/dist/interpolator/ChebyshevInterpolator.d.ts +3 -3
  156. package/dist/interpolator/ChebyshevInterpolator.js +2 -2
  157. package/dist/interpolator/ChebyshevInterpolator.js.map +1 -1
  158. package/dist/interpolator/CubicSpline.d.ts +1 -1
  159. package/dist/interpolator/CubicSplineInterpolator.d.ts +3 -3
  160. package/dist/interpolator/CubicSplineInterpolator.js +3 -3
  161. package/dist/interpolator/CubicSplineInterpolator.js.map +1 -1
  162. package/dist/interpolator/FieldInterpolator.d.ts +2 -2
  163. package/dist/interpolator/FieldInterpolator.js +1 -11
  164. package/dist/interpolator/FieldInterpolator.js.map +1 -1
  165. package/dist/interpolator/Interpolator.d.ts +1 -1
  166. package/dist/interpolator/Interpolator.js +1 -1
  167. package/dist/interpolator/Interpolator.js.map +1 -1
  168. package/dist/interpolator/LagrangeInterpolator.d.ts +2 -2
  169. package/dist/interpolator/LagrangeInterpolator.js +2 -2
  170. package/dist/interpolator/LagrangeInterpolator.js.map +1 -1
  171. package/dist/interpolator/StateInterpolator.d.ts +3 -3
  172. package/dist/interpolator/StateInterpolator.js +1 -9
  173. package/dist/interpolator/StateInterpolator.js.map +1 -1
  174. package/dist/interpolator/VerletBlendInterpolator.d.ts +4 -4
  175. package/dist/interpolator/VerletBlendInterpolator.js +4 -4
  176. package/dist/interpolator/VerletBlendInterpolator.js.map +1 -1
  177. package/dist/main.d.ts +19 -19
  178. package/dist/main.js +20 -19
  179. package/dist/main.js.map +1 -1
  180. package/dist/maneuver/TwoBurnOrbitTransfer.d.ts +2 -2
  181. package/dist/maneuver/TwoBurnOrbitTransfer.js +2 -2
  182. package/dist/maneuver/TwoBurnOrbitTransfer.js.map +1 -1
  183. package/dist/maneuver/Waypoint.d.ts +4 -4
  184. package/dist/maneuver/Waypoint.js +6 -6
  185. package/dist/maneuver/Waypoint.js.map +1 -1
  186. package/dist/objects/BaseObject.d.ts +2 -2
  187. package/dist/objects/BaseObject.js +1 -1
  188. package/dist/objects/BaseObject.js.map +1 -1
  189. package/dist/objects/DetailedSatellite.d.ts +3 -3
  190. package/dist/objects/DetailedSatellite.js +3 -3
  191. package/dist/objects/DetailedSatellite.js.map +1 -1
  192. package/dist/objects/DetailedSensor.d.ts +4 -4
  193. package/dist/objects/DetailedSensor.js +1 -1
  194. package/dist/objects/DetailedSensor.js.map +1 -1
  195. package/dist/objects/GroundObject.d.ts +3 -3
  196. package/dist/objects/GroundObject.js +2 -2
  197. package/dist/objects/GroundObject.js.map +1 -1
  198. package/dist/objects/LandObject.d.ts +2 -2
  199. package/dist/objects/LandObject.js +1 -1
  200. package/dist/objects/LandObject.js.map +1 -1
  201. package/dist/objects/Marker.d.ts +1 -1
  202. package/dist/objects/Marker.js +1 -1
  203. package/dist/objects/Marker.js.map +1 -1
  204. package/dist/objects/RfSensor.d.ts +2 -2
  205. package/dist/objects/RfSensor.js +2 -2
  206. package/dist/objects/RfSensor.js.map +1 -1
  207. package/dist/objects/Satellite.d.ts +11 -11
  208. package/dist/objects/Satellite.js +11 -11
  209. package/dist/objects/Satellite.js.map +1 -1
  210. package/dist/objects/Sensor.d.ts +5 -5
  211. package/dist/objects/Sensor.js +4 -4
  212. package/dist/objects/Sensor.js.map +1 -1
  213. package/dist/objects/Star.d.ts +2 -2
  214. package/dist/objects/Star.js +2 -2
  215. package/dist/objects/Star.js.map +1 -1
  216. package/dist/objects/index.d.ts +10 -10
  217. package/dist/objects/index.js +10 -10
  218. package/dist/objects/index.js.map +1 -1
  219. package/dist/observation/Observation.d.ts +10 -10
  220. package/dist/observation/Observation.js +0 -51
  221. package/dist/observation/Observation.js.map +1 -1
  222. package/dist/observation/ObservationOptical.d.ts +5 -5
  223. package/dist/observation/ObservationOptical.js +3 -3
  224. package/dist/observation/ObservationOptical.js.map +1 -1
  225. package/dist/observation/ObservationRadar.d.ts +5 -5
  226. package/dist/observation/ObservationRadar.js +3 -3
  227. package/dist/observation/ObservationRadar.js.map +1 -1
  228. package/dist/observation/ObservationUtils.d.ts +1 -1
  229. package/dist/observation/ObservationUtils.js +1 -1
  230. package/dist/observation/ObservationUtils.js.map +1 -1
  231. package/dist/observation/PropagatorPairs.d.ts +1 -1
  232. package/dist/observation/RAE.d.ts +5 -5
  233. package/dist/observation/RAE.js +5 -5
  234. package/dist/observation/RAE.js.map +1 -1
  235. package/dist/observation/RadecGeocentric.d.ts +5 -5
  236. package/dist/observation/RadecGeocentric.js +4 -4
  237. package/dist/observation/RadecGeocentric.js.map +1 -1
  238. package/dist/observation/RadecTopocentric.d.ts +5 -5
  239. package/dist/observation/RadecTopocentric.js +8 -6
  240. package/dist/observation/RadecTopocentric.js.map +1 -1
  241. package/dist/observation/index.d.ts +4 -4
  242. package/dist/observation/index.js +4 -4
  243. package/dist/observation/index.js.map +1 -1
  244. package/dist/operations/BoxMuller.d.ts +1 -1
  245. package/dist/operations/BoxMuller.js +1 -1
  246. package/dist/operations/BoxMuller.js.map +1 -1
  247. package/dist/operations/EulerAngles.d.ts +1 -1
  248. package/dist/operations/EulerAngles.js +1 -1
  249. package/dist/operations/EulerAngles.js.map +1 -1
  250. package/dist/operations/Matrix.d.ts +1 -1
  251. package/dist/operations/Matrix.js +1 -1
  252. package/dist/operations/Matrix.js.map +1 -1
  253. package/dist/operations/Quaternion.d.ts +1 -1
  254. package/dist/operations/Quaternion.js +1 -1
  255. package/dist/operations/Quaternion.js.map +1 -1
  256. package/dist/operations/RandomGaussianSource.d.ts +1 -1
  257. package/dist/operations/RandomGaussianSource.js +2 -2
  258. package/dist/operations/RandomGaussianSource.js.map +1 -1
  259. package/dist/operations/Vector.d.ts +1 -1
  260. package/dist/operations/Vector.js +1 -1
  261. package/dist/operations/Vector.js.map +1 -1
  262. package/dist/operations/Vector3D.d.ts +4 -3
  263. package/dist/operations/Vector3D.js +4 -3
  264. package/dist/operations/Vector3D.js.map +1 -1
  265. package/dist/operations/index.d.ts +4 -4
  266. package/dist/operations/index.js +4 -4
  267. package/dist/operations/index.js.map +1 -1
  268. package/dist/operations/operations.d.ts +4 -4
  269. package/dist/operations/operations.js +4 -4
  270. package/dist/operations/operations.js.map +1 -1
  271. package/dist/optimize/ChebyshevCompressor.d.ts +2 -2
  272. package/dist/optimize/ChebyshevCompressor.js +3 -3
  273. package/dist/optimize/ChebyshevCompressor.js.map +1 -1
  274. package/dist/optimize/DownhillSimplex.d.ts +1 -1
  275. package/dist/optimize/DownhillSimplex.js +1 -1
  276. package/dist/optimize/DownhillSimplex.js.map +1 -1
  277. package/dist/optimize/GoldenSection.d.ts +1 -1
  278. package/dist/optimize/PolynomialRegression.d.ts +1 -1
  279. package/dist/optimize/PolynomialRegression.js +3 -3
  280. package/dist/optimize/PolynomialRegression.js.map +1 -1
  281. package/dist/optimize/SimplexEntry.js +1 -1
  282. package/dist/optimize/SimplexEntry.js.map +1 -1
  283. package/dist/orbit_determination/BatchLeastSquaresOD.d.ts +4 -4
  284. package/dist/orbit_determination/BatchLeastSquaresOD.js +7 -7
  285. package/dist/orbit_determination/BatchLeastSquaresOD.js.map +1 -1
  286. package/dist/orbit_determination/BatchLeastSquaresResult.d.ts +2 -2
  287. package/dist/orbit_determination/GaussIOD.d.ts +98 -0
  288. package/dist/orbit_determination/GaussIOD.js +291 -0
  289. package/dist/orbit_determination/GaussIOD.js.map +1 -0
  290. package/dist/orbit_determination/GibbsIOD.d.ts +1 -1
  291. package/dist/orbit_determination/GibbsIOD.js +3 -3
  292. package/dist/orbit_determination/GibbsIOD.js.map +1 -1
  293. package/dist/orbit_determination/GoodingIOD.d.ts +57 -7
  294. package/dist/orbit_determination/GoodingIOD.js +224 -34
  295. package/dist/orbit_determination/GoodingIOD.js.map +1 -1
  296. package/dist/orbit_determination/HerrickGibbsIOD.d.ts +1 -1
  297. package/dist/orbit_determination/HerrickGibbsIOD.js +1 -1
  298. package/dist/orbit_determination/HerrickGibbsIOD.js.map +1 -1
  299. package/dist/orbit_determination/LambertIOD.d.ts +1 -1
  300. package/dist/orbit_determination/LambertIOD.js +1 -1
  301. package/dist/orbit_determination/LambertIOD.js.map +1 -1
  302. package/dist/orbit_determination/ModifiedGoodingIOD.d.ts +2 -2
  303. package/dist/orbit_determination/ModifiedGoodingIOD.js +7 -7
  304. package/dist/orbit_determination/ModifiedGoodingIOD.js.map +1 -1
  305. package/dist/orbit_determination/index.d.ts +7 -7
  306. package/dist/orbit_determination/index.js +7 -7
  307. package/dist/orbit_determination/index.js.map +1 -1
  308. package/dist/propagator/DormandPrince54Propagator.d.ts +1 -1
  309. package/dist/propagator/DormandPrince54Propagator.js +1 -1
  310. package/dist/propagator/DormandPrince54Propagator.js.map +1 -1
  311. package/dist/propagator/KeplerPropagator.d.ts +5 -5
  312. package/dist/propagator/KeplerPropagator.js +5 -6
  313. package/dist/propagator/KeplerPropagator.js.map +1 -1
  314. package/dist/propagator/Propagator.d.ts +4 -4
  315. package/dist/propagator/Propagator.js +4 -4
  316. package/dist/propagator/Propagator.js.map +1 -1
  317. package/dist/propagator/RkCheckpoint.d.ts +1 -1
  318. package/dist/propagator/RkResult.d.ts +1 -1
  319. package/dist/propagator/RungeKutta4Propagator.d.ts +5 -5
  320. package/dist/propagator/RungeKutta4Propagator.js +4 -4
  321. package/dist/propagator/RungeKutta4Propagator.js.map +1 -1
  322. package/dist/propagator/RungeKutta89Propagator.d.ts +1 -1
  323. package/dist/propagator/RungeKutta89Propagator.js +1 -1
  324. package/dist/propagator/RungeKutta89Propagator.js.map +1 -1
  325. package/dist/propagator/RungeKuttaAdaptive.d.ts +5 -5
  326. package/dist/propagator/RungeKuttaAdaptive.js +51 -8
  327. package/dist/propagator/RungeKuttaAdaptive.js.map +1 -1
  328. package/dist/propagator/Sgp4Propagator.d.ts +6 -6
  329. package/dist/propagator/Sgp4Propagator.js +3 -3
  330. package/dist/propagator/Sgp4Propagator.js.map +1 -1
  331. package/dist/propagator/index.d.ts +3 -3
  332. package/dist/propagator/index.js +3 -3
  333. package/dist/propagator/index.js.map +1 -1
  334. package/dist/sgp4/index.d.ts +1 -1
  335. package/dist/sgp4/index.js +1 -1
  336. package/dist/sgp4/index.js.map +1 -1
  337. package/dist/sgp4/sgp4.d.ts +2 -2
  338. package/dist/sgp4/sgp4.js +4 -4
  339. package/dist/sgp4/sgp4.js.map +1 -1
  340. package/dist/smoothing/ExponentialSmoothing.d.ts +1 -1
  341. package/dist/time/Epoch.d.ts +1 -1
  342. package/dist/time/Epoch.js +1 -1
  343. package/dist/time/Epoch.js.map +1 -1
  344. package/dist/time/EpochGPS.d.ts +2 -2
  345. package/dist/time/EpochGPS.js +2 -2
  346. package/dist/time/EpochGPS.js.map +1 -1
  347. package/dist/time/EpochTAI.d.ts +1 -1
  348. package/dist/time/EpochTAI.js +1 -1
  349. package/dist/time/EpochTAI.js.map +1 -1
  350. package/dist/time/EpochTDB.d.ts +1 -1
  351. package/dist/time/EpochTDB.js +1 -1
  352. package/dist/time/EpochTDB.js.map +1 -1
  353. package/dist/time/EpochTT.d.ts +1 -1
  354. package/dist/time/EpochTT.js +1 -1
  355. package/dist/time/EpochTT.js.map +1 -1
  356. package/dist/time/EpochUTC.d.ts +6 -6
  357. package/dist/time/EpochUTC.js +8 -8
  358. package/dist/time/EpochUTC.js.map +1 -1
  359. package/dist/time/EpochWindow.d.ts +1 -1
  360. package/dist/time/TimeStamped.d.ts +1 -1
  361. package/dist/time/index.d.ts +8 -8
  362. package/dist/time/index.js +8 -8
  363. package/dist/time/index.js.map +1 -1
  364. package/dist/transforms/conversions.d.ts +1 -1
  365. package/dist/transforms/conversions.js +1 -1
  366. package/dist/transforms/conversions.js.map +1 -1
  367. package/dist/transforms/index.d.ts +2 -2
  368. package/dist/transforms/index.js +2 -2
  369. package/dist/transforms/index.js.map +1 -1
  370. package/dist/transforms/transforms.d.ts +1 -1
  371. package/dist/transforms/transforms.js +1 -1
  372. package/dist/transforms/transforms.js.map +1 -1
  373. package/dist/types/types.d.ts +8 -3
  374. package/dist/types/types.js +6 -1
  375. package/dist/types/types.js.map +1 -1
  376. package/dist/utils/constants.d.ts +2 -2
  377. package/dist/utils/constants.js +1 -1
  378. package/dist/utils/constants.js.map +1 -1
  379. package/dist/utils/create-covariance-from-tle.d.ts +1 -1
  380. package/dist/utils/create-covariance-from-tle.js +1 -1
  381. package/dist/utils/create-covariance-from-tle.js.map +1 -1
  382. package/dist/utils/functions.d.ts +4 -4
  383. package/dist/utils/functions.js +9 -4
  384. package/dist/utils/functions.js.map +1 -1
  385. package/dist/utils/index.d.ts +5 -5
  386. package/dist/utils/index.js +5 -5
  387. package/dist/utils/index.js.map +1 -1
  388. package/dist/utils/jacobian.d.ts +2 -2
  389. package/dist/utils/jacobian.js +1 -1
  390. package/dist/utils/jacobian.js.map +1 -1
  391. package/dist/utils/linearDistance.d.ts +1 -1
  392. package/docs/README.md +132 -0
  393. package/docs/getting-started.md +792 -0
  394. package/docs/lambert-satellite-integration-guide.md +766 -0
  395. package/docs/user-guide.md +1935 -0
  396. package/jest.config.mjs +28 -0
  397. package/package.json +4 -4
  398. package/src/body/Celestial.ts +1 -1
  399. package/src/body/Earth.ts +3 -3
  400. package/src/body/Moon.ts +7 -7
  401. package/src/body/NutationAngles.ts +1 -1
  402. package/src/body/PrecessionAngles.ts +1 -1
  403. package/src/body/Sun.ts +3 -3
  404. package/src/body/index.ts +4 -4
  405. package/src/conjunction/ConjunctionAssessment.ts +417 -0
  406. package/src/conjunction/ConjunctionEvent.ts +149 -0
  407. package/src/conjunction/ProbabilityOfCollision.ts +300 -0
  408. package/src/conjunction/index.ts +24 -0
  409. package/src/coordinate/ClassicalElements.ts +9 -9
  410. package/src/coordinate/EquinoctialElements.ts +6 -6
  411. package/src/coordinate/FormatTle.ts +1 -1
  412. package/src/coordinate/Geodetic.ts +7 -7
  413. package/src/coordinate/Hill.ts +3 -3
  414. package/src/coordinate/ITRF.ts +5 -5
  415. package/src/coordinate/J2000.ts +6 -6
  416. package/src/coordinate/RIC.ts +3 -3
  417. package/src/coordinate/RelativeState.ts +4 -4
  418. package/src/coordinate/StateVector.ts +1 -1
  419. package/src/coordinate/TEME.ts +5 -5
  420. package/src/coordinate/Tle.ts +8 -8
  421. package/src/coordinate/index.ts +13 -12
  422. package/src/covariance/CovarianceSample.ts +5 -5
  423. package/src/covariance/StateCovariance.ts +1 -1
  424. package/src/covariance/index.ts +3 -2
  425. package/src/data/DataHandler.ts +5 -5
  426. package/src/data/values/Egm96Data.ts +2 -2
  427. package/src/data/values/HpAtmosphereData.ts +2 -2
  428. package/src/data/values/HpAtmosphereResult.ts +1 -1
  429. package/src/data/values/Iau1980Data.ts +1 -1
  430. package/src/data/values/LeapSecondData.ts +1 -1
  431. package/src/data/values/egm96.ts +1 -1
  432. package/src/data/values/hpAtmosphere.ts +1 -1
  433. package/src/data/values/iau1980.ts +1 -1
  434. package/src/enums/index.ts +8 -7
  435. package/src/fetch/horizons-constants.ts +53 -0
  436. package/src/fetch/horizons-interfaces.ts +38 -0
  437. package/src/fetch/horizons.ts +300 -0
  438. package/src/force/AtmosphericDrag.ts +2 -2
  439. package/src/force/EarthGravity.ts +2 -2
  440. package/src/force/Force.ts +2 -4
  441. package/src/force/ForceModel.ts +8 -8
  442. package/src/force/Gravity.ts +2 -2
  443. package/src/force/SolarRadiationPressure.ts +3 -3
  444. package/src/force/ThirdBodyGravity.ts +2 -2
  445. package/src/force/Thrust.ts +2 -2
  446. package/src/force/index.ts +2 -1
  447. package/src/interfaces/BaseObjectParams.ts +1 -1
  448. package/src/interfaces/ClassicalElementsParams.ts +1 -1
  449. package/src/interfaces/EquinoctialElementsParams.ts +1 -1
  450. package/src/interfaces/GroundPositionParams.ts +1 -1
  451. package/src/interfaces/RfSensorParams.ts +2 -2
  452. package/src/interfaces/SatelliteParams.ts +2 -2
  453. package/src/interfaces/SensorParams.ts +3 -3
  454. package/src/interfaces/StarObjectParams.ts +1 -1
  455. package/src/interfaces/TimeVariables.ts +1 -1
  456. package/src/interfaces/index.ts +10 -9
  457. package/src/interpolator/ChebyshevCoefficients.ts +1 -1
  458. package/src/interpolator/ChebyshevInterpolator.ts +3 -3
  459. package/src/interpolator/CubicSpline.ts +1 -1
  460. package/src/interpolator/CubicSplineInterpolator.ts +3 -3
  461. package/src/interpolator/FieldInterpolator.ts +2 -4
  462. package/src/interpolator/Interpolator.ts +1 -1
  463. package/src/interpolator/LagrangeInterpolator.ts +2 -2
  464. package/src/interpolator/StateInterpolator.ts +3 -5
  465. package/src/interpolator/VerletBlendInterpolator.ts +4 -4
  466. package/src/main.ts +21 -19
  467. package/src/maneuver/TwoBurnOrbitTransfer.ts +2 -2
  468. package/src/maneuver/Waypoint.ts +7 -7
  469. package/src/objects/BaseObject.ts +2 -2
  470. package/src/objects/DetailedSatellite.ts +3 -3
  471. package/src/objects/DetailedSensor.ts +4 -4
  472. package/src/objects/GroundObject.ts +3 -3
  473. package/src/objects/LandObject.ts +2 -2
  474. package/src/objects/Marker.ts +1 -1
  475. package/src/objects/RfSensor.ts +2 -2
  476. package/src/objects/Satellite.ts +18 -18
  477. package/src/objects/Sensor.ts +6 -6
  478. package/src/objects/Star.ts +2 -2
  479. package/src/objects/index.ts +11 -10
  480. package/src/observation/Observation.ts +10 -22
  481. package/src/observation/ObservationOptical.ts +6 -6
  482. package/src/observation/ObservationRadar.ts +6 -6
  483. package/src/observation/ObservationUtils.ts +1 -1
  484. package/src/observation/PropagatorPairs.ts +1 -1
  485. package/src/observation/RAE.ts +8 -8
  486. package/src/observation/RadecGeocentric.ts +8 -8
  487. package/src/observation/RadecTopocentric.ts +12 -9
  488. package/src/observation/index.ts +4 -4
  489. package/src/operations/BoxMuller.ts +1 -1
  490. package/src/operations/EulerAngles.ts +1 -1
  491. package/src/operations/Matrix.ts +1 -1
  492. package/src/operations/Quaternion.ts +1 -1
  493. package/src/operations/RandomGaussianSource.ts +2 -2
  494. package/src/operations/Vector.ts +1 -1
  495. package/src/operations/Vector3D.ts +5 -3
  496. package/src/operations/index.ts +5 -4
  497. package/src/operations/operations.ts +4 -4
  498. package/src/optimize/ChebyshevCompressor.ts +4 -4
  499. package/src/optimize/DownhillSimplex.ts +1 -1
  500. package/src/optimize/GoldenSection.ts +1 -1
  501. package/src/optimize/PolynomialRegression.ts +3 -3
  502. package/src/optimize/SimplexEntry.ts +1 -1
  503. package/src/orbit_determination/BatchLeastSquaresOD.ts +9 -9
  504. package/src/orbit_determination/BatchLeastSquaresResult.ts +2 -2
  505. package/src/orbit_determination/GaussIOD.ts +393 -0
  506. package/src/orbit_determination/GibbsIOD.ts +3 -3
  507. package/src/orbit_determination/GoodingIOD.ts +457 -159
  508. package/src/orbit_determination/HerrickGibbsIOD.ts +1 -1
  509. package/src/orbit_determination/LambertIOD.ts +1 -1
  510. package/src/orbit_determination/ModifiedGoodingIOD.ts +32 -21
  511. package/src/orbit_determination/index.ts +8 -7
  512. package/src/propagator/DormandPrince54Propagator.ts +1 -1
  513. package/src/propagator/KeplerPropagator.ts +6 -7
  514. package/src/propagator/Propagator.ts +5 -5
  515. package/src/propagator/RkCheckpoint.ts +1 -1
  516. package/src/propagator/RkResult.ts +1 -1
  517. package/src/propagator/RungeKutta4Propagator.ts +5 -5
  518. package/src/propagator/RungeKutta89Propagator.ts +1 -1
  519. package/src/propagator/RungeKuttaAdaptive.ts +60 -10
  520. package/src/propagator/Sgp4Propagator.ts +6 -6
  521. package/src/propagator/index.ts +4 -3
  522. package/src/sgp4/index.ts +1 -1
  523. package/src/sgp4/sgp4.ts +5 -5
  524. package/src/smoothing/ExponentialSmoothing.ts +1 -1
  525. package/src/time/Epoch.ts +2 -2
  526. package/src/time/EpochGPS.ts +4 -4
  527. package/src/time/EpochTAI.ts +1 -1
  528. package/src/time/EpochTDB.ts +1 -1
  529. package/src/time/EpochTT.ts +1 -1
  530. package/src/time/EpochUTC.ts +9 -9
  531. package/src/time/EpochWindow.ts +1 -1
  532. package/src/time/TimeStamped.ts +1 -1
  533. package/src/time/index.ts +9 -8
  534. package/src/transforms/conversions.ts +1 -1
  535. package/src/transforms/index.ts +3 -2
  536. package/src/transforms/transforms.ts +4 -4
  537. package/src/types/types.ts +8 -3
  538. package/src/utils/constants.ts +2 -2
  539. package/src/utils/create-covariance-from-tle.ts +1 -1
  540. package/src/utils/functions.ts +10 -5
  541. package/src/utils/index.ts +6 -5
  542. package/src/utils/jacobian.ts +2 -2
  543. package/src/utils/linearDistance.ts +1 -1
@@ -0,0 +1,28 @@
1
+ const jestConfig = {
2
+ testEnvironment: 'node',
3
+ extensionsToTreatAsEsm: ['.ts'],
4
+ moduleNameMapper: {
5
+ '^(\\.{1,2}/.*)\\.js$': '$1',
6
+ '^@src/(.*)$': '<rootDir>/src/$1',
7
+ '^@src$': '<rootDir>/src',
8
+ },
9
+ transform: {
10
+ '^.+\\.jsx?$': 'babel-jest',
11
+ '^.+\\.tsx?$': [
12
+ 'ts-jest',
13
+ {
14
+ useESM: true,
15
+ },
16
+ ],
17
+ },
18
+ testMatch: ['**/test/**/?(*.)+(spec|test).?(m)[jt]s?(x)'],
19
+ moduleFileExtensions: ['js', 'mjs', 'ts'],
20
+ coverageDirectory: '<rootDir>/coverage',
21
+ moduleDirectories: ['node_modules'],
22
+ modulePathIgnorePatterns: ['<rootDir>/node_modules/', '<rootDir>/test/sgp4/sgp4prop'],
23
+ coverageReporters: ['lcov', 'html', 'text'],
24
+ coveragePathIgnorePatterns: ['/node_modules/', '/dist/', '/lib/', '/commonjs/', '/test/', '/scripts/', '/coverage/'],
25
+ globalSetup: '<rootDir>/test/lib/globalSetup.js',
26
+ };
27
+
28
+ export default jestConfig;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "ootk",
3
- "version": "5.1.1",
3
+ "version": "6.0.0-rc.2",
4
4
  "type": "module",
5
5
  "module": "dist/main.js",
6
6
  "description": "Orbital Object Toolkit including Multiple Propagators, Initial Orbit Determination, and Maneuver Calculations.",
@@ -39,8 +39,8 @@
39
39
  "@babel/preset-env": "^7.26.9",
40
40
  "@babel/preset-typescript": "^7.26.0",
41
41
  "@types/jest": "^29.5.14",
42
- "@typescript-eslint/eslint-plugin": "^7.18.0",
43
- "@typescript-eslint/parser": "^7.18.0",
42
+ "@typescript-eslint/eslint-plugin": "^8.46.2",
43
+ "@typescript-eslint/parser": "^8.46.2",
44
44
  "auto-changelog": "^2.5.0",
45
45
  "babel-eslint": "^10.1.0",
46
46
  "babel-jest": "^28.1.3",
@@ -54,4 +54,4 @@
54
54
  "typescript": "^5.8.2"
55
55
  },
56
56
  "homepage": "https://github.com/thkruz/ootk"
57
- }
57
+ }
@@ -21,7 +21,7 @@
21
21
  * Orbital Object ToolKit. If not, see <http://www.gnu.org/licenses/>.
22
22
  */
23
23
 
24
- import { AzEl, Degrees, Kilometers, RAD2DEG, RaDec, Radians, Sun } from '../main.js';
24
+ import { AzEl, Degrees, Kilometers, RAD2DEG, RaDec, Radians, Sun } from '../main';
25
25
 
26
26
  /**
27
27
  * Celestial is a static class that provides methods for calculating the position of celestial objects such as the Sun,
package/src/body/Earth.ts CHANGED
@@ -39,9 +39,9 @@ import {
39
39
  TAU,
40
40
  ttasec2rad,
41
41
  Vector3D,
42
- } from '../main.js';
43
- import { NutationAngles } from './NutationAngles.js';
44
- import { PrecessionAngles } from './PrecessionAngles.js';
42
+ } from '../main';
43
+ import { NutationAngles } from './NutationAngles';
44
+ import { PrecessionAngles } from './PrecessionAngles';
45
45
 
46
46
  // / Earth metrics and operations.
47
47
  export class Earth {
package/src/body/Moon.ts CHANGED
@@ -36,13 +36,13 @@
36
36
  * moon calculations are based on formulas from this website
37
37
  */
38
38
 
39
- import { AngularDiameterMethod, Celestial, Degrees, Kilometers, RaDec, Radians } from '../main.js';
40
- import { Vector3D } from '../operations/Vector3D.js';
41
- import { EpochUTC } from '../time/EpochUTC.js';
42
- import { DEG2RAD, MS_PER_DAY } from '../utils/constants.js';
43
- import { angularDiameter } from '../utils/functions.js';
44
- import { Earth } from './Earth.js';
45
- import { Sun } from './Sun.js';
39
+ import { AngularDiameterMethod, Celestial, Degrees, Kilometers, RaDec, Radians } from '../main';
40
+ import { Vector3D } from '../operations/Vector3D';
41
+ import { EpochUTC } from '../time/EpochUTC';
42
+ import { DEG2RAD, MS_PER_DAY } from '../utils/constants';
43
+ import { angularDiameter } from '../utils/functions';
44
+ import { Earth } from './Earth';
45
+ import { Sun } from './Sun';
46
46
 
47
47
  type MoonIlluminationData = {
48
48
  fraction: number;
@@ -21,7 +21,7 @@
21
21
  * Orbital Object ToolKit. If not, see <http://www.gnu.org/licenses/>.
22
22
  */
23
23
 
24
- import { Radians } from '../main.js';
24
+ import { Radians } from '../main';
25
25
 
26
26
  /** Represents the nutation angles. */
27
27
  export type NutationAngles = {
@@ -21,7 +21,7 @@
21
21
  * Orbital Object ToolKit. If not, see <http://www.gnu.org/licenses/>.
22
22
  */
23
23
 
24
- import { Radians } from '../main.js';
24
+ import { Radians } from '../main';
25
25
 
26
26
  /** Represents the precession angles in radians. */
27
27
  export type PrecessionAngles = {
package/src/body/Sun.ts CHANGED
@@ -33,7 +33,6 @@
33
33
  import {
34
34
  angularDiameter,
35
35
  AngularDiameterMethod,
36
- astronomicalUnit,
37
36
  AzEl,
38
37
  Celestial,
39
38
  cKmPerSec,
@@ -42,6 +41,7 @@ import {
42
41
  Earth,
43
42
  EpochUTC,
44
43
  Kilometers,
44
+ KM_PER_AU,
45
45
  Meters,
46
46
  MS_PER_DAY,
47
47
  RAD2DEG,
@@ -51,7 +51,7 @@ import {
51
51
  SunTime,
52
52
  TAU,
53
53
  Vector3D,
54
- } from '../main.js';
54
+ } from '../main';
55
55
 
56
56
  /**
57
57
  * Sun metrics and operations.
@@ -500,7 +500,7 @@ export class Sun {
500
500
  rMag * Math.cos(obliq * dtr) * Math.sin(lamEc * dtr),
501
501
  rMag * Math.sin(obliq * dtr) * Math.sin(lamEc * dtr),
502
502
  );
503
- const rMOD = r.scale(astronomicalUnit);
503
+ const rMOD = r.scale(KM_PER_AU);
504
504
  const p = Earth.precession(epoch);
505
505
 
506
506
  return rMOD
package/src/body/index.ts CHANGED
@@ -21,8 +21,8 @@
21
21
  * Orbital Object ToolKit. If not, see <http://www.gnu.org/licenses/>.
22
22
  */
23
23
 
24
- export { Celestial } from './Celestial.js';
25
- export { Earth } from './Earth.js';
26
- export { Moon } from './Moon.js';
27
- export { Sun } from './Sun.js';
24
+ export { Celestial } from './Celestial';
25
+ export { Earth } from './Earth';
26
+ export { Moon } from './Moon';
27
+ export { Sun } from './Sun';
28
28
 
@@ -0,0 +1,417 @@
1
+ /**
2
+ * @author Theodore Kruczek
3
+ * @license AGPL-3.0-or-later
4
+ * @copyright (c) 2025 Kruczek Labs LLC
5
+ *
6
+ * Orbital Object ToolKit is free software: you can redistribute it and/or modify it under the
7
+ * terms of the GNU Affero General Public License as published by the Free Software
8
+ * Foundation, either version 3 of the License, or (at your option) any later version.
9
+ *
10
+ * Orbital Object ToolKit is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;
11
+ * without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
12
+ * See the GNU Affero General Public License for more details.
13
+ *
14
+ * You should have received a copy of the GNU Affero General Public License along with
15
+ * Orbital Object ToolKit. If not, see <http://www.gnu.org/licenses/>.
16
+ */
17
+
18
+ import { EpochUTC } from '../time/EpochUTC.js';
19
+ import { J2000 } from '../coordinate/J2000.js';
20
+ import { RIC } from '../coordinate/RIC.js';
21
+ import { Tle } from '../coordinate/Tle.js';
22
+ import { StateCovariance, CovarianceFrame } from '../covariance/StateCovariance.js';
23
+ import { CovarianceSample } from '../covariance/CovarianceSample.js';
24
+ import { Propagator } from '../propagator/Propagator.js';
25
+ import { Sgp4Propagator } from '../propagator/Sgp4Propagator.js';
26
+ import { RungeKutta89Propagator } from '../propagator/RungeKutta89Propagator.js';
27
+ import { ForceModel } from '../force/ForceModel.js';
28
+ import { GoldenSection } from '../optimize/GoldenSection.js';
29
+ import { Matrix } from '../operations/Matrix.js';
30
+ import type { Kilometers, Seconds } from '../main.js';
31
+ import { ConjunctionEvent } from './ConjunctionEvent.js';
32
+ import { ProbabilityOfCollision } from './ProbabilityOfCollision.js';
33
+
34
+ /**
35
+ * Input for a space object in conjunction assessment.
36
+ * Can be specified as either a TLE or a state vector with optional covariance.
37
+ */
38
+ export interface SpaceObject {
39
+ /** Object identifier/name */
40
+ name?: string;
41
+
42
+ /** TLE for the object (alternative to state) */
43
+ tle?: Tle;
44
+
45
+ /** State vector in J2000 frame (alternative to TLE) */
46
+ state?: J2000;
47
+
48
+ /** Covariance matrix (optional, for probability calculation) */
49
+ covariance?: StateCovariance;
50
+
51
+ /** Hard body radius in km (optional, for probability calculation) */
52
+ radius?: Kilometers;
53
+
54
+ /** Custom propagator (optional, overrides default) */
55
+ propagator?: Propagator;
56
+ }
57
+
58
+ /**
59
+ * Configuration options for conjunction assessment.
60
+ */
61
+ export interface ConjunctionAssessmentOptions {
62
+ /** Search window start time */
63
+ startTime: EpochUTC;
64
+
65
+ /** Search window end time */
66
+ endTime: EpochUTC;
67
+
68
+ /** Use high-fidelity propagation (RungeKutta89 instead of SGP4) */
69
+ useHighFidelity?: boolean;
70
+
71
+ /** Force model for high-fidelity propagation (optional) */
72
+ forceModel?: ForceModel;
73
+
74
+ /** Propagate covariances using sigma-point method */
75
+ propagateCovariance?: boolean;
76
+
77
+ /** TCA search tolerance in seconds */
78
+ tcaTolerance?: Seconds;
79
+
80
+ /** Step size for initial TCA search in seconds */
81
+ searchStepSize?: Seconds;
82
+ }
83
+
84
+ /**
85
+ * High accuracy conjunction assessment workflow.
86
+ *
87
+ * This class provides a comprehensive workflow for assessing conjunctions between
88
+ * space objects using:
89
+ * - High accuracy propagators (SGP4 or numerical integrators)
90
+ * - Covariance matrices based on historical TLE accuracy
91
+ * - Time of Closest Approach (TCA) finding using optimization
92
+ * - Probability of collision calculation using Chan's 2D method
93
+ *
94
+ * @example
95
+ * ```typescript
96
+ * const primaryTle = new Tle(line1, line2);
97
+ * const secondaryTle = new Tle(line1, line2);
98
+ *
99
+ * const assessment = new ConjunctionAssessment(
100
+ * { tle: primaryTle, radius: 0.01 as Kilometers },
101
+ * { tle: secondaryTle, radius: 0.01 as Kilometers },
102
+ * );
103
+ *
104
+ * const event = assessment.assess({
105
+ * startTime: EpochUTC.fromDateTime(new Date('2025-01-01T00:00:00Z')),
106
+ * endTime: EpochUTC.fromDateTime(new Date('2025-01-02T00:00:00Z')),
107
+ * useHighFidelity: true,
108
+ * propagateCovariance: true,
109
+ * });
110
+ *
111
+ * console.log(event.toString());
112
+ * ```
113
+ */
114
+ export class ConjunctionAssessment {
115
+ private primaryProp: Propagator;
116
+ private secondaryProp: Propagator;
117
+ private primaryCovSample?: CovarianceSample;
118
+ private secondaryCovSample?: CovarianceSample;
119
+
120
+ constructor(
121
+ private primary: SpaceObject,
122
+ private secondary: SpaceObject,
123
+ ) {
124
+ // Initialize propagators (will be replaced in assess() if needed)
125
+ this.primaryProp = this.createPropagator(primary, false);
126
+ this.secondaryProp = this.createPropagator(secondary, false);
127
+ }
128
+
129
+ /**
130
+ * Performs conjunction assessment over the specified time window.
131
+ *
132
+ * @param options Assessment configuration options
133
+ * @returns ConjunctionEvent with TCA, miss distance, and probability of collision
134
+ */
135
+ assess(options: ConjunctionAssessmentOptions): ConjunctionEvent {
136
+ const {
137
+ startTime,
138
+ endTime,
139
+ useHighFidelity = false,
140
+ forceModel,
141
+ propagateCovariance = false,
142
+ tcaTolerance = 0.001 as Seconds,
143
+ searchStepSize = 60.0 as Seconds,
144
+ } = options;
145
+
146
+ // Create propagators based on options
147
+ this.primaryProp = this.primary.propagator ?? this.createPropagator(this.primary, useHighFidelity, forceModel);
148
+ this.secondaryProp =
149
+ this.secondary.propagator ?? this.createPropagator(this.secondary, useHighFidelity, forceModel);
150
+
151
+ // Initialize covariance samples if requested
152
+ if (propagateCovariance) {
153
+ this.initializeCovarianceSamples(useHighFidelity, forceModel);
154
+ }
155
+
156
+ // Find Time of Closest Approach (TCA)
157
+ const tca = this.findTCA(startTime, endTime, searchStepSize, tcaTolerance);
158
+
159
+ // Propagate states to TCA
160
+ const primaryState = this.primaryProp.propagate(tca);
161
+ const secondaryState = this.secondaryProp.propagate(tca);
162
+
163
+ // Compute relative state in RIC frame
164
+ const relativeState = RIC.fromJ2000(secondaryState, primaryState);
165
+
166
+ // Extract RIC components
167
+ const radialDistance = Math.abs(relativeState.position.x) as Kilometers;
168
+ const intrackDistance = Math.abs(relativeState.position.y) as Kilometers;
169
+ const crosstrackDistance = Math.abs(relativeState.position.z) as Kilometers;
170
+ const missDistance = relativeState.range;
171
+ const relativeVelocity = relativeState.velocity.magnitude();
172
+
173
+ // Compute combined covariance and Pc if available
174
+ let combinedCovariance: StateCovariance | undefined;
175
+ let probabilityOfCollision: number | undefined;
176
+
177
+ if (this.primaryCovSample && this.secondaryCovSample && this.primary.radius && this.secondary.radius) {
178
+ // Propagate covariance samples to TCA
179
+ this.primaryCovSample.propagate(tca);
180
+ this.secondaryCovSample.propagate(tca);
181
+
182
+ // Get covariances in RIC frame
183
+ const primaryCov = this.primaryCovSample.covarianceRIC();
184
+ const secondaryCov = this.secondaryCovSample.covarianceRIC();
185
+
186
+ // Combine covariances
187
+ combinedCovariance = ProbabilityOfCollision.combineCovarianceMatrices(primaryCov, secondaryCov);
188
+
189
+ // Calculate probability of collision
190
+ const combinedRadius = (this.primary.radius + this.secondary.radius) as Kilometers;
191
+
192
+ probabilityOfCollision = ProbabilityOfCollision.calculate(
193
+ relativeState.position,
194
+ relativeState.velocity,
195
+ combinedCovariance,
196
+ combinedRadius,
197
+ );
198
+ } else if (this.primary.covariance && this.secondary.covariance && this.primary.radius && this.secondary.radius) {
199
+ // Use provided covariances without propagation
200
+ // Transform to RIC if needed
201
+ let primaryCovRIC = this.primary.covariance;
202
+ let secondaryCovRIC = this.secondary.covariance;
203
+
204
+ if (this.primary.covariance.frame === CovarianceFrame.ECI) {
205
+ primaryCovRIC = this.transformCovarianceToRIC(this.primary.covariance, primaryState);
206
+ }
207
+ if (this.secondary.covariance.frame === CovarianceFrame.ECI) {
208
+ secondaryCovRIC = this.transformCovarianceToRIC(this.secondary.covariance, secondaryState);
209
+ }
210
+
211
+ combinedCovariance = ProbabilityOfCollision.combineCovarianceMatrices(primaryCovRIC, secondaryCovRIC);
212
+
213
+ const combinedRadius = (this.primary.radius + this.secondary.radius) as Kilometers;
214
+
215
+ probabilityOfCollision = ProbabilityOfCollision.calculate(
216
+ relativeState.position,
217
+ relativeState.velocity,
218
+ combinedCovariance,
219
+ combinedRadius,
220
+ );
221
+ }
222
+
223
+ return new ConjunctionEvent(
224
+ tca,
225
+ primaryState,
226
+ secondaryState,
227
+ relativeState,
228
+ missDistance,
229
+ radialDistance,
230
+ intrackDistance,
231
+ crosstrackDistance,
232
+ relativeVelocity,
233
+ combinedCovariance,
234
+ probabilityOfCollision,
235
+ this.primary.radius,
236
+ this.secondary.radius,
237
+ );
238
+ }
239
+
240
+ /**
241
+ * Finds the Time of Closest Approach (TCA) using golden section search.
242
+ *
243
+ * @param startTime Search window start
244
+ * @param endTime Search window end
245
+ * @param stepSize Initial search step size in seconds
246
+ * @param tolerance TCA search tolerance in seconds
247
+ * @returns TCA epoch
248
+ */
249
+ private findTCA(startTime: EpochUTC, endTime: EpochUTC, stepSize: Seconds, tolerance: Seconds): EpochUTC {
250
+ // Coarse search to find approximate TCA region
251
+ let minRange = Infinity;
252
+ let minEpoch = startTime;
253
+ let current = startTime;
254
+
255
+ while (current.posix <= endTime.posix) {
256
+ const primary = this.primaryProp.propagate(current);
257
+ const secondary = this.secondaryProp.propagate(current);
258
+ const ric = RIC.fromJ2000(secondary, primary);
259
+ const range = ric.range;
260
+
261
+ if (range < minRange) {
262
+ minRange = range;
263
+ minEpoch = current;
264
+ }
265
+
266
+ current = current.roll(stepSize);
267
+ }
268
+
269
+ // Fine search using golden section optimization
270
+ const searchWindow = 2 * stepSize;
271
+ const lowerBound = Math.max(startTime.posix, minEpoch.posix - searchWindow);
272
+ const upperBound = Math.min(endTime.posix, minEpoch.posix + searchWindow);
273
+
274
+ const tcaPosix = GoldenSection.search(
275
+ (posix) => {
276
+ const epoch = new EpochUTC(posix as Seconds);
277
+ const primary = this.primaryProp.propagate(epoch);
278
+ const secondary = this.secondaryProp.propagate(epoch);
279
+ const ric = RIC.fromJ2000(secondary, primary);
280
+
281
+ return ric.range;
282
+ },
283
+ lowerBound,
284
+ upperBound,
285
+ { tolerance },
286
+ );
287
+
288
+ return new EpochUTC(tcaPosix as Seconds);
289
+ }
290
+
291
+ /**
292
+ * Creates a propagator for a space object.
293
+ *
294
+ * @param obj Space object
295
+ * @param useHighFidelity Whether to use high-fidelity propagation
296
+ * @param forceModel Optional force model for numerical propagation
297
+ * @returns Propagator instance
298
+ */
299
+ private createPropagator(obj: SpaceObject, useHighFidelity: boolean, forceModel?: ForceModel): Propagator {
300
+ if (obj.tle) {
301
+ if (useHighFidelity) {
302
+ // Convert TLE to state and use RK89
303
+ const state = obj.tle.toJ2000();
304
+ const fm = forceModel ?? new ForceModel().setGravity();
305
+
306
+ return new RungeKutta89Propagator(state, fm);
307
+ }
308
+
309
+ return new Sgp4Propagator(obj.tle);
310
+ } else if (obj.state) {
311
+ if (useHighFidelity) {
312
+ const fm = forceModel ?? new ForceModel().setGravity();
313
+
314
+ return new RungeKutta89Propagator(obj.state, fm);
315
+ }
316
+
317
+ // For low-fidelity, still use RK89 but with simpler force model
318
+ const fm = new ForceModel().setGravity();
319
+
320
+ return new RungeKutta89Propagator(obj.state, fm);
321
+ }
322
+
323
+ throw new Error('Space object must have either a TLE or state vector');
324
+ }
325
+
326
+ /**
327
+ * Initializes covariance samples for both objects.
328
+ *
329
+ * @param useHighFidelity Whether to use high-fidelity propagation
330
+ * @param forceModel Optional force model
331
+ */
332
+ private initializeCovarianceSamples(useHighFidelity: boolean, forceModel?: ForceModel): void {
333
+ const fm = forceModel ?? new ForceModel().setGravity();
334
+
335
+ // Primary covariance
336
+ if (this.primary.tle) {
337
+ const state = this.primary.tle.toJ2000();
338
+ const covariance =
339
+ this.primary.covariance ??
340
+ StateCovariance.fromSigmas([1.0, 1.0, 1.0, 0.001, 0.001, 0.001], CovarianceFrame.RIC);
341
+
342
+ this.primaryCovSample = new CovarianceSample(state, covariance, this.primary.tle, fm, fm);
343
+ } else if (this.primary.state && this.primary.covariance) {
344
+ this.primaryCovSample = new CovarianceSample(this.primary.state, this.primary.covariance, undefined, fm, fm);
345
+ }
346
+
347
+ // Secondary covariance
348
+ if (this.secondary.tle) {
349
+ const state = this.secondary.tle.toJ2000();
350
+ const covariance =
351
+ this.secondary.covariance ??
352
+ StateCovariance.fromSigmas([1.0, 1.0, 1.0, 0.001, 0.001, 0.001], CovarianceFrame.RIC);
353
+
354
+ this.secondaryCovSample = new CovarianceSample(state, covariance, this.secondary.tle, fm, fm);
355
+ } else if (this.secondary.state && this.secondary.covariance) {
356
+ this.secondaryCovSample = new CovarianceSample(this.secondary.state, this.secondary.covariance, undefined, fm, fm);
357
+ }
358
+ }
359
+
360
+ /**
361
+ * Transforms ECI covariance to RIC frame.
362
+ *
363
+ * @param covariance ECI covariance
364
+ * @param state State vector for RIC frame definition
365
+ * @returns RIC covariance
366
+ */
367
+ private transformCovarianceToRIC(covariance: StateCovariance, state: J2000): StateCovariance {
368
+ // Create RIC transformation matrix (3x3)
369
+ const ricMatrix = this.createRICTransformMatrix(state.position, state.velocity);
370
+
371
+ // Build 6x6 transformation matrix (block diagonal with 3x3 rotation)
372
+ const transform = this.build6x6Transform(ricMatrix);
373
+
374
+ // Transform covariance: C_ric = T * C_eci * T^T
375
+ const covRIC = transform.multiply(covariance.matrix).multiply(transform.transpose());
376
+
377
+ return new StateCovariance(covRIC, CovarianceFrame.RIC);
378
+ }
379
+
380
+ /**
381
+ * Creates the 3x3 RIC transformation matrix.
382
+ *
383
+ * @param position Position vector
384
+ * @param velocity Velocity vector
385
+ * @returns 3x3 RIC transformation matrix
386
+ */
387
+ private createRICTransformMatrix(position: any, velocity: any): Matrix {
388
+ const ru = position.normalize();
389
+ const cu = position.cross(velocity).normalize();
390
+ const iu = cu.cross(ru).normalize();
391
+
392
+ return new Matrix([
393
+ [ru.x, ru.y, ru.z],
394
+ [iu.x, iu.y, iu.z],
395
+ [cu.x, cu.y, cu.z],
396
+ ]);
397
+ }
398
+
399
+ /**
400
+ * Builds a 6x6 transformation matrix from a 3x3 rotation matrix.
401
+ *
402
+ * @param rot 3x3 rotation matrix
403
+ * @returns 6x6 transformation matrix
404
+ */
405
+ private build6x6Transform(rot: Matrix): Matrix {
406
+ const elements = [
407
+ [rot.elements[0][0], rot.elements[0][1], rot.elements[0][2], 0, 0, 0],
408
+ [rot.elements[1][0], rot.elements[1][1], rot.elements[1][2], 0, 0, 0],
409
+ [rot.elements[2][0], rot.elements[2][1], rot.elements[2][2], 0, 0, 0],
410
+ [0, 0, 0, rot.elements[0][0], rot.elements[0][1], rot.elements[0][2]],
411
+ [0, 0, 0, rot.elements[1][0], rot.elements[1][1], rot.elements[1][2]],
412
+ [0, 0, 0, rot.elements[2][0], rot.elements[2][1], rot.elements[2][2]],
413
+ ];
414
+
415
+ return new Matrix(elements);
416
+ }
417
+ }