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

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

#[derive(Default, Clone, Copy, Debug, PartialEq, Eq)]
pub enum HeaderEncoding {
    #[default]
    UTF8,
    ANSI,
    Unknown,
}

static HEADER_ENCODING_REGEX: OnceLock<Regex> = OnceLock::new();

/// Returns HeaderEncoding::Unknown if no valid encoding was found
pub fn parse_header_encoding(textcontent: &str) -> HeaderEncoding {

    let re = HEADER_ENCODING_REGEX.get_or_init(|| {
        Regex::new(r"Codepage=([\w-]*)").unwrap() 
      });
    
    let caps = re.captures(textcontent);
    if caps.is_some() {
        let caps = caps.unwrap();
        caps.get(1).map_or(HeaderEncoding::Unknown, |m| {
            if m.as_str() == "UTF-8" {
                HeaderEncoding::UTF8
            } else if m.as_str() == "ANSI" {
                HeaderEncoding::ANSI
            } else {
                HeaderEncoding::Unknown
            }
        })
    } else {
        HeaderEncoding::Unknown
    }
}


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

    #[test]
    fn test_parse_header_encoding() {
        let input = "Brain Vision Data Exchange Header File Version 1.0
        ; Data created by the Vision Recorder
        
        [Common Infos]
        Codepage=UTF-8
        DataFormat=BINARY
        ; Data orientation: MULTIPLEXED=ch1,pt1, ch2,pt1 ...
        DataOrientation=MULTIPLEXED
        NumberOfChannels=71
        ; Sampling interval in microseconds
        SamplingInterval=2000
        
        [Binary Infos]
        BinaryFormat=IEEE_FLOAT_32
        
        [Channel Infos]
        ; Each entry: Ch<Channel number>=<Name>,<Reference channel name>,
        ; <Resolution in Unit>,<Unit>, Future extensions..
        ; Fields are delimited by commas, some fields might be omitted (empty).
        ; Commas in channel names are coded as \\1.
        Ch1=Fp1,,0.0488281,µV
        Ch2=Fz,,0.0488281,µV
        Ch3=F3,,0.0488281,µV
        Ch4=F7,,0.0488281,µV
        Ch5=FT9,,0.0488281,µV
        Ch6=FC5,,0.0488281,µV
        Ch7=FC1,,0.0488281,µV
        Ch8=C3,,0.0488281,µV
        Ch9=T7,,0.0488281,µV";
        let output = parse_header_encoding(input);
        let expected = HeaderEncoding::UTF8;
        assert_eq!(output, expected);
    }

    #[test]
    fn test_parse_header_encoding_empty() {
        let input = "[Common Infos]
        Codepage=
        DataFile=sadasdffs";
        let output = parse_header_encoding(input);
        let expected = HeaderEncoding::Unknown;
        assert_eq!(output, expected);
    }

}