org.orekit.rugged.linesensor

Class SensorMeanPlaneCrossing

java.lang.Object

org.orekit.rugged.linesensor.SensorMeanPlaneCrossing

public class SensorMeanPlaneCrossing
extends Object

Class dedicated to find when ground point crosses mean sensor plane.

This class is used in the first stage of inverse location.

Author:

Luc Maisonobe

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	SensorMeanPlaneCrossing.CrossingResult Container for mean plane crossing result.

Constructor Summary

Constructors

Constructor and Description
SensorMeanPlaneCrossing(LineSensor sensor, SpacecraftToObservedBody scToBody, int minLine, int maxLine, boolean lightTimeCorrection, boolean aberrationOfLightCorrection, int maxEval, double accuracy) Simple constructor.
SensorMeanPlaneCrossing(LineSensor sensor, SpacecraftToObservedBody scToBody, int minLine, int maxLine, boolean lightTimeCorrection, boolean aberrationOfLightCorrection, int maxEval, double accuracy, Vector3D meanPlaneNormal, SensorMeanPlaneCrossing.CrossingResult[] cachedResults) Simple constructor.

Method Summary

Methods

Modifier and Type	Method and Description
SensorMeanPlaneCrossing.CrossingResult	find(Vector3D target) Find mean plane crossing.
double	getAccuracy() Get the accuracy to use for finding crossing line number.
SensorMeanPlaneCrossing.CrossingResult[]	getCachedResults() Get the cached previous results.
int	getMaxEval() Get the maximum number of evaluations.
int	getMaxLine() Get the maximum line number in the search interval.
Vector3D	getMeanPlaneNormal() Get the mean plane normal.
int	getMinLine() Get the minimum line number in the search interval.
SpacecraftToObservedBody	getScToBody() Get converter between spacecraft and body.
LineSensor	getSensor() Get the underlying sensor.
SensorMeanPlaneCrossing.CrossingResult	slowFind(PVCoordinates targetPV, double initialGuess) Find mean plane crossing using a slow but robust method.

Methods inherited from class java.lang.Object

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

Constructor Detail

SensorMeanPlaneCrossing

public SensorMeanPlaneCrossing(LineSensor sensor,
                       SpacecraftToObservedBody scToBody,
                       int minLine,
                       int maxLine,
                       boolean lightTimeCorrection,
                       boolean aberrationOfLightCorrection,
                       int maxEval,
                       double accuracy)
                        throws RuggedException

Simple constructor.

Parameters:

sensor - sensor to consider

scToBody - converter between spacecraft and body

minLine - minimum line number

maxLine - maximum line number

lightTimeCorrection - flag for light time correction

aberrationOfLightCorrection - flag for aberration of light correction.

maxEval - maximum number of evaluations

accuracy - accuracy to use for finding crossing line number

Throws:

RuggedException - if some frame conversion fails

SensorMeanPlaneCrossing

public SensorMeanPlaneCrossing(LineSensor sensor,
                       SpacecraftToObservedBody scToBody,
                       int minLine,
                       int maxLine,
                       boolean lightTimeCorrection,
                       boolean aberrationOfLightCorrection,
                       int maxEval,
                       double accuracy,
                       Vector3D meanPlaneNormal,
                       SensorMeanPlaneCrossing.CrossingResult[] cachedResults)
                        throws RuggedException

Simple constructor.

Parameters:

sensor - sensor to consider

scToBody - converter between spacecraft and body

minLine - minimum line number

maxLine - maximum line number

lightTimeCorrection - flag for light time correction

aberrationOfLightCorrection - flag for aberration of light correction.

maxEval - maximum number of evaluations

accuracy - accuracy to use for finding crossing line number

meanPlaneNormal - mean plane normal

cachedResults - cached results

Throws:

RuggedException - if some frame conversion fails

Method Detail

getSensor

public LineSensor getSensor()

Get the underlying sensor.

Returns:

underlying sensor

getScToBody

public SpacecraftToObservedBody getScToBody()

Get converter between spacecraft and body.

Returns:

converter between spacecraft and body

getMinLine

public int getMinLine()

Get the minimum line number in the search interval.

Returns:

minimum line number in the search interval

getMaxLine

public int getMaxLine()

Get the maximum line number in the search interval.

Returns:

maximum line number in the search interval

getMaxEval

public int getMaxEval()

Get the maximum number of evaluations.

Returns:

maximum number of evaluations

getAccuracy

public double getAccuracy()

Get the accuracy to use for finding crossing line number.

Returns:

accuracy to use for finding crossing line number

getMeanPlaneNormal

public Vector3D getMeanPlaneNormal()

Get the mean plane normal.

The normal is oriented such traversing pixels in increasing indices order corresponds is consistent with trigonometric order (i.e. counterclockwise).

Returns:

mean plane normal

getCachedResults

public SensorMeanPlaneCrossing.CrossingResult[] getCachedResults()

Get the cached previous results.

Returns:

mean plane normal

find

public SensorMeanPlaneCrossing.CrossingResult find(Vector3D target)
                                            throws RuggedException

Find mean plane crossing.

Parameters:

target - target ground point

Returns:

line number and target direction at mean plane crossing, or null if search interval does not bracket a solution

Throws:

RuggedException - if geometry cannot be computed for some line or if the maximum number of evaluations is exceeded

slowFind

public SensorMeanPlaneCrossing.CrossingResult slowFind(PVCoordinates targetPV,
                                              double initialGuess)
                                                throws RuggedException

Find mean plane crossing using a slow but robust method.

Parameters:

targetPV - target ground point

initialGuess - initial guess for the crossing line

Returns:

line number and target direction at mean plane crossing, or null if search interval does not bracket a solution

Throws:

RuggedException - if geometry cannot be computed for some line or if the maximum number of evaluations is exceeded