info

Signal mapping and plot information for UAV log signal mapping

Since R2020b

collapse all in page

Syntax

signalTable = info(mapper,"Signal")

signalTable = info(mapper,"Signal",signalNames)

plotTable = info(mapper,"Plot")

signalTable = info(mapper,"Plot",plotNames)

Description

signalTable = info(mapper,"Signal") generates a table of information for the Predefined Signals available and the signals mapped in the flight log signal mapping object. The table contains a list of signal names, field names, units, and whether the signal has a value function mapped to it (IsMapped column).

signalTable = info(mapper,"Signal",signalNames) generates the signal table for the specified signal names.

plotTable = info(mapper,"Plot") generates a table of information for the Predefined Plots and custom plots available in the flight log signal mapping object. The table contains plots names, required signals, missing signals, and whether the plot is ready to plot.

signalTable = info(mapper,"Plot",plotNames) generates the plot table for the specified plot names.

Input Arguments

collapse all

`mapper` — Flight log signal mapping
`flightLogSignalMapping` object

Flight log signal mapping object, specified as a flightLogSignalMapping object.

`signalNames` — Signal names
string array

Signal names, specified as a string array.

`plotNames` — Plot names
string array

Plot names, specified as a string array.

Output Arguments

collapse all

`signalTable` — Table of available signals
table

Table of available signals, returned as a table. This table includes preconfigured signals and any signals you added to the flight log signal mapping object using mapSignal. The table has these fields:

SignalName –– String scalar of the name of the signal.
IsMapped –– Logical indicating if the signal is properly mapped. To update signal mapping, see mapSignal.
SignalFields –– String scalar that lists the fields of the signal.
FieldUnits –– String scalar that lists the units of each field.

`plotTable` — Table of available plots
table

Table of available plots, returned as a table. This table includes preconfigured plots and any plots you added to the flight log signal mapping object using updatePlot. The table has these fields:

PlotName –– String scalar of the name of the plot.
ReadyToPlot –– Logical indicating if the plot is configured properly. To update the plot, see updatePlot.
MissingSignals –– String scalar that lists the signals that need to be mapped using mapSignal.
RequiredSignals –– String scalar that lists all required signals for a specific plot name.

More About

collapse all

Predefined Signals

A set of predefined signals and plots are configured in the flightLogSignalMapping object. Depending on your log file type, you can map specific signals to the provided signal names using mapSignal. You can also call info to view the table for your log type and see whether you have already mapped a signal to that plot type.

Specify the SignalName as the input to mapSignal. Signals with the format SignalName# support mapping multiple signals of the same type. Replace # with incremental integers for each signal name when calling mapSignal.

The predefined signals have specific names and required fields when mapping the signal.

Predefined Signals

Signal Name	Description	Fields	Units
`Accel#`	Raw accelerometer reading from IMU sensor	`[ax ay az]`	m/s²
`Airspeed#`	Airspeed reading of pressure differential, indicated air speed, and temperature	`[PressDiff, AirSpeed, Temp]`	Pa, m/s, ℃
`AttitudeEuler`	Attitude of UAV in Euler (ZYX) form	`[Roll, Pitch, Yaw]`	radians
`AttitudeRate`	Angular velocity along each body axis	`[xRotRate, yRotRate, zRotRate]`	rad/s
`AttitudeTargetEuler`	Target attitude of UAV in Euler (ZYX) form	`[TargetRoll, TargetPitch, TargetYaw]`	radians
`Barometer#`	Barometer readings for absolute pressure, relative pressure, and temperature	`[PressAbs, PressAltitude, Temp]`	Pa, m, ℃
`Battery`	Voltage readings for battery and remaining battery capacity (%)	`[Volt1,Volt2, ... Volt16, RemainingCapacity`	V, %
`GPS#`	GPS readings for latitude, longitude, altitude, ground speed, course angle, and number of satellites visible	`[lat, long, alt, groundspeed, courseAngle, satellites]`	degree, degree, m, m/s, degree, n/a
`Gyro#`	Raw body angular velocity readings from IMU sensor	`[GyroX, GyroY, GyroZ]`	rad/s
`LocalNED`	Local NED coordinates estimated by the UAV	`[xNED, yNED, zNED]`	meters
`LocalNEDTarget`	Target location in local NED coordinates	`[xTarget, yTarget, zTarget]`	meters
`LocalNEDVel`	Local NED velocity estimated by the UAV	`[vx vy vz]`	m/s
`LocalNEDVelTarget`	Target velocity in local NED coordinates	`[vxTarget, vyTarget, vzTarget]`	m/s
`Mag#`	Raw magnetometer reading from IMU sensor	`[x y z]`	Gs

Predefined Plots

After mapping signals to the list of predefined signals using mapSignal, specific plots are made available when calling show. To view a list of available plots and their associated signals for your specific object, call info(mapper,"Plot"). If you want to define custom plots based on signals, use updatePlot.

Each predefined plot has a set of required signals that must be mapped.

Predefined Plots

Plot	Description	Signals
`Attitude`	Stacked plot of roll, pitch, yaw angles and body rotation rates	`AttitudeEuler, AttitudeRate, Gyro#`
`AttitudeControl`	Estimated attitude of UAV and the attitude target set point	`AttitudeEuler, AttitudeTargetEuler`
`Battery`	Battery consumption plot	`Battery`
`Compass`	Estimated yaw and magnetometer readings	`AttitudeEuler, Mag#, GPS#`
`GPS2D`	Raw Lat-Lon plot for GPS sensor readings.	`GPS#`
`Height`	Stacked plots of barometer reading, GPS altitude reading, and fused height estimate	`Barometer#, GPS#, LocalNED`
`Speed`	Stacked plot of ground velocity and air speed	`GPS#, Airspeed#`
`Trajectory`	Trajectory in local coordinates versus target set points	`LocalNED, LocalNEDTarget`
`TrajectoryTracking`	Error between desired and actual position in NED coordinates	`LocalNED, LocalNEDTarget`
`TrajectoryVelTracking`	Error between desired and actual velocity in NED coordinates	`LocalNEDVel, LocalNEDVelTarget`