Click or drag to resize

BasicLaunchSegment Class

This launch segment provides compatibility with STK Astrogator's launch segment. The design of this segment is relatively simple: form an ellipse in the fixed frame between the launch point and the burnout point and interpolate along this ellipse to produce the output ephemeris. This model is low fidelity, but provides a reasonable visualization for launch to orbit insertion. When the burnout state specifies the final velocity in the fixed frame, the flight path angle is set to zero and the final orbit's inclination is determined by the arc of the ellipse. When the burnout state specifies the burnout velocity in the inertial frame it is possible to specify the characteristics of the final orbit more exactly.
Inheritance Hierarchy

Namespace:  AGI.Foundation.SegmentPropagation
Assembly:  AGI.Foundation.SegmentPropagation (in AGI.Foundation.SegmentPropagation.dll) Version: 24.2.419.0 (24.2.419.0)
Syntax
public class BasicLaunchSegment : SegmentDefinition

The BasicLaunchSegment type exposes the following members.

Constructors
  NameDescription
Public methodBasicLaunchSegment
Initializes a new launch segment. The segment will need to be configured with the appropriate parameters before propagation can occur.
Public methodBasicLaunchSegment(Duration)
Initializes a new launch segment with the specified step size.
Protected methodBasicLaunchSegment(BasicLaunchSegment, CopyContext)
Initializes a new instance as a copy of an existing instance.
Public methodBasicLaunchSegment(Duration, String, ITimeBasedState)
Initializes a new launch segment with the specified step size, launch state, and motion ID.
Public methodBasicLaunchSegment(Duration, String, ITimeBasedState, ITimeBasedState)
Initializes a new launch segment with the specified step size, launch state, burnout state, and motion ID.
Top
Properties
  NameDescription
Public propertyAscentType
Gets or sets the interpolation type for the ascent. Use the quartic type when specifying an initial acceleration.
Public propertyBurnoutFlightPathAngle
Gets or sets the burnout velocity's flight path angle. This defaults to zero.
Public propertyBurnoutState
Gets or sets the burnout state. The state's motion element, if set, must contain the ID specified with MotionID.
Public propertyBurnoutVelocityAzimuth
Gets or sets the burnout velocity's azimuth. This defaults to zero.
Public propertyBurnoutVelocityFrame
Gets or sets the reference frame that the burnout velocity is specified in.
Public propertyBurnoutVelocityMagnitude
Gets or sets the burnout velocity magnitude in the CentralBody reference frame indicated by BurnoutVelocityFrame. This defaults to zero m/s.
Public propertyCentralBody
Gets or sets the central body to be used for the launch segment.
Public propertyElements
Gets the names of all of the elements that this segment is propagating.
(Inherited from SegmentDefinition.)
Public propertyInitialAcceleration
Gets or sets the initial acceleration at launch. The AscentType type must be set to quartic to use. This defaults to zero m/s^2.
Public propertyIsFrozen
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.
(Inherited from DefinitionalObject.)
Public propertyLaunchState
Gets or sets the launch state. This needs to include a launch date and a motion whose ID matches the ID specified in MotionID.
Public propertyMotionID
Gets or sets the ID in the state that represents the motion to be computed/manipulated.
Public propertyName
Gets or sets a name to describe the segment. This is optional.
(Inherited from SegmentDefinition.)
Public propertyNextStateBehavior
Gets or sets the behavior for passing states to the next segment. See StateForNextSegmentBehavior for more information.
(Inherited from SegmentDefinition.)
Public propertyNumberOfSamplePoints
Gets or sets the number of points to be sampled on the interpolation spline.
Public propertyOrder
Gets or sets the order of the motion produced by the propagator. This may be up to jerk (order 3).
Public propertyPassAllElementsToNextSegment
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.
(Overrides SegmentDefinitionPassAllElementsToNextSegment.)
Public propertyPropagationDirection
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).
(Inherited from SegmentDefinition.)
Public propertyStep
Gets or sets the default step that the SegmentPropagator should create states for. This must be a positive duration.
Top
Methods
  NameDescription
