https://github.com/mitre/fmacm
An aircraft and control model for Flight Deck Interval Management MOPS testing by RTCA SC-186 members.
https://github.com/mitre/fmacm
aircraft-simulation c-plus-plus control-systems eurocontrol eurocontrol-bada mitre-corporation
Last synced: 5 days ago
JSON representation
An aircraft and control model for Flight Deck Interval Management MOPS testing by RTCA SC-186 members.
- Host: GitHub
- URL: https://github.com/mitre/fmacm
- Owner: mitre
- License: apache-2.0
- Created: 2015-05-07T14:49:02.000Z (almost 10 years ago)
- Default Branch: master
- Last Pushed: 2024-04-16T19:38:30.000Z (about 1 year ago)
- Last Synced: 2025-04-01T14:22:23.319Z (25 days ago)
- Topics: aircraft-simulation, c-plus-plus, control-systems, eurocontrol, eurocontrol-bada, mitre-corporation
- Language: C++
- Homepage: https://mitre.github.io/FMACM/
- Size: 2.69 MB
- Stars: 11
- Watchers: 12
- Forks: 5
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://travis-ci.org/mitre/FMACM)
[](https://codecov.io/gh/mitre/fmacm)
# NOTICE
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 [email protected] in order to let us know where this software is being used.
# Licensing
[Apache 2.0](https://github.com/mitre/FMACM/blob/master/LICENSE)
# Documentation
Documentation is provided via two publications:
- Model [technical documentation](https://www.mitre.org/publications/technical-papers/derivation-of-a-point-mass-aircraft-model-used-for-fast-time) in form of a paper available from MITRE
- Official [RTCA SC-186](http://www.rtca.org/content.asp?pl=108&sl=33&contentid=88) documentation. In particular see DO-328B and DO-361A. Please contact RTCA for more information.
# Licensing questions
Any questions related to MITRE Open Source technologies may be emailed to [email protected]
# Developer Notice
### EUROCONTROL BADA Development Necessary
This code uses [EUROCONTROL's BADA](https://eurocontrol.int/services/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 Dependency
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](https://github.com/log4cplus/log4cplus).
### Continuous Integration & Testing
To view a successful build and any public-facing tests, please also refer to the [Travis-CI job](https://travis-ci.org/mitre/FMACM) that is always building and testing this repo's master branch.
### Compile
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](https://www.centos.org/) 7 using gcc 4.8.5. For all other computing environments, YMMV.
The [CMake](https://cmake.org/) 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`.
### Run Unit Tests
Unit tests can be run via the CMake infrastructure.
Assuming the software already compiles:
```
>> cd build
>> make run
```
### 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.
### Inputs
The format of the [horizontal flight path](../Run_Files/FimAcTv-P~W_JET_HFP.csv) 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
```