cad-cs 0.1.0-beta.2

Calculations on Coordinate Systems (2D/3D geometry, vectors, transformations)
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

// 📃 ./src/libs/cs/model.rs
use crate::libs::angle::Angle;

// =============================================================================
// 1. RDZEŃ GENERYCZNY (BASE MODEL)
// =============================================================================

/// 📚 【 POL】: Generyczny wrapper dla tablic o stałym rozmiarze, ograniczony do wymiarów 2D i 3D.
/// 📚 【 ENG】: Generic wrapper for fixed-size arrays, restricted to 2D and 3D dimensions.
///
/// ⚠️ 【 POL】: Implementacja ściśle ograniczona do N=2 lub N=3. Inne wymiary nie są wspierane.
/// ⚠️ 【 ENG】: Implementation strictly limited to N=2 or N=3. Other dimensions are not supported.
#[derive(Debug, Clone, Copy, PartialEq)]
pub struct Cs<const N: usize>(pub [f64; N]);

// =============================================================================
// 2. STRUKTURY DANYCH WSPÓŁRZĘDNYCH (COORDS MODELS)
// =============================================================================

// --- KARTEZJAŃSKIE ---

/// 📚 【 POL】: Współrzędne 2D w układzie kartezjańskim.
/// 📚 【 ENG】: 2D coordinates in the Cartesian system.
/// 💡 Może reprezentować dowolną płaszczyznę rzutowania (XY, XZ, YZ) traktowaną jako przestrzeń dwuwymiarowa.
/// 💡 Can represent any projection plane (XY, XZ, YZ) treated as a two-dimensional space.
#[derive(Debug, Clone, Copy, PartialEq)]
pub struct CoordsXy {
	pub x: f64,
	pub y: f64,
}

/// 📚 【 POL】: Współrzędne 3D w układzie kartezjańskim (Przestrzeń XYZ).
/// 📚 【 ENG】: 3D coordinates in the Cartesian system (XYZ Space).
#[derive(Debug, Clone, Copy, PartialEq)]
pub struct CoordsXyz {
	pub x: f64,
	pub y: f64,
	pub z: f64,
}

// --- BIEGUNOWE I CYLINDRYCZNE ---

/// 📚 【 POL】: Współrzędne 2D w układzie biegunowym (Promień, Azymut).
/// 📚 【 ENG】: 2D coordinates in the Polar system (Radius, Azimuth).
/// 💡 Może reprezentować dowolną płaszczyznę rzutowania (XY, XZ, YZ) traktowaną jako przestrzeń dwuwymiarowa.
/// 💡 Can represent any projection plane (XY, XZ, YZ) treated as a two-dimensional space.
#[derive(Debug, Clone, Copy, PartialEq)]
pub struct CoordsPolar {
	pub r_d2: f64,
	pub f_y_x: f64, // w radianach
}

/// 📚 【 POL】: Współrzędne 3D w układzie cylindrycznym względem osi Z.
/// 📚 【 ENG】: 3D coordinates in the Cylindrical system relative to the Z-axis.
#[derive(Debug, Clone, Copy, PartialEq)]
pub struct CoordsCylindricalZ {
	pub r_d2: f64,
	pub f_y_x: f64, // w radianach
	pub z: f64,
}

/// 📚 【 POL】: Współrzędne 3D w układzie cylindrycznym względem osi Y.
/// 📚 【 ENG】: 3D coordinates in the Cylindrical system relative to the Y-axis.
#[derive(Debug, Clone, Copy, PartialEq)]
pub struct CoordsCylindricalY {
	pub r_d2: f64,
	pub f_z_x: f64, // w radianach
	pub y: f64,
}

/// 📚 【 POL】: Współrzędne 3D w układzie cylindrycznym względem osi X.
/// 📚 【 ENG】: 3D coordinates in the Cylindrical system relative to the X-axis.
#[derive(Debug, Clone, Copy, PartialEq)]
pub struct CoordsCylindricalX {
	pub r_d2: f64,
	pub f_z_y: f64, // w radianach
	pub x: f64,
}

// --- SFERYCZNE I GEOGRAFICZNE ---

/// 📚 【 POL】: Współrzędne 3D w układzie sferycznym (Promień, Azymut, Inklinacja).
/// 📚 【 ENG】: 3D coordinates in the Spherical system (Radius, Azimuth, Inclination).
#[derive(Debug, Clone, Copy, PartialEq)]
pub struct CoordsSpherical {
	pub r_d3: f64,
	pub f_y_x: f64, // w radianach (Azymut w płaszczyźnie XY)
	pub t_z_r: f64, // w radianach (Inklinacja od osi Z)
}

// 📚 【 POL】: Współrzędne geograficzne w formacie DMS (Stopnie, Minuty, Sekundy).
/// 📚 【 ENG】: Geographic coordinates in DMS format (Degrees, Minutes, Seconds).
/// 🗺️ Orientacja: Nz90Ex0 (Oś Z: Biegun N, Oś X: Greenwich).
#[derive(Debug, Clone, Copy, PartialEq)]
pub struct CoordsSphericalEcefSnWeDms {
	pub sn_lat_d: i8,  // Szerokość stopnie (-90 do 90)
	pub sn_lat_m: u8,  // Szerokość minuty (0 do 59)
	pub sn_lat_s: f32, // Szerokość sekundy (0.0 do 59.99999)
	pub we_lon_d: i16, // Długość stopnie (-180 do 180)
	pub we_lon_m: u8,  // Długość minuty (0 do 59)
	pub we_lon_s: f32, // Długość sekundy (0.0 do 59.99999)
	                   //pub alt: f64,    // Wysokość nad poziomem morza (m)
}

/// 📚 【 POL】: Współrzędne geograficzne w formacie DDD (Stopnie Dziesiętne).
/// 📚 【 ENG】: Geographic coordinates in DDD format (Decimal Degrees).
/// 🗺️ Orientacja: Nz90Ex0 (Oś Z: Biegun N, Oś X: Greenwich).
#[derive(Debug, Clone, Copy, PartialEq)]
pub struct CoordsSphericalEcefSnWeDdd {
	pub sn_lat: Angle, // Szerokość (-90.0 do 90.0)
	pub we_lon: Angle, // Długość (-180.0 do 180.0)
	                   //pub alt: f64,    // Wysokość nad poziomem morza (m)
}