fr.cnes.sirius.patrius.bodies.mesh

Class FacetBodyShape

java.lang.Object

fr.cnes.sirius.patrius.bodies.mesh.FacetBodyShape

All Implemented Interfaces:

BodyShape, GeometricBodyShape, PVCoordinatesProvider, Serializable

public class FacetBodyShape
extends Object
implements GeometricBodyShape

Facet body shape defined by a list of facets. A facet is a 3D triangle defined in the body frame.

This class offers an optimal storage under a Binary Space Partition Tree (BSP Tree). Each of the body facet (class Triangle) is linked to its neighbors. Each of the body vertex (class Vertex) is also linked to its neighboring triangles Triangle. Hence this class provides very efficient methods (O(log n)) for intersection computation, neighbors computation, etc.

This class implements the interface GeometricBodyShape:

• As a GeometricBodyShape, this class can be used in conjunction with EclipseDetector and SensorModel.

Since:

4.6

Author:

Emmanuel Bignon

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	FacetBodyShape.EllipsoidType Type of ellipsoid to apply transformation methods on.

Nested classes/interfaces inherited from interface fr.cnes.sirius.patrius.bodies.GeometricBodyShape

GeometricBodyShape.MarginType

Field Summary

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

EPS_ALTITUDE

Constructor Summary

Constructors

Constructor and Description
FacetBodyShape(String name, Frame bodyFrame, PVCoordinatesProvider pvProv, FacetBodyShape.EllipsoidType ellipsoidTypeIn, MeshProvider meshLoader) Constructor.

Method Summary

