Units, coordinate system and yaw
Units
The Skybrush Compiled Format (.skyc) works in SI units:
-
time is always expressed in [seconds]
-
space is always expressed in [meters]
-
angles are always expressed in [degrees]
Coordinate system
Spatial coordinates inside .skyc (and .skyb) files are given in a relative coordinate system with the following properties:
-
the coordinate system is flat (i.e., flat-Earth)
-
the coordinate system is right-handed;
-
the x-y-z coordinates are assumed to be treated as front-left-up in the real world;
-
the origin of the relative coordinate system in the real world is determined by Skybrush Live as part of the drone show preparation process, under the name show origin, containing
[latitude, longitude, AMSL/AGL altitude]values associated with relative position[0, 0, 0]; -
the orientation of the relative coordinate system in the real world is determined by Skybrush Live as part of the drone show preparation process, under the name show orientation, with a single value that defines the orientation of the X axis relative to North in clockwise positive direction (i.e., 0° = North, 90° = East, 180° = South, 270° = West);
Example: The coordinates [1, 2, 3] with show orientation 90° means 1 meter to the front (towards East), 2 meters to the left (towards North), 3 meters up (towards the sky) from the defined show origin.
Yaw angle
Yaw rotations inside the .skyc (and .skyb) files are given either as relative or as absolute rotations with the following properties:
-
yaw is always expressed in clockwise positive direction;
-
if yaw is relative, it is relative to the direction of the X axis with clockwise positive (front-right) direction (i.e., 0° = x+, 90° = y-, 180° = x-, 270° = y+); in this case absolute yaw values can be inferred by adding the value of the show orientation to the given relative yaw value;
-
if yaw is absolute, it is defined the same way as the show orientation (i.e., 0° = North, 90° = East, 180° = South, 270° = West), but independently of that;
-
auto yaw means that the yaw angle of the aircraft is linked to the direction of motion, with an optional yaw offset relative to that (i.e., 0° offset = direction of motion, 90° offset = right to direction of motion, 180° offset = opposite to the direction of motion, 270° offset = left to direction of motion).
Yaw values are treated as relative by default, unless noted otherwise.