Design_Explorer_Optimizer

This attribute defines the Design_Explorer_Optimizer targeting profile.

Syntax

Astrogator <Satellite Object Path> SetValue <Attribute Path>.Profiles.Design_Explorer_Optimizer.{Attribute} <Value> [{Unit}]

Astrogator_RM <Satellite Object Path> GetMCSConstraintValue <Attribute Path>.Profiles.Design_Explorer_Optimizer <ParentObjectName> <ResultName> <Attribute>

Astrogator_RM <Satellite Object Path> GetMCSControlValue <Attribute Path>.Profiles.Design_Explorer_Optimizer <ParentObjectName> <ControlName> <Attribute>

Astrogator <Satellite Object Path> SetMCSConstraintValue <Attribute Path>.Profiles.Design_Explorer_Optimizer <ParentObjectName> <ResultName> <Attribute> <Value> [<Unit>]

Astrogator <Satellite Object Path> SetMCSControlValue <Attribute Path>.Profiles.Design_Explorer_Optimizer <ParentObjectName> <ControlName> <Attribute> <Value> [<Unit>]

Description

The Design Explorer Optimizer Profile is a search profile that uses a gradient-based optimization algorithm to achieve an objective. The optimizer modifies a set of control parameters to achieve the objective while applying a set of constraints that define the problem space. The optimization algorithm uses the Sequential Quadratic Programming (SQP) methodology to search for the objective.

Examples

Setting the Mode

Available Design_Explorer_Optimizer modes are:

Iterate
Not Active
Run Once

Astrogator */Satellite/Satellite1 SetValue MainSequence.SegmentList.Target_Sequence.Profiles.Design_Explorer_Optimizer.Mode Iterate

Variables

Control Parameters (Independent Variables)

Note: If an element of a linked component is selected as an independent variable, the changed value that is produced will only be applied to subsequent segments nested within the same target sequence. Segments that are outside of the target sequence will use the value that the element held at the beginning of the MCS. If you apply corrections after running the MCS, then on the next run, all segments within the MCS will use the value produced by the target sequence.

Setting Control Parameters to Active/Inactive

Set Active to true to use a control parameter.

Astrogator */Satellite/Satellite1 SetMCSControlValue MainSequence.SegmentList.Target_Sequence.Profiles.Design_Explorer_Optimizer Propagate StoppingConditions.Duration.TripValue PluginConfig.Active true

Retrieving Current Value

CurrentValue only works with GetMCSControlValue because it is read only.

Astrogator_RM */Satellite/Satellite1 GetMCSControlValue MainSequence.SegmentList.Target_Sequence.Profiles.Design_Explorer_Optimizer Propagate StoppingConditions.Duration.TripValue CurrentValue

Retrieving Initial Value

InitialValue only works with GetMCSControlValue because it is read only.

Astrogator_RM */Satellite/Satellite1 GetMCSControlValue MainSequence.SegmentList.Target_Sequence.Profiles.Design_Explorer_Optimizer Propagate StoppingConditions.Duration.TripValue InitialValue

Retrieving Values for Every Iteration

Values only works with GetMCSControlValue because it is read only. It returns a list of the variable's values at every iteration.

Astrogator_RM */Satellite/Satellite1 GetMCSControlValue MainSequence.SegmentList.Target_Sequence.Profiles.Design_Explorer_Optimizer Propagate StoppingConditions.Duration.TripValue Values

Defining Lower Bound

Specify the minimum value the control should be allowed to have.

Defining Upper Bound

Specify the maximum value the control should be allowed to have.

Setting Custom Display Unit to Active/Inactive

Set UseCustomUnit to true to use a custom display unit.

Astrogator */Satellite/Satellite1 SetMCSControlValue MainSequence.SegmentList.Target_Sequence.Profiles.Design_Explorer_Optimizer Propagate StoppingConditions.Duration.TripValue UseCustomUnit true

Defining Custom Display Unit

Specify the custom display unit.

Astrogator */Satellite/Satellite1 SetMCSControlValue MainSequence.SegmentList.Target_Sequence.Profiles.Design_Explorer_Optimizer Propagate StoppingConditions.Duration.TripValue Unit day