Modifier and Type	Method and Description
double	distanceTo(Line line, Frame frame, AbsoluteDate date) Computes the distance to a line.
Frame	getBodyFrame() Get body frame related to body shape.
FieldData	getFieldData(SpacecraftState state, IFieldOfView fieldOfView, Vector3D lineOfSight) Returns the field data as FieldData for each state in provided list.
ExtendedOneAxisEllipsoid	getFittedEllipsoid() Returns the fitted ellipsoid which is the ellipsoid (a, f) which minimizes the distance to all vertices.
ExtendedOneAxisEllipsoid	getInnerEllipsoid() Returns the inner ellipsoid which is the largest ellipsoid strictly contained in the mesh and centered around (0, 0, 0).
ExtendedOneAxisEllipsoid	getInnerSphere() Returns the inner sphere which is the largest sphere strictly contained in the mesh and centered around (0, 0, 0).
Intersection	getIntersection(Line line, Vector3D close, Frame frame, AbsoluteDate date) Get the intersection point of a line with the surface of the body.
GeodeticPoint	getIntersectionPoint(Line line, Vector3D close, Frame frame, AbsoluteDate date) Get the intersection point of a line with the surface of the body.
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[]	getIntersectionPoints(Line line, Frame frame, AbsoluteDate date) Compute the intersection points with a line.
double	getLocalAltitude(double latitude, double longitude) Returns the altitude of body at point (latitude, longitude).
double	getLocalAltitude(Vector3D direction) Returns the altitude of body given provided direction in body frame.
double	getLocalRadius(Vector3D posObserver, Frame frame, AbsoluteDate date, PVCoordinatesProvider occultedBody) Compute the apparent radius (in meters) of the occulting body from the spacecraft (observer) position.
double	getMaxNorm() Returns the distance from center to farthest vertex to center of body.
MeshProvider	getMeshProvider() Returns the mesh provider.
double	getMinNorm() Returns the distance from center to closest vertex to center of body.
String	getName()
Frame	getNativeFrame(AbsoluteDate date, Frame frame) Get the native frame, i.e.
List<Triangle>	getNeighbors(GeodeticPoint point, double maxDistance) Returns the neighbors of provided geodetic point whose center is closer than provided distance.
List<Triangle>	getNeighbors(GeodeticPoint point, int order) Returns the neighbor triangles of provided geodetic point which are closer or equal to provided order of "neighborhood".
List<Triangle>	getNeighbors(Triangle triangle, double maxDistance) Returns the neighbors of provided triangle whose center is closer than provided distance of provided triangle center.
List<Triangle>	getNeighbors(Triangle triangle, int order) Returns the neighbors of provided triangle whose distance in terms of triangle is closer or equal to provided order of "neighborhood".
List<Triangle>	getNeighbors(Vector3D pos, double maxDistance) Returns the neighbors of provided cartesian point whose center is closer than provided distance.
List<Triangle>	getNeighbors(Vector3D pos, int order) Returns the neighbor triangles of provided cartesian point which are closer or equal to provided order of "neighborhood".
List<Triangle>	getNeverEnlightenedTriangles(List<AbsoluteDate> dates, PVCoordinatesProvider sun) Returns the list of triangles never enlightened by the Sun at provided dates.
List<Triangle>	getNeverVisibleTriangles(List<SpacecraftState> states, IFieldOfView fieldOfView) Returns the list of triangles never visible from the satellite field of view during the whole ephemeris.
ExtendedOneAxisEllipsoid	getOuterEllipsoid() Returns the outer ellipsoid which is the smallest ellipsoid englobing the shape and centered around (0, 0, 0).
ExtendedOneAxisEllipsoid	getOuterSphere() Returns the outer sphere which is the smallest sphere englobing the shape and centered around (0, 0, 0).
PVCoordinates	getPVCoordinates(AbsoluteDate date, Frame frame) Get the PVCoordinates of the body in the selected frame.
List<SurfacePointedData>	getSurfacePointedDataEphemeris(List<SpacecraftState> states, Vector3D lineOfSight, PVCoordinatesProvider sun, double pixelFOV) Returns the body surface pointed data as SurfacePointedData for each state in provided list.
double	getThreshold() Returns the threshold for apparent radius determination convergence.
Triangle[]	getTriangles() Returns the mesh under a list of triangles.
List<Triangle>	getVisibleAndEnlightenedTriangles(List<SpacecraftState> states, PVCoordinatesProvider sun, IFieldOfView fieldOfView) Returns the list of triangles enlightened (by the Sun) and visible at least once during the whole ephemeris from the satellite field of view.
boolean	isInEclipse(AbsoluteDate date, Vector3D position, Frame frame, PVCoordinatesProvider sun) Returns true if provided position in provided frame at provided date in in eclipse or not.
boolean	isMasked(Triangle triangle, Vector3D pos) Returns true if the triangle is masked by another triangle as seen from the provided position.
boolean	isVisible(Triangle triangle, Vector3D pos, IFieldOfView fieldOfView, Transform t) Returns true if the triangle is visible from the field of view, i.e.: Is oriented toward the field of view All points of the triangle are in the field of view Triangle not masked by another facet
FacetBodyShape	resize(GeometricBodyShape.MarginType marginType, double marginValue) Resize the geometric body shape by a margin.
void	setThreshold(double threshold) Set the threshold for apparent radius determination convergence.
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.

Methods inherited from class java.lang.Object

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

Constructor Detail

FacetBodyShape

public FacetBodyShape(String name,
                      Frame bodyFrame,
                      PVCoordinatesProvider pvProv,
                      FacetBodyShape.EllipsoidType ellipsoidTypeIn,
                      MeshProvider meshLoader)
               throws PatriusException

Constructor.

Parameters:

name - body name

bodyFrame - frame in which celestial body coordinates are defined

pvProv - body PV coordinates provider

ellipsoidTypeIn - ellipsoid type to apply the transform methods on

meshLoader - mesh loader

Throws:

PatriusException - thrown if loading failed

Method Detail

getTriangles

public Triangle[] getTriangles()

Returns the mesh under a list of triangles. The triangles are not sorted in any particular way.

Returns:

the mesh under a list of triangles

getBodyFrame

public final Frame getBodyFrame()

Get body frame related to body shape.

Specified by:

getBodyFrame in interface BodyShape

Returns:

body frame related to body shape

getIntersectionPoint

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

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.

Specified by:

getIntersectionPoint in interface BodyShape

Parameters:

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

close - point used for intersections selection expressed in the body frame

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:

PatriusException - if line cannot be converted to body frame

getIntersectionPoints

public Vector3D[] getIntersectionPoints(Line line,
                                        Frame frame,
                                        AbsoluteDate date)
                                 throws PatriusException

Compute the intersection points with a line.

Specified by:

