sct-reader 0.5.0

A Rust crate for deserialising sector files used by online ATC clients such as EuroScope and VRC and converting them to a common 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
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116

use std::{fmt::Display, marker::PhantomData};

use super::{error::Error, SectorResult};

#[derive(Debug, Clone, Copy, PartialEq)]
pub struct Position<Status = MaybeValid> {
    pub lat: f64,
    pub lon: f64,
    status: std::marker::PhantomData<Status>,
}
impl Position {
    pub fn new(lat: f64, lon: f64) -> Position {
        Position {
            lat,
            lon,
            status: PhantomData,
        }
    }
    pub fn try_new_from_es(lat: &str, lon: &str) -> SectorResult<Position> {
        let lat = coord_from_es(lat).ok_or(Error::InvalidPosition)?;
        let lon = coord_from_es(lon).ok_or(Error::InvalidPosition)?;
        Ok(Position {
            lat,
            lon,
            status: PhantomData,
        })
    }
    pub fn validate(self) -> SectorResult<Position<Valid>> {
        let valid = (-90.0..=90.0).contains(&self.lat) && (-180.0..=180.0).contains(&self.lon);
        return if valid {
            Ok(Position {
                lat: self.lat,
                lon: self.lon,
                status: PhantomData,
            })
        } else {
            Err(Error::InvalidPosition)
        };
    }
}

impl From<Position<Valid>> for Position<MaybeValid> {
    fn from(value: Position<Valid>) -> Self {
        Position {
            lat: value.lat,
            lon: value.lon,
            status: PhantomData,
        }
    }
}

//N051.07.25.010
//E002.39.13.334
pub fn coord_from_es(value: &str) -> Option<f64> {
    let multiply_by = if value.starts_with(&['N', 'n', 'E', 'e']) {
        1.0
    } else {
        -1.0
    };
    let mut sections = value.get(1..)?.splitn(3, '.');
    let degs = sections.next()?.parse::<f64>().ok()?;
    let mins = sections.next()?.parse::<f64>().ok()?;
    let secs = sections.next()?.parse::<f64>().ok()?;

    let coord = degs + (mins / 60.0) + (secs / 3600.0);
    return Some(coord * multiply_by);
}

#[derive(Debug, Clone, Copy, PartialEq)]
pub struct Heading(f32);
impl Heading {
    pub fn new(heading: f32) -> SectorResult<Heading> {
        heading.try_into()
    }
    pub fn new_from_u16(heading: u16) -> SectorResult<Heading> {
        let value: f32 = heading.try_into().map_err(|_| Error::InvalidHeading)?;
        Self::new(value)
    }
    pub fn value(&self) -> f32 {
        self.0
    }
    pub fn value_u16(&self) -> u16 {
        self.0.round() as u16
    }
    pub fn reciprocal(&self) -> Heading {
        let new = if self.0 < 180.0 {
            self.0 + 180.0
        } else {
            self.0 - 180.0
        };
        Heading(new)
    }
}
impl Display for Heading {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        write!(f, "{:03}", self.0)
    }
}

impl TryFrom<f32> for Heading {
    type Error = Error;
    fn try_from(mut value: f32) -> Result<Self, Self::Error> {
        if value > 360.0 {
            return Err(Error::InvalidHeading);
        }
        if value == 0.0 {
            value = 360.0;
        }
        Ok(Heading(value))
    }
}

#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub struct MaybeValid;
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub struct Valid;