traffic, a toolbox for processing and analysing air traffic data

traffic, a toolbox for processing and analysing air traffic data - Published in JOSS (2019)

https://github.com/xoolive/traffic

Science Score: 95.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
    Found 8 DOI reference(s) in README and JOSS metadata
  • Academic publication links
    Links to: scholar.google, joss.theoj.org
  • Committers with academic emails
    3 of 38 committers (7.9%) from academic institutions
  • Institutional organization owner
  • JOSS paper metadata
    Published in Journal of Open Source Software

Keywords

adsb air-traffic-data data-analytics data-science data-visualisation declarative-pipeline mode-s trajectory

Keywords from Contributors

pde standardization turing-machine pypi genetic-algorithm energy-system plasma benchmarking hydrology distribution

Scientific Fields

Earth and Environmental Sciences Physical Sciences - 87% confidence
Artificial Intelligence and Machine Learning Computer Science - 83% confidence
Political Science Social Sciences - 67% confidence
Last synced: 4 months ago · JSON representation

Repository

A toolbox for processing and analysing air traffic data

Basic Info
Statistics
  • Stars: 430
  • Watchers: 10
  • Forks: 87
  • Open Issues: 10
  • Releases: 26
Topics
adsb air-traffic-data data-analytics data-science data-visualisation declarative-pipeline mode-s trajectory
Created almost 8 years ago · Last pushed 4 months ago
Metadata Files
Readme License

readme.md

A toolbox for processing and analysing air traffic data

Documentation Status tests Code Coverage Checked with mypy License
Join the chat at https://gitter.im/xoolive/traffic PyPI version PyPI downloads Conda version Conda Downloads
JOSS paper

The traffic library helps to work with common sources of air traffic data.

Its main purpose is to provide data analysis methods commonly applied to trajectories and airspaces. 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 visualization (images) exports are accessible via Matplotlib/Cartopy. More dynamic visualization frameworks are easily accessible in Jupyter environments with ipyleaflet and altair; or through exports to other formats, including CesiumJS or Google Earth.

Installation

Full installation instructions are to be found in the documentation.

  • If you are not familiar/comfortable with your Python environment, please install the latest traffic release in a new, fresh conda environment.

sh conda create -n traffic -c conda-forge python=3.12 traffic

  • Adjust the Python version you need (>=3.10) and append packages you need for working efficiently, such as Jupyter Lab, xarray, PyTorch or more.
  • Then activate the environment every time you need to use the traffic library:

sh conda activate traffic

Warning! Dependency resolution may be tricky, esp. if you use an old conda environment where you overwrote conda libraries with pip installs. Please only report installation issues in new, fresh conda environments.

If conda fails to resolve an environment in a reasonable time, consider using a Docker image with a working installation.

For troubleshooting, refer to the appropriate documentation section.

Credits

JOSS
badge

  • Like other researchers before, if you find this project useful for your research and use it in an academic work, you may cite it as:

bibtex @article{olive2019traffic, author={Xavier {Olive}}, journal={Journal of Open Source Software}, title={traffic, a toolbox for processing and analysing air traffic data}, year={2019}, volume={4}, pages={1518}, doi={10.21105/joss.01518}, issn={2475-9066}, }

  • Additionally, you may consider adding a star to the repository. This token of appreciation is often interpreted as positive feedback and improves the visibility of the library.

Documentation

Documentation Status Join the chat at https://gitter.im/xoolive/traffic

Documentation available at https://traffic-viz.github.io/
Join the Gitter chat for assistance: https://gitter.im/xoolive/traffic

Tests and code quality

tests Code Coverage Codacy Badge Checked with mypy

Unit and non-regression tests are written in the tests/ directory. You may run pytest from the root directory.

Tests are checked on Github Actions platform upon each commit. Latest status and coverage are displayed with standard badges hereabove.

In addition to unit tests, code is checked against:

  • linting and formatting with ruff;
  • static typing with mypy

pre-commit hooks are available in the repository.

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.
  • If you intend to contribute to traffic or file a pull request, the best way to ensure continuous integration does not break is to reproduce an environment with the same exact versions of all dependency libraries. Please follow the appropriate section in the documentation.

Let us know what you want to do just in case we're already working on an implementation of something similar. This way we can avoid any needless duplication of effort. Also, please don't forget to add tests for any new functions.