getIntersectionPoints in interface GeometricBodyShape

Parameters:

line - the line

frame - in which line is expressed

date - date of the line in given frame

Returns:

the intersection points if they exist. If no intersection is found, the dimension is zero

Throws:

PatriusException - if line cannot be converted to body frame

getIntersection

public Intersection getIntersection(Line line,
                                    Vector3D close,
                                    Frame frame,
                                    AbsoluteDate date)
                             throws PatriusException

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 expressed in the body frame

frame - frame in which line is expressed

date - date of the line in given frame

Returns:

or null if the line does not intersect the surface

Throws:

PatriusException - if line cannot be converted to body frame

getIntersectionPoint

public 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.

Warning: this method returns getIntersectionPoint(Line, Vector3D, Frame, AbsoluteDate) if altitude is close to 0. An exception is thrown otherwise.

Specified by:

getIntersectionPoint in interface BodyShape

Parameters:

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

close - point used for intersections selection expressed in the body frame

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

transform

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

Transform a cartesian point to a surface-relative point.

Warning: this method considers the body either as the inner sphere, the outer ellipsoid or the fitted ellipsoid depending on the FacetBodyShape.EllipsoidType attribute.

Specified by:

transform in interface BodyShape

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:

PatriusException - if point cannot be converted to body frame

transform

public Vector3D transform(GeodeticPoint point)

Transform a surface-relative point to a cartesian point.

Warning: this method considers the body either as the inner sphere, the outer ellipsoid or the fitted ellipsoid depending on the FacetBodyShape.EllipsoidType attribute.

Specified by:

transform in interface BodyShape

Parameters:

point - surface-relative point

Returns:

point at the same location but as a cartesian point

getLocalAltitude

public double getLocalAltitude(double latitude,
                               double longitude)
                        throws PatriusException

Returns the altitude of body at point (latitude, longitude). The returned altitude is the altitude of the point belonging to the mesh with provided latitude, longitude.

Altitude is relative to the inner sphere to the body (which is the largest sphere strictly inside the mesh).

Parameters:

latitude - latitude

longitude - longitude

Returns:

the altitude of body at point (latitude, longitude)

Throws:

PatriusException - thrown if failed to compute intersection

getLocalAltitude

public double getLocalAltitude(Vector3D direction)
                        throws PatriusException

Returns the altitude of body given provided direction in body frame.

Altitude is relative to the inner sphere to the body (which is the largest sphere strictly inside the mesh).

Parameters:

direction - direction in body frame

Returns:

altitude of body given provided direction in body frame

Throws:

PatriusException - thrown if failed to compute intersection

distanceTo

public double distanceTo(Line line,
                         Frame frame,
                         AbsoluteDate date)
                  throws PatriusException

Computes the distance to a line.

Warning: in case of strongly not convex bodies, this methods may not return exact minimal distance.

Specified by:

distanceTo in interface GeometricBodyShape

Parameters:

line - the line

frame - in which line is expressed

date - date of the line in given frame

Returns:

the shortest distance between the the line and the shape

Throws:

PatriusException - if line cannot be converted to body frame

getLocalRadius

public double getLocalRadius(Vector3D posObserver,
                             Frame frame,
                             AbsoluteDate date,
                             PVCoordinatesProvider occultedBody)
                      throws PatriusException

Compute the apparent radius (in meters) of the occulting body from the spacecraft (observer) position. Given a plane containing the spacecraft (observer) position, the center of the occulting body and the center of the occulted body, and given a line contained within this plane, passing by the spacecraft (observer) position and tangent to the mesh of the occulting body, the apparent radius corresponds to the length of the line starting from the center of the occulting body, perpendicular to the first given line and ending at the intersection of the two lines.

Please notice that this method will for the moment be used only with an instantaneous propagation delay type.

To compute the apparent radius (in meters), the algorithm iterates, until convergence, between the minimum and the maximum angles (and so radii too), given by the apparent angles (and so radii too) of the inner and outer ellipsoid of this occulting body. Given the plane containing the observer, the occulted body and this occulting body, if the line lying on this plane and connecting the observer to the hypothetical tangential point of this occulting body actually intersects this occulting body, the search for the correct angle value by which this line shall be rotated (within the given plane) to be tangential to this occulting body will continue towards a larger angle, otherwise it will continue towards a smaller angle. Each time, this line is rotated by the current value of the angle and the value of the apparent radius is computed thanks to the current angle and the distance between the observer and this occulting body. Convergence is reached when the absolute value of the difference between the current value of the apparent radius and the previous one is smaller than a specified threshold (in meters).

