Guides
Use the recipe feature set
myogestic.recipes.features provides five classic time-domain EMG features.
Starter examples previously copied these implementations into each script.
| Name | Function | What it captures |
|---|---|---|
rms |
Root-mean-square | Channel envelope amplitude. |
mav |
Mean absolute value | Same neighbourhood as RMS, cheaper to compute. |
wl |
Waveform length | Sum of ` |
var |
Variance | Energy around the per-window mean. |
zc |
Zero-crossing count | Per-channel oscillation rate. |
Use these baselines for a five-minute setup check. They are not the framework’s recommended feature set. For work beyond a smoke test, mix them with features suited to your experiment.
The shape contract
Every function takes one argument, an EMG window of shape (n_channels, n_samples)
and returns a per-channel scalar vector of
shape (n_channels,) with dtype float32.
import numpy as npfrom myogestic.recipes.features import rms
emg = np.random.randn(8, 256).astype(np.float32) # 8 channels, 256 samplesrms(emg).shape # (8,)rms(emg).dtype # dtype('float32')The shape and dtype are part of the contract. Stick to them when writing
your own feature for FeatureSelector and the typed pipeline.
Wiring into a pipeline
FeatureSelector takes a {name: fn} dict and exposes a wrapping mono toggle chip for
each feature under a Features caption. Active chips are tinted; all chips can be
deselected, but extraction then raises until at least one is selected:
from myogestic.recipes.features import rms, mav, wl, var, zcfrom myogestic.widgets import FeatureSelector
feats = FeatureSelector( {"RMS": rms, "MAV": mav, "WL": wl, "VAR": var, "ZC": zc}, default=["RMS", "MAV"], # start with these active)
@pipeline.extractdef extract(windows): return feats(windows["emg"]) # → (n_features * n_channels,)
@app.uidef ui(ctx): with grid[2, 0]: feats.ui()feats(window) concatenates the selected features. Toggling a feature changes
output dimensionality without invalidating the trained model. FeatureSelector
only mutates its active-feature set. Sklearn and
CatBoost raise shape-mismatch errors if prediction uses a different shape.
Choose one of these patterns:
- Lock the selector after training - render the feature toggles
greyed out once
pipeline.app.ctx.state == "predicting"so the user can’t silently break the live loop. - Treat a toggle as “retrain me” - keep your own snapshot of
feats.active_namesbetween frames and, when it changes, prompt the user to retrain (or kick off training automatically).
The first is the safer default for a demo; the second is what you want when feature selection is part of the user’s iteration loop.
Mixing in your own
A feature is a Callable[[np.ndarray], np.ndarray] matching the
shape contract. Drop yours in next to the recipe ones:
import numpy as npfrom myogestic.recipes.features import rms, mav
def slope_sign_changes(emg: np.ndarray) -> np.ndarray: """Count slope-sign changes per channel - classic Hudgins SSC feature.""" d1 = np.diff(emg, axis=1) flips = (d1[:, :-1] * d1[:, 1:]) < 0 return np.sum(flips, axis=1).astype(np.float32)
feats = FeatureSelector( {"RMS": rms, "MAV": mav, "SSC": slope_sign_changes}, default=["RMS", "MAV", "SSC"],)Choose a feature pipeline
These five features operate on time-domain sEMG windows. Use a dedicated pipeline for spectral features, frozen-network embeddings or MyoVerse decomposition output.
Use it for:
- A first cut at a new dataset, to confirm wiring before tuning.
- A baseline to beat when adding model-side complexity.
- A demo that needs to be five lines, not fifty.
Replace it for:
- HD-sEMG with established spectral or NMF pipelines - use the existing
feature stack from your prior work;
FeatureSelectoraccepts any shape-conforming callable. - End-to-end deep models where features are the raw window - skip feature extraction entirely and feed the window to the model.
See also
- Feature extraction cookbook - recipes for windowing, normalization, and spectral features.
myogestic.recipes.features- full module reference.myogestic.widgets.FeatureSelector- the GUI-toggleable feature dispatcher.