Package org.orekit.ssa.collision.shorttermencounter.probability.twod

Interface ShortTermEncounter2DPOCMethod

All Known Implementing Classes:
AbstractAlfriend1999, AbstractShortTermEncounter1DNumerical2DPOCMethod, AbstractShortTermEncounter2DPOCMethod, Alfano2005, Alfriend1999, Alfriend1999Max, Chan1997, Laas2015, Patera2005
public interface ShortTermEncounter2DPOCMethod
Interface common to all short-term encounter probability of collision computing methods.

All the methods implementing this interface will at least assume the followings :

  • Short term encounter leading to a linear relative motion.
  • Spherical collision object.
  • Uncorrelated positional covariance.
  • Gaussian distribution of the position uncertainties.
  • Deterministic velocity i.e. no velocity uncertainties.
As listed in the assumptions, methods implementing this interface are to be used in short encounter, meaning that there must be a high relative velocity. For ease of computation, the resulting swept volume is extended to infinity so that the integral becomes bivariate instead of trivariate (conservative hypothesis).

Consequently and if we consider Earth, methods implementing this interface are recommended for collision happening in Low/Medium Earth Orbit (LEO and MEO) but are not recommended for collision happening in Geostationary Earth Orbit (GEO).

Since:
12.0
Author:
Vincent Cucchietti

  • Field Details

    • DEFAULT_ZERO_THRESHOLD

      static final double DEFAULT_ZERO_THRESHOLD
      Threshold below which values are considered equal to zero.
      See Also:

  • Method Details

    • compute

      default ProbabilityOfCollision compute(Cdm cdm, double primaryRadius, double secondaryRadius)
      Compute the probability of collision using a Conjunction Data Message (CDM).
      Parameters:
      cdm - conjunction data message input
      primaryRadius - primary collision object equivalent sphere radius (m)
      secondaryRadius - secondary collision object equivalent sphere radius (m)
      Returns:
      probability of collision

    • compute

      ProbabilityOfCollision compute(Cdm cdm, double combinedRadius)
      Compute the probability of collision using a Conjunction Data Message (CDM).
      Parameters:
      cdm - conjunction data message input
      combinedRadius - combined radius (m)
      Returns:
      probability of collision

    • compute

      default <T extends CalculusFieldElement<T>> FieldProbabilityOfCollision<T> compute(Cdm cdm, T primaryRadius, T secondaryRadius)
      Compute the probability of collision using a Conjunction Data Message (CDM).
      Type Parameters:
      T - type of the field elements
      Parameters:
      cdm - conjunction data message input
      primaryRadius - primary collision object equivalent sphere radius (m)
      secondaryRadius - secondary collision object equivalent sphere radius (m)
      Returns:
      probability of collision

    • compute

      default <T extends CalculusFieldElement<T>> FieldProbabilityOfCollision<T> compute(Cdm cdm, T combinedRadius)
      Compute the probability of collision using a Conjunction Data Message (CDM).
      Type Parameters:
      T - type of the field elements
      Parameters:
      cdm - conjunction data message input
      combinedRadius - combined radius (m)
      Returns:
      probability of collision

    • compute

      <T extends CalculusFieldElement<T>> FieldProbabilityOfCollision<T> compute(Cdm cdm, T combinedRadius, double zeroThreshold)
      Compute the probability of collision using a Conjunction Data Message (CDM).
      Type Parameters:
      T - type of the field elements
      Parameters:
      cdm - conjunction data message input
      combinedRadius - combined radius (m)
      zeroThreshold - threshold below which values are considered equal to zero
      Returns:
      probability of collision

    • compute

      default ProbabilityOfCollision compute(Orbit primaryAtTCA, StateCovariance primaryCovariance, double primaryRadius, Orbit secondaryAtTCA, StateCovariance secondaryCovariance, double secondaryRadius)
      Compute the probability of collision using parameters necessary for creating a collision definition instance.
      Parameters:
      primaryAtTCA - primary collision object spacecraft state at time of closest approach
      primaryCovariance - primary collision object covariance
      primaryRadius - primary collision object equivalent sphere radius (m)
      secondaryAtTCA - secondary collision object spacecraft state at time of closest approach
      secondaryCovariance - secondary collision object covariance
      secondaryRadius - secondary collision object equivalent sphere radius (m)
      Returns:
      probability of collision

    • compute

      default ProbabilityOfCollision compute(Orbit primaryAtTCA, StateCovariance primaryCovariance, Orbit secondaryAtTCA, StateCovariance secondaryCovariance, double combinedRadius)
      Compute the probability of collision using parameters necessary for creating a collision definition instance.
      Parameters:
      primaryAtTCA - primary collision object spacecraft state at time of closest approach
      primaryCovariance - primary collision object covariance
      secondaryAtTCA - secondary collision object spacecraft state at time of closest approach
      secondaryCovariance - secondary collision object covariance
      combinedRadius - combined radius (m)
      Returns:
      probability of collision

    • compute

      ProbabilityOfCollision compute(Orbit primaryAtTCA, StateCovariance primaryCovariance, Orbit secondaryAtTCA, StateCovariance secondaryCovariance, double combinedRadius, double zeroThreshold)
      Compute the probability of collision using parameters necessary for creating a collision definition instance.
      Parameters:
      primaryAtTCA - primary collision object spacecraft state at time of closest approach
      primaryCovariance - primary collision object covariance
      secondaryAtTCA - secondary collision object spacecraft state at time of closest approach
      secondaryCovariance - secondary collision object covariance
      combinedRadius - combined radius (m)
      zeroThreshold - threshold below which values are considered equal to zero
      Returns:
      probability of collision

    • compute

      default <T extends CalculusFieldElement<T>> FieldProbabilityOfCollision<T> compute(FieldOrbit<T> primaryAtTCA, FieldStateCovariance<T> primaryCovariance, T primaryRadius, FieldOrbit<T> secondaryAtTCA, FieldStateCovariance<T> secondaryCovariance, T secondaryRadius)
      Compute the probability of collision using parameters necessary for creating a collision definition instance.
      Type Parameters:
      T - type of the field elements
      Parameters:
      primaryAtTCA - primary collision object spacecraft state at time of closest approach
      primaryCovariance - primary collision object covariance
      primaryRadius - primary collision object equivalent sphere radius (m)
      secondaryAtTCA - secondary collision object spacecraft state at time of closest approach
      secondaryCovariance - secondary collision object covariance
      secondaryRadius - secondary collision object equivalent sphere radius (m)
      Returns:
      probability of collision

    • compute

      default <T extends CalculusFieldElement<T>> FieldProbabilityOfCollision<T> compute(FieldOrbit<T> primaryAtTCA, FieldStateCovariance<T> primaryCovariance, FieldOrbit<T> secondaryAtTCA, FieldStateCovariance<T> secondaryCovariance, T combinedRadius)
      Compute the probability of collision using parameters necessary for creating a collision definition instance.
      Type Parameters:
      T - type of the field elements
      Parameters:
      primaryAtTCA - primary collision object spacecraft state at time of closest approach
      primaryCovariance - primary collision object covariance
      secondaryAtTCA - secondary collision object spacecraft state at time of closest approach
      secondaryCovariance - secondary collision object covariance
      combinedRadius - secondary collision object equivalent sphere radius (m)
      Returns:
      probability of collision

    • compute

      <T extends CalculusFieldElement<T>> FieldProbabilityOfCollision<T> compute(FieldOrbit<T> primaryAtTCA, FieldStateCovariance<T> primaryCovariance, FieldOrbit<T> secondaryAtTCA, FieldStateCovariance<T> secondaryCovariance, T combinedRadius, double zeroThreshold)
      Compute the probability of collision using parameters necessary for creating a collision definition instance.
      Type Parameters:
      T - type of the field elements
      Parameters:
      primaryAtTCA - primary collision object spacecraft state at time of closest approach
      primaryCovariance - primary collision object covariance
      secondaryAtTCA - secondary collision object spacecraft state at time of closest approach
      secondaryCovariance - secondary collision object covariance
      combinedRadius - combined radius (m)
      zeroThreshold - threshold below which values are considered equal to zero
      Returns:
      probability of collision

    • compute

      default ProbabilityOfCollision compute(ShortTermEncounter2DDefinition encounter)
      Compute the probability of collision using given collision definition.
      Parameters:
      encounter - encounter definition between a primary and a secondary collision object
      Returns:
      probability of collision

    • compute

      ProbabilityOfCollision compute(ShortTermEncounter2DDefinition encounter, double zeroThreshold)
      Compute the probability of collision using given collision definition.
      Parameters:
      encounter - encounter definition between a primary and a secondary collision object
      zeroThreshold - threshold below which values are considered equal to zero
      Returns:
      probability of collision

    • compute

      default <T extends CalculusFieldElement<T>> FieldProbabilityOfCollision<T> compute(FieldShortTermEncounter2DDefinition<T> encounter)
      Compute the probability of collision using given collision definition.
      Type Parameters:
      T - type of the field elements
      Parameters:
      encounter - encounter definition between a primary and a secondary collision object
      Returns:
      probability of collision

    • compute

      <T extends CalculusFieldElement<T>> FieldProbabilityOfCollision<T> compute(FieldShortTermEncounter2DDefinition<T> encounter, double zeroThreshold)
      Compute the probability of collision using given collision definition.
      Type Parameters:
      T - type of the field elements
      Parameters:
      encounter - encounter definition between a primary and a secondary collision object
      zeroThreshold - threshold below which values are considered equal to zero
      Returns:
      probability of collision

    • compute

      ProbabilityOfCollision compute(double xm, double ym, double sigmaX, double sigmaY, double radius)
      Compute the probability of collision using arguments specific to the rotated encounter frame.

      The rotated encounter frame is define by the initial encounter frame (defined in ShortTermEncounter2DDefinition) rotated by the rotation matrix which is used to diagonalize the combined covariance matrix.

      Parameters:
      xm - other collision object projected position onto the collision plane in the rotated encounter frame x-axis (m)
      ym - other collision object projected position onto the collision plane in the rotated encounter frame y-axis (m)
      sigmaX - square root of the x-axis eigen value of the diagonalized combined covariance matrix projected onto the collision plane (m)
      sigmaY - square root of the y-axis eigen value of the diagonalized combined covariance matrix projected onto the collision plane (m)
      radius - sum of primary and secondary collision object equivalent sphere radii (m)
      Returns:
      probability of collision

    • compute

      <T extends CalculusFieldElement<T>> FieldProbabilityOfCollision<T> compute(T xm, T ym, T sigmaX, T sigmaY, T radius)
      Compute the probability of collision using arguments specific to the rotated encounter frame.

      The rotated encounter frame is define by the initial encounter frame (defined in ShortTermEncounter2DDefinition) rotated by the rotation matrix which is used to diagonalize the combined covariance matrix.

      Type Parameters:
      T - type of the field elements
      Parameters:
      xm - other collision object projected position onto the collision plane in the rotated encounter frame x-axis (m)
      ym - other collision object projected position onto the collision plane in the rotated encounter frame y-axis (m)
      sigmaX - square root of the x-axis eigen value of the diagonalized combined covariance matrix projected onto the collision plane (m)
      sigmaY - square root of the y-axis eigen value of the diagonalized combined covariance matrix projected onto the collision plane (m)
      radius - sum of primary and secondary collision object equivalent sphere radii (m)
      Returns:
      probability of collision

    • getType

      ShortTermEncounter2DPOCMethodType getType()
      Get type of the method.
      Returns:
      type of the method

    • getName

      String getName()
      Get name of the method.
      Returns:
      name of the method

    • isAMaximumProbabilityOfCollisionMethod

      boolean isAMaximumProbabilityOfCollisionMethod()
      Get flag that defines if the method is a maximum probability of collision computing method.
      Returns:
      flag that defines if the method is a maximum probability of collision computing method