Metadata-Version: 2.1
Name: OverflightSimulator
Version: 1.1.0.1
Summary: A collection of code to employ the Battlefield Acoustic Software to simulate the acoustic levels from a known flight track to a specific location.
Keywords: machine learning,audio
Author-Email: frankmobley <mobssoft@gmail.com>, "Dr. Frank Mobley" <frank.mobley.1@afrl.af.mil>
License: MIT
Requires-Python: >=3.8
Requires-Dist: numpy>=1.21.5
Requires-Dist: batts_coordinate_base>=1.0.8
Requires-Dist: batts_mathematics>=1.0.8
Requires-Dist: batts_measurable_objects>=1.0.8
Requires-Dist: batts_geospatial>=1.0.8
Requires-Dist: batts_physical_acoustics>=1.0.8
Requires-Dist: batts_acoustic_sources>=1.0.8
Requires-Dist: pytimbre>=1.0.2
Description-Content-Type: text/markdown



# OverflightSimulator

The requirement to define acoustic levels from a flight track to a known location is vital for the creation of training and testing datasets for machine learning in the detection and classification of small unmanned aircraft systems (SUAS). This code incorporates the variety of acoustic losses that are found within the suite of Python codes associated with the Battlefield Acoustic Tactical Technology Software.

This code provides a method to take in a __Trajectory__ file and determine the acoustic losses from each point in the trajectory to a known __GeodeticCoordinate__, or the receiver. The methods within this class calculate:
- Spherical spreading
- Atmospheric absorption
- Excess ground attenuation

The velocity component of the __TrajectoryPoint__ elements of the __Trajectory__ define the change in frequency as the aircraft passes near the receiver location. 

To generate a simulated flyover, a __stationary__ auditory measurement is provided to the class. It will extend the reference audio so that it is the same duration as the flight track and then apply the various frequency filters and temporal shifting to simulate the overflight.

This code was cleared for public release on 20 May 2025 with number AFRL-2026-1081.