Description

General properties of a TargetSequence segment.

Object Model

Public Methods

ApplyProfile	Apply Changes - applies the current values of specified profile to the segments within the target sequence.
ApplyProfileByName	Apply Changes - applies the current values of specified profile to the segments within the target sequence.
ApplyProfiles	Apply Changes - applies the current values of search profiles' controls and the changes specified by the segment configuration profiles to the segments within the target sequence.
ResetProfile	Reset - resets the current values of specified profile.
ResetProfileByName	Reset - resets the current values of specified profile.
ResetProfiles	Reset - resets the controls of the search profiles to the segments' values.

Public Properties

Action	Whether to run the sequence nominally or using profiles.
ContinueOnFailure	Continue if profiles don't converge - if true, the target sequence continues if a profile fails to converge; otherwise, the MCS will stop upon the failure of a search profile.
Profiles	Returns the profiles used within the target sequence.
ResetInnerTargeters	If true, inner target sequences will have their profiles reset before each run.
Segments	Returns the segments contained within the target sequence.
WhenProfilesFinish	When Profiles Converge - the action to be carried out if targeting has converged.

Example

Configure target sequence segment

[C#] Copy Code

// First add a sequence target 


IAgVAMCSSegment segment = driver.MainSequence.Insert(AgEVASegmentType.eVASegmentTypeTargetSequence, "Start Transfer", "-"); 


IAgVAMCSTargetSequence targetSequence = segment as IAgVAMCSTargetSequence; 


 

targetSequence.Action = AgEVATargetSeqAction.eVATargetSeqActionRunActiveProfiles; 


targetSequence.WhenProfilesFinish = AgEVAProfilesFinish.eVAProfilesFinishRunToReturnAndContinue; 


targetSequence.ContinueOnFailure = false; 

 

// Add as many child segments to target 


IAgVAMCSManeuver dv1 = targetSequence.Segments.Insert(AgEVASegmentType.eVASegmentTypeManeuver, "DV1", "-") as IAgVAMCSManeuver; 


IAgVAMCSManeuver dv2 = targetSequence.Segments.Insert(AgEVASegmentType.eVASegmentTypeManeuver, "DV2", "-") as IAgVAMCSManeuver; 


 

// Add more profiles if necessary 


string profileName = "Change Maneuver Type"; 


if (Array.IndexOf(targetSequence.Profiles.AvailableProfiles, profileName) != -1) 


{ 

    IAgVAProfile newProfile = targetSequence.Profiles.Add(profileName); 


} 

 

// Enable controls 


dv1.EnableControlParameter(AgEVAControlManeuver.eVAControlManeuverImpulsiveCartesianX); 


IAgVAProfileDifferentialCorrector dc = targetSequence.Profiles["Differential Corrector"] as IAgVAProfileDifferentialCorrector; 


IAgVADCControl controlParam = dc.ControlParameters.GetControlByPaths("DV1", "ImpulsiveMnvr.Cartesian.X"); 


controlParam.Enable = true; 

controlParam.MaxStep = 0.3; 

 

// Enable results 


((IAgVAMCSSegment)dv1).Results.Add("Epoch"); 

IAgVADCResult roaResult = dc.Results.GetResultByPaths("DV1", "Epoch"); 


roaResult.Enable = true; 

 

// Confiure the differential corrector 


dc.MaxIterations = 50; 

dc.EnableDisplayStatus = true; 

dc.Mode = AgEVAProfileMode.eVAProfileModeIterate; 


targetSequence.Action = AgEVATargetSeqAction.eVATargetSeqActionRunActiveProfiles;

Configure target sequence segment

[Visual Basic .NET] Copy Code

' First
add a sequence target

Dim segment As IAgVAMCSSegment =
driver.MainSequence.Insert(AgEVASegmentType.eVASegmentTypeTargetSequence,
"Start Transfer", "-")

Dim targetSequence As IAgVAMCSTargetSequence = TryCast(segment,
IAgVAMCSTargetSequence)



targetSequence.Action =
AgEVATargetSeqAction.eVATargetSeqActionRunActiveProfiles

targetSequence.WhenProfilesFinish =
AgEVAProfilesFinish.eVAProfilesFinishRunToReturnAndContinue

targetSequence.ContinueOnFailure = False



' Add as many child segments to
target

Dim dv1 As IAgVAMCSManeuver =
TryCast(targetSequence.Segments.Insert(AgEVASegmentType.eVASegmentTypeManeuver,
"DV1", "-"), IAgVAMCSManeuver)

Dim dv2 As IAgVAMCSManeuver =
TryCast(targetSequence.Segments.Insert(AgEVASegmentType.eVASegmentTypeManeuver,
"DV2", "-"), IAgVAMCSManeuver)



' Add more profiles if necessary

Dim profileName As String =
"Change Maneuver Type"

If Array.IndexOf(targetSequence.Profiles.AvailableProfiles,
profileName) <> -1 Then

    Dim newProfile
As IAgVAProfile =
targetSequence.Profiles.Add(profileName)

End If



' Enable controls

dv1.EnableControlParameter(AgEVAControlManeuver.eVAControlManeuverImpulsiveCartesianX)


Dim dc As
IAgVAProfileDifferentialCorrector =
TryCast(targetSequence.Profiles("Differential
Corrector"), IAgVAProfileDifferentialCorrector)

Dim controlParam As IAgVADCControl =
dc.ControlParameters.GetControlByPaths("DV1", "ImpulsiveMnvr.Cartesian.X")

controlParam.Enable = True

controlParam.MaxStep = 0.3



' Enable results

DirectCast(dv1, IAgVAMCSSegment).Results.Add("Epoch")

Dim roaResult As IAgVADCResult =
dc.Results.GetResultByPaths("DV1",
"Epoch")

roaResult.Enable = True



' Confiure the differential
corrector

dc.MaxIterations = 50

dc.EnableDisplayStatus = True

dc.Mode = AgEVAProfileMode.eVAProfileModeIterate

targetSequence.Action =
AgEVATargetSeqAction.eVATargetSeqActionRunActiveProfiles

Insert a Target Sequence Segment into the MCS and configure

[MATLAB] Copy Code

% IAgVADriverMCS driver: MCS driver interface 


ts = driver.MainSequence.Insert('eVASegmentTypeTargetSequence', 'Start Transfer', '-'); 


dv1 = ts.Segments.Insert('eVASegmentTypeManeuver', 'DV1', '-'); 


%Insert maneuver into target sequence and target thrust vector 


dv1.SetManeuverType('eVAManeuverTypeImpulsive'); 

impulsive = dv1.Maneuver; 

impulsive.SetAttitudeControlType('eVAAttitudeControlThrustVector'); 


thrustVector = impulsive.AttitudeControl; 

thrustVector.ThrustAxesName = 'Satellite/MySatellite VNC(Earth)'; 


dv1.EnableControlParameter('eVAControlManeuverImpulsiveCartesianX'); 


dv1.Results.Add('Keplerian Elems/Radius of Apoapsis'); 


%Handle to differential corrector profile 


dc = ts.Profiles.Item('Differential Corrector'); 


%Set up control parameter 

xControlParam = dc.ControlParameters.GetControlByPaths('DV1','ImpulsiveMnvr.Cartesian.X'); 


xControlParam.Enable = true; 

xControlParam.MaxStep = 0.3; 

%Set up result for control parameter 


roaResult = dc.Results.GetResultByPaths('DV1', 'Radius Of Apoapsis'); 


roaResult.Enable = true; 

roaResult.DesiredValue = 42238; 

roaResult.Tolerance = 0.1; 

 

dc.MaxIterations = 50; 

ts.Action = 'eVATargetSeqActionRunActiveProfiles';

CoClasses that Implement IAgVAMCSTargetSequence

Name
AgVAMCSTargetSequence

AGI STK Astrogator 11	Send comments on this topic.
IAgVAMCSTargetSequence Interface