{"id":13798672,"url":"https://github.com/xoolive/traffic","last_synced_at":"2025-05-14T19:10:40.995Z","repository":{"id":37431092,"uuid":"127042768","full_name":"xoolive/traffic","owner":"xoolive","description":"A toolbox for processing and analysing air traffic data","archived":false,"fork":false,"pushed_at":"2025-05-01T23:59:58.000Z","size":155535,"stargazers_count":406,"open_issues_count":12,"forks_count":84,"subscribers_count":9,"default_branch":"master","last_synced_at":"2025-05-14T04:35:59.862Z","etag":null,"topics":["adsb","air-traffic-data","data-analytics","data-science","data-visualisation","declarative-pipeline","mode-s","trajectory"],"latest_commit_sha":null,"homepage":"https://traffic-viz.github.io/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/xoolive.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":"license.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2018-03-27T20:32:46.000Z","updated_at":"2025-05-07T01:49:24.000Z","dependencies_parsed_at":"2023-09-22T23:52:48.201Z","dependency_job_id":"4190aa08-a0e2-4014-9dc5-3efa90c105d1","html_url":"https://github.com/xoolive/traffic","commit_stats":{"total_commits":1464,"total_committers":38,"mean_commits":"38.526315789473685","dds":0.1359289617486339,"last_synced_commit":"47e6bed0a30bfa35efd5960d32defdb997227fbf"},"previous_names":[],"tags_count":27,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xoolive%2Ftraffic","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xoolive%2Ftraffic/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xoolive%2Ftraffic/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xoolive%2Ftraffic/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/xoolive","download_url":"https://codeload.github.com/xoolive/traffic/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254071527,"owners_count":22009804,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["adsb","air-traffic-data","data-analytics","data-science","data-visualisation","declarative-pipeline","mode-s","trajectory"],"created_at":"2024-08-04T00:00:49.299Z","updated_at":"2025-05-14T19:10:34.486Z","avatar_url":"https://github.com/xoolive.png","language":"Python","funding_links":[],"categories":["Tools and Libraries"],"sub_categories":[],"readme":"![A toolbox for processing and analysing air traffic data](./docs/_static/logo/logo_full.png)\n\n[![Documentation Status](https://github.com/xoolive/traffic/workflows/docs/badge.svg)](https://traffic-viz.github.io/)\n[![tests](https://github.com/xoolive/traffic/actions/workflows/run-tests.yml/badge.svg?branch=master\u0026event=push)](https://github.com/xoolive/traffic/actions/workflows/run-tests.yml)\n[![Code Coverage](https://img.shields.io/codecov/c/github/xoolive/traffic.svg)](https://codecov.io/gh/xoolive/traffic)\n[![Checked with mypy](https://img.shields.io/badge/mypy-checked-blue.svg)](https://mypy.readthedocs.io/)\n![License](https://img.shields.io/pypi/l/traffic.svg)  \n[![Join the chat at https://gitter.im/xoolive/traffic](https://badges.gitter.im/xoolive/traffic.svg)](https://gitter.im/xoolive/traffic?utm_source=badge\u0026utm_medium=badge\u0026utm_campaign=pr-badge\u0026utm_content=badge)\n![PyPI version](https://img.shields.io/pypi/v/traffic)\n[![PyPI downloads](https://img.shields.io/pypi/dm/traffic)](https://pypi.org/project/traffic)\n![Conda version](https://img.shields.io/conda/vn/conda-forge/traffic)\n[![Conda Downloads](https://img.shields.io/conda/dn/conda-forge/traffic.svg)](https://anaconda.org/conda-forge/traffic)  \n[![JOSS paper](http://joss.theoj.org/papers/10.21105/joss.01518/status.svg)](https://doi.org/10.21105/joss.01518)\n\nThe traffic library helps to work with common sources of air traffic data.\n\nIts 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.\n\nThe library also offers facilities to parse and/or access traffic data from open sources of ADS-B traffic like the [OpenSky Network](https://opensky-network.org/) or Eurocontrol DDR files. It is designed to be easily extendable to other sources of data.\n\nStatic visualization (images) exports are accessible via Matplotlib/Cartopy. More dynamic visualization frameworks are easily accessible in Jupyter environments with [ipyleaflet](http://ipyleaflet.readthedocs.io/) and [altair](http://altair-viz.github.io/); or through exports to other formats, including CesiumJS or Google Earth.\n\n## Installation\n\n**Full installation instructions are to be found in the [documentation](https://traffic-viz.github.io/installation.html).**\n\n- If you are not familiar/comfortable with your Python environment, please install the latest `traffic` release in a new, fresh conda environment.\n\n  ```sh\n  conda create -n traffic -c conda-forge python=3.12 traffic\n  ```\n\n- Adjust the Python version you need (\u003e=3.10) and append packages you need for working efficiently, such as Jupyter Lab, xarray, PyTorch or more.\n- Then activate the environment every time you need to use the `traffic` library:\n\n  ```sh\n  conda activate traffic\n  ```\n\n**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.**\n\nIf conda fails to resolve an environment in a reasonable time, consider using a [Docker image](https://traffic-viz.github.io/user_guide/docker.html) with a working installation.\n\nFor troubleshooting, refer to the appropriate [documentation section](https://traffic-viz.github.io/troubleshooting/installation.html).\n\n## Credits\n\n[![JOSS\nbadge](http://joss.theoj.org/papers/10.21105/joss.01518/status.svg)](https://doi.org/10.21105/joss.01518)\n\n- Like [other researchers before](https://scholar.google.com/scholar?cites=18420568209924139259\u0026scisbd=1), if you find this project useful for your research and use it in an academic work, you may cite it as:\n\n  ```bibtex\n  @article{olive2019traffic,\n      author={Xavier {Olive}},\n      journal={Journal of Open Source Software},\n      title={traffic, a toolbox for processing and analysing air traffic data},\n      year={2019},\n      volume={4},\n      pages={1518},\n      doi={10.21105/joss.01518},\n      issn={2475-9066},\n  }\n  ```\n\n- 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.\n\n## Documentation\n\n[![Documentation Status](https://github.com/xoolive/traffic/workflows/docs/badge.svg)](https://traffic-viz.github.io/)\n[![Join the chat at https://gitter.im/xoolive/traffic](https://badges.gitter.im/xoolive/traffic.svg)](https://gitter.im/xoolive/traffic?utm_source=badge\u0026utm_medium=badge\u0026utm_campaign=pr-badge\u0026utm_content=badge)\n\nDocumentation available at \u003chttps://traffic-viz.github.io/\u003e  \nJoin the Gitter chat for assistance: https://gitter.im/xoolive/traffic\n\n## Tests and code quality\n\n[![tests](https://github.com/xoolive/traffic/actions/workflows/run-tests.yml/badge.svg?branch=master\u0026event=push)](https://github.com/xoolive/traffic/actions/workflows/run-tests.yml)\n[![Code Coverage](https://img.shields.io/codecov/c/github/xoolive/traffic.svg)](https://codecov.io/gh/xoolive/traffic)\n[![Codacy Badge](https://img.shields.io/codacy/grade/eea673ed15304f1b93490726295d6de0)](https://www.codacy.com/manual/xoolive/traffic)\n[![Checked with mypy](https://img.shields.io/badge/mypy-checked-blue.svg)](https://mypy.readthedocs.io/)\n\nUnit and non-regression tests are written in the `tests/` directory. You may run `pytest` from the root directory.\n\nTests are checked on [Github Actions](https://github.com/xoolive/traffic/actions/workflows/run-tests.yml) platform upon each commit. Latest status and coverage are displayed with standard badges hereabove.\n\nIn addition to unit tests, code is checked against:\n\n- linting and formatting with [ruff](https://beta.ruff.rs/docs/);\n- static typing with [mypy](https://mypy.readthedocs.io/)\n\n[pre-commit](https://pre-commit.com/) hooks are available in the repository.\n\n## Feedback and contribution\n\nAny input, feedback, bug report or contribution is welcome.\n\n- Should you encounter any [issue](https://github.com/xoolive/traffic/issues/new), you may want to file it in the [issue](https://github.com/xoolive/traffic/issues/new) section of this repository.\n- If you intend to [contribute to traffic](https://traffic-viz.github.io/installation.html#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](https://traffic-viz.github.io/installation.html#contribute-to-traffic) in the documentation.\n\n  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.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxoolive%2Ftraffic","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fxoolive%2Ftraffic","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxoolive%2Ftraffic/lists"}