Usage Examples

Basic Usage

Get All Beluga Flights

Retrieve all currently tracked Beluga aircraft:

from pybelugaxl import get_beluga

flights = get_beluga()

for flight in flights:
    print(f"Aircraft: {flight.registration}")
    print(f"Route: {flight.from_airport} → {flight.to_airport}")
    print(f"Status: {flight.status}")
    print(f"Altitude: {flight.altitude} ft")
    print(f"Speed: {flight.ground_speed} kt")
    print(f"Position: {flight.position}")
    print("-" * 50)

Filtering Examples

Filter by Status

Get only aircraft that are currently flying:

from pybelugaxl import get_beluga

# Get only enroute flights
flying = get_beluga(status="enroute")

print(f"Found {len(flying)} aircraft in flight")
for flight in flying:
    print(f"{flight.registration} at {flight.altitude} ft")

Get aircraft on the ground:

# Get aircraft on ground
grounded = get_beluga(status="on_ground")

for flight in grounded:
    print(f"{flight.registration} at {flight.from_airport}")

Filter by Aircraft Registration

Track a specific Beluga by its registration:

from pybelugaxl import get_beluga

# Track F-GXLJ
flights = get_beluga(registration="F-GXLJ")

if flights:
    flight = flights[0]
    print(f"Found {flight.registration}")
    print(f"Current position: {flight.position}")
    print(f"Heading: {flight.heading}°")
else:
    print("Aircraft not currently tracked")

Filter by Airport

Find flights departing from a specific airport:

from pybelugaxl import get_beluga

# Flights from Toulouse Blagnac (LFBO)
toulouse_departures = get_beluga(from_airport_icao="LFBO")

for flight in toulouse_departures:
    print(f"{flight.registration}: LFBO → {flight.to_airport}")

Find flights arriving at a specific airport:

# Flights to Hamburg Finkenwerder (EDHI)
hamburg_arrivals = get_beluga(to_airport_icao="EDHI")

for flight in hamburg_arrivals:
    print(f"{flight.registration}: {flight.from_airport} → EDHI")
    print(f"ETA: {flight.eta}")