ootk 6.0.0-rc.4 → 6.0.0

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 (1008) hide show
  1. package/dist/main.cjs +29551 -0
  2. package/dist/main.d.cts +16961 -0
  3. package/dist/main.d.ts +16940 -32
  4. package/dist/main.js +29243 -35
  5. package/package.json +38 -25
  6. package/.claude/PROMPT.md +0 -13
  7. package/.claude/hooks/post-tool-use.ts +0 -33
  8. package/.claude/hooks/user-prompt-submit.ts +0 -138
  9. package/.claude/settings.local.json +0 -21
  10. package/.claude/skill-rules.json +0 -11
  11. package/.claude/skills/ootk-dev/SKILL.md +0 -16
  12. package/ADVANCED_FEATURES_GUIDE.md +0 -1025
  13. package/CHANGELOG.md +0 -511
  14. package/CLAUDE.md +0 -67
  15. package/FUTURE-WORK.md +0 -325
  16. package/dist/body/CelestialBody.d.ts +0 -155
  17. package/dist/body/CelestialBody.js +0 -207
  18. package/dist/body/CelestialBody.js.map +0 -1
  19. package/dist/body/CelestialBodyType.d.ts +0 -41
  20. package/dist/body/CelestialBodyType.js +0 -55
  21. package/dist/body/CelestialBodyType.js.map +0 -1
  22. package/dist/body/Earth.d.ts +0 -68
  23. package/dist/body/Earth.js +0 -198
  24. package/dist/body/Earth.js.map +0 -1
  25. package/dist/body/EphemerisBody.d.ts +0 -153
  26. package/dist/body/EphemerisBody.js +0 -235
  27. package/dist/body/EphemerisBody.js.map +0 -1
  28. package/dist/body/MoonBody.d.ts +0 -200
  29. package/dist/body/MoonBody.js +0 -414
  30. package/dist/body/MoonBody.js.map +0 -1
  31. package/dist/body/NutationAngles.d.ts +0 -38
  32. package/dist/body/NutationAngles.js +0 -24
  33. package/dist/body/NutationAngles.js.map +0 -1
  34. package/dist/body/PlanetBody.d.ts +0 -130
  35. package/dist/body/PlanetBody.js +0 -293
  36. package/dist/body/PlanetBody.js.map +0 -1
  37. package/dist/body/PrecessionAngles.d.ts +0 -29
  38. package/dist/body/PrecessionAngles.js +0 -24
  39. package/dist/body/PrecessionAngles.js.map +0 -1
  40. package/dist/body/SolarSystem.d.ts +0 -124
  41. package/dist/body/SolarSystem.js +0 -218
  42. package/dist/body/SolarSystem.js.map +0 -1
  43. package/dist/body/SunBody.d.ts +0 -253
  44. package/dist/body/SunBody.js +0 -433
  45. package/dist/body/SunBody.js.map +0 -1
  46. package/dist/body/index.d.ts +0 -36
  47. package/dist/body/index.js +0 -39
  48. package/dist/body/index.js.map +0 -1
  49. package/dist/comm/Antenna.d.ts +0 -112
  50. package/dist/comm/Antenna.js +0 -173
  51. package/dist/comm/Antenna.js.map +0 -1
  52. package/dist/comm/Beacon.d.ts +0 -141
  53. package/dist/comm/Beacon.js +0 -268
  54. package/dist/comm/Beacon.js.map +0 -1
  55. package/dist/comm/CommTypes.d.ts +0 -181
  56. package/dist/comm/CommTypes.js +0 -115
  57. package/dist/comm/CommTypes.js.map +0 -1
  58. package/dist/comm/CommunicationDevice.d.ts +0 -115
  59. package/dist/comm/CommunicationDevice.js +0 -142
  60. package/dist/comm/CommunicationDevice.js.map +0 -1
  61. package/dist/comm/Receiver.d.ts +0 -139
  62. package/dist/comm/Receiver.js +0 -219
  63. package/dist/comm/Receiver.js.map +0 -1
  64. package/dist/comm/Transmitter.d.ts +0 -136
  65. package/dist/comm/Transmitter.js +0 -273
  66. package/dist/comm/Transmitter.js.map +0 -1
  67. package/dist/comm/Transponder.d.ts +0 -154
  68. package/dist/comm/Transponder.js +0 -281
  69. package/dist/comm/Transponder.js.map +0 -1
  70. package/dist/comm/index.d.ts +0 -30
  71. package/dist/comm/index.js +0 -26
  72. package/dist/comm/index.js.map +0 -1
  73. package/dist/conjunction/CatalogScreener.d.ts +0 -134
  74. package/dist/conjunction/CatalogScreener.js +0 -213
  75. package/dist/conjunction/CatalogScreener.js.map +0 -1
  76. package/dist/conjunction/ConjunctionAssessment.d.ts +0 -149
  77. package/dist/conjunction/ConjunctionAssessment.js +0 -288
  78. package/dist/conjunction/ConjunctionAssessment.js.map +0 -1
  79. package/dist/conjunction/ConjunctionEvent.d.ts +0 -110
  80. package/dist/conjunction/ConjunctionEvent.js +0 -154
  81. package/dist/conjunction/ConjunctionEvent.js.map +0 -1
  82. package/dist/conjunction/CovarianceRealism.d.ts +0 -189
  83. package/dist/conjunction/CovarianceRealism.js +0 -348
  84. package/dist/conjunction/CovarianceRealism.js.map +0 -1
  85. package/dist/conjunction/ProbabilityOfCollision.d.ts +0 -102
  86. package/dist/conjunction/ProbabilityOfCollision.js +0 -242
  87. package/dist/conjunction/ProbabilityOfCollision.js.map +0 -1
  88. package/dist/conjunction/ScreeningFilter.d.ts +0 -112
  89. package/dist/conjunction/ScreeningFilter.js +0 -160
  90. package/dist/conjunction/ScreeningFilter.js.map +0 -1
  91. package/dist/conjunction/index.d.ts +0 -22
  92. package/dist/conjunction/index.js +0 -23
  93. package/dist/conjunction/index.js.map +0 -1
  94. package/dist/constellation/ConstellationGenerator.d.ts +0 -137
  95. package/dist/constellation/ConstellationGenerator.js +0 -270
  96. package/dist/constellation/ConstellationGenerator.js.map +0 -1
  97. package/dist/constellation/index.d.ts +0 -17
  98. package/dist/constellation/index.js +0 -18
  99. package/dist/constellation/index.js.map +0 -1
  100. package/dist/coordinate/ClassicalElements.d.ts +0 -170
  101. package/dist/coordinate/ClassicalElements.js +0 -334
  102. package/dist/coordinate/ClassicalElements.js.map +0 -1
  103. package/dist/coordinate/EquinoctialElements.d.ts +0 -114
  104. package/dist/coordinate/EquinoctialElements.js +0 -172
  105. package/dist/coordinate/EquinoctialElements.js.map +0 -1
  106. package/dist/coordinate/FormatTle.d.ts +0 -95
  107. package/dist/coordinate/FormatTle.js +0 -188
  108. package/dist/coordinate/FormatTle.js.map +0 -1
  109. package/dist/coordinate/Geodetic.d.ts +0 -110
  110. package/dist/coordinate/Geodetic.js +0 -164
  111. package/dist/coordinate/Geodetic.js.map +0 -1
  112. package/dist/coordinate/Hill.d.ts +0 -49
  113. package/dist/coordinate/Hill.js +0 -222
  114. package/dist/coordinate/Hill.js.map +0 -1
  115. package/dist/coordinate/ITRF.d.ts +0 -75
  116. package/dist/coordinate/ITRF.js +0 -135
  117. package/dist/coordinate/ITRF.js.map +0 -1
  118. package/dist/coordinate/J2000.d.ts +0 -65
  119. package/dist/coordinate/J2000.js +0 -120
  120. package/dist/coordinate/J2000.js.map +0 -1
  121. package/dist/coordinate/RIC.d.ts +0 -64
  122. package/dist/coordinate/RIC.js +0 -79
  123. package/dist/coordinate/RIC.js.map +0 -1
  124. package/dist/coordinate/RelativeState.d.ts +0 -70
  125. package/dist/coordinate/RelativeState.js +0 -79
  126. package/dist/coordinate/RelativeState.js.map +0 -1
  127. package/dist/coordinate/StateVector.d.ts +0 -76
  128. package/dist/coordinate/StateVector.js +0 -97
  129. package/dist/coordinate/StateVector.js.map +0 -1
  130. package/dist/coordinate/TEME.d.ts +0 -57
  131. package/dist/coordinate/TEME.js +0 -89
  132. package/dist/coordinate/TEME.js.map +0 -1
  133. package/dist/coordinate/Tle.d.ts +0 -429
  134. package/dist/coordinate/Tle.js +0 -866
  135. package/dist/coordinate/Tle.js.map +0 -1
  136. package/dist/coordinate/index.d.ts +0 -12
  137. package/dist/coordinate/index.js +0 -13
  138. package/dist/coordinate/index.js.map +0 -1
  139. package/dist/coordinate/tle-format-data.d.ts +0 -41
  140. package/dist/coordinate/tle-format-data.js +0 -46
  141. package/dist/coordinate/tle-format-data.js.map +0 -1
  142. package/dist/covariance/CovarianceSample.d.ts +0 -46
  143. package/dist/covariance/CovarianceSample.js +0 -221
  144. package/dist/covariance/CovarianceSample.js.map +0 -1
  145. package/dist/covariance/StateCovariance.d.ts +0 -42
  146. package/dist/covariance/StateCovariance.js +0 -65
  147. package/dist/covariance/StateCovariance.js.map +0 -1
  148. package/dist/covariance/index.d.ts +0 -2
  149. package/dist/covariance/index.js +0 -3
  150. package/dist/covariance/index.js.map +0 -1
  151. package/dist/data/DataHandler.d.ts +0 -66
  152. package/dist/data/DataHandler.js +0 -80
  153. package/dist/data/DataHandler.js.map +0 -1
  154. package/dist/data/values/Egm96Data.d.ts +0 -37
  155. package/dist/data/values/Egm96Data.js +0 -63
  156. package/dist/data/values/Egm96Data.js.map +0 -1
  157. package/dist/data/values/HpAtmosphereData.d.ts +0 -33
  158. package/dist/data/values/HpAtmosphereData.js +0 -58
  159. package/dist/data/values/HpAtmosphereData.js.map +0 -1
  160. package/dist/data/values/HpAtmosphereResult.d.ts +0 -29
  161. package/dist/data/values/HpAtmosphereResult.js +0 -38
  162. package/dist/data/values/HpAtmosphereResult.js.map +0 -1
  163. package/dist/data/values/Iau1980Data.d.ts +0 -36
  164. package/dist/data/values/Iau1980Data.js +0 -52
  165. package/dist/data/values/Iau1980Data.js.map +0 -1
  166. package/dist/data/values/LeapSecond.d.ts +0 -27
  167. package/dist/data/values/LeapSecond.js +0 -35
  168. package/dist/data/values/LeapSecond.js.map +0 -1
  169. package/dist/data/values/LeapSecondData.d.ts +0 -41
  170. package/dist/data/values/LeapSecondData.js +0 -103
  171. package/dist/data/values/LeapSecondData.js.map +0 -1
  172. package/dist/data/values/egm96.d.ts +0 -24
  173. package/dist/data/values/egm96.js +0 -726
  174. package/dist/data/values/egm96.js.map +0 -1
  175. package/dist/data/values/hpAtmosphere.d.ts +0 -24
  176. package/dist/data/values/hpAtmosphere.js +0 -76
  177. package/dist/data/values/hpAtmosphere.js.map +0 -1
  178. package/dist/data/values/iau1980.d.ts +0 -24
  179. package/dist/data/values/iau1980.js +0 -30
  180. package/dist/data/values/iau1980.js.map +0 -1
  181. package/dist/enums/AngularDiameterMethod.d.ts +0 -27
  182. package/dist/enums/AngularDiameterMethod.js +0 -29
  183. package/dist/enums/AngularDiameterMethod.js.map +0 -1
  184. package/dist/enums/AngularDistanceMethod.d.ts +0 -27
  185. package/dist/enums/AngularDistanceMethod.js +0 -29
  186. package/dist/enums/AngularDistanceMethod.js.map +0 -1
  187. package/dist/enums/CatalogSource.d.ts +0 -10
  188. package/dist/enums/CatalogSource.js +0 -12
  189. package/dist/enums/CatalogSource.js.map +0 -1
  190. package/dist/enums/CommLink.d.ts +0 -7
  191. package/dist/enums/CommLink.js +0 -9
  192. package/dist/enums/CommLink.js.map +0 -1
  193. package/dist/enums/FovFrame.d.ts +0 -25
  194. package/dist/enums/FovFrame.js +0 -27
  195. package/dist/enums/FovFrame.js.map +0 -1
  196. package/dist/enums/FovShape.d.ts +0 -25
  197. package/dist/enums/FovShape.js +0 -27
  198. package/dist/enums/FovShape.js.map +0 -1
  199. package/dist/enums/OrbitRegime.d.ts +0 -30
  200. package/dist/enums/OrbitRegime.js +0 -32
  201. package/dist/enums/OrbitRegime.js.map +0 -1
  202. package/dist/enums/PassType.d.ts +0 -28
  203. package/dist/enums/PassType.js +0 -30
  204. package/dist/enums/PassType.js.map +0 -1
  205. package/dist/enums/SensorType.d.ts +0 -33
  206. package/dist/enums/SensorType.js +0 -35
  207. package/dist/enums/SensorType.js.map +0 -1
  208. package/dist/enums/Sgp4OpsMode.d.ts +0 -26
  209. package/dist/enums/Sgp4OpsMode.js +0 -28
  210. package/dist/enums/Sgp4OpsMode.js.map +0 -1
  211. package/dist/enums/index.d.ts +0 -10
  212. package/dist/enums/index.js +0 -11
  213. package/dist/enums/index.js.map +0 -1
  214. package/dist/errors/index.d.ts +0 -153
  215. package/dist/errors/index.js +0 -179
  216. package/dist/errors/index.js.map +0 -1
  217. package/dist/force/AtmosphericDrag.d.ts +0 -50
  218. package/dist/force/AtmosphericDrag.js +0 -92
  219. package/dist/force/AtmosphericDrag.js.map +0 -1
  220. package/dist/force/EarthGravity.d.ts +0 -53
  221. package/dist/force/EarthGravity.js +0 -142
  222. package/dist/force/EarthGravity.js.map +0 -1
  223. package/dist/force/Force.d.ts +0 -26
  224. package/dist/force/Force.js +0 -22
  225. package/dist/force/Force.js.map +0 -1
  226. package/dist/force/ForceModel.d.ts +0 -45
  227. package/dist/force/ForceModel.js +0 -83
  228. package/dist/force/ForceModel.js.map +0 -1
  229. package/dist/force/Gravity.d.ts +0 -38
  230. package/dist/force/Gravity.js +0 -47
  231. package/dist/force/Gravity.js.map +0 -1
  232. package/dist/force/SolarRadiationPressure.d.ts +0 -26
  233. package/dist/force/SolarRadiationPressure.js +0 -45
  234. package/dist/force/SolarRadiationPressure.js.map +0 -1
  235. package/dist/force/ThirdBodyGravity.d.ts +0 -26
  236. package/dist/force/ThirdBodyGravity.js +0 -59
  237. package/dist/force/ThirdBodyGravity.js.map +0 -1
  238. package/dist/force/Thrust.d.ts +0 -34
  239. package/dist/force/Thrust.js +0 -58
  240. package/dist/force/Thrust.js.map +0 -1
  241. package/dist/force/index.d.ts +0 -8
  242. package/dist/force/index.js +0 -9
  243. package/dist/force/index.js.map +0 -1
  244. package/dist/interfaces/BaseObjectParams.d.ts +0 -30
  245. package/dist/interfaces/BaseObjectParams.js +0 -24
  246. package/dist/interfaces/BaseObjectParams.js.map +0 -1
  247. package/dist/interfaces/ClassicalElementsParams.d.ts +0 -33
  248. package/dist/interfaces/ClassicalElementsParams.js +0 -24
  249. package/dist/interfaces/ClassicalElementsParams.js.map +0 -1
  250. package/dist/interfaces/EquinoctialElementsParams.d.ts +0 -35
  251. package/dist/interfaces/EquinoctialElementsParams.js +0 -24
  252. package/dist/interfaces/EquinoctialElementsParams.js.map +0 -1
  253. package/dist/interfaces/GroundPositionParams.d.ts +0 -28
  254. package/dist/interfaces/GroundPositionParams.js +0 -24
  255. package/dist/interfaces/GroundPositionParams.js.map +0 -1
  256. package/dist/interfaces/OmmFormat.d.ts +0 -62
  257. package/dist/interfaces/OmmFormat.js +0 -2
  258. package/dist/interfaces/OmmFormat.js.map +0 -1
  259. package/dist/interfaces/OptionsParams.d.ts +0 -3
  260. package/dist/interfaces/OptionsParams.js +0 -2
  261. package/dist/interfaces/OptionsParams.js.map +0 -1
  262. package/dist/interfaces/SatelliteParams.d.ts +0 -38
  263. package/dist/interfaces/SatelliteParams.js +0 -2
  264. package/dist/interfaces/SatelliteParams.js.map +0 -1
  265. package/dist/interfaces/StarObjectParams.d.ts +0 -10
  266. package/dist/interfaces/StarObjectParams.js +0 -2
  267. package/dist/interfaces/StarObjectParams.js.map +0 -1
  268. package/dist/interfaces/TimeVariables.d.ts +0 -6
  269. package/dist/interfaces/TimeVariables.js +0 -2
  270. package/dist/interfaces/TimeVariables.js.map +0 -1
  271. package/dist/interfaces/index.d.ts +0 -7
  272. package/dist/interfaces/index.js +0 -2
  273. package/dist/interfaces/index.js.map +0 -1
  274. package/dist/interpolator/ChebyshevCoefficients.d.ts +0 -50
  275. package/dist/interpolator/ChebyshevCoefficients.js +0 -94
  276. package/dist/interpolator/ChebyshevCoefficients.js.map +0 -1
  277. package/dist/interpolator/ChebyshevInterpolator.d.ts +0 -38
  278. package/dist/interpolator/ChebyshevInterpolator.js +0 -71
  279. package/dist/interpolator/ChebyshevInterpolator.js.map +0 -1
  280. package/dist/interpolator/CubicSpline.d.ts +0 -35
  281. package/dist/interpolator/CubicSpline.js +0 -69
  282. package/dist/interpolator/CubicSpline.js.map +0 -1
  283. package/dist/interpolator/CubicSplineInterpolator.d.ts +0 -36
  284. package/dist/interpolator/CubicSplineInterpolator.js +0 -80
  285. package/dist/interpolator/CubicSplineInterpolator.js.map +0 -1
  286. package/dist/interpolator/FieldInterpolator.d.ts +0 -28
  287. package/dist/interpolator/FieldInterpolator.js +0 -24
  288. package/dist/interpolator/FieldInterpolator.js.map +0 -1
  289. package/dist/interpolator/Interpolator.d.ts +0 -22
  290. package/dist/interpolator/Interpolator.js +0 -47
  291. package/dist/interpolator/Interpolator.js.map +0 -1
  292. package/dist/interpolator/LagrangeInterpolator.d.ts +0 -40
  293. package/dist/interpolator/LagrangeInterpolator.js +0 -159
  294. package/dist/interpolator/LagrangeInterpolator.js.map +0 -1
  295. package/dist/interpolator/StateInterpolator.d.ts +0 -27
  296. package/dist/interpolator/StateInterpolator.js +0 -27
  297. package/dist/interpolator/StateInterpolator.js.map +0 -1
  298. package/dist/interpolator/VerletBlendInterpolator.d.ts +0 -43
  299. package/dist/interpolator/VerletBlendInterpolator.js +0 -118
  300. package/dist/interpolator/VerletBlendInterpolator.js.map +0 -1
  301. package/dist/interpolator/index.d.ts +0 -31
  302. package/dist/interpolator/index.js +0 -32
  303. package/dist/interpolator/index.js.map +0 -1
  304. package/dist/main.js.map +0 -1
  305. package/dist/maneuver/TwoBurnOrbitTransfer.d.ts +0 -41
  306. package/dist/maneuver/TwoBurnOrbitTransfer.js +0 -65
  307. package/dist/maneuver/TwoBurnOrbitTransfer.js.map +0 -1
  308. package/dist/maneuver/Waypoint.d.ts +0 -91
  309. package/dist/maneuver/Waypoint.js +0 -179
  310. package/dist/maneuver/Waypoint.js.map +0 -1
  311. package/dist/maneuver/index.d.ts +0 -24
  312. package/dist/maneuver/index.js +0 -25
  313. package/dist/maneuver/index.js.map +0 -1
  314. package/dist/objects/AccessCalculator.d.ts +0 -112
  315. package/dist/objects/AccessCalculator.js +0 -268
  316. package/dist/objects/AccessCalculator.js.map +0 -1
  317. package/dist/objects/AccessWindow.d.ts +0 -95
  318. package/dist/objects/AccessWindow.js +0 -69
  319. package/dist/objects/AccessWindow.js.map +0 -1
  320. package/dist/objects/BaseObject.d.ts +0 -119
  321. package/dist/objects/BaseObject.js +0 -203
  322. package/dist/objects/BaseObject.js.map +0 -1
  323. package/dist/objects/CenterBody.d.ts +0 -41
  324. package/dist/objects/CenterBody.js +0 -85
  325. package/dist/objects/CenterBody.js.map +0 -1
  326. package/dist/objects/DynamicGroundObject.d.ts +0 -309
  327. package/dist/objects/DynamicGroundObject.js +0 -758
  328. package/dist/objects/DynamicGroundObject.js.map +0 -1
  329. package/dist/objects/EphemerisSatellite.d.ts +0 -209
  330. package/dist/objects/EphemerisSatellite.js +0 -480
  331. package/dist/objects/EphemerisSatellite.js.map +0 -1
  332. package/dist/objects/GroundObject.d.ts +0 -124
  333. package/dist/objects/GroundObject.js +0 -192
  334. package/dist/objects/GroundObject.js.map +0 -1
  335. package/dist/objects/GroundStation.d.ts +0 -60
  336. package/dist/objects/GroundStation.js +0 -113
  337. package/dist/objects/GroundStation.js.map +0 -1
  338. package/dist/objects/History.d.ts +0 -101
  339. package/dist/objects/History.js +0 -180
  340. package/dist/objects/History.js.map +0 -1
  341. package/dist/objects/InterpolatorType.d.ts +0 -39
  342. package/dist/objects/InterpolatorType.js +0 -41
  343. package/dist/objects/InterpolatorType.js.map +0 -1
  344. package/dist/objects/LandObject.d.ts +0 -38
  345. package/dist/objects/LandObject.js +0 -48
  346. package/dist/objects/LandObject.js.map +0 -1
  347. package/dist/objects/Marker.d.ts +0 -24
  348. package/dist/objects/Marker.js +0 -30
  349. package/dist/objects/Marker.js.map +0 -1
  350. package/dist/objects/ObjectTypes.d.ts +0 -60
  351. package/dist/objects/ObjectTypes.js +0 -18
  352. package/dist/objects/ObjectTypes.js.map +0 -1
  353. package/dist/objects/Satellite.d.ts +0 -443
  354. package/dist/objects/Satellite.js +0 -843
  355. package/dist/objects/Satellite.js.map +0 -1
  356. package/dist/objects/SpaceObject.d.ts +0 -205
  357. package/dist/objects/SpaceObject.js +0 -149
  358. package/dist/objects/SpaceObject.js.map +0 -1
  359. package/dist/objects/Star.d.ts +0 -44
  360. package/dist/objects/Star.js +0 -95
  361. package/dist/objects/Star.js.map +0 -1
  362. package/dist/objects/VisualizationHelpers.d.ts +0 -148
  363. package/dist/objects/VisualizationHelpers.js +0 -218
  364. package/dist/objects/VisualizationHelpers.js.map +0 -1
  365. package/dist/objects/index.d.ts +0 -24
  366. package/dist/objects/index.js +0 -16
  367. package/dist/objects/index.js.map +0 -1
  368. package/dist/observation/Observation.d.ts +0 -89
  369. package/dist/observation/Observation.js +0 -51
  370. package/dist/observation/Observation.js.map +0 -1
  371. package/dist/observation/ObservationOptical.d.ts +0 -48
  372. package/dist/observation/ObservationOptical.js +0 -105
  373. package/dist/observation/ObservationOptical.js.map +0 -1
  374. package/dist/observation/ObservationRadar.d.ts +0 -46
  375. package/dist/observation/ObservationRadar.js +0 -96
  376. package/dist/observation/ObservationRadar.js.map +0 -1
  377. package/dist/observation/ObservationUtils.d.ts +0 -22
  378. package/dist/observation/ObservationUtils.js +0 -46
  379. package/dist/observation/ObservationUtils.js.map +0 -1
  380. package/dist/observation/PropagatorPairs.d.ts +0 -32
  381. package/dist/observation/PropagatorPairs.js +0 -43
  382. package/dist/observation/PropagatorPairs.js.map +0 -1
  383. package/dist/observation/RAE.d.ts +0 -111
  384. package/dist/observation/RAE.js +0 -214
  385. package/dist/observation/RAE.js.map +0 -1
  386. package/dist/observation/RadecGeocentric.d.ts +0 -111
  387. package/dist/observation/RadecGeocentric.js +0 -169
  388. package/dist/observation/RadecGeocentric.js.map +0 -1
  389. package/dist/observation/RadecTopocentric.d.ts +0 -123
  390. package/dist/observation/RadecTopocentric.js +0 -200
  391. package/dist/observation/RadecTopocentric.js.map +0 -1
  392. package/dist/observation/index.d.ts +0 -26
  393. package/dist/observation/index.js +0 -27
  394. package/dist/observation/index.js.map +0 -1
  395. package/dist/operations/BoxMuller.d.ts +0 -46
  396. package/dist/operations/BoxMuller.js +0 -77
  397. package/dist/operations/BoxMuller.js.map +0 -1
  398. package/dist/operations/EulerAngles.d.ts +0 -105
  399. package/dist/operations/EulerAngles.js +0 -161
  400. package/dist/operations/EulerAngles.js.map +0 -1
  401. package/dist/operations/Matrix.d.ts +0 -170
  402. package/dist/operations/Matrix.js +0 -405
  403. package/dist/operations/Matrix.js.map +0 -1
  404. package/dist/operations/Quaternion.d.ts +0 -56
  405. package/dist/operations/Quaternion.js +0 -167
  406. package/dist/operations/Quaternion.js.map +0 -1
  407. package/dist/operations/Random.d.ts +0 -40
  408. package/dist/operations/Random.js +0 -50
  409. package/dist/operations/Random.js.map +0 -1
  410. package/dist/operations/RandomGaussianSource.d.ts +0 -24
  411. package/dist/operations/RandomGaussianSource.js +0 -43
  412. package/dist/operations/RandomGaussianSource.js.map +0 -1
  413. package/dist/operations/Vector.d.ts +0 -262
  414. package/dist/operations/Vector.js +0 -415
  415. package/dist/operations/Vector.js.map +0 -1
  416. package/dist/operations/Vector3D.d.ts +0 -80
  417. package/dist/operations/Vector3D.js +0 -224
  418. package/dist/operations/Vector3D.js.map +0 -1
  419. package/dist/operations/index.d.ts +0 -4
  420. package/dist/operations/index.js +0 -5
  421. package/dist/operations/index.js.map +0 -1
  422. package/dist/operations/operations.d.ts +0 -26
  423. package/dist/operations/operations.js +0 -27
  424. package/dist/operations/operations.js.map +0 -1
  425. package/dist/optimize/ChebyshevCompressor.d.ts +0 -80
  426. package/dist/optimize/ChebyshevCompressor.js +0 -128
  427. package/dist/optimize/ChebyshevCompressor.js.map +0 -1
  428. package/dist/optimize/DownhillSimplex.d.ts +0 -98
  429. package/dist/optimize/DownhillSimplex.js +0 -216
  430. package/dist/optimize/DownhillSimplex.js.map +0 -1
  431. package/dist/optimize/GoldenSection.d.ts +0 -177
  432. package/dist/optimize/GoldenSection.js +0 -202
  433. package/dist/optimize/GoldenSection.js.map +0 -1
  434. package/dist/optimize/PolynomialRegression.d.ts +0 -151
  435. package/dist/optimize/PolynomialRegression.js +0 -184
  436. package/dist/optimize/PolynomialRegression.js.map +0 -1
  437. package/dist/optimize/SimpleLinearRegression.d.ts +0 -153
  438. package/dist/optimize/SimpleLinearRegression.js +0 -212
  439. package/dist/optimize/SimpleLinearRegression.js.map +0 -1
  440. package/dist/optimize/index.d.ts +0 -5
  441. package/dist/optimize/index.js +0 -6
  442. package/dist/optimize/index.js.map +0 -1
  443. package/dist/optimize/internal/PolynomicalRegressionResult.d.ts +0 -118
  444. package/dist/optimize/internal/PolynomicalRegressionResult.js +0 -123
  445. package/dist/optimize/internal/PolynomicalRegressionResult.js.map +0 -1
  446. package/dist/optimize/internal/SimplexEntry.d.ts +0 -150
  447. package/dist/optimize/internal/SimplexEntry.js +0 -147
  448. package/dist/optimize/internal/SimplexEntry.js.map +0 -1
  449. package/dist/orbit-design/RepeatGroundTrack.d.ts +0 -184
  450. package/dist/orbit-design/RepeatGroundTrack.js +0 -359
  451. package/dist/orbit-design/RepeatGroundTrack.js.map +0 -1
  452. package/dist/orbit-design/index.d.ts +0 -18
  453. package/dist/orbit-design/index.js +0 -18
  454. package/dist/orbit-design/index.js.map +0 -1
  455. package/dist/orbit-determination/BatchLeastSquaresOD.d.ts +0 -69
  456. package/dist/orbit-determination/BatchLeastSquaresOD.js +0 -143
  457. package/dist/orbit-determination/BatchLeastSquaresOD.js.map +0 -1
  458. package/dist/orbit-determination/BatchLeastSquaresResult.d.ts +0 -31
  459. package/dist/orbit-determination/BatchLeastSquaresResult.js +0 -36
  460. package/dist/orbit-determination/BatchLeastSquaresResult.js.map +0 -1
  461. package/dist/orbit-determination/GaussIOD.d.ts +0 -98
  462. package/dist/orbit-determination/GaussIOD.js +0 -294
  463. package/dist/orbit-determination/GaussIOD.js.map +0 -1
  464. package/dist/orbit-determination/GibbsIOD.d.ts +0 -38
  465. package/dist/orbit-determination/GibbsIOD.js +0 -77
  466. package/dist/orbit-determination/GibbsIOD.js.map +0 -1
  467. package/dist/orbit-determination/GoodingIOD.d.ts +0 -155
  468. package/dist/orbit-determination/GoodingIOD.js +0 -492
  469. package/dist/orbit-determination/GoodingIOD.js.map +0 -1
  470. package/dist/orbit-determination/HerrickGibbsIOD.d.ts +0 -33
  471. package/dist/orbit-determination/HerrickGibbsIOD.js +0 -50
  472. package/dist/orbit-determination/HerrickGibbsIOD.js.map +0 -1
  473. package/dist/orbit-determination/LambertIOD.d.ts +0 -59
  474. package/dist/orbit-determination/LambertIOD.js +0 -213
  475. package/dist/orbit-determination/LambertIOD.js.map +0 -1
  476. package/dist/orbit-determination/LevenbergMarquardtOD.d.ts +0 -72
  477. package/dist/orbit-determination/LevenbergMarquardtOD.js +0 -202
  478. package/dist/orbit-determination/LevenbergMarquardtOD.js.map +0 -1
  479. package/dist/orbit-determination/LevenbergMarquardtResult.d.ts +0 -36
  480. package/dist/orbit-determination/LevenbergMarquardtResult.js +0 -43
  481. package/dist/orbit-determination/LevenbergMarquardtResult.js.map +0 -1
  482. package/dist/orbit-determination/ModifiedGoodingIOD.d.ts +0 -41
  483. package/dist/orbit-determination/ModifiedGoodingIOD.js +0 -94
  484. package/dist/orbit-determination/ModifiedGoodingIOD.js.map +0 -1
  485. package/dist/orbit-determination/index.d.ts +0 -9
  486. package/dist/orbit-determination/index.js +0 -10
  487. package/dist/orbit-determination/index.js.map +0 -1
  488. package/dist/parsers/CdmExporter.d.ts +0 -85
  489. package/dist/parsers/CdmExporter.js +0 -235
  490. package/dist/parsers/CdmExporter.js.map +0 -1
  491. package/dist/parsers/CdmParser.d.ts +0 -97
  492. package/dist/parsers/CdmParser.js +0 -396
  493. package/dist/parsers/CdmParser.js.map +0 -1
  494. package/dist/parsers/CdmTypes.d.ts +0 -240
  495. package/dist/parsers/CdmTypes.js +0 -18
  496. package/dist/parsers/CdmTypes.js.map +0 -1
  497. package/dist/parsers/HorizonsParser.d.ts +0 -128
  498. package/dist/parsers/HorizonsParser.js +0 -320
  499. package/dist/parsers/HorizonsParser.js.map +0 -1
  500. package/dist/parsers/OemParser.d.ts +0 -56
  501. package/dist/parsers/OemParser.js +0 -235
  502. package/dist/parsers/OemParser.js.map +0 -1
  503. package/dist/parsers/OemTypes.d.ts +0 -100
  504. package/dist/parsers/OemTypes.js +0 -18
  505. package/dist/parsers/OemTypes.js.map +0 -1
  506. package/dist/parsers/index.d.ts +0 -23
  507. package/dist/parsers/index.js +0 -24
  508. package/dist/parsers/index.js.map +0 -1
  509. package/dist/propagator/DormandPrince54Propagator.d.ts +0 -28
  510. package/dist/propagator/DormandPrince54Propagator.js +0 -64
  511. package/dist/propagator/DormandPrince54Propagator.js.map +0 -1
  512. package/dist/propagator/KeplerPropagator.d.ts +0 -35
  513. package/dist/propagator/KeplerPropagator.js +0 -83
  514. package/dist/propagator/KeplerPropagator.js.map +0 -1
  515. package/dist/propagator/Propagator.d.ts +0 -34
  516. package/dist/propagator/Propagator.js +0 -162
  517. package/dist/propagator/Propagator.js.map +0 -1
  518. package/dist/propagator/RkCheckpoint.d.ts +0 -22
  519. package/dist/propagator/RkCheckpoint.js +0 -27
  520. package/dist/propagator/RkCheckpoint.js.map +0 -1
  521. package/dist/propagator/RkResult.d.ts +0 -23
  522. package/dist/propagator/RkResult.js +0 -30
  523. package/dist/propagator/RkResult.js.map +0 -1
  524. package/dist/propagator/RungeKutta4Propagator.d.ts +0 -50
  525. package/dist/propagator/RungeKutta4Propagator.js +0 -141
  526. package/dist/propagator/RungeKutta4Propagator.js.map +0 -1
  527. package/dist/propagator/RungeKutta89Propagator.d.ts +0 -28
  528. package/dist/propagator/RungeKutta89Propagator.js +0 -126
  529. package/dist/propagator/RungeKutta89Propagator.js.map +0 -1
  530. package/dist/propagator/RungeKuttaAdaptive.d.ts +0 -51
  531. package/dist/propagator/RungeKuttaAdaptive.js +0 -199
  532. package/dist/propagator/RungeKuttaAdaptive.js.map +0 -1
  533. package/dist/propagator/Sgp4Propagator.d.ts +0 -76
  534. package/dist/propagator/Sgp4Propagator.js +0 -96
  535. package/dist/propagator/Sgp4Propagator.js.map +0 -1
  536. package/dist/propagator/index.d.ts +0 -9
  537. package/dist/propagator/index.js +0 -10
  538. package/dist/propagator/index.js.map +0 -1
  539. package/dist/scheduling/ContactScheduler.d.ts +0 -248
  540. package/dist/scheduling/ContactScheduler.js +0 -503
  541. package/dist/scheduling/ContactScheduler.js.map +0 -1
  542. package/dist/scheduling/ScheduledContact.d.ts +0 -155
  543. package/dist/scheduling/ScheduledContact.js +0 -189
  544. package/dist/scheduling/ScheduledContact.js.map +0 -1
  545. package/dist/scheduling/index.d.ts +0 -5
  546. package/dist/scheduling/index.js +0 -4
  547. package/dist/scheduling/index.js.map +0 -1
  548. package/dist/sensor/FieldOfView.d.ts +0 -250
  549. package/dist/sensor/FieldOfView.js +0 -470
  550. package/dist/sensor/FieldOfView.js.map +0 -1
  551. package/dist/sensor/LaserRangingSensor.d.ts +0 -122
  552. package/dist/sensor/LaserRangingSensor.js +0 -174
  553. package/dist/sensor/LaserRangingSensor.js.map +0 -1
  554. package/dist/sensor/MechanicalRadar.d.ts +0 -86
  555. package/dist/sensor/MechanicalRadar.js +0 -130
  556. package/dist/sensor/MechanicalRadar.js.map +0 -1
  557. package/dist/sensor/OpticalSensor.d.ts +0 -111
  558. package/dist/sensor/OpticalSensor.js +0 -164
  559. package/dist/sensor/OpticalSensor.js.map +0 -1
  560. package/dist/sensor/PassiveRFSensor.d.ts +0 -115
  561. package/dist/sensor/PassiveRFSensor.js +0 -168
  562. package/dist/sensor/PassiveRFSensor.js.map +0 -1
  563. package/dist/sensor/PhasedArrayRadar.d.ts +0 -170
  564. package/dist/sensor/PhasedArrayRadar.js +0 -290
  565. package/dist/sensor/PhasedArrayRadar.js.map +0 -1
  566. package/dist/sensor/RadarSensor.d.ts +0 -94
  567. package/dist/sensor/RadarSensor.js +0 -106
  568. package/dist/sensor/RadarSensor.js.map +0 -1
  569. package/dist/sensor/Sensor.d.ts +0 -271
  570. package/dist/sensor/Sensor.js +0 -343
  571. package/dist/sensor/Sensor.js.map +0 -1
  572. package/dist/sensor/index.d.ts +0 -74
  573. package/dist/sensor/index.js +0 -70
  574. package/dist/sensor/index.js.map +0 -1
  575. package/dist/sgp4/index.d.ts +0 -25
  576. package/dist/sgp4/index.js +0 -25
  577. package/dist/sgp4/index.js.map +0 -1
  578. package/dist/sgp4/sgp4-error.d.ts +0 -22
  579. package/dist/sgp4/sgp4-error.js +0 -44
  580. package/dist/sgp4/sgp4-error.js.map +0 -1
  581. package/dist/sgp4/sgp4.d.ts +0 -99
  582. package/dist/sgp4/sgp4.js +0 -3170
  583. package/dist/sgp4/sgp4.js.map +0 -1
  584. package/dist/smoothing/ExponentialSmoothing.d.ts +0 -37
  585. package/dist/smoothing/ExponentialSmoothing.js +0 -75
  586. package/dist/smoothing/ExponentialSmoothing.js.map +0 -1
  587. package/dist/time/Epoch.d.ts +0 -81
  588. package/dist/time/Epoch.js +0 -146
  589. package/dist/time/Epoch.js.map +0 -1
  590. package/dist/time/EpochGPS.d.ts +0 -106
  591. package/dist/time/EpochGPS.js +0 -134
  592. package/dist/time/EpochGPS.js.map +0 -1
  593. package/dist/time/EpochTAI.d.ts +0 -62
  594. package/dist/time/EpochTAI.js +0 -63
  595. package/dist/time/EpochTAI.js.map +0 -1
  596. package/dist/time/EpochTDB.d.ts +0 -72
  597. package/dist/time/EpochTDB.js +0 -73
  598. package/dist/time/EpochTDB.js.map +0 -1
  599. package/dist/time/EpochTT.d.ts +0 -75
  600. package/dist/time/EpochTT.js +0 -76
  601. package/dist/time/EpochTT.js.map +0 -1
  602. package/dist/time/EpochUTC.d.ts +0 -123
  603. package/dist/time/EpochUTC.js +0 -200
  604. package/dist/time/EpochUTC.js.map +0 -1
  605. package/dist/time/EpochWindow.d.ts +0 -28
  606. package/dist/time/EpochWindow.js +0 -31
  607. package/dist/time/EpochWindow.js.map +0 -1
  608. package/dist/time/TimeStamped.d.ts +0 -61
  609. package/dist/time/TimeStamped.js +0 -73
  610. package/dist/time/TimeStamped.js.map +0 -1
  611. package/dist/time/index.d.ts +0 -8
  612. package/dist/time/index.js +0 -9
  613. package/dist/time/index.js.map +0 -1
  614. package/dist/transforms/TransformCache.d.ts +0 -27
  615. package/dist/transforms/TransformCache.js +0 -41
  616. package/dist/transforms/TransformCache.js.map +0 -1
  617. package/dist/transforms/conversions.d.ts +0 -63
  618. package/dist/transforms/conversions.js +0 -89
  619. package/dist/transforms/conversions.js.map +0 -1
  620. package/dist/transforms/index.d.ts +0 -2
  621. package/dist/transforms/index.js +0 -3
  622. package/dist/transforms/index.js.map +0 -1
  623. package/dist/transforms/transforms.d.ts +0 -241
  624. package/dist/transforms/transforms.js +0 -479
  625. package/dist/transforms/transforms.js.map +0 -1
  626. package/dist/types/types.d.ts +0 -757
  627. package/dist/types/types.js +0 -90
  628. package/dist/types/types.js.map +0 -1
  629. package/dist/utils/constants.d.ts +0 -80
  630. package/dist/utils/constants.js +0 -87
  631. package/dist/utils/constants.js.map +0 -1
  632. package/dist/utils/create-covariance-from-tle.d.ts +0 -18
  633. package/dist/utils/create-covariance-from-tle.js +0 -57
  634. package/dist/utils/create-covariance-from-tle.js.map +0 -1
  635. package/dist/utils/functions.d.ts +0 -236
  636. package/dist/utils/functions.js +0 -501
  637. package/dist/utils/functions.js.map +0 -1
  638. package/dist/utils/index.d.ts +0 -5
  639. package/dist/utils/index.js +0 -6
  640. package/dist/utils/index.js.map +0 -1
  641. package/dist/utils/jacobian.d.ts +0 -17
  642. package/dist/utils/jacobian.js +0 -34
  643. package/dist/utils/jacobian.js.map +0 -1
  644. package/dist/utils/linearDistance.d.ts +0 -8
  645. package/dist/utils/linearDistance.js +0 -10
  646. package/dist/utils/linearDistance.js.map +0 -1
  647. package/docs/README.md +0 -151
  648. package/docs/getting-started.md +0 -792
  649. package/docs/lambert-satellite-integration-guide.md +0 -766
  650. package/docs/user-guide.md +0 -1935
  651. package/jest.config.mjs +0 -29
  652. package/src/body/CelestialBody.ts +0 -316
  653. package/src/body/CelestialBodyType.ts +0 -55
  654. package/src/body/Earth.ts +0 -260
  655. package/src/body/EphemerisBody.ts +0 -349
  656. package/src/body/MoonBody.ts +0 -552
  657. package/src/body/NutationAngles.ts +0 -40
  658. package/src/body/PlanetBody.ts +0 -354
  659. package/src/body/PrecessionAngles.ts +0 -31
  660. package/src/body/SolarSystem.ts +0 -276
  661. package/src/body/SunBody.ts +0 -538
  662. package/src/body/__tests__/Earth.test.ts +0 -135
  663. package/src/body/__tests__/EphemerisBody.test.ts +0 -323
  664. package/src/body/__tests__/MoonBody.test.ts +0 -198
  665. package/src/body/__tests__/PlanetBody.test.ts +0 -257
  666. package/src/body/__tests__/SolarSystem.test.ts +0 -237
  667. package/src/body/__tests__/SunBody.test.ts +0 -227
  668. package/src/body/__tests__/__snapshots__/Earth.test.ts.snap +0 -39
  669. package/src/body/index.ts +0 -64
  670. package/src/body/suncalc.LICENSE.md +0 -18
  671. package/src/comm/Antenna.ts +0 -213
  672. package/src/comm/Beacon.ts +0 -328
  673. package/src/comm/CommTypes.ts +0 -216
  674. package/src/comm/CommunicationDevice.ts +0 -199
  675. package/src/comm/Receiver.ts +0 -263
  676. package/src/comm/Transmitter.ts +0 -349
  677. package/src/comm/Transponder.ts +0 -360
  678. package/src/comm/__tests__/Antenna.test.ts +0 -155
  679. package/src/comm/__tests__/Beacon.test.ts +0 -333
  680. package/src/comm/__tests__/CommTypes.test.ts +0 -165
  681. package/src/comm/__tests__/Receiver.test.ts +0 -215
  682. package/src/comm/__tests__/Transmitter.test.ts +0 -164
  683. package/src/comm/__tests__/Transponder.test.ts +0 -181
  684. package/src/comm/index.ts +0 -60
  685. package/src/conjunction/CatalogScreener.ts +0 -322
  686. package/src/conjunction/ConjunctionAssessment.ts +0 -410
  687. package/src/conjunction/ConjunctionEvent.ts +0 -185
  688. package/src/conjunction/CovarianceRealism.ts +0 -472
  689. package/src/conjunction/ProbabilityOfCollision.ts +0 -302
  690. package/src/conjunction/ScreeningFilter.ts +0 -206
  691. package/src/conjunction/__tests__/CatalogScreener.test.ts +0 -280
  692. package/src/conjunction/__tests__/ConjunctionAssessment.basic.test.ts +0 -250
  693. package/src/conjunction/__tests__/ConjunctionAssessment.highfidelity.test.ts +0 -76
  694. package/src/conjunction/__tests__/CovarianceRealism.test.ts +0 -296
  695. package/src/conjunction/index.ts +0 -35
  696. package/src/constellation/ConstellationGenerator.ts +0 -377
  697. package/src/constellation/__tests__/ConstellationGenerator.test.ts +0 -446
  698. package/src/constellation/index.ts +0 -18
  699. package/src/coordinate/ClassicalElements.ts +0 -394
  700. package/src/coordinate/EquinoctialElements.ts +0 -189
  701. package/src/coordinate/FormatTle.ts +0 -219
  702. package/src/coordinate/Geodetic.ts +0 -191
  703. package/src/coordinate/Hill.ts +0 -326
  704. package/src/coordinate/ITRF.ts +0 -146
  705. package/src/coordinate/J2000.ts +0 -130
  706. package/src/coordinate/README.md +0 -788
  707. package/src/coordinate/RIC.ts +0 -87
  708. package/src/coordinate/RelativeState.ts +0 -101
  709. package/src/coordinate/StateVector.ts +0 -128
  710. package/src/coordinate/TEME.ts +0 -97
  711. package/src/coordinate/Tle.ts +0 -1025
  712. package/src/coordinate/__tests__/ClassicalElements.test.ts +0 -129
  713. package/src/coordinate/__tests__/EquinoctialElements.test.ts +0 -108
  714. package/src/coordinate/__tests__/FormatTle.test.ts +0 -92
  715. package/src/coordinate/__tests__/Geodetic.test.ts +0 -165
  716. package/src/coordinate/__tests__/Hill.test.ts +0 -195
  717. package/src/coordinate/__tests__/ITRF.test.ts +0 -231
  718. package/src/coordinate/__tests__/J2000.test.ts +0 -132
  719. package/src/coordinate/__tests__/RIC.test.ts +0 -107
  720. package/src/coordinate/__tests__/TEME.test.ts +0 -48
  721. package/src/coordinate/__tests__/Tle.test.ts +0 -185
  722. package/src/coordinate/__tests__/__snapshots__/ClassicalElements.test.ts.snap +0 -106
  723. package/src/coordinate/__tests__/__snapshots__/EquinoctialElements.test.ts.snap +0 -93
  724. package/src/coordinate/__tests__/__snapshots__/Geodetic.test.ts.snap +0 -54
  725. package/src/coordinate/__tests__/__snapshots__/ITRF.test.ts.snap +0 -321
  726. package/src/coordinate/__tests__/__snapshots__/J2000.test.ts.snap +0 -26
  727. package/src/coordinate/__tests__/__snapshots__/RIC.test.ts.snap +0 -79
  728. package/src/coordinate/__tests__/__snapshots__/TEME.test.ts.snap +0 -41
  729. package/src/coordinate/__tests__/__snapshots__/Tle.test.ts.snap +0 -180
  730. package/src/coordinate/index.ts +0 -13
  731. package/src/coordinate/tle-format-data.ts +0 -47
  732. package/src/covariance/CovarianceSample.ts +0 -292
  733. package/src/covariance/StateCovariance.ts +0 -69
  734. package/src/covariance/__tests__/CovarianceSample.test.ts +0 -143
  735. package/src/covariance/__tests__/StateCovariance.test.ts +0 -90
  736. package/src/covariance/index.ts +0 -3
  737. package/src/data/DataHandler.ts +0 -88
  738. package/src/data/values/Egm96Data.ts +0 -75
  739. package/src/data/values/HpAtmosphereData.ts +0 -76
  740. package/src/data/values/HpAtmosphereResult.ts +0 -41
  741. package/src/data/values/Iau1980Data.ts +0 -63
  742. package/src/data/values/LeapSecond.ts +0 -37
  743. package/src/data/values/LeapSecondData.ts +0 -113
  744. package/src/data/values/__tests__/Egm96Data.test.ts +0 -33
  745. package/src/data/values/__tests__/HpAtmosphereData.test.ts +0 -82
  746. package/src/data/values/__tests__/LeapSecondData.test.ts +0 -59
  747. package/src/data/values/egm96.ts +0 -728
  748. package/src/data/values/hpAtmosphere.ts +0 -79
  749. package/src/data/values/iau1980.ts +0 -32
  750. package/src/enums/AngularDiameterMethod.ts +0 -28
  751. package/src/enums/AngularDistanceMethod.ts +0 -28
  752. package/src/enums/CatalogSource.ts +0 -10
  753. package/src/enums/CommLink.ts +0 -7
  754. package/src/enums/FovFrame.ts +0 -26
  755. package/src/enums/FovShape.ts +0 -26
  756. package/src/enums/OrbitRegime.ts +0 -31
  757. package/src/enums/PassType.ts +0 -29
  758. package/src/enums/SensorType.ts +0 -34
  759. package/src/enums/Sgp4OpsMode.ts +0 -27
  760. package/src/enums/index.ts +0 -11
  761. package/src/errors/__tests__/errors.test.ts +0 -196
  762. package/src/errors/index.ts +0 -185
  763. package/src/fetch/horizons-constants.ts +0 -53
  764. package/src/fetch/horizons-interfaces.ts +0 -38
  765. package/src/fetch/horizons.ts +0 -300
  766. package/src/fetch/index.ts +0 -26
  767. package/src/force/AtmosphericDrag.ts +0 -120
  768. package/src/force/EarthGravity.ts +0 -182
  769. package/src/force/Force.ts +0 -31
  770. package/src/force/ForceModel.ts +0 -99
  771. package/src/force/Gravity.ts +0 -53
  772. package/src/force/README.md +0 -99
  773. package/src/force/SolarRadiationPressure.ts +0 -43
  774. package/src/force/ThirdBodyGravity.ts +0 -64
  775. package/src/force/Thrust.ts +0 -83
  776. package/src/force/__tests__/AtmosphericDrag.test.ts +0 -168
  777. package/src/force/__tests__/EarthGravity.test.ts +0 -115
  778. package/src/force/__tests__/ForceModel.test.ts +0 -188
  779. package/src/force/__tests__/Gravity.test.ts +0 -81
  780. package/src/force/__tests__/SolarRadiationPressure.test.ts +0 -115
  781. package/src/force/__tests__/ThirdBodyGravity.test.ts +0 -119
  782. package/src/force/__tests__/Thrust.test.ts +0 -132
  783. package/src/force/index.ts +0 -9
  784. package/src/interfaces/BaseObjectParams.ts +0 -32
  785. package/src/interfaces/ClassicalElementsParams.ts +0 -35
  786. package/src/interfaces/EquinoctialElementsParams.ts +0 -37
  787. package/src/interfaces/GroundPositionParams.ts +0 -30
  788. package/src/interfaces/OmmFormat.ts +0 -63
  789. package/src/interfaces/OptionsParams.ts +0 -3
  790. package/src/interfaces/SatelliteParams.ts +0 -57
  791. package/src/interfaces/StarObjectParams.ts +0 -11
  792. package/src/interfaces/TimeVariables.ts +0 -7
  793. package/src/interfaces/index.ts +0 -8
  794. package/src/interpolator/ChebyshevCoefficients.ts +0 -109
  795. package/src/interpolator/ChebyshevInterpolator.ts +0 -87
  796. package/src/interpolator/CubicSpline.ts +0 -72
  797. package/src/interpolator/CubicSplineInterpolator.ts +0 -90
  798. package/src/interpolator/FieldInterpolator.ts +0 -35
  799. package/src/interpolator/Interpolator.ts +0 -56
  800. package/src/interpolator/LagrangeInterpolator.ts +0 -192
  801. package/src/interpolator/StateInterpolator.ts +0 -37
  802. package/src/interpolator/VerletBlendInterpolator.ts +0 -146
  803. package/src/interpolator/__tests__/ChebyshevCoefficients.test.ts +0 -105
  804. package/src/interpolator/__tests__/ChebyshevInterpolator.test.ts +0 -81
  805. package/src/interpolator/__tests__/CubicSpline.test.ts +0 -80
  806. package/src/interpolator/__tests__/CubicSplineInterpolator.test.ts +0 -94
  807. package/src/interpolator/__tests__/FieldInterpolator.test.ts +0 -59
  808. package/src/interpolator/__tests__/Interpolator.test.ts +0 -131
  809. package/src/interpolator/__tests__/LagrangeInterpolator.test.ts +0 -121
  810. package/src/interpolator/__tests__/StateInterpolator.test.ts +0 -57
  811. package/src/interpolator/__tests__/VerletBlendInterpolator.test.ts +0 -116
  812. package/src/interpolator/index.ts +0 -32
  813. package/src/main.ts +0 -87
  814. package/src/maneuver/TwoBurnOrbitTransfer.ts +0 -79
  815. package/src/maneuver/Waypoint.ts +0 -267
  816. package/src/maneuver/__tests__/TwoBurnOrbitTransfer.test.ts +0 -90
  817. package/src/maneuver/__tests__/Waypoint.test.ts +0 -427
  818. package/src/maneuver/index.ts +0 -25
  819. package/src/objects/AccessCalculator.ts +0 -345
  820. package/src/objects/AccessWindow.ts +0 -129
  821. package/src/objects/BaseObject.ts +0 -242
  822. package/src/objects/CenterBody.ts +0 -88
  823. package/src/objects/DynamicGroundObject.ts +0 -975
  824. package/src/objects/EphemerisSatellite.ts +0 -629
  825. package/src/objects/GroundObject.ts +0 -246
  826. package/src/objects/GroundStation.ts +0 -130
  827. package/src/objects/History.ts +0 -228
  828. package/src/objects/InterpolatorType.ts +0 -42
  829. package/src/objects/LandObject.ts +0 -62
  830. package/src/objects/Marker.ts +0 -32
  831. package/src/objects/ObjectTypes.ts +0 -66
  832. package/src/objects/Satellite.ts +0 -1013
  833. package/src/objects/SpaceObject.ts +0 -304
  834. package/src/objects/Star.ts +0 -135
  835. package/src/objects/VisualizationHelpers.ts +0 -324
  836. package/src/objects/__tests__/AccessCalculator.test.ts +0 -499
  837. package/src/objects/__tests__/DynamicGroundObject.test.ts +0 -859
  838. package/src/objects/__tests__/EphemerisSatellite.test.ts +0 -589
  839. package/src/objects/__tests__/GroundStation.test.ts +0 -204
  840. package/src/objects/__tests__/Satellite.test.ts +0 -487
  841. package/src/objects/__tests__/SpaceObject.rae.test.ts +0 -156
  842. package/src/objects/__tests__/VisualizationHelpers.test.ts +0 -438
  843. package/src/objects/index.ts +0 -31
  844. package/src/observation/Observation.ts +0 -113
  845. package/src/observation/ObservationOptical.ts +0 -146
  846. package/src/observation/ObservationRadar.ts +0 -135
  847. package/src/observation/ObservationUtils.ts +0 -69
  848. package/src/observation/PropagatorPairs.ts +0 -45
  849. package/src/observation/RAE.ts +0 -261
  850. package/src/observation/RadecGeocentric.ts +0 -206
  851. package/src/observation/RadecTopocentric.ts +0 -247
  852. package/src/observation/__tests__/RAE.test.ts +0 -135
  853. package/src/observation/__tests__/RadecGeocentric.test.ts +0 -107
  854. package/src/observation/__tests__/RadecTopocentric.test.ts +0 -121
  855. package/src/observation/__tests__/__snapshots__/RAE.test.ts.snap +0 -91
  856. package/src/observation/__tests__/__snapshots__/RadecGeocentric.test.ts.snap +0 -71
  857. package/src/observation/__tests__/__snapshots__/RadecTopocentric.test.ts.snap +0 -71
  858. package/src/observation/index.ts +0 -28
  859. package/src/operations/BoxMuller.ts +0 -87
  860. package/src/operations/EulerAngles.ts +0 -183
  861. package/src/operations/Matrix.ts +0 -473
  862. package/src/operations/Quaternion.ts +0 -222
  863. package/src/operations/Random.ts +0 -54
  864. package/src/operations/RandomGaussianSource.ts +0 -51
  865. package/src/operations/Vector.ts +0 -484
  866. package/src/operations/Vector3D.ts +0 -272
  867. package/src/operations/__tests__/Matrix.test.ts +0 -277
  868. package/src/operations/__tests__/Random.test.ts +0 -24
  869. package/src/operations/__tests__/Vector.test.ts +0 -269
  870. package/src/operations/__tests__/Vector3D.test.ts +0 -100
  871. package/src/operations/__tests__/__snapshots__/Matrix.test.ts.snap +0 -161
  872. package/src/operations/__tests__/__snapshots__/Random.test.ts.snap +0 -7
  873. package/src/operations/__tests__/__snapshots__/Vector.test.ts.snap +0 -218
  874. package/src/operations/__tests__/__snapshots__/Vector3D.test.ts.snap +0 -138
  875. package/src/operations/index.ts +0 -5
  876. package/src/operations/operations.ts +0 -28
  877. package/src/optimize/ChebyshevCompressor.ts +0 -141
  878. package/src/optimize/DownhillSimplex.ts +0 -246
  879. package/src/optimize/GoldenSection.ts +0 -230
  880. package/src/optimize/PolynomialRegression.ts +0 -211
  881. package/src/optimize/README.md +0 -343
  882. package/src/optimize/SimpleLinearRegression.ts +0 -227
  883. package/src/optimize/__tests__/ChebyshevCompressor.test.ts +0 -40
  884. package/src/optimize/__tests__/DownhillSimplex.test.ts +0 -168
  885. package/src/optimize/__tests__/GoldenSection.test.ts +0 -21
  886. package/src/optimize/__tests__/PolynomialRegression.test.ts +0 -24
  887. package/src/optimize/__tests__/SimpleLinearRegression.test.ts +0 -31
  888. package/src/optimize/index.ts +0 -6
  889. package/src/optimize/internal/PolynomicalRegressionResult.ts +0 -126
  890. package/src/optimize/internal/SimplexEntry.ts +0 -169
  891. package/src/orbit-design/RepeatGroundTrack.ts +0 -516
  892. package/src/orbit-design/__tests__/RepeatGroundTrack.test.ts +0 -526
  893. package/src/orbit-design/index.ts +0 -23
  894. package/src/orbit-determination/BatchLeastSquaresOD.ts +0 -174
  895. package/src/orbit-determination/BatchLeastSquaresResult.ts +0 -33
  896. package/src/orbit-determination/GaussIOD.ts +0 -396
  897. package/src/orbit-determination/GibbsIOD.ts +0 -98
  898. package/src/orbit-determination/GoodingIOD.ts +0 -680
  899. package/src/orbit-determination/HerrickGibbsIOD.ts +0 -51
  900. package/src/orbit-determination/LambertIOD.ts +0 -260
  901. package/src/orbit-determination/LevenbergMarquardtOD.ts +0 -258
  902. package/src/orbit-determination/LevenbergMarquardtResult.ts +0 -42
  903. package/src/orbit-determination/ModifiedGoodingIOD.test.ts +0 -86
  904. package/src/orbit-determination/ModifiedGoodingIOD.ts +0 -145
  905. package/src/orbit-determination/README.md +0 -353
  906. package/src/orbit-determination/__tests__/BatchLeastSquaresOD.accuracy.test.ts +0 -320
  907. package/src/orbit-determination/__tests__/BatchLeastSquaresOD.observations.test.ts +0 -279
  908. package/src/orbit-determination/__tests__/BatchLeastSquaresOD.robustness.test.ts +0 -439
  909. package/src/orbit-determination/__tests__/GaussIOD.test.ts +0 -395
  910. package/src/orbit-determination/__tests__/GibbsIOD.test.ts +0 -423
  911. package/src/orbit-determination/__tests__/GoodingIOD.test.ts +0 -356
  912. package/src/orbit-determination/__tests__/HerrickGibbsIOD.test.ts +0 -501
  913. package/src/orbit-determination/__tests__/LambertIOD.test.ts +0 -643
  914. package/src/orbit-determination/__tests__/LevenbergMarquardtOD.test.ts +0 -1039
  915. package/src/orbit-determination/index.ts +0 -10
  916. package/src/parsers/CdmExporter.ts +0 -298
  917. package/src/parsers/CdmParser.ts +0 -474
  918. package/src/parsers/CdmTypes.ts +0 -259
  919. package/src/parsers/HorizonsParser.ts +0 -432
  920. package/src/parsers/OemParser.ts +0 -277
  921. package/src/parsers/OemTypes.ts +0 -111
  922. package/src/parsers/__tests__/CdmExporter.test.ts +0 -305
  923. package/src/parsers/__tests__/CdmParser.test.ts +0 -305
  924. package/src/parsers/__tests__/HorizonsParser.test.ts +0 -126
  925. package/src/parsers/__tests__/OemParser.test.ts +0 -398
  926. package/src/parsers/index.ts +0 -49
  927. package/src/propagator/DormandPrince54Propagator.ts +0 -73
  928. package/src/propagator/KeplerPropagator.ts +0 -101
  929. package/src/propagator/Propagator.ts +0 -253
  930. package/src/propagator/README.md +0 -241
  931. package/src/propagator/RkCheckpoint.ts +0 -25
  932. package/src/propagator/RkResult.ts +0 -26
  933. package/src/propagator/RungeKutta4Propagator.ts +0 -179
  934. package/src/propagator/RungeKutta89Propagator.ts +0 -132
  935. package/src/propagator/RungeKuttaAdaptive.ts +0 -282
  936. package/src/propagator/Sgp4Propagator.ts +0 -111
  937. package/src/propagator/__tests__/KeplerPropagator.test.ts +0 -250
  938. package/src/propagator/__tests__/Propagator.test.ts +0 -180
  939. package/src/propagator/__tests__/RungeKutta4Propagator.test.ts +0 -289
  940. package/src/propagator/__tests__/RungeKuttaAdaptive.test.ts +0 -244
  941. package/src/propagator/__tests__/Sgp4Propagator.test.ts +0 -144
  942. package/src/propagator/index.ts +0 -10
  943. package/src/scheduling/ContactScheduler.ts +0 -760
  944. package/src/scheduling/ScheduledContact.ts +0 -249
  945. package/src/scheduling/__tests__/ContactScheduler.test.ts +0 -389
  946. package/src/scheduling/__tests__/ScheduledContact.test.ts +0 -293
  947. package/src/scheduling/index.ts +0 -10
  948. package/src/sensor/FieldOfView.ts +0 -666
  949. package/src/sensor/LaserRangingSensor.ts +0 -210
  950. package/src/sensor/MechanicalRadar.ts +0 -156
  951. package/src/sensor/OpticalSensor.ts +0 -198
  952. package/src/sensor/PassiveRFSensor.ts +0 -205
  953. package/src/sensor/PhasedArrayRadar.ts +0 -352
  954. package/src/sensor/RadarSensor.ts +0 -150
  955. package/src/sensor/Sensor.ts +0 -487
  956. package/src/sensor/__tests__/Sensor.test.ts +0 -135
  957. package/src/sensor/index.ts +0 -81
  958. package/src/sensor/v2-docs/field-of-view-design-document.md +0 -466
  959. package/src/sgp4/index.ts +0 -27
  960. package/src/sgp4/sgp4-error.ts +0 -53
  961. package/src/sgp4/sgp4.LICENSE.md +0 -28
  962. package/src/sgp4/sgp4.ts +0 -3983
  963. package/src/smoothing/ExponentialSmoothing.ts +0 -83
  964. package/src/smoothing/__tests__/ExponentialSmoothing.test.ts +0 -108
  965. package/src/time/Epoch.ts +0 -165
  966. package/src/time/EpochGPS.ts +0 -141
  967. package/src/time/EpochTAI.ts +0 -63
  968. package/src/time/EpochTDB.ts +0 -73
  969. package/src/time/EpochTT.ts +0 -76
  970. package/src/time/EpochUTC.ts +0 -253
  971. package/src/time/EpochWindow.ts +0 -33
  972. package/src/time/README.md +0 -212
  973. package/src/time/TimeStamped.ts +0 -80
  974. package/src/time/__tests__/Epoch.test.ts +0 -250
  975. package/src/time/__tests__/EpochGPS.test.ts +0 -78
  976. package/src/time/__tests__/EpochUTC.test.ts +0 -149
  977. package/src/time/__tests__/EpochWindow.test.ts +0 -30
  978. package/src/time/__tests__/TimeStamped.test.ts +0 -62
  979. package/src/time/__tests__/__snapshots__/Epoch.test.ts.snap +0 -46
  980. package/src/time/__tests__/__snapshots__/EpochGPS.test.ts.snap +0 -13
  981. package/src/time/__tests__/__snapshots__/EpochUTC.test.ts.snap +0 -112
  982. package/src/time/__tests__/__snapshots__/TimeStamped.test.ts.snap +0 -10
  983. package/src/time/index.ts +0 -9
  984. package/src/transforms/TransformCache.ts +0 -46
  985. package/src/transforms/__tests__/__snapshots__/transforms.test.ts.snap +0 -16
  986. package/src/transforms/__tests__/__snapshots__/transforms2.test.ts.snap +0 -49
  987. package/src/transforms/__tests__/conversions.test.ts +0 -80
  988. package/src/transforms/__tests__/transforms.test.ts +0 -128
  989. package/src/transforms/__tests__/transforms2.test.ts +0 -275
  990. package/src/transforms/__tests__/transformsData.ts +0 -289
  991. package/src/transforms/conversions.ts +0 -99
  992. package/src/transforms/index.ts +0 -3
  993. package/src/transforms/transforms.ts +0 -614
  994. package/src/types/types.ts +0 -829
  995. package/src/utils/__tests__/__snapshots__/functions.test.ts.snap +0 -89
  996. package/src/utils/__tests__/__snapshots__/utils.test.ts.snap +0 -5
  997. package/src/utils/__tests__/create-covariance-from-tle.test.ts +0 -90
  998. package/src/utils/__tests__/functions.test.ts +0 -450
  999. package/src/utils/__tests__/jacobian.test.ts +0 -37
  1000. package/src/utils/__tests__/linearDistance.test.ts +0 -44
  1001. package/src/utils/__tests__/utils.test.ts +0 -164
  1002. package/src/utils/constants.ts +0 -113
  1003. package/src/utils/create-covariance-from-tle.ts +0 -75
  1004. package/src/utils/functions.ts +0 -590
  1005. package/src/utils/index.ts +0 -6
  1006. package/src/utils/jacobian.ts +0 -42
  1007. package/src/utils/linearDistance.ts +0 -11
  1008. /package/{LICENSE.md → LICENSE.MD} +0 -0
