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:
- This command cannot be used to insert segments within automatic sequences.
- The attribute path should end at the segment that you want to insert a new segment before.
- To insert a segment at the end of the MCS or a subsequence, use the "-" symbol as the end of the path.
- 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