bvreader 0.1.5

Reader for the BrainVision data format
Documentation 
1
2
3
4
5
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
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152

use regex::Regex;
use std::sync::OnceLock;

use crate::bv_reader::generic_parser::parse_generic_value;

static AMP_NUMCHAN_REGEX: OnceLock<Regex> = OnceLock::new();
/// Returns None if no channel data was found
pub fn parse_amp_numchan(textcontent: &str) -> Option<usize> {

    let re = AMP_NUMCHAN_REGEX.get_or_init(|| {
        Regex::new(r"Number of channels: (\d*)").unwrap() 
      });
    
    parse_generic_value::<usize>(textcontent, re)
}

static AMP_SR_REGEX: OnceLock<Regex> = OnceLock::new();
/// Returns None if no sampling rate was found
pub fn parse_amp_samplingrate(textcontent: &str) -> Option<usize> {

    let re = AMP_SR_REGEX.get_or_init(|| {
        Regex::new(r"Sampling Rate \[Hz\]: (\d*)").unwrap() 
      });
    
    parse_generic_value::<usize>(textcontent, re)
}

static AMP_SI_REGEX: OnceLock<Regex> = OnceLock::new();
/// Returns None if no sampling interval was found
pub fn parse_amp_samplinginterval(textcontent: &str) -> Option<usize> {

    let re = AMP_SI_REGEX.get_or_init(|| {
        Regex::new(r"Sampling Interval \[µS\]: (\d*)").unwrap() 
      });
    
    parse_generic_value::<usize>(textcontent, re)
}


#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn test_parse_amp_numchan() {
        let input = "
        [Comment]

        BrainVision Recorder Professional   -   V. 1.21.0201
        
        
        A m p l i f i e r  S e t u p
        ============================
        Number of channels: 71
        Sampling Rate [Hz]: 500
        Sampling Interval [µS]: 2000";
        let output = parse_amp_numchan(input).unwrap();
        let expected = 71;
        assert_eq!(output, expected);
    }

    #[test]
    fn test_parse_amp_numchan_empty() {
        let input = "
        [Comment]

        BrainVision Recorder Professional   -   V. 1.21.0201
        
        
        A m p l i f i e r  S e t u p
        ============================
        Number of channels:
        Sampling Rate [Hz]:
        Sampling Interval [µS]:";
        let output = parse_amp_numchan(input);
        let expected = Option::None;
        assert_eq!(output, expected);
    }

    #[test]
    fn test_parse_amp_samplingrate() {
        let input = "
        [Comment]

        BrainVision Recorder Professional   -   V. 1.21.0201
        
        
        A m p l i f i e r  S e t u p
        ============================
        Number of channels: 71
        Sampling Rate [Hz]: 500
        Sampling Interval [µS]: 2000";
        let output = parse_amp_samplingrate(input).unwrap();
        let expected = 500;
        assert_eq!(output, expected);
    }

    #[test]
    fn test_parse_amp_samplingrate_empty() {
        let input = "
        [Comment]

        BrainVision Recorder Professional   -   V. 1.21.0201
        
        
        A m p l i f i e r  S e t u p
        ============================
        Number of channels:
        Sampling Rate [Hz]:
        Sampling Interval [µS]:";
        let output = parse_amp_samplingrate(input);
        let expected = Option::None;
        assert_eq!(output, expected);
    }

    #[test]
    fn test_parse_amp_samplinginterval() {
        let input = "
        [Comment]

        BrainVision Recorder Professional   -   V. 1.21.0201
        
        
        A m p l i f i e r  S e t u p
        ============================
        Number of channels: 71
        Sampling Rate [Hz]: 500
        Sampling Interval [µS]: 2000";
        let output = parse_amp_samplinginterval(input).unwrap();
        let expected = 2000;
        assert_eq!(output, expected);
    }

    #[test]
    fn test_parse_amp_samplinginterval_empty() {
        let input = "
        [Comment]

        BrainVision Recorder Professional   -   V. 1.21.0201
        
        
        A m p l i f i e r  S e t u p
        ============================
        Number of channels:
        Sampling Rate [Hz]:
        Sampling Interval [µS]:";
        let output = parse_amp_samplinginterval(input);
        let expected = Option::None;
        assert_eq!(output, expected);
    }

}