EmgNormalisationProcessingFilter

class pyCGM2.EMG.emgFilters.EmgNormalisationProcessingFilter(analysis: Analysis, label: str, context: str)

Filter for normalizing EMG signals in amplitude.

This filter normalizes the amplitude of EMG signals, typically after rectification and enveloping, using various normalization methods.

Parameters:

• analysis (Analysis) – A pyCGM2 analysis instance containing EMG data.

• label (str) – EMG label for the signal to normalize.

• context (str) – Event context (e.g., ‘Left’, ‘Right’).

__init__(analysis: Analysis, label: str, context: str)

Initializes the EmgNormalisationProcessingFilter with an analysis instance, label, and context.

Methods

__init__(analysis, label, context)	Initializes the EmgNormalisationProcessingFilter with an analysis instance, label, and context.
processAnalysis()	Process the pyCGM2 analysis instance for EMG normalization.
processC3d()	Process all C3D files specified in the filter.
run()	Run the EMG normalization filter.
setC3ds(datPath, c3ds[, fileSuffix])	Set a list of C3D files for processing.
setMaxMethod(EnumEmgNorm[, Value])	Set the normalization method for EMG signal amplitude.
setThresholdFromOtherAnalysis(analysis)	Set another pyCGM2 analysis instance as the normalization denominator.

processAnalysis()

Process the pyCGM2 analysis instance for EMG normalization.

New labels with the suffix ‘_Norm’ are created in the ‘emgStats.data’ section of the pyCGM2 analysis instance.

processC3d()

Process all C3D files specified in the filter.

Each C3D file is updated to include a new analog label with the suffix ‘_Norm’.

run()

Run the EMG normalization filter.

Processes either the specified C3D files or the pyCGM2 analysis instance, depending on the configuration.

setC3ds(datPath: str, c3ds: List, fileSuffix: str | None = None)

Set a list of C3D files for processing.

Parameters:

• datPath (str) – Folder data path containing the C3D files.

• c3ds (List[str]) – List of C3D file names.

• fileSuffix (Optional[str]) – Optional suffix added to C3D filenames during processing.

setMaxMethod(EnumEmgNorm: EmgAmplitudeNormalization, Value: float | None = None)

Set the normalization method for EMG signal amplitude.

Parameters:

• EnumEmgNorm (enums.EmgAmplitudeNormalization) – Enumeration specifying the normalization method.

• Value (Optional[float]) – Optional value to force the normalization denominator.

setThresholdFromOtherAnalysis(analysis: Analysis)

Set another pyCGM2 analysis instance as the normalization denominator.

Parameters:

analysis (Analysis) – A pyCGM2 analysis instance to use as the normalization reference.