Specified by:

getLocalRadius in interface GeometricBodyShape

Parameters:

posObserver - the spacecraft (observer) position

frame - the reference frame in which the spacecraft (observer) position is expressed

date - the date at which the spacecraft (observer) position is expressed

occultedBody - the body which is occulted to the spacecraft (observer) by the occulting body

Returns:

the apparent radius (in meters) of the occulting body from the spacecraft (observer) position

Throws:

PatriusException - if the PVCoordinatesProvider computation fails

getNeighbors

public List<Triangle> getNeighbors(Triangle triangle,
                                   double maxDistance)

Returns the neighbors of provided triangle whose center is closer than provided distance of provided triangle center.

Provided triangle is included in the list of neighbors.

Beware not to confuse this method with getNeighbors(Triangle, int)

Parameters:

triangle - a triangle

maxDistance - max distance

Returns:

the neighbors of provided triangle whose center is closer than provided distance of provided triangle center

getNeighbors

public List<Triangle> getNeighbors(Triangle triangle,
                                   int order)

Returns the neighbors of provided triangle whose distance in terms of triangle is closer or equal to provided order of "neighborhood". For example:

• Order 0 returns provided triangle
• Order 1 returns provided triangle and the immediate neighbors of provided triangle
• Order 2 returns provided triangle, the immediate neighbors of provided triangle and also their own immediate neighbors

Beware not to confuse this method with getNeighbors(Triangle, double)

Parameters:

triangle - a triangle

order - order of "neighborhood"

Returns:

the neighbors of provided triangle whose distance in terms of triangle is closer or equal to provided order of "neighborhood"

getNeighbors

public List<Triangle> getNeighbors(GeodeticPoint point,
                                   double maxDistance)
                            throws PatriusException

Returns the neighbors of provided geodetic point whose center is closer than provided distance.

Parameters:

point - a geodetic point

maxDistance - max distance

Returns:

the neighbors of provided geodetic point whose center is closer than provided distance

Throws:

PatriusException - thrown if computation failed (should not happen)

getNeighbors

public List<Triangle> getNeighbors(GeodeticPoint point,
                                   int order)
                            throws PatriusException

Returns the neighbor triangles of provided geodetic point which are closer or equal to provided order of "neighborhood". For example:

• Order 0 returns closest triangle
• Order 1 returns closest triangle and the immediate neighbors of closest triangle
• Order 2 returns closest triangle, the immediate neighbors of closest triangle and also their own immediate neighbors

Beware not to confuse this method with getNeighbors(GeodeticPoint, double)

Parameters:

point - a geodetic point

order - order of "neighborhood"

Returns:

the neighbor triangles of provided geodetic point which are closer or equal to provided order of "neighborhood"

Throws:

PatriusException - thrown if computation failed (should not happen)

getNeighbors

public List<Triangle> getNeighbors(Vector3D pos,
                                   double maxDistance)
                            throws PatriusException

Returns the neighbors of provided cartesian point whose center is closer than provided distance.

Parameters:

pos - a point in body frame

maxDistance - max distance

Returns:

the neighbors of provided cartesian point whose center is closer than provided distance

Throws:

PatriusException - thrown if computation failed (should not happen)

getNeighbors

public List<Triangle> getNeighbors(Vector3D pos,
                                   int order)
                            throws PatriusException

Returns the neighbor triangles of provided cartesian point which are closer or equal to provided order of "neighborhood". For example:

• Order 0 returns closest triangle
• Order 1 returns closest triangle and the immediate neighbors of closest triangle
• Order 2 returns closest triangle, the immediate neighbors of closest triangle and also their own immediate neighbors

Beware not to confuse this method with getNeighbors(Vector3D, double)

Parameters:

pos - a point in body frame

order - order of "neighborhood"

Returns:

the neighbor triangles of provided cartesian point which are closer or equal to provided order of "neighborhood"

