The Python Library roc is a software package developed by UC3M. It is a tool for robust flight planning considering the concept of free-routing airspace. The main features of roc are: 1) integrates horizontal and vertical decision-making, 2) incorporates uncertainty in meteorological variables. In addition, roc is very generic in terms of flight planning objectives. For instance, it can be used to optimize aircraft trajectory w.r.t minimum flight time, minimum fuel burn, minimum operating cost, and minimum climate impact.
License: roc is released under GNU Lesser General Public License v3.0 (LGPLv3).
Support: Support of all general technical questions on roc, i.e., installation, application, and development, will be provided by Abolfazl Simorgh (abolfazl.simorgh@uc3m.es).
Core developer team: Daniel González Arribas, Abolfazl Simorgh, and Manuel Soler.
Copyright (C) 2022, Universidad Carlos III de Madrid
Ref 1: Simorgh, A., Soler, M., Dietmuller, S., Matthes, S., Yamashita, H., Castino, F., Yin, F. (2024). Robust 4D climate-optimal aircraft trajectory planning under weather-induced uncertainties: free-routing airspace. Transportation Research Part D, 131.
Ref 2: Simorgh, A., Soler, M., Castino, F., Yin, F., Cerezo-Magaña, M. (2024). Concept of robust climate-friendly flight planning under multiple climate impact estimates. Transportation Research Part D, 131.
Ref 3: González-Arribas, D., Soler, M., & Sanjurjo-Rivo, M. (2018). Robust aircraft trajectory planning under wind uncertainty using optimal control. Journal of Guidance, Control, and Dynamics, 41(3), 673-688.
The installation is the first step to start working with roc. In the following, the steps required to install the library are provided.
- It is highly recommended to create a virtual environment (e.g., roc):
conda create -n env_roc python=3.9
conda activate env_roc-
Clone or download the repository. The roost source code is available on a public GitHub repository: https://github.com/Abolfazl-Simorgh/roc. The easiest way to obtain it is to clone the repository using git: git clone https://github.com/Abolfazl-Simorgh/roc.git.
-
Locate yourself in the roost (library folder) path, and run the following line, using terminal (MacOS and Linux) or cmd (Windows), which will install all dependencies:
python setup.py installit will install all the required dependencies.
There is a script in the test folder of the library, test.py, which provides a sample to get started with the library. This sample file contains comments explaining the required inputs, problem configurations, objective function selection (which includes flight planning objectives), optimization configurations, running, and output files. Notice that we use BADA4.2 to represent the aerodynamic and propulsive performance of the aircraft. Due to restrictions imposed by the BADA license, the current version on GitHub is incomplete, as two Python scripts related to the used aircraft performance model have been excluded (i.e., bada4.py and apm.py). Therefore, users need to define and input an aircraft performance model to the rfp.py module to work with the current library version. We are currently assessing the existing open-source aircraft performance models in order to make the complete library available to the public.