Click or drag to resize

AccessConstraintSampling.GetNextStepFromRelativeMotionEvaluator 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: 24.3.420.0 (24.3.420.0)
Syntax
public static Evaluator<JulianDate> GetNextStepFromRelativeMotionEvaluator(
	ILinkConstraint constraint,
	double maximumAngularMotion,
	EvaluatorGroup group
)

Parameters

constraint
Type: AGI.Foundation.Access.ILinkConstraint
The constraint from which the two objects (the observer and target) should be determined.
maximumAngularMotion
Type: System.Double
The maximum angular motion allowed, in radians.
group
Type: AGI.Foundation.EvaluatorGroup
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: Evaluator<JulianDate>
The evaluator.
Exceptions
ExceptionCondition
ServiceNotAvailableException

Thrown when any 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 nullReferenceFrame property.
  • The end of the link which is identified as the target has a nullLocationPoint 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