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

Class AbstractShortTermEncounter1DNumerical2DPOCMethod

java.lang.Object
org.orekit.ssa.collision.shorttermencounter.probability.twod.AbstractShortTermEncounter2DPOCMethod
org.orekit.ssa.collision.shorttermencounter.probability.twod.AbstractShortTermEncounter1DNumerical2DPOCMethod
All Implemented Interfaces:
ShortTermEncounter2DPOCMethod
Direct Known Subclasses:
Patera2005
public abstract class AbstractShortTermEncounter1DNumerical2DPOCMethod extends AbstractShortTermEncounter2DPOCMethod
This abstract class serves as a foundation to create 1D numerical 2D probability of collision computing method.
Since:
12.0
Author:
Vincent Cucchietti

  • Constructor Details

    • 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 Details

    • 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)
      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(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.

      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.

      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