org.orekit.rugged.intersection

Interface IntersectionAlgorithm

All Known Implementing Classes:

BasicScanAlgorithm, ConstantElevationAlgorithm, DuvenhageAlgorithm, IgnoreDEMAlgorithm

public interface IntersectionAlgorithm

Interface for Digital Elevation Model intersection algorithm.

Author:

Luc Maisonobe

Method Summary

Methods

Modifier and Type	Method and Description
double	getElevation(double latitude, double longitude) Get elevation at a given ground point.
NormalizedGeodeticPoint	intersection(ExtendedEllipsoid ellipsoid, Vector3D position, Vector3D los) Compute intersection of line with Digital Elevation Model.
NormalizedGeodeticPoint	refineIntersection(ExtendedEllipsoid ellipsoid, Vector3D position, Vector3D los, NormalizedGeodeticPoint closeGuess) Refine intersection of line with Digital Elevation Model.

Method Detail

intersection

NormalizedGeodeticPoint intersection(ExtendedEllipsoid ellipsoid,
                                   Vector3D position,
                                   Vector3D los)
                                     throws RuggedException

Compute intersection of line with Digital Elevation Model.

Parameters:

ellipsoid - reference ellipsoid

position - pixel position in ellipsoid frame

los - pixel line-of-sight in ellipsoid frame

Returns:

point at which the line first enters ground

Throws:

RuggedException - if intersection cannot be found

refineIntersection

NormalizedGeodeticPoint refineIntersection(ExtendedEllipsoid ellipsoid,
                                         Vector3D position,
                                         Vector3D los,
                                         NormalizedGeodeticPoint closeGuess)
                                           throws RuggedException

Refine intersection of line with Digital Elevation Model.

This method is used to refine an intersection when a close guess is already known. The intersection is typically looked for by a direct cell intersection in the tile which already contains the close guess, or any similar very fast algorithm.

Parameters:

ellipsoid - reference ellipsoid

position - pixel position in ellipsoid frame

los - pixel line-of-sight in ellipsoid frame

closeGuess - guess close to the real intersection

Returns:

point at which the line first enters ground

Throws:

RuggedException - if intersection cannot be found

getElevation

double getElevation(double latitude,
                  double longitude)
                    throws RuggedException

Get elevation at a given ground point.

Parameters:

latitude - ground point latitude

longitude - ground point longitude

Returns:

elevation at specified point

Throws:

RuggedException - if Digital Elevation Model does not cover point