v1.0.1

[jkirk5]

Aviary version 1.0.1 is now released! This version includes a large number of bug fixes and behind-the-scenes changes, as well as a few feature additions and minor backwards-incompatible changes.

Feature Additions

• New atmospheric models for Mars and Venus are now available - see the docs page on the Atmosphere subsystem for details. Note that gravitational acceleration is still hardcoded to earth for much of Aviary, but user-set gravitational acceleration will be made available in a future update.
• Coefficients of friction for 2DOF-based takeoff and landing are no longer hardcoded constants but now controlled by existing variables (Mission.Takeoff.ROLLING_FRICTION_COEFFICIENT, `Mission.Landing.ROLLING_FRICTION_COEFFICIENT'). When not provided by the user, these revert to the same defaults as legacy codes (FLOPS vs. GASP) based on which equations of motion are selected for mission analysis.
• Aviary's mass subsystem now computes aircraft useful load (defined as the difference between gross mass and zero fuel mass). A new mass category, Aircraft.Design.OPERATING_ITEMS was created to bookkeep non-fuel and passenger/cargo masses included in useful load. This includes crew, unusable fuel, and oil mass among others.
• The energy-state simple takeoff component now actively uses the propulsion subsystem to directly compute thrust rather than rely on Aircraft.Design.THRUST_TAKEOFF_PER_ENG. A new variable, Mission.Takeoff.CLIMBOUT_THRUST_FRACTION allows the user to control the takeoff thrust to assist in modeling failure states. It defaults to 1.0 for backwards compatibility reasons (i.e. full engine thrust used in takeoff)
• FLOPS-based aerodynamics (the EDET method) now allows for users to control the percentage of drag which comes from excrescence via Aircraft.Design.PERCENT_EXCRESCENCE_DRAG. It not provided by the user, it defaults to the value used by the legacy code for that aerodynamics method.

Backwards Incompatibilities

Variable Name Changes

Fuel variables were updated to specify that they record mass (as opposed to volume)

• Aircraft.Engine.CONSTANT_FUEL_CONSUMPTION -> Aircraft.Engine.CONSTANT_FUEL_MASS_CONSUMPTION
• Aircraft.Fuel.AUXILIARY_FUEL_CAPACITY -> Aircraft.Fuel.AUXILIARY_FUEL_MASS_CAPACITY
• Aircraft.Fuel.WING_FUEL_CAPACITY -> Aircraft.Fuel.WING_FUEL_MASS_CAPACITY
• Dynamic.Vehicle.Propulsion.FUEL_FLOW_RATE -> Dynamic.Vehicle.Propulsion.FUEL_MASS_FLOW_RATE
• Dynamic.Vehicle.Propulsion.FUEL_FLOW_RATE_NEGATIVE -> Dynamic.Vehicle.Propulsion.FUEL_MASS_FLOW_RATE_NEGATIVE
• Dynamic.Vehicle.Propulsion.FUEL_FLOW_RATE_NEGATIVE_TOTAL ->
• Dynamic.Vehicle.Propulsion.FUEL_MASS_FLOW_RATE_NEGATIVE_TOTAL
• Mission.BLOCK_FUEL -> Mission.BLOCK_FUEL_MASS
• Mission.RESERVE_FUEL_ADDITIONAL -> Mission.RESERVE_FUEL_MASS_ADDITIONAL
• Mission.TOTAL_FUEL -> Mission.TOTAL_FUEL_MASS
• Mission.TOTAL_RESERVE_FUEL -> Mission.TOTAL_RESERVE_FUEL_MASS
• Mission.Constraints.EXCESS_FUEL_CAPACITY -> Mission.Constraints.EXCESS_FUEL_MASS_CAPACITY
• Mission.Takeoff.FUEL -> Mission.Takeoff.FUEL_MASS
• Mission.Taxi.FUEL_TAXI_IN -> Mission.Taxi.FUEL_MASS_TAXI_IN
• Mission.Taxi.FUEL_TAXI_OUT -> Mission.Taxi.FUEL_MASS_TAXI_OUT

Aircraft.Design.THRUST_TAKEOFF_PER_ENG has been removed (see Feature Additions above for explanation)

What's Changed

• increment version to v1.0.1-dev by @jkirk5 in increment version to v1.0.1-dev #1121
• Tweak the scaling in the ascent phase to get the battery benchmark working again. by @Kenneth-T-Moore in Tweak the scaling in the ascent phase to get the battery benchmark working again. #1120
• Refactor CI to use the pixi envs from OpenMDAO. by @Kenneth-T-Moore in Refactor CI to use the pixi envs from OpenMDAO. #1126
• Fix weekly CI job by @Kenneth-T-Moore in Fix weekly CI job #1136
• GASP aero multiengine update by @jkirk5 in GASP aero multiengine update #1128
• Discontinuities in GASP based mass subsystem are removed by @xjjiang in Discontinuities in GASP based mass subsystem are removed #1130
• Allow Aircraft.Wing.LOAD_DISTRIBUTION_CONTROL to be in [1, 3] by @xjjiang in Allow Aircraft.Wing.LOAD_DISTRIBUTION_CONTROL to be in [1, 3] #1127
• Fix a setup error for when a static and dynamic variable are promoted together. by @Kenneth-T-Moore in Fix a setup error for when a static and dynamic variable are promoted together. #1134
• Fix landing altitude connection by @cmbenne3 in Fix landing altitude connection #1139
• CI overhaul 2: remove no_dev workflow. Begin to add Windows/Macos testing (will be completed in follow-on). by @Kenneth-T-Moore in CI overhaul 2: remove no_dev workflow. Begin to add Windows/Macos testing (will be completed in follow-on). #1146
• Fix the warning check for the cabin crew calculation. by @Kenneth-T-Moore in Fix the warning check for the cabin crew calculation. #1137
• Takeoff thrust by @cmbenne3 in Takeoff thrust #1142
• Display Preprocessor Warnings by @cmbenne3 in Display Preprocessor Warnings #1143
• Made fewer fields required in issue templates by @jkirk5 in Made fewer fields required in issue templates #1147
• Useful load update by @cmbenne3 in Useful load update #1122
• Some cleanup in the 2DOF mission. by @Kenneth-T-Moore in Some cleanup in the 2DOF mission. #1144
• Activate win and mac jobs by @Kenneth-T-Moore in Activate win and mac jobs #1149
• Reduce number of terminal printouts by @jkirk5 in Reduce number of terminal printouts #1150
• More check partials in GASP based mass subsystem by @xjjiang in More check partials in GASP based mass subsystem #1153
• Add CD and Cl to the timeseries. by @Kenneth-T-Moore in Add CD and Cl to the timeseries. #1154
• A new section for FLOPS modelers in blended_wing_body_FLOPS.ipynb by @xjjiang in A new section for FLOPS modelers in blended_wing_body_FLOPS.ipynb #1152
• Update FLOPS based mass partials and BWB300 model by @xjjiang in Update FLOPS based mass partials and BWB300 model #1156
• Split GASP mass components by @xjjiang in Split GASP mass components #1133
• Don't overwrite driver opt_settings specified by user by @jkirk5 in Don't overwrite driver opt_settings specified by user #1148
• Extended the args for get_linked_variables in the subsystem API. by @Kenneth-T-Moore in Extended the args for get_linked_variables in the subsystem API. #1160
• Use built-in dymos methods for setting states/controls/time by @Kenneth-T-Moore in Use built-in dymos methods for setting states/controls/time #1166
• nacelle mass update by @jkirk5 in nacelle mass update #1165
• Fixed problem preventing external subsystem tests from running by @jkirk5 in Fixed problem preventing external subsystem tests from running #1172
• Fixed pre-made objectives to correctly minimize targets by @jkirk5 in Fixed pre-made objectives to correctly minimize targets #1167
• Use Aircraft.Design.LANDING_TO_TAKEOFF_MASS_RATIO for GASP based by @xjjiang in Use Aircraft.Design.LANDING_TO_TAKEOFF_MASS_RATIO for GASP based #1158
• Move MU_LANDING and MU_TAKEOFF out of constants.py by @xjjiang in Move MU_LANDING and MU_TAKEOFF out of constants.py #1170
• Move some of TODOs to issue database from source code by @xjjiang in Move some of TODOs to issue database from source code #1187
• Added mass to the name of variables related to fuel masses by @hschilling in Added mass to the name of variables related to fuel masses #1171
• Mars + Venus Atmosphere Models by @ehariton in Mars + Venus Atmosphere Models #1163
• Apply Aircraft.Design.PERCENT_EXCRESCENCE_DRAG to FLOPS based aerodynamics by @xjjiang in Apply Aircraft.Design.PERCENT_EXCRESCENCE_DRAG to FLOPS based aerodynamics #1185
• Fix image width not rendering in external_subsystems docs by @hschilling in Fix image width not rendering in external_subsystems docs #1201
• Add Aircraft.Furnishings.ADDITIONAL_MASS by @xjjiang in Add Aircraft.Furnishings.ADDITIONAL_MASS #1157
• New documentation on Aviary problem structure by @jkirk5 in New documentation on Aviary problem structure #1155
• Added GASP default to gasp_defaults.py by @xjjiang in Added GASP default to gasp_defaults.py #1197
• Standardize some aviary function call by @xjjiang in Standardize some aviary function call #1202
• 1.0.1 version increment by @jkirk5 in 1.0.1 version increment #1212

Full Changelog: v1.0.0...v1.0.1

---

This discussion was created from the release v1.0.1.