Package org.orekit.rugged.errors

Class DumpManager

java.lang.Object

org.orekit.rugged.errors.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 Summary

Modifier and Type	Method	Description
static void	activate(File file)	Activate debug dump.
static void	deactivate()	Deactivate debug dump.
static void	dumpAlgorithm(AlgorithmId algorithmId)	Dump algorithm data.
static void	dumpAlgorithm(AlgorithmId algorithmId, double specific)	Dump algorithm data.
static void	dumpDirectLocation(org.orekit.time.AbsoluteDate date, org.hipparchus.geometry.euclidean.threed.Vector3D sensorPosition, org.hipparchus.geometry.euclidean.threed.Vector3D los, boolean lightTimeCorrection, boolean aberrationOfLightCorrection, boolean refractionCorrection)	Dump a direct location computation.
static void	dumpDirectLocationResult(org.orekit.bodies.GeodeticPoint gp)	Dump a direct location result.
static void	dumpEllipsoid(ExtendedEllipsoid ellipsoid)	Dump ellipsoid data.
static void	dumpInverseLocation(LineSensor sensor, org.orekit.bodies.GeodeticPoint point, ExtendedEllipsoid ellipsoid, int minLine, int maxLine, boolean lightTimeCorrection, boolean aberrationOfLightCorrection, boolean refractionCorrection)	Dump an inverse location computation.
static void	dumpInverseLocationResult(SensorPixel pixel)	Dump an inverse location result.
static void	dumpSensorDatation(LineSensor sensor, double lineNumber, org.orekit.time.AbsoluteDate date)	Dump a sensor datation.
static void	dumpSensorLOS(LineSensor sensor, org.orekit.time.AbsoluteDate date, int i, org.hipparchus.geometry.euclidean.threed.Vector3D los)	Dump a sensor LOS.
static void	dumpSensorMeanPlane(SensorMeanPlaneCrossing meanPlane)	Dump a sensor mean plane.
static void	dumpSensorRate(LineSensor sensor, double lineNumber, double rate)	Dump a sensor rate.
static void	dumpTileCell(Tile tile, int latitudeIndex, int longitudeIndex, double elevation)	Dump DEM cell data.
static void	dumpTransform(SpacecraftToObservedBody scToBody, int index, org.orekit.frames.Transform bodyToInertial, org.orekit.frames.Transform scToInertial)	Dump an observation transform transform.
static void	endNicely()	In case dump is suspended and an exception is thrown, allows the dump to end nicely.
static boolean	isActive()	Check if dump is active for this thread.
static void	resume(Boolean wasSuspended)	Resume the dump, only if it was not already suspended.
static Boolean	suspend()	Suspend the dump.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

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(org.orekit.time.AbsoluteDate date,
                                      org.hipparchus.geometry.euclidean.threed.Vector3D sensorPosition,
                                      org.hipparchus.geometry.euclidean.threed.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(org.orekit.bodies.GeodeticPoint gp)

Dump a direct location result.

Parameters:

gp - resulting geodetic point

dumpInverseLocation

public static void dumpInverseLocation(LineSensor sensor,
                                       org.orekit.bodies.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,
                                 org.orekit.frames.Transform bodyToInertial,
                                 org.orekit.frames.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,
                                 org.orekit.time.AbsoluteDate date,
                                 int i,
                                 org.hipparchus.geometry.euclidean.threed.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,
                                      org.orekit.time.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