Package org.orekit.rugged.errors

Class DumpManager

  • public class DumpManager
extends Object
    Class managing debug dumps.

    WARNING: this class is public only for technical reasons, it is not considered to belong to the public API of the library and should not be called by user code. It is only intended to be called internally by the Rugged library itself. This class may be changed or even removed at any time, so user code should not rely on it.

    Author:
    Luc Maisonobe, Guylaine Prat

    • Method Detail

      • activate

        public static void activate​(File file)
        Activate debug dump.
        Parameters:
        file - dump file

      • deactivate

        public static void deactivate()
        Deactivate debug dump.

      • suspend

        public static Boolean suspend()
        Suspend the dump. In case the dump is already suspended, keep the previous status in order to correctly deal the resume stage.
        Returns:
        a flag to tell if the dump is already suspended (true; false otherwise)

      • resume

        public static void resume​(Boolean wasSuspended)
        Resume the dump, only if it was not already suspended.
        Parameters:
        wasSuspended - flag to tell if the dump was already suspended (true; false otherwise)

      • endNicely

        public static void endNicely()
        In case dump is suspended and an exception is thrown, allows the dump to end nicely.

      • isActive

        public static boolean isActive()
        Check if dump is active for this thread.
        Returns:
        true if dump is active for this thread

      • dumpTileCell

        public static void dumpTileCell​(Tile tile,
                                int latitudeIndex,
                                int longitudeIndex,
                                double elevation)
        Dump DEM cell data.
        Parameters:
        tile - tile to which the cell belongs
        latitudeIndex - latitude index of the cell
        longitudeIndex - longitude index of the cell
        elevation - elevation of the cell

      • dumpAlgorithm

        public static void dumpAlgorithm​(AlgorithmId algorithmId)
        Dump algorithm data.
        Parameters:
        algorithmId - algorithm ID

      • dumpAlgorithm

        public static void dumpAlgorithm​(AlgorithmId algorithmId,
                                 double specific)
        Dump algorithm data.
        Parameters:
        algorithmId - algorithm ID
        specific - algorithm specific extra data

      • dumpEllipsoid

        public static void dumpEllipsoid​(ExtendedEllipsoid ellipsoid)
        Dump ellipsoid data.
        Parameters:
        ellipsoid - ellipsoid to dump

      • dumpDirectLocation

        public static void dumpDirectLocation​(AbsoluteDate date,
                                      Vector3D sensorPosition,
                                      Vector3D los,
                                      boolean lightTimeCorrection,
                                      boolean aberrationOfLightCorrection,
                                      boolean refractionCorrection)
        Dump a direct location computation.
        Parameters:
        date - date of the location
        sensorPosition - sensor position in spacecraft frame
        los - normalized line-of-sight in spacecraft frame
        lightTimeCorrection - flag for light time correction
        aberrationOfLightCorrection - flag for aberration of light correction
        refractionCorrection - flag for refraction correction

      • dumpDirectLocationResult

        public static void dumpDirectLocationResult​(GeodeticPoint gp)
        Dump a direct location result.
        Parameters:
        gp - resulting geodetic point

      • dumpInverseLocation

        public static void dumpInverseLocation​(LineSensor sensor,
                                       GeodeticPoint point,
                                       ExtendedEllipsoid ellipsoid,
                                       int minLine,
                                       int maxLine,
                                       boolean lightTimeCorrection,
                                       boolean aberrationOfLightCorrection,
                                       boolean refractionCorrection)
        Dump an inverse location computation.
        Parameters:
        sensor - sensor
        point - point to localize
        ellipsoid - the used ellipsoid
        minLine - minimum line number
        maxLine - maximum line number
        lightTimeCorrection - flag for light time correction
        aberrationOfLightCorrection - flag for aberration of light correction
        refractionCorrection - flag for refraction correction

      • dumpInverseLocationResult

        public static void dumpInverseLocationResult​(SensorPixel pixel)
        Dump an inverse location result.
        Parameters:
        pixel - resulting sensor pixel

      • dumpTransform

        public static void dumpTransform​(SpacecraftToObservedBody scToBody,
                                 int index,
                                 Transform bodyToInertial,
                                 Transform scToInertial)
        Dump an observation transform transform.
        Parameters:
        scToBody - provider for observation
        index - index of the transform
        bodyToInertial - transform from body frame to inertial frame
        scToInertial - transfrom from spacecraft frame to inertial frame

      • dumpSensorMeanPlane

        public static void dumpSensorMeanPlane​(SensorMeanPlaneCrossing meanPlane)
        Dump a sensor mean plane.
        Parameters:
        meanPlane - mean plane associated with sensor

      • dumpSensorLOS

        public static void dumpSensorLOS​(LineSensor sensor,
                                 AbsoluteDate date,
                                 int i,
                                 Vector3D los)
        Dump a sensor LOS.
        Parameters:
        sensor - sensor
        date - date
        i - pixel index
        los - pixel normalized line-of-sight

      • dumpSensorDatation

        public static void dumpSensorDatation​(LineSensor sensor,
                                      double lineNumber,
                                      AbsoluteDate date)
        Dump a sensor datation.
        Parameters:
        sensor - sensor
        lineNumber - line number
        date - date

      • dumpSensorRate

        public static void dumpSensorRate​(LineSensor sensor,
                                  double lineNumber,
                                  double rate)
        Dump a sensor rate.
        Parameters:
        sensor - sensor
        lineNumber - line number
        rate - lines rate