A toolbox for manipulating and analysing air traffic data
Project description
A toolbox for processing and analysing air traffic data
The traffic library helps working with common sources of air traffic data.
Its main purpose is to offer basic cumbersome data analysis methods commonly applied to trajectories and ATC sectors. When a specific function is not provided, the access to the underlying structure is direct, through an attribute pointing to a pandas dataframe.
The library also offers facilities to parse and/or access traffic data from open sources of ADS-B traffic like the OpenSky Network or Eurocontrol DDR files. It is designed to be easily extendable to other sources of data.
Static visualisation (images) exports are accessible via Matplotlib/Cartopy. More dynamic visualisation frameworks are easily accessible in Jupyter environments with ipyleaflet and altair; or through exports to other formats, including CesiumJS or Google Earth.
Installation
Latest release:
pip install traffic
Development version:
pip install git+https://github.com/xoolive/traffic
Warning: cartotools
and shapely
have strong dependencies to dynamic
libraries which may not be available on your system by default.
Before reporting an issue, please try to use an Anaconda environment. Other
installations (You may check them in the .travis.yml
configuration file.)
should work but the Anaconda way proved to work smoothly.
conda install cartopy shapely
Documentation
Documentation available at https://travis-viz.github.io/
Command line tool
The traffic
tool scripts around the library for common usecases.
The most basic use case revolves around exploring the embedded data. You may check
the help with traffic data -h
.
traffic data -p Tokyo
altitude country iata icao latitude longitude name
3820 21 Japan HND RJTT 35.552250 139.779602 Tokyo Haneda International Airport
3821 135 Japan NRT RJAA 35.764721 140.386307 Tokyo Narita International Airport
More details in the documentation.
Graphical user interface
A Qt application is provided for exploring and recording data.
More details in the GUI section of the documentation.
Feedback and contribution
Any input, feedback, bug report or contribution is welcome.
Should you encounter any issue, you may want to file it in the issue section of this repository. Please first activate the DEBUG
messages recorded using Python logging mechanism with the following snippet:
from traffic.core.logging import loglevel
loglevel('DEBUG')
Bug fixes and improvements in the library are also helpful.
If you share a fix together with the issue, I can include it in the code for you. But since you did the job, pull requests (PR) let you keep the authorship on your additions. For details on creating a PR see GitHub documentation Creating a pull request. You can add more details about your example in the PR such as motivation for the example or why you thought it would be a good addition. You will get feed back in the PR discussion if anything needs to be changed. To make changes continue to push commits made in your local example branch to origin and they will be automatically shown in the PR.
You may find the process troublesome but please keep in mind it is actually easier that way to keep track of corrections and to remember why things are the way they are.
Frequently asked questions
- I like your work, it is helpful. How should I cite it in my academic paper?
A proper publication introducting the library is under preparation. Please come back here when you are ready to submit. If it is not ready, a word of acknowledgement is appreciated. You may also want to consider starring this github repository.
- I want to know more about Eurocontrol NM files
We download those files from Eurocontrol Network Manager DDR2 repository service under Dataset Files > Airspace Environment Datasets. You may not be entitled access to those data.
Should you have no such access, basic FIRs are provided in eurofirs
from
traffic.data
.
- I want to know more about Eurocontrol AIXM files
When you import aixm_airspaces
from traffic.data
, you need to set a path to
a directory containing AIRAC files. These are XML files following the
AIXM standard and produced by Eurocontrol. We download
those files from Eurocontrol Network Manager B2B web
service.
You may not be entitled access to those data.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.