Skip to content

clean

Functions

clean(data, lowcut=0.05, highcut=3, sample_rate=1000, order=3, axis=-1, forward_backward=True)

Clean respiratory signal using biquad filter.

By default, applies a 3rd order Butterworth filter between 0.05 and 3 Hz.

Parameters:

  • data (NDArray) –

    Signal

  • lowcut (float, default: 0.05 ) –

    Lower cutoff in Hz. Defaults to 0.05 Hz (3 bpm).

  • highcut (float, default: 3 ) –

    Upper cutoff in Hz. Defaults to 3 Hz (180 bpm).

  • 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.

  • forward_backward (bool, default: True ) –

    Apply filter forward and backward. Defaults to True.

Returns:

  • NDArray –

    npt.NDArray: Cleaned signal

Source code in physiokit/rsp/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
39
40
41
def clean(
    data: npt.NDArray,
    lowcut: float = 0.05,
    highcut: float = 3,
    sample_rate: float = 1000,
    order: int = 3,
    axis: int = -1,
    forward_backward: bool = True,
) -> npt.NDArray:
    """Clean respiratory signal using biquad filter.

    By default, applies a 3rd order Butterworth filter between 0.05 and 3 Hz.

    Args:
        data (npt.NDArray): Signal
        lowcut (float, optional): Lower cutoff in Hz. Defaults to 0.05 Hz (3 bpm).
        highcut (float, optional): Upper cutoff in Hz. Defaults to 3 Hz (180 bpm).
        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.
        forward_backward (bool, optional): Apply filter forward and backward. Defaults to True.

    Returns:
        npt.NDArray: Cleaned signal
    """

    # Bandpass filter
    return filter_signal(
        data=data,
        lowcut=lowcut,
        highcut=highcut,
        sample_rate=sample_rate,
        order=order,
        axis=axis,
        forward_backward=forward_backward,
    )