Data Provider Elements

RIC Coordinates

The relative ephemeris of the assigned object with respect to the primary object, expressed in Cartesian components, as a function of time.

The relative ephemeris is computed with respect to two rotating frames, the RIC (Radial, In-Track, Cross-Track) frame and the NTC (Normal, Tangential, and Cross-Track) frames, that are defined using the primary's ephemeris.

Cross-track refers to the direction perpendicular to the position and inertial velocity; in-track refers to the direction perpendicular to both the radial and cross-track (positive in the direction of motion); tangential refers to the direction along the velocity vector; and normal refers to the direction perpendicular to the velocity and cross-track directions (positive outward along radial).

If the ephemeris times of the assigned object do not match those of the primary object, then the ephemeris of the assigned object is interpolated to the ephemeris times of the primary object. This can lead to nonzero values reported between primary and assigned objects that should be at the same position.



Available for these objects: Satellite

Type: Time-varying data.

Availability: Reports | Graphs | Dynamic Displays | Strip Charts

Pre-data required: "<TruncObjectPath>" - e.g. "Satellite/Sat1"

Data Provider Elements

NameDimensionTypeDescription
TimeDateReal Number or TextTime.
RadialDistanceReal NumberThe radial component of the relative position vector.
In-TrackDistanceReal NumberThe in-track component of the relative position vector.
Cross-TrackDistanceReal NumberThe cross-track component of the relative position vector.
RangeDistanceReal NumberThe range (i.e., distance between the primary and secondary object) at the given time.
Radial RateRateReal NumberThe radial component of the relative velocity vector as observed in the RIC rotating frame.
In-Track RateRateReal NumberThe in-track component of the relative velocity vector as observed in the RIC rotating frame.
Cross-Track RateRateReal NumberThe cross-track component of the relative velocity vector as observed in the RIC rotating frame.
Range RateRateReal NumberThe rate of change of the magnitude of the relative position vector. This is computed using the analytical formula dot_product(relative_position_vector, relative_velocity_vector) / magnitude(relative_position_vector). This is an exact formula when the velocity is the derivative of position. Some propagators (e.g., SGP4, J2Perturbation, J4Perturbation), however, produce ephemerides where the velocity is not exactly the derivative of position so that this formula does not compute the derivative of range exactly in such cases.
Range Rate NumericalRateReal NumberThe rate of change of the magnitude of the relative position vector. This is computed using numerical differentiation of the range. The central difference will be used for interior points; forward or backward differences will be used at ephemeris start and stop times.
Range Rate DotAccelerationReal NumberThe time derivative of the range rate, as evaluated using the analytical formula.
Range Rate Dot NumericalAccelerationReal NumberThe time derivative of the range rate, as evaluated using numerical differentiation.
TangentialDistanceReal NumberThe tangential component of the relative position vector.
Tangential RateRateReal NumberThe tangential component of the relative velocity vector as observed in the NTC rotating frame.
NormalDistanceReal NumberThe normal component of the relative position vector.
Normal RateRateReal NumberThe normal component of the relative velocity vector as observed in the NTC rotating frame.
Time DifferenceTimeReal NumberAlternative measure for in-track position difference, computed as duration. The duration is computed by dividing the in-track component of the relative position vector by the inertial velocity of the primary object.
SpeedRelToRICFrameRateReal NumberThe magnitude of the relative velocity vector, as observed in the RIC rotating frame.
Radial Vel DiffRateReal NumberThe radial component of the vector difference between the assigned object's and the primary's inertial velocities.
In-Track Vel DiffRateReal NumberThe in-track component of the vector difference between the assigned object's and the primary's inertial velocities.
Cross-Track Vel DiffRateReal NumberThe cross-track component of the vector difference between the assigned object's and the primary's inertial velocities.
From ObjectDistanceTextThe class name and name of the From-object.
To ObjectDistanceTextThe class name and name of the To-object.
Position Cov SigmaUnitlessReal NumberPosition difference measured in terms of the position covariance. Reports N where the current relative position vector lies on a N sigma ellipsoid, where the ellipsoid if obtained from the position covariance of the primary satellite. This can only be computed if position covariance is available.
Position Combined Cov SigmaUnitlessReal NumberPosition difference measured in terms of the combined position covariance of primary and target satellites. Reports N where the current relative position vector lies on an N sigma ellipsoid, where the ellipsoid is obtained from the sum of the covariances matrices of the two objects. This can only be computed if position covariance is available.