Skip to main content

AeroSCOPE: Exploring Aviation Flows

Project description

Welcome

AeroSCOPE is a project that aims to bring together various open data sources on air transport in order to better understand the geographical distribution of air transport. More details on data collection and compilation can be found in the article accompanying this work: https://journals.open.tudelft.nl/joas/article/view/7201

AeroSCOPE is licensed under the GPL-3.0 license.
Please contact us if your use case of the dataset it outside the academic framework: Although all sources used are open to everyone, the Eurocontrol database is only freely available to academic researchers. It is used in this dataset in a very aggregated way and under several levels of abstraction. As a result, it is not distributed in its original format as specified in the contract of use. As a general rule, we decline any responsibility for any use that is contrary to the terms and conditions of the various sources that are used. In case of commercial use of the database, please contact us in advance.

Setup - app only

It is suggested to use a new conda virtual environment to install the required packages. Python 3.10 is recommended, although older versions may work.

In the new virtual environment, navigate to the project folder. Most installations are done using poetry, except for poetry itself, which can be installed using pip or conda.

pip install aeroscope

Usage

AeroSCOPE can be used in two different ways.

  • Simple usage: just using the graphical interface or downloading the final database, no external input is required. This use case is directly addressed to this repository.
  • Advanced usage: to run all data collection and processing notebooks and to perform more complex analysis on the file. The GUI is an input to this mode (soon). External data inputs that are too large to be stored on git or whose distribution is restricted are required. This mode is described in https://github.com/AeroMAPS/AeroSCOPE_dataset.

Please read the dedicated paper to understand the global data collection and aggregation process.
The idea behind the project is to collect all open-source air traffic data to build an extended air traffic route database for a given year, 2019.
Due to the limited coverage of these sources, especially in Asia-Pacific, South America and Africa, a methodology has been developed to estimate the data in this case. Wikipedia airport pages are automatically parsed to find information on the route network from each airport. This newly created database is merged with the previously mentioned open source data and a regressor is trained. Traffic (seats offered) is then estimated on the remaining routes before all sources are aggregated into a single file. It is then analysed and can be explored using a simple user interface.

Simple usage

AeroSCOPE app: To run the simple web app designed to explore the data, one can either visit www.aeromaps.eu/aeroscope (soon) or navigate to the 04_app folder using a terminal and run the app using voila.

aeroscope run

Advanced usage

This mode is described in https://github.com/AeroMAPS/AeroSCOPE_dataset.

Raw database csv file: If you simply want to access the compiled database; The last version of the processed database is stored on zenodo under the following doi: 10.5281/zenodo.10143773. Make sure to download v1.0.1.
Be sure to replace default NaN (such as 'NA') when reading the csv, to avoid mistakingly considering North America and Namibia codes as NaN.

Authors

Antoine Salgas, Junzi Sun, Scott Delbecq, Thomas Planès
Contact: [antoine.salgas@isae-supaero.fr]

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

aeroscope-0.2.3b0.tar.gz (127.4 MB view details)

Uploaded Source

Built Distribution

aeroscope-0.2.3b0-py3-none-any.whl (127.4 MB view details)

Uploaded Python 3

File details

Details for the file aeroscope-0.2.3b0.tar.gz.

File metadata

  • Download URL: aeroscope-0.2.3b0.tar.gz
  • Upload date:
  • Size: 127.4 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.4.1 CPython/3.9.10 Darwin/23.5.0

File hashes

Hashes for aeroscope-0.2.3b0.tar.gz
Algorithm Hash digest
SHA256 31b45ca1521b212ef5ff6b0699cd464b8e6c84478989585e020ea4d15632eeb3
MD5 11ed7ff85c79b3a006cf78e75f1e7991
BLAKE2b-256 fa84cc12829b5d5f9429f1e32b20b2a2e5d3beb90783cacfb4da7f29bae0891e

See more details on using hashes here.

File details

Details for the file aeroscope-0.2.3b0-py3-none-any.whl.

File metadata

  • Download URL: aeroscope-0.2.3b0-py3-none-any.whl
  • Upload date:
  • Size: 127.4 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.4.1 CPython/3.9.10 Darwin/23.5.0

File hashes

Hashes for aeroscope-0.2.3b0-py3-none-any.whl
Algorithm Hash digest
SHA256 5c544d1d0ba4e911856ddc4371d8237623dd07f3aa950bb2dcdd892333b41e91
MD5 44ea355fb6beb1468302dd23d1e1c70b
BLAKE2b-256 76c19330e365b51722d2c1647452297f5dd716e2d735bfbf98dd185c847cb826

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page