Throws:

PatriusException - thrown if computation failed (should not happen)

getSurfacePointedDataEphemeris

public List<SurfacePointedData> getSurfacePointedDataEphemeris(List<SpacecraftState> states,
                                                               Vector3D lineOfSight,
                                                               PVCoordinatesProvider sun,
                                                               double pixelFOV)
                                                        throws PatriusException

Returns the body surface pointed data as SurfacePointedData for each state in provided list. The light propagation is considered as instantaneous.

Parameters:

states - list of spacecraft states

lineOfSight - line of sight in spacecraft frame

sun - Sun body

pixelFOV - aperture of field of view for one pixel

Returns:

list of SurfacePointedData, one per provided date

Throws:

PatriusException - thrown if state position could not be retrieved in body frame or if intersection is null or Sun frame conversion failed

getFieldData

public FieldData getFieldData(SpacecraftState state,
                              IFieldOfView fieldOfView,
                              Vector3D lineOfSight)
                       throws PatriusException

Returns the field data as FieldData for each state in provided list.

Parameters:

state - spacecraft state

fieldOfView - sensor field of view

lineOfSight - optional parameter in order to indicate field of view main line of sight in spacecraft frame. If provided, this parameter may fasten algorithm by several order of magnitudes (O(log n) vs O(n)). Be careful, in this case, strongly not convex bodies may lead to missing some triangles.

Returns:

FieldData for corresponding state

Throws:

PatriusException - thrown if state position could not be retrieved in body frame

isVisible

public boolean isVisible(Triangle triangle,
                         Vector3D pos,
                         IFieldOfView fieldOfView,
                         Transform t)
                  throws PatriusException

Returns true if the triangle is visible from the field of view, i.e.:

• Is oriented toward the field of view
• All points of the triangle are in the field of view
• Triangle not masked by another facet

Parameters:

triangle - a triangle

fieldOfView - field of view

pos - spacecraft position in body frame

t - transform from body frame to spacecraft frame

Returns:

true if the triangle is visible from the field of view

Throws:

PatriusException - thrown if intersection computation failed

isMasked

public boolean isMasked(Triangle triangle,
                        Vector3D pos)
                 throws PatriusException

Returns true if the triangle is masked by another triangle as seen from the provided position. A triangle is masked if all its vertices are masked by at least another triangle.

Parameters:

triangle - a triangle

pos - spacecraft position in body frame

Returns:

true if the triangle is masked by another triangle as seen from the provided position

Throws:

PatriusException - thrown if intersection computation failed

isInEclipse

public boolean isInEclipse(AbsoluteDate date,
                           Vector3D position,
                           Frame frame,
                           PVCoordinatesProvider sun)
                    throws PatriusException

Returns true if provided position in provided frame at provided date in in eclipse or not.

Computed eclipse status is exact and takes into account full body shape. This methods cannot however be used in conjunction with EclipseDetector since they use a different framework.

Parameters:

date - date

position - position

frame - frame in which position is expressed

sun - Sun body

Returns:

true if provided position in provided frame at provided date in in eclipse or not

Throws:

PatriusException - thrown if failed to retrieve Sun position of intersection points with body

getNeverVisibleTriangles

public List<Triangle> getNeverVisibleTriangles(List<SpacecraftState> states,
                                               IFieldOfView fieldOfView)
                                        throws PatriusException

Returns the list of triangles never visible from the satellite field of view during the whole ephemeris. A visible triangle must be properly oriented, in the field of view and not masked by any other triangle.

Parameters:

states - list of spacecraft states

fieldOfView - field of view

Returns:

list of Triangle never visible from the satellite field of view during the whole ephemeris

Throws:

PatriusException - thrown if state position could not be retrieved in body frame

getNeverEnlightenedTriangles

public List<Triangle> getNeverEnlightenedTriangles(List<AbsoluteDate> dates,
                                                   PVCoordinatesProvider sun)
                                            throws PatriusException

Returns the list of triangles never enlightened by the Sun at provided dates. An enlightened triangle must be properly oriented toward the Sun and not masked by any other triangle.

Parameters:

dates - list of dates

sun - Sun body

Returns:

list of Triangle never enlightened by the Sun

Throws:

