agi.foundation.numericalmethods

(agi.foundation.models-2025r1.jar)

Class SegmentPropagatorConstraint

java.lang.Object

agi.foundation.infrastructure.DefinitionalObject

agi.foundation.numericalmethods.SegmentPropagatorConstraint

All Implemented Interfaces:

ICloneWithContext, IEnumerateDependencies, IEquatableDefinition, IFreezable

Direct Known Subclasses:

DelegateBasedConstraint, ExtremeValueOfSegmentConstraint, ScalarAtEndOfNumericalSegmentConstraint, ScalarAtEndOfSegmentConstraint, ScalarDifferenceOfSegmentConstraint

public abstract class SegmentPropagatorConstraint
extends DefinitionalObject

The base type for constraints for use with the MultivariableFunctionSolver or ParameterOptimizer. This is the definition of the evaluator.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	SegmentPropagatorConstraint() Initializes a new instance.
protected	SegmentPropagatorConstraint(double desiredValue, double tolerance) Initializes a new instance.
protected	SegmentPropagatorConstraint(double desiredValue, double tolerance, SolverConstraintScaling scaling) Initializes a new instance.
protected	SegmentPropagatorConstraint(SegmentPropagatorConstraint existingInstance, CopyContext context) Initializes a new instance as a copy of an existing instance.
protected	SegmentPropagatorConstraint(ValueDefinition<Double> desiredValue, double tolerance) Initializes a new instance.
protected	SegmentPropagatorConstraint(ValueDefinition<Double> desiredValue, double tolerance, SolverConstraintScaling scaling) Initializes a new instance.
protected	SegmentPropagatorConstraint(ValueDefinition<Double> desiredValue, double tolerance, SolverConstraintScaling scaling, double weight) Initializes a new instance.

Method Summary

Modifier and Type	Method and Description
protected boolean	checkForSameDefinition(DefinitionalObject other) Checks to determine if another instance has the same definition as this instance and returns true if it does.
protected abstract boolean	checkForSameDefinition(SegmentPropagatorConstraint other) Checks to determine if another instance has the same definition as this instance and returns true if it does.
protected int	computeCurrentDefinitionHashCode() Computes a hash code based on the current properties of this object.
void	enumerateDependencies(DependencyEnumerator enumerator) Enumerates the dependencies of this object by calling DependencyEnumerator#enumerate(T) for each object that this object directly depends upon.
protected void	freezeAggregatedObjects() Called by DefinitionalObject.freeze() to also freeze any objects that are considered to be a part of this object.
ValueDefinition<Double>	getDesiredValue() Gets the threshold that the evaluated value will be compared to when solving for a particular trajectory.
abstract SegmentPropagatorConstraintEvaluator	getEvaluator(EvaluatorGroup group) Creates and returns the SegmentPropagatorConstraintEvaluator.
String	getName() Gets an optional name to identify this constraint.
SolverConstraintSettings	getSettings() Gets the settings for the MultivariableFunctionSolver or ParameterOptimizer associated with this constraint.
void	setDesiredValue(ValueDefinition<Double> value) Sets the threshold that the evaluated value will be compared to when solving for a particular trajectory.
void	setName(String value) Sets an optional name to identify this constraint.
void	setSettings(SolverConstraintSettings value) Sets the settings for the MultivariableFunctionSolver or ParameterOptimizer associated with this constraint.
protected void	validateProperties() Validates that required properties are configured correctly in order to get an evaluator for this instance.

Methods inherited from class agi.foundation.infrastructure.DefinitionalObject

areSameDefinition, areSameDefinition, areSameDefinition, areSameDefinition, areSameDefinition, clone, collectionItemsAreSameDefinition, collectionItemsAreSameDefinition, collectionItemsAreSameDefinition, dictionaryItemsAreSameDefinition, freeze, getCollectionHashCode, getCollectionHashCode, getCollectionHashCode, getDefinitionHashCode, getDefinitionHashCode, getDefinitionHashCode, getDefinitionHashCode, getDefinitionHashCode, getDefinitionHashCode, getDictionaryHashCode, getIsFrozen, isSameDefinition, throwIfFrozen

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