@@ -1,1935 +0,0 @@
1
- # OOTK User Guide
2
-
3
- **Orbital Object Toolkit (ootk)** - Comprehensive Documentation
4
-
5
- Version: 5.1.1
6
-
7
- ---
8
-
9
- ## Table of Contents
10
-
11
- 1. [Introduction](#introduction)
12
- 2. [Core Concepts](#core-concepts)
13
- 3. [Satellite Operations](#satellite-operations)
14
- 4. [Sensor Operations](#sensor-operations)
15
- 5. [Coordinate Systems](#coordinate-systems)
16
- 6. [Orbit Propagation](#orbit-propagation)
17
- 7. [Force Models](#force-models)
18
- 8. [Initial Orbit Determination](#initial-orbit-determination)
19
- 9. [Observations](#observations)
20
- 10. [Time Systems](#time-systems)
21
- 11. [Interpolation](#interpolation)
22
- 12. [Mathematical Operations](#mathematical-operations)
23
- 13. [Optimization](#optimization)
24
- 14. [Covariance](#covariance)
25
- 15. [Celestial Bodies](#celestial-bodies)
26
- 16. [Maneuvers](#maneuvers)
27
- 17. [Advanced Topics](#advanced-topics)
28
-
29
- ---
30
-
31
- ## Introduction
32
-
33
- OOTK is a comprehensive TypeScript/JavaScript library for orbital mechanics calculations. Originally developed for the [KeepTrack](https://github.com/thkruz/keeptrack.space) satellite tracking application, it provides a complete toolkit for working with satellites, orbital objects, sensors, and celestial mechanics.
34
-
35
- ### What Can OOTK Do?
36
-
37
- - **Satellite Tracking**: Parse TLE data and propagate satellite positions using SGP4 or numerical integrators
38
- - **Sensor Operations**: Calculate visibility, field-of-view, and predict satellite passes
39
- - **Orbit Determination**: Determine orbits from observations using multiple IOD methods
40
- - **Coordinate Transformations**: Convert between ECI, ECF, geodetic, and other coordinate systems
41
- - **High-Precision Propagation**: Model perturbations including gravity harmonics, third-body effects, solar radiation pressure, and atmospheric drag
42
- - **Mission Planning**: Calculate orbital maneuvers, transfers, and delta-v requirements
43
- - **Time Systems**: Handle multiple time systems (UTC, TAI, TT, GPS, TDB) with conversions
44
-
45
- ### Key Features
46
-
47
- - **Type-Safe**: Written in TypeScript with comprehensive type definitions
48
- - **Unit Types**: Distinct types for Degrees, Radians, Kilometers, Meters, etc.
49
- - **Multiple Propagators**: SGP4, Kepler, Runge-Kutta (4th, 8/9th order), Dormand-Prince
50
- - **Coordinate Systems**: J2000, TEME, ITRF, Geodetic, RIC, Hill, and more
51
- - **Browser & Node.js**: Works in both environments
52
-
53
- ---
54
-
55
- ## Core Concepts
56
-
57
- ### Type Safety with Units
58
-
59
- OOTK uses TypeScript's type system to enforce unit safety:
60
-
61
- ```typescript
62
- import { Degrees, Radians, Kilometers, Meters } from 'ootk';
63
-
64
- // Type-safe units prevent mixing incompatible values
65
- const latitude = 41.754785 as Degrees;
66
- const altitude = 0.060966 as Kilometers;
67
-
68
- // Compilation error if you try to mix units incorrectly
69
- // const wrong = latitude + altitude; // Error!
70
- ```
71
-
72
- **Available Unit Types:**
73
- - **Angular**: `Degrees`, `Radians`
74
- - **Distance**: `Kilometers`, `Meters`
75
- - **Time**: `Seconds`, `Minutes`, `Hours`, `Days`
76
- - **Velocity**: `KilometersPerSecond`, `MetersPerSecond`
77
- - **Angular Velocity**: `RadiansPerSecond`
78
-
79
- ### Vector Types
80
-
81
- OOTK provides specialized vector types for different coordinate systems:
82
-
83
- ```typescript
84
- import { EciVec3, EcfVec3, LlaVec3, RaeVec3 } from 'ootk';
85
-
86
- // ECI (Earth-Centered Inertial) vector
87
- const eciPos: EciVec3 = { x: 6778.137, y: 0, z: 0 } as EciVec3<Kilometers>;
88
-
89
- // Geodetic coordinates
90
- const lla: LlaVec3 = {
91
- lat: 41.754785 as Degrees,
92
- lon: -70.539151 as Degrees,
93
- alt: 0.060966 as Kilometers
94
- };
95
-
96
- // Range, Azimuth, Elevation
97
- const rae: RaeVec3 = {
98
- rng: 1000 as Kilometers,
99
- az: 180 as Degrees,
100
- el: 45 as Degrees
101
- };
102
- ```
103
-
104
- ### Enumerations
105
-
106
- Type-safe enums for common values:
107
-
108
- ```typescript
109
- import { OrbitRegime, SpaceObjectType, Sgp4OpsMode } from 'ootk';
110
-
111
- const regime = OrbitRegime.LEO; // LEO, MEO, GEO, VHEO, DEEP
112
- const type = SpaceObjectType.PAYLOAD;
113
- const opsMode = Sgp4OpsMode.AFSPC; // AFSPC or IMPROVED
114
- ```
115
-
116
- ---
117
-
118
- ## Satellite Operations
119
-
120
- ### Creating Satellites
121
-
122
- #### From TLE (Two-Line Elements)
123
-
124
- ```typescript
125
- import { Satellite, TleLine1, TleLine2 } from 'ootk';
126
-
127
- const satellite = new Satellite({
128
- tle1: '1 25544U 98067A 24028.54545847 .00031576 00000-0 57240-3 0 9991' as TleLine1,
129
- tle2: '2 25544 51.6418 292.2590 0002595 167.5319 252.0460 15.49326324436741' as TleLine2
130
- });
131
- ```
132
-
133
- #### From Orbital Elements
134
-
135
- ```typescript
136
- import { Satellite, ClassicalElements, Degrees, Kilometers } from 'ootk';
137
-
138
- const elements = new ClassicalElements({
139
- epoch: EpochUTC.fromDateTime(new Date()),
140
- semimajorAxis: 6778.137 as Kilometers,
141
- eccentricity: 0.001,
142
- inclination: 51.6418 as Degrees,
143
- rightAscension: 292.259 as Degrees,
144
- argOfPerigee: 167.5319 as Degrees,
145
- trueAnomaly: 252.046 as Degrees
146
- });
147
-
148
- const tle = elements.toTLE({
149
- intlDes: '98067A',
150
- epochYear: 24,
151
- epochDay: 28.54545847
152
- });
153
-
154
- const satellite = new Satellite({ tle1: tle.line1, tle2: tle.line2 });
155
- ```
156
-
157
- #### DetailedSatellite
158
-
159
- For additional metadata:
160
-
161
- ```typescript
162
- import { DetailedSatellite } from 'ootk';
163
-
164
- const satellite = new DetailedSatellite({
165
- tle1: line1,
166
- tle2: line2,
167
- id: 25544,
168
- name: 'ISS (ZARYA)',
169
- country: 'US',
170
- launchDate: new Date('1998-11-20'),
171
- mass: 419700, // kg
172
- shape: 'Composite',
173
- period: 92.91, // minutes
174
- apogee: 422.7, // km
175
- perigee: 418.9 // km
176
- });
177
- ```
178
-
179
- ### Getting Satellite Position
180
-
181
- #### ECI (Earth-Centered Inertial)
182
-
183
- ```typescript
184
- // Current time
185
- const eci = satellite.eci();
186
- console.log(eci.position); // { x, y, z } in km
187
- console.log(eci.velocity); // { x, y, z } in km/s
188
-
189
- // Specific time
190
- const date = new Date('2024-01-28T12:00:00Z');
191
- const eciAtTime = satellite.eci(date);
192
- ```
193
-
194
- #### Geodetic (Latitude/Longitude/Altitude)
195
-
196
- ```typescript
197
- const lla = satellite.lla();
198
- console.log(lla.lat); // Latitude in degrees
199
- console.log(lla.lon); // Longitude in degrees
200
- console.log(lla.alt); // Altitude in kilometers
201
- ```
202
-
203
- #### ECF (Earth-Centered Fixed)
204
-
205
- ```typescript
206
- const ecf = satellite.ecf();
207
- console.log(ecf.position); // { x, y, z } in Earth-fixed frame
208
- ```
209
-
210
- ### Orbital Parameters
211
-
212
- Access Keplerian orbital elements:
213
-
214
- ```typescript
215
- console.log(satellite.inclination); // Degrees
216
- console.log(satellite.eccentricity); // 0-1
217
- console.log(satellite.period); // Minutes
218
- console.log(satellite.apogee); // Kilometers
219
- console.log(satellite.perigee); // Kilometers
220
- console.log(satellite.semiMajorAxis); // Kilometers
221
- console.log(satellite.semiMinorAxis); // Kilometers
222
- console.log(satellite.rightAscension); // Degrees
223
- console.log(satellite.argOfPerigee); // Degrees
224
- console.log(satellite.meanMotion); // Revolutions per day
225
- ```
226
-
227
- ### Coordinate Conversions
228
-
229
- ```typescript
230
- // Convert to J2000 coordinate system
231
- const j2000 = satellite.toJ2000(date);
232
- console.log(j2000.position);
233
- console.log(j2000.velocity);
234
-
235
- // Convert to ITRF (Earth-fixed)
236
- const itrf = satellite.toITRF(date);
237
-
238
- // Get classical orbital elements
239
- const elements = satellite.getClassicalElements();
240
- ```
241
-
242
- ### Satellite Visibility
243
-
244
- ```typescript
245
- // Check if satellite is in sunlight
246
- const inSunlight = satellite.isInSunlight(date);
247
-
248
- // Get illumination (0 = shadowed, 1 = fully illuminated)
249
- const illumination = satellite.getIllumination(date);
250
- ```
251
-
252
- ---
253
-
254
- ## Sensor Operations
255
-
256
- ### Creating Sensors
257
-
258
- #### Basic Sensor
259
-
260
- ```typescript
261
- import { Sensor, Degrees, Kilometers } from 'ootk';
262
-
263
- const sensor = new Sensor({
264
- lat: 41.754785 as Degrees,
265
- lon: -70.539151 as Degrees,
266
- alt: 0.060966 as Kilometers,
267
- minEl: 3 as Degrees, // Minimum elevation angle
268
- maxEl: 85 as Degrees, // Maximum elevation angle
269
- minRng: 0 as Kilometers, // Minimum range
270
- maxRng: 5556 as Kilometers // Maximum range
271
- });
272
- ```
273
-
274
- #### DetailedSensor
275
-
276
- For ground stations with additional metadata:
277
-
278
- ```typescript
279
- import { DetailedSensor, SpaceObjectType } from 'ootk';
280
-
281
- const sensor = new DetailedSensor({
282
- lat: 41.754785 as Degrees,
283
- lon: -70.539151 as Degrees,
284
- alt: 0.060966 as Kilometers,
285
- minAz: 347 as Degrees,
286
- maxAz: 227 as Degrees,
287
- minEl: 3 as Degrees,
288
- maxEl: 85 as Degrees,
289
- minRng: 0 as Kilometers,
290
- maxRng: 5556 as Kilometers,
291
- name: 'Cape Cod Space Force Station',
292
- type: SpaceObjectType.PHASED_ARRAY_RADAR,
293
- country: 'United States',
294
- freqBand: 'UHF',
295
- operator: 'USSF'
296
- });
297
- ```
298
-
299
- #### RF Sensor
300
-
301
- For RF sensors with phased array capabilities:
302
-
303
- ```typescript
304
- import { RfSensor } from 'ootk';
305
-
306
- const rfSensor = new RfSensor({
307
- lat: 41.754785 as Degrees,
308
- lon: -70.539151 as Degrees,
309
- alt: 0.060966 as Kilometers,
310
- minEl: 3 as Degrees,
311
- maxEl: 85 as Degrees,
312
- beamwidth: 2 as Degrees, // Antenna beamwidth
313
- frequency: 420 // MHz
314
- });
315
- ```
316
-
317
- ### Range, Azimuth, Elevation (RAE)
318
-
319
- Calculate look angles from sensor to satellite:
320
-
321
- ```typescript
322
- const rae = sensor.rae(satellite);
323
-
324
- console.log(rae.rng); // Range in kilometers
325
- console.log(rae.az); // Azimuth in degrees (0-360)
326
- console.log(rae.el); // Elevation in degrees (-90 to 90)
327
- console.log(rae.rngRate); // Range rate (km/s)
328
-
329
- // At a specific time
330
- const raeAtTime = sensor.rae(satellite, date);
331
- ```
332
-
333
- ### Field of View
334
-
335
- Check if satellite is visible:
336
-
337
- ```typescript
338
- // Check if satellite is in sensor's field of view
339
- const isVisible = sensor.isSatInFov(satellite);
340
- console.log(isVisible); // true or false
341
-
342
- // At a specific time
343
- const isVisibleAtTime = sensor.isSatInFov(satellite, date);
344
- ```
345
-
346
- ### Pass Predictions
347
-
348
- Calculate when satellite will be visible:
349
-
350
- ```typescript
351
- // Calculate passes over next 7 days in 30-second intervals
352
- const passes = sensor.calculatePasses(30, satellite, {
353
- startDate: new Date(),
354
- lengthDays: 7
355
- });
356
-
357
- passes.forEach(pass => {
358
- console.log('Rise time:', pass.rise);
359
- console.log('Culmination time:', pass.culmination);
360
- console.log('Set time:', pass.set);
361
- console.log('Max elevation:', pass.maxEl);
362
- console.log('Duration:', pass.duration); // seconds
363
- });
364
- ```
365
-
366
- ### Sensor Position in ECI
367
-
368
- ```typescript
369
- // Get sensor position in J2000 ECI coordinates
370
- const j2000 = sensor.toJ2000();
371
- console.log(j2000.position);
372
-
373
- // At a specific time
374
- const j2000AtTime = sensor.toJ2000(date);
375
- ```
376
-
377
- ---
378
-
379
- ## Coordinate Systems
380
-
381
- OOTK supports multiple coordinate systems with easy conversions between them.
382
-
383
- ### Earth-Centered Inertial (ECI)
384
-
385
- #### J2000
386
-
387
- Standard inertial frame at epoch J2000.0:
388
-
389
- ```typescript
390
- import { J2000, Kilometers, KilometersPerSecond } from 'ootk';
391
-
392
- const j2000 = new J2000(
393
- epoch,
394
- { x: 6778.137, y: 0, z: 0 } as EciVec3<Kilometers>,
395
- { x: 0, y: 7.67, z: 0 } as EciVec3<KilometersPerSecond>
396
- );
397
-
398
- // Convert to other frames
399
- const teme = j2000.toTEME();
400
- const itrf = j2000.toITRF();
401
- ```
402
-
403
- #### TEME (True Equator Mean Equinox)
404
-
405
- Used by SGP4 propagator:
406
-
407
- ```typescript
408
- import { TEME } from 'ootk';
409
-
410
- const teme = new TEME(epoch, position, velocity);
411
-
412
- // Convert to J2000
413
- const j2000 = teme.toJ2000();
414
- ```
415
-
416
- ### Earth-Centered Fixed (ECF)
417
-
418
- #### ITRF (International Terrestrial Reference Frame)
419
-
420
- Earth-fixed frame that rotates with Earth:
421
-
422
- ```typescript
423
- import { ITRF } from 'ootk';
424
-
425
- const itrf = new ITRF(epoch, position, velocity);
426
-
427
- // Convert to inertial
428
- const j2000 = itrf.toJ2000();
429
- ```
430
-
431
- ### Geodetic Coordinates
432
-
433
- Latitude, Longitude, Altitude:
434
-
435
- ```typescript
436
- import { Geodetic } from 'ootk';
437
-
438
- const geodetic = new Geodetic(
439
- 41.754785 as Degrees,
440
- -70.539151 as Degrees,
441
- 0.060966 as Kilometers
442
- );
443
-
444
- // Convert to ECF
445
- const itrf = geodetic.toITRF();
446
-
447
- // Convert to ECI
448
- const j2000 = geodetic.toJ2000(epoch);
449
- ```
450
-
451
- ### Classical Orbital Elements
452
-
453
- ```typescript
454
- import { ClassicalElements } from 'ootk';
455
-
456
- const elements = new ClassicalElements({
457
- epoch: epoch,
458
- semimajorAxis: 6778.137 as Kilometers,
459
- eccentricity: 0.001,
460
- inclination: 51.6418 as Degrees,
461
- rightAscension: 292.259 as Degrees,
462
- argOfPerigee: 167.5319 as Degrees,
463
- trueAnomaly: 252.046 as Degrees
464
- });
465
-
466
- // Convert to position/velocity
467
- const pv = elements.toPositionVelocity();
468
-
469
- // Generate TLE
470
- const tle = elements.toTLE({
471
- intlDes: '98067A',
472
- epochYear: 24,
473
- epochDay: 28.54545847
474
- });
475
- ```
476
-
477
- ### Equinoctial Elements
478
-
479
- Non-singular orbital elements:
480
-
481
- ```typescript
482
- import { EquinoctialElements } from 'ootk';
483
-
484
- const equinoctial = new EquinoctialElements(
485
- epoch,
486
- a, // semi-major axis
487
- h, // h = e * sin(ω + Ω)
488
- k, // k = e * cos(ω + Ω)
489
- p, // p = tan(i/2) * sin(Ω)
490
- q, // q = tan(i/2) * cos(Ω)
491
- λ // mean longitude
492
- );
493
-
494
- // Convert to classical elements
495
- const classical = equinoctial.toClassicalElements();
496
- ```
497
-
498
- ### Relative Frames
499
-
500
- #### RIC (Radial-In-track-Cross-track)
501
-
502
- ```typescript
503
- import { RIC } from 'ootk';
504
-
505
- // Create RIC frame relative to a reference satellite
506
- const ric = RIC.fromJ2000(referenceState, targetState);
507
-
508
- console.log(ric.position.x); // Radial component
509
- console.log(ric.position.y); // In-track component
510
- console.log(ric.position.z); // Cross-track component
511
- ```
512
-
513
- #### Hill Frame
514
-
515
- Similar to RIC but with different conventions:
516
-
517
- ```typescript
518
- import { Hill } from 'ootk';
519
-
520
- const hill = Hill.fromJ2000(referenceState, targetState);
521
- ```
522
-
523
- ### TLE (Two-Line Element)
524
-
525
- Parse and create TLE data:
526
-
527
- ```typescript
528
- import { Tle } from 'ootk';
529
-
530
- // Parse existing TLE
531
- const tle = new Tle(line1, line2);
532
- console.log(tle.inclination);
533
- console.log(tle.eccentricity);
534
- console.log(tle.meanMotion);
535
-
536
- // Create from classical elements
537
- const newTle = ClassicalElements.toTLE(elements, metadata);
538
- ```
539
-
540
- ---
541
-
542
- ## Orbit Propagation
543
-
544
- ### SGP4 Propagator
545
-
546
- Standard propagator for TLE data:
547
-
548
- ```typescript
549
- import { Satellite, Sgp4Propagator, EpochUTC } from 'ootk';
550
-
551
- const satellite = new Satellite({ tle1, tle2 });
552
- const propagator = new Sgp4Propagator(satellite);
553
-
554
- // Propagate to a specific time
555
- const futureEpoch = EpochUTC.fromDateTime(new Date('2024-12-31'));
556
- const state = propagator.propagate(futureEpoch);
557
-
558
- console.log(state.position); // TEME coordinates
559
- console.log(state.velocity);
560
- ```
561
-
562
- **SGP4 Operation Modes:**
563
-
564
- ```typescript
565
- import { Sgp4OpsMode } from 'ootk';
566
-
567
- // AFSPC mode (original)
568
- const propagatorAFSPC = new Sgp4Propagator(satellite, Sgp4OpsMode.AFSPC);
569
-
570
- // Improved mode (recommended)
571
- const propagatorImproved = new Sgp4Propagator(satellite, Sgp4OpsMode.IMPROVED);
572
- ```
573
-
574
- ### Kepler Propagator
575
-
576
- Simple two-body propagation (fastest, least accurate):
577
-
578
- ```typescript
579
- import { KeplerPropagator } from 'ootk';
580
-
581
- const initialState = satellite.toJ2000();
582
- const propagator = new KeplerPropagator(initialState);
583
-
584
- const futureState = propagator.propagate(futureEpoch);
585
- ```
586
-
587
- ### Runge-Kutta 4 Propagator
588
-
589
- 4th-order Runge-Kutta numerical integration:
590
-
591
- ```typescript
592
- import { RungeKutta4Propagator, ForceModel } from 'ootk';
593
-
594
- const forceModel = new ForceModel();
595
- forceModel.setEarthGravity(4, 4); // 4x4 gravity field
596
-
597
- const propagator = new RungeKutta4Propagator(
598
- initialState,
599
- forceModel,
600
- { stepSize: 60 } // 60 second steps
601
- );
602
-
603
- const futureState = propagator.propagate(futureEpoch);
604
- ```
605
-
606
- ### Runge-Kutta 89 Propagator
607
-
608
- 8/9th-order with adaptive step size (high accuracy):
609
-
610
- ```typescript
611
- import { RungeKutta89Propagator } from 'ootk';
612
-
613
- const propagator = new RungeKutta89Propagator(
614
- initialState,
615
- forceModel,
616
- {
617
- minStepSize: 0.01, // seconds
618
- maxStepSize: 600, // seconds
619
- tolerance: 1e-9 // error tolerance
620
- }
621
- );
622
-
623
- const futureState = propagator.propagate(futureEpoch);
624
- ```
625
-
626
- ### Dormand-Prince 5(4) Propagator
627
-
628
- Adaptive Runge-Kutta method:
629
-
630
- ```typescript
631
- import { DormandPrince54Propagator } from 'ootk';
632
-
633
- const propagator = new DormandPrince54Propagator(
634
- initialState,
635
- forceModel,
636
- {
637
- minStepSize: 0.01,
638
- maxStepSize: 600,
639
- tolerance: 1e-9
640
- }
641
- );
642
-
643
- const futureState = propagator.propagate(futureEpoch);
644
- ```
645
-
646
- ### Propagator Comparison
647
-
648
- | Propagator | Accuracy | Speed | Use Case |
649
- |------------|----------|-------|----------|
650
- | SGP4 | Good | Very Fast | TLE propagation, Earth orbits |
651
- | Kepler | Low | Fastest | Quick estimates, educational |
652
- | RK4 | High | Moderate | General purpose |
653
- | RK89 | Very High | Slower | High-precision requirements |
654
- | Dormand-Prince | High | Moderate | Balanced accuracy/speed |
655
-
656
- ---
657
-
658
- ## Force Models
659
-
660
- For high-precision propagation, configure perturbation forces:
661
-
662
- ### Creating a Force Model
663
-
664
- ```typescript
665
- import { ForceModel } from 'ootk';
666
-
667
- const forceModel = new ForceModel();
668
- ```
669
-
670
- ### Earth Gravity
671
-
672
- Include gravitational harmonics:
673
-
674
- ```typescript
675
- // Point mass gravity (fastest)
676
- forceModel.setEarthGravity(0, 0);
677
-
678
- // J2 perturbation only
679
- forceModel.setEarthGravity(2, 0);
680
-
681
- // 8x8 gravity field (recommended for LEO)
682
- forceModel.setEarthGravity(8, 8);
683
-
684
- // 20x20 gravity field (high precision)
685
- forceModel.setEarthGravity(20, 20);
686
- ```
687
-
688
- **Degree/Order Guide:**
689
- - `(0, 0)` - Point mass only
690
- - `(2, 0)` - J2 oblateness
691
- - `(4, 4)` - Basic harmonics
692
- - `(8, 8)` - Good for most applications
693
- - `(20, 20)` - High precision
694
- - `(70, 70)` - Maximum precision (slow)
695
-
696
- ### Third-Body Gravity
697
-
698
- Sun and Moon perturbations:
699
-
700
- ```typescript
701
- forceModel.setThirdBodyGravity({
702
- sun: true,
703
- moon: true
704
- });
705
- ```
706
-
707
- ### Solar Radiation Pressure
708
-
709
- ```typescript
710
- // Basic SRP
711
- forceModel.setSolarRadiationPressure(
712
- 1000, // mass in kg
713
- 10, // cross-sectional area in m²
714
- 1.5 // radiation pressure coefficient (typically 1.0-2.0)
715
- );
716
- ```
717
-
718
- ### Atmospheric Drag
719
-
720
- ```typescript
721
- forceModel.setAtmosphericDrag(
722
- 1000, // mass in kg
723
- 10, // cross-sectional area in m²
724
- 2.2 // drag coefficient (typically 2.0-2.5)
725
- );
726
- ```
727
-
728
- ### Thrust
729
-
730
- For maneuvers:
731
-
732
- ```typescript
733
- import { Thrust, Vector3D } from 'ootk';
734
-
735
- const thrust = new Thrust(
736
- new Vector3D(100, 0, 0), // thrust vector in Newtons
737
- startEpoch,
738
- endEpoch
739
- );
740
-
741
- forceModel.addThrust(thrust);
742
- ```
743
-
744
- ### Complete Example
745
-
746
- ```typescript
747
- const forceModel = new ForceModel();
748
-
749
- // Configure all perturbations
750
- forceModel.setEarthGravity(20, 20);
751
- forceModel.setThirdBodyGravity({ sun: true, moon: true });
752
- forceModel.setSolarRadiationPressure(500, 15, 1.5);
753
- forceModel.setAtmosphericDrag(500, 15, 2.2);
754
-
755
- // Use with propagator
756
- const propagator = new RungeKutta89Propagator(
757
- initialState,
758
- forceModel,
759
- { tolerance: 1e-12 }
760
- );
761
- ```
762
-
763
- ---
764
-
765
- ## Initial Orbit Determination
766
-
767
- Determine orbits from observations using various IOD methods.
768
-
769
- ### Gibbsmethod
770
-
771
- Determine orbit from 3 position vectors:
772
-
773
- ```typescript
774
- import { GibbsIOD, Vector3D, EpochUTC } from 'ootk';
775
-
776
- const iod = new GibbsIOD();
777
-
778
- const r1 = new Vector3D(6778, 0, 0);
779
- const r2 = new Vector3D(0, 6778, 0);
780
- const r3 = new Vector3D(-6778, 0, 0);
781
-
782
- const result = iod.estimate(r1, r2, r3);
783
-
784
- console.log(result.velocity); // Determined velocity
785
- console.log(result.orbit); // Orbital elements
786
- ```
787
-
788
- ### Herrick-Gibbs IOD
789
-
790
- Improved Gibbs method using observation times:
791
-
792
- ```typescript
793
- import { HerrickGibbsIOD } from 'ootk';
794
-
795
- const iod = new HerrickGibbsIOD();
796
-
797
- const result = iod.estimate(
798
- r1, epoch1,
799
- r2, epoch2,
800
- r3, epoch3
801
- );
802
- ```
803
-
804
- ### Gooding IOD
805
-
806
- Advanced method with better handling of short arcs:
807
-
808
- ```typescript
809
- import { GoodingIOD } from 'ootk';
810
-
811
- const iod = new GoodingIOD();
812
-
813
- const result = iod.estimate(
814
- r1, epoch1,
815
- r2, epoch2,
816
- r3, epoch3
817
- );
818
- ```
819
-
820
- ### Modified Gooding IOD
821
-
822
- Enhanced Gooding method:
823
-
824
- ```typescript
825
- import { ModifiedGoodingIOD } from 'ootk';
826
-
827
- const iod = new ModifiedGoodingIOD();
828
-
829
- const result = iod.estimate(
830
- r1, epoch1,
831
- r2, epoch2,
832
- r3, epoch3
833
- );
834
- ```
835
-
836
- ### Lambert IOD
837
-
838
- Solve Lambert's problem (two positions, time of flight):
839
-
840
- ```typescript
841
- import { LambertIOD } from 'ootk';
842
-
843
- const iod = new LambertIOD();
844
-
845
- const result = iod.estimate(
846
- r1, epoch1,
847
- r2, epoch2
848
- );
849
-
850
- console.log(result.v1); // Velocity at first position
851
- console.log(result.v2); // Velocity at second position
852
- ```
853
-
854
- ### Batch Least Squares
855
-
856
- Fit orbit to multiple observations:
857
-
858
- ```typescript
859
- import { BatchLeastSquaresOD, ObservationOptical } from 'ootk';
860
-
861
- const observations = [
862
- new ObservationOptical(epoch1, ra1, dec1, sensor1),
863
- new ObservationOptical(epoch2, ra2, dec2, sensor2),
864
- new ObservationOptical(epoch3, ra3, dec3, sensor3),
865
- // ... more observations
866
- ];
867
-
868
- const iod = new BatchLeastSquaresOD();
869
- const result = iod.estimate(observations, initialGuess);
870
-
871
- console.log(result.state); // Final state estimate
872
- console.log(result.covariance); // Uncertainty
873
- console.log(result.residuals); // Observation residuals
874
- ```
875
-
876
- ### From Sensor Observations
877
-
878
- Practical example using sensor angle measurements:
879
-
880
- ```typescript
881
- import { Sensor, RAE } from 'ootk';
882
-
883
- const sensor = new Sensor({ lat, lon, alt, minEl, maxEl });
884
-
885
- // Get three observations
886
- const obs1 = new RAE(epoch1, range1, azimuth1, elevation1);
887
- const obs2 = new RAE(epoch2, range2, azimuth2, elevation2);
888
- const obs3 = new RAE(epoch3, range3, azimuth3, elevation3);
889
-
890
- // Convert to position vectors
891
- const r1 = sensor.raeToECI(obs1);
892
- const r2 = sensor.raeToECI(obs2);
893
- const r3 = sensor.raeToECI(obs3);
894
-
895
- // Run IOD
896
- const iod = new GoodingIOD();
897
- const orbit = iod.estimate(r1, epoch1, r2, epoch2, r3, epoch3);
898
- ```
899
-
900
- ---
901
-
902
- ## Observations
903
-
904
- ### Range, Azimuth, Elevation (RAE)
905
-
906
- Radar or optical tracking station measurements:
907
-
908
- ```typescript
909
- import { RAE, Degrees, Kilometers } from 'ootk';
910
-
911
- const observation = new RAE(
912
- epoch,
913
- 1000 as Kilometers, // range
914
- 180 as Degrees, // azimuth (0-360)
915
- 45 as Degrees, // elevation (-90 to 90)
916
- 0.5 as KilometersPerSecond // range rate (optional)
917
- );
918
-
919
- // Convert to topocentric coordinates
920
- const topocentric = observation.toTopocentric(sensor);
921
-
922
- // Convert to ECI
923
- const eci = observation.toECI(sensor);
924
- ```
925
-
926
- ### Right Ascension / Declination
927
-
928
- Optical observations in celestial coordinates:
929
-
930
- #### Geocentric
931
-
932
- ```typescript
933
- import { RadecGeocentric } from 'ootk';
934
-
935
- const observation = new RadecGeocentric(
936
- epoch,
937
- 15.5 as Degrees, // right ascension (0-360)
938
- 45.2 as Degrees, // declination (-90 to 90)
939
- 1000 as Kilometers // range (optional)
940
- );
941
- ```
942
-
943
- #### Topocentric
944
-
945
- From a ground station:
946
-
947
- ```typescript
948
- import { RadecTopocentric } from 'ootk';
949
-
950
- const observation = new RadecTopocentric(
951
- epoch,
952
- ra,
953
- dec,
954
- sensor // observer location
955
- );
956
-
957
- // Convert to geocentric
958
- const geocentric = observation.toGeocentric();
959
- ```
960
-
961
- ### Radar Observations
962
-
963
- ```typescript
964
- import { ObservationRadar } from 'ootk';
965
-
966
- const observation = new ObservationRadar(
967
- epoch,
968
- range,
969
- azimuth,
970
- elevation,
971
- rangeRate,
972
- sensor
973
- );
974
- ```
975
-
976
- ### Optical Observations
977
-
978
- ```typescript
979
- import { ObservationOptical } from 'ootk';
980
-
981
- const observation = new ObservationOptical(
982
- epoch,
983
- ra,
984
- dec,
985
- sensor
986
- );
987
- ```
988
-
989
- ---
990
-
991
- ## Time Systems
992
-
993
- ### Epoch Types
994
-
995
- OOTK supports multiple time systems:
996
-
997
- ```typescript
998
- import {
999
- EpochUTC,
1000
- EpochTAI,
1001
- EpochTT,
1002
- EpochGPS,
1003
- EpochTDB
1004
- } from 'ootk';
1005
-
1006
- // UTC (Coordinated Universal Time)
1007
- const utc = EpochUTC.fromDateTime(new Date('2024-01-28T12:00:00Z'));
1008
-
1009
- // TAI (International Atomic Time)
1010
- const tai = EpochTAI.fromDateTime(new Date('2024-01-28T12:00:00Z'));
1011
-
1012
- // TT (Terrestrial Time)
1013
- const tt = EpochTT.fromDateTime(new Date('2024-01-28T12:00:00Z'));
1014
-
1015
- // GPS Time
1016
- const gps = EpochGPS.fromDateTime(new Date('2024-01-28T12:00:00Z'));
1017
-
1018
- // TDB (Barycentric Dynamical Time)
1019
- const tdb = EpochTDB.fromDateTime(new Date('2024-01-28T12:00:00Z'));
1020
- ```
1021
-
1022
- ### Creating Epochs
1023
-
1024
- #### From JavaScript Date
1025
-
1026
- ```typescript
1027
- const epoch = EpochUTC.fromDateTime(new Date());
1028
- ```
1029
-
1030
- #### From Julian Date
1031
-
1032
- ```typescript
1033
- const epoch = EpochUTC.fromJulianDate(2451545.0);
1034
- ```
1035
-
1036
- #### From Modified Julian Date
1037
-
1038
- ```typescript
1039
- const epoch = EpochUTC.fromMJD(51544.5);
1040
- ```
1041
-
1042
- #### From Components
1043
-
1044
- ```typescript
1045
- const epoch = EpochUTC.fromDateTimeComponents(
1046
- 2024, // year
1047
- 1, // month
1048
- 28, // day
1049
- 12, // hour
1050
- 0, // minute
1051
- 0 // second
1052
- );
1053
- ```
1054
-
1055
- ### Time Conversions
1056
-
1057
- ```typescript
1058
- const utc = EpochUTC.fromDateTime(new Date());
1059
-
1060
- // Convert between time systems
1061
- const tai = utc.toTAI();
1062
- const tt = utc.toTT();
1063
- const gps = utc.toGPS();
1064
- const tdb = utc.toTDB();
1065
-
1066
- // Get Julian dates
1067
- console.log(utc.toJulianDate());
1068
- console.log(utc.toMJD());
1069
-
1070
- // Get as JavaScript Date
1071
- console.log(utc.toDateTime());
1072
- ```
1073
-
1074
- ### Time Windows
1075
-
1076
- Define time intervals:
1077
-
1078
- ```typescript
1079
- import { EpochWindow } from 'ootk';
1080
-
1081
- const window = new EpochWindow(startEpoch, endEpoch);
1082
-
1083
- // Check if epoch is in window
1084
- const isInWindow = window.contains(testEpoch);
1085
-
1086
- // Get duration
1087
- const durationSeconds = window.duration();
1088
- ```
1089
-
1090
- ### Time Arithmetic
1091
-
1092
- ```typescript
1093
- // Add seconds
1094
- const future = epoch.addSeconds(3600); // +1 hour
1095
-
1096
- // Add days
1097
- const tomorrow = epoch.addDays(1);
1098
-
1099
- // Difference between epochs
1100
- const deltaSeconds = epoch2.difference(epoch1);
1101
-
1102
- // Compare epochs
1103
- const isAfter = epoch2.isAfter(epoch1);
1104
- const isBefore = epoch2.isBefore(epoch1);
1105
- ```
1106
-
1107
- ### Greenwich Mean Sidereal Time
1108
-
1109
- ```typescript
1110
- import { EpochUTC } from 'ootk';
1111
-
1112
- const epoch = EpochUTC.fromDateTime(new Date());
1113
-
1114
- // Get GMST in radians
1115
- const gmst = epoch.gmst();
1116
-
1117
- // Get GMST in degrees
1118
- const gmstDeg = epoch.gmstDegrees();
1119
- ```
1120
-
1121
- ---
1122
-
1123
- ## Interpolation
1124
-
1125
- Interpolate state vectors for smooth trajectories.
1126
-
1127
- ### Chebyshev Interpolation
1128
-
1129
- Efficient for smooth functions:
1130
-
1131
- ```typescript
1132
- import { ChebyshevInterpolator, EpochUTC } from 'ootk';
1133
-
1134
- // Generate sample states
1135
- const states = [];
1136
- for (let i = 0; i < 10; i++) {
1137
- const epoch = startEpoch.addSeconds(i * 60);
1138
- const state = propagator.propagate(epoch);
1139
- states.push({ epoch, state });
1140
- }
1141
-
1142
- // Create interpolator
1143
- const interpolator = new ChebyshevInterpolator(states, 8); // 8th order
1144
-
1145
- // Interpolate at arbitrary time
1146
- const interpEpoch = startEpoch.addSeconds(135); // Between samples
1147
- const interpState = interpolator.interpolate(interpEpoch);
1148
- ```
1149
-
1150
- ### Lagrange Interpolation
1151
-
1152
- Classic polynomial interpolation:
1153
-
1154
- ```typescript
1155
- import { LagrangeInterpolator } from 'ootk';
1156
-
1157
- const interpolator = new LagrangeInterpolator(states, 5); // 5th order
1158
- const interpState = interpolator.interpolate(interpEpoch);
1159
- ```
1160
-
1161
- ### Cubic Spline Interpolation
1162
-
1163
- Smooth curves through points:
1164
-
1165
- ```typescript
1166
- import { CubicSplineInterpolator } from 'ootk';
1167
-
1168
- const interpolator = new CubicSplineInterpolator(states);
1169
- const interpState = interpolator.interpolate(interpEpoch);
1170
- ```
1171
-
1172
- ### Verlet Blend Interpolation
1173
-
1174
- Optimized for orbital mechanics:
1175
-
1176
- ```typescript
1177
- import { VerletBlendInterpolator } from 'ootk';
1178
-
1179
- const interpolator = new VerletBlendInterpolator(states);
1180
- const interpState = interpolator.interpolate(interpEpoch);
1181
- ```
1182
-
1183
- ### State Interpolator
1184
-
1185
- Generic state interpolation:
1186
-
1187
- ```typescript
1188
- import { StateInterpolator } from 'ootk';
1189
-
1190
- const interpolator = new StateInterpolator(states, 'chebyshev');
1191
- const interpState = interpolator.interpolate(interpEpoch);
1192
- ```
1193
-
1194
- ### Compression
1195
-
1196
- Reduce ephemeris data size:
1197
-
1198
- ```typescript
1199
- import { ChebyshevCompressor } from 'ootk';
1200
-
1201
- // Generate dense ephemeris
1202
- const ephemeris = [];
1203
- for (let i = 0; i < 1000; i++) {
1204
- ephemeris.push(propagator.propagate(epoch.addSeconds(i * 10)));
1205
- }
1206
-
1207
- // Compress to coefficients
1208
- const compressor = new ChebyshevCompressor(ephemeris, 12); // 12th order
1209
- const coefficients = compressor.compress();
1210
-
1211
- // Reconstruct with interpolation
1212
- const reconstructed = compressor.evaluate(testEpoch);
1213
- ```
1214
-
1215
- ---
1216
-
1217
- ## Mathematical Operations
1218
-
1219
- ### Vector3D
1220
-
1221
- 3D vector operations:
1222
-
1223
- ```typescript
1224
- import { Vector3D } from 'ootk';
1225
-
1226
- const v1 = new Vector3D(1, 2, 3);
1227
- const v2 = new Vector3D(4, 5, 6);
1228
-
1229
- // Basic operations
1230
- const sum = v1.add(v2);
1231
- const diff = v1.subtract(v2);
1232
- const scaled = v1.scale(2.5);
1233
-
1234
- // Dot product
1235
- const dot = v1.dot(v2);
1236
-
1237
- // Cross product
1238
- const cross = v1.cross(v2);
1239
-
1240
- // Magnitude
1241
- const mag = v1.magnitude();
1242
-
1243
- // Normalize
1244
- const unit = v1.normalize();
1245
-
1246
- // Distance
1247
- const dist = v1.distance(v2);
1248
-
1249
- // Angle between vectors
1250
- const angle = v1.angle(v2); // radians
1251
- ```
1252
-
1253
- ### Vector
1254
-
1255
- N-dimensional vectors:
1256
-
1257
- ```typescript
1258
- import { Vector } from 'ootk';
1259
-
1260
- const v = new Vector([1, 2, 3, 4, 5]);
1261
-
1262
- // Operations
1263
- const doubled = v.scale(2);
1264
- const sum = v.add(new Vector([1, 1, 1, 1, 1]));
1265
-
1266
- // Norms
1267
- const norm2 = v.norm(); // L2 norm
1268
- const norm1 = v.norm(1); // L1 norm
1269
- const normInf = v.norm(Infinity); // L-infinity norm
1270
- ```
1271
-
1272
- ### Matrix
1273
-
1274
- Matrix operations:
1275
-
1276
- ```typescript
1277
- import { Matrix } from 'ootk';
1278
-
1279
- const m = new Matrix([
1280
- [1, 2, 3],
1281
- [4, 5, 6],
1282
- [7, 8, 9]
1283
- ]);
1284
-
1285
- // Multiply matrices
1286
- const product = m.multiply(otherMatrix);
1287
-
1288
- // Multiply by vector
1289
- const result = m.multiplyVector(vector);
1290
-
1291
- // Transpose
1292
- const transposed = m.transpose();
1293
-
1294
- // Determinant
1295
- const det = m.determinant();
1296
-
1297
- // Inverse
1298
- const inverse = m.inverse();
1299
-
1300
- // Identity matrix
1301
- const identity = Matrix.identity(3);
1302
-
1303
- // Zero matrix
1304
- const zeros = Matrix.zeros(3, 3);
1305
- ```
1306
-
1307
- ### Quaternion
1308
-
1309
- Rotation representation:
1310
-
1311
- ```typescript
1312
- import { Quaternion, Vector3D } from 'ootk';
1313
-
1314
- // Create from axis-angle
1315
- const axis = new Vector3D(0, 0, 1);
1316
- const angle = Math.PI / 4; // 45 degrees
1317
- const q = Quaternion.fromAxisAngle(axis, angle);
1318
-
1319
- // Quaternion operations
1320
- const product = q1.multiply(q2);
1321
- const conjugate = q.conjugate();
1322
- const inverse = q.inverse();
1323
-
1324
- // Rotate vector
1325
- const rotated = q.rotateVector(vector);
1326
-
1327
- // Convert to rotation matrix
1328
- const rotMatrix = q.toRotationMatrix();
1329
-
1330
- // Interpolation (SLERP)
1331
- const interpolated = Quaternion.slerp(q1, q2, 0.5); // 50% between
1332
- ```
1333
-
1334
- ### Euler Angles
1335
-
1336
- ```typescript
1337
- import { EulerAngles } from 'ootk';
1338
-
1339
- const euler = new EulerAngles(
1340
- 0.1, // roll (radians)
1341
- 0.2, // pitch
1342
- 0.3 // yaw
1343
- );
1344
-
1345
- // Convert to quaternion
1346
- const quat = euler.toQuaternion();
1347
-
1348
- // Convert to rotation matrix
1349
- const matrix = euler.toRotationMatrix();
1350
- ```
1351
-
1352
- ### Random Number Generation
1353
-
1354
- ```typescript
1355
- import { Random } from 'ootk';
1356
-
1357
- // Uniform random in [0, 1)
1358
- const r = Random.uniform();
1359
-
1360
- // Uniform in range
1361
- const r2 = Random.uniformRange(-1, 1);
1362
-
1363
- // Gaussian (normal) distribution
1364
- const gaussian = Random.gaussian(0, 1); // mean=0, stddev=1
1365
-
1366
- // Random unit vector
1367
- const unitVec = Random.unitVector3D();
1368
- ```
1369
-
1370
- ### Box-Muller Transform
1371
-
1372
- Gaussian random numbers:
1373
-
1374
- ```typescript
1375
- import { BoxMuller } from 'ootk';
1376
-
1377
- const generator = new BoxMuller();
1378
-
1379
- // Generate pair of independent Gaussian random numbers
1380
- const [z1, z2] = generator.generate();
1381
- ```
1382
-
1383
- ---
1384
-
1385
- ## Optimization
1386
-
1387
- ### Golden Section Search
1388
-
1389
- 1D optimization:
1390
-
1391
- ```typescript
1392
- import { GoldenSection } from 'ootk';
1393
-
1394
- // Find minimum of function
1395
- const optimizer = new GoldenSection(
1396
- func, // function to minimize
1397
- lowerBound, // search range start
1398
- upperBound, // search range end
1399
- tolerance // convergence tolerance
1400
- );
1401
-
1402
- const result = optimizer.optimize();
1403
- console.log(result.x); // Optimal value
1404
- console.log(result.fval); // Function value at optimum
1405
- console.log(result.iterations);
1406
- ```
1407
-
1408
- ### Downhill Simplex (Nelder-Mead)
1409
-
1410
- Multi-dimensional optimization:
1411
-
1412
- ```typescript
1413
- import { DownhillSimplex } from 'ootk';
1414
-
1415
- // Minimize function of multiple variables
1416
- const optimizer = new DownhillSimplex(
1417
- func, // function to minimize
1418
- initialGuess, // starting point
1419
- {
1420
- tolerance: 1e-6,
1421
- maxIterations: 1000
1422
- }
1423
- );
1424
-
1425
- const result = optimizer.optimize();
1426
- console.log(result.x); // Optimal parameters
1427
- console.log(result.fval); // Final function value
1428
- console.log(result.converged);
1429
- ```
1430
-
1431
- ### Polynomial Regression
1432
-
1433
- Fit polynomial to data:
1434
-
1435
- ```typescript
1436
- import { PolynomialRegression } from 'ootk';
1437
-
1438
- const x = [1, 2, 3, 4, 5];
1439
- const y = [2.1, 3.9, 6.2, 8.1, 9.9];
1440
-
1441
- // Fit 2nd degree polynomial
1442
- const regression = new PolynomialRegression(x, y, 2);
1443
-
1444
- // Get coefficients
1445
- const coeffs = regression.getCoefficients();
1446
-
1447
- // Predict
1448
- const yPred = regression.predict(3.5);
1449
-
1450
- // R-squared
1451
- const r2 = regression.rSquared();
1452
- ```
1453
-
1454
- ### Simple Linear Regression
1455
-
1456
- ```typescript
1457
- import { SimpleLinearRegression } from 'ootk';
1458
-
1459
- const regression = new SimpleLinearRegression(x, y);
1460
-
1461
- console.log(regression.slope);
1462
- console.log(regression.intercept);
1463
- console.log(regression.rSquared);
1464
-
1465
- const predicted = regression.predict(newX);
1466
- ```
1467
-
1468
- ---
1469
-
1470
- ## Covariance
1471
-
1472
- Track state uncertainty for orbit determination and propagation.
1473
-
1474
- ### State Covariance
1475
-
1476
- ```typescript
1477
- import { StateCovariance, Matrix } from 'ootk';
1478
-
1479
- // Create 6x6 covariance matrix (position + velocity)
1480
- const covMatrix = new Matrix([
1481
- [100, 0, 0, 0, 0, 0], // σ²_x
1482
- [0, 100, 0, 0, 0, 0], // σ²_y
1483
- [0, 0, 100, 0, 0, 0], // σ²_z
1484
- [0, 0, 0, 0.01, 0, 0], // σ²_vx
1485
- [0, 0, 0, 0, 0.01, 0], // σ²_vy
1486
- [0, 0, 0, 0, 0, 0.01] // σ²_vz
1487
- ]);
1488
-
1489
- const covariance = new StateCovariance(epoch, state, covMatrix);
1490
-
1491
- // Propagate covariance
1492
- const futureCov = covariance.propagate(futureEpoch, propagator);
1493
-
1494
- // Get position uncertainty
1495
- const posUncertainty = covariance.getPositionUncertainty(); // km
1496
-
1497
- // Get velocity uncertainty
1498
- const velUncertainty = covariance.getVelocityUncertainty(); // km/s
1499
-
1500
- // Get standard deviations
1501
- const stdDevs = covariance.getStandardDeviations();
1502
- console.log('X uncertainty:', stdDevs.position.x, 'km');
1503
- ```
1504
-
1505
- ### Covariance from TLE
1506
-
1507
- Estimate uncertainty from TLE:
1508
-
1509
- ```typescript
1510
- import { Satellite } from 'ootk';
1511
-
1512
- const satellite = new Satellite({ tle1, tle2 });
1513
- const covariance = satellite.getCovariance();
1514
- ```
1515
-
1516
- ### Covariance Sampling
1517
-
1518
- Generate samples from distribution:
1519
-
1520
- ```typescript
1521
- import { CovarianceSample } from 'ootk';
1522
-
1523
- const samples = CovarianceSample.generate(
1524
- state,
1525
- covariance,
1526
- 1000 // number of samples
1527
- );
1528
-
1529
- // Use samples for Monte Carlo analysis
1530
- samples.forEach(sample => {
1531
- const propagated = propagator.propagate(futureEpoch);
1532
- // ... analyze
1533
- });
1534
- ```
1535
-
1536
- ---
1537
-
1538
- ## Celestial Bodies
1539
-
1540
- ### Earth
1541
-
1542
- Earth properties and models:
1543
-
1544
- ```typescript
1545
- import { Earth } from 'ootk';
1546
-
1547
- // Physical constants
1548
- console.log(Earth.radiusEquator); // km
1549
- console.log(Earth.radiusPolar); // km
1550
- console.log(Earth.radiusMean); // km
1551
- console.log(Earth.flattening);
1552
- console.log(Earth.mu); // Gravitational parameter
1553
- console.log(Earth.angularVelocity); // rad/s
1554
-
1555
- // Gravitational harmonics
1556
- console.log(Earth.j2);
1557
- console.log(Earth.j3);
1558
- console.log(Earth.j4);
1559
- console.log(Earth.j5);
1560
-
1561
- // Precession and nutation
1562
- const precession = Earth.precession(epoch);
1563
- const nutation = Earth.nutation(epoch);
1564
- ```
1565
-
1566
- ### Moon
1567
-
1568
- Lunar position and properties:
1569
-
1570
- ```typescript
1571
- import { Moon } from 'ootk';
1572
-
1573
- // Moon position in ECI
1574
- const moonPos = Moon.position(epoch);
1575
- console.log(moonPos); // { x, y, z } in km
1576
-
1577
- // Moon velocity
1578
- const moonVel = Moon.velocity(epoch);
1579
-
1580
- // Illumination angles
1581
- const illum = Moon.illumination(epoch, observerPos);
1582
- console.log(illum.phase); // 0-1 (0=new, 0.5=full)
1583
- console.log(illum.angle); // Phase angle
1584
- console.log(illum.fraction); // Illuminated fraction
1585
-
1586
- // Physical constants
1587
- console.log(Moon.radius);
1588
- console.log(Moon.mu);
1589
- ```
1590
-
1591
- ### Sun
1592
-
1593
- Solar position and calculations:
1594
-
1595
- ```typescript
1596
- import { Sun } from 'ootk';
1597
-
1598
- // Sun position in ECI
1599
- const sunPos = Sun.position(epoch);
1600
- console.log(sunPos); // { x, y, z } in km
1601
-
1602
- // Sun velocity
1603
- const sunVel = Sun.velocity(epoch);
1604
-
1605
- // Check if position is in Earth's shadow
1606
- const inShadow = Sun.isInEarthShadow(satellitePos, epoch);
1607
-
1608
- // Eclipse calculations
1609
- const eclipse = Sun.getEclipse(satellitePos, epoch);
1610
- console.log(eclipse.umbra); // In umbra (total shadow)
1611
- console.log(eclipse.penumbra); // In penumbra (partial shadow)
1612
- console.log(eclipse.sunlit); // In sunlight
1613
-
1614
- // Solar radiation pressure magnitude
1615
- const srp = Sun.radiationPressure(
1616
- area, // m²
1617
- mass, // kg
1618
- coeff // radiation coefficient
1619
- );
1620
- ```
1621
-
1622
- ---
1623
-
1624
- ## Maneuvers
1625
-
1626
- Plan and execute orbital maneuvers.
1627
-
1628
- ### Hohmann Transfer
1629
-
1630
- Classic two-burn transfer:
1631
-
1632
- ```typescript
1633
- import { TwoBurnOrbitTransfer, Kilometers } from 'ootk';
1634
-
1635
- // Transfer from LEO to GEO
1636
- const r1 = 6778 as Kilometers; // LEO radius
1637
- const r2 = 42164 as Kilometers; // GEO radius
1638
-
1639
- const transfer = TwoBurnOrbitTransfer.hohmannTransfer(r1, r2);
1640
-
1641
- console.log(transfer.deltaV1); // First burn Δv (km/s)
1642
- console.log(transfer.deltaV2); // Second burn Δv
1643
- console.log(transfer.totalDeltaV); // Total Δv required
1644
- console.log(transfer.transferTime); // Transfer duration (seconds)
1645
-
1646
- // Convert to maneuver objects
1647
- const maneuvers = transfer.toManeuvers(startEpoch);
1648
- ```
1649
-
1650
- ### Bi-elliptic Transfer
1651
-
1652
- Three-burn transfer (sometimes more efficient):
1653
-
1654
- ```typescript
1655
- const transfer = TwoBurnOrbitTransfer.biellipticTransfer(
1656
- r1, // Initial radius
1657
- r2, // Final radius
1658
- rb // Apoapsis of first transfer ellipse
1659
- );
1660
- ```
1661
-
1662
- ### Maneuver Object
1663
-
1664
- Individual maneuver:
1665
-
1666
- ```typescript
1667
- import { Maneuver, Vector3D } from 'ootk';
1668
-
1669
- const maneuver = new Maneuver({
1670
- epoch: burnEpoch,
1671
- deltaV: new Vector3D(0.5, 0.1, 0), // Δv vector in km/s
1672
- duration: 60, // Burn duration in seconds
1673
- direction: 'prograde' // or 'retrograde', 'normal', 'radial'
1674
- });
1675
-
1676
- // Apply to state
1677
- const newState = maneuver.apply(currentState);
1678
- ```
1679
-
1680
- ### Plane Change
1681
-
1682
- ```typescript
1683
- import { planeChange } from 'ootk';
1684
-
1685
- // Calculate Δv for plane change
1686
- const deltaV = planeChange(
1687
- velocity, // Current velocity (km/s)
1688
- angleChange // Angle to change (radians)
1689
- );
1690
- ```
1691
-
1692
- ### Inclination Change
1693
-
1694
- ```typescript
1695
- const deltaV = inclinationChange(
1696
- velocity,
1697
- currentInclination,
1698
- targetInclination
1699
- );
1700
- ```
1701
-
1702
- ---
1703
-
1704
- ## Advanced Topics
1705
-
1706
- ### Custom Propagators
1707
-
1708
- Create custom propagator:
1709
-
1710
- ```typescript
1711
- import { Propagator, J2000, EpochUTC } from 'ootk';
1712
-
1713
- class MyPropagator extends Propagator {
1714
- propagate(epoch: EpochUTC): J2000 {
1715
- // Your custom propagation logic
1716
- return new J2000(epoch, position, velocity);
1717
- }
1718
- }
1719
- ```
1720
-
1721
- ### Gravity Field Models
1722
-
1723
- Use custom gravity coefficients:
1724
-
1725
- ```typescript
1726
- import { EarthGravity } from 'ootk';
1727
-
1728
- const gravity = new EarthGravity(20, 20); // 20x20 field
1729
-
1730
- // Set custom coefficients
1731
- gravity.setCoefficient(2, 0, customJ2);
1732
- gravity.setCoefficient(3, 0, customJ3);
1733
- ```
1734
-
1735
- ### Ephemeris Generation
1736
-
1737
- Generate ephemeris table:
1738
-
1739
- ```typescript
1740
- const startEpoch = EpochUTC.fromDateTime(new Date());
1741
- const ephemeris = [];
1742
-
1743
- for (let i = 0; i < 1440; i++) { // 24 hours, 1-minute intervals
1744
- const epoch = startEpoch.addMinutes(i);
1745
- const state = propagator.propagate(epoch);
1746
-
1747
- ephemeris.push({
1748
- epoch: epoch.toDateTime(),
1749
- position: state.position,
1750
- velocity: state.velocity,
1751
- lla: state.toGeodetic()
1752
- });
1753
- }
1754
-
1755
- // Save or use ephemeris
1756
- ```
1757
-
1758
- ### Sensor Network
1759
-
1760
- Multiple sensor visibility:
1761
-
1762
- ```typescript
1763
- const sensors = [sensor1, sensor2, sensor3];
1764
-
1765
- const visibility = sensors.map(sensor => ({
1766
- sensor: sensor.name,
1767
- visible: sensor.isSatInFov(satellite),
1768
- rae: sensor.rae(satellite)
1769
- }));
1770
-
1771
- // Find which sensors can see satellite
1772
- const visibleFrom = visibility.filter(v => v.visible);
1773
- ```
1774
-
1775
- ### Collision Detection
1776
-
1777
- Check for close approaches:
1778
-
1779
- ```typescript
1780
- // Propagate both objects
1781
- const state1 = satellite1.toJ2000(epoch);
1782
- const state2 = satellite2.toJ2000(epoch);
1783
-
1784
- // Calculate distance
1785
- const distance = state1.position.distance(state2.position);
1786
-
1787
- if (distance < threshold) {
1788
- console.warn('Close approach detected!');
1789
- console.log('Distance:', distance, 'km');
1790
- console.log('Relative velocity:',
1791
- state1.velocity.subtract(state2.velocity).magnitude());
1792
- }
1793
- ```
1794
-
1795
- ### Catalog Management
1796
-
1797
- Work with satellite catalogs:
1798
-
1799
- ```typescript
1800
- import { Satellite } from 'ootk';
1801
-
1802
- const catalog = [];
1803
-
1804
- // Load TLEs
1805
- tleData.forEach(tle => {
1806
- const sat = new Satellite({
1807
- tle1: tle.line1,
1808
- tle2: tle.line2
1809
- });
1810
- catalog.push(sat);
1811
- });
1812
-
1813
- // Find satellites by criteria
1814
- const leoSats = catalog.filter(sat =>
1815
- sat.apogee < 2000 && sat.perigee > 200
1816
- );
1817
-
1818
- const highInclination = catalog.filter(sat =>
1819
- sat.inclination > 80
1820
- );
1821
- ```
1822
-
1823
- ### State Vector Manipulation
1824
-
1825
- ```typescript
1826
- import { StateVector } from 'ootk';
1827
-
1828
- const state = new StateVector(epoch, position, velocity);
1829
-
1830
- // Transform coordinate systems
1831
- const j2000 = state.toJ2000();
1832
- const itrf = state.toITRF();
1833
-
1834
- // Get orbital elements
1835
- const elements = state.toClassicalElements();
1836
-
1837
- // Add relative motion
1838
- const ricDelta = { x: 10, y: 0, z: 0 }; // 10 km radial
1839
- const newState = state.addRIC(ricDelta);
1840
- ```
1841
-
1842
- ### Performance Optimization
1843
-
1844
- Tips for optimal performance:
1845
-
1846
- ```typescript
1847
- // 1. Reuse propagators
1848
- const propagator = new Sgp4Propagator(satellite);
1849
- for (let i = 0; i < 1000; i++) {
1850
- const state = propagator.propagate(epochs[i]); // Fast
1851
- }
1852
-
1853
- // 2. Batch operations
1854
- const states = epochs.map(epoch => propagator.propagate(epoch));
1855
-
1856
- // 3. Use appropriate propagator
1857
- // - SGP4 for TLE data (fastest)
1858
- // - Kepler for quick estimates
1859
- // - RK4 for balanced precision/speed
1860
- // - RK89 only when high precision needed
1861
-
1862
- // 4. Reduce gravity field degree for distant objects
1863
- const forceModel = distance > 10000
1864
- ? new ForceModel().setEarthGravity(4, 4)
1865
- : new ForceModel().setEarthGravity(20, 20);
1866
-
1867
- // 5. Cache calculations
1868
- const cached = new Map();
1869
- function getState(satellite, epoch) {
1870
- const key = `${satellite.id}-${epoch.toJulianDate()}`;
1871
- if (!cached.has(key)) {
1872
- cached.set(key, satellite.eci(epoch.toDateTime()));
1873
- }
1874
- return cached.get(key);
1875
- }
1876
- ```
1877
-
1878
- ---
1879
-
1880
- ## Appendix: Quick Reference
1881
-
1882
- ### Common Conversions
1883
-
1884
- ```typescript
1885
- import { DEG2RAD, RAD2DEG, MINUTES_PER_DAY } from 'ootk';
1886
-
1887
- const radians = degrees * DEG2RAD;
1888
- const degrees = radians * RAD2DEG;
1889
-
1890
- // Mean motion to period
1891
- const period = MINUTES_PER_DAY / meanMotion;
1892
-
1893
- // Period to semi-major axis
1894
- const a = Math.cbrt((Earth.mu * (period * 60)**2) / (4 * Math.PI**2));
1895
- ```
1896
-
1897
- ### Useful Constants
1898
-
1899
- ```typescript
1900
- import { Earth } from 'ootk';
1901
-
1902
- Earth.radiusEquator; // 6378.137 km
1903
- Earth.radiusMean; // 6371.0 km
1904
- Earth.mu; // 398600.4418 km³/s²
1905
- Earth.j2; // 0.00108263
1906
- Earth.angularVelocity; // 7.2921159e-5 rad/s
1907
- ```
1908
-
1909
- ### Type Casting
1910
-
1911
- ```typescript
1912
- // Always cast numeric literals to appropriate types
1913
- const lat = 41.754785 as Degrees;
1914
- const alt = 400 as Kilometers;
1915
- const vel = 7.8 as KilometersPerSecond;
1916
- ```
1917
-
1918
- ---
1919
-
1920
- ## Support and Resources
1921
-
1922
- - **GitHub**: https://github.com/thkruz/ootk
1923
- - **Issues**: https://github.com/thkruz/ootk/issues
1924
- - **NPM**: https://www.npmjs.com/package/ootk
1925
- - **Examples**: `/examples` directory in repository
1926
-
1927
- For questions or contributions, please open an issue on GitHub.
1928
-
1929
- ---
1930
-
1931
- **License**: AGPL-3.0
1932
-
1933
- **Author**: Theodore Kruczek
1934
-
1935
- **Version**: 5.1.1