Skip to content

clean

Functions

clean(data, lowcut=3, highcut=11, sample_rate=1000, order=3, axis=-1)

Clean accelerometer signal using biquad filter.

By default applies a 3rd order Butterworth filter between 0.5 and 4 Hz.

Parameters:

  • data (NDArray) –

    Accelerometer signal

  • lowcut (float, default: 3 ) –

    Lower cutoff in Hz. Defaults to 3 Hz.

  • highcut (float, default: 11 ) –

    Upper cutoff in Hz. Defaults to 11 Hz.

  • sample_rate (float, default: 1000 ) –

    Sample rate in Hz. Defaults to 1000 Hz.

  • order (int, default: 3 ) –

    Filter order. Defaults to 3 (3rd order Butterworth filter).

  • axis (int, default: -1 ) –

    Axis to apply against. Defaults to -1.

Returns:

  • NDArray –

    npt.NDArray: Cleaned signal

Source code in physiokit/imu/clean.py 
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
def clean(
    data: npt.NDArray,
    lowcut: float = 3,
    highcut: float = 11,
    sample_rate: float = 1000,
    order: int = 3,
    axis: int = -1,
) -> npt.NDArray:
    """Clean accelerometer signal using biquad filter.

    By default applies a 3rd order Butterworth filter between 0.5 and 4 Hz.

    Args:
        data (npt.NDArray): Accelerometer signal
        lowcut (float, optional): Lower cutoff in Hz. Defaults to 3 Hz.
        highcut (float, optional): Upper cutoff in Hz. Defaults to 11 Hz.
        sample_rate (float, optional): Sample rate in Hz. Defaults to 1000 Hz.
        order (int, optional): Filter order. Defaults to 3 (3rd order Butterworth filter).
        axis (int, optional): Axis to apply against. Defaults to -1.

    Returns:
        npt.NDArray: Cleaned signal
    """

    return filter_signal(
        data=data,
        lowcut=lowcut,
        highcut=highcut,
        sample_rate=sample_rate,
        order=order,
        forward_backward=True,
        axis=axis,
    )