msn_kit/spectrum.rs
1// (c) Copyright 2021 Trent Hauck
2// All Rights Reserved
3//! A Spectrum is a set of peaks and associated metadata.
4
5use serde::{Deserialize, Serialize};
6use std::collections::HashMap;
7
8/// # Examples
9///
10/// The simplest spectrum with a single peak.
11///
12/// ```
13/// use std::collections::HashMap;
14///
15/// let s = msn_kit::spectrum::Spectrum::new(HashMap::<String, String>::new(), vec![1.0], vec![1.0]);
16/// assert_eq!(s.mz, vec![1.0]);
17/// assert_eq!(s.intensities, vec![1.0]);
18/// ```
19#[derive(Debug, PartialEq, Serialize, Deserialize)]
20pub struct Spectrum {
21 pub metadata: HashMap<String, String>,
22 pub mz: Vec<f64>,
23 pub intensities: Vec<f64>,
24}
25
26impl Spectrum {
27 /// Create a new Spectrum.
28 ///
29 /// # Arguments
30 ///
31 /// * `metadata` - The map of keys to values of the metadata.
32 /// * `mz` - The mass to charge ratio vector.
33 /// * `intensities` - The intensities vector.
34 ///
35 pub fn new(metadata: HashMap<String, String>, mz: Vec<f64>, intensities: Vec<f64>) -> Self {
36 Self {
37 metadata,
38 mz,
39 intensities,
40 }
41 }
42
43 /// Returns an empty is Spectrum.
44 ///
45 pub fn empty() -> Self {
46 Self {
47 metadata: HashMap::<String, String>::new(),
48 mz: Vec::<f64>::new(),
49 intensities: Vec::<f64>::new(),
50 }
51 }
52
53 /// Returns true if the Spectrum is empty.
54 ///
55 pub fn is_empty(&self) -> bool {
56 self.mz.is_empty() && self.intensities.is_empty() && self.metadata.is_empty()
57 }
58
59 /// Adds a key/value pair to the metadata.
60 pub fn add_metadata_field(&mut self, s: String, v: String) -> &mut Self {
61 self.metadata.insert(s, v);
62 self
63 }
64
65 /// Adds a vector of mzs.
66 pub fn add_mzs(&mut self, mz: Vec<f64>) -> &mut Self {
67 self.mz = mz;
68 self
69 }
70
71 /// Adds a vector of intensities.
72 pub fn add_intensities(&mut self, intensities: Vec<f64>) -> &mut Self {
73 self.intensities = intensities;
74 self
75 }
76}