There are many 3D coordinate systems, they differ due to their varied etymologies in mathematics, navigation, computer graphics etc. The one used internally by Panaudia is that most commonly used by ambisonics, which were developed by Michael Gerzon and others at Oxford in the early 1970s, and is very similar to the conventions used in avionics.
Positions are represented by x, y and z values in a right-handed, three-dimensional cartesian space with these axes.
Panaudia's Spaces are cubes with a unit size of 1.0. This means that all x, y and z coordinates must be scaled to be between 0.0 and 1.0.
Rotations are represented by yaw, pitch and roll values in degrees:
This looks something like this:
The Panaudia version of this system can be described as:
You can find a detailed explanation of Euler and Tait–Bryan conventions and difference between intrinsic and extrinsic rotations here https://en.wikipedia.org/wiki/Euler_angles
Another common coordinates system is that used in computer graphics. Probably originating in IRIS GL at Silicone Graphics in the early 1980s this system placed the two principle axes, x and y, on an upright plane, to match the computer screen rather than on the ground. This standard is now the default 3D in web graphics built on WebGL/OpenGL.
OpenGL itself uses extrinsic rotations but most JavaScript libraries like Three.js or React-three-fiber wrap these up in more intuitive intrinsic rotations resulting in a coordinate system that looks like this:
As our JavaScript SDK is most likely to be used with this coordinate system we have included automatic conversion between web 3D and ambisonic coordinate systems. These functions will automatically do the conversions for you, their details are here:
Ambisonic coordinates, WebGL coordinates and geospatial coordinates are all right-handed cartesian coordinate systems. This is a spatial mnemonic I use to help me quickly remember their relationships to each other.
Imagine you are sitting looking East with your phone flat on the floor in front of you, with its screen facing up and the top of the phone pointing to your left.
Now the x, y and z axes for your head's ambisonic sound field, your geospatial pose and your phone's WebGL renderer are all aligned.
These give some extra background information: