Skip to content

matlab/matlab-agentic-toolkit / skills-catalog/signal-processing/matlab-prepare-signal-data

matlab-prepare-signal-data

Verified

Use this skill when conditioning, loading, preparing, or labeling signal data for analysis or ML training. Covers: cleaning a single signal (fill gaps, remove drift, deoutlier, denoise, resample/align a time base) BEFORE analysis; building a `signalDatastore` pipeline; creating a `labeledSignalSet` for Signal Labeler; deriving labels (filename, folder, in-file, ROI, time-frequency ROI); stratified train/val/test splits; framing long signals; parallel processing; and shaping datastore output for `trainnet`. Triggers include "clean up this signal", "remove drift / detrend", "fill gaps", "remove spikes / outliers", "denoise", "resample to a uniform rate", "align channels", "labels from filenames", "stratified split", "prepare for Signal Labeler", and function names like `fillgaps`, `fillmissing`, `detrend`, `filloutliers`, `smoothdata`, `resample`, `synchronize`, `signalDatastore`, `labeledSignalSet`, `filenames2labels`, `folders2labels`, `splitlabels`, `framesig`, `framelbl`, `createDatastores`.

FileKindSize
SKILL.mdskill md9.5 KB
manifest.yamlconfig650 B
references/fn-countlabels.mdmarkdown2.1 KB
references/fn-detrend.mdmarkdown4.6 KB
references/fn-filenames2labels.mdmarkdown4.8 KB
references/fn-fillgaps.mdmarkdown3.3 KB
references/fn-fillmissing.mdmarkdown4.2 KB
references/fn-filloutliers.mdmarkdown5.0 KB
references/fn-folders2labels.mdmarkdown3.4 KB
references/fn-framelbl.mdmarkdown7.1 KB
references/fn-framesig.mdmarkdown4.1 KB
references/fn-hampel.mdmarkdown3.3 KB
references/fn-labeledsignalset.mdmarkdown9.1 KB
references/fn-labelspectrogramoptions.mdmarkdown4.6 KB
references/fn-medfilt1.mdmarkdown3.3 KB
references/fn-partition.mdmarkdown4.6 KB
references/fn-resample.mdmarkdown4.6 KB
references/fn-retime.mdmarkdown4.7 KB
references/fn-sgolayfilt.mdmarkdown3.5 KB
references/fn-signaldatastore.mdmarkdown11.9 KB
references/fn-signallabeldefinition.mdmarkdown5.9 KB
references/fn-signalmask-getmask.mdmarkdown8.6 KB
references/fn-smoothdata.mdmarkdown4.8 KB
references/fn-splitlabels.mdmarkdown5.3 KB
references/fn-subset.mdmarkdown3.9 KB
references/fn-synchronize.mdmarkdown4.7 KB
references/fn-wdenoise.mdmarkdown5.2 KB
references/wf-align-channels.mdmarkdown6.6 KB
references/wf-custom-readfcn.mdmarkdown5.0 KB
references/wf-denoise.mdmarkdown2.6 KB
references/wf-detrend-smooth-deoutlier.mdmarkdown6.6 KB
references/wf-envelope.mdmarkdown5.3 KB
references/wf-frame-and-label.mdmarkdown4.7 KB
references/wf-handoff-to-dl.mdmarkdown9.1 KB
references/wf-label-and-export.mdmarkdown8.7 KB
references/wf-load-and-split.mdmarkdown4.6 KB
references/wf-parallel-process.mdmarkdown4.8 KB
references/wf-repair-missing.mdmarkdown6.7 KB
references/wf-uniform-rate.mdmarkdown4.2 KB

references/fn-labelspectrogramoptions.md

View on GitHub
# Function: `labelSpectrogramOptions`

> Used in: wf-label-and-export.md, fn-signallabeldefinition.md
> Toolbox: Signal Processing Toolbox
> Since: R2025a

Store spectrogram options for time-frequency ROI label definitions. Controls
how the TF map is computed when labeling in the time-frequency domain (both
programmatically and in Signal Labeler).

## Signatures

```matlab
opts = labelSpectrogramOptions                              % defaults (leakage)
opts = labelSpectrogramOptions(resType)                     % "leakage" | "rbw" | "windowlength"
opts = labelSpectrogramOptions(resType, Name=Value)         % with NV-pairs
```

## Resolution types

| `resType` | Controls via | Typical use |
|---|---|---|
| `"leakage"` (default) | `Leakage`, `TimeResolutionMode`, `TimeResolution` | Quick pspectrum-style setup |
| `"rbw"` | `RBWMode`, `RBW` | Explicit resolution bandwidth |
| `"windowlength"` | `Window`, `WindowLengthMode`, `WindowLength`, `NFFTMode`, `NFFT` | Full STFT control |

## Properties (all resolution types)

| Property | Default | Notes |
|---|---|---|
| `ResolutionType` | `"leakage"` | Read-only after construction |
| `Overlap` | `50` | Percentage [0, 100) |
| `MinimumThresholdMode` | `"auto"` | `"auto"` \| `"specify"` |
| `MinimumThreshold` | `[]` | Positive scalar when mode is `"specify"` |
| `UseDecibels` | `true` | Express spectrogram in dB |

## Properties (leakage-specific)

| Property | Default | Notes |
|---|---|---|
| `Leakage` | `20` | Scalar in [0, 40]. Maps to Kaiser beta. |
| `TimeResolutionMode` | `"auto"` | `"auto"` \| `"specify"` |
| `TimeResolution` | `[]` | Positive scalar (seconds) when mode is `"specify"` |
| `Reassign` | `false` | Reassign spectrogram values for sharper localization |

## Properties (rbw-specific)

| Property | Default | Notes |
|---|---|---|
| `RBWMode` | `"auto"` | `"auto"` \| `"specify"` |
| `RBW` | `[]` | Resolution bandwidth (Hz) when mode is `"specify"` |

## Properties (windowlength-specific)

| Property | Default | Notes |
|---|---|---|
| `Window` | `"hamming"` | `"hamming"` \| `"hann"` \| `"blackmanharris"` \| `"flattop"` \| `"rectangular"` \| `"chebyshev"` \| `"kaiser"` |
| `WindowAttenuationChebyshev` | `[]` | >= 21 dB |
| `WindowAttenuationKaiser` | `[]` | >= 45 dB |
| `WindowLengthMode` | `"auto"` | `"auto"` \| `"specify"` |
| `WindowLength` | `[]` | Positive integer (samples) |
| `NFFTMode` | `"auto"` | `"auto"` \| `"specify"` |
| `NFFT` | `[]` | Positive integer |

## Object functions

| Function | Returns |
|---|---|
| `getTFMap(opts, signal, Fs)` | STFT matrix for TF labeling |
| `getTFMapSize(opts, signalLength, Fs)` | `[numFreqBins numTimeSteps]` — size without computing |

## Canonical pattern

```matlab
opts = labelSpectrogramOptions("leakage", ...
    Leakage=32, Overlap=90, ...
    TimeResolutionMode="specify", TimeResolution=0.05);

lblDef = signalLabelDefinition("Signal", ...
    LabelType="roiTimeFrequency", ...
    LabelDataType="categorical", ...
    Categories=["WLAN" "BT" "LTE"], ...
    TimeFrequencyOptions=opts);
```

## Matching pspectrum settings

`pspectrum` uses `Leakage` as a fraction [0, 1]; `labelSpectrogramOptions`
uses it as a value in [0, 40]. The conversion:

```matlab
pspectrumLeakage = 0.5;                    % fraction
optsLeakage = 40 * (1 - pspectrumLeakage); % = 20
```

The `[0, 40]` value is literally the **Kaiser window beta** (for the default
Kaiser path): `labelSpectrogramOptions` internally calls `pspectrum` with
`Leakage = 1 - optsLeakage/40`, and `pspectrum` maps that to `beta = 40*(1 -
leakage)`, so `optsLeakage == beta`. This equivalence is specific to the
default Kaiser window; it does not apply if you set `Window` to
`"blackmanharris"` / `"chebyshev"` / `"flattop"` etc., which use their own
attenuation properties.

## Gotchas

- **`Leakage` range differs from `pspectrum`.** `pspectrum` takes [0, 1]
  (fraction); `labelSpectrogramOptions` takes [0, 40] (Kaiser sidelobe
  attenuation scale). Use `40*(1 - pspectrumLeakage)` to convert.
- **`Overlap` is percentage, not sample count.** Unlike `spectrogram()`
  which takes `noverlap` in samples.
- **Options must match Signal Labeler view settings.** If you set
  spectrogram options programmatically and then open in Signal Labeler,
  the app uses those exact options. Mismatched settings mean labels
  appear at wrong TF locations.
- **`getTFMapSize` is useful for pre-allocating.** Call before
  `createDatastores` with `TimeFrequencyImageSize` to know the native
  TF grid size.

## See also

- `fn-signallabeldefinition.md` — uses `TimeFrequencyOptions` property.
- `wf-label-and-export.md` — end-to-end workflow.

----

Copyright 2026 The MathWorks, Inc.

----
finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 322kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 322kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 322kUpdated Claude CodeCodexVerifiedInstall
skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.Stars: 197kUpdated Claude CodeCodexVerifiedInstall