mseed 0.7.1

Bindings to libmseed for interoperating with miniSEED records.
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

//! Port of the [libmseed
//! `lm_pack_rollingbuffer.c`](https://github.com/EarthScope/libmseed/blob/develop/example/lm_pack_rollingbuffer.c)
//! example.
//!
//! For further information on how to use this example program, simply invoke:
//!
//! ```sh
//! cargo run --example pack-rollingbuffer -- --help
//! ```

use std::path::PathBuf;

use clap::Parser;

use mseed::{MSControlFlags, MSDataEncoding, MSReader, MSRecord, MSTraceList, TlPackInfo};

#[derive(Parser, Debug)]
#[command(author, version)]
#[command(about = "Illustrates using a trace list as an itermediate rolling buffer")]
#[command( long_about = None)]
struct Args {
    /// Path to miniSEED file.
    #[arg(value_name = "FILE")]
    in_file: PathBuf,
}

fn main() {
    let args = Args::parse();

    let mut mstl = MSTraceList::new().unwrap();

    let pack_info = TlPackInfo {
        encoding: MSDataEncoding::Steim2,
        rec_len: 256,
        extra_headers: None,
    };

    // A simple record handler callback function that parses and prints records
    let record_handler = |rec: &[u8]| {
        let mut buf = rec.to_vec();
        let msr = MSRecord::parse(&mut buf, MSControlFlags::MSF_UNPACKDATA).unwrap();

        print!("{}", msr.display(0));
    };

    // Create a reader
    let mut reader = MSReader::new_with_flags(
        args.in_file,
        MSControlFlags::MSF_VALIDATECRC | MSControlFlags::MSF_UNPACKDATA,
    )
    .unwrap();

    // Loop over the reader
    while let Some(msr) = reader.next() {
        let msr = msr.unwrap();

        mstl.insert(msr, true).unwrap();

        let (cnt_records, cnt_samples) = mseed::pack_trace_list(
            &mut mstl,
            record_handler,
            &pack_info,
            MSControlFlags::empty(),
        )
        .unwrap();

        println!(
            "mseed::pack_trace_list() created {} records containing {} samples, totally",
            cnt_records, cnt_samples
        );
    }

    // Final call to flush data buffers - now with `MSControlFlags::MSF_FLUSHDATA` enabled
    let (cnt_records, cnt_samples) = mseed::pack_trace_list(
        &mut mstl,
        record_handler,
        &pack_info,
        MSControlFlags::MSF_FLUSHDATA,
    )
    .unwrap();

    println!(
        "Final mseed::pack_trace_list() created {} records containing {} samples, totally",
        cnt_records, cnt_samples
    );
}