SegmentPropagatorConstraint

protected SegmentPropagatorConstraint()

Initializes a new instance. The weight defaults to 1.0.

Before SegmentPropagatorConstraint.getEvaluator(agi.foundation.EvaluatorGroup) can be called, DesiredValue (get / set) must be configured, and Settings (get / set) must be configured with a valid Tolerance (get / set). Scaling (get / set) defaults to NoScalingOnConstraint.

SegmentPropagatorConstraint

protected SegmentPropagatorConstraint(double desiredValue,
                                      double tolerance)

Initializes a new instance. The weight defaults to 1.0.

Scaling (get / set) defaults to NoScalingOnConstraint.

Parameters:

desiredValue - The desired value that the SolvableMultivariableFunction will be driven to.

tolerance - How close the evaluated value must get to the desiredValue to consider this constraint satisfied.

SegmentPropagatorConstraint

protected SegmentPropagatorConstraint(ValueDefinition<Double> desiredValue,
                                      double tolerance)

Initializes a new instance. The weight defaults to 1.0.

Scaling (get / set) defaults to NoScalingOnConstraint.

Parameters:

desiredValue - The desired value that the SolvableMultivariableFunction will be driven to.

tolerance - How close the evaluated value must get to the desiredValue to consider this constraint satisfied.

SegmentPropagatorConstraint

protected SegmentPropagatorConstraint(double desiredValue,
                                      double tolerance,
                                      @Nonnull
                                      SolverConstraintScaling scaling)

Initializes a new instance. The weight defaults to 1.0.

Parameters:

desiredValue - The desired value that the SolvableMultivariableFunction will be driven to.

tolerance - How close the evaluated value must get to the desiredValue to consider this constraint satisfied.

scaling - The type of scaling to be used on this constraint.

SegmentPropagatorConstraint

protected SegmentPropagatorConstraint(ValueDefinition<Double> desiredValue,
                                      double tolerance,
                                      @Nonnull
                                      SolverConstraintScaling scaling)

Initializes a new instance. The weight defaults to 1.0.

Parameters:

desiredValue - The desired value that the SolvableMultivariableFunction will be driven to.

tolerance - How close the evaluated value must get to the desiredValue to consider this constraint satisfied.

scaling - The type of scaling to be used on this constraint.

SegmentPropagatorConstraint

protected SegmentPropagatorConstraint(ValueDefinition<Double> desiredValue,
                                      double tolerance,
                                      @Nonnull
                                      SolverConstraintScaling scaling,
                                      double weight)

Initializes a new instance.

Parameters:

desiredValue - The desired value that the SolvableMultivariableFunction will be driven to.

tolerance - How close the evaluated value must get to the desiredValue to consider this constraint satisfied.

scaling - The type of scaling to be used on this constraint.

weight - The weight of this constraint compared to the cost function and other constraints.

SegmentPropagatorConstraint

protected SegmentPropagatorConstraint(@Nonnull
                                      SegmentPropagatorConstraint existingInstance,
                                      @Nonnull
                                      CopyContext context)

Initializes a new instance as a copy of an existing instance.

See ICloneWithContext.clone(CopyContext) for more information about how to implement this constructor in a derived class.

Parameters:

existingInstance - The existing instance to copy.

context - A CopyContext that controls the depth of the copy.

Throws:

ArgumentNullException - Thrown when existingInstance or context is null.

Method Detail

checkForSameDefinition

protected final boolean checkForSameDefinition(DefinitionalObject other)

Checks to determine if another instance has the same definition as this instance and returns true if it does. Derived classes MUST override this method and check all new fields introduced by the derived class for definitional equivalence. It is NOT necessary to check base class fields because the base class will already have done that. When overriding this method, you should NOT call the base implementation because it will return false for all derived-class instances. Derived classes should check the type of other to preserve the symmetric nature of IEquatableDefinition.isSameDefinition(java.lang.Object).

Specified by:

checkForSameDefinition in class DefinitionalObject

Parameters:

other - The other instance to compare to this one.

Returns:

true if the two objects are defined equivalently; otherwise false.

