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
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.
Source Distribution
Built Distribution
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
Algorithm | Hash digest | |
---|---|---|
SHA256 | 31b45ca1521b212ef5ff6b0699cd464b8e6c84478989585e020ea4d15632eeb3 |
|
MD5 | 11ed7ff85c79b3a006cf78e75f1e7991 |
|
BLAKE2b-256 | fa84cc12829b5d5f9429f1e32b20b2a2e5d3beb90783cacfb4da7f29bae0891e |
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
Algorithm | Hash digest | |
---|---|---|
SHA256 | 5c544d1d0ba4e911856ddc4371d8237623dd07f3aa950bb2dcdd892333b41e91 |
|
MD5 | 44ea355fb6beb1468302dd23d1e1c70b |
|
BLAKE2b-256 | 76c19330e365b51722d2c1647452297f5dd716e2d735bfbf98dd185c847cb826 |