profiles.py

class openconcept.mission.profiles.FullMissionWithReserve(include_takeoff=True, include_reserve=True, **kwargs)

Bases: TrajectoryGroup

A combination of the FullMissionAnalysis and MissionWithReserve profiles (see their documentation) for more details. This combination includes the balanced field length simulation from FullMissionAnalysis, climb, cruise, and descent phases, and the reserve phases from MissionWithReserve.

This acts as the main group that includes all the features of FullMissionAnalysis, BasicMission, and MissionWithReserve profiles so that those can inherit from this without duplicating code.

class openconcept.mission.profiles.MissionWithReserve(**kwargs)

Bases: FullMissionWithReserve

This analysis group is set up to compute all the major parameters of a fixed wing mission, including climb, cruise, and descent as well as Part 25 reserve fuel phases. The 5% of block fuel is not accounted for here.

To use this analysis, pass in an aircraft model following OpenConcept interface. Namely, the model should consume the following: - flight conditions (fltcond|q/rho/p/T/Utrue/Ueas/…) - aircraft design parameters (ac|*) - lift coefficient (fltcond|CL; either solved from steady flight or assumed during ground roll) - throttle - propulsor_failed (value 0 when failed, 1 when not failed)

and produce top-level outputs: - thrust - drag - weight

the following parameters need to either be defined as design variables or given as top-level analysis outputs from the airplane model: - ac|geom|S_ref - ac|aero|CL_max_flaps30 - ac|weights|MTOW

Inputs:

  • ac|* (various) – All relevant airplane design variables to pass to the airplane model

  • takeoff|h (float) – Takeoff and landing altitude (default 0 ft)

  • cruise|h0 (float) – Initial cruise altitude (default 28000 ft)

  • payload (float) – Mission payload (default 1000 lbm)

  • mission_range (float) – Design range (deault 1250 NM)

Options:

  • aircraft_model (class) – An aircraft model class with the standard OpenConcept interfaces promoted correctly

  • num_nodes (int) – Number of analysis points per phase. Higher is more accurate but more expensive

class openconcept.mission.profiles.BasicMission(**kwargs)

Bases: FullMissionWithReserve

This analysis group is set up to compute all the major parameters of a fixed wing mission, including climb, cruise, and descent but no Part 25 reserves To use this analysis, pass in an aircraft model following OpenConcept interface. Namely, the model should consume the following: - flight conditions (fltcond|q/rho/p/T/Utrue/Ueas/…) - aircraft design parameters (ac|*) - lift coefficient (fltcond|CL; either solved from steady flight or assumed during ground roll) - throttle - propulsor_failed (value 0 when failed, 1 when not failed) and produce top-level outputs: - thrust - drag - weight the following parameters need to either be defined as design variables or given as top-level analysis outputs from the airplane model: - ac|geom|S_ref - ac|aero|CL_max_flaps30 - ac|weights|MTOW

Inputs:

  • ac|* (various) – All relevant airplane design variables to pass to the airplane model

  • takeoff|h (float) – Takeoff and landing altitude (default 0 ft). However, if the ground roll is included it will always occur at 0 ft unless its fltcond|h is specifically set.

  • cruise|h0 (float) – Initial cruise altitude (default 28000 ft)

  • payload (float) – Mission payload (default 1000 lbm)

  • mission_range (float) – Design range (deault 1250 NM)

Options:

  • aircraft_model (class) – An aircraft model class with the standard OpenConcept interfaces promoted correctly

  • num_nodes (int) – Number of analysis points per phase. Higher is more accurate but more expensive

class openconcept.mission.profiles.FullMissionAnalysis(**kwargs)

Bases: FullMissionWithReserve

This analysis group is set up to compute all the major parameters of a fixed wing mission, including balanced-field takeoff, climb, cruise, and descent.

To use this analysis, pass in an aircraft model following OpenConcept interface. Namely, the model should consume the following: - flight conditions (fltcond|q/rho/p/T/Utrue/Ueas/…) - aircraft design parameters (ac|*) - lift coefficient (fltcond|CL; either solved from steady flight or assumed during ground roll) - throttle - propulsor_failed (value 0 when failed, 1 when not failed)

and produce top-level outputs: - thrust - drag - weight

the following parameters need to either be defined as design variables or given as top-level analysis outputs from the airplane model: - ac|geom|S_ref - ac|aero|CL_max_flaps30 - ac|weights|MTOW

Inputs:

  • ac|* (various) – All relevant airplane design variables to pass to the airplane model

  • takeoff|h (float) – WARNING: This parameter will set the landing altitude, but takeoff altitude will always be 0 ft unless specifically set in each takeoff phase’s fltcond|h value. However, even if you change this value, the climb phase will begin at the rotation phase’s obstacle height. Also, the rotation phase does it’s own thing (see the source to understand).

  • cruise|h0 (float) – Initial cruise altitude (default 28000 ft)

  • payload (float) – Mission payload (default 1000 lbm)

  • mission_range (float) – Design range (deault 1250 NM)

Outputs:

takeoff|v1 (float) – Decision speed

Options:

  • aircraft_model (class) – An aircraft model class with the standard OpenConcept interfaces promoted correctly

  • num_nodes (int) – Number of analysis points per phase. Higher is more accurate but more expensive

  • transition_method (str) – Analysis method to compute distance, altitude, and time during transition Default “simplified” is the Raymer circular arc method and is more robust Option “ode” is a 2DOF ODE integration method which is arguably just as inaccurate and less robust