StoppingConditionConstraintEvaluator Class

The evaluator for a StoppingConditionConstraint. This evaluator will be checked at one of two times and return a Boolean indicating if the state checked can be used to stop propagation (if the StoppingConditionEvaluator also determines if propagation should stop).

Inheritance Hierarchy

SystemObject
AGI.Foundation.StoppingConditionsStoppingConditionConstraintEvaluator
AGI.Foundation.StoppingConditionsThresholdStoppingConditionConstraintEvaluator

Namespace: AGI.Foundation.StoppingConditions
Assembly: AGI.Foundation.Models (in AGI.Foundation.Models.dll) Version: 24.2.419.0 (24.2.419.0)

Syntax

C++

Copy

public abstract class StoppingConditionConstraintEvaluator : IEvaluator, 
	IAvailability, IThreadAware, ICloneWithContext, IDisposable

Public MustInherit Class StoppingConditionConstraintEvaluator
	Implements IEvaluator, IAvailability, IThreadAware, ICloneWithContext, 
	IDisposable

public ref class StoppingConditionConstraintEvaluator abstract : IEvaluator, 
	IAvailability, IThreadAware, ICloneWithContext, IDisposable

[<AbstractClassAttribute>]
type StoppingConditionConstraintEvaluator =  
    class
        interface IEvaluator
        interface IAvailability
        interface IThreadAware
        interface ICloneWithContext
        interface IDisposable
    end

The StoppingConditionConstraintEvaluator type exposes the following members.

Constructors

	Name	Description
	StoppingConditionConstraintEvaluator(EvaluatorGroup, StoppingConditionConstraint)	Initializes a new instance.
	StoppingConditionConstraintEvaluator(StoppingConditionConstraintEvaluator, CopyContext)	Initializes a new instance as a copy of an existing instance.

Top

Properties

	Name	Description
	Group	Gets the group that contains this evaluator.
	IsThreadSafe	Gets a value indicating whether the methods on this instance are safe to call from multiple threads simultaneously.
	Name	Gets an optional name for this StoppingConditionConstraintEvaluator.
	WhenToCheck	Gets when to check the constraint (when an event is detected or exactly found). See the documentation of WhenToCheckConstraint to help decide which one to pick.

Top

Methods

	Name	Description
	AreConstraintsSatisfied	Loop through the constraints on a stopping condition and see if their constraints are satisfied by the state given when a relevant event is detected.
	CheckCurrentState	This method gets called every time a new ITimeBasedState is checked by the parent StoppingConditionEvaluator. This method should be used when the criteria of your StoppingConditionConstraintEvaluator needs to check every computed state. For example, ThresholdStoppingConditionConstraintEvaluator needs to keep track of extrema if its InequalityCriteria is set to GreaterThanMinimum or LessThanMaximum.
	Clone	Clones this object using the specified context.
	Dispose	Releases any resources associated with this instance.
	Dispose(Boolean)	Releases any resources associated with this instance.
	Equals	Determines whether the specified object is equal to the current object. (Inherited from Object.)
	Finalize	Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
	GetAvailabilityIntervals	Gets the intervals over which data is available.
	GetCachingWrapper	Gets a version of this evaluator that caches the previously computed value so that if it is evaluated twice at the same date the computation is done only once.
	GetHashCode	Serves as the default hash function. (Inherited from Object.)
	GetType	Gets the Type of the current instance. (Inherited from Object.)
	Initialize	Initialize the constraint with the initialState. This is useful for when the constraint is comparing the current value with the initial (such as something related to the duration of propagation).
	IsAvailable	Determines if valid data is available for the given JulianDate.
	IsConstraintSatisfied	This method will examine from the state and return if this constraint is satisfied, and if not.
	MemberwiseClone	Creates a shallow copy of the current Object. (Inherited from Object.)
	ToString	Returns a string that represents the current object. (Inherited from Object.)
	UpdateEvaluatorReferences	Updates the evaluator references held by this object using the reference-to-reference mapping in the specified CopyContext.

Top

Remarks

Often there are times when a StoppingCondition needs additional criteria to truly stop on the desired event. Simply combining StoppingConditions usually wouldn't work; if you would AND two conditions together, they both must have their own relevant at the exact same time. It is more reasonable to add constraints to a stopping condition that could, instead of stopping at some particular event, could instead signal that some other event has gone by, or has not happened yet. This is the evaluator for such an object.

Note that most cases are sampling some single double value from the state at the current propagation time. If that is the general behavior of your constraint, consider using ThresholdStoppingConditionConstraintEvaluator instead, which allows for the more general case for deciding upon the satisfaction of this constraint by any means of determining or based on the passed in state.

Reference

AGI.Foundation.StoppingConditions Namespace