Data types
From XDIF
This page is meant to function as a brainstorming on GDIF data types. What types of data are we working with?
Contents |
Information
Data | Description | SDIF type tag | OSC namespace | Unit |
---|---|---|---|---|
Index number | Index number. Referring to a certain event in a series of events. E.g. triggering a certain sound sample from a sample bank. | XIDX | | none |
Synchronisation | Synchronisation stream. Used for synchronising an SDIF file to external files, e.g. video frame number. | XSNC | /synchronisation/videoFrameNumber | none |
Raw data descriptors
Position and orientation descriptors
Data | Description | SDIF type tag | OSC namespace | Unit |
---|---|---|---|---|
Position, 1D | Position in a single dimension | XP10 | /position/x | m |
Position, 2D | Position in two dimensions | XP20 | /position/xy | m |
Position, 3D | Position in three dimensions | XP30 | /position/xyz | m |
Position, 1D, First finite difference | Position in a single dimension, first finite difference | XP11 | /position/x/delta1 | m/sample |
Position, 3D, First finite difference | Position in three dimensions, first finite difference | XP31 | /position/xyz/delta1 | m/sample |
Position, First finite difference | Position, first finite difference, Absolute value | XPA1 | /position/xyz/delta1/absolute | m/sample |
Position, 3D, Second finite difference | Position in three dimensions, second finite difference | XP32 | /position/xyz/delta2 | m/sample^2 |
Position, Second finite difference | Position, second finite difference, Absolute value | XPA2 | /position/xyz/delta2/absolute | m/sample^2 |
Velocity 1D | 1-dimensional velocity stream. | XV10 | /velocity/x | m/s |
Velocity 2D | 2-dimensional velocity stream. | XV20 | /velocity/xy | m/s |
Velocity 3D | 3-dimensional velocity stream. | XV30 | /velocity/xyz | m/s |
Absolute velocity | Velocity of an object independent from the direction of the movement. | XVA0 | /velocity/absolute | m/s |
Acceleration 1D | 1-dimensional acceleration stream. | XA10 | /acceleration/x | m/s^2 |
Acceleration 2D | 2-dimensional acceleration stream. | XA20 | /acceleration/xy | m/s^2 |
Acceleration 3D | 3-dimensional acceleration stream. | XA30 | /acceleration/xyz | m/s^2 |
Absolute acceleration | Acceleration of an object independent from direction. | XAA0 | /acceleration/absolute | m/s^2 |
Jerk 1D | 1-dimensional jerk stream. Third derivative of position. | XJ10 | /jerk/x | m/s^3 |
Jerk 2D | 2-dimensional jerk stream. | XJ20 | /jerk/xy | m/s^3 |
Jerk 3D | 3-dimensional jerk stream. | XJ30 | /jerk/xyz | m/s^3 |
Absolute jerk | Jerk of an object independent from direction. | XJA0 | /jerk/absolute | m/s^3 |
Orientation 3D Euler | 3-dimensional orientation in Euler format. E.g. an orientation described as three successive rotations along the cumulative Z, X and Z axes. | XOE0 | /orientation/eulerzxz | |
Orientation Quaternion | 3-dimensional orientation in Quaternion format. | XOQ0 | /orientation/quaternion | |
Orientation Rotation matrix | 3-dimensional orientation in 3x3 Rotation matrix format. | XOR0 | /orientation/matrix | |
Sensor data & input devices
Data | Description | SDIF type tag | OSC namespace | Unit |
---|---|---|---|---|
MIDI | MIDI stream, already implemented in the SDIF standard | 1MID | /midi/raw | |
HID | HID controllers | XHID | /hid/raw | |
Polhemus | 6DOF position and orientation data from a Polhemus device | XPOL | /polhemus | |
Accelerometer | Data from an accelerometer | XACC | /accelerometer | |
FSR | Data from a Force-Sensing Resistor | XFSR | /fsr | |
Elextromyography | EMG sensor input | XEMG | /emg | |
Cooked data
Motion descriptors
Data | Description | SDIF type tag | OSC namespace | Unit |
---|---|---|---|---|
Quantity of motion | The total amount of motion, often calculated by taking the absolute value of the vector length of the first derivative of position (or accelerometer data). | XMQ0 | | none |
Quantity of motion. First finite difference. | The change in Quantity of motion from one sample to the next. | XMQ1 | /motion/quantity | none |
Area of motion (2D) | The area of the bounding box (or convex hull) surrounding the motion points. | XMA0 | /motion/area | m^{2} |
Volume of motion (3D) | The volume of the bounding box (or convex hull) surrounding the motion points. | XMV0 | /motion/volume | m^{3} |
Centre of motion (2D/3D) | The geometric centre of the area/volume of motion. | XMC0 | /motion/centre | m |
Laban descriptors
Based on features from the Effort part of the Laban Movement Analysis.
Data | Description | SDIF type tag | OSC namespace | Unit |
---|---|---|---|---|
Space | range: direct - indirect | | | none |
Weight | range: strong - light | | | none |
Time | range: sudden - sustained | | | |
Flow | range: | | | |
Higher-level descriptors
Data | Description | SDIF type tag | OSC namespace | Unit |
---|---|---|---|---|
Arousal | range: high - low | | ||
Valence | range: negative - positive |