Differences

This shows you the differences between two versions of the page.

--- atmos:pestiside:lead_sampling [2026/06/08 20:14] – Added documentation on lead analysis code. halmos
+++ atmos:pestiside:lead_sampling [2026/06/08 20:52] (current) – halmos
@@ Line 9: / Line 9: @@
 ===Software Documentation===
-Code written in Python is being developed to analyze data files obtained by the Aviation department. To view the code, make sure you have the latest revision of ADPAA. The files can be found in src/airport/. In this folder, you will find subfolders depending on the data analysis you would like to perform.
+Code written in Python is being developed to analyze data files obtained by the Aviation department. To view the code, make sure you have the latest revision of ADPAA. The files can be found in ADPAA/src/airport/. In this folder, you will find subfolders depending on the data analysis you would like to perform.
 ==Extracting Aircraft Data Files==
@@ Line 23: / Line 23: @@
 Analysis of boundary layer data can be performed by running the boundary_master.py file. Ensure that you have an API key with the ECMWF. For more information on the setup of the API key visit: https://cds.climate.copernicus.eu/how-to-api.
 The boundary master file calls 3 different files: boundary_layer_api.py, boundary_grib.py, and boundary_boxplot.py.
+==Visualizing Aircraft Data==
+Code used to visualize aircraft data is located in ADPAA/src/airport/und_kml. In this folder, there are 2 files: aircraft_kml_bl.py and aircraft_kml.py.
+aircraft_kml.py loops through csv files in the current working directory and creates an individual kml file for each aircraft, which can be loaded into software such as Google Earth to visualize where flights go in a 3D space. The kml files include time-series data, so it is possible to create a short GIF of how aircraft move throughout the area over time. Currently, this time series data is limited in functionality using Google Earth. When viewing hundreds of files over a 24 hour period, the program only displays aircraft movement over 20 minute intervals. In the future, code will be developed to use Cartopy and create GIF animations which will be cleaner and allow a higher resolution of data than Google Earth.
+aircraft_kml_bl.py is a program that is in development. It will only display aircraft tracks that are in the boundary layer for each given day.
+==Analyzing Aircraft Data==
+Code to analyze aircraft data is currently in development. In-progress code can be found in ADPAA/src/aircraft/aircraft_pbl. Below are the goals of the analyzing process:
+  * csv_append.py will create new csv files in the format data.pbl.csv.
+    * Included in this will be 3 new parameters:
+      * PBL Height
+      * PBL Flag (0 if out of the PBL, 1 if in the PBL)
+      * Radial distance from GFK sampling site (kilometers)
+  *unnamed_file.py will create a daily summary file that summarizes all flights for each day. Included will be:
+    * Flight start time
+    * Flight start date
+    * Total flight time
+    * End time
+    * End date
+    * Total gallons burned
+    * Gallons burned in boundary layer
+      * at different intervals (5km, 10km, 20km)
+**For questions about Python code, please email jacob.halmos@und.edu**
+//Code documentation last updated 06/08/2026//
 === Engineering Performance, FAA requirements, Certification requirements ===