PatriusException - thrown if state position could not be retrieved in body frame

getVisibleAndEnlightenedTriangles

public List<Triangle> getVisibleAndEnlightenedTriangles(List<SpacecraftState> states,
                                                        PVCoordinatesProvider sun,
                                                        IFieldOfView fieldOfView)
                                                 throws PatriusException

Returns the list of triangles enlightened (by the Sun) and visible at least once during the whole ephemeris from the satellite field of view. A visible triangle must be properly oriented, in the field of view and not masked by any other triangle. An enlightened triangle must be properly oriented toward the Sun and not masked by any other triangle.

Parameters:

states - list of spacecraft states

sun - sun

fieldOfView - field of view

Returns:

list of Triangle enlightened and visible at least once from the satellite field of view

Throws:

PatriusException - thrown if state position could not be retrieved in body frame

getFittedEllipsoid

public ExtendedOneAxisEllipsoid getFittedEllipsoid()

Returns the fitted ellipsoid which is the ellipsoid (a, f) which minimizes the distance to all vertices.

Returns:

the fitted ellipsoid

getInnerEllipsoid

public ExtendedOneAxisEllipsoid getInnerEllipsoid()

Returns the inner ellipsoid which is the largest ellipsoid strictly contained in the mesh and centered around (0, 0, 0).

Returns:

the inner ellipsoid

getOuterEllipsoid

public ExtendedOneAxisEllipsoid getOuterEllipsoid()

Returns the outer ellipsoid which is the smallest ellipsoid englobing the shape and centered around (0, 0, 0).

Returns:

the outer ellipsoid

getInnerSphere

public ExtendedOneAxisEllipsoid getInnerSphere()

Returns the inner sphere which is the largest sphere strictly contained in the mesh and centered around (0, 0, 0).

Returns:

the inner sphere

getOuterSphere

public ExtendedOneAxisEllipsoid getOuterSphere()

Returns the outer sphere which is the smallest sphere englobing the shape and centered around (0, 0, 0).

Returns:

the outer sphere

getMinNorm

public double getMinNorm()

Returns the distance from center to closest vertex to center of body.

Returns:

the distance from center to closest vertex to center of body

getMaxNorm

public double getMaxNorm()

Returns the distance from center to farthest vertex to center of body.

Returns:

the distance from center to farthest vertex to center of body

getThreshold

public double getThreshold()

Returns the threshold for apparent radius determination convergence.

Returns:

the threshold for apparent radius determination convergence

getMeshProvider

public MeshProvider getMeshProvider()

Returns the mesh provider.

Returns:

the mesh provider

setThreshold

public void setThreshold(double threshold)

Set the threshold for apparent radius determination convergence.

Parameters:

threshold - the threshold for apparent radius determination convergence to set

resize

public FacetBodyShape resize(GeometricBodyShape.MarginType marginType,
                             double marginValue)
                      throws PatriusException

Resize the geometric body shape by a margin.

Specified by:

resize in interface GeometricBodyShape

Parameters:

marginType - margin type to be used

marginValue - margin value to be used (in meters if the margin type is DISTANCE)

Returns:

resized geometric body shape with the margin

Throws:

PatriusException - if the margin value is invalid

getName

public final String getName()

Specified by:

getName in interface GeometricBodyShape

Returns:

the name of the shape

getPVCoordinates

public PVCoordinates getPVCoordinates(AbsoluteDate date,
                                      Frame frame)
                               throws PatriusException

Get the PVCoordinates of the body in the selected frame.

Specified by:

getPVCoordinates in interface PVCoordinatesProvider

Parameters:

date - current date

frame - the frame where to define the position

Returns:

position/velocity of the body (m and m/s)

Throws:

PatriusException - if position cannot be computed in given frame

getNativeFrame

public Frame getNativeFrame(AbsoluteDate date,
                            Frame frame)
                     throws PatriusException

Get the native frame, i.e. the raw frame in which PVCoordinates are expressed before transformation to user output frame. This native frame can be dependent on date and frame.

Specified by:

getNativeFrame in interface PVCoordinatesProvider

Parameters:

date - a date

frame - a frame

Returns:

the native frame

Throws:

PatriusException - thrown if native frame is undefined or unknown