ootk 5.1.0 → 6.0.0-rc.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude/PROMPT.md +13 -0
- package/.claude/hooks/post-tool-use.ts +33 -0
- package/.claude/hooks/user-prompt-submit.ts +138 -0
- package/.claude/settings.local.json +13 -0
- package/.claude/skill-rules.json +11 -0
- package/.claude/skills/ootk-dev/SKILL.md +16 -0
- package/ADVANCED_FEATURES_GUIDE.md +1025 -0
- package/CHANGELOG.md +42 -3
- package/README.md +77 -45
- package/dist/body/Celestial.d.ts +2 -2
- package/dist/body/Celestial.js +2 -2
- package/dist/body/Celestial.js.map +1 -1
- package/dist/body/Earth.d.ts +4 -4
- package/dist/body/Earth.js +2 -2
- package/dist/body/Earth.js.map +1 -1
- package/dist/body/Moon.d.ts +3 -3
- package/dist/body/Moon.js +7 -7
- package/dist/body/Moon.js.map +1 -1
- package/dist/body/NutationAngles.d.ts +2 -2
- package/dist/body/NutationAngles.js +1 -1
- package/dist/body/PrecessionAngles.d.ts +2 -2
- package/dist/body/PrecessionAngles.js +1 -1
- package/dist/body/Sun.d.ts +2 -2
- package/dist/body/Sun.js +3 -3
- package/dist/body/Sun.js.map +1 -1
- package/dist/body/index.d.ts +5 -5
- package/dist/body/index.js +5 -5
- package/dist/body/index.js.map +1 -1
- package/dist/conjunction/ConjunctionAssessment.d.ts +156 -0
- package/dist/conjunction/ConjunctionAssessment.js +281 -0
- package/dist/conjunction/ConjunctionAssessment.js.map +1 -0
- package/dist/conjunction/ConjunctionEvent.d.ts +104 -0
- package/dist/conjunction/ConjunctionEvent.js +156 -0
- package/dist/conjunction/ConjunctionEvent.js.map +1 -0
- package/dist/conjunction/ProbabilityOfCollision.d.ts +102 -0
- package/dist/conjunction/ProbabilityOfCollision.js +240 -0
- package/dist/conjunction/ProbabilityOfCollision.js.map +1 -0
- package/dist/conjunction/index.d.ts +19 -0
- package/dist/conjunction/index.js +20 -0
- package/dist/conjunction/index.js.map +1 -0
- package/dist/coordinate/ClassicalElements.d.ts +7 -7
- package/dist/coordinate/ClassicalElements.js +7 -7
- package/dist/coordinate/ClassicalElements.js.map +1 -1
- package/dist/coordinate/EquinoctialElements.d.ts +5 -5
- package/dist/coordinate/EquinoctialElements.js +4 -4
- package/dist/coordinate/EquinoctialElements.js.map +1 -1
- package/dist/coordinate/FormatTle.d.ts +2 -2
- package/dist/coordinate/FormatTle.js +2 -2
- package/dist/coordinate/FormatTle.js.map +1 -1
- package/dist/coordinate/Geodetic.d.ts +4 -4
- package/dist/coordinate/Geodetic.js +7 -7
- package/dist/coordinate/Geodetic.js.map +1 -1
- package/dist/coordinate/Hill.d.ts +4 -4
- package/dist/coordinate/Hill.js +3 -3
- package/dist/coordinate/Hill.js.map +1 -1
- package/dist/coordinate/ITRF.d.ts +5 -5
- package/dist/coordinate/ITRF.js +6 -5
- package/dist/coordinate/ITRF.js.map +1 -1
- package/dist/coordinate/J2000.d.ts +5 -5
- package/dist/coordinate/J2000.js +5 -5
- package/dist/coordinate/J2000.js.map +1 -1
- package/dist/coordinate/RIC.d.ts +4 -4
- package/dist/coordinate/RIC.js +3 -3
- package/dist/coordinate/RIC.js.map +1 -1
- package/dist/coordinate/RelativeState.d.ts +5 -5
- package/dist/coordinate/RelativeState.js +2 -2
- package/dist/coordinate/RelativeState.js.map +1 -1
- package/dist/coordinate/StateVector.d.ts +2 -2
- package/dist/coordinate/StateVector.js +2 -2
- package/dist/coordinate/StateVector.js.map +1 -1
- package/dist/coordinate/TEME.d.ts +4 -4
- package/dist/coordinate/TEME.js +4 -4
- package/dist/coordinate/TEME.js.map +1 -1
- package/dist/coordinate/Tle.d.ts +5 -5
- package/dist/coordinate/Tle.js +9 -9
- package/dist/coordinate/Tle.js.map +1 -1
- package/dist/coordinate/index.d.ts +12 -12
- package/dist/coordinate/index.js +12 -12
- package/dist/coordinate/index.js.map +1 -1
- package/dist/coordinate/tle-format-data.d.ts +1 -1
- package/dist/coordinate/tle-format-data.js +1 -1
- package/dist/covariance/CovarianceSample.d.ts +5 -5
- package/dist/covariance/CovarianceSample.js +5 -5
- package/dist/covariance/CovarianceSample.js.map +1 -1
- package/dist/covariance/StateCovariance.d.ts +2 -2
- package/dist/covariance/StateCovariance.js +2 -2
- package/dist/covariance/StateCovariance.js.map +1 -1
- package/dist/covariance/index.d.ts +2 -2
- package/dist/covariance/index.js +2 -2
- package/dist/covariance/index.js.map +1 -1
- package/dist/data/DataHandler.d.ts +4 -4
- package/dist/data/DataHandler.js +5 -5
- package/dist/data/DataHandler.js.map +1 -1
- package/dist/data/values/Egm96Data.d.ts +1 -1
- package/dist/data/values/Egm96Data.js +3 -3
- package/dist/data/values/Egm96Data.js.map +1 -1
- package/dist/data/values/HpAtmosphereData.d.ts +2 -2
- package/dist/data/values/HpAtmosphereData.js +3 -3
- package/dist/data/values/HpAtmosphereData.js.map +1 -1
- package/dist/data/values/HpAtmosphereResult.d.ts +2 -2
- package/dist/data/values/HpAtmosphereResult.js +1 -1
- package/dist/data/values/Iau1980Data.d.ts +1 -1
- package/dist/data/values/Iau1980Data.js +2 -2
- package/dist/data/values/Iau1980Data.js.map +1 -1
- package/dist/data/values/LeapSecond.d.ts +1 -1
- package/dist/data/values/LeapSecond.js +1 -1
- package/dist/data/values/LeapSecondData.d.ts +2 -2
- package/dist/data/values/LeapSecondData.js +2 -2
- package/dist/data/values/LeapSecondData.js.map +1 -1
- package/dist/data/values/egm96.d.ts +2 -2
- package/dist/data/values/egm96.js +1 -1
- package/dist/data/values/hpAtmosphere.d.ts +2 -2
- package/dist/data/values/hpAtmosphere.js +1 -1
- package/dist/data/values/iau1980.d.ts +2 -2
- package/dist/data/values/iau1980.js +1 -1
- package/dist/enums/AngularDiameterMethod.d.ts +1 -1
- package/dist/enums/AngularDiameterMethod.js +1 -1
- package/dist/enums/AngularDistanceMethod.d.ts +1 -1
- package/dist/enums/AngularDistanceMethod.js +1 -1
- package/dist/enums/OrbitRegime.d.ts +1 -1
- package/dist/enums/OrbitRegime.js +1 -1
- package/dist/enums/PassType.d.ts +1 -1
- package/dist/enums/PassType.js +1 -1
- package/dist/enums/Sgp4OpsMode.d.ts +1 -1
- package/dist/enums/Sgp4OpsMode.js +1 -1
- package/dist/enums/index.d.ts +7 -7
- package/dist/enums/index.js +7 -7
- package/dist/enums/index.js.map +1 -1
- package/dist/fetch/horizons-constants.d.ts +43 -0
- package/dist/fetch/horizons-constants.js +50 -0
- package/dist/fetch/horizons-constants.js.map +1 -0
- package/dist/fetch/horizons-interfaces.d.ts +37 -0
- package/dist/fetch/horizons-interfaces.js +2 -0
- package/dist/fetch/horizons-interfaces.js.map +1 -0
- package/dist/fetch/horizons.d.ts +86 -0
- package/dist/fetch/horizons.js +237 -0
- package/dist/fetch/horizons.js.map +1 -0
- package/dist/force/AtmosphericDrag.d.ts +3 -3
- package/dist/force/AtmosphericDrag.js +2 -2
- package/dist/force/AtmosphericDrag.js.map +1 -1
- package/dist/force/EarthGravity.d.ts +3 -3
- package/dist/force/EarthGravity.js +2 -2
- package/dist/force/EarthGravity.js.map +1 -1
- package/dist/force/Force.d.ts +3 -3
- package/dist/force/Force.js +1 -10
- package/dist/force/Force.js.map +1 -1
- package/dist/force/ForceModel.d.ts +3 -3
- package/dist/force/ForceModel.js +7 -7
- package/dist/force/ForceModel.js.map +1 -1
- package/dist/force/Gravity.d.ts +3 -3
- package/dist/force/Gravity.js +2 -2
- package/dist/force/Gravity.js.map +1 -1
- package/dist/force/SolarRadiationPressure.d.ts +3 -3
- package/dist/force/SolarRadiationPressure.js +4 -4
- package/dist/force/SolarRadiationPressure.js.map +1 -1
- package/dist/force/ThirdBodyGravity.d.ts +3 -3
- package/dist/force/ThirdBodyGravity.js +2 -2
- package/dist/force/ThirdBodyGravity.js.map +1 -1
- package/dist/force/Thrust.d.ts +3 -3
- package/dist/force/Thrust.js +2 -2
- package/dist/force/Thrust.js.map +1 -1
- package/dist/force/index.d.ts +1 -1
- package/dist/force/index.js +1 -1
- package/dist/force/index.js.map +1 -1
- package/dist/interfaces/BaseObjectParams.d.ts +2 -2
- package/dist/interfaces/BaseObjectParams.js +1 -1
- package/dist/interfaces/ClassicalElementsParams.d.ts +2 -2
- package/dist/interfaces/ClassicalElementsParams.js +1 -1
- package/dist/interfaces/EquinoctialElementsParams.d.ts +2 -2
- package/dist/interfaces/EquinoctialElementsParams.js +1 -1
- package/dist/interfaces/GroundPositionParams.d.ts +2 -2
- package/dist/interfaces/GroundPositionParams.js +1 -1
- package/dist/interfaces/RfSensorParams.d.ts +2 -2
- package/dist/interfaces/SatelliteParams.d.ts +2 -2
- package/dist/interfaces/SensorParams.d.ts +2 -2
- package/dist/interfaces/StarObjectParams.d.ts +1 -1
- package/dist/interfaces/TimeVariables.d.ts +1 -1
- package/dist/interfaces/index.d.ts +9 -9
- package/dist/interpolator/ChebyshevCoefficients.d.ts +2 -2
- package/dist/interpolator/ChebyshevCoefficients.js +2 -2
- package/dist/interpolator/ChebyshevCoefficients.js.map +1 -1
- package/dist/interpolator/ChebyshevInterpolator.d.ts +4 -4
- package/dist/interpolator/ChebyshevInterpolator.js +3 -3
- package/dist/interpolator/ChebyshevInterpolator.js.map +1 -1
- package/dist/interpolator/CubicSpline.d.ts +2 -2
- package/dist/interpolator/CubicSpline.js +1 -1
- package/dist/interpolator/CubicSplineInterpolator.d.ts +4 -4
- package/dist/interpolator/CubicSplineInterpolator.js +4 -4
- package/dist/interpolator/CubicSplineInterpolator.js.map +1 -1
- package/dist/interpolator/FieldInterpolator.d.ts +3 -3
- package/dist/interpolator/FieldInterpolator.js +2 -12
- package/dist/interpolator/FieldInterpolator.js.map +1 -1
- package/dist/interpolator/Interpolator.d.ts +2 -2
- package/dist/interpolator/Interpolator.js +2 -2
- package/dist/interpolator/Interpolator.js.map +1 -1
- package/dist/interpolator/LagrangeInterpolator.d.ts +3 -3
- package/dist/interpolator/LagrangeInterpolator.js +3 -3
- package/dist/interpolator/LagrangeInterpolator.js.map +1 -1
- package/dist/interpolator/StateInterpolator.d.ts +4 -4
- package/dist/interpolator/StateInterpolator.js +2 -10
- package/dist/interpolator/StateInterpolator.js.map +1 -1
- package/dist/interpolator/VerletBlendInterpolator.d.ts +5 -5
- package/dist/interpolator/VerletBlendInterpolator.js +5 -5
- package/dist/interpolator/VerletBlendInterpolator.js.map +1 -1
- package/dist/main.d.ts +20 -20
- package/dist/main.js +21 -20
- package/dist/main.js.map +1 -1
- package/dist/maneuver/TwoBurnOrbitTransfer.d.ts +3 -3
- package/dist/maneuver/TwoBurnOrbitTransfer.js +3 -3
- package/dist/maneuver/TwoBurnOrbitTransfer.js.map +1 -1
- package/dist/maneuver/Waypoint.d.ts +5 -5
- package/dist/maneuver/Waypoint.js +7 -7
- package/dist/maneuver/Waypoint.js.map +1 -1
- package/dist/objects/BaseObject.d.ts +3 -3
- package/dist/objects/BaseObject.js +2 -2
- package/dist/objects/BaseObject.js.map +1 -1
- package/dist/objects/DetailedSatellite.d.ts +4 -4
- package/dist/objects/DetailedSatellite.js +4 -4
- package/dist/objects/DetailedSatellite.js.map +1 -1
- package/dist/objects/DetailedSensor.d.ts +5 -5
- package/dist/objects/DetailedSensor.js +2 -2
- package/dist/objects/DetailedSensor.js.map +1 -1
- package/dist/objects/GroundObject.d.ts +4 -4
- package/dist/objects/GroundObject.js +3 -3
- package/dist/objects/GroundObject.js.map +1 -1
- package/dist/objects/LandObject.d.ts +3 -3
- package/dist/objects/LandObject.js +2 -2
- package/dist/objects/LandObject.js.map +1 -1
- package/dist/objects/Marker.d.ts +2 -2
- package/dist/objects/Marker.js +2 -2
- package/dist/objects/Marker.js.map +1 -1
- package/dist/objects/RfSensor.d.ts +2 -2
- package/dist/objects/RfSensor.js +2 -2
- package/dist/objects/RfSensor.js.map +1 -1
- package/dist/objects/Satellite.d.ts +12 -12
- package/dist/objects/Satellite.js +14 -14
- package/dist/objects/Satellite.js.map +1 -1
- package/dist/objects/Sensor.d.ts +6 -6
- package/dist/objects/Sensor.js +5 -5
- package/dist/objects/Sensor.js.map +1 -1
- package/dist/objects/Star.d.ts +3 -3
- package/dist/objects/Star.js +3 -3
- package/dist/objects/Star.js.map +1 -1
- package/dist/objects/index.d.ts +10 -10
- package/dist/objects/index.js +10 -10
- package/dist/objects/index.js.map +1 -1
- package/dist/observation/Observation.d.ts +11 -11
- package/dist/observation/Observation.js +1 -52
- package/dist/observation/Observation.js.map +1 -1
- package/dist/observation/ObservationOptical.d.ts +6 -6
- package/dist/observation/ObservationOptical.js +4 -4
- package/dist/observation/ObservationOptical.js.map +1 -1
- package/dist/observation/ObservationRadar.d.ts +6 -6
- package/dist/observation/ObservationRadar.js +4 -4
- package/dist/observation/ObservationRadar.js.map +1 -1
- package/dist/observation/ObservationUtils.d.ts +2 -2
- package/dist/observation/ObservationUtils.js +2 -2
- package/dist/observation/ObservationUtils.js.map +1 -1
- package/dist/observation/PropagatorPairs.d.ts +2 -2
- package/dist/observation/PropagatorPairs.js +1 -1
- package/dist/observation/RAE.d.ts +6 -6
- package/dist/observation/RAE.js +6 -6
- package/dist/observation/RAE.js.map +1 -1
- package/dist/observation/RadecGeocentric.d.ts +6 -6
- package/dist/observation/RadecGeocentric.js +5 -5
- package/dist/observation/RadecGeocentric.js.map +1 -1
- package/dist/observation/RadecTopocentric.d.ts +6 -6
- package/dist/observation/RadecTopocentric.js +9 -7
- package/dist/observation/RadecTopocentric.js.map +1 -1
- package/dist/observation/index.d.ts +5 -5
- package/dist/observation/index.js +5 -5
- package/dist/observation/index.js.map +1 -1
- package/dist/operations/BoxMuller.d.ts +2 -2
- package/dist/operations/BoxMuller.js +2 -2
- package/dist/operations/BoxMuller.js.map +1 -1
- package/dist/operations/EulerAngles.d.ts +2 -2
- package/dist/operations/EulerAngles.js +2 -2
- package/dist/operations/EulerAngles.js.map +1 -1
- package/dist/operations/Matrix.d.ts +2 -2
- package/dist/operations/Matrix.js +2 -2
- package/dist/operations/Matrix.js.map +1 -1
- package/dist/operations/Quaternion.d.ts +2 -2
- package/dist/operations/Quaternion.js +2 -2
- package/dist/operations/Quaternion.js.map +1 -1
- package/dist/operations/Random.d.ts +1 -1
- package/dist/operations/Random.js +1 -1
- package/dist/operations/RandomGaussianSource.d.ts +2 -2
- package/dist/operations/RandomGaussianSource.js +3 -3
- package/dist/operations/RandomGaussianSource.js.map +1 -1
- package/dist/operations/Vector.d.ts +2 -2
- package/dist/operations/Vector.js +2 -2
- package/dist/operations/Vector.js.map +1 -1
- package/dist/operations/Vector3D.d.ts +5 -4
- package/dist/operations/Vector3D.js +5 -4
- package/dist/operations/Vector3D.js.map +1 -1
- package/dist/operations/index.d.ts +4 -4
- package/dist/operations/index.js +4 -4
- package/dist/operations/index.js.map +1 -1
- package/dist/operations/operations.d.ts +5 -5
- package/dist/operations/operations.js +5 -5
- package/dist/operations/operations.js.map +1 -1
- package/dist/optimize/ChebyshevCompressor.d.ts +3 -3
- package/dist/optimize/ChebyshevCompressor.js +4 -4
- package/dist/optimize/ChebyshevCompressor.js.map +1 -1
- package/dist/optimize/DownhillSimplex.d.ts +2 -2
- package/dist/optimize/DownhillSimplex.js +2 -2
- package/dist/optimize/DownhillSimplex.js.map +1 -1
- package/dist/optimize/GoldenSection.d.ts +2 -2
- package/dist/optimize/GoldenSection.js +1 -1
- package/dist/optimize/PolynomialRegression.d.ts +2 -2
- package/dist/optimize/PolynomialRegression.js +4 -4
- package/dist/optimize/PolynomialRegression.js.map +1 -1
- package/dist/optimize/PolynomicalRegressionResult.d.ts +1 -1
- package/dist/optimize/PolynomicalRegressionResult.js +1 -1
- package/dist/optimize/SimpleLinearRegression.d.ts +1 -1
- package/dist/optimize/SimpleLinearRegression.js +1 -1
- package/dist/optimize/SimplexEntry.d.ts +1 -1
- package/dist/optimize/SimplexEntry.js +2 -2
- package/dist/optimize/SimplexEntry.js.map +1 -1
- package/dist/orbit_determination/BatchLeastSquaresOD.d.ts +5 -5
- package/dist/orbit_determination/BatchLeastSquaresOD.js +8 -8
- package/dist/orbit_determination/BatchLeastSquaresOD.js.map +1 -1
- package/dist/orbit_determination/BatchLeastSquaresResult.d.ts +3 -3
- package/dist/orbit_determination/BatchLeastSquaresResult.js +1 -1
- package/dist/orbit_determination/GaussIOD.d.ts +98 -0
- package/dist/orbit_determination/GaussIOD.js +291 -0
- package/dist/orbit_determination/GaussIOD.js.map +1 -0
- package/dist/orbit_determination/GibbsIOD.d.ts +2 -2
- package/dist/orbit_determination/GibbsIOD.js +4 -4
- package/dist/orbit_determination/GibbsIOD.js.map +1 -1
- package/dist/orbit_determination/GoodingIOD.d.ts +58 -8
- package/dist/orbit_determination/GoodingIOD.js +225 -35
- package/dist/orbit_determination/GoodingIOD.js.map +1 -1
- package/dist/orbit_determination/HerrickGibbsIOD.d.ts +2 -2
- package/dist/orbit_determination/HerrickGibbsIOD.js +2 -2
- package/dist/orbit_determination/HerrickGibbsIOD.js.map +1 -1
- package/dist/orbit_determination/LambertIOD.d.ts +2 -2
- package/dist/orbit_determination/LambertIOD.js +2 -2
- package/dist/orbit_determination/LambertIOD.js.map +1 -1
- package/dist/orbit_determination/ModifiedGoodingIOD.d.ts +3 -3
- package/dist/orbit_determination/ModifiedGoodingIOD.js +8 -8
- package/dist/orbit_determination/ModifiedGoodingIOD.js.map +1 -1
- package/dist/orbit_determination/index.d.ts +7 -7
- package/dist/orbit_determination/index.js +7 -7
- package/dist/orbit_determination/index.js.map +1 -1
- package/dist/propagator/DormandPrince54Propagator.d.ts +2 -2
- package/dist/propagator/DormandPrince54Propagator.js +2 -2
- package/dist/propagator/DormandPrince54Propagator.js.map +1 -1
- package/dist/propagator/KeplerPropagator.d.ts +6 -6
- package/dist/propagator/KeplerPropagator.js +6 -7
- package/dist/propagator/KeplerPropagator.js.map +1 -1
- package/dist/propagator/Propagator.d.ts +5 -5
- package/dist/propagator/Propagator.js +5 -5
- package/dist/propagator/Propagator.js.map +1 -1
- package/dist/propagator/RkCheckpoint.d.ts +2 -2
- package/dist/propagator/RkCheckpoint.js +1 -1
- package/dist/propagator/RkResult.d.ts +2 -2
- package/dist/propagator/RkResult.js +1 -1
- package/dist/propagator/RungeKutta4Propagator.d.ts +6 -6
- package/dist/propagator/RungeKutta4Propagator.js +5 -5
- package/dist/propagator/RungeKutta4Propagator.js.map +1 -1
- package/dist/propagator/RungeKutta89Propagator.d.ts +2 -2
- package/dist/propagator/RungeKutta89Propagator.js +2 -2
- package/dist/propagator/RungeKutta89Propagator.js.map +1 -1
- package/dist/propagator/RungeKuttaAdaptive.d.ts +6 -6
- package/dist/propagator/RungeKuttaAdaptive.js +52 -9
- package/dist/propagator/RungeKuttaAdaptive.js.map +1 -1
- package/dist/propagator/Sgp4Propagator.d.ts +7 -7
- package/dist/propagator/Sgp4Propagator.js +4 -4
- package/dist/propagator/Sgp4Propagator.js.map +1 -1
- package/dist/propagator/index.d.ts +3 -3
- package/dist/propagator/index.js +3 -3
- package/dist/propagator/index.js.map +1 -1
- package/dist/sgp4/index.d.ts +2 -2
- package/dist/sgp4/index.js +2 -2
- package/dist/sgp4/index.js.map +1 -1
- package/dist/sgp4/sgp4.d.ts +3 -3
- package/dist/sgp4/sgp4.js +11 -5
- package/dist/sgp4/sgp4.js.map +1 -1
- package/dist/smoothing/ExponentialSmoothing.d.ts +2 -2
- package/dist/smoothing/ExponentialSmoothing.js +1 -1
- package/dist/time/Epoch.d.ts +2 -2
- package/dist/time/Epoch.js +2 -2
- package/dist/time/Epoch.js.map +1 -1
- package/dist/time/EpochGPS.d.ts +3 -3
- package/dist/time/EpochGPS.js +3 -3
- package/dist/time/EpochGPS.js.map +1 -1
- package/dist/time/EpochTAI.d.ts +2 -2
- package/dist/time/EpochTAI.js +2 -2
- package/dist/time/EpochTAI.js.map +1 -1
- package/dist/time/EpochTDB.d.ts +2 -2
- package/dist/time/EpochTDB.js +2 -2
- package/dist/time/EpochTDB.js.map +1 -1
- package/dist/time/EpochTT.d.ts +2 -2
- package/dist/time/EpochTT.js +2 -2
- package/dist/time/EpochTT.js.map +1 -1
- package/dist/time/EpochUTC.d.ts +7 -7
- package/dist/time/EpochUTC.js +9 -9
- package/dist/time/EpochUTC.js.map +1 -1
- package/dist/time/EpochWindow.d.ts +2 -2
- package/dist/time/EpochWindow.js +1 -1
- package/dist/time/TimeStamped.d.ts +2 -2
- package/dist/time/TimeStamped.js +1 -1
- package/dist/time/index.d.ts +8 -8
- package/dist/time/index.js +8 -8
- package/dist/time/index.js.map +1 -1
- package/dist/transforms/TransformCache.d.ts +1 -1
- package/dist/transforms/TransformCache.js +1 -1
- package/dist/transforms/conversions.d.ts +2 -2
- package/dist/transforms/conversions.js +2 -2
- package/dist/transforms/conversions.js.map +1 -1
- package/dist/transforms/index.d.ts +2 -2
- package/dist/transforms/index.js +2 -2
- package/dist/transforms/index.js.map +1 -1
- package/dist/transforms/transforms.d.ts +1 -1
- package/dist/transforms/transforms.js +1 -1
- package/dist/transforms/transforms.js.map +1 -1
- package/dist/types/types.d.ts +8 -3
- package/dist/types/types.js +6 -1
- package/dist/types/types.js.map +1 -1
- package/dist/utils/constants.d.ts +2 -2
- package/dist/utils/constants.js +1 -1
- package/dist/utils/constants.js.map +1 -1
- package/dist/utils/create-covariance-from-tle.d.ts +1 -1
- package/dist/utils/create-covariance-from-tle.js +1 -1
- package/dist/utils/create-covariance-from-tle.js.map +1 -1
- package/dist/utils/functions.d.ts +4 -4
- package/dist/utils/functions.js +9 -4
- package/dist/utils/functions.js.map +1 -1
- package/dist/utils/index.d.ts +5 -5
- package/dist/utils/index.js +5 -5
- package/dist/utils/index.js.map +1 -1
- package/dist/utils/jacobian.d.ts +2 -2
- package/dist/utils/jacobian.js +1 -1
- package/dist/utils/jacobian.js.map +1 -1
- package/dist/utils/linearDistance.d.ts +1 -1
- package/docs/README.md +132 -0
- package/docs/getting-started.md +792 -0
- package/docs/lambert-satellite-integration-guide.md +766 -0
- package/docs/user-guide.md +1935 -0
- package/jest.config.mjs +28 -0
- package/package.json +3 -4
- package/src/body/Celestial.ts +2 -2
- package/src/body/Earth.ts +4 -4
- package/src/body/Moon.ts +7 -7
- package/src/body/NutationAngles.ts +2 -2
- package/src/body/PrecessionAngles.ts +2 -2
- package/src/body/Sun.ts +4 -4
- package/src/body/index.ts +6 -5
- package/src/conjunction/ConjunctionAssessment.ts +417 -0
- package/src/conjunction/ConjunctionEvent.ts +149 -0
- package/src/conjunction/ProbabilityOfCollision.ts +300 -0
- package/src/conjunction/index.ts +24 -0
- package/src/coordinate/ClassicalElements.ts +16 -11
- package/src/coordinate/EquinoctialElements.ts +7 -7
- package/src/coordinate/FormatTle.ts +2 -2
- package/src/coordinate/Geodetic.ts +8 -8
- package/src/coordinate/Hill.ts +4 -4
- package/src/coordinate/ITRF.ts +6 -6
- package/src/coordinate/J2000.ts +7 -7
- package/src/coordinate/RIC.ts +4 -4
- package/src/coordinate/RelativeState.ts +5 -5
- package/src/coordinate/StateVector.ts +8 -3
- package/src/coordinate/TEME.ts +6 -6
- package/src/coordinate/Tle.ts +9 -9
- package/src/coordinate/index.ts +13 -12
- package/src/coordinate/tle-format-data.ts +1 -1
- package/src/covariance/CovarianceSample.ts +13 -13
- package/src/covariance/StateCovariance.ts +2 -2
- package/src/covariance/index.ts +3 -2
- package/src/data/DataHandler.ts +6 -6
- package/src/data/values/Egm96Data.ts +3 -3
- package/src/data/values/HpAtmosphereData.ts +3 -3
- package/src/data/values/HpAtmosphereResult.ts +2 -2
- package/src/data/values/Iau1980Data.ts +2 -2
- package/src/data/values/LeapSecond.ts +1 -1
- package/src/data/values/LeapSecondData.ts +2 -2
- package/src/data/values/egm96.ts +2 -2
- package/src/data/values/hpAtmosphere.ts +2 -2
- package/src/data/values/iau1980.ts +2 -2
- package/src/enums/AngularDiameterMethod.ts +1 -1
- package/src/enums/AngularDistanceMethod.ts +1 -1
- package/src/enums/OrbitRegime.ts +1 -1
- package/src/enums/PassType.ts +1 -1
- package/src/enums/Sgp4OpsMode.ts +1 -1
- package/src/enums/index.ts +8 -7
- package/src/fetch/horizons-constants.ts +53 -0
- package/src/fetch/horizons-interfaces.ts +38 -0
- package/src/fetch/horizons.ts +300 -0
- package/src/force/AtmosphericDrag.ts +3 -3
- package/src/force/EarthGravity.ts +3 -3
- package/src/force/Force.ts +3 -5
- package/src/force/ForceModel.ts +9 -9
- package/src/force/Gravity.ts +3 -3
- package/src/force/SolarRadiationPressure.ts +4 -4
- package/src/force/ThirdBodyGravity.ts +3 -3
- package/src/force/Thrust.ts +3 -3
- package/src/force/index.ts +2 -1
- package/src/interfaces/BaseObjectParams.ts +2 -2
- package/src/interfaces/ClassicalElementsParams.ts +2 -2
- package/src/interfaces/EquinoctialElementsParams.ts +2 -2
- package/src/interfaces/GroundPositionParams.ts +2 -2
- package/src/interfaces/RfSensorParams.ts +2 -2
- package/src/interfaces/SatelliteParams.ts +2 -2
- package/src/interfaces/SensorParams.ts +3 -3
- package/src/interfaces/StarObjectParams.ts +1 -1
- package/src/interfaces/TimeVariables.ts +1 -1
- package/src/interfaces/index.ts +10 -9
- package/src/interpolator/ChebyshevCoefficients.ts +2 -2
- package/src/interpolator/ChebyshevInterpolator.ts +4 -4
- package/src/interpolator/CubicSpline.ts +2 -2
- package/src/interpolator/CubicSplineInterpolator.ts +4 -4
- package/src/interpolator/FieldInterpolator.ts +3 -5
- package/src/interpolator/Interpolator.ts +2 -2
- package/src/interpolator/LagrangeInterpolator.ts +3 -3
- package/src/interpolator/StateInterpolator.ts +4 -6
- package/src/interpolator/VerletBlendInterpolator.ts +5 -5
- package/src/main.ts +41 -20
- package/src/maneuver/TwoBurnOrbitTransfer.ts +3 -3
- package/src/maneuver/Waypoint.ts +8 -8
- package/src/objects/BaseObject.ts +3 -3
- package/src/objects/DetailedSatellite.ts +9 -9
- package/src/objects/DetailedSensor.ts +5 -5
- package/src/objects/GroundObject.ts +9 -9
- package/src/objects/LandObject.ts +3 -3
- package/src/objects/Marker.ts +2 -2
- package/src/objects/RfSensor.ts +2 -2
- package/src/objects/Satellite.ts +21 -21
- package/src/objects/Sensor.ts +7 -7
- package/src/objects/Star.ts +3 -3
- package/src/objects/index.ts +11 -10
- package/src/observation/Observation.ts +11 -23
- package/src/observation/ObservationOptical.ts +7 -7
- package/src/observation/ObservationRadar.ts +7 -7
- package/src/observation/ObservationUtils.ts +2 -2
- package/src/observation/PropagatorPairs.ts +2 -2
- package/src/observation/RAE.ts +9 -9
- package/src/observation/RadecGeocentric.ts +9 -9
- package/src/observation/RadecTopocentric.ts +13 -10
- package/src/observation/index.ts +6 -5
- package/src/operations/BoxMuller.ts +2 -2
- package/src/operations/EulerAngles.ts +2 -2
- package/src/operations/Matrix.ts +2 -2
- package/src/operations/Quaternion.ts +2 -2
- package/src/operations/Random.ts +1 -1
- package/src/operations/RandomGaussianSource.ts +3 -3
- package/src/operations/Vector.ts +2 -2
- package/src/operations/Vector3D.ts +6 -4
- package/src/operations/index.ts +5 -4
- package/src/operations/operations.ts +6 -5
- package/src/optimize/ChebyshevCompressor.ts +5 -5
- package/src/optimize/DownhillSimplex.ts +2 -2
- package/src/optimize/GoldenSection.ts +2 -2
- package/src/optimize/PolynomialRegression.ts +4 -4
- package/src/optimize/PolynomicalRegressionResult.ts +1 -1
- package/src/optimize/SimpleLinearRegression.ts +1 -1
- package/src/optimize/SimplexEntry.ts +2 -2
- package/src/orbit_determination/BatchLeastSquaresOD.ts +10 -10
- package/src/orbit_determination/BatchLeastSquaresResult.ts +3 -3
- package/src/orbit_determination/GaussIOD.ts +393 -0
- package/src/orbit_determination/GibbsIOD.ts +4 -4
- package/src/orbit_determination/GoodingIOD.ts +458 -160
- package/src/orbit_determination/HerrickGibbsIOD.ts +2 -2
- package/src/orbit_determination/LambertIOD.ts +2 -2
- package/src/orbit_determination/ModifiedGoodingIOD.ts +33 -22
- package/src/orbit_determination/index.ts +8 -7
- package/src/propagator/DormandPrince54Propagator.ts +2 -2
- package/src/propagator/KeplerPropagator.ts +7 -8
- package/src/propagator/Propagator.ts +6 -6
- package/src/propagator/RkCheckpoint.ts +2 -2
- package/src/propagator/RkResult.ts +2 -2
- package/src/propagator/RungeKutta4Propagator.ts +6 -6
- package/src/propagator/RungeKutta89Propagator.ts +2 -2
- package/src/propagator/RungeKuttaAdaptive.ts +62 -12
- package/src/propagator/Sgp4Propagator.ts +7 -7
- package/src/propagator/index.ts +4 -3
- package/src/sgp4/index.ts +3 -2
- package/src/sgp4/sgp4.ts +6 -6
- package/src/smoothing/ExponentialSmoothing.ts +2 -2
- package/src/time/Epoch.ts +3 -3
- package/src/time/EpochGPS.ts +5 -5
- package/src/time/EpochTAI.ts +2 -2
- package/src/time/EpochTDB.ts +2 -2
- package/src/time/EpochTT.ts +2 -2
- package/src/time/EpochUTC.ts +10 -10
- package/src/time/EpochWindow.ts +2 -2
- package/src/time/TimeStamped.ts +2 -2
- package/src/time/index.ts +9 -8
- package/src/transforms/TransformCache.ts +1 -1
- package/src/transforms/conversions.ts +2 -2
- package/src/transforms/index.ts +3 -2
- package/src/transforms/transforms.ts +4 -4
- package/src/types/types.ts +8 -3
- package/src/utils/constants.ts +2 -2
- package/src/utils/create-covariance-from-tle.ts +1 -1
- package/src/utils/functions.ts +10 -5
- package/src/utils/index.ts +6 -5
- package/src/utils/jacobian.ts +2 -2
- package/src/utils/linearDistance.ts +1 -1
|
@@ -0,0 +1,393 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @author Theodore Kruczek
|
|
3
|
+
* @license AGPL-3.0-or-later
|
|
4
|
+
* @copyright (c) 2025 Kruczek Labs LLC
|
|
5
|
+
*
|
|
6
|
+
* Based on the anglesg.m MATLAB implementation by David Vallado
|
|
7
|
+
* Reference: Vallado 2022, Algorithm 52, Example 7-2
|
|
8
|
+
*
|
|
9
|
+
* This procedure solves the problem of orbit determination using three
|
|
10
|
+
* optical sightings using the Gaussian technique. The 8th order polynomial
|
|
11
|
+
* root is found using Halley iteration with canonical units for numerical
|
|
12
|
+
* stability.
|
|
13
|
+
*
|
|
14
|
+
* Orbital Object ToolKit is free software: you can redistribute it and/or modify it under the
|
|
15
|
+
* terms of the GNU Affero General Public License as published by the Free Software
|
|
16
|
+
* Foundation, either version 3 of the License, or (at your option) any later version.
|
|
17
|
+
*
|
|
18
|
+
* Orbital Object ToolKit is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;
|
|
19
|
+
* without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
|
|
20
|
+
* See the GNU Affero General Public License for more details.
|
|
21
|
+
*
|
|
22
|
+
* You should have received a copy of the GNU Affero General Public License along with
|
|
23
|
+
* Orbital Object ToolKit. If not, see <http://www.gnu.org/licenses/>.
|
|
24
|
+
*/
|
|
25
|
+
|
|
26
|
+
import { DEG2RAD, Earth, J2000, Kilometers, KilometersPerSecond, Matrix, Radians, Vector3D } from '@src/main';
|
|
27
|
+
import { ObservationOptical } from '@src/observation/ObservationOptical';
|
|
28
|
+
import { GibbsIOD } from './GibbsIOD';
|
|
29
|
+
import { HerrickGibbsIOD } from './HerrickGibbsIOD';
|
|
30
|
+
|
|
31
|
+
/**
|
|
32
|
+
* Gauss Initial Orbit Determination using three optical observations.
|
|
33
|
+
*
|
|
34
|
+
* This implementation follows Vallado's anglesg.m MATLAB code and uses:
|
|
35
|
+
* - Canonical units for numerical stability when solving the 8th-order polynomial
|
|
36
|
+
* - Halley iteration for root finding (faster convergence than Newton-Raphson)
|
|
37
|
+
* - Gibbs or Herrick-Gibbs methods for velocity determination
|
|
38
|
+
* - Optional iterative refinement (currently disabled)
|
|
39
|
+
*/
|
|
40
|
+
export class GaussIOD {
|
|
41
|
+
/** Maximum iterations for Halley root finding */
|
|
42
|
+
private static readonly MAX_ROOT_ITERATIONS = 15;
|
|
43
|
+
/** Root convergence tolerance in canonical units (Earth radii) */
|
|
44
|
+
private static readonly ROOT_CONVERGENCE_TOL = 8.0e-5;
|
|
45
|
+
/** Angle threshold for determining if observations are too close */
|
|
46
|
+
private static readonly COPLANAR_THRESHOLD: Radians = (1.0 * DEG2RAD) as Radians;
|
|
47
|
+
|
|
48
|
+
private readonly mu_: number;
|
|
49
|
+
private readonly re_: number; // Earth radius in km
|
|
50
|
+
private readonly tusec_: number; // Canonical time unit in seconds
|
|
51
|
+
|
|
52
|
+
constructor(mu: number = Earth.mu, re: number = Earth.radiusEquator) {
|
|
53
|
+
this.mu_ = mu;
|
|
54
|
+
this.re_ = re;
|
|
55
|
+
// Canonical time unit: sqrt(re^3 / mu)
|
|
56
|
+
this.tusec_ = Math.sqrt((re * re * re) / mu);
|
|
57
|
+
}
|
|
58
|
+
|
|
59
|
+
/**
|
|
60
|
+
* Find the root of the 8th degree polynomial using Halley iteration.
|
|
61
|
+
* Uses canonical units (Earth radii) for numerical stability.
|
|
62
|
+
*
|
|
63
|
+
* Polynomial: r^8 + a6*r^6 + a3*r^3 + a0 = 0
|
|
64
|
+
*
|
|
65
|
+
* @param a0 - coefficient of r^0
|
|
66
|
+
* @param a3 - coefficient of r^3
|
|
67
|
+
* @param a6 - coefficient of r^6
|
|
68
|
+
* @returns root in canonical units (Earth radii) or 0 if no valid solution
|
|
69
|
+
*/
|
|
70
|
+
private findRootHalley(a0: number, a3: number, a6: number): number {
|
|
71
|
+
// Initial guess: ~GPS altitude (20000 km) in canonical units
|
|
72
|
+
let r = 20000.0 / this.re_;
|
|
73
|
+
let rPrev = 100.0;
|
|
74
|
+
let iterations = 0;
|
|
75
|
+
|
|
76
|
+
while (Math.abs(r - rPrev) > GaussIOD.ROOT_CONVERGENCE_TOL && iterations < GaussIOD.MAX_ROOT_ITERATIONS) {
|
|
77
|
+
rPrev = r;
|
|
78
|
+
|
|
79
|
+
// Evaluate polynomial and derivatives
|
|
80
|
+
const r2 = r * r;
|
|
81
|
+
const r3 = r2 * r;
|
|
82
|
+
const r5 = r3 * r2;
|
|
83
|
+
const r6 = r5 * r;
|
|
84
|
+
const r7 = r6 * r;
|
|
85
|
+
const r8 = r7 * r;
|
|
86
|
+
|
|
87
|
+
// f(r) = r^8 + a6*r^6 + a3*r^3 + a0
|
|
88
|
+
const f = r8 + a6 * r6 + a3 * r3 + a0;
|
|
89
|
+
|
|
90
|
+
// f'(r) = 8*r^7 + 6*a6*r^5 + 3*a3*r^2
|
|
91
|
+
const fp = 8.0 * r7 + 6.0 * a6 * r5 + 3.0 * a3 * r2;
|
|
92
|
+
|
|
93
|
+
// f''(r) = 56*r^6 + 30*a6*r^4 + 6*a3*r
|
|
94
|
+
const fpp = 56.0 * r6 + 30.0 * a6 * r ** 4 + 6.0 * a3 * r;
|
|
95
|
+
|
|
96
|
+
/* Halley iteration: r_new = r - (2*f*f') / (2*f'^2 - f*f'') */
|
|
97
|
+
r -= (2.0 * f * fp) / (2.0 * fp * fp - f * fpp);
|
|
98
|
+
iterations++;
|
|
99
|
+
}
|
|
100
|
+
|
|
101
|
+
/*
|
|
102
|
+
* Validate result - if negative or beyond GEO+, set to GEO altitude
|
|
103
|
+
*/
|
|
104
|
+
if (r < 0.0 || r * this.re_ > 50000.0) {
|
|
105
|
+
r = 35000.0 / this.re_;
|
|
106
|
+
}
|
|
107
|
+
|
|
108
|
+
return r;
|
|
109
|
+
}
|
|
110
|
+
|
|
111
|
+
/**
|
|
112
|
+
* Estimate a J2000 state from three optical observations using Gauss IOD.
|
|
113
|
+
* Returns null if a valid solution cannot be found.
|
|
114
|
+
*
|
|
115
|
+
* @param o1 - First optical observation
|
|
116
|
+
* @param o2 - Second optical observation (middle)
|
|
117
|
+
* @param o3 - Third optical observation
|
|
118
|
+
* @returns J2000 state at epoch of second observation, or null if solution fails
|
|
119
|
+
*/
|
|
120
|
+
estimate(o1: ObservationOptical, o2: ObservationOptical, o3: ObservationOptical): J2000 | null {
|
|
121
|
+
const tau12 = o1.epoch.difference(o2.epoch);
|
|
122
|
+
const tau32 = o3.epoch.difference(o2.epoch);
|
|
123
|
+
|
|
124
|
+
// Require observations to be spaced in time by at least 10 seconds
|
|
125
|
+
if (Math.abs(tau12) < 10.0 || Math.abs(tau32) < 10.0) {
|
|
126
|
+
return null;
|
|
127
|
+
}
|
|
128
|
+
|
|
129
|
+
/* Build line-of-sight matrices and solve for r2 magnitude */
|
|
130
|
+
const { lmati, l1, l2, l3 } = this.buildLosMatrix_(o1, o2, o3);
|
|
131
|
+
const r2Mag = this.solveForR2Magnitude_(o1, o2, o3, tau12, tau32, lmati, l2);
|
|
132
|
+
|
|
133
|
+
if (r2Mag === 0 || !isFinite(r2Mag)) {
|
|
134
|
+
return null;
|
|
135
|
+
}
|
|
136
|
+
|
|
137
|
+
/* Compute position vectors using slant ranges */
|
|
138
|
+
const { r1, r2, r3 } = this.computePositionVectors_({ o1, o2, o3, tau12, tau32, r2Mag, lmati, l1, l2, l3 });
|
|
139
|
+
|
|
140
|
+
/* Determine velocity using Gibbs, Herrick-Gibbs, or Lagrange */
|
|
141
|
+
const v2 = this.computeVelocity_({ r1, r2, r3, o1, o2, o3, tau12, tau32 });
|
|
142
|
+
|
|
143
|
+
return new J2000(o2.epoch, r2, v2);
|
|
144
|
+
}
|
|
145
|
+
|
|
146
|
+
/**
|
|
147
|
+
* Build line-of-sight matrix and compute its inverse.
|
|
148
|
+
*/
|
|
149
|
+
private buildLosMatrix_(o1: ObservationOptical, o2: ObservationOptical, o3: ObservationOptical) {
|
|
150
|
+
const l1 = o1.observation.lineOfSight();
|
|
151
|
+
const l2 = o2.observation.lineOfSight();
|
|
152
|
+
const l3 = o3.observation.lineOfSight();
|
|
153
|
+
|
|
154
|
+
const losMatrix = Matrix.allZeros(3, 3);
|
|
155
|
+
|
|
156
|
+
losMatrix.elements[0][0] = l1.x;
|
|
157
|
+
losMatrix.elements[1][0] = l1.y;
|
|
158
|
+
losMatrix.elements[2][0] = l1.z;
|
|
159
|
+
losMatrix.elements[0][1] = l2.x;
|
|
160
|
+
losMatrix.elements[1][1] = l2.y;
|
|
161
|
+
losMatrix.elements[2][1] = l2.z;
|
|
162
|
+
losMatrix.elements[0][2] = l3.x;
|
|
163
|
+
losMatrix.elements[1][2] = l3.y;
|
|
164
|
+
losMatrix.elements[2][2] = l3.z;
|
|
165
|
+
|
|
166
|
+
return { lmati: losMatrix.inverse(), l1, l2, l3 };
|
|
167
|
+
}
|
|
168
|
+
|
|
169
|
+
/**
|
|
170
|
+
* Solve for the magnitude of r2 using canonical units and Halley iteration.
|
|
171
|
+
*/
|
|
172
|
+
private solveForR2Magnitude_(
|
|
173
|
+
o1: ObservationOptical,
|
|
174
|
+
o2: ObservationOptical,
|
|
175
|
+
o3: ObservationOptical,
|
|
176
|
+
tau12: number,
|
|
177
|
+
tau32: number,
|
|
178
|
+
lmati: Matrix,
|
|
179
|
+
l2: Vector3D,
|
|
180
|
+
): number {
|
|
181
|
+
/* Switch to canonical time units */
|
|
182
|
+
const tau12c = tau12 / this.tusec_;
|
|
183
|
+
const tau32c = tau32 / this.tusec_;
|
|
184
|
+
|
|
185
|
+
/* Vallado coefficients (equation 7-15, canonical units) */
|
|
186
|
+
const a1c = tau32c / (tau32c - tau12c);
|
|
187
|
+
const a1uc = (tau32c * ((tau32c - tau12c) ** 2 - tau32c * tau32c)) / (6.0 * (tau32c - tau12c));
|
|
188
|
+
const a3c = -tau12c / (tau32c - tau12c);
|
|
189
|
+
const a3uc = (-tau12c * ((tau32c - tau12c) ** 2 - tau12c * tau12c)) / (6.0 * (tau32c - tau12c));
|
|
190
|
+
|
|
191
|
+
/* Build site position matrix in canonical units */
|
|
192
|
+
const rsMatrixCanonical = this.buildSiteMatrixCanonical_(o1, o2, o3);
|
|
193
|
+
|
|
194
|
+
/* M matrix in canonical units: M = inv(LOS) * R_site */
|
|
195
|
+
const lir = lmati.multiply(rsMatrixCanonical);
|
|
196
|
+
|
|
197
|
+
/* Compute d1 and d2 coefficients (Vallado equation 7-15) */
|
|
198
|
+
const d1c = lir.elements[1][0] * a1c - lir.elements[1][1] + lir.elements[1][2] * a3c;
|
|
199
|
+
const d2c = lir.elements[1][0] * a1uc + lir.elements[1][2] * a3uc;
|
|
200
|
+
|
|
201
|
+
const s2 = o2.site.position;
|
|
202
|
+
const rs2c = new Vector3D(s2.x / this.re_, s2.y / this.re_, s2.z / this.re_);
|
|
203
|
+
const magrs2c = rs2c.magnitude();
|
|
204
|
+
const l2dotrs = l2.x * rs2c.x + l2.y * rs2c.y + l2.z * rs2c.z;
|
|
205
|
+
|
|
206
|
+
/*
|
|
207
|
+
* Solve 8th degree polynomial (Vallado equation 7-16)
|
|
208
|
+
* Note: mu is 1.0 in canonical units
|
|
209
|
+
*/
|
|
210
|
+
const poly0 = -d2c * d2c;
|
|
211
|
+
const poly3 = -2.0 * (l2dotrs * d2c + d1c * d2c);
|
|
212
|
+
const poly6 = -(d1c * d1c + 2.0 * d1c * l2dotrs + magrs2c * magrs2c);
|
|
213
|
+
|
|
214
|
+
const r2MagCanonical = this.findRootHalley(poly0, poly3, poly6);
|
|
215
|
+
|
|
216
|
+
return r2MagCanonical * this.re_;
|
|
217
|
+
}
|
|
218
|
+
|
|
219
|
+
/**
|
|
220
|
+
* Build site position matrix in canonical units.
|
|
221
|
+
*/
|
|
222
|
+
private buildSiteMatrixCanonical_(o1: ObservationOptical, o2: ObservationOptical, o3: ObservationOptical): Matrix {
|
|
223
|
+
const s1 = o1.site.position;
|
|
224
|
+
const s2 = o2.site.position;
|
|
225
|
+
const s3 = o3.site.position;
|
|
226
|
+
const rsMatrixCanonical = Matrix.allZeros(3, 3);
|
|
227
|
+
|
|
228
|
+
rsMatrixCanonical.elements[0][0] = s1.x / this.re_;
|
|
229
|
+
rsMatrixCanonical.elements[1][0] = s1.y / this.re_;
|
|
230
|
+
rsMatrixCanonical.elements[2][0] = s1.z / this.re_;
|
|
231
|
+
rsMatrixCanonical.elements[0][1] = s2.x / this.re_;
|
|
232
|
+
rsMatrixCanonical.elements[1][1] = s2.y / this.re_;
|
|
233
|
+
rsMatrixCanonical.elements[2][1] = s2.z / this.re_;
|
|
234
|
+
rsMatrixCanonical.elements[0][2] = s3.x / this.re_;
|
|
235
|
+
rsMatrixCanonical.elements[1][2] = s3.y / this.re_;
|
|
236
|
+
rsMatrixCanonical.elements[2][2] = s3.z / this.re_;
|
|
237
|
+
|
|
238
|
+
return rsMatrixCanonical;
|
|
239
|
+
}
|
|
240
|
+
|
|
241
|
+
/**
|
|
242
|
+
* Compute satellite position vectors from slant ranges.
|
|
243
|
+
*/
|
|
244
|
+
private computePositionVectors_(params: {
|
|
245
|
+
o1: ObservationOptical;
|
|
246
|
+
o2: ObservationOptical;
|
|
247
|
+
o3: ObservationOptical;
|
|
248
|
+
tau12: number;
|
|
249
|
+
tau32: number;
|
|
250
|
+
r2Mag: number;
|
|
251
|
+
lmati: Matrix;
|
|
252
|
+
l1: Vector3D;
|
|
253
|
+
l2: Vector3D;
|
|
254
|
+
l3: Vector3D;
|
|
255
|
+
}) {
|
|
256
|
+
const { o1, o2, o3, tau12, tau32, r2Mag, lmati, l1, l2, l3 } = params;
|
|
257
|
+
/* Vallado coefficients in regular units */
|
|
258
|
+
const a1 = tau32 / (tau32 - tau12);
|
|
259
|
+
const a1u = (tau32 * ((tau32 - tau12) ** 2 - tau32 * tau32)) / (6.0 * (tau32 - tau12));
|
|
260
|
+
const a3 = -tau12 / (tau32 - tau12);
|
|
261
|
+
const a3u = (-tau12 * ((tau32 - tau12) ** 2 - tau12 * tau12)) / (6.0 * (tau32 - tau12));
|
|
262
|
+
|
|
263
|
+
const s1 = o1.site.position;
|
|
264
|
+
const s2 = o2.site.position;
|
|
265
|
+
const s3 = o3.site.position;
|
|
266
|
+
|
|
267
|
+
/* Build site matrix in regular units (km) */
|
|
268
|
+
const rsMatrix = Matrix.allZeros(3, 3);
|
|
269
|
+
|
|
270
|
+
rsMatrix.elements[0][0] = s1.x;
|
|
271
|
+
rsMatrix.elements[1][0] = s1.y;
|
|
272
|
+
rsMatrix.elements[2][0] = s1.z;
|
|
273
|
+
rsMatrix.elements[0][1] = s2.x;
|
|
274
|
+
rsMatrix.elements[1][1] = s2.y;
|
|
275
|
+
rsMatrix.elements[2][1] = s2.z;
|
|
276
|
+
rsMatrix.elements[0][2] = s3.x;
|
|
277
|
+
rsMatrix.elements[1][2] = s3.y;
|
|
278
|
+
rsMatrix.elements[2][2] = s3.z;
|
|
279
|
+
|
|
280
|
+
const lirKm = lmati.multiply(rsMatrix);
|
|
281
|
+
const u = this.mu_ / (r2Mag * r2Mag * r2Mag);
|
|
282
|
+
|
|
283
|
+
/* Slant range coefficients */
|
|
284
|
+
const c1 = a1 + a1u * u;
|
|
285
|
+
const c2 = -1.0;
|
|
286
|
+
const c3 = a3 + a3u * u;
|
|
287
|
+
|
|
288
|
+
const cMat = new Matrix([[-c1], [-c2], [-c3]]);
|
|
289
|
+
const rhoMat = lirKm.multiply(cMat);
|
|
290
|
+
|
|
291
|
+
const rho1 = rhoMat.elements[0][0] / c1;
|
|
292
|
+
const rho2 = rhoMat.elements[1][0] / c2;
|
|
293
|
+
const rho3 = rhoMat.elements[2][0] / c3;
|
|
294
|
+
|
|
295
|
+
const r1 = new Vector3D<Kilometers>(
|
|
296
|
+
(rho1 * l1.x + s1.x) as Kilometers,
|
|
297
|
+
(rho1 * l1.y + s1.y) as Kilometers,
|
|
298
|
+
(rho1 * l1.z + s1.z) as Kilometers,
|
|
299
|
+
);
|
|
300
|
+
const r2 = new Vector3D<Kilometers>(
|
|
301
|
+
(rho2 * l2.x + s2.x) as Kilometers,
|
|
302
|
+
(rho2 * l2.y + s2.y) as Kilometers,
|
|
303
|
+
(rho2 * l2.z + s2.z) as Kilometers,
|
|
304
|
+
);
|
|
305
|
+
const r3 = new Vector3D<Kilometers>(
|
|
306
|
+
(rho3 * l3.x + s3.x) as Kilometers,
|
|
307
|
+
(rho3 * l3.y + s3.y) as Kilometers,
|
|
308
|
+
(rho3 * l3.z + s3.z) as Kilometers,
|
|
309
|
+
);
|
|
310
|
+
|
|
311
|
+
return { r1, r2, r3 };
|
|
312
|
+
}
|
|
313
|
+
|
|
314
|
+
/**
|
|
315
|
+
* Compute velocity using Gibbs, Herrick-Gibbs, or Lagrange method.
|
|
316
|
+
*/
|
|
317
|
+
private computeVelocity_(params: {
|
|
318
|
+
r1: Vector3D<Kilometers>;
|
|
319
|
+
r2: Vector3D<Kilometers>;
|
|
320
|
+
r3: Vector3D<Kilometers>;
|
|
321
|
+
o1: ObservationOptical;
|
|
322
|
+
o2: ObservationOptical;
|
|
323
|
+
o3: ObservationOptical;
|
|
324
|
+
tau12: number;
|
|
325
|
+
tau32: number;
|
|
326
|
+
}): Vector3D<KilometersPerSecond> {
|
|
327
|
+
const { r1, r2, r3, o1, o2, o3, tau12, tau32 } = params;
|
|
328
|
+
const theta1 = this.angle_(r1, r2);
|
|
329
|
+
const theta2 = this.angle_(r2, r3);
|
|
330
|
+
|
|
331
|
+
if (Math.abs(theta1) < GaussIOD.COPLANAR_THRESHOLD || Math.abs(theta2) < GaussIOD.COPLANAR_THRESHOLD) {
|
|
332
|
+
const hgibbs = new HerrickGibbsIOD(this.mu_);
|
|
333
|
+
|
|
334
|
+
try {
|
|
335
|
+
return hgibbs.solve(r1, o1.epoch, r2, o2.epoch, r3, o3.epoch).velocity;
|
|
336
|
+
} catch {
|
|
337
|
+
return this.velocityFromLagrange_(r1, r2, r3, tau12, tau32);
|
|
338
|
+
}
|
|
339
|
+
}
|
|
340
|
+
const gibbs = new GibbsIOD(this.mu_);
|
|
341
|
+
|
|
342
|
+
try {
|
|
343
|
+
return gibbs.solve(r1, r2, r3, o2.epoch, o3.epoch).velocity;
|
|
344
|
+
} catch {
|
|
345
|
+
return this.velocityFromLagrange_(r1, r2, r3, tau12, tau32);
|
|
346
|
+
}
|
|
347
|
+
}
|
|
348
|
+
|
|
349
|
+
/**
|
|
350
|
+
* Calculate velocity using simplified Lagrange f and g series.
|
|
351
|
+
* This is a fallback method when Gibbs/Herrick-Gibbs cannot be used.
|
|
352
|
+
*/
|
|
353
|
+
private velocityFromLagrange_(
|
|
354
|
+
r1: Vector3D<Kilometers>,
|
|
355
|
+
r2: Vector3D<Kilometers>,
|
|
356
|
+
r3: Vector3D<Kilometers>,
|
|
357
|
+
tau12: number,
|
|
358
|
+
tau32: number,
|
|
359
|
+
): Vector3D<KilometersPerSecond> {
|
|
360
|
+
const magr2 = r2.magnitude();
|
|
361
|
+
const magr2Cubed = magr2 * magr2 * magr2;
|
|
362
|
+
|
|
363
|
+
// Second-order Lagrange f and g functions (Vallado section 2.3.1)
|
|
364
|
+
const f1 = 1.0 - (0.5 * this.mu_ * tau12 * tau12) / magr2Cubed;
|
|
365
|
+
const f3 = 1.0 - (0.5 * this.mu_ * tau32 * tau32) / magr2Cubed;
|
|
366
|
+
const g1 = tau12 - ((1.0 / 6.0) * this.mu_ * tau12 * tau12 * tau12) / magr2Cubed;
|
|
367
|
+
const g3 = tau32 - ((1.0 / 6.0) * this.mu_ * tau32 * tau32 * tau32) / magr2Cubed;
|
|
368
|
+
|
|
369
|
+
const denom = f1 * g3 - f3 * g1;
|
|
370
|
+
|
|
371
|
+
// Velocity at middle observation (Vallado equation 7-17)
|
|
372
|
+
const v2x = ((r3.x * f1 - r1.x * f3) / denom) as KilometersPerSecond;
|
|
373
|
+
const v2y = ((r3.y * f1 - r1.y * f3) / denom) as KilometersPerSecond;
|
|
374
|
+
const v2z = ((r3.z * f1 - r1.z * f3) / denom) as KilometersPerSecond;
|
|
375
|
+
|
|
376
|
+
return new Vector3D<KilometersPerSecond>(v2x, v2y, v2z);
|
|
377
|
+
}
|
|
378
|
+
|
|
379
|
+
/**
|
|
380
|
+
* Calculate the angle between two position vectors.
|
|
381
|
+
*/
|
|
382
|
+
private angle_(r1: Vector3D, r2: Vector3D): Radians {
|
|
383
|
+
const magr1 = r1.magnitude();
|
|
384
|
+
const magr2 = r2.magnitude();
|
|
385
|
+
const dot = r1.dot(r2);
|
|
386
|
+
const cosAngle = dot / (magr1 * magr2);
|
|
387
|
+
|
|
388
|
+
// Clamp to avoid numerical issues with acos
|
|
389
|
+
const clamped = Math.max(-1.0, Math.min(1.0, cosAngle));
|
|
390
|
+
|
|
391
|
+
return Math.acos(clamped) as Radians;
|
|
392
|
+
}
|
|
393
|
+
}
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* @author
|
|
2
|
+
* @author Theodore Kruczek
|
|
3
3
|
* @license AGPL-3.0-or-later
|
|
4
4
|
* @copyright (c) 2025 Kruczek Labs LLC
|
|
5
5
|
*
|
|
@@ -17,9 +17,9 @@
|
|
|
17
17
|
|
|
18
18
|
import {
|
|
19
19
|
DEG2RAD, Earth, EpochUTC, halfPi, J2000, Kilometers, KilometersPerSecond, Radians, Vector3D,
|
|
20
|
-
} from '../main
|
|
21
|
-
import { ForceModel } from './../force/ForceModel
|
|
22
|
-
import { RungeKutta89Propagator } from './../propagator/RungeKutta89Propagator
|
|
20
|
+
} from '../main';
|
|
21
|
+
import { ForceModel } from './../force/ForceModel';
|
|
22
|
+
import { RungeKutta89Propagator } from './../propagator/RungeKutta89Propagator';
|
|
23
23
|
|
|
24
24
|
/**
|
|
25
25
|
* Gibbs 3-position inital orbit determination.
|