Protected methodCheckForSameDefinition(BasicLaunchSegment)
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).
Protected methodCheckForSameDefinition(DefinitionalObject)
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).
(Inherited from SegmentDefinition.)
Protected methodCheckForSameDefinition(SegmentDefinition)
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).
(Overrides SegmentDefinitionCheckForSameDefinition(SegmentDefinition).)
Public methodClone
Clones this object using the specified context.
(Overrides DefinitionalObjectClone(CopyContext).)
Protected methodComputeCurrentDefinitionHashCode
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.
(Overrides SegmentDefinitionComputeCurrentDefinitionHashCode.)
Public methodContainsElement
Checks to see if there is a StateElementAdapterDefinition for the provided element.
(Inherited from SegmentDefinition.)
Protected methodCreateSegmentPropagator
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.
(Overrides SegmentDefinitionCreateSegmentPropagator(EvaluatorGroup, SegmentDefinition).)
Public methodCreateSequenceWithPreLaunchHold
This helper method returns a SegmentList that contains three parts; an InitialStateSegmentT, a HoldSegment and this BasicLaunchSegment. This sequence may then be used to model a launch segment with a pre-launch hold time. The epoch of the produced initial state segment will be the launch epoch minus the hold time.
Public methodEnumerateDependencies
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.
(Overrides DefinitionalObjectEnumerateDependencies(DependencyEnumerator).)
Public methodEquals
Determines whether the specified object is equal to the current object.
(Inherited from Object.)
Protected methodFinalize
Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.
(Inherited from Object.)
Public methodFreeze
Freezes this object. Further attempts to modify it will result in an ObjectFrozenException.
(Inherited from DefinitionalObject.)
Protected methodFreezeAggregatedObjects
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.
(Inherited from DefinitionalObject.)
Public methodGetDefinedIn
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.
(Inherited from SegmentDefinition.)
Public methodGetDefinitionHashCode
Gets a hash code representing the definition of this object.
(Inherited from DefinitionalObject.)
Public methodGetElementAdapter
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.
(Inherited from SegmentDefinition.)
Public methodGetHashCode
Serves as the default hash function.
(Inherited from Object.)
Public methodGetSegmentPropagator
Creates, configures, and returns the SegmentPropagator for this segment. This method assumes that no previous segment is needed to configure this segment's propagator.
(Inherited from SegmentDefinition.)
Public methodGetSegmentPropagator(EvaluatorGroup)
Creates, configures, and returns the SegmentPropagator for this segment. This method assumes that no previous segment is needed to configure this segment's propagator.
(Inherited from SegmentDefinition.)
Public methodGetSegmentPropagator(SegmentDefinition)
Creates, configures, and returns the SegmentPropagator for this segment.
(Inherited from SegmentDefinition.)
Public methodGetSegmentPropagator(EvaluatorGroup, SegmentDefinition)
Creates, configures, and returns the SegmentPropagator for this segment.
(Inherited from SegmentDefinition.)
Public methodGetType
Gets the Type of the current instance.
(Inherited from Object.)
Public methodIsSameDefinition
Determines if this object has the same definition as another object.
(Inherited from DefinitionalObject.)
Protected methodMemberwiseClone
Creates a shallow copy of the current Object.
(Inherited from Object.)
Public methodRemoveElement
Removes the StateElementAdapterDefinition for the specified element.
(Inherited from SegmentDefinition.)
Public methodSetElementAndAdapter

Add or sets an adapter for an element in this segment.

Note that many types of derived segments will automatically handle their adapters by interrogating properties specific to the derived segment. Also some segments whose PassAllElementsToNextSegment property is do not require adapters or elements to be set.

These adapters have the responsibility of processing the initial state that the propagator will start propagating from. They will modify the initial state passed to this segment so that the state is in a form that the propagator can process.

(Inherited from SegmentDefinition.)
Protected methodThrowIfFrozen
Throws ObjectFrozenException if this object IsFrozen. This method should be called from any method or property that modifies this object.
(Inherited from DefinitionalObject.)
Public methodToString
Returns a string that represents the current object.
(Inherited from SegmentDefinition.)
Top
Events
Remarks
Note that the reference frame used for the input positions must be set. This is accomplished via SetElementAndAdapter(StateElementAdapterDefinition). Both the BurnoutState and LaunchState location reference frames must be the same.
See Also