agi.foundation.propagators

(agi.foundation.models-2025r1.jar)

Class Sgp4ElementsSwitchByClosestApproach

java.lang.Object

agi.foundation.propagators.Sgp4ElementsSwitching

agi.foundation.propagators.Sgp4ElementsSwitchByClosestApproach

public class Sgp4ElementsSwitchByClosestApproach
extends Sgp4ElementsSwitching

An algorithm which determines when to switch from one element set to another by propagating each element set against the next to determine the time at which the range between the positions of the two orbits is the smallest. This may not represent the most accurate position for the orbit at all times. However, it will minimize discontinuities which may result from fitting the newer element set to the correct orbit.

Constructor Summary

Constructors

Constructor and Description
Sgp4ElementsSwitchByClosestApproach() Create a new instance using a default Sgp4Propagator to test the element sets.
Sgp4ElementsSwitchByClosestApproach(Sgp4Propagator propagator) Create a new instance using the given propagator to test the element sets.

Method Summary

Modifier and Type	Method and Description
Sgp4Propagator	getPropagator() Gets the propagator used to test for the closest approach between two element sets.
JulianDate	getSwitchTime(Sgp4Elements previous, Sgp4Elements next) Determine the intervals of time covered by each element set.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Sgp4ElementsSwitchByClosestApproach

public Sgp4ElementsSwitchByClosestApproach()

Create a new instance using a default Sgp4Propagator to test the element sets.

Sgp4ElementsSwitchByClosestApproach

public Sgp4ElementsSwitchByClosestApproach(@Nonnull
                                           Sgp4Propagator propagator)

Create a new instance using the given propagator to test the element sets.

Parameters:

propagator - The propagator to use to test the element sets.

Method Detail

getPropagator

public final Sgp4Propagator getPropagator()

Gets the propagator used to test for the closest approach between two element sets.

getSwitchTime

@Nonnull
public JulianDate getSwitchTime(Sgp4Elements previous,
                                          Sgp4Elements next)

Determine the intervals of time covered by each element set. The intervals should not overlap.

Specified by:

getSwitchTime in class Sgp4ElementsSwitching

Parameters:

previous - The previous element set from which to transition.

next - The next element set to which to transition.

Returns:

The intervals of time and their corresponding element sets.