Owner

  • Name: Xavier Olive
  • Login: xoolive
  • Kind: user
  • Location: Toulouse, France
  • Company: Research Scientist

I like maps 🌍, code 🐍 and data visualisation 😎. I keep an eye on anything that can fly 🛩️.

JOSS Publication

traffic, a toolbox for processing and analysing air traffic data
Published
July 05, 2019
Volume 4, Issue 39, Page 1518
Authors
Xavier Olive ORCID
ONERA, Université de Toulouse, France
Editor
Daniel S. Katz ORCID
Tags
trajectory ADS-B Mode S air traffic management data visualisation

Papers & Mentions

Total mentions: 1

Analysis of Intelligent Transportation Systems Using Model-Driven Simulations
Last synced: 3 months ago

GitHub Events

Total
  • Create event: 15
  • Release event: 4
  • Issues event: 17
  • Watch event: 55
  • Delete event: 14
  • Issue comment event: 57
  • Push event: 83
  • Pull request review comment event: 2
  • Pull request review event: 3
  • Pull request event: 46
  • Fork event: 9
Last Year
  • Create event: 15
  • Release event: 4
  • Issues event: 17
  • Watch event: 55
  • Delete event: 14
  • Issue comment event: 57
  • Push event: 83
  • Pull request review comment event: 2
  • Pull request review event: 3
  • Pull request event: 46
  • Fork event: 9

Committers

Last synced: 5 months ago

All Time
  • Total Commits: 1,529
  • Total Committers: 38
  • Avg Commits per committer: 40.237
  • Development Distribution Score (DDS): 0.115
Past Year
  • Commits: 76
  • Committers: 11
  • Avg Commits per committer: 6.909
  • Development Distribution Score (DDS): 0.25
Top Committers
Name Email Commits
Xavier Olive g****t@x****g 1,353
dependabot[bot] 4****] 46
Enrico Spinielli e****i@g****m 19
Benoit Figuet 3****e 15
Luis Basora l****a@o****r 12
Junzi Sun j****n@g****m 8
Michel Khalaf K****8@g****m 7
Simon Proud s****d@p****k 7
Stanley F s****r@g****m 6
rmonstein 4****n 5
antoine a****t@f****r 5
Kim Gaume 3****r 4
Adrien Lafage a****e@o****m 3
RaphaelDELAIR 7****R 3
ViryBe b****y@l****t 3
niclaswue 1****e 3
Aliaksei Pilko a****5 2
ElSabio97 4****7 2
Jaime Bowen j****v@g****m 2
Jeremy Grignard j****d@p****u 2
Manuel Derra 3****a 2
Maxime Warnier m****x@g****m 2
renovate[bot] 2****] 2
Timothé Krauth 7****W 2
q-wertz c****r@w****e 1
Axel Tanner a****t@a****g 1
Valentin Courchelle v****e@h****r 1
mora m****a@z****h 1
krumjan 1****n 1
Ysbrand van Eijck y****r@h****m 1
and 8 more...
Committer Domains (Top 20 + Academic)

Issues and Pull Requests

Last synced: 4 months ago

All Time
  • Total issues: 36
  • Total pull requests: 221
  • Average time to close issues: 7 months
  • Average time to close pull requests: 12 days
  • Total issue authors: 20
  • Total pull request authors: 17
  • Average comments per issue: 2.58
  • Average comments per pull request: 0.95
  • Merged pull requests: 79
  • Bot issues: 0
  • Bot pull requests: 160
Past Year
  • Issues: 11
  • Pull requests: 38
  • Average time to close issues: 4 days
  • Average time to close pull requests: 13 days
  • Issue authors: 7
  • Pull request authors: 12
  • Average comments per issue: 3.55
  • Average comments per pull request: 0.95
  • Merged pull requests: 30
  • Bot issues: 0
  • Bot pull requests: 9
Top Authors
Issue Authors
  • xoolive (6)
  • iavrekh (4)
  • simonrp84 (4)
  • niclaswue (4)
  • espinielli (2)
  • junzis (2)
  • q-wertz (1)
  • jsmailes (1)
  • mdlugosz-agh (1)
  • HWJ-NUMPY (1)
  • rmonstein (1)
  • cpt13-g (1)
  • nmatton (1)
  • raph-p (1)
  • JoScheiderer (1)
