Click or drag to resize

AccessConstraintSamplingGetNextStepFromRelativeMotionEvaluator Method (ILinkConstraint, Double, EvaluatorGroup)

Gets an evaluator that determines the next time at which to sample a constraint function based on the relative motion between two objects and a maximum relative motion per step.

Namespace:  AGI.Foundation.Access
Assembly:  AGI.Foundation.Core (in AGI.Foundation.Core.dll) Version: 19.1.398.0 (19.1.398.0)
Syntax
public static Evaluator<JulianDate> GetNextStepFromRelativeMotionEvaluator(
	ILinkConstraint constraint,
	double maximumAngularMotion,
	EvaluatorGroup group
)

Parameters

constraint
Type: AGI.Foundation.AccessILinkConstraint
The constraint from which the two objects (the observer and target) should be determined.
maximumAngularMotion
Type: SystemDouble
The maximum angular motion allowed, in radians.
group
Type: AGI.FoundationEvaluatorGroup
The group with which to associate the new evaluator. By grouping evaluators that are often evaluated at the same Julian dates, common computations can be performed only once for the entire group instead of multiple times for each evaluator.

Return Value

Type: EvaluatorJulianDate
The evaluator.
Exceptions
ExceptionCondition
ServiceNotAvailableException Thrown when any one of the following conditions are met:
PropertyInvalidException Thrown when any of the following conditions are met:
  • The constraint's ConstrainedLink property is null.
  • The link's Transmitter property is null.
  • The link's Receiver property is null.
  • The end of the link which is identified as the observer has a ReferenceFrame property.
  • The end of the link which is identified as the target has a LocationPoint property.
Remarks
In order to determine the next sample time, this evaluator requires that the angular velocity of the target relative to the observer be available. If it is not, the evaluator will return the input time as the next step, indicating that a default step should be taken.
See Also