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

Class AbstractShortTermEncounter1DNumerical2DPOCMethod

    • Constructor Detail

      • AbstractShortTermEncounter1DNumerical2DPOCMethod

        protected AbstractShortTermEncounter1DNumerical2DPOCMethod​(String name,
                                                           UnivariateIntegrator integrator,
                                                           int maxNbOfEval)
        Customizable constructor.
        Parameters:
        name - name of the method
        integrator - integrator
        maxNbOfEval - max number of evaluation

    • Method Detail

      • compute

        public ProbabilityOfCollision compute​(Cdm cdm,
                                      double primaryRadius,
                                      double secondaryRadius,
                                      UnivariateIntegrator customIntegrator,
                                      int customMaxNbOfEval,
                                      double zeroThreshold)
        Compute the probability of collision using an Orekit Conjunction Data Message.
        Parameters:
        cdm - conjunction data message input
        primaryRadius - primary collision object equivalent sphere radius (m)
        secondaryRadius - secondary collision object equivalent sphere radius (m)
        customIntegrator - different univariate function numerical integrator than the one defined in the instance
        customMaxNbOfEval - different maximum number of function evaluation when integrating than the one defined in the instance
        zeroThreshold - threshold below which values are considered equal to zero
        Returns:
        probability of collision

      • compute

        public <T extends CalculusFieldElement<T>> FieldProbabilityOfCollision<T> compute​(Cdm cdm,
                                                                                  T primaryRadius,
                                                                                  T secondaryRadius,
                                                                                  FieldUnivariateIntegrator<T> customIntegrator,
                                                                                  int customMaxNbOfEval,
                                                                                  double zeroThreshold)
        Compute the probability of collision using an Orekit Conjunction Data Message.
        Type Parameters:
        T - type of the field elements
        Parameters:
        cdm - conjunction data message
        primaryRadius - primary collision object equivalent sphere radius (m)
        secondaryRadius - secondary collision object equivalent sphere radius (m)
        zeroThreshold - threshold below which values are considered equal to zero
        customIntegrator - different univariate function numerical integrator than the one defined in the instance
        customMaxNbOfEval - different maximum number of function evaluation when integrating than the one defined in the instance
        Returns:
        probability of collision

      • compute

        public ProbabilityOfCollision compute​(Orbit primaryAtTCA,
                                      StateCovariance primaryCovariance,
                                      double primaryRadius,
                                      Orbit secondaryAtTCA,
                                      StateCovariance secondaryCovariance,
                                      double secondaryRadius,
                                      UnivariateIntegrator customIntegrator,
                                      int customMaxNbOfEval,
                                      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
        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)
        customIntegrator - different univariate function numerical integrator than the one defined in the instance
        customMaxNbOfEval - different maximum number of function evaluation when integrating than the one defined in the instance
        zeroThreshold - threshold below which values are considered equal to zero
        Returns:
        probability of collision

      • compute

        public <T extends CalculusFieldElement<T>> FieldProbabilityOfCollision<T> compute​(FieldOrbit<T> primaryAtTCA,
                                                                                  FieldStateCovariance<T> primaryCovariance,
                                                                                  T primaryRadius,
                                                                                  FieldOrbit<T> secondaryAtTCA,
                                                                                  FieldStateCovariance<T> secondaryCovariance,
                                                                                  T secondaryRadius,
                                                                                  FieldUnivariateIntegrator<T> customIntegrator,
                                                                                  int customMaxNbOfEval,
                                                                                  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
        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)
        customIntegrator - different univariate function numerical integrator than the one defined in the instance
        customMaxNbOfEval - different maximum number of function evaluation when integrating than the one defined in the instance
        zeroThreshold - threshold below which values are considered equal to zero
        Returns:
        probability of collision

      • compute

        public ProbabilityOfCollision compute​(ShortTermEncounter2DDefinition encounterDefinition,
                                      UnivariateIntegrator customIntegrator,
                                      int customMaxNbOfEval,
                                      double zeroThreshold)
        Compute the probability of collision using a given collision definition.
        Parameters:
        encounterDefinition - probabilityOfCollision definition between a primary and a secondary collision object
        customIntegrator - different univariate function numerical integrator than the one defined in the instance
        customMaxNbOfEval - different maximum number of function evaluation when integrating than the one defined in the instance
        zeroThreshold - threshold below which values are considered equal to zero
        Returns:
        probability of collision

      • compute

        public <T extends CalculusFieldElement<T>> FieldProbabilityOfCollision<T> compute​(FieldShortTermEncounter2DDefinition<T> encounterDefinition,
                                                                                  FieldUnivariateIntegrator<T> customIntegrator,
                                                                                  int customMaxNbOfEval,
                                                                                  double zeroThreshold)
        Compute the probability of collision using given collision definition.
        Type Parameters:
        T - type of the field element
        Parameters:
        encounterDefinition - encounter definition between a primary and a secondary collision object
        customIntegrator - custom integrator to use in place of the integrator from the constructor
        customMaxNbOfEval - custom maximum number of evaluations to use in place of the custom maximum number from the
        zeroThreshold - threshold below which values are considered equal to zero
        Returns:
        probability of collision

      • compute

        public 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.

        It uses the defaults integrator and maximum number of function evaluation when integrating.

        Specified by:
        compute in interface ShortTermEncounter2DPOCMethod
        Specified by:
        compute in class AbstractShortTermEncounter2DPOCMethod
        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

        public <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.

        Specified by:
        compute in interface ShortTermEncounter2DPOCMethod
        Specified by:
        compute in class AbstractShortTermEncounter2DPOCMethod
        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

      • compute

        public abstract ProbabilityOfCollision compute​(double xm,
                                               double ym,
                                               double sigmaX,
                                               double sigmaY,
                                               double radius,
                                               UnivariateIntegrator customIntegrator,
                                               int customMaxNbOfEval)
        Compute the probability of collision using arguments specific to the rotated encounter frame and custom numerical configuration.

        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)
        customIntegrator - custom integrator to use in place of the integrator from the constructor
        customMaxNbOfEval - custom maximum number of evaluations to use in place of the custom maximum number from the constructor
        Returns:
        probability of collision

      • compute

        public abstract <T extends CalculusFieldElement<T>> FieldProbabilityOfCollision<T> compute​(T xm,
                                                                                           T ym,
                                                                                           T sigmaX,
                                                                                           T sigmaY,
                                                                                           T radius,
                                                                                           FieldUnivariateIntegrator<T> customIntegrator,
                                                                                           int customMaxNbOfEval)
        Compute the probability of collision using arguments specific to the rotated encounter frame and custom numerical configuration.

        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 element
        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)
        customIntegrator - custom integrator to use in place of the integrator from the constructor
        customMaxNbOfEval - custom maximum number of evaluations to use in place of the custom maximum number from the constructor
        Returns:
        probability of collision