This is the copyright work of The MITRE Corporation, and was produced for the U. S. Government under Contract Number DTFAWA-10-C-00080, and is subject to Federal Aviation Administration Acquisition Management System Clause 3.5-13, Rights In Data-General, Alt. III and Alt. IV (Oct. 1996). No other use other than that granted to the U. S. Government, or to those acting on behalf of the U. S. Government, under that Clause is authorized without the express written permission of The MITRE Corporation. For further information, please contact The MITRE Corporation, Contracts Office, 7515 Colshire Drive, McLean, VA 22102-7539, (703) 983-6000.
Copyright 2020 The MITRE Corporation. All Rights Reserved. Approved for Public Release; Distribution Unlimited. 15-1482
This project contains content developed by The MITRE Corporation. If this code is used in a deployment or embedded within another project, it is requested that you send an email to opensource@mitre.org in order to let us know where this software is being used.
Documentation is provided via two publications:
- Model technical documentation in form of a paper available from MITRE
- Official RTCA SC-186 documentation. In particular see DO-328B and DO-361A. Please contact RTCA for more information.
Any questions related to MITRE Open Source technologies may be emailed to opensource@mitre.org
This code uses EUROCONTROL's BADA for aircraft performance data that drive the aircraft dynamics modeling. However, BADA functionality and code cannot be provided due to licensing restrictions imposed by EUROCONTROL. Therefore, stub classes exist in this code repository that represent MITRE's suggested implementation in order to use this software. See Bada.cpp and BadaPerformanceCalculator.cpp. Please complete the implementation in these classes before using the code.
Log4Cplus is a logging application used by this code base. It needs to be installed prior to building this code. You can download it from their GitHub repo.
To view a successful build and any public-facing tests, please also refer to the Travis-CI job that is always building and testing this repo's master branch.
No attempt has been made to ensure that this code will compile on all operating systems. This code compiles successfully on Linux machines, specifically CentOs 7 using gcc 4.8.5. For all other computing environments, YMMV.
The CMake utility is used to compile this code. If not already installed on the target environment, it is easily installed via apt. Please use version 3.0+. From the root directory, execute:
>> mkdir build
>> cd build
>> cmake ..
>> make
The resulting executable will be found in /bin and is named FMACM.
Unit tests can be run via the CMake infrastructure.
Assuming the software already compiles:
>> cd build
>> make run
A configuration file must be provided as the only command-line argument to the FMACM program. The file must be formatted as plain text and contain paths to each scenario that is to be run. The contents of the configuration file must look like this:
# number of scenarios to run
2
# path to each scenario file, one per line, as many as the number above indicates
path/to/scenario.txt
path/to/scenario2.txt
Users may list as many scenario files as desired. The scenario file provides detailed instructions about the scenario that FMACM is to run. An example configuration and scenario file is provided in ./Run_Files/.
The executable is then executed in this manner:
./bin/FMACM configuration.txt
Output is found in the run-time directory.
The format of the horizontal flight path input file has changed since the last release. There is a new script to convert any files you may have in the old format:
./.python/convert_pre_april_2020_hfp_files.py
Navigate to the directory that you want your nex file to be generated in:
cd Run_Files/
Run the script with the path to the file you wish to convert, and the desired output filename as command line arguments:
../.python/convert_pre_april_2020_hfp_files.py path/to/input.csv output_filename