TargetedSegmentList Class

Initializes a new instance. At least one SegmentDefinition must be added to Segments, and at least one operator must be added to the Operators.

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

Gets or sets a value indicating whether the next operator should continue if the operators do not converge. If set to , the next operators will continue to run as if it did converge. If , a property on the results will be set to indicate that all propagation should stop and the results will be returned.

Gets or sets the behavior that should be done when an operators converges.

Gets the names of all of the elements that this segment is propagating.

Gets a value indicating whether this object is frozen. A frozen object cannot be modified and an ObjectFrozenException will be thrown if an attempt is made to do so.

Gets or sets a name to describe the segment. This is optional.

Gets or sets the behavior for passing states to the next segment. See StateForNextSegmentBehavior for more information.

Gets or sets how the propagator will run the operators (will the operators be run normally, be run once, or just run the nominal sequence).

Gets the operators that this segment will run. Operators will in some way edit the segments configuration which will affect the propagation. The operators will be run in series, the modified segments of one passed into the next.

Gets a value indicating whether the segment is such that it will not define any Elements or StateElementAdapters. Such a segment typically affects the control flow of multiple segments instead of propagating state elements. By default this is , but if the specific derived segment can use the previous segment's adapters, override this property to always return . Even if this is some segments may require adapters to be set with the SetElementAndAdapter(StateElementAdapterDefinition) method.

Gets or sets the direction that this segment will be initially propagated. If this segment propagates multiple segments, the child segments will be propagated in the direction that they are configured with. If the overall list is going forward, segments that go back in time will override the immediate previous segments ephemeris, but if another segment going forward follows the backwards segment, that backwards segment will be ignored when the overall trajectory is resolved into a single ephemeris set. If you are using a StoppingCondition that depends on time, the time span of those stopping conditions must match this property (for example, a DurationStoppingCondition must have a negative threshold if this is set to Decreasing, otherwise, the condition will never be tripped).

Gets or sets a value indicating whether or not this TargetedSegmentList should be reset at the start of every run initiated by this segments parent. This is most relevant when this TargetedSegmentList is a child segment of another TargetedSegmentList. This should be set to if your initial configuration is a better guess than this segments previous run. This is by default.

Gets the segments that will get propagated. It is recommended that you do not add the same SegmentDefinition more than once. You will be limited in what results you can easily extract from a SegmentListResults, and the SegmentListConfiguration will only return the configuration of the first SegmentPropagator made from that SegmentDefinition in the list.

Checks to determine if another instance has the same definition as this instance and returns 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 for all derived-class instances. Derived classes should check the type of other to preserve the symmetric nature of IsSameDefinition(Object).

Checks to determine if another instance has the same definition as this instance and returns 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 for all derived-class instances. Derived classes should check the type of other to preserve the symmetric nature of IsSameDefinition(Object).

Checks to determine if another instance has the same definition as this instance and returns 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 for all derived-class instances. Derived classes should check the type of other to preserve the symmetric nature of IsSameDefinition(Object).

Checks to determine if another instance has the same definition as this instance and returns 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 for all derived-class instances. Derived classes should check the type of other to preserve the symmetric nature of IsSameDefinition(Object).

Clones this object using the specified context.

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 CheckForSameDefinition(DefinitionalObject) method.

Checks to see if there is a StateElementAdapterDefinition for the provided element.

Creates, configures, and returns the SegmentPropagator for this segment. This method should check that all of the required properties on the concrete instance are configured properly before constructing the SegmentPropagator to be returned.

Enumerates the dependencies of this object by calling EnumerateT(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.

Determines whether the specified object is equal to the current object.

Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.

Freezes this object. Further attempts to modify it will result in an ObjectFrozenException.

Called by 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.

Gets the object (for example, a ReferenceFrame, an Axes, etc.) in which the specified element is defined in. This can return if there is no such object. When overriding this method, you generally should not call the base method, instead the derived segment should keep track of the elements and defined in objects itself.

Gets a hash code representing the definition of this object.

Returns the adapter for the given state element. The StateElementAdapters handle the various transformations of the propagated elements between segments (for example, if the integration frame of a point being propagated changes from one segment to another, the adapter is what handles that transformation between segment). All elements propagated by this segment must have an adapter returned by this method (even if that adapter simply returns the original state). If multiple segments are being propagated by this segment (as a SegmentList would), this must return the adapter of the StateElementAdapter of the element for the final known segment getting propagated.

Loops over the Segments in this SegmentList and returns the first one with the specified Name, or if a segment with that segmentName is not in the list

Serves as the default hash function.

Creates and returns the propagator for this segment list.

Creates and returns the propagator for this segment list.

Creates and returns the propagator for this segment list.

Creates and returns the propagator for this SegmentList.

Creates, configures, and returns the SegmentPropagator for this segment. This method assumes that no previous segment is needed to configure this segment's propagator.

Creates, configures, and returns the SegmentPropagator for this segment. This method assumes that no previous segment is needed to configure this segment's propagator.

Creates, configures, and returns the SegmentPropagator for this segment.

Creates, configures, and returns the SegmentPropagator for this segment.

Returns the SegmentDefinition that should be used to initialize the next SegmentDefinition after this SegmentList with. If it is known at the time when GetSegmentListPropagator is called that the final segment will be different, that other segment should be returned by this method.

Gets the Type of the current instance.

Determines if this object has the same definition as another object.

Creates a shallow copy of the current Object.

Removes the StateElementAdapterDefinition for the specified element.

Throws ObjectFrozenException if this object IsFrozen. This method should be called from any method or property that modifies this object.

Returns a string that represents the current object.

An event that gets raised when propagation is complete.