Complete phase_info
user options reference for all Aviary EquationsOfMotion#
HEIGHT_ENERGY#
The height energy phase_info has been converted to the new system.
om.show_options_table('aviary.mission.flight_phase_builder.FlightPhaseOptions')
Option | Default | Acceptable Values | Acceptable Types | Description |
---|---|---|---|---|
altitude_bounds | ((None, None), 'ft') | N/A | ['tuple'] | Tuple of form ((lower, upper), units) containing the upper and lower bounds for all values of altitude in the phase. The default of None for upper or lower means that bound will not be declared. |
altitude_final | (None, 'ft') | N/A | ['tuple'] | Tuple of (value, units) containing value of altitude at the end of the phase. If this phase is connected to a downstream phase, final values should be specified with altitude_initial in that phase instead of here. When specified, a constraint is created on the final altitude. |
altitude_initial | (None, 'ft') | N/A | ['tuple'] | Tuple of (value, units) containing value of altitude at the start of the phase. When unspecified, the value comes from upstream. When specified, a constraint is created on the initial altitude. |
altitude_optimize | True | [True, False] | ['bool'] | When True, the optimizer will set this value. When False, the initial value for all nodes can be set in the initial_conditions section of the phase. |
altitude_polynomial_order | N/A | N/A | ['int'] | The order of polynomials for interpolation in the transcription. Default is None, which does not use a polynomial. |
altitude_rate_constraint | N/A | [None, 'positive', 'negative'] | N/A | Can be (None, positive, negative.) When not None, adds a constraint that keeps the rate positive or negative as requested. For altitude in a flight phase, negative means no climb, and positive means no descent. |
altitude_ref | (1.0, 'ft') | N/A | ['tuple'] | Multiplicative scale factor "ref" for altitude. Default is 1.0 |
altitude_ref0 | (None, 'ft') | N/A | ['tuple'] | Additive scale factor "ref0" for altitude. |
constraints | {} | N/A | ['dict'] | Add in custom constraints i.e. 'flight_path_angle': {'equals': -3., 'loc': 'initial', 'units': 'deg', 'type': 'boundary',}. For more details see _add_user_defined_constraints(). |
distance_bounds | ((0.0, None), 'm') | N/A | ['tuple'] | Tuple of form ((lower, upper), units) containing the upper and lower bounds for all values of distance in the phase. The default of None for upper or lower means that bound will not be declared. |
distance_constraint_ref | (None, 'm') | N/A | ['tuple'] | Multiplicative scale factor "ref" for the distance boundary constraint. If unspecified, then the value in distance_final is used. At present, only a final constraint is added. |
distance_defect_ref | (100000000.0, 'm') | N/A | ['tuple'] | Multiplicative scale factor "ref" for the distance defect constraint. Default is None, which means the ref and defect_ref are the same. |
distance_final | (None, 'm') | N/A | ['tuple'] | Tuple of (value, units) containing value of distance at the end of the phase. If this phase is connected to a downstream phase, final values should be specified with distance_initial in that phase instead of here. When specified, a constraint is created on the final distance. |
distance_initial | (None, 'm') | N/A | ['tuple'] | Tuple of (value, units) containing value of distance at the start of the phase. When unspecified, the optimizer controls the value. When specified, a constraint is created on the initial distance. |
distance_ref | (1000000.0, 'm') | N/A | ['tuple'] | Multiplicative scale factor "ref" for distance. Default is 1.0 |
distance_ref0 | (None, 'm') | N/A | ['tuple'] | Additive scale factor "ref0" for distance. |
distance_solve_segments | False | [True, False] | ['bool'] | When True, a solver will be used to converge the collocation defects within a segment. Note that the state continuity defects between segements will still be handled by the optimizer. |
ground_roll | False | [True, False] | ['bool'] | Set to True only for phases where the aircraft is rolling on the ground. All other phases of flight (climb, cruise, descent) this must be set to False. |
mach_bounds | ((None, None), 'unitless') | N/A | ['tuple'] | Tuple of form ((lower, upper), units) containing the upper and lower bounds for all values of mach in the phase. The default of None for upper or lower means that bound will not be declared. |
mach_final | (None, 'unitless') | N/A | ['tuple'] | Tuple of (value, units) containing value of mach at the end of the phase. If this phase is connected to a downstream phase, final values should be specified with mach_initial in that phase instead of here. When specified, a constraint is created on the final mach. |
mach_initial | (None, 'unitless') | N/A | ['tuple'] | Tuple of (value, units) containing value of mach at the start of the phase. When unspecified, the value comes from upstream. When specified, a constraint is created on the initial mach. |
mach_optimize | True | [True, False] | ['bool'] | When True, the optimizer will set this value. When False, the initial value for all nodes can be set in the initial_conditions section of the phase. |
mach_polynomial_order | N/A | N/A | ['int'] | The order of polynomials for interpolation in the transcription. Default is None, which does not use a polynomial. |
mach_rate_constraint | N/A | [None, 'positive', 'negative'] | N/A | Can be (None, positive, negative.) When not None, adds a constraint that keeps the rate positive or negative as requested. For altitude in a flight phase, negative means no climb, and positive means no descent. |
mach_ref | (0.5, 'unitless') | N/A | ['tuple'] | Multiplicative scale factor "ref" for mach. Default is 1.0 |
mach_ref0 | (None, 'unitless') | N/A | ['tuple'] | Additive scale factor "ref0" for mach. |
mass_bounds | ((0.0, None), 'kg') | N/A | ['tuple'] | Tuple of form ((lower, upper), units) containing the upper and lower bounds for all values of mass in the phase. The default of None for upper or lower means that bound will not be declared. |
mass_constraint_ref | (None, 'kg') | N/A | ['tuple'] | Multiplicative scale factor "ref" for the mass boundary constraint. If unspecified, then the value in mass_final is used. At present, only a final constraint is added. |
mass_defect_ref | (1000000.0, 'kg') | N/A | ['tuple'] | Multiplicative scale factor "ref" for the mass defect constraint. Default is None, which means the ref and defect_ref are the same. |
mass_final | (None, 'kg') | N/A | ['tuple'] | Tuple of (value, units) containing value of mass at the end of the phase. If this phase is connected to a downstream phase, final values should be specified with mass_initial in that phase instead of here. When specified, a constraint is created on the final mass. |
mass_initial | (None, 'kg') | N/A | ['tuple'] | Tuple of (value, units) containing value of mass at the start of the phase. When unspecified, the optimizer controls the value. When specified, a constraint is created on the initial mass. |
mass_ref | (10000.0, 'kg') | N/A | ['tuple'] | Multiplicative scale factor "ref" for mass. Default is 1.0 |
mass_ref0 | (None, 'kg') | N/A | ['tuple'] | Additive scale factor "ref0" for mass. |
mass_solve_segments | False | [True, False] | ['bool'] | When True, a solver will be used to converge the collocation defects within a segment. Note that the state continuity defects between segements will still be handled by the optimizer. |
no_climb | False | [True, False] | ['bool'] | Set to True to prevent the aircraft from climbing during the phase. This option can be used to prevent unexpected climb during a descent phase. |
no_descent | False | [True, False] | ['bool'] | Set to True to prevent the aircraft from descending during the phase. This can be used to prevent unexpected descent during a climb phase. |
num_segments | 1 | N/A | ['int'] | The number of segments in transcription creation in Dymos. The default value is 1. |
order | 3 | N/A | ['int'] | The order of polynomials for interpolation in the transcription created in Dymos. The default value is 3. |
required_available_climb_rate | (None, 'ft/s') | N/A | ['tuple'] | Adds a constraint requiring Dynamic.Mission.ALTITUDE_RATE_MAX to be no smaller than required_available_climb_rate. This helps to ensure that the propulsion system is large enough to handle emergency maneuvers at all points throughout the flight envelope. Default value is None for no constraint. |
reserve | False | [True, False] | ['bool'] | Designate this phase as a reserve phase and contributes its fuel burn towards the reserve mission fuel requirements. Reserve phases should be be placed after all non-reserve phases in the phase_info. |
target_distance | (None, 'm') | N/A | ['tuple'] | The total distance traveled by the aircraft from takeoff to landing for the primary mission, not including reserve missions. This value must be positive. |
throttle_allocation | ThrottleAllocation.FIXED | [<ThrottleAllocation.FIXED: 'fixed'>, <ThrottleAllocation.STATIC: 'static'>, <ThrottleAllocation.DYNAMIC: 'dynamic'>] | N/A | Specifies how to handle the throttles for multiple engines. FIXED is a user-specified value. STATIC is specified by the optimizer as one value for the whole phase. DYNAMIC is specified by the optimizer at each point in the phase. |
throttle_enforcement | path_constraint | ['path_constraint', 'boundary_constraint', 'bounded', None] | N/A | Flag to enforce engine throttle constraints on the path or at the segment boundaries or using solver bounds. |
time_duration | (None, 's') | N/A | ['tuple'] | Tuple of (value, units) containing value of time_duration at the start of the phase. When unspecified, the value comes from upstream. When specified, a constraint is created on the initial time_duration. |
time_duration_bounds | ((None, None), 's') | N/A | ['tuple'] | Tuple of form ((lower, upper), units) containing the upper and lower bounds for all values of time_duration in the phase. The default of None for upper or lower means that bound will not be declared. |
time_duration_ref | (1.0, 's') | N/A | ['tuple'] | Multiplicative scale factor "ref" for time_duration. Default is 1.0 |
time_initial | (None, 's') | N/A | ['tuple'] | Tuple of (value, units) containing value of time_initial at the start of the phase. When unspecified, the value comes from upstream. When specified, a constraint is created on the initial time_initial. |
time_initial_bounds | ((None, None), 's') | N/A | ['tuple'] | Tuple of form ((lower, upper), units) containing the upper and lower bounds for all values of time_initial in the phase. The default of None for upper or lower means that bound will not be declared. |
time_initial_ref | (1.0, 's') | N/A | ['tuple'] | Multiplicative scale factor "ref" for time_initial. Default is 1.0 |
SOLVED_2DOF#
The solved 2dof phase_info has not been converted completely to the new system.
om.show_options_table('aviary.mission.gasp_based.phases.twodof_phase.TwoDOFPhaseOptions')
Option | Default | Acceptable Values | Acceptable Types | Description |
---|---|---|---|---|
altitude_bounds | ((None, None), 'ft') | N/A | ['tuple'] | Tuple of form ((lower, upper), units) containing the upper and lower bounds for all values of altitude in the phase. The default of None for upper or lower means that bound will not be declared. |
altitude_final | (None, 'ft') | N/A | ['tuple'] | Tuple of (value, units) containing value of altitude at the end of the phase. If this phase is connected to a downstream phase, final values should be specified with altitude_initial in that phase instead of here. When specified, a constraint is created on the final altitude. |
altitude_initial | (None, 'ft') | N/A | ['tuple'] | Tuple of (value, units) containing value of altitude at the start of the phase. When unspecified, the value comes from upstream. When specified, a constraint is created on the initial altitude. |
altitude_optimize | True | [True, False] | ['bool'] | When True, the optimizer will set this value. When False, the initial value for all nodes can be set in the initial_conditions section of the phase. |
altitude_polynomial_order | N/A | N/A | ['int'] | The order of polynomials for interpolation in the transcription. Default is None, which does not use a polynomial. |
altitude_rate_constraint | N/A | [None, 'positive', 'negative'] | N/A | Can be (None, positive, negative.) When not None, adds a constraint that keeps the rate positive or negative as requested. For altitude in a flight phase, negative means no climb, and positive means no descent. |
altitude_ref | (1.0, 'ft') | N/A | ['tuple'] | Multiplicative scale factor "ref" for altitude. Default is 1.0 |
altitude_ref0 | (None, 'ft') | N/A | ['tuple'] | Additive scale factor "ref0" for altitude. |
angle_of_attack_bounds | ((0.0, 15.0), 'deg') | N/A | ['tuple'] | Tuple of form ((lower, upper), units) containing the upper and lower bounds for all values of angle_of_attack in the phase. The default of None for upper or lower means that bound will not be declared. |
angle_of_attack_final | (None, 'deg') | N/A | ['tuple'] | Tuple of (value, units) containing value of angle_of_attack at the end of the phase. If this phase is connected to a downstream phase, final values should be specified with angle_of_attack_initial in that phase instead of here. When specified, a constraint is created on the final angle_of_attack. |
angle_of_attack_initial | (0.0, 'deg') | N/A | ['tuple'] | Tuple of (value, units) containing value of angle_of_attack at the start of the phase. When unspecified, the value comes from upstream. When specified, a constraint is created on the initial angle_of_attack. |
angle_of_attack_optimize | True | [True, False] | ['bool'] | When True, the optimizer will set this value. When False, the initial value for all nodes can be set in the initial_conditions section of the phase. |
angle_of_attack_polynomial_order | 1 | N/A | ['int'] | The order of polynomials for interpolation in the transcription. Default is None, which does not use a polynomial. |
angle_of_attack_rate_constraint | N/A | [None, 'positive', 'negative'] | N/A | Can be (None, positive, negative.) When not None, adds a constraint that keeps the rate positive or negative as requested. For altitude in a flight phase, negative means no climb, and positive means no descent. |
angle_of_attack_ref | (10.0, 'deg') | N/A | ['tuple'] | Multiplicative scale factor "ref" for angle_of_attack. Default is 1.0 |
angle_of_attack_ref0 | (None, 'deg') | N/A | ['tuple'] | Additive scale factor "ref0" for angle_of_attack. |
clean | False | [True, False] | ['bool'] | Set to true to use clean aero with no ground effects. |
constraints | {} | N/A | ['dict'] | Add in custom constraints i.e. 'flight_path_angle': {'equals': -3., 'loc': 'initial', 'units': 'deg', 'type': 'boundary',}. For more details see _add_user_defined_constraints(). |
distance_bounds | ((0.0, None), 'm') | N/A | ['tuple'] | Tuple of form ((lower, upper), units) containing the upper and lower bounds for all values of distance in the phase. The default of None for upper or lower means that bound will not be declared. |
distance_constraint_ref | (None, 'm') | N/A | ['tuple'] | Multiplicative scale factor "ref" for the distance boundary constraint. If unspecified, then the value in distance_final is used. At present, only a final constraint is added. |
distance_defect_ref | (100000000.0, 'm') | N/A | ['tuple'] | Multiplicative scale factor "ref" for the distance defect constraint. Default is None, which means the ref and defect_ref are the same. |
distance_final | (None, 'm') | N/A | ['tuple'] | Tuple of (value, units) containing value of distance at the end of the phase. If this phase is connected to a downstream phase, final values should be specified with distance_initial in that phase instead of here. When specified, a constraint is created on the final distance. |
distance_initial | (None, 'm') | N/A | ['tuple'] | Tuple of (value, units) containing value of distance at the start of the phase. When unspecified, the optimizer controls the value. When specified, a constraint is created on the initial distance. |
distance_ref | (1000000.0, 'm') | N/A | ['tuple'] | Multiplicative scale factor "ref" for distance. Default is 1.0 |
distance_ref0 | (None, 'm') | N/A | ['tuple'] | Additive scale factor "ref0" for distance. |
distance_solve_segments | False | [True, False] | ['bool'] | When True, a solver will be used to converge the collocation defects within a segment. Note that the state continuity defects between segements will still be handled by the optimizer. |
ground_roll | False | [True, False] | ['bool'] | Set to True only for phases where the aircraft is rolling on the ground. All other phases of flight (climb, cruise, descent) this must be set to False. |
mach_bounds | ((None, None), 'unitless') | N/A | ['tuple'] | Tuple of form ((lower, upper), units) containing the upper and lower bounds for all values of mach in the phase. The default of None for upper or lower means that bound will not be declared. |
mach_final | (None, 'unitless') | N/A | ['tuple'] | Tuple of (value, units) containing value of mach at the end of the phase. If this phase is connected to a downstream phase, final values should be specified with mach_initial in that phase instead of here. When specified, a constraint is created on the final mach. |
mach_initial | (None, 'unitless') | N/A | ['tuple'] | Tuple of (value, units) containing value of mach at the start of the phase. When unspecified, the value comes from upstream. When specified, a constraint is created on the initial mach. |
mach_optimize | True | [True, False] | ['bool'] | When True, the optimizer will set this value. When False, the initial value for all nodes can be set in the initial_conditions section of the phase. |
mach_polynomial_order | N/A | N/A | ['int'] | The order of polynomials for interpolation in the transcription. Default is None, which does not use a polynomial. |
mach_rate_constraint | N/A | [None, 'positive', 'negative'] | N/A | Can be (None, positive, negative.) When not None, adds a constraint that keeps the rate positive or negative as requested. For altitude in a flight phase, negative means no climb, and positive means no descent. |
mach_ref | (0.5, 'unitless') | N/A | ['tuple'] | Multiplicative scale factor "ref" for mach. Default is 1.0 |
mach_ref0 | (None, 'unitless') | N/A | ['tuple'] | Additive scale factor "ref0" for mach. |
mass_bounds | ((0.0, None), 'kg') | N/A | ['tuple'] | Tuple of form ((lower, upper), units) containing the upper and lower bounds for all values of mass in the phase. The default of None for upper or lower means that bound will not be declared. |
mass_constraint_ref | (None, 'kg') | N/A | ['tuple'] | Multiplicative scale factor "ref" for the mass boundary constraint. If unspecified, then the value in mass_final is used. At present, only a final constraint is added. |
mass_defect_ref | (1000000.0, 'kg') | N/A | ['tuple'] | Multiplicative scale factor "ref" for the mass defect constraint. Default is None, which means the ref and defect_ref are the same. |
mass_final | (None, 'kg') | N/A | ['tuple'] | Tuple of (value, units) containing value of mass at the end of the phase. If this phase is connected to a downstream phase, final values should be specified with mass_initial in that phase instead of here. When specified, a constraint is created on the final mass. |
mass_initial | (None, 'kg') | N/A | ['tuple'] | Tuple of (value, units) containing value of mass at the start of the phase. When unspecified, the optimizer controls the value. When specified, a constraint is created on the initial mass. |
mass_ref | (10000.0, 'kg') | N/A | ['tuple'] | Multiplicative scale factor "ref" for mass. Default is 1.0 |
mass_ref0 | (None, 'kg') | N/A | ['tuple'] | Additive scale factor "ref0" for mass. |
mass_solve_segments | False | [True, False] | ['bool'] | When True, a solver will be used to converge the collocation defects within a segment. Note that the state continuity defects between segements will still be handled by the optimizer. |
no_climb | False | [True, False] | ['bool'] | Set to True to prevent the aircraft from climbing during the phase. This option can be used to prevent unexpected climb during a descent phase. |
no_descent | False | [True, False] | ['bool'] | Set to True to prevent the aircraft from descending during the phase. This can be used to prevent unexpected descent during a climb phase. |
num_segments | 1 | N/A | ['int'] | The number of segments in transcription creation in Dymos. The default value is 1. |
order | 3 | N/A | ['int'] | The order of polynomials for interpolation in the transcription created in Dymos. The default value is 3. |
required_available_climb_rate | (None, 'ft/s') | N/A | ['tuple'] | Adds a constraint requiring Dynamic.Mission.ALTITUDE_RATE_MAX to be no smaller than required_available_climb_rate. This helps to ensure that the propulsion system is large enough to handle emergency maneuvers at all points throughout the flight envelope. Default value is None for no constraint. |
reserve | False | [True, False] | ['bool'] | Designate this phase as a reserve phase and contributes its fuel burn towards the reserve mission fuel requirements. Reserve phases should be be placed after all non-reserve phases in the phase_info. |
rotation | False | [True, False] | ['bool'] | Set to true if this is a rotation phase. |
target_distance | (None, 'm') | N/A | ['tuple'] | The total distance traveled by the aircraft from takeoff to landing for the primary mission, not including reserve missions. This value must be positive. |
throttle_allocation | ThrottleAllocation.FIXED | [<ThrottleAllocation.FIXED: 'fixed'>, <ThrottleAllocation.STATIC: 'static'>, <ThrottleAllocation.DYNAMIC: 'dynamic'>] | N/A | Specifies how to handle the throttles for multiple engines. FIXED is a user-specified value. STATIC is specified by the optimizer as one value for the whole phase. DYNAMIC is specified by the optimizer at each point in the phase. |
throttle_enforcement | path_constraint | ['path_constraint', 'boundary_constraint', 'bounded', None] | N/A | Flag to enforce engine throttle constraints on the path or at the segment boundaries or using solver bounds. |
time_duration | (None, 'ft') | N/A | ['tuple'] | Tuple of (value, units) containing value of time_duration at the start of the phase. When unspecified, the value comes from upstream. When specified, a constraint is created on the initial time_duration. |
time_duration_bounds | ((None, None), 'ft') | N/A | ['tuple'] | Tuple of form ((lower, upper), units) containing the upper and lower bounds for all values of time_duration in the phase. The default of None for upper or lower means that bound will not be declared. |
time_duration_ref | (1.0, 'ft') | N/A | ['tuple'] | Multiplicative scale factor "ref" for time_duration. Default is 1.0 |
time_initial | (None, 'ft') | N/A | ['tuple'] | Tuple of (value, units) containing value of time_initial at the start of the phase. When unspecified, the value comes from upstream. When specified, a constraint is created on the initial time_initial. |
time_initial_bounds | ((None, None), 'ft') | N/A | ['tuple'] | Tuple of form ((lower, upper), units) containing the upper and lower bounds for all values of time_initial in the phase. The default of None for upper or lower means that bound will not be declared. |
time_initial_ref | (1.0, 'ft') | N/A | ['tuple'] | Multiplicative scale factor "ref" for time_initial. Default is 1.0 |
TWO_DEGREES_OF_FREEDOM#
The two degree of freedom phase_info has not been converted completely to the new system.
AccelPhase#
om.show_options_table('aviary.mission.gasp_based.phases.accel_phase.AccelPhaseOptions')
Option | Default | Acceptable Values | Acceptable Types | Description |
---|---|---|---|---|
EAS_constraint_eq | (250.0, 'kn') | N/A | ['tuple'] | Airspeed constraint applied at the end of the phase. |
alt | (500.0, 'ft') | N/A | ['tuple'] | Constant altitude for this phase. |
analytic | False | [True, False] | ['bool'] | When set to True, this is an analytic phase. |
distance_bounds | ((0.0, None), 'NM') | N/A | ['tuple'] | Tuple of form ((lower, upper), units) containing the upper and lower bounds for all values of distance in the phase. The default of None for upper or lower means that bound will not be declared. |
distance_constraint_ref | (None, 'NM') | N/A | ['tuple'] | Multiplicative scale factor "ref" for the distance boundary constraint. If unspecified, then the value in distance_final is used. At present, only a final constraint is added. |
distance_defect_ref | (None, 'NM') | N/A | ['tuple'] | Multiplicative scale factor "ref" for the distance defect constraint. Default is None, which means the ref and defect_ref are the same. |
distance_final | (None, 'NM') | N/A | ['tuple'] | Tuple of (value, units) containing value of distance at the end of the phase. If this phase is connected to a downstream phase, final values should be specified with distance_initial in that phase instead of here. When specified, a constraint is created on the final distance. |
distance_initial | (None, 'NM') | N/A | ['tuple'] | Tuple of (value, units) containing value of distance at the start of the phase. When unspecified, the optimizer controls the value. When specified, a constraint is created on the initial distance. |
distance_ref | (1.0, 'NM') | N/A | ['tuple'] | Multiplicative scale factor "ref" for distance. Default is 1.0 |
distance_ref0 | (None, 'NM') | N/A | ['tuple'] | Additive scale factor "ref0" for distance. |
distance_solve_segments | False | [True, False] | ['bool'] | When True, a solver will be used to converge the collocation defects within a segment. Note that the state continuity defects between segements will still be handled by the optimizer. |
mass_bounds | ((0.0, None), 'lbm') | N/A | ['tuple'] | Tuple of form ((lower, upper), units) containing the upper and lower bounds for all values of mass in the phase. The default of None for upper or lower means that bound will not be declared. |
mass_constraint_ref | (None, 'lbm') | N/A | ['tuple'] | Multiplicative scale factor "ref" for the mass boundary constraint. If unspecified, then the value in mass_final is used. At present, only a final constraint is added. |
mass_defect_ref | (None, 'lbm') | N/A | ['tuple'] | Multiplicative scale factor "ref" for the mass defect constraint. Default is None, which means the ref and defect_ref are the same. |
mass_final | (None, 'lbm') | N/A | ['tuple'] | Tuple of (value, units) containing value of mass at the end of the phase. If this phase is connected to a downstream phase, final values should be specified with mass_initial in that phase instead of here. When specified, a constraint is created on the final mass. |
mass_initial | (None, 'lbm') | N/A | ['tuple'] | Tuple of (value, units) containing value of mass at the start of the phase. When unspecified, the optimizer controls the value. When specified, a constraint is created on the initial mass. |
mass_ref | (1.0, 'lbm') | N/A | ['tuple'] | Multiplicative scale factor "ref" for mass. Default is 1.0 |
mass_ref0 | (None, 'lbm') | N/A | ['tuple'] | Additive scale factor "ref0" for mass. |
mass_solve_segments | False | [True, False] | ['bool'] | When True, a solver will be used to converge the collocation defects within a segment. Note that the state continuity defects between segements will still be handled by the optimizer. |
num_segments | 1 | N/A | ['int'] | The number of segments in transcription creation in Dymos. The default value is 1. |
order | 3 | N/A | ['int'] | The order of polynomials for interpolation in the transcription created in Dymos. The default value is 3. |
reserve | False | [True, False] | ['bool'] | Designate this phase as a reserve phase and contributes its fuel burn towards the reserve mission fuel requirements. Reserve phases should be be placed after all non-reserve phases in the phase_info. |
target_distance | (None, 'm') | N/A | ['tuple'] | The total distance traveled by the aircraft from takeoff to landing for the primary mission, not including reserve missions. This value must be positive. |
time_duration | (None, 's') | N/A | ['tuple'] | Tuple of (value, units) containing value of time_duration at the start of the phase. When unspecified, the value comes from upstream. When specified, a constraint is created on the initial time_duration. |
time_duration_bounds | ((None, None), 's') | N/A | ['tuple'] | Tuple of form ((lower, upper), units) containing the upper and lower bounds for all values of time_duration in the phase. The default of None for upper or lower means that bound will not be declared. |
time_duration_ref | (1.0, 's') | N/A | ['tuple'] | Multiplicative scale factor "ref" for time_duration. Default is 1.0 |
time_initial | (None, 's') | N/A | ['tuple'] | Tuple of (value, units) containing value of time_initial at the start of the phase. When unspecified, the value comes from upstream. When specified, a constraint is created on the initial time_initial. |
time_initial_bounds | ((None, None), 's') | N/A | ['tuple'] | Tuple of form ((lower, upper), units) containing the upper and lower bounds for all values of time_initial in the phase. The default of None for upper or lower means that bound will not be declared. |
time_initial_ref | (1.0, 's') | N/A | ['tuple'] | Multiplicative scale factor "ref" for time_initial. Default is 1.0 |
velocity_bounds | ((0.0, None), 'kn') | N/A | ['tuple'] | Tuple of form ((lower, upper), units) containing the upper and lower bounds for all values of velocity in the phase. The default of None for upper or lower means that bound will not be declared. |
velocity_constraint_ref | (None, 'kn') | N/A | ['tuple'] | Multiplicative scale factor "ref" for the velocity boundary constraint. If unspecified, then the value in velocity_final is used. At present, only a final constraint is added. |
velocity_defect_ref | (None, 'kn') | N/A | ['tuple'] | Multiplicative scale factor "ref" for the velocity defect constraint. Default is None, which means the ref and defect_ref are the same. |
velocity_final | (None, 'kn') | N/A | ['tuple'] | Tuple of (value, units) containing value of velocity at the end of the phase. If this phase is connected to a downstream phase, final values should be specified with velocity_initial in that phase instead of here. When specified, a constraint is created on the final velocity. |
velocity_initial | (None, 'kn') | N/A | ['tuple'] | Tuple of (value, units) containing value of velocity at the start of the phase. When unspecified, the optimizer controls the value. When specified, a constraint is created on the initial velocity. |
velocity_ref | (1.0, 'kn') | N/A | ['tuple'] | Multiplicative scale factor "ref" for velocity. Default is 1.0 |
velocity_ref0 | (None, 'kn') | N/A | ['tuple'] | Additive scale factor "ref0" for velocity. |
velocity_solve_segments | False | [True, False] | ['bool'] | When True, a solver will be used to converge the collocation defects within a segment. Note that the state continuity defects between segements will still be handled by the optimizer. |
AscentPhase#
om.show_options_table('aviary.mission.gasp_based.phases.ascent_phase.AscentPhaseOptions')
Option | Default | Acceptable Values | Acceptable Types | Description |
---|---|---|---|---|
altitude_bounds | ((0.0, 700.0), 'ft') | N/A | ['tuple'] | Tuple of form ((lower, upper), units) containing the upper and lower bounds for all values of altitude in the phase. The default of None for upper or lower means that bound will not be declared. |
altitude_constraint_ref | (100.0, 'ft') | N/A | ['tuple'] | Multiplicative scale factor "ref" for the altitude boundary constraint. If unspecified, then the value in altitude_final is used. At present, only a final constraint is added. |
altitude_defect_ref | (None, 'ft') | N/A | ['tuple'] | Multiplicative scale factor "ref" for the altitude defect constraint. Default is None, which means the ref and defect_ref are the same. |
altitude_final | (None, 'ft') | N/A | ['tuple'] | Tuple of (value, units) containing value of altitude at the end of the phase. If this phase is connected to a downstream phase, final values should be specified with altitude_initial in that phase instead of here. When specified, a constraint is created on the final altitude. |
altitude_initial | (None, 'ft') | N/A | ['tuple'] | Tuple of (value, units) containing value of altitude at the start of the phase. When unspecified, the optimizer controls the value. When specified, a constraint is created on the initial altitude. |
altitude_ref | (100.0, 'ft') | N/A | ['tuple'] | Multiplicative scale factor "ref" for altitude. Default is 1.0 |
altitude_ref0 | (None, 'ft') | N/A | ['tuple'] | Additive scale factor "ref0" for altitude. |
altitude_solve_segments | False | [True, False] | ['bool'] | When True, a solver will be used to converge the collocation defects within a segment. Note that the state continuity defects between segements will still be handled by the optimizer. |
analytic | False | [True, False] | ['bool'] | When set to True, this is an analytic phase. |
angle_of_attack_bounds | ((-0.5235987755982988, 0.5235987755982988), 'rad') | N/A | ['tuple'] | Tuple of form ((lower, upper), units) containing the upper and lower bounds for all values of angle_of_attack in the phase. The default of None for upper or lower means that bound will not be declared. |
angle_of_attack_final | (None, 'rad') | N/A | ['tuple'] | Tuple of (value, units) containing value of angle_of_attack at the end of the phase. If this phase is connected to a downstream phase, final values should be specified with angle_of_attack_initial in that phase instead of here. When specified, a constraint is created on the final angle_of_attack. |
angle_of_attack_initial | (None, 'rad') | N/A | ['tuple'] | Tuple of (value, units) containing value of angle_of_attack at the start of the phase. When unspecified, the value comes from upstream. When specified, a constraint is created on the initial angle_of_attack. |
angle_of_attack_optimize | True | [True, False] | ['bool'] | When True, the optimizer will set this value. When False, the initial value for all nodes can be set in the initial_conditions section of the phase. |
angle_of_attack_polynomial_order | N/A | N/A | ['int'] | The order of polynomials for interpolation in the transcription. Default is None, which does not use a polynomial. |
angle_of_attack_rate_constraint | N/A | [None, 'positive', 'negative'] | N/A | Can be (None, positive, negative.) When not None, adds a constraint that keeps the rate positive or negative as requested. For altitude in a flight phase, negative means no climb, and positive means no descent. |
angle_of_attack_ref | (0.08726646259971647, 'rad') | N/A | ['tuple'] | Multiplicative scale factor "ref" for angle_of_attack. Default is 1.0 |
angle_of_attack_ref0 | (None, 'rad') | N/A | ['tuple'] | Additive scale factor "ref0" for angle_of_attack. |
distance_bounds | ((0.0, 10000.0), 'ft') | N/A | ['tuple'] | Tuple of form ((lower, upper), units) containing the upper and lower bounds for all values of distance in the phase. The default of None for upper or lower means that bound will not be declared. |
distance_constraint_ref | (None, 'ft') | N/A | ['tuple'] | Multiplicative scale factor "ref" for the distance boundary constraint. If unspecified, then the value in distance_final is used. At present, only a final constraint is added. |
distance_defect_ref | (None, 'ft') | N/A | ['tuple'] | Multiplicative scale factor "ref" for the distance defect constraint. Default is None, which means the ref and defect_ref are the same. |
distance_final | (None, 'ft') | N/A | ['tuple'] | Tuple of (value, units) containing value of distance at the end of the phase. If this phase is connected to a downstream phase, final values should be specified with distance_initial in that phase instead of here. When specified, a constraint is created on the final distance. |
distance_initial | (None, 'ft') | N/A | ['tuple'] | Tuple of (value, units) containing value of distance at the start of the phase. When unspecified, the optimizer controls the value. When specified, a constraint is created on the initial distance. |
distance_ref | (3000.0, 'ft') | N/A | ['tuple'] | Multiplicative scale factor "ref" for distance. Default is 1.0 |
distance_ref0 | (None, 'ft') | N/A | ['tuple'] | Additive scale factor "ref0" for distance. |
distance_solve_segments | False | [True, False] | ['bool'] | When True, a solver will be used to converge the collocation defects within a segment. Note that the state continuity defects between segements will still be handled by the optimizer. |
flight_path_angle_bounds | ((-0.2617993877991494, 0.4363323129985824), 'rad') | N/A | ['tuple'] | Tuple of form ((lower, upper), units) containing the upper and lower bounds for all values of flight_path_angle in the phase. The default of None for upper or lower means that bound will not be declared. |
flight_path_angle_constraint_ref | (None, 'rad') | N/A | ['tuple'] | Multiplicative scale factor "ref" for the flight_path_angle boundary constraint. If unspecified, then the value in flight_path_angle_final is used. At present, only a final constraint is added. |
flight_path_angle_defect_ref | (0.01, 'rad') | N/A | ['tuple'] | Multiplicative scale factor "ref" for the flight_path_angle defect constraint. Default is None, which means the ref and defect_ref are the same. |
flight_path_angle_final | (None, 'rad') | N/A | ['tuple'] | Tuple of (value, units) containing value of flight_path_angle at the end of the phase. If this phase is connected to a downstream phase, final values should be specified with flight_path_angle_initial in that phase instead of here. When specified, a constraint is created on the final flight_path_angle. |
flight_path_angle_initial | (None, 'rad') | N/A | ['tuple'] | Tuple of (value, units) containing value of flight_path_angle at the start of the phase. When unspecified, the optimizer controls the value. When specified, a constraint is created on the initial flight_path_angle. |
flight_path_angle_ref | (0.017453292519943295, 'rad') | N/A | ['tuple'] | Multiplicative scale factor "ref" for flight_path_angle. Default is 1.0 |
flight_path_angle_ref0 | (None, 'rad') | N/A | ['tuple'] | Additive scale factor "ref0" for flight_path_angle. |
flight_path_angle_solve_segments | False | [True, False] | ['bool'] | When True, a solver will be used to converge the collocation defects within a segment. Note that the state continuity defects between segements will still be handled by the optimizer. |
mass_bounds | ((0.0, 190000.0), 'lbm') | N/A | ['tuple'] | Tuple of form ((lower, upper), units) containing the upper and lower bounds for all values of mass in the phase. The default of None for upper or lower means that bound will not be declared. |
mass_constraint_ref | (None, 'lbm') | N/A | ['tuple'] | Multiplicative scale factor "ref" for the mass boundary constraint. If unspecified, then the value in mass_final is used. At present, only a final constraint is added. |
mass_defect_ref | (100.0, 'lbm') | N/A | ['tuple'] | Multiplicative scale factor "ref" for the mass defect constraint. Default is None, which means the ref and defect_ref are the same. |
mass_final | (None, 'lbm') | N/A | ['tuple'] | Tuple of (value, units) containing value of mass at the end of the phase. If this phase is connected to a downstream phase, final values should be specified with mass_initial in that phase instead of here. When specified, a constraint is created on the final mass. |
mass_initial | (None, 'lbm') | N/A | ['tuple'] | Tuple of (value, units) containing value of mass at the start of the phase. When unspecified, the optimizer controls the value. When specified, a constraint is created on the initial mass. |
mass_ref | (100000.0, 'lbm') | N/A | ['tuple'] | Multiplicative scale factor "ref" for mass. Default is 1.0 |
mass_ref0 | (None, 'lbm') | N/A | ['tuple'] | Additive scale factor "ref0" for mass. |
mass_solve_segments | False | [True, False] | ['bool'] | When True, a solver will be used to converge the collocation defects within a segment. Note that the state continuity defects between segements will still be handled by the optimizer. |
num_segments | 1 | N/A | ['int'] | The number of segments in transcription creation in Dymos. The default value is 1. |
order | N/A | N/A | ['int'] | The order of polynomials for interpolation in the transcription created in Dymos. |
pitch_constraint_bounds | ((0.0, 15.0), 'deg') | N/A | ['tuple'] | Tuple containing the lower and upper bounds of the pitch constraint, with unit string. |
pitch_constraint_ref | (1.0, 'deg') | N/A | ['tuple'] | Scale factor ref for the pitch constraint. |
reserve | False | [True, False] | ['bool'] | Designate this phase as a reserve phase and contributes its fuel burn towards the reserve mission fuel requirements. Reserve phases should be be placed after all non-reserve phases in the phase_info. |
target_distance | (None, 'm') | N/A | ['tuple'] | The total distance traveled by the aircraft from takeoff to landing for the primary mission, not including reserve missions. This value must be positive. |
time_duration | (None, 's') | N/A | ['tuple'] | Tuple of (value, units) containing value of time_duration at the start of the phase. When unspecified, the value comes from upstream. When specified, a constraint is created on the initial time_duration. |
time_duration_bounds | ((None, None), 's') | N/A | ['tuple'] | Tuple of form ((lower, upper), units) containing the upper and lower bounds for all values of time_duration in the phase. The default of None for upper or lower means that bound will not be declared. |
time_duration_ref | (1.0, 's') | N/A | ['tuple'] | Multiplicative scale factor "ref" for time_duration. Default is 1.0 |
time_initial | (None, 's') | N/A | ['tuple'] | Tuple of (value, units) containing value of time_initial at the start of the phase. When unspecified, the value comes from upstream. When specified, a constraint is created on the initial time_initial. |
time_initial_bounds | ((None, None), 's') | N/A | ['tuple'] | Tuple of form ((lower, upper), units) containing the upper and lower bounds for all values of time_initial in the phase. The default of None for upper or lower means that bound will not be declared. |
time_initial_ref | (1.0, 's') | N/A | ['tuple'] | Multiplicative scale factor "ref" for time_initial. Default is 1.0 |
velocity_bounds | ((0.0, 1000.0), 'kn') | N/A | ['tuple'] | Tuple of form ((lower, upper), units) containing the upper and lower bounds for all values of velocity in the phase. The default of None for upper or lower means that bound will not be declared. |
velocity_constraint_ref | (None, 'kn') | N/A | ['tuple'] | Multiplicative scale factor "ref" for the velocity boundary constraint. If unspecified, then the value in velocity_final is used. At present, only a final constraint is added. |
velocity_defect_ref | (None, 'kn') | N/A | ['tuple'] | Multiplicative scale factor "ref" for the velocity defect constraint. Default is None, which means the ref and defect_ref are the same. |
velocity_final | (None, 'kn') | N/A | ['tuple'] | Tuple of (value, units) containing value of velocity at the end of the phase. If this phase is connected to a downstream phase, final values should be specified with velocity_initial in that phase instead of here. When specified, a constraint is created on the final velocity. |
velocity_initial | (None, 'kn') | N/A | ['tuple'] | Tuple of (value, units) containing value of velocity at the start of the phase. When unspecified, the optimizer controls the value. When specified, a constraint is created on the initial velocity. |
velocity_ref | (100.0, 'kn') | N/A | ['tuple'] | Multiplicative scale factor "ref" for velocity. Default is 1.0 |
velocity_ref0 | (None, 'kn') | N/A | ['tuple'] | Additive scale factor "ref0" for velocity. |
velocity_solve_segments | False | [True, False] | ['bool'] | When True, a solver will be used to converge the collocation defects within a segment. Note that the state continuity defects between segements will still be handled by the optimizer. |
ClimbPhase#
om.show_options_table('aviary.mission.gasp_based.phases.climb_phase.ClimbPhaseOptions')
Option | Default | Acceptable Values | Acceptable Types | Description |
---|---|---|---|---|
EAS_target | (0.0, 'kn') | N/A | ['tuple'] | Target airspeed for the balance in this phase. |
altitude_bounds | ((0.0, None), 'ft') | N/A | ['tuple'] | Tuple of form ((lower, upper), units) containing the upper and lower bounds for all values of altitude in the phase. The default of None for upper or lower means that bound will not be declared. |
altitude_constraint_ref | (None, 'ft') | N/A | ['tuple'] | Multiplicative scale factor "ref" for the altitude boundary constraint. If unspecified, then the value in altitude_final is used. At present, only a final constraint is added. |
altitude_defect_ref | (None, 'ft') | N/A | ['tuple'] | Multiplicative scale factor "ref" for the altitude defect constraint. Default is None, which means the ref and defect_ref are the same. |
altitude_final | (None, 'ft') | N/A | ['tuple'] | Tuple of (value, units) containing value of altitude at the end of the phase. If this phase is connected to a downstream phase, final values should be specified with altitude_initial in that phase instead of here. When specified, a constraint is created on the final altitude. |
altitude_initial | (None, 'ft') | N/A | ['tuple'] | Tuple of (value, units) containing value of altitude at the start of the phase. When unspecified, the optimizer controls the value. When specified, a constraint is created on the initial altitude. |
altitude_ref | (1.0, 'ft') | N/A | ['tuple'] | Multiplicative scale factor "ref" for altitude. Default is 1.0 |
altitude_ref0 | (None, 'ft') | N/A | ['tuple'] | Additive scale factor "ref0" for altitude. |
altitude_solve_segments | False | [True, False] | ['bool'] | When True, a solver will be used to converge the collocation defects within a segment. Note that the state continuity defects between segements will still be handled by the optimizer. |
analytic | False | [True, False] | ['bool'] | When set to True, this is an analytic phase. |
distance_bounds | ((0.0, None), 'NM') | N/A | ['tuple'] | Tuple of form ((lower, upper), units) containing the upper and lower bounds for all values of distance in the phase. The default of None for upper or lower means that bound will not be declared. |
distance_constraint_ref | (None, 'NM') | N/A | ['tuple'] | Multiplicative scale factor "ref" for the distance boundary constraint. If unspecified, then the value in distance_final is used. At present, only a final constraint is added. |
distance_defect_ref | (None, 'NM') | N/A | ['tuple'] | Multiplicative scale factor "ref" for the distance defect constraint. Default is None, which means the ref and defect_ref are the same. |
distance_final | (None, 'NM') | N/A | ['tuple'] | Tuple of (value, units) containing value of distance at the end of the phase. If this phase is connected to a downstream phase, final values should be specified with distance_initial in that phase instead of here. When specified, a constraint is created on the final distance. |
distance_initial | (None, 'NM') | N/A | ['tuple'] | Tuple of (value, units) containing value of distance at the start of the phase. When unspecified, the optimizer controls the value. When specified, a constraint is created on the initial distance. |
distance_ref | (1.0, 'NM') | N/A | ['tuple'] | Multiplicative scale factor "ref" for distance. Default is 1.0 |
distance_ref0 | (None, 'NM') | N/A | ['tuple'] | Additive scale factor "ref0" for distance. |
distance_solve_segments | False | [True, False] | ['bool'] | When True, a solver will be used to converge the collocation defects within a segment. Note that the state continuity defects between segements will still be handled by the optimizer. |
mach_cruise | 0.0 | N/A | N/A | Defines the mach constraint at the end of the phase. Only valid when target_mach=True. |
mass_bounds | ((0.0, None), 'lbm') | N/A | ['tuple'] | Tuple of form ((lower, upper), units) containing the upper and lower bounds for all values of mass in the phase. The default of None for upper or lower means that bound will not be declared. |
mass_constraint_ref | (None, 'lbm') | N/A | ['tuple'] | Multiplicative scale factor "ref" for the mass boundary constraint. If unspecified, then the value in mass_final is used. At present, only a final constraint is added. |
mass_defect_ref | (None, 'lbm') | N/A | ['tuple'] | Multiplicative scale factor "ref" for the mass defect constraint. Default is None, which means the ref and defect_ref are the same. |
mass_final | (None, 'lbm') | N/A | ['tuple'] | Tuple of (value, units) containing value of mass at the end of the phase. If this phase is connected to a downstream phase, final values should be specified with mass_initial in that phase instead of here. When specified, a constraint is created on the final mass. |
mass_initial | (None, 'lbm') | N/A | ['tuple'] | Tuple of (value, units) containing value of mass at the start of the phase. When unspecified, the optimizer controls the value. When specified, a constraint is created on the initial mass. |
mass_ref | (1.0, 'lbm') | N/A | ['tuple'] | Multiplicative scale factor "ref" for mass. Default is 1.0 |
mass_ref0 | (None, 'lbm') | N/A | ['tuple'] | Additive scale factor "ref0" for mass. |
mass_solve_segments | False | [True, False] | ['bool'] | When True, a solver will be used to converge the collocation defects within a segment. Note that the state continuity defects between segements will still be handled by the optimizer. |
num_segments | N/A | N/A | ['int'] | The number of segments in transcription creation in Dymos. |
order | N/A | N/A | ['int'] | The order of polynomials for interpolation in the transcription created in Dymos. |
required_available_climb_rate | (None, 'ft/min') | N/A | ['tuple'] | Adds a constraint requiring Dynamic.Mission.ALTITUDE_RATE_MAX to be no smaller than required_available_climb_rate. This helps to ensure that the propulsion system is large enough to handle emergency maneuvers at all points throughout the flight envelope. Default value is None for no constraint. |
reserve | False | [True, False] | ['bool'] | Designate this phase as a reserve phase and contributes its fuel burn towards the reserve mission fuel requirements. Reserve phases should be be placed after all non-reserve phases in the phase_info. |
target_distance | (None, 'm') | N/A | ['tuple'] | The total distance traveled by the aircraft from takeoff to landing for the primary mission, not including reserve missions. This value must be positive. |
target_mach | False | [True, False] | ['bool'] | Set to true to enforce a mach_constraint at the phase endpoint. The mach value is set in "mach_cruise". |
time_duration | (None, 's') | N/A | ['tuple'] | Tuple of (value, units) containing value of time_duration at the start of the phase. When unspecified, the value comes from upstream. When specified, a constraint is created on the initial time_duration. |
time_duration_bounds | ((None, None), 's') | N/A | ['tuple'] | Tuple of form ((lower, upper), units) containing the upper and lower bounds for all values of time_duration in the phase. The default of None for upper or lower means that bound will not be declared. |
time_duration_ref | (1.0, 's') | N/A | ['tuple'] | Multiplicative scale factor "ref" for time_duration. Default is 1.0 |
time_initial | (None, 's') | N/A | ['tuple'] | Tuple of (value, units) containing value of time_initial at the start of the phase. When unspecified, the value comes from upstream. When specified, a constraint is created on the initial time_initial. |
time_initial_bounds | ((None, None), 's') | N/A | ['tuple'] | Tuple of form ((lower, upper), units) containing the upper and lower bounds for all values of time_initial in the phase. The default of None for upper or lower means that bound will not be declared. |
time_initial_ref | (1.0, 's') | N/A | ['tuple'] | Multiplicative scale factor "ref" for time_initial. Default is 1.0 |
CruisePhase#
om.show_options_table('aviary.mission.gasp_based.phases.cruise_phase.CruisePhaseOptions')
Option | Default | Acceptable Values | Acceptable Types | Description |
---|---|---|---|---|
alt_cruise | (0.0, 'ft') | N/A | ['tuple'] | Cruise altitude. |
analytic | False | [True, False] | ['bool'] | When set to True, this is an analytic phase. |
mach_cruise | 0.0 | N/A | N/A | Cruise Mach number. |
reserve | False | [True, False] | ['bool'] | Designate this phase as a reserve phase and contributes its fuel burn towards the reserve mission fuel requirements. Reserve phases should be be placed after all non-reserve phases in the phase_info. |
target_distance | (None, 'm') | N/A | ['tuple'] | The total distance traveled by the aircraft from takeoff to landing for the primary mission, not including reserve missions. This value must be positive. |
time_duration | (None, 's') | N/A | ['tuple'] | The amount of time taken by this phase added as a constraint. |
time_duration_bounds | ((0, 3600), 's') | N/A | ['tuple'] | Lower and upper bounds on the phase duration, in the form of a nested tuple: i.e. ((20, 36), "min") This constrains the duration to be between 20 and 36 min. |
time_initial_bounds | ((0.0, 100.0), 's') | N/A | ['tuple'] | Lower and upper bounds on the starting time for this phase relative to the starting time of the mission, i.e., ((25, 45), "min") constrians this phase to start between 25 and 45 minutes after the start of the mission. |
DescentPhase#
om.show_options_table('aviary.mission.gasp_based.phases.descent_phase.DescentPhaseOptions')
Option | Default | Acceptable Values | Acceptable Types | Description |
---|---|---|---|---|
EAS_limit | (0.0, 'kn') | N/A | ['tuple'] | Value for maximum speed constraint in this phase. |
altitude_bounds | ((0.0, None), 'ft') | N/A | ['tuple'] | Tuple of form ((lower, upper), units) containing the upper and lower bounds for all values of altitude in the phase. The default of None for upper or lower means that bound will not be declared. |
altitude_constraint_ref | (100.0, 'ft') | N/A | ['tuple'] | Multiplicative scale factor "ref" for the altitude boundary constraint. If unspecified, then the value in altitude_final is used. At present, only a final constraint is added. |
altitude_defect_ref | (None, 'ft') | N/A | ['tuple'] | Multiplicative scale factor "ref" for the altitude defect constraint. Default is None, which means the ref and defect_ref are the same. |
altitude_final | (None, 'ft') | N/A | ['tuple'] | Tuple of (value, units) containing value of altitude at the end of the phase. If this phase is connected to a downstream phase, final values should be specified with altitude_initial in that phase instead of here. When specified, a constraint is created on the final altitude. |
altitude_initial | (None, 'ft') | N/A | ['tuple'] | Tuple of (value, units) containing value of altitude at the start of the phase. When unspecified, the optimizer controls the value. When specified, a constraint is created on the initial altitude. |
altitude_ref | (1.0, 'ft') | N/A | ['tuple'] | Multiplicative scale factor "ref" for altitude. Default is 1.0 |
altitude_ref0 | (None, 'ft') | N/A | ['tuple'] | Additive scale factor "ref0" for altitude. |
altitude_solve_segments | False | [True, False] | ['bool'] | When True, a solver will be used to converge the collocation defects within a segment. Note that the state continuity defects between segements will still be handled by the optimizer. |
analytic | False | [True, False] | ['bool'] | When set to True, this is an analytic phase. |
distance_bounds | ((0.0, None), 'NM') | N/A | ['tuple'] | Tuple of form ((lower, upper), units) containing the upper and lower bounds for all values of distance in the phase. The default of None for upper or lower means that bound will not be declared. |
distance_constraint_ref | (None, 'NM') | N/A | ['tuple'] | Multiplicative scale factor "ref" for the distance boundary constraint. If unspecified, then the value in distance_final is used. At present, only a final constraint is added. |
distance_defect_ref | (None, 'NM') | N/A | ['tuple'] | Multiplicative scale factor "ref" for the distance defect constraint. Default is None, which means the ref and defect_ref are the same. |
distance_final | (None, 'NM') | N/A | ['tuple'] | Tuple of (value, units) containing value of distance at the end of the phase. If this phase is connected to a downstream phase, final values should be specified with distance_initial in that phase instead of here. When specified, a constraint is created on the final distance. |
distance_initial | (None, 'NM') | N/A | ['tuple'] | Tuple of (value, units) containing value of distance at the start of the phase. When unspecified, the optimizer controls the value. When specified, a constraint is created on the initial distance. |
distance_ref | (1.0, 'NM') | N/A | ['tuple'] | Multiplicative scale factor "ref" for distance. Default is 1.0 |
distance_ref0 | (None, 'NM') | N/A | ['tuple'] | Additive scale factor "ref0" for distance. |
distance_solve_segments | False | [True, False] | ['bool'] | When True, a solver will be used to converge the collocation defects within a segment. Note that the state continuity defects between segements will still be handled by the optimizer. |
input_speed_type | mach | [<SpeedType.MACH: 'mach'>, <SpeedType.EAS: 'EAS'>, <SpeedType.TAS: 'TAS'>] | N/A | Determines which speed variable is independent. The other two will be .computed from it. |
mach_cruise | 0.0 | N/A | N/A | Defines the mach constraint in this phase. |
mass_bounds | ((0.0, None), 'lbm') | N/A | ['tuple'] | Tuple of form ((lower, upper), units) containing the upper and lower bounds for all values of mass in the phase. The default of None for upper or lower means that bound will not be declared. |
mass_constraint_ref | (None, 'lbm') | N/A | ['tuple'] | Multiplicative scale factor "ref" for the mass boundary constraint. If unspecified, then the value in mass_final is used. At present, only a final constraint is added. |
mass_defect_ref | (None, 'lbm') | N/A | ['tuple'] | Multiplicative scale factor "ref" for the mass defect constraint. Default is None, which means the ref and defect_ref are the same. |
mass_final | (None, 'lbm') | N/A | ['tuple'] | Tuple of (value, units) containing value of mass at the end of the phase. If this phase is connected to a downstream phase, final values should be specified with mass_initial in that phase instead of here. When specified, a constraint is created on the final mass. |
mass_initial | (None, 'lbm') | N/A | ['tuple'] | Tuple of (value, units) containing value of mass at the start of the phase. When unspecified, the optimizer controls the value. When specified, a constraint is created on the initial mass. |
mass_ref | (1.0, 'lbm') | N/A | ['tuple'] | Multiplicative scale factor "ref" for mass. Default is 1.0 |
mass_ref0 | (None, 'lbm') | N/A | ['tuple'] | Additive scale factor "ref0" for mass. |
mass_solve_segments | False | [True, False] | ['bool'] | When True, a solver will be used to converge the collocation defects within a segment. Note that the state continuity defects between segements will still be handled by the optimizer. |
num_segments | N/A | N/A | ['int'] | The number of segments in transcription creation in Dymos. |
order | N/A | N/A | ['int'] | The order of polynomials for interpolation in the transcription created in Dymos. |
reserve | False | [True, False] | ['bool'] | Designate this phase as a reserve phase and contributes its fuel burn towards the reserve mission fuel requirements. Reserve phases should be be placed after all non-reserve phases in the phase_info. |
target_distance | (None, 'm') | N/A | ['tuple'] | The total distance traveled by the aircraft from takeoff to landing for the primary mission, not including reserve missions. This value must be positive. |
time_duration | (None, 's') | N/A | ['tuple'] | Tuple of (value, units) containing value of time_duration at the start of the phase. When unspecified, the value comes from upstream. When specified, a constraint is created on the initial time_duration. |
time_duration_bounds | ((None, None), 's') | N/A | ['tuple'] | Tuple of form ((lower, upper), units) containing the upper and lower bounds for all values of time_duration in the phase. The default of None for upper or lower means that bound will not be declared. |
time_duration_ref | (1.0, 's') | N/A | ['tuple'] | Multiplicative scale factor "ref" for time_duration. Default is 1.0 |
time_initial | (None, 's') | N/A | ['tuple'] | Tuple of (value, units) containing value of time_initial at the start of the phase. When unspecified, the value comes from upstream. When specified, a constraint is created on the initial time_initial. |
time_initial_bounds | ((None, None), 's') | N/A | ['tuple'] | Tuple of form ((lower, upper), units) containing the upper and lower bounds for all values of time_initial in the phase. The default of None for upper or lower means that bound will not be declared. |
time_initial_ref | (1.0, 's') | N/A | ['tuple'] | Multiplicative scale factor "ref" for time_initial. Default is 1.0 |
GroundrollPhase#
om.show_options_table('aviary.mission.gasp_based.phases.groundroll_phase.GroundrollPhaseOptions')
Option | Default | Acceptable Values | Acceptable Types | Description |
---|---|---|---|---|
analytic | False | [True, False] | ['bool'] | When set to True, this is an analytic phase. |
distance_bounds | ((0.0, 4000.0), 'ft') | N/A | ['tuple'] | Tuple of form ((lower, upper), units) containing the upper and lower bounds for all values of distance in the phase. The default of None for upper or lower means that bound will not be declared. |
distance_constraint_ref | (None, 'ft') | N/A | ['tuple'] | Multiplicative scale factor "ref" for the distance boundary constraint. If unspecified, then the value in distance_final is used. At present, only a final constraint is added. |
distance_defect_ref | (None, 'ft') | N/A | ['tuple'] | Multiplicative scale factor "ref" for the distance defect constraint. Default is None, which means the ref and defect_ref are the same. |
distance_final | (None, 'ft') | N/A | ['tuple'] | Tuple of (value, units) containing value of distance at the end of the phase. If this phase is connected to a downstream phase, final values should be specified with distance_initial in that phase instead of here. When specified, a constraint is created on the final distance. |
distance_initial | (None, 'ft') | N/A | ['tuple'] | Tuple of (value, units) containing value of distance at the start of the phase. When unspecified, the optimizer controls the value. When specified, a constraint is created on the initial distance. |
distance_ref | (3000.0, 'ft') | N/A | ['tuple'] | Multiplicative scale factor "ref" for distance. Default is 1.0 |
distance_ref0 | (None, 'ft') | N/A | ['tuple'] | Additive scale factor "ref0" for distance. |
distance_solve_segments | False | [True, False] | ['bool'] | When True, a solver will be used to converge the collocation defects within a segment. Note that the state continuity defects between segements will still be handled by the optimizer. |
mass_bounds | ((0.0, 200000.0), 'lbm') | N/A | ['tuple'] | Tuple of form ((lower, upper), units) containing the upper and lower bounds for all values of mass in the phase. The default of None for upper or lower means that bound will not be declared. |
mass_constraint_ref | (None, 'lbm') | N/A | ['tuple'] | Multiplicative scale factor "ref" for the mass boundary constraint. If unspecified, then the value in mass_final is used. At present, only a final constraint is added. |
mass_defect_ref | (100.0, 'lbm') | N/A | ['tuple'] | Multiplicative scale factor "ref" for the mass defect constraint. Default is None, which means the ref and defect_ref are the same. |
mass_final | (None, 'lbm') | N/A | ['tuple'] | Tuple of (value, units) containing value of mass at the end of the phase. If this phase is connected to a downstream phase, final values should be specified with mass_initial in that phase instead of here. When specified, a constraint is created on the final mass. |
mass_initial | (None, 'lbm') | N/A | ['tuple'] | Tuple of (value, units) containing value of mass at the start of the phase. When unspecified, the optimizer controls the value. When specified, a constraint is created on the initial mass. |
mass_ref | (100000.0, 'lbm') | N/A | ['tuple'] | Multiplicative scale factor "ref" for mass. Default is 1.0 |
mass_ref0 | (None, 'lbm') | N/A | ['tuple'] | Additive scale factor "ref0" for mass. |
mass_solve_segments | False | [True, False] | ['bool'] | When True, a solver will be used to converge the collocation defects within a segment. Note that the state continuity defects between segements will still be handled by the optimizer. |
num_segments | 1 | N/A | ['int'] | The number of segments in transcription creation in Dymos. The default value is 1. |
order | 3 | N/A | ['int'] | The order of polynomials for interpolation in the transcription created in Dymos. The default value is 3. |
t_init_flaps | (100.0, 's') | N/A | ['tuple'] | Time where flaps are retracted. |
t_init_gear | (100.0, 's') | N/A | ['tuple'] | Time where landing gear is lifted. |
time_duration | (None, 's') | N/A | ['tuple'] | Tuple of (value, units) containing value of time_duration at the start of the phase. When unspecified, the value comes from upstream. When specified, a constraint is created on the initial time_duration. |
time_duration_bounds | ((1.0, 100.0), 's') | N/A | ['tuple'] | Tuple of form ((lower, upper), units) containing the upper and lower bounds for all values of time_duration in the phase. The default of None for upper or lower means that bound will not be declared. |
time_duration_ref | (1.0, 's') | N/A | ['tuple'] | Multiplicative scale factor "ref" for time_duration. Default is 1.0 |
time_initial | (None, 's') | N/A | ['tuple'] | Tuple of (value, units) containing value of time_initial at the start of the phase. When unspecified, the value comes from upstream. When specified, a constraint is created on the initial time_initial. |
time_initial_bounds | ((None, None), 's') | N/A | ['tuple'] | Tuple of form ((lower, upper), units) containing the upper and lower bounds for all values of time_initial in the phase. The default of None for upper or lower means that bound will not be declared. |
time_initial_ref | (1.0, 's') | N/A | ['tuple'] | Multiplicative scale factor "ref" for time_initial. Default is 1.0 |
velocity_bounds | ((0.0, 1000.0), 'kn') | N/A | ['tuple'] | Tuple of form ((lower, upper), units) containing the upper and lower bounds for all values of velocity in the phase. The default of None for upper or lower means that bound will not be declared. |
velocity_constraint_ref | (None, 'kn') | N/A | ['tuple'] | Multiplicative scale factor "ref" for the velocity boundary constraint. If unspecified, then the value in velocity_final is used. At present, only a final constraint is added. |
velocity_defect_ref | (None, 'kn') | N/A | ['tuple'] | Multiplicative scale factor "ref" for the velocity defect constraint. Default is None, which means the ref and defect_ref are the same. |
velocity_final | (None, 'kn') | N/A | ['tuple'] | Tuple of (value, units) containing value of velocity at the end of the phase. If this phase is connected to a downstream phase, final values should be specified with velocity_initial in that phase instead of here. When specified, a constraint is created on the final velocity. |
velocity_initial | (None, 'kn') | N/A | ['tuple'] | Tuple of (value, units) containing value of velocity at the start of the phase. When unspecified, the optimizer controls the value. When specified, a constraint is created on the initial velocity. |
velocity_ref | (100.0, 'kn') | N/A | ['tuple'] | Multiplicative scale factor "ref" for velocity. Default is 1.0 |
velocity_ref0 | (None, 'kn') | N/A | ['tuple'] | Additive scale factor "ref0" for velocity. |
velocity_solve_segments | False | [True, False] | ['bool'] | When True, a solver will be used to converge the collocation defects within a segment. Note that the state continuity defects between segements will still be handled by the optimizer. |
RotationPhase#
om.show_options_table('aviary.mission.gasp_based.phases.rotation_phase.RotationPhaseOptions')
Option | Default | Acceptable Values | Acceptable Types | Description |
---|---|---|---|---|
analytic | False | [True, False] | ['bool'] | When set to True, this is an analytic phase. |
angle_of_attack_bounds | ((0.0, 0.4363323129985824), 'rad') | N/A | ['tuple'] | Tuple of form ((lower, upper), units) containing the upper and lower bounds for all values of angle_of_attack in the phase. The default of None for upper or lower means that bound will not be declared. |
angle_of_attack_constraint_ref | (None, 'rad') | N/A | ['tuple'] | Multiplicative scale factor "ref" for the angle_of_attack boundary constraint. If unspecified, then the value in angle_of_attack_final is used. At present, only a final constraint is added. |
angle_of_attack_defect_ref | (0.01, 'rad') | N/A | ['tuple'] | Multiplicative scale factor "ref" for the angle_of_attack defect constraint. Default is None, which means the ref and defect_ref are the same. |
angle_of_attack_final | (None, 'rad') | N/A | ['tuple'] | Tuple of (value, units) containing value of angle_of_attack at the end of the phase. If this phase is connected to a downstream phase, final values should be specified with angle_of_attack_initial in that phase instead of here. When specified, a constraint is created on the final angle_of_attack. |
angle_of_attack_initial | (None, 'rad') | N/A | ['tuple'] | Tuple of (value, units) containing value of angle_of_attack at the start of the phase. When unspecified, the optimizer controls the value. When specified, a constraint is created on the initial angle_of_attack. |
angle_of_attack_ref | (1.0, 'rad') | N/A | ['tuple'] | Multiplicative scale factor "ref" for angle_of_attack. Default is 1.0 |
angle_of_attack_ref0 | (None, 'rad') | N/A | ['tuple'] | Additive scale factor "ref0" for angle_of_attack. |
angle_of_attack_solve_segments | False | [True, False] | ['bool'] | When True, a solver will be used to converge the collocation defects within a segment. Note that the state continuity defects between segements will still be handled by the optimizer. |
distance_bounds | ((0.0, 10000.0), 'ft') | N/A | ['tuple'] | Tuple of form ((lower, upper), units) containing the upper and lower bounds for all values of distance in the phase. The default of None for upper or lower means that bound will not be declared. |
distance_constraint_ref | (None, 'ft') | N/A | ['tuple'] | Multiplicative scale factor "ref" for the distance boundary constraint. If unspecified, then the value in distance_final is used. At present, only a final constraint is added. |
distance_defect_ref | (None, 'ft') | N/A | ['tuple'] | Multiplicative scale factor "ref" for the distance defect constraint. Default is None, which means the ref and defect_ref are the same. |
distance_final | (None, 'ft') | N/A | ['tuple'] | Tuple of (value, units) containing value of distance at the end of the phase. If this phase is connected to a downstream phase, final values should be specified with distance_initial in that phase instead of here. When specified, a constraint is created on the final distance. |
distance_initial | (None, 'ft') | N/A | ['tuple'] | Tuple of (value, units) containing value of distance at the start of the phase. When unspecified, the optimizer controls the value. When specified, a constraint is created on the initial distance. |
distance_ref | (3000.0, 'ft') | N/A | ['tuple'] | Multiplicative scale factor "ref" for distance. Default is 1.0 |
distance_ref0 | (None, 'ft') | N/A | ['tuple'] | Additive scale factor "ref0" for distance. |
distance_solve_segments | False | [True, False] | ['bool'] | When True, a solver will be used to converge the collocation defects within a segment. Note that the state continuity defects between segements will still be handled by the optimizer. |
mass_bounds | ((0.0, 190000.0), 'lbm') | N/A | ['tuple'] | Tuple of form ((lower, upper), units) containing the upper and lower bounds for all values of mass in the phase. The default of None for upper or lower means that bound will not be declared. |
mass_constraint_ref | (None, 'lbm') | N/A | ['tuple'] | Multiplicative scale factor "ref" for the mass boundary constraint. If unspecified, then the value in mass_final is used. At present, only a final constraint is added. |
mass_defect_ref | (None, 'lbm') | N/A | ['tuple'] | Multiplicative scale factor "ref" for the mass defect constraint. Default is None, which means the ref and defect_ref are the same. |
mass_final | (None, 'lbm') | N/A | ['tuple'] | Tuple of (value, units) containing value of mass at the end of the phase. If this phase is connected to a downstream phase, final values should be specified with mass_initial in that phase instead of here. When specified, a constraint is created on the final mass. |
mass_initial | (None, 'lbm') | N/A | ['tuple'] | Tuple of (value, units) containing value of mass at the start of the phase. When unspecified, the optimizer controls the value. When specified, a constraint is created on the initial mass. |
mass_ref | (100000.0, 'lbm') | N/A | ['tuple'] | Multiplicative scale factor "ref" for mass. Default is 1.0 |
mass_ref0 | (None, 'lbm') | N/A | ['tuple'] | Additive scale factor "ref0" for mass. |
mass_solve_segments | False | [True, False] | ['bool'] | When True, a solver will be used to converge the collocation defects within a segment. Note that the state continuity defects between segements will still be handled by the optimizer. |
normal_ref | (1.0, 'lbf') | N/A | ['tuple'] | Scale factor ref for the normal force constraint. |
normal_ref0 | (0.0, 'lbf') | N/A | ['tuple'] | Scale factor ref0 for the normal force constraint. |
num_segments | N/A | N/A | ['int'] | The number of segments in transcription creation in Dymos. |
order | N/A | N/A | ['int'] | The order of polynomials for interpolation in the transcription created in Dymos. |
reserve | False | [True, False] | ['bool'] | Designate this phase as a reserve phase and contributes its fuel burn towards the reserve mission fuel requirements. Reserve phases should be be placed after all non-reserve phases in the phase_info. |
t_init_flaps | (100.0, 's') | N/A | ['tuple'] | Time where flaps are retracted. |
t_init_gear | (100.0, 's') | N/A | ['tuple'] | Time where landing gear is lifted. |
target_distance | (None, 'm') | N/A | ['tuple'] | The total distance traveled by the aircraft from takeoff to landing for the primary mission, not including reserve missions. This value must be positive. |
time_duration | (None, 's') | N/A | ['tuple'] | Tuple of (value, units) containing value of time_duration at the start of the phase. When unspecified, the value comes from upstream. When specified, a constraint is created on the initial time_duration. |
time_duration_bounds | ((1.0, 100.0), 's') | N/A | ['tuple'] | Tuple of form ((lower, upper), units) containing the upper and lower bounds for all values of time_duration in the phase. The default of None for upper or lower means that bound will not be declared. |
time_duration_ref | (1.0, 's') | N/A | ['tuple'] | Multiplicative scale factor "ref" for time_duration. Default is 1.0 |
time_initial | (None, 's') | N/A | ['tuple'] | Tuple of (value, units) containing value of time_initial at the start of the phase. When unspecified, the value comes from upstream. When specified, a constraint is created on the initial time_initial. |
time_initial_bounds | ((None, None), 's') | N/A | ['tuple'] | Tuple of form ((lower, upper), units) containing the upper and lower bounds for all values of time_initial in the phase. The default of None for upper or lower means that bound will not be declared. |
time_initial_ref | (1.0, 's') | N/A | ['tuple'] | Multiplicative scale factor "ref" for time_initial. Default is 1.0 |
velocity_bounds | ((0.0, 1000.0), 'kn') | N/A | ['tuple'] | Tuple of form ((lower, upper), units) containing the upper and lower bounds for all values of velocity in the phase. The default of None for upper or lower means that bound will not be declared. |
velocity_constraint_ref | (None, 'kn') | N/A | ['tuple'] | Multiplicative scale factor "ref" for the velocity boundary constraint. If unspecified, then the value in velocity_final is used. At present, only a final constraint is added. |
velocity_defect_ref | (None, 'kn') | N/A | ['tuple'] | Multiplicative scale factor "ref" for the velocity defect constraint. Default is None, which means the ref and defect_ref are the same. |
velocity_final | (None, 'kn') | N/A | ['tuple'] | Tuple of (value, units) containing value of velocity at the end of the phase. If this phase is connected to a downstream phase, final values should be specified with velocity_initial in that phase instead of here. When specified, a constraint is created on the final velocity. |
velocity_initial | (None, 'kn') | N/A | ['tuple'] | Tuple of (value, units) containing value of velocity at the start of the phase. When unspecified, the optimizer controls the value. When specified, a constraint is created on the initial velocity. |
velocity_ref | (100.0, 'kn') | N/A | ['tuple'] | Multiplicative scale factor "ref" for velocity. Default is 1.0 |
velocity_ref0 | (None, 'kn') | N/A | ['tuple'] | Additive scale factor "ref0" for velocity. |
velocity_solve_segments | False | [True, False] | ['bool'] | When True, a solver will be used to converge the collocation defects within a segment. Note that the state continuity defects between segements will still be handled by the optimizer. |