affn 0.7.0

Affine geometry primitives: strongly-typed coordinate systems, reference frames, and centers for scientific computing.
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

//! Serde implementations for Spherical coordinate types.

use super::Position;
use crate::centers::ReferenceCenter;
use crate::frames::SphericalNaming;
use crate::serde_utils::{collect_field, is_zero_sized, skip_unknown, take_required};
use qtty::angular::Degrees;
use qtty::length::LengthUnit;
use qtty::Quantity;
use serde::de::{MapAccess, Visitor};
use serde::ser::SerializeStruct;
use serde::Serializer;
use serde::{Deserialize, Serialize};
use std::fmt;
use std::marker::PhantomData;

impl<C, F, U> Serialize for Position<C, F, U>
where
    C: ReferenceCenter,
    C::Params: Serialize,
    F: SphericalNaming,
    U: LengthUnit,
{
    fn serialize<S: Serializer>(&self, serializer: S) -> Result<S::Ok, S::Error> {
        let polar_name = F::polar_name();
        let azimuth_name = F::azimuth_name();
        let distance_name = F::distance_name();
        let has_params = !is_zero_sized(&self.center_params);

        let field_count = if has_params { 4 } else { 3 };
        let mut state = serializer.serialize_struct("Position", field_count)?;
        state.serialize_field(polar_name, &self.polar)?;
        state.serialize_field(azimuth_name, &self.azimuth)?;
        state.serialize_field(distance_name, &self.distance)?;
        if has_params {
            state.serialize_field("center_params", self.center_params())?;
        }
        state.end()
    }
}

impl<'de, C, F, U> Deserialize<'de> for Position<C, F, U>
where
    C: ReferenceCenter,
    C::Params: Deserialize<'de> + Default,
    F: SphericalNaming,
    U: LengthUnit,
{
    fn deserialize<D: serde::Deserializer<'de>>(deserializer: D) -> Result<Self, D::Error> {
        struct PositionVisitor<C, F, U>(PhantomData<(C, F, U)>);

        impl<'de, C, F, U> Visitor<'de> for PositionVisitor<C, F, U>
        where
            C: ReferenceCenter,
            C::Params: Deserialize<'de> + Default,
            F: SphericalNaming,
            U: LengthUnit,
        {
            type Value = Position<C, F, U>;

            fn expecting(&self, formatter: &mut fmt::Formatter) -> fmt::Result {
                write!(
                    formatter,
                    "a spherical position with '{}', '{}', and '{}' fields",
                    F::polar_name(),
                    F::azimuth_name(),
                    F::distance_name()
                )
            }

            fn visit_map<M: MapAccess<'de>>(self, mut map: M) -> Result<Self::Value, M::Error> {
                let polar_name = F::polar_name();
                let azimuth_name = F::azimuth_name();
                let distance_name = F::distance_name();

                let mut polar: Option<Degrees> = None;
                let mut azimuth: Option<Degrees> = None;
                let mut distance: Option<Quantity<U>> = None;
                let mut center_params: Option<C::Params> = None;

                while let Some(key) = map.next_key::<String>()? {
                    if key == polar_name {
                        collect_field(&mut polar, polar_name, &mut map)?;
                    } else if key == azimuth_name {
                        collect_field(&mut azimuth, azimuth_name, &mut map)?;
                    } else if key == distance_name {
                        collect_field(&mut distance, distance_name, &mut map)?;
                    } else if key == "center_params" {
                        collect_field(&mut center_params, "center_params", &mut map)?;
                    } else {
                        skip_unknown(&mut map)?;
                    }
                }

                let polar = take_required(polar, polar_name)?;
                let azimuth = take_required(azimuth, azimuth_name)?;
                let distance = take_required(distance, distance_name)?;
                let center_params = center_params.unwrap_or_default();

                Ok(Position::new_with_params(
                    center_params,
                    polar,
                    azimuth,
                    distance,
                ))
            }
        }

        deserializer.deserialize_map(PositionVisitor(PhantomData))
    }
}