Defining Perturbation

Enter the value to be used in calculating numerical derivatives.

Defining Scaling Method

Select among:

Auto
Custom
Initial Value
None

This attribute allows better numerical behavior if the parameters have very different magnitudes.

Defining Scale Factor

Enter a specified scale value if Scaling Method is set to Custom.

Objectives and Constraints (Dependent Variables)

Setting to Active/Inactive

Set Active to true to use an objective or constraint.

Astrogator */Satellite/Satellite1 SetMCSConstraintValue MainSequence.SegmentList.Target_Sequence.Profiles.Design_Explorer_Optimizer Propagate R_Mag PluginConfig.Active true

Retrieving Current Value

CurrentValue only works with GetMCSConstraintValue because it is read only.

Astrogator_RM */Satellite/Satellite1 GetMCSConstraintValue MainSequence.SegmentList.Target_Sequence.Profiles.Design_Explorer_Optimizer Propagate R_Mag CurrentValue

Retrieving Values for Every Iteration

Values only works with GetMCSConstraintValue because it is read only. It returns a list of the variable's values at every iteration.

Astrogator_RM */Satellite/Satellite1 GetMCSConstraintValue MainSequence.SegmentList.Target_Sequence.Profiles.Design_Explorer_Optimizer Propagate R_Mag Values

Defining Weight

This attribute is the factor by which the objective value is to be multiplied. This value is used to emphasize or de-emphasize the importance of one objective relative to the others.

Astrogator */Satellite/Satellite1 SetMCSConstraintValue MainSequence.SegmentList.Target_Sequence.Profiles.Design_Explorer_Optimizer Propagate R_Mag PluginConfig.WeightFactor 2

Defining Lower Bound

Specify the minimum value the constraint should be allowed to have. For equality constraints, set the lower and upper bound equal to one another.

Astrogator */Satellite/Satellite1 SetMCSConstraintValue MainSequence.SegmentList.Target_Sequence.Profiles.Design_Explorer_Optimizer Propagate R_Mag PluginConfig.LowerBound 10000 km

Defining Upper Bound

Specify the maximum value the constraint should be allowed to have. For equality constraints, set the lower and upper bound equal to one another.

Astrogator */Satellite/Satellite1 SetMCSConstraintValue MainSequence.SegmentList.Target_Sequence.Profiles.Design_Explorer_Optimizer Propagate R_Mag PluginConfig.UpperBound 10000 km

Specifying Goal

Select among:

Constraint
Maximize
Minimize
Minimize+Constraint
Maximize+Constraint

Astrogator */Satellite/Satellite1 SetMCSConstraintValue MainSequence.SegmentList.Target_Sequence.Profiles.Design_Explorer_Optimizer Propagate R_Mag PluginConfig.Goal Minimize

Setting Custom Display Unit to Active/Inactive

Set UseCustomUnit to true to use a custom display unit.

Astrogator */Satellite/Satellite1 SetMCSConstraintValue MainSequence.SegmentList.Target_Sequence.Profiles.Design_Explorer_Optimizer Propagate R_Mag UseCustomUnit true

Defining Custom Display Unit

Specify the custom display unit.

Astrogator */Satellite/Satellite1 SetMCSConstraintValue MainSequence.SegmentList.Target_Sequence.Profiles.Design_Explorer_Optimizer Propagate R_Mag Unit m

Defining Scale Method

Select among:

Auto
Custom
Initial Value
None

This attribute allows better numerical behavior if the parameters have very different magnitudes.

Astrogator */Satellite/Satellite1 SetMCSConstraintValue MainSequence.SegmentList.Target_Sequence.Profiles.Design_Explorer_Optimizer Propagate R_Mag PluginConfig.ScaleMethod Custom

Defining Scale Factor

Enter a specified scale value if Scaling Method is set to Custom.

Astrogator */Satellite/Satellite1 SetMCSConstraintValue MainSequence.SegmentList.Target_Sequence.Profiles.Design_Explorer_Optimizer Propagate R_Mag PluginConfig.ScaleFactor 10000 km

