fr.cnes.sirius.patrius.bodies

Interface EllipsoidBodyShape

All Superinterfaces:

BodyShape, GeometricBodyShape, PVCoordinatesProvider, Serializable

All Known Implementing Classes:

ExtendedOneAxisEllipsoid, ProjectionEllipsoid

public interface EllipsoidBodyShape
extends GeometricBodyShape

Extended interface for spheroid model to represent celestial bodies shape : extends the GeometricBodyShape interface by adding getters to access the spheroid parameters.

Since:

4.3

See Also:

GeometricBodyShape

Method Summary

Modifier and Type	Method and Description
double	getApparentRadius(Vector3D position, Frame frame, AbsoluteDate date, PVCoordinatesProvider occultedBody) Calculate the apparent radius.
double	getConjugateRadius() Return conjugate radius (minor semi axis)
IEllipsoid	getEllipsoid() Return the spheroid object
double	getEquatorialRadius() Get the equatorial radius of the body.
double	getFlattening() Return the flattening
GeodeticPoint	getIntersectionPoint(Line line, Vector3D close, Frame frame, AbsoluteDate date, double altitude) Get the intersection point of a line with the surface of the body for a given altitude.
Vector3D	getNormal(Vector3D point) Return the normal vector to the surface from the ellipsoid
double	getTransverseRadius() Return transverse radius (major semi axis)

Methods inherited from interface fr.cnes.sirius.patrius.bodies.GeometricBodyShape

distanceTo, getIntersectionPoints, getLocalRadius, getName

Methods inherited from interface fr.cnes.sirius.patrius.bodies.BodyShape

getBodyFrame, getIntersectionPoint, transform, transform

Methods inherited from interface fr.cnes.sirius.patrius.orbits.pvcoordinates.PVCoordinatesProvider

getPVCoordinates

Method Detail

getEquatorialRadius

double getEquatorialRadius()

Get the equatorial radius of the body.

Returns:

equatorial radius of the body (m)

getTransverseRadius

double getTransverseRadius()

Return transverse radius (major semi axis)

Returns:

transverse radius

getConjugateRadius

double getConjugateRadius()

Return conjugate radius (minor semi axis)

Returns:

conjugate radius

getApparentRadius

double getApparentRadius(Vector3D position,
                         Frame frame,
                         AbsoluteDate date,
                         PVCoordinatesProvider occultedBody)
                  throws PatriusException

Calculate the apparent radius.

Parameters:

position - spacecraft position

frame - frame in which position is expressed

date - date of position

occultedBody - body occulted by this

Returns:

apparent radius

Throws:

PatriusException - if PVCoordinatesProvider computation fails

getFlattening

double getFlattening()

Return the flattening

Returns:

fIn

getNormal

Vector3D getNormal(Vector3D point)

Return the normal vector to the surface from the ellipsoid

Parameters:

point - Point as a Vector3D in local basis

Returns:

the normal vector in local basis

getEllipsoid

IEllipsoid getEllipsoid()

Return the spheroid object

Returns:

the spheroid

getIntersectionPoint

GeodeticPoint getIntersectionPoint(Line line,
                                   Vector3D close,
                                   Frame frame,
                                   AbsoluteDate date,
                                   double altitude)
                            throws PatriusException

Get the intersection point of a line with the surface of the body for a given altitude.

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

altitude - altitude of the intersection

Returns:

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

Throws:

PatriusException - if line cannot be converted to body frame