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 Detail

      • DEFAULT_ZERO_THRESHOLD

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

    • Method Detail

      • 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

        <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

      • 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