mrc 0.6.0

MRC-2014 file format reader/writer for cryo-EM — SIMD-accelerated, mmap-enabled
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

// ============================================================================
// MRCO — legacy MRC format
// ============================================================================

#[cfg(feature = "serde")]
use serde::{Deserialize, Serialize};

/// Size of a single MRCO record, in bytes.
pub const MRCO_RECORD_SIZE: usize = 80;

/// A legacy MRCO extended header record.
///
/// The MRCO format uses the same 80-byte record size as CCP4 but stores
/// different metadata.  The exact byte layout is not fully standardised
/// across implementations; this struct stores the raw bytes for
/// interpretation by the caller.
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
#[derive(Debug, Clone, PartialEq)]
pub struct MrcoRecord {
    /// Raw 80-byte MRCO record.
    #[cfg_attr(feature = "serde", serde(with = "crate::serde_byte_array"))]
    pub raw: [u8; MRCO_RECORD_SIZE],
}

impl MrcoRecord {
    /// Parse a single MRCO record from bytes.
    pub fn from_bytes(bytes: &[u8]) -> Option<Self> {
        if bytes.len() < MRCO_RECORD_SIZE {
            return None;
        }
        let mut raw = [0u8; MRCO_RECORD_SIZE];
        raw.copy_from_slice(&bytes[..MRCO_RECORD_SIZE]);
        Some(Self { raw })
    }
}

crate::impl_record_parser!(MrcoRecord, MRCO_RECORD_SIZE, parse_mrco_records);

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

    #[test]
    fn mrco_roundtrip() {
        let buf = vec![42u8; MRCO_RECORD_SIZE];
        let records = super::parse_mrco_records(&buf).unwrap();
        assert_eq!(records.len(), 1);
        assert_eq!(records[0].raw[0], 42);
    }

    #[test]
    fn mrco_empty() {
        assert!(super::parse_mrco_records(&[]).is_none());
    }
}