Options

Selecting Reset Before Each Run

Set this attribute to true to use this option; otherwise, set it to false.

Astrogator */Satellite/Satellite1 SetValue MainSequence.SegmentList.Target_Sequence.Profiles.Design_Explorer_Optimizer.ResetBeforeEachRun true

Selecting Display Status

Set this attribute to true to have a page appear during the targeting run to report the status of the optimization in terms of current values of objectives and constraints; otherwise, set it to false.

Astrogator */Satellite/Satellite1 SetValue MainSequence.SegmentList.Target_Sequence.Profiles.Design_Explorer_Optimizer.PluginConfig.DisplayStatus true

Setting Generate Results File Option

Set this attribute to true to create a file in the scenario directory with the optimizer's results at each iteration; otherwise, set it to false.

Astrogator */Satellite/Satellite1 SetValue MainSequence.SegmentList.Target_Sequence.Profiles.Design_Explorer_Optimizer.PluginConfig.GenerateResultsFile true

Setting Enforce Design Variable Bounds Option

Set this attribute to true to stop the optimizer if it tries to take an evaluation outside the control bounds; otherwise, set it to false.

Astrogator */Satellite/Satellite1 SetValue MainSequence.SegmentList.Target_Sequence.Profiles.Design_Explorer_Optimizer.PluginConfig.enforceDVBounds true

Use Default General Options

Set this attribute to true to use the default setting for maximum iterations; otherwise, set it to false.

Astrogator */Satellite/Satellite1 SetValue MainSequence.SegmentList.Target_Sequence.Profiles.Design_Explorer_Optimizer.PluginConfig.UseDefaultsSQPGen false

Specifying Max Evaluations

Enter the maximum number of evaluations you want the optimizer to perform.

Astrogator */Satellite/Satellite1 SetValue MainSequence.SegmentList.Target_Sequence.Profiles.Design_Explorer_Optimizer.PluginConfig.SQPMaxnfe 5100

Advanced

Use Default Advanced Options

Set this attribute to true to use the default settings for the advanced options; otherwise, set it to false.

Astrogator */Satellite/Satellite1 SetValue MainSequence.SegmentList.Target_Sequence.Profiles.Design_Explorer_Optimizer.PluginConfig.UseDefaultsSQPAdv false

Using Global Perturbation

Set this attribute to true to use a single perturbation size for all control variables; otherwise, set it to false.

Astrogator */Satellite/Satellite1 SetValue MainSequence.SegmentList.Target_Sequence.Profiles.Design_Explorer_Optimizer.PluginConfig.UseSQPPrtSiz true

Defining Perturbation

Specify the global perturbation size to use, if this option has been selected.

Astrogator */Satellite/Satellite1 SetValue MainSequence.SegmentList.Target_Sequence.Profiles.Design_Explorer_Optimizer.PluginConfig.SQPPrtsiz 1e-6

Defining Objective Function Tolerance

Enter the desired tolerance for satisfying an objective.

Astrogator */Satellite/Satellite1 SetValue MainSequence.SegmentList.Target_Sequence.Profiles.Design_Explorer_Optimizer.PluginConfig.SQPObjtol 1e-5

Defining Constraint Feasibility Tolerance

Enter the desired tolerance for abiding a constraint.

Astrogator */Satellite/Satellite1 SetValue MainSequence.SegmentList.Target_Sequence.Profiles.Design_Explorer_Optimizer.PluginConfig.SQPContol 1e-5

Defining Projected Gradient Tolerance

Enter the desired tolerance for convergence on a projected gradient.

Astrogator */Satellite/Satellite1 SetValue MainSequence.SegmentList.Target_Sequence.Profiles.Design_Explorer_Optimizer.PluginConfig.SQPPgdtol 1e-5

Logs

Summary Log

SummaryString is a read-only attribtue that will give you a dump of the summary log.

Astrogator_RM */Satellite/Satellite1 GetValue MainSequence.SegmentList.Target_Sequence.Profiles.Design_Explorer_Optimizer.PluginConfig.SummaryString

Detail Log