checkForSameDefinition

protected abstract boolean checkForSameDefinition(SegmentPropagatorConstraint other)

Checks to determine if another instance has the same definition as this instance and returns true if it does. Derived classes MUST override this method and check all new fields introduced by the derived class for definitional equivalence. It is NOT necessary to check base class fields because the base class will already have done that. When overriding this method, you should NOT call the base implementation because it will return false for all derived-class instances. Derived classes should check the type of other to preserve the symmetric nature of IEquatableDefinition.isSameDefinition(java.lang.Object).

Parameters:

other - The other instance to compare to this one.

Returns:

true if the two objects are defined equivalently; otherwise false.

computeCurrentDefinitionHashCode

protected int computeCurrentDefinitionHashCode()

Computes a hash code based on the current properties of this object. Derived classes MUST override this method and compute a hash code that combines: a unique hash code seed, the base implementation result, and the hash codes of all new fields introduced by the derived class which are used in the SegmentPropagatorConstraint.checkForSameDefinition(agi.foundation.infrastructure.DefinitionalObject) method.

Overrides:

computeCurrentDefinitionHashCode in class DefinitionalObject

Returns:

The computed hash code.

enumerateDependencies

public void enumerateDependencies(DependencyEnumerator enumerator)

Enumerates the dependencies of this object by calling DependencyEnumerator#enumerate(T) for each object that this object directly depends upon. Derived classes which contain additional dependencies MUST override this method, call the base implementation, and enumerate dependencies introduced by the derived class.

Specified by:

enumerateDependencies in interface IEnumerateDependencies

Overrides:

enumerateDependencies in class DefinitionalObject

Parameters:

enumerator - The enumerator that is informed of the dependencies of this object.

freezeAggregatedObjects

protected void freezeAggregatedObjects()

Called by DefinitionalObject.freeze() to also freeze any objects that are considered to be a part of this object. Derived classes which contain additional aggregated objects MUST override this method, call the base implementation, and freeze aggregated objects introduced by the derived class. The objects that need to be frozen in this method are frequently created in this object's constructor and are not settable via properties.

Overrides:

freezeAggregatedObjects in class DefinitionalObject

getDesiredValue

public final ValueDefinition<Double> getDesiredValue()

Gets the threshold that the evaluated value will be compared to when solving for a particular trajectory. This value must not vary in time; consider using a ParameterizedValueDefinition if you want to change this value at propagation time.

setDesiredValue

public final void setDesiredValue(ValueDefinition<Double> value)

Sets the threshold that the evaluated value will be compared to when solving for a particular trajectory. This value must not vary in time; consider using a ParameterizedValueDefinition if you want to change this value at propagation time.

getSettings

public final SolverConstraintSettings getSettings()

Gets the settings for the MultivariableFunctionSolver or ParameterOptimizer associated with this constraint.

setSettings

public final void setSettings(SolverConstraintSettings value)

Sets the settings for the MultivariableFunctionSolver or ParameterOptimizer associated with this constraint.

getName

public final String getName()

Gets an optional name to identify this constraint.

setName

public final void setName(String value)

Sets an optional name to identify this constraint.

getEvaluator

@Nonnull
public abstract SegmentPropagatorConstraintEvaluator getEvaluator(@Nonnull
                                                                            EvaluatorGroup group)

Creates and returns the SegmentPropagatorConstraintEvaluator.

Derived classes should call SegmentPropagatorConstraint.validateProperties() to check properties owned by this base class, as well as validate their own properties.

Parameters:

group - The EvaluatorGroup to use to create any necessary evaluators for this constraint.

Returns:

The fully configured constraint evaluator.

validateProperties

protected void validateProperties()

Validates that required properties are configured correctly in order to get an evaluator for this instance. Derived classes should call this method when implementing SegmentPropagatorConstraint.getEvaluator(agi.foundation.EvaluatorGroup), as well as validate their own properties.

Throws:

PropertyInvalidException - Thrown when Settings (get / set) or DesiredValue (get / set) is null, or Scaling (get / set) is null, or Tolerance (get / set) is not greater than zero.