Closest Approach

class ClosestApproach

A close approach between an orbit and a target orbit. Obtained by calling Orbit.NextClosestApproach or Orbit.ClosestApproaches.

Note

A close approach is a snapshot: the time of closest approach is estimated once when the object is created, and every member describes the state at that time. Relative quantities are the target relative to the orbiting object (target minus self).

Double UT { get; }

The universal time of the closest approach, in seconds.

Game Scenes:

All

Double TimeTo { get; }

The time until the closest approach, in seconds.

Game Scenes:

All

Double Distance { get; }

The distance between the objects at the closest approach, in meters.

Game Scenes:

All

Double RelativeSpeed { get; }

The relative speed of the objects at the closest approach, in meters per second. This is the magnitude of ClosestApproach.RelativeVelocity, and does not depend on the choice of reference frame.

Game Scenes:

All

Vessel Vessel { get; }

The vessel doing the approaching, or null if it is not a vessel.

Game Scenes:

All

CelestialBody Body { get; }

The celestial body doing the approaching, or null if it is not a celestial body.

Game Scenes:

All

Vessel TargetVessel { get; }

The vessel being approached, or null if the target is not a vessel.

Game Scenes:

All

CelestialBody TargetBody { get; }

The celestial body being approached, or null if the target is not a celestial body.

Game Scenes:

All

Tuple<Double, Double, Double> Position (ReferenceFrame referenceFrame = null)

The position of the orbiting object at the closest approach.

Parameters:

• referenceFrame – The reference frame that the returned position vector is in. Defaults to the orbital reference frame of the object the orbit belongs to.

Returns:

The position as a vector.

Game Scenes:

All

Tuple<Double, Double, Double> TargetPosition (ReferenceFrame referenceFrame = null)

The position of the target object at the closest approach.

Parameters:

• referenceFrame – The reference frame that the returned position vector is in. Defaults to the orbital reference frame of the object the orbit belongs to.

Returns:

The position as a vector.

Game Scenes:

All

Tuple<Double, Double, Double> Velocity (ReferenceFrame referenceFrame = null)

The velocity of the orbiting object at the closest approach.

Parameters:

• referenceFrame – The reference frame that the returned velocity vector is in. Defaults to the orbital reference frame of the object the orbit belongs to.

Returns:

The velocity as a vector.

Game Scenes:

All

Tuple<Double, Double, Double> TargetVelocity (ReferenceFrame referenceFrame = null)

The velocity of the target object at the closest approach.

Parameters:

• referenceFrame – The reference frame that the returned velocity vector is in. Defaults to the orbital reference frame of the object the orbit belongs to.

Returns:

The velocity as a vector.

Game Scenes:

All

Tuple<Double, Double, Double> RelativePosition (ReferenceFrame referenceFrame = null)

The position of the target relative to the orbiting object at the closest approach.

Parameters:

• referenceFrame – The reference frame whose axes the returned vector is expressed in. Defaults to the orbital reference frame of the object the orbit belongs to.

Returns:

The relative position as a vector.

Game Scenes:

All

Tuple<Double, Double, Double> RelativeVelocity (ReferenceFrame referenceFrame = null)

The velocity of the target relative to the orbiting object at the closest approach.

Parameters:

• referenceFrame – The reference frame whose axes the returned vector is expressed in. Defaults to the orbital reference frame of the object the orbit belongs to.

Returns:

The relative velocity as a vector.

Game Scenes:

All