A typical workflow for labeling signals using the Signal Labeler app is:
Create or Import Signal Label Definitions — Define labels to annotate signal attributes, regions, or points of interest quickly and consistently using logical, categorical, numerical, or string values. You can also import signal label definitions stored in MAT-files.
Label Signals Interactively or Automatically — Label signals interactively. Automatically label signal peaks or use your own Custom Labeling Functions. Label several signals at once or use the autolabeling mode of the app to inspect labeling results before committing them.
Export Labeled Signal Sets and Signal Label Definitions — Export labeled signal sets and label signal definitions to the MATLAB Workspace or to MAT-files.
Define a vector with two acute peaks and one flat peak. Use Signal Labeler to label the peaks and mark the flat peak as different from the others.
data = [25 8 15 5 6 10 10 3 1 20 7];
Open Signal Labeler. Import the data vector. On the Labeler tab, click Import ▼, select
Members from workspace, select the
data signal in the dialog box that appears, click Import, and close the dialog box. Select the check box next to the signal name in the Labeled Signal Set browser to display the signal in the time plot.
Label the signal peaks. Start by creating a signal label definition. Click Add Definition. In the dialog box, specify Label Name as
Peak, Label Type as
Point, and Data Type as
Peak definition highlighted in the Label Definitions browser, select Peak Labeler in the Automate Value gallery. Click Auto-Label ▼ and select
Auto-Label Signals. Click OK in the dialog box that appears. Signal Labeler labels the three peaks and annotates its locations.
Create a sublabel for
Peak to annotate the flat peak, which is the second of the three. With
Peak still selected in the Label Definitions browser, click Add Definition ▼ and select
Add sublabel definition. Specify Label Name as
Flat, Label Type as
ROI, and Data Type as
Select the point label for the flat peak. You can select the label by clicking it in the Labeled Signal Set browser, in the time plot, or in the label viewer. Selecting the label highlights it in all three places. Select
Flat in the Label Definitions browser, click Label ▼, and select
Label Plotted. A shaded region appears on the signal plot. Move and resize the region until it encloses the flat peak. To accept a label, click the Accept check mark next to the Label button, press Enter, or double-click the shaded region.
Export the labeled signal. Click Export ▼ and select
Labeled Signal Set To File. Name the file
peaks.mat. Click Export.
Inspect the labeled signal set you created. Load
peaks.mat into the MATLAB® Workspace. The
labeledSignalSet object is called
ls. Verify that the data source is the vector you created at the beginning. Check that the signal label definitions are the ones you created, including the
Flat sublabel for
load peaks src = getSignal(ls,1)'
src = 1×11 25 8 15 5 6 10 10 3 1 20 7
lbl = getLabelDefinitions(ls)
lbl = signalLabelDefinition with properties: Name: "Peak" LabelType: "point" LabelDataType: "numeric" ValidationFunction:  PointLocationsDataType: "double" DefaultValue:  Sublabels: [1x1 signalLabelDefinition] Tag: "" Description: "" Use labeledSignalSet to create a labeled signal set.
slbl = lbl.Sublabels
slbl = signalLabelDefinition with properties: Name: "Flat" LabelType: "roi" LabelDataType: "logical" ValidationFunction:  ROILimitsDataType: "double" DefaultValue:  Sublabels: [0x0 signalLabelDefinition] Tag: "" Description: "" Use labeledSignalSet to create a labeled signal set.