org.orekit.bodies

Interface BodyShape

All Superinterfaces:

Serializable

All Known Subinterfaces:

EarthShape

All Known Implementing Classes:

Geoid, OneAxisEllipsoid, ReferenceEllipsoid

public interface BodyShape
extends Serializable

Interface representing the rigid surface shape of a natural body.

The shape is not provided as a single complete geometric model, but single points can be queried (getIntersectionPoint(org.apache.commons.math3.geometry.euclidean.threed.Line, org.apache.commons.math3.geometry.euclidean.threed.Vector3D, org.orekit.frames.Frame, org.orekit.time.AbsoluteDate)).

Author:

Luc Maisonobe

Method Summary

Methods

Modifier and Type	Method and Description
Frame	getBodyFrame() Get body frame related to body shape.
GeodeticPoint	getIntersectionPoint(Line line, Vector3D close, Frame frame, AbsoluteDate date) Get the intersection point of a line with the surface of the body.
TimeStampedPVCoordinates	projectToGround(TimeStampedPVCoordinates pv, Frame frame) Project a moving point to the ground.
Vector3D	projectToGround(Vector3D point, AbsoluteDate date, Frame frame) Project a point to the ground.
Vector3D	transform(GeodeticPoint point) Transform a surface-relative point to a cartesian point.
GeodeticPoint	transform(Vector3D point, Frame frame, AbsoluteDate date) Transform a cartesian point to a surface-relative point.

Method Detail

getBodyFrame

Frame getBodyFrame()

Get body frame related to body shape.

Returns:

body frame related to body shape

getIntersectionPoint

GeodeticPoint getIntersectionPoint(Line line,
                                 Vector3D close,
                                 Frame frame,
                                 AbsoluteDate date)
                                   throws OrekitException

Get the intersection point of a line with the surface of the body.

A line may have several intersection points with a closed surface (we consider the one point case as a degenerated two points case). The close parameter is used to select which of these points should be returned. The selected point is the one that is closest to the close point.

Parameters:

line - test line (may intersect the body or not)

close - point used for intersections selection

frame - frame in which line is expressed

date - date of the line in given frame

Returns:

intersection point at altitude zero or null if the line does not intersect the surface

Throws:

OrekitException - if line cannot be converted to body frame

projectToGround

Vector3D projectToGround(Vector3D point,
                       AbsoluteDate date,
                       Frame frame)
                         throws OrekitException

Project a point to the ground.

Parameters:

point - point to project

date - current date

frame - frame in which moving point is expressed

Returns:

ground point exactly at the local vertical of specified point, in the same frame as specified point

Throws:

OrekitException - if point cannot be converted to body frame

Since:

7.0

See Also:

projectToGround(TimeStampedPVCoordinates, Frame)

projectToGround

TimeStampedPVCoordinates projectToGround(TimeStampedPVCoordinates pv,
                                       Frame frame)
                                         throws OrekitException

Project a moving point to the ground.

Parameters:

pv - moving point

frame - frame in which moving point is expressed

Returns:

ground point exactly at the local vertical of specified point, in the same frame as specified point

Throws:

OrekitException - if point cannot be converted to body frame

Since:

7.0

See Also:

projectToGround(Vector3D, AbsoluteDate, Frame)

transform

GeodeticPoint transform(Vector3D point,
                      Frame frame,
                      AbsoluteDate date)
                        throws OrekitException

Transform a cartesian point to a surface-relative point.

Parameters:

point - cartesian point

frame - frame in which cartesian point is expressed

date - date of the computation (used for frames conversions)

Returns:

point at the same location but as a surface-relative point

Throws:

OrekitException - if point cannot be converted to body frame

transform

Vector3D transform(GeodeticPoint point)

Transform a surface-relative point to a cartesian point.

Parameters:

point - surface-relative point

Returns:

point at the same location but as a cartesian point