DetailString is a read-only attribute that will give you a dump of the detail log.

Astrogator_RM */Satellite/Satellite1 GetValue MainSequence.SegmentList.Target_Sequence.Profiles.Design_Explorer_Optimizer.PluginConfig.DetailString

Engine Log

EngineStringFilename is a read-only attribute giving the file name containing the engine log.

Astrogator_RM */Satellite/Satellite1 GetValue MainSequence.SegmentList.Target_Sequence.Profiles.Design_Explorer_Optimizer.PluginConfig.EngineStringFilename

Graphs

Defining the Graphs List

Add a Graph component for each graph needed. The graph names will automatically be changed to be unique.

Astrogator */Satellite/Satellite1 SetValue MainSequence.SegmentList.Target_Sequence.Profiles.Design_Explorer_Optimizer.Graphs Graph Graph Graph

To keep an existing graph while adding new ones to the list, include the name of the existing graph in the list.

Astrogator */Satellite/Satellite1 SetValue MainSequence.SegmentList.Target_Sequence.Profiles.Design_Explorer_Optimizer.Graphs "My Graph" Graph Graph

Graph Properties

To retrieve or set the value of the properties of a graph, you must append the graph name after "Graphs".

Graph Name

Astrogator */Satellite/Satellite1 SetValue MainSequence.SegmentList.Target_Sequence.Profiles.Design_Explorer_Optimizer.Graphs.Graph1.ComponentName "My Graph"

Graph Generation

The value is a boolean.

Astrogator */Satellite/Satellite1 SetValue MainSequence.SegmentList.Target_Sequence.Profiles.Design_Explorer_Optimizer.Graphs.Graph1.GraphWhileRunning true

User Comment

Astrogator */Satellite/Satellite1 SetValue MainSequence.SegmentList.Target_Sequence.Profiles.Design_Explorer_Optimizer.Graphs.Graph1.UserComment "This graph shows x"

Independent Variable

The value can be "Iteration" or the name of an active control or result.

Astrogator */Satellite/Satellite1 SetValue MainSequence.SegmentList.Target_Sequence.Profiles.Design_Explorer_Optimizer.Graphs.Graph1.IndependentVariable Maneuver_:_Semimajor_Axis

Label Iterations

The value is a boolean.

Astrogator */Satellite/Satellite1 SetValue MainSequence.SegmentList.Target_Sequence.Profiles.Design_Explorer_Optimizer.Graphs.Graph1.LabelIterations false

Active Controls

To retrieve or set the value of the graph properties of an active control, you must append "ActiveControlOptions" and the name of the control after the graph name.

Graph Value

The value is a boolean.

Astrogator */Satellite/Satellite1 SetValue MainSequence.SegmentList.Target_Sequence.Profiles.Design_Explorer_Optimizer.Graphs.Graph1.ActiveControlOptions.Maneuver_:_ImpulsiveMnvr_Cartesian_X.GraphValue true

Line Color

The color is defined in hexadecimal format, as 0x00BBGGRR, where BB is blue, GG is green, and RR is red. Connect does not acknowledge hexadecimal numbers, so once you have chosen the hexadecimal expression of the desired color, you will have to convert it to a decimal number.

Point Style

The value can be Circle, Cross, Diamond, Down Triangle, None, Plus, Solid Diamond, Solid Dot, Solid Down Triangle, Solid Square, Solid Triangle, Square, or Triangle.

Y Axis

The value can be Y1 or Y2.

Results

To retrieve or set the value of the graph properties of a result, you must append "ResultOptions" and the name of the result after the graph name.

Graph Option

The value can be "Don't graph" or "Graph value".

Astrogator */Satellite/Satellite1 SetValue MainSequence.SegmentList.Target_Sequence.Profiles.Design_Explorer_Optimizer.Graphs.Graph1.ResultOptions.Maneuver_:_Semimajor_Axis.GraphOption "Graph value"

Line Color

Astrogator */Satellite/Satellite1 SetValue MainSequence.SegmentList.Target_Sequence.Profiles.Design_Explorer_Optimizer.Graphs.Graph1.ResultOptions.Maneuver_:_Semimajor_Axis.GraphLineColor 1

