Return logged orientation data from mobile device sensor
[ returns the orientation log, where
m is the name of the
mobiledev object that acquires the sensor data,
log is an N-by-3 matrix containing orientation data points for azimuth, roll, and pitch, and
timestamp is an N-by-1 vector of timestamps, where N is the number of samples acquired during the capture duration.
Get Logged Orientation Data from Mobile Device Sensor
This example assumes that you have already installed and set up MATLAB® Mobile™ on your mobile device. If you have not, see Install MATLAB Mobile on Your Device.
If you want to read the data in a different session of MATLAB, start MATLAB Online™ or MATLAB on your local computer. Using a local installation to read sensor data also requires one of the following support packages, appropriate for your mobile device:
MATLAB Support Package for Apple iOS Sensors
MATLAB Support Package for Android™ Sensors
Start MATLAB Mobile on your device.
On the Sensors screen, tap the Orientation sensor.
Place the device where you want to get the sensor data.
In your MATLAB session, create a
m = mobiledev
Begin logging data by enabling the
m.Logging = 1
This action starts the transmitting of data from all selected sensors. You can also start transmission by tapping the Start button in MATLAB Mobile.
Get the logged orientation data.
[o, t] = orientlog(m)
This returns the orientation log, where
o contains the three data points in degrees for azimuth, pitch, and roll.
See Device Orientation for a diagram showing the
Z axes relative to the device.
log — Name of variable for orientation log data
Name of variable for orientation log data, returned as an N-by-3 matrix of data points from the Orientation sensor on the mobile device. The three data points are the position reading in degrees, for azimuth, pitch, and roll.
Orientation is defined in relation to the
Z axes. If you set the device down face-up on a table, the positive X-axis extends out of the right side of the device, positive Y-axis extends out of the top side, and the positive Z-axis extends out of the front face of the device. This is independent of the orientation of the device.
Azimuth is the angle between the positive Y-axis and magnetic north, and its range is between -180 and 180 degrees.
Positive pitch is defined when the device is lying flat on a surface and the positive Z-axis tilts towards the positive Y-axis, with range between -90 and 90 degrees.
Positive roll is defined when the device is lying flat on a surface and the positive Z-axis tilts towards the positive X-axis, with range between -180 and 180 degrees.
timestamp — Name of variable for timestamp
Name of variable for timestamp, returned as an N-by-1 vector of timestamps from the Orientation sensor on the mobile device. Time is in seconds, relative to the
Introduced in R2015a