ais 0.12.0

An Automatic Identification System (AIS) parser library
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

pub fn parse_speed_over_ground(data: u16) -> Option<f32> {
    match data {
        1023 => None,
        _ => Some(data as f32 / 10.0),
    }
}

pub fn parse_longitude(data: i32) -> Option<f32> {
    match data {
        108_600_000 => None,
        _ => Some(data as f32 / 600_000.0),
    }
}

pub fn parse_latitude(data: i32) -> Option<f32> {
    match data {
        54_600_000 => None,
        _ => Some(data as f32 / 600_000.0),
    }
}

pub fn parse_cog(data: u16) -> Option<f32> {
    match data {
        3600 => None,
        _ => Some(data as f32 / 10.0),
    }
}

pub fn parse_heading(data: u16) -> Option<u16> {
    match data {
        511 => None,
        _ => Some(data),
    }
}

#[derive(Debug, PartialEq, Eq, Copy, Clone)]
pub enum Accuracy {
    Unaugmented,
    Dgps,
}

impl Accuracy {
    pub fn parse(data: u8) -> Self {
        match data {
            0 => Self::Unaugmented,
            1 => Self::Dgps,
            _ => unreachable!(),
        }
    }
}

#[derive(Debug, Copy, Clone, PartialEq, Eq)]
pub struct RateOfTurn {
    raw: i8,
}

#[derive(Debug, PartialEq, Eq, Copy, Clone)]
pub enum Direction {
    Port,
    Starboard,
}

impl RateOfTurn {
    pub fn parse(data: u8) -> Option<Self> {
        #[allow(overflowing_literals)]
        match data as i8 {
            128 => None, // does indeed encode as 0x80
            -127..=127 => Some(RateOfTurn { raw: data as i8 }),
        }
    }

    pub fn rate(self) -> Option<f32> {
        match self.raw {
            -126..=126 => Some((self.raw as f32 / 4.733) * (self.raw as f32 / 4.733)),
            -127 => None,
            127 => None,
            _ => unreachable!(),
        }
    }

    pub fn direction(self) -> Option<Direction> {
        match self.raw {
            0 => None,
            1..=127 => Some(Direction::Starboard),
            -127..=-1 => Some(Direction::Port),
            _ => unreachable!(),
        }
    }
}

#[derive(Debug, PartialEq, Eq, Copy, Clone)]
pub enum ManeuverIndicator {
    NoSpecialManeuver,
    SpecialManeuver,
    Unknown(u8),
}
impl ManeuverIndicator {
    pub fn parse(data: u8) -> Option<Self> {
        match data {
            0 => None,
            1 => Some(Self::NoSpecialManeuver),
            2 => Some(Self::SpecialManeuver),
            _ => Some(Self::Unknown(data)),
        }
    }
}