Point Style

The value can be Circle, Cross, Diamond, Down Triangle, None, Plus, Solid Diamond, Solid Dot, Solid Down Triangle, Solid Square, Solid Triangle, Square, or Triangle.

Astrogator */Satellite/Satellite1 SetValue MainSequence.SegmentList.Target_Sequence.Profiles.Design_Explorer_Optimizer.Graphs.Graph1.ResultOptions.Maneuver_:_Semimajor_Axis.GraphPointStyle "Solid Down Triangle"

Y Axis

The value can be Y1 or Y2.

Astrogator */Satellite/Satellite1 SetValue MainSequence.SegmentList.Target_Sequence.Profiles.Design_Explorer_Optimizer.Graphs.Graph1.ResultOptions.Maneuver_:_Semimajor_Axis.GraphYAxis Y2

Scripting

Setting to Enabled/Disabled

Set Enabled to true to use the Scripting Tool.

Astrogator */Satellite/Satellite1 SetValue MainSequence.SegmentList.Target_Sequence.Profiles.Design_Explorer_Optimizer.ScriptingTool.Enabled true

Defining Object Property List

Add an Attribute component in the list for each object property needed.

Astrogator */Satellite/Satellite1 SetValue MainSequence.SegmentList.Target_Sequence.Profiles.Design_Explorer_Optimizer.ScriptingTool.Attributes Attribute Attribute

Specifying Object

Enter the object that the attribute component will be associated with.

Astrogator */Satellite/Satellite1 SetValue MainSequence.SegmentList.Target_Sequence.Profiles.Design_Explorer_Optimizer.ScriptingTool.Attributes.Attribute.Object Propagate

Specifying Attribute

Enter the specific attribute of the object that the attribute component uses.

Astrogator */Satellite/Satellite1 SetValue MainSequence.SegmentList.Target_Sequence.Profiles.Design_Explorer_Optimizer.ScriptingTool.Attributes.Attribute.Attribute StoppingConditions.Duration.TripValue

Specifying Unit

Enter the unit in which the object property will be used in the script.

Astrogator */Satellite/Satellite1 SetValue MainSequence.SegmentList.Target_Sequence.Profiles.Design_Explorer_Optimizer.ScriptingTool.Attributes.Attribute.Unit min

Selecting Editable or Read-Only Attributes

Set ReadOnlyProperty to true to select from read-only attributes or false to select from editable attributes.

Astrogator */Satellite/Satellite1 SetValue MainSequence.SegmentList.Target_Sequence.Profiles.Design_Explorer_Optimizer.ScriptingTool.Attributes.Attribute.ReadOnlyProperty true

Defining Calc Object List

Enter a Calc Object component for each calculation object needed.

Astrogator */Satellite/Satellite1 SetValue MainSequence.SegmentList.Target_Sequence.Profiles.Design_Explorer_Optimizer.ScriptingTool.CalcObjects CalcObject CalcObject

Specifying Calc Object

Enter the name of the calculation object the component should use.

Astrogator */Satellite/Satellite1 SetValue MainSequence.SegmentList.Target_Sequence.Profiles.Design_Explorer_Optimizer.ScriptingTool.CalcObjects.CalcObject.CalcObject Altitude

To set a property of the calc object, add that property to the attribute path (this example sets the altitude calc object to be lunar altitude).

Astrogator */Satellite/Satellite1 SetValue MainSequence.SegmentList.Target_Sequence.Profiles.Design_Explorer_Optimizer.ScriptingTool.CalcObjects.CalcObject.CalcObject.CentralBody Moon

Specifying Unit

Enter the unit in which the calculation object will be used in the script.

Astrogator */Satellite/Satellite1 SetValue MainSequence.SegmentList.Target_Sequence.Profiles.Design_Explorer_Optimizer.ScriptingTool.CalcObjects.CalcObject.Unit m

Specifying Parameter List

Enter a Parameter component for each parameter needed.

Astrogator */Satellite/Satellite1 SetValue MainSequence.SegmentList.Target_Sequence.Profiles.Design_Explorer_Optimizer.ScriptingTool.Parameters Parameter Parameter

Setting a Parameter to Inherit Its Value

Set InheritValue to true to have the parameter inherit its value from a previous search profile that has the same parameter or false to define the value (and unit dimension and unit) manually.

Astrogator */Satellite/Satellite1 SetValue MainSequence.SegmentList.Target_Sequence.Profiles.Design_Explorer_Optimizer.ScriptingTool.Parameters.Parameter.InheritValue true

Setting a User Comment

Enter a user comment.

Astrogator */Satellite/Satellite1 SetValue MainSequence.SegmentList.Target_Sequence.Profiles.Design_Explorer_Optimizer.ScriptingTool.Parameters.Parameter.UserComment This parameter is my favorite

Selecting a Minimum Value

Set UseMinValue to true to give the parameter a minimum value.

Astrogator */Satellite/Satellite1 SetValue MainSequence.SegmentList.Target_Sequence.Profiles.Design_Explorer_Optimizer.ScriptingTool.Parameters.Parameter.UseMinValue true

Setting a Minimum Value

If UseMinValue is true, define a minimum value for the parameter.

Astrogator */Satellite/Satellite1 SetValue MainSequence.SegmentList.Target_Sequence.Profiles.Design_Explorer_Optimizer.ScriptingTool.Parameters.Parameter.MinValue 0

Selecting a Maximum Value

Set UseMaxValue to true to give the parameter a maximum value.

Astrogator */Satellite/Satellite1 SetValue MainSequence.SegmentList.Target_Sequence.Profiles.Design_Explorer_Optimizer.ScriptingTool.Parameters.Parameter.UseMaxValue true

Setting a Maximum Value

If UseMaxValue is true, define a maximum value for the parameter.

Astrogator */Satellite/Satellite1 SetValue MainSequence.SegmentList.Target_Sequence.Profiles.Design_Explorer_Optimizer.ScriptingTool.Parameters.Parameter.MaxValue 10

Defining Parameter Value

Enter the value of the parameter.

Astrogator */Satellite/Satellite1 SetValue MainSequence.SegmentList.Target_Sequence.Profiles.Design_Explorer_Optimizer.ScriptingTool.Parameters.Parameter.ParamValue 20

Defining Parameter Type

Enter "Boolean", "Date", "Double", "Enumeration", "Integer", "Quantity", or "String".

Astrogator */Satellite/Satellite1 SetValue MainSequence.SegmentList.Target_Sequence.Profiles.Design_Explorer_Optimizer.ScriptingTool.Parameters.Parameter.ParamType Boolean

Defining Parameter Unit

Enter a unit.

Astrogator */Satellite/Satellite1 SetValue MainSequence.SegmentList.Target_Sequence.Profiles.Design_Explorer_Optimizer.ScriptingTool.Parameters.Parameter.Unit m/sec

Defining Parameter Unit Dimension

Enter a unit dimension.

Astrogator */Satellite/Satellite1 SetValue MainSequence.SegmentList.Target_Sequence.Profiles.Design_Explorer_Optimizer.ScriptingTool.Parameters.Parameter.UnitDimension Rate

Specifying Language

Enter the desired scripting language.

Astrogator */Satellite/Satellite1 SetValue MainSequence.SegmentList.Target_Sequence.Profiles.Design_Explorer_Optimizer.ScriptingTool.Language JScript

Astrogator */Satellite/Satellite1 SetValue MainSequence.SegmentList.Target_Sequence.Profiles.Design_Explorer_Optimizer.ScriptingTool.Language VBScript

Astrogator */Satellite/Satellite1 SetValue MainSequence.SegmentList.Target_Sequence.Profiles.Design_Explorer_Optimizer.ScriptingTool.Language MATLAB

Specifying Script

Enter the text of the script.

Astrogator */Satellite/Satellite1 SetValue MainSequence.SegmentList.Target_Sequence.Profiles.Design_Explorer_Optimizer.ScriptingTool.ScriptStatements "Attribute = 2 * Parameter"

STK Programming Interface 11.0.1