MCSOptions#

class ansys.stk.core.stkobjects.astrogator.MCSOptions#

The MCS Options.

Overview#

draw_trajectory_in_2d

If true, Astrogator will draw the trajectory in the 2D Graphics windows as the ephemeris is calculated during the current run.

draw_trajectory_in_3d

If true, Astrogator will draw the trajectory in the 3D Graphics windows as the ephemeris is calculated during the current run.

update_animation_time_for_all_objects

If true, all other objects will be animated so that they appear at the proper position for the time being computed as the trajectory is calculated.

clear_draw_while_calculating_graphics_before_each_run

If true, Astrogator will automatically clear all target iteration graphics of the previous run - in all graphics windows - before the current run draws new calculations.

clear_additional_b_plane_points

If true, Astrogator will clear all additional B-Plane points from any previous run - in all graphics windows - before the current run.

propagate_on_apply

If true, Astrogator will propagate trajectories whenever you click OK or Apply on the Orbit page. If you want to close the Properties Browser for the satellite without running the MCS, make certain this option is disabled.

enable_trajectory_segment_colors

If true, trajectory segments are displayed in the 2D Graphics window in the colors selected for the respective segments; otherwise the color of the trajectory is defined by the 2D Graphics Attributes page.

save_numbers_in_raw_format

If true, Astrogator will store satellite information in binary format - to preserve the maximum amount of precision.

stopping_condition_time_tolerance

Get or set the time tolerance, which will be applied with respect to desired trip values throughout the MCS. If this value is set to zero, time tolerance will not be applied.

enable_segment_controls

If true, Astrogator will automatically add independent variables to differential correctors.

enable_segment_results

If true, Astrogator will automatically add dependent variables to differential correctors.

enable_logging

If true, target sequences can be set to produce β€˜run history’ log files for differential corrector profiles. By default, a target sequence does not produce a log file.

graphics_update_rate

Get or set the rate (between 0 and 1) at which to update graphics. Dimensionless.

promote_controls

If true, a target sequence will be able to affect controls and results within a nested target sequence in addition to its own.

use_nominal_settings

If true, components or segments that are modified by a target sequence will be restored to their nominal values as soon as the target sequence completes its run.

min_ephem_step

Get or set the minimum step size for saving ephemeris. Uses Time Dimension.

generate_ephemeris

If true, Astrogator will generate ephemeris.

user_variables

Interface used to add/remove user variables.

smart_run_mode

Control whether the run will attempt to only run changed segments.

Import detail#

from ansys.stk.core.stkobjects.astrogator import MCSOptions

Property detail#

property MCSOptions.draw_trajectory_in_2d: bool#

If true, Astrogator will draw the trajectory in the 2D Graphics windows as the ephemeris is calculated during the current run.

property MCSOptions.draw_trajectory_in_3d: bool#

If true, Astrogator will draw the trajectory in the 3D Graphics windows as the ephemeris is calculated during the current run.

property MCSOptions.update_animation_time_for_all_objects: bool#

If true, all other objects will be animated so that they appear at the proper position for the time being computed as the trajectory is calculated.

property MCSOptions.clear_draw_while_calculating_graphics_before_each_run: bool#

If true, Astrogator will automatically clear all target iteration graphics of the previous run - in all graphics windows - before the current run draws new calculations.

property MCSOptions.clear_additional_b_plane_points: bool#

If true, Astrogator will clear all additional B-Plane points from any previous run - in all graphics windows - before the current run.

property MCSOptions.propagate_on_apply: bool#

If true, Astrogator will propagate trajectories whenever you click OK or Apply on the Orbit page. If you want to close the Properties Browser for the satellite without running the MCS, make certain this option is disabled.

property MCSOptions.enable_trajectory_segment_colors: bool#

If true, trajectory segments are displayed in the 2D Graphics window in the colors selected for the respective segments; otherwise the color of the trajectory is defined by the 2D Graphics Attributes page.

property MCSOptions.save_numbers_in_raw_format: bool#

If true, Astrogator will store satellite information in binary format - to preserve the maximum amount of precision.

property MCSOptions.stopping_condition_time_tolerance: float#

Get or set the time tolerance, which will be applied with respect to desired trip values throughout the MCS. If this value is set to zero, time tolerance will not be applied.

property MCSOptions.enable_segment_controls: bool#

If true, Astrogator will automatically add independent variables to differential correctors.

property MCSOptions.enable_segment_results: bool#

If true, Astrogator will automatically add dependent variables to differential correctors.

property MCSOptions.enable_logging: bool#

If true, target sequences can be set to produce β€˜run history’ log files for differential corrector profiles. By default, a target sequence does not produce a log file.

property MCSOptions.graphics_update_rate: float#

Get or set the rate (between 0 and 1) at which to update graphics. Dimensionless.

property MCSOptions.promote_controls: bool#

If true, a target sequence will be able to affect controls and results within a nested target sequence in addition to its own.

property MCSOptions.use_nominal_settings: bool#

If true, components or segments that are modified by a target sequence will be restored to their nominal values as soon as the target sequence completes its run.

property MCSOptions.min_ephem_step: float#

Get or set the minimum step size for saving ephemeris. Uses Time Dimension.

property MCSOptions.generate_ephemeris: bool#

If true, Astrogator will generate ephemeris.

property MCSOptions.user_variables: UserVariableDefinitionCollection#

Interface used to add/remove user variables.

property MCSOptions.smart_run_mode: SmartRunMode#

Control whether the run will attempt to only run changed segments.