a5 0.7.3

High-performance Rust implementation of the A5 hierarchical spatial indexing system
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

// A5
// SPDX-License-Identifier: Apache-2.0
// Copyright (c) A5 contributors

use crate::coordinate_systems::{Polar, Radians, Spherical};

/// Gnomonic projection implementation that converts between spherical and polar coordinates.
pub struct GnomonicProjection;

impl GnomonicProjection {
    /// Projects spherical coordinates to polar coordinates using gnomonic projection
    ///
    /// # Arguments
    ///
    /// * `spherical` - Spherical coordinates [theta, phi]
    ///
    /// # Returns
    ///
    /// Polar coordinates [rho, gamma]
    pub fn forward(&self, spherical: Spherical) -> Polar {
        let theta = spherical.theta();
        let phi = spherical.phi();
        Polar::new(phi.get().tan(), theta)
    }

    /// Unprojects polar coordinates to spherical coordinates using gnomonic projection
    ///
    /// # Arguments
    ///
    /// * `polar` - Polar coordinates [rho, gamma]
    ///
    /// # Returns
    ///
    /// Spherical coordinates [theta, phi]
    pub fn inverse(&self, polar: Polar) -> Spherical {
        let rho = polar.rho();
        let gamma = polar.gamma();
        Spherical::new(gamma, Radians::new_unchecked(rho.atan()))
    }
}