coordinate-system 7.0.0__cp313-cp313-win_amd64.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,9 @@
1
+ MIT License
2
+
3
+ Copyright (c) [2024] [PanGuoJun]
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
6
+
7
+ 1. The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
8
+
9
+ 2. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
@@ -0,0 +1,312 @@
1
+ Metadata-Version: 2.1
2
+ Name: coordinate_system
3
+ Version: 7.0.0
4
+ Summary: High-performance 3D coordinate system library with unified differential geometry, quantum frame algebra, and Christmas Equation (CFUT)
5
+ Home-page: https://github.com/panguojun/Coordinate-System
6
+ Author: PanGuoJun
7
+ Author-email: PanGuoJun <18858146@qq.com>
8
+ License: MIT
9
+ Project-URL: Homepage, https://github.com/panguojun/Coordinate-System
10
+ Project-URL: Documentation, https://github.com/panguojun/Coordinate-System/blob/main/README.md
11
+ Project-URL: Repository, https://github.com/panguojun/Coordinate-System
12
+ Project-URL: Bug Reports, https://github.com/panguojun/Coordinate-System/issues
13
+ Project-URL: DOI, https://zenodo.org/records/14435613
14
+ Keywords: 3d,math,vector,quaternion,coordinate-system,geometry,differential-geometry,curvature,spectral-analysis,christmas-equation,cfut,unified-field-theory,complex-frame
15
+ Platform: Windows
16
+ Platform: Linux
17
+ Platform: macOS
18
+ Platform: Android
19
+ Platform: iOS
20
+ Classifier: Development Status :: 5 - Production/Stable
21
+ Classifier: Intended Audience :: Developers
22
+ Classifier: Intended Audience :: Science/Research
23
+ Classifier: Topic :: Software Development :: Libraries :: Python Modules
24
+ Classifier: Topic :: Scientific/Engineering :: Mathematics
25
+ Classifier: Topic :: Scientific/Engineering :: Physics
26
+ Classifier: License :: OSI Approved :: MIT License
27
+ Classifier: Programming Language :: Python :: 3
28
+ Classifier: Programming Language :: Python :: 3.7
29
+ Classifier: Programming Language :: Python :: 3.8
30
+ Classifier: Programming Language :: Python :: 3.9
31
+ Classifier: Programming Language :: Python :: 3.10
32
+ Classifier: Programming Language :: Python :: 3.11
33
+ Classifier: Programming Language :: Python :: 3.12
34
+ Classifier: Programming Language :: Python :: 3.13
35
+ Classifier: Programming Language :: C++
36
+ Classifier: Operating System :: Microsoft :: Windows
37
+ Classifier: Operating System :: POSIX :: Linux
38
+ Classifier: Operating System :: MacOS
39
+ Requires-Python: >=3.7
40
+ Description-Content-Type: text/markdown
41
+ License-File: LICENSE
42
+ Requires-Dist: numpy>=1.19.0
43
+ Requires-Dist: matplotlib>=3.3.0
44
+
45
+ # Coordinate System Library
46
+
47
+ **High-performance 3D coordinate system and differential geometry library for Python**
48
+
49
+ [![PyPI version](https://badge.fury.io/py/coordinate-system.svg)](https://pypi.org/project/coordinate-system/)
50
+ [![Python](https://img.shields.io/pypi/pyversions/coordinate-system.svg)](https://pypi.org/project/coordinate-system/)
51
+ [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
52
+
53
+ **Author:** PanGuoJun
54
+ **Version:** 7.0.0-alpha
55
+ **License:** MIT
56
+ **DOI:** [10.5281/zenodo.14435613](https://zenodo.org/records/14435613)
57
+
58
+ ---
59
+
60
+ ## What's New in v7.0.0-alpha (2026-01-14)
61
+
62
+ - **🎄 Christmas Equation**: New `complex_geometric_physics` module implementing unified field theory
63
+ - **Complex Frame Unified Theory (CFUT)**: Geometry + Topology = Complex Matter + Topological Force
64
+ - **Einstein Tensor**: Compute Ĝ_μν from complex frame field U(x)
65
+ - **Chern-Simons Current**: Topological current K̄_μ for gauge field analysis
66
+ - **Energy-Momentum Tensor**: Real-imaginary decomposition for matter and topology
67
+ - **Complete English Translation**: All code documentation now in English for worldwide use
68
+
69
+ ---
70
+
71
+ ## Module Structure
72
+
73
+ ```
74
+ coordinate_system/
75
+ ├── coordinate_system.pyd/.so # C++ core (vec3, quat, coord3)
76
+ ├── complex_geometric_physics.py # 🎄 Christmas Equation, CFUT unified theory
77
+ ├── spectral_geometry.py # FourierFrame [GL(1,C)], spectral analysis
78
+ ├── u3_frame.py # U3Frame [U(3)], gauge field theory
79
+ ├── differential_geometry.py # Surface curvature calculation
80
+ ├── visualization.py # 3D visualization
81
+ └── curve_interpolation.py # C2-continuous interpolation
82
+ ```
83
+
84
+ ## Group Correspondence
85
+
86
+ | Class | Group | DOF | Use Case |
87
+ |-------|-------|-----|----------|
88
+ | `coord3` | Sim(3) = R³ ⋊ (SO(3) × R⁺) | 10 | 3D coordinate transform |
89
+ | `ComplexFrame` | U(3) complex field | 18 | 🎄 Unified field theory (CFUT) |
90
+ | `FourierFrame` | GL(1,C) = U(1) × R⁺ | 2 | Spectral geometry, heat kernel |
91
+ | `U3Frame` | U(3) = SU(3) × U(1) | 9 | Gauge field theory |
92
+
93
+ ---
94
+
95
+ ## Installation
96
+
97
+ ```bash
98
+ pip install coordinate-system
99
+ ```
100
+
101
+ ---
102
+
103
+ ## Quick Start
104
+
105
+ ### Basic Coordinate System
106
+
107
+ ```python
108
+ from coordinate_system import vec3, quat, coord3
109
+
110
+ # Vector operations
111
+ v1 = vec3(1, 2, 3)
112
+ v2 = vec3(4, 5, 6)
113
+ dot = v1.dot(v2)
114
+ cross = v1.cross(v2)
115
+
116
+ # Quaternion rotation
117
+ q = quat(1.5708, vec3(0, 0, 1)) # 90° around Z
118
+ rotated = q * v1
119
+
120
+ # Coordinate transform
121
+ frame = coord3.from_angle(1.57, vec3(0, 0, 1))
122
+ world_pos = v1 * frame # Local -> World
123
+ local_pos = world_pos / frame # World -> Local
124
+ ```
125
+
126
+ ### Differential Geometry
127
+
128
+ ```python
129
+ from coordinate_system import Sphere, compute_gaussian_curvature
130
+
131
+ sphere = Sphere(radius=1.0)
132
+ K = compute_gaussian_curvature(sphere, u=0.5, v=0.5) # K = 1.0
133
+ ```
134
+
135
+ **Gaussian Curvature via Lie Bracket:**
136
+ $$K = -\frac{\langle [G_u, G_v] e_v, e_u \rangle}{\sqrt{\det(g)}}$$
137
+
138
+ ### Spectral Geometry (FourierFrame)
139
+
140
+ ```python
141
+ from coordinate_system import (
142
+ FourierFrame, IntrinsicGradient, BerryPhase, ChernNumber, HeatKernel
143
+ )
144
+
145
+ # Create frame field
146
+ frame_field = [[FourierFrame(q_factor=1.0 + 0.1j*(i+j))
147
+ for j in range(16)] for i in range(16)]
148
+
149
+ # Intrinsic gradient: G_μ = d/dx^μ log Q
150
+ grad_op = IntrinsicGradient(frame_field)
151
+
152
+ # Berry phase: γ = ∮ G_μ dx^μ
153
+ berry = BerryPhase(grad_op)
154
+ path = [(4, 4), (4, 12), (12, 12), (12, 4), (4, 4)]
155
+ gamma = berry.compute_along_path(path, closed=True)
156
+
157
+ # Heat kernel trace
158
+ heat = HeatKernel(frame_field)
159
+ trace = heat.trace(t=0.1)
160
+ ```
161
+
162
+ ### Gauge Field Theory (U3Frame)
163
+
164
+ ```python
165
+ from coordinate_system import U3Frame, GaugeConnection, FieldStrength
166
+ import numpy as np
167
+
168
+ # Create U(3) frame
169
+ frame = U3Frame()
170
+
171
+ # Symmetry decomposition: U(3) = SU(3) × U(1)
172
+ su3_comp, u1_phase = frame.to_su3_u1()
173
+
174
+ # Gauge transforms
175
+ frame_u1 = frame.gauge_transform_u1(np.pi/4)
176
+ frame_su3 = frame.gauge_transform_su3(np.random.randn(8) * 0.1)
177
+
178
+ # Gauge connection and field strength
179
+ conn_x = GaugeConnection(su3_component=np.random.randn(8) * 0.1)
180
+ conn_y = GaugeConnection(su3_component=np.random.randn(8) * 0.1)
181
+ F_xy = conn_x.field_strength(conn_y)
182
+
183
+ # Yang-Mills action
184
+ S_YM = F_xy.yang_mills_action()
185
+ ```
186
+
187
+ ### 🎄 Complex Geometric Physics (Christmas Equation)
188
+
189
+ ```python
190
+ from coordinate_system import (
191
+ ComplexFrame,
192
+ EnergyMomentumTensor,
193
+ ChristmasEquation,
194
+ create_flat_spacetime_frame,
195
+ create_curved_spacetime_frame,
196
+ create_gauge_field_frame,
197
+ M_PLANCK,
198
+ LAMBDA_TOPO
199
+ )
200
+ import numpy as np
201
+
202
+ # Create complex frames
203
+ flat_frame = create_flat_spacetime_frame()
204
+ curved_frame = create_curved_spacetime_frame(curvature=0.1)
205
+ gauge_frame = create_gauge_field_frame(field_strength=0.1)
206
+
207
+ # Initialize Christmas Equation solver
208
+ solver = ChristmasEquation()
209
+ print(f"Planck mass: {solver.M_P:.3e} GeV")
210
+ print(f"Topological coupling: {solver.lambda_topo:.4f}")
211
+
212
+ # Compute geometric quantities
213
+ G_tensor = solver.einstein_tensor(curved_frame)
214
+ K_current = solver.chern_simons_current(gauge_frame)
215
+
216
+ # Create matter energy-momentum tensor
217
+ matter_real = np.diag([1.0, 0.1, 0.1, 0.1])
218
+ matter_imag = np.zeros((4, 4))
219
+ T_matter = EnergyMomentumTensor(matter_real, matter_imag)
220
+
221
+ # Solve the Christmas Equation
222
+ # M_P²/2 Ĝ_μν[U] + λ/(32π²) ∇̂_(μ K̄_ν)[U] = T̂_μν^(top)[U] + T̂_μν^(mat)
223
+ solution = solver.solve_christmas_equation(gauge_frame, T_matter)
224
+ print(f"Geometric term norm: {np.linalg.norm(solution['geometric_term']):.6e}")
225
+ print(f"Topological term norm: {np.linalg.norm(solution['topological_term']):.6e}")
226
+ print(f"Equation balanced: {solution['balanced']}")
227
+ ```
228
+
229
+ **The Christmas Equation** unifies geometry and topology:
230
+ - **Left side**: Geometry (Einstein tensor) + Topology (Chern-Simons current)
231
+ - **Right side**: Topological source + Matter source
232
+ - **Real part U^(R)**: Geometric properties (metric, curvature, spacetime)
233
+ - **Imaginary part U^(I)**: Topological properties (phase winding, gauge symmetry)
234
+
235
+ ---
236
+
237
+ ## Key Formulas
238
+
239
+ | Concept | Formula | Code |
240
+ |---------|---------|------|
241
+ | 🎄 **Christmas Equation** | $\frac{M_P^2}{2} \hat{G}_{\mu\nu}[U] + \frac{\lambda}{32\pi^2} \hat{\nabla}_{(\mu} \bar{K}_{\nu)}[U] = \hat{T}_{\mu\nu}^{(\text{top})}[U] + \hat{T}_{\mu\nu}^{(\text{mat})}$ | `ChristmasEquation.solve_christmas_equation()` |
242
+ | Einstein Tensor | $\hat{G}_{\mu\nu} = R_{\mu\nu} - \frac{1}{2}g_{\mu\nu} R$ | `ChristmasEquation.einstein_tensor()` |
243
+ | Chern-Simons Current | $\bar{K}_\mu = \varepsilon_{\mu\nu\rho\sigma} \text{Tr}(A^\nu F^{\rho\sigma})$ | `ChristmasEquation.chern_simons_current()` |
244
+ | Intrinsic Gradient | $G_\mu = \frac{d}{dx^\mu} \log C(x)$ | `IntrinsicGradient` |
245
+ | Curvature Tensor | $R_{\mu\nu} = [G_\mu, G_\nu]$ | `CurvatureFromFrame` |
246
+ | Gaussian Curvature | $K = -\langle [G_u, G_v] e_v, e_u \rangle / \sqrt{\det g}$ | `compute_gaussian_curvature` |
247
+ | Berry Phase | $\gamma = \oint G_\mu dx^\mu$ | `BerryPhase` |
248
+ | Chern Number | $c_1 = \frac{1}{2\pi} \iint R_{\mu\nu} dS$ | `ChernNumber` |
249
+ | Heat Kernel | $\text{Tr}(e^{t\Delta}) \sim (4\pi t)^{-d/2} \sum_k a_k t^k$ | `HeatKernel` |
250
+ | Yang-Mills Action | $S = -\frac{1}{4g^2} \text{Tr}(F_{\mu\nu} F^{\mu\nu})$ | `FieldStrength.yang_mills_action()` |
251
+
252
+ ---
253
+
254
+ ## FourierFrame vs U3Frame
255
+
256
+ | Property | FourierFrame | U3Frame |
257
+ |----------|--------------|---------|
258
+ | **Group** | GL(1,C) = C× | U(3) |
259
+ | **DOF** | 2 (phase + magnitude) | 9 (unitary matrix) |
260
+ | **Use Case** | Spectral analysis, heat kernel | Gauge field theory |
261
+ | **Fourier Transform** | `fourier_transform(θ)` | `gauge_transform_u1(θ)` |
262
+ | **Conformal Transform** | `conformal_transform(λ)` | Not supported |
263
+ | **SU(3) Transform** | Not supported | `gauge_transform_su3(...)` |
264
+
265
+ ---
266
+
267
+ ## Performance
268
+
269
+ | Operation | Ops/second |
270
+ |-----------|-----------|
271
+ | Vector addition | 5,200,000 |
272
+ | Quaternion rotation | 1,800,000 |
273
+ | Gaussian curvature | 85,000 |
274
+ | Spectral transform (GPU) | 12,000 |
275
+
276
+ ---
277
+
278
+ ## Changelog
279
+
280
+ ### v7.0.0-alpha (2026-01-14)
281
+ - 🎄 **Christmas Equation**: New `complex_geometric_physics.py` module
282
+ - **Complex Frame Unified Theory (CFUT)**: Unified field equation implementation
283
+ - **ComplexFrame**: U(x) = U^(R)(x) + iU^(I)(x) decomposition
284
+ - **EnergyMomentumTensor**: Real-imaginary tensor decomposition
285
+ - **ChristmasEquation**: Einstein tensor, Chern-Simons current, topological energy-momentum
286
+ - **Complete English Translation**: All documentation and code comments in English
287
+ - **DOI**: Added Zenodo DOI 10.5281/zenodo.14435613
288
+
289
+ ### v6.0.4 (2025-12-08)
290
+ - `frames.py` → `spectral_geometry.py`
291
+ - Removed `fourier_spectral.py`
292
+ - Unified theory documentation
293
+
294
+ ### v6.0.3 (2025-12-04)
295
+ - U3Frame: U(3) unitary frame
296
+ - GaugeConnection, FieldStrength
297
+
298
+ ### v6.0.1 (2025-12-04)
299
+ - FourierFrame spectral geometry
300
+ - Berry phase, Chern number, heat kernel
301
+
302
+ ---
303
+
304
+ ## License
305
+
306
+ MIT License - Copyright (c) 2024-2025 PanGuoJun
307
+
308
+ ## Links
309
+
310
+ - **PyPI**: https://pypi.org/project/coordinate-system/
311
+ - **GitHub**: https://github.com/panguojun/Coordinate-System
312
+ - **Email**: 18858146@qq.com
@@ -0,0 +1,13 @@
1
+ coordinate_system/__init__.py,sha256=bsBHh-g2QAIGCSVaH61cJu1R4Dt3YCxVDkARrOXTTbw,9758
2
+ coordinate_system/complex_geometric_physics.py,sha256=Pgc7P596gGVmGdQSUSmzJTaVPf8Phyc4UOJGhJcuEPw,16860
3
+ coordinate_system/coordinate_system.cp313-win_amd64.pyd,sha256=_CgbuMbj1ZBVuDWEZiG35KlAmi2XACTGHfrRIDHFvKs,499200
4
+ coordinate_system/curve_interpolation.py,sha256=_HKsWozBNlD8TaVX1K0dzWTNFa_96Bqu6F_K4xhceSg,14753
5
+ coordinate_system/differential_geometry.py,sha256=SYPVI6cYk-TharLOQCjMd-4kK0Em5ETTU6y6zvjCL3E,29388
6
+ coordinate_system/spectral_geometry.py,sha256=k2Rb-wJSB5vZsCz-rTkHbiNd4IBhOCvDdsIezLsHewQ,51996
7
+ coordinate_system/u3_frame.py,sha256=I96QzPkQFaqhR4EvpygND6RWUkruy8zoeuUjuQit1L8,29239
8
+ coordinate_system/visualization.py,sha256=hnjQB66plimu24CimzW98ZBcFOBUCoJ9vhxjsQ417s0,34229
9
+ coordinate_system-7.0.0.dist-info/LICENSE,sha256=tDnRkJxBYPzWdfh2gArRqrUPJxQZRZHJVs68qqBHIq4,1083
10
+ coordinate_system-7.0.0.dist-info/METADATA,sha256=E7keYBAtJ4snfNY-4nRx9L7A3olEWoNE_yC-T88vWG8,11395
11
+ coordinate_system-7.0.0.dist-info/WHEEL,sha256=4-iQBlRoDdX1wfPofc7KLWa5Cys4eZSgXs6GVU8fKlQ,101
12
+ coordinate_system-7.0.0.dist-info/top_level.txt,sha256=R6LguuPPZ5esrIsDTqPGi9UxCvZPIXwn7KRKX87c79M,18
13
+ coordinate_system-7.0.0.dist-info/RECORD,,
@@ -0,0 +1,5 @@
1
+ Wheel-Version: 1.0
2
+ Generator: setuptools (75.6.0)
3
+ Root-Is-Purelib: false
4
+ Tag: cp313-cp313-win_amd64
5
+
@@ -0,0 +1 @@
1
+ coordinate_system