Pull Request Authors
  • dependabot[bot] (201)
  • figuetbe (26)
  • xoolive (18)
  • niclaswue (6)
  • Vibujor (5)
  • junzis (5)
  • renovate[bot] (4)
  • aeroevan (4)
  • espinielli (3)
  • Julien6431 (2)
  • ipato9 (2)
  • goncaloroque30 (2)
  • kruuZHAW (2)
  • richardalligier (2)
  • sfo (2)
Top Labels
Issue Labels
bug (22) enhancement (10) documentation (4) good first issue (3)
Pull Request Labels
dependencies (201) python (178) github_actions (23)

Packages

  • Total packages: 2
  • Total downloads:
    • pypi 2,070 last-month
  • Total dependent packages: 0
    (may contain duplicates)
  • Total dependent repositories: 11
    (may contain duplicates)
  • Total versions: 36
  • Total maintainers: 1
pypi.org: traffic

A toolbox for manipulating and analysing air traffic data

  • Versions: 29
  • Dependent Packages: 0
  • Dependent Repositories: 10
  • Downloads: 2,070 Last month
Rankings
Stargazers count: 3.5%
Dependent repos count: 4.6%
Forks count: 5.0%
Average: 7.2%
Dependent packages count: 10.1%
Downloads: 12.9%
Maintainers (1)
Last synced: 4 months ago
conda-forge.org: traffic
  • Versions: 7
  • Dependent Packages: 0
  • Dependent Repositories: 1
Rankings
Forks count: 22.2%
Stargazers count: 23.1%
Dependent repos count: 24.4%
Average: 30.3%
Dependent packages count: 51.6%
Last synced: 4 months ago

Dependencies

.github/workflows/build-docs.yml actions
  • actions/cache v3 composite
  • actions/checkout v3 composite
  • actions/setup-python v4 composite
  • peaceiris/actions-gh-pages v3 composite
  • snok/install-poetry v1.3.3 composite
.github/workflows/pypi-publish.yml actions
  • actions/checkout v3 composite
  • actions/setup-python v4 composite
  • pypa/gh-action-pypi-publish release/v1 composite
  • snok/install-poetry v1.3.3 composite
.github/workflows/run-docker.yml actions
  • actions/checkout v3 composite
  • docker/login-action v2 composite
.github/workflows/run-tests.yml actions
  • actions/cache v3 composite
  • actions/checkout v3 composite
  • actions/setup-python v4 composite
  • codecov/codecov-action v3 composite
  • snok/install-poetry v1.3.3 composite
poetry.lock pypi
  • 214 dependencies
pyproject.toml pypi
  • Sphinx >=5.1 develop
  • altair-saver >=0.5.0 develop
  • black >=21.6 develop
  • codecov >=2.1.11 develop
  • flake8 >=5.0 develop
  • isort >=5.9.1 develop
  • jupyter_sphinx >=0.3.2 develop
  • mypy >=0.981 develop
  • pre-commit >=2.13.0 develop
  • pytest >=7.1 develop
  • pytest-cov >=4.0 develop
  • pytest-timeout >=2.1 develop
  • requests >=2.27 develop
  • sphinx-autodoc-typehints >=1.17,!=1.21.4 develop
  • sphinx-rtd-theme >=0.5.2 develop
  • types-flask >=1.1.6 develop
  • types-paramiko >=0.1.7 develop
  • types-pkg-resources >=0.1.3 develop
  • types-pyOpenSSL >=22.0 develop
  • types-requests >=2.25.0 develop
  • types-waitress >=2.0.8 develop
  • Flask >=2.1.1
  • Flask-Cors >=3.0.10
  • astor ^0.8.1
  • cartes >=0.7.4
  • click >=8.1
  • fastparquet >=0.7
  • ipyleaflet >=0.17
  • ipywidgets >=7.6
  • libarchive >=0.4.7,<1.0.0
  • metar >=1.8
  • onnxruntime >=1.12
  • openap >=1.1
  • paramiko >=2.7
  • pyModeS ^2.14
  • pyOpenSSL >=22.0
  • pyrtlsdr ^0.2.93
  • pyspark >=3.3.0
  • python >=3.8,<4.0
  • requests >=2.27
  • requests-pkcs12 >=1.10
  • scikit-learn >=1.0
  • textual >=0.1.17
  • typing-extensions >=4.2
  • waitress >=2.1.1
  • xarray >=0.18.2