Achieve

General Mission Analysis Tool

Achieve

Achieve — Specify a goal for a Target sequence

Script Syntax

Achieve SolverName (Goal = Arg1, [{Tolerance = Arg2}])   

Description

The Achieve command is used in conjunction with the Target command as part of the Target sequence. The purpose of the Achieve command is to define a goal for the targeter (currently, the differential corrector is the only targeter available within a Target sequence) to achieve. To configure the Achieve command, you specify the goal object, its corresponding desired value, and an optional tolerance so the differential corrector can find a solution. The Achieve command must be accompanied and preceded by a Vary command in order to assist in the targeting process.

See Also: DifferentialCorrector, Target, Vary

Options

Option Description
Arg1

Specifies the desired value for the Goal after the DifferentialCorrector has converged.

Accepted Data Types

Array, ArrayElement, Variable, String

Allowed Values

Real Number, Array element, or Variable

Default Value

42165

Required

yes

Interfaces

GUI, script

Arg2

Convergence tolerance for how close Goal equals Arg1

Accepted Data Types

Real Number, Array element, Variable, or any user-defined parameter > 0

Allowed Values

Real Number, Array element, Variable, or any user-defined parameter > 0

Default Value

0.1

Required

no

Interfaces

GUI, script

Goal

Allows you to select any single element user defined parameter, except a number, as a targeter goal.

Accepted Data Types

Object parameter, ArrayElement, Variable

Allowed Values

Spacecraft parameter, Array element, Variable, or any other single element user defined parameter, excluding numbers

Default Value

DefaultSC.Earth.RMAG

Required

yes

Interfaces

GUI, script

SolverName

Specifies the DifferentialCorrector being used in the Target sequence

Accepted Data Types

String

Allowed Values

Any user defined DifferentialCorrector

Default Value

DefaultDC

Required

yes

Interfaces

GUI, script

GUI

You use an Achieve command, which is only valid within a Target sequence, to define your desired goal. More than one Achieve command may be used within a Target command sequence. The Achieve command dialog box, which allows you to specify the targeter, goal object, goal value, and convergence tolerance, is shown below.

Remarks

Command Interactions

A Target sequence must contain at least one Vary and one Achieve command.

Target command

An Achieve command only occurs within a Target sequence

Vary command

Associated with any Achieve command is at least one Vary command. The Vary command identifies the control variable used by the targeter. The goal specified by the Achieve command is obtained by varying the control variables.

Examples

As mentioned above, an Achieve command only occurs within a Target sequence. See the Target command help for examples showing the use of the Achieve command.