Performance and Analysis Reports
The Setuav Standard provides a structure not only for UAV design but also for storing and sharing the analysis results of that design. This section explains how performance reports are structured.
Overview
Unlike a design file (design.yaml), performance reports (report.yaml) represent the outputs generated by an analysis tool or test process. This distinction separates the lifecycles of design data and result data.
Report Structure
A Setuav performance report (report.json schema) consists of five main components:
- Analysis Conditions (
conditions): The physical (mass, CG) and atmospheric (altitude, temperature) environment in which the analysis was performed. -
Aerodynamics (
aerodynamics): Basic aerodynamic coefficients and polars. -
Flight Performance (
flight): Speeds, climb rates, range, and endurance. - Propulsion Performance (
propulsion): Static thrust, power consumption, and efficiency.
Analysis Conditions
Every report must include context specifying the conditions under which the results are valid:
| Parameter | Unit | Required | Description |
|---|---|---|---|
| total_mass | g |
Yes | Total flight weight at the time of analysis. |
| cg_position_x | mm |
Yes | Center of Gravity (CG) position used in analysis. |
| altitude_msl | m |
No | Analysis altitude (Default: 0). |
| temperature | C |
No | Ambient temperature (Default: 15). |
| air_density | kg/m³ |
No | Air density (Default: 1.225). |
Interpretation and Flags
The Setuav report format does not include textual judgments or flags such as "Stable", "Unstable", or "Feasible". The report format stores only objective, calculated engineering data. The interpretation of this data (e.g., whether a 5% static margin is "sufficient") is the responsibility of the engineer or the tool reading the data.
Schema Reference
Report files can be validated using the schemas/report.json schema.
python3 validate.py my_analysis_result.yaml schemas/report.json