Scenarios

Default scenarios are available via the Simulator class constructor:

from bluebird_dt.simulator import Simulator

sim = Simulator.from_category("Artificial", "I-Sector Two Aircraft")

but more control is available by using a scenario manager as a simulator constructor.

Two Aircraft

This scenario has two aircraft approaching one another from opposite sides of the sector. Each aircraft can be a "climber", "descender" or "overflight".

It can easily be initialised using

from bluebird_dt.simulator import Simulator

sim = Simulator.from_category("Artificial", "I-Sector Two Aircraft")

or, for more control over the scenario

from bluebird_dt.scenario_manager import TwoAircraft
from bluebird_dt.airspace_generator import SectorX

airspace, routes = SectorX(
    width=20,
    height=60,
    fl_limits=(200, 300),
    alpha=52.5,
).generate_airspace()


sim = TwoAircraft(airspace=airspace, routes=routes, total_time=1200, scenario_type="climber").to_simulator()

See the source code reference for documentation on all the parameters which could be passed in.

Infinite

Unlike the other scenario generators that run for a specified length of time, the Infinite scenarios will go on indefinitely, with aircraft spawning stochastically at a given average frequency on randomly chosen routes. Optionally, the user can ramp up the spawning frequency by a set interval after set periods of time, up to a specified maximum frequency.

It can easily be initialised using

from bluebird_dt.simulator import Simulator

sim = Simulator.from_category("Infinite", "X-Sector")

or, for more control over the scenario

from bluebird_dt.scenario_manager import Infinite
from bluebird_dt.airspace_generator import SectorX

airspace, routes = SectorX(
    width=20,
    height=60,
    fl_limits=(200, 300),
    alpha=52.5,
).generate_airspace()


sim = Infinite(
    airspace=airspace,
    routes=routes,
    initial_spawn_rate=0.005,
    max_spawn_rate=0.2,
    spawn_rate_increment=0.005,
    spawn_rate_increase_interval=60,
).to_simulator()

See the source code reference for documentation on all the parameters which could be passed in.

Springfield

Springfield is a realistic (though fictional) sector with a more complex route structure than X-Plus. The Springfield scenario manager does not provide additional configuration options, therefore it is simplest to start it directly from the simulator.

from bluebird_dt.scenario_manager import SpringfieldScenarioManager
from bluebird_dt.simulator import Simulator
import random

scenario_name = random.choice(SpringfieldScenarioManager.list_scenarios())
sim = Simulator.from_category("Springfield", scenario_name)

Regular

The user can specify the total time and the number of aircraft for the scenario, and the aircraft will be emitted from route start points, quasi-regularly spaced out in time.

It can easily be initialised using

from bluebird_dt.scenario_manager import Regular
from bluebird_dt.airspace_generator import SectorX

airspace, routes = SectorX(
    width=20,
    height=60,
    fl_limits=(200, 300),
    alpha=52.5,
).generate_airspace()


sim = Regular(
    airspace=airspace,
    routes=routes,
    total_time=1200,
    num_aircraft=20,
)

See the source code reference for documentation on all the parameters which could be passed in.