Export Data and Create Data Sets

At the end of a labeling session, you can export any signal sets that you labeled or any label definitions that you created for use with other signal sets. You can also import these signal sets into the app in a subsequent labeling session. When labeling is complete, you can create data sets for training and save them as MAT files. You can export labeled signal sets and definitions to MAT files or to the MATLAB^® Workspace. You can also export labeled signal sets to Diagnostic Feature Designer (Predictive Maintenance Toolbox). Signal Labeler exports labeled signals as labeledSignalSet objects.

Export Label Definitions

To export signal label definitions, click Export on the Labeler tab and select To Workspace or To File under Label Definitions. In the dialog box, specify the name of a variable or MAT file. The specified file or variable contains an array of signalLabelDefinition objects with all the definitions you created, imported, and modified in the current Signal Labeler session.

Note

If you want to reuse signal label definitions created during a Signal Labeler session, you must export the definitions to a MAT file and import them in a subsequent session.

Export Labeled Signal Sets

To export new labeled signal sets, click Export on the Labeler tab and select To Workspace or To File under Labeled Signal Set. In the dialog box, specify the name of a variable or MAT file and an optional brief description. The variable or file contains a labeledSignalSet object that merges all the signals, label definitions, and label values that you created, imported, and modified in the current Signal Labeler session. All signals that contain time information are converted to MATLAB timetables.

Note

When exporting labeled signal sets, Signal Labeler converts all signals with time information to timetables. This conversion results in a deeper hierarchy of nested channels in the exported labeledSignalSet object. You can see the deeper hierarchy if you import the labeled signal set again into the app.

To export labeled signal sets to Diagnostic Feature Designer, click Export on the Labeler tab and select To Diagnostic Feature Designer under Labeled Signal Set. Signal Labeler exports the labeled signal set and opens the Diagnostic Feature Designer app. You must have a Predictive Maintenance Toolbox™ license to use Diagnostic Feature Designer. (since R2024b)

Create Data Sets

To create data sets, click Create Data Sets on the Labeler tab. In the dialog box, specify the path to the folder to which you want to save the data set, select label definition and the data to include in the data set, then click Create. Signal Labeler saves the created data set to a MAT file and a READ.ME metadata file.

The data you can save in the data set depends on the label definition type.

For attribute, point, or ROI label definitions, Signal Labeler includes signal and labels. You can choose to include member names.
For time-frequency ROI label definitions, Signal Labeler includes labels and time-frequency map. You can choose to include member names, signals, and time-frequency options. For more information about time-frequency options, see labelSpectrogramOptions.

To set the format of the time-frequency labels, select one of the options under Format of label limits.

[x,y,w,h] (best for object detection) — Signal Labeler stores the labels of the member signals and their locations as a cell array. Each label location forms a four-element vector [x y w h] that describes each instance of the label value, where:
- x represents the column of the matrix the label value starts in.
- y represents the row of the matrix the label value starts in.
- w indicates how many columns the label spans across.
- h indicates how many rows the label spans across.
Mask (best for semantic segmentation) — Signal Labeler stores the labels of the member signals as M-by-N matrices, where M is the number of frequency bins and N is the number of time windows. Each value in each matrix represents the label value at the same indices as in the corresponding signal time-frequency map.
Both — Signal Labeler stores the labels of the member signals in both formats, [x y w h] and the mask.

To set the format of the time-frequency map, select one of these options.

Image (RGB) — Signal Labeler stores the time-frequency representation of the member signals as uint8 M-by-N-by-3 arrays, where M is the number of frequency bins and N is the number of time windows. Each array represents an image of the spectrogram, and the pages represent the color intensity in red, green, and blue, respectively. The values in the array range between 0 and 255.
If you select this option, you can specify M and N in Width and Height, respectively.
Spectrogram — Signal Labeler stores the time-frequency representation of the signals as M-by-N matrices in double precision, where M is the number of frequency bins and N is the number of time windows. Each matrix represents the grayscale map of the spectrogram.