Metadata-Version: 2.1
Name: flightdata
Version: 0.2.14
Summary: Module for handling UAV flight log data
Author-email: Thomas David <thomasdavid0@gmail.com>
License: GNU GPL v3
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.12
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: numpy
Requires-Dist: pandas
Requires-Dist: simplejson
Requires-Dist: pfc-geometry>=0.2.5
Provides-Extra: dev
Requires-Dist: numpy; extra == "dev"
Requires-Dist: pandas; extra == "dev"
Requires-Dist: simplejson; extra == "dev"
Requires-Dist: pfc-geometry>=0.2.5; extra == "dev"
Requires-Dist: ardupilot-log-reader>=0.3.1; extra == "dev"
Requires-Dist: pytest; extra == "dev"

## FlightData
This repo is contains a set of datastructures and tools for handling flight log data.

### Flight 
The Flight object represents the data logged by a flight controller. The class wraps a pandas dataframe which is indexed on a single time axis. Where data is logged at different rates for different sensors it is mapped to the closest time index. Attribute access provides individual columns or sets of columns in the groups defined in Fields. Item access subsets the data in the time axis. 

### Table
The Table is the base type for most of the datastructures. It allows attribute access to individual columns. Attribute access is also available to return basic entities subclassed from the base type in the pfc-geometry package. For example in the state object table.x provides the x position, table.pos provides a Point representing the xyz position. columns that are not represented by geometric base types are considered to be labels for the data.

### State
The State object is a table representing the position and orientation of the aircraft along with their derivatives, it can be constructed from a Flight or from scratch by extrapolating in lines or around arcs. Many tools are provided to manipulate the data. The position and attitude are in a reference frame (with Z up), the derivatives move with the aircraft in either the body, wind, stability or track (like the wind axis but with no wind) frame.  


Further documentation will be provided here: https://pfcdocumentation.readthedocs.io/pyflightcoach/flightdata.html


### Installation

```bash
pip install pfc-geometry
```

### Setup from source

```bash
pip install .
```
