gnss-rtk 0.8.0

GNSS position solver
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
117
118
119
120
121
122

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

fn default_sv_clock() -> bool {
    true
}

fn default_group_delay() -> bool {
    true
}

fn default_ionospheric_bias() -> bool {
    true
}

fn default_tropospheric_bias() -> bool {
    true
}

fn default_earth_rot() -> bool {
    true
}

fn default_relativistic_clock() -> bool {
    true
}

fn default_relativistic_path() -> bool {
    true
}

fn default_phase_windup() -> bool {
    false
}

fn default_solid_tides() -> bool {
    false
}

/// Atmospherical, Physical and Environmental modeling
#[derive(Copy, Clone, Debug, PartialEq)]
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
pub struct Modeling {
    /// Compensate for onboard clock offset to system time (+/- 100km)
    #[cfg_attr(feature = "serde", serde(default = "default_sv_clock"))]
    pub sv_clock_bias: bool,

    /// Compensate for onboard transmission delay (+/- 1m)
    #[cfg_attr(feature = "serde", serde(default = "default_group_delay"))]
    pub sv_total_group_delay: bool,

    /// Compensate for relativistic effect on onboard clock (+/- 1m)
    #[cfg_attr(feature = "serde", serde(default = "default_relativistic_clock"))]
    pub relativistic_clock_bias: bool,

    /// Compensate for relativistic effect on signal propagation (+/- 0.1 m)
    #[cfg_attr(feature = "serde", serde(default = "default_relativistic_path"))]
    pub relativistic_path_range: bool,

    /// Compensate for troposphere negative impact (+/- 10m)
    #[cfg_attr(feature = "serde", serde(default = "default_tropospheric_bias"))]
    pub tropospheric_bias: bool,

    /// Compensate for ionospheric negative impact (+/- 20m)
    /// Starting from [Method::CPP] and on, this value is disregarded as the
    /// measurement strategy allows to physically canceled this phenomenon,
    /// which is always prefered.
    #[cfg_attr(feature = "serde", serde(default = "default_ionospheric_bias"))]
    pub ionospheric_bias: bool,

    /// Compensate for Earth rotation during signal propagation
    /// (static +5/+10m eastern error).
    #[cfg_attr(feature = "serde", serde(default = "default_earth_rot"))]
    pub earth_rotation: bool,

    /// Compensate for signal phase windup. This only impacts
    /// strategies that use raw phase like [Method::PPP].
    #[cfg_attr(feature = "serde", serde(default = "default_phase_windup"))]
    pub phase_windup: bool,

    /// Compensate for crust (solid body) deformation due to moon and star
    /// gravitational effect.
    #[cfg_attr(feature = "serde", serde(default = "default_solid_tides"))]
    pub solid_tides: bool,
}

impl Default for Modeling {
    fn default() -> Self {
        Self {
            sv_clock_bias: default_sv_clock(),
            solid_tides: default_solid_tides(),
            earth_rotation: default_earth_rot(),
            phase_windup: default_phase_windup(),
            sv_total_group_delay: default_group_delay(),
            ionospheric_bias: default_ionospheric_bias(),
            tropospheric_bias: default_tropospheric_bias(),
            relativistic_clock_bias: default_relativistic_clock(),
            relativistic_path_range: default_relativistic_path(),
        }
    }
}

impl Modeling {
    /// Defines a new [Modeling] structure without any of the
    /// compensation enabled, that you can then customize.
    /// This is intended for teaching purposes only.
    /// Until [Modeling.sv_clock_bias] is enabled, your solution
    /// will be off by hundreds of kilometers.
    pub fn no_modeling() -> Modeling {
        Modeling {
            sv_clock_bias: false,
            sv_total_group_delay: false,
            relativistic_clock_bias: false,
            relativistic_path_range: false,
            tropospheric_bias: false,
            ionospheric_bias: false,
            earth_rotation: false,
            phase_windup: false,
            solid_tides: false,
        }
    }
}