Astrogator InsertSegment

Astrogator InsertSegment is a command that inserts a segment in the MCS or a subsequence.

Syntax

Astrogator <Satellite Object Path> InsertSegment <Attribute Path>

Description

There are no attributes or values for this command. Specify the attribute path to the segment that you want to insert. The following additional rules govern the use of this command:

  1. This command cannot be used to insert segments within automatic sequences.
  2. The attribute path should end at the segment that you want to insert a new segment before.
  3. To insert a segment at the end of the MCS or a subsequence, use the "-" symbol as the end of the path.
  4. To insert a segment that is in the MCS and not nested in a subsequence, you do not have to include the full path; simply name the segment that you want to insert a new segment before.

Examples

To insert a propagate segment before the "Maneuver1" segment in the MCS:

Astrogator */Satellite/Satellite1 InsertSegment MainSequence.SegmentList.Maneuver1 Propagate

or simply Astrogator */Satellite/Satellite1 InsertSegment Maneuver1 Propagate

To insert a propagate segment at the end of the MCS:

Astrogator */Satellite/Satellite1 InsertSegment MainSequence.SegmentList.- Propagate

or simply Astrogator */Satellite/Satellite1 InsertSegment - Propagate

To insert a propagate segment before the "Maneuver1" segment within "Target_Sequence":

Astrogator */Satellite/Satellite1 InsertSegment MainSequence.SegmentList.Target_Sequence.SegmentList.Maneuver1 Propagate

Alternatives Using Astrogator SetValue

You can also use the Astrogator SetValue command to define the entire MCS, a subsequence, or an automatic sequence. To use this method to insert new segments, place them where you want them to be added within the existing MCS segment list. New segments must be assigned using only the segment name - Astrogator will automatically rename them according to the default convention. Existing segments must be listed according to their current names in order to preserve their settings; otherwise Astrogator will simply replace the segment with a new instance of the same segment type.

Examples

To define an entirely new MCS:

Astrogator */Satellite/Satellite1 SetValue MainSequence.SegmentList Initial_State Maneuver Return

To add two propagate segments to the MCS created in the previous example:

Astrogator */Satellite/Satellite1 SetValue MainSequence.SegmentList Initial_State Propagate Maneuver Propagate Return

To add a hold segment to an automatic sequence that is currently comprised of launch and propagate segments:

Astrogator */Satellite/Satellite1 SetValue AutoSequenceList.Sequence1.SegmentList Launch Propagate Hold

STK Programming Interface 11.0.1