VisibilitySegment.CalculateRefraction(Variable, Variable, Variable, Array) Method

Top

Description

Calculates the refracted ray from the observer to the target and calculates the refracted elevation angle, refracted distance and apparent refracted position of the target. The elevation angle is calculated as the angle between the Observer-to-Target vector and the Observers's local horizontal plane, which is tangent to the central body's reference spheroid. The Earth uses the WGS 84 (World Geodetic System 1984) reference ellipsoid.

Timing Precision Mode

This page describes functionality in millisecond timing precision mode. Millisecond timing precision mode is deprecated and will be removed in a future release. We recommend that you migrate your Mission Plans to nanosecond timing precision mode.

Click here to see the documentation for this object in nanosecond timing precision mode.

Method Signature

VisibilitySegment.CalculateRefraction(	Variable epoch,
	Variable angle,
	Variable distance,
	Array refractedPos)

Arguments

epoch
Description:	The epoch at which to evaluate the refraction calculation.

angle
Description:	The difference in elevation due to the effects of atmospheric refraction.
Valid Range:	angle ≥ 0

distance
Description:	The refracted distance between the observer and the target summed along the path of the refracted ray.
Valid Range:	distance ≥ 0

refractedPos
Description:	The apparent position of the refracted target as it appears to the observer.

Return Value

Type:

boolean

Returns true if calculating the refracting target was successful and false if no solution could be calculated.

Syntax

myVariable1 = myVisibilitySegment1.CalculateRefraction(myVariable2, myVariable3, myVariable4, myArray1);