coordinate-system 6.0.5__tar.gz → 7.0.0__tar.gz

{coordinate_system-6.0.5/coordinate_system.egg-info → coordinate_system-7.0.0}/PKG-INFO

@@ -1,15 +1,17 @@
 Metadata-Version: 2.1
 Name: coordinate_system
-Version: 6.0.5
-Summary: High-performance 3D coordinate system library with unified differential geometry, quantum frame algebra, spectral transforms, and professional curvature visualization
+Version: 7.0.0
+Summary: High-performance 3D coordinate system library with unified differential geometry, quantum frame algebra, and Christmas Equation (CFUT)
 Home-page: https://github.com/panguojun/Coordinate-System
 Author: PanGuoJun
-Author-email: 18858146@qq.com
+Author-email: PanGuoJun <18858146@qq.com>
 License: MIT
-Project-URL: Bug Reports, https://github.com/panguojun/Coordinate-System/issues
-Project-URL: Source, https://github.com/panguojun/Coordinate-System
+Project-URL: Homepage, https://github.com/panguojun/Coordinate-System
 Project-URL: Documentation, https://github.com/panguojun/Coordinate-System/blob/main/README.md
-Keywords: 3d math vector quaternion coordinate-system geometry graphics spatial-computing differential-geometry curvature curve-interpolation c2-continuity frenet-frames fourier-transform operator-overloading quantum-coordinates heisenberg-uncertainty visualization rgb-frames catmull-rom squad intrinsic-gradient spectral-analysis surface-visualization
+Project-URL: Repository, https://github.com/panguojun/Coordinate-System
+Project-URL: Bug Reports, https://github.com/panguojun/Coordinate-System/issues
+Project-URL: DOI, https://zenodo.org/records/14435613
+Keywords: 3d,math,vector,quaternion,coordinate-system,geometry,differential-geometry,curvature,spectral-analysis,christmas-equation,cfut,unified-field-theory,complex-frame
 Platform: Windows
 Platform: Linux
 Platform: macOS
@@ -20,7 +22,7 @@ Classifier: Intended Audience :: Developers
 Classifier: Intended Audience :: Science/Research
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Topic :: Scientific/Engineering :: Mathematics
-Classifier: Topic :: Multimedia :: Graphics :: 3D Modeling
+Classifier: Topic :: Scientific/Engineering :: Physics
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.7
@@ -49,16 +51,20 @@ Requires-Dist: matplotlib>=3.3.0
 [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
 
 **Author:** PanGuoJun
-**Version:** 6.0.4
+**Version:** 7.0.0-alpha
 **License:** MIT
+**DOI:** [10.5281/zenodo.14435613](https://zenodo.org/records/14435613)
 
 ---
 
-## What's New in v6.0.4 (2025-12-08)
+## What's New in v7.0.0-alpha (2026-01-14)
 
-- **File Restructure**: `frames.py` → `spectral_geometry.py`, removed redundant `fourier_spectral.py`
-- **Unified Documentation**: Complete "Complex Frame Field Algebra" theory document
-- **Gaussian Curvature**: Unified to intrinsic gradient / Lie bracket method
+- **🎄 Christmas Equation**: New `complex_geometric_physics` module implementing unified field theory
+- **Complex Frame Unified Theory (CFUT)**: Geometry + Topology = Complex Matter + Topological Force
+- **Einstein Tensor**: Compute Ĝ_μν from complex frame field U(x)
+- **Chern-Simons Current**: Topological current K̄_μ for gauge field analysis
+- **Energy-Momentum Tensor**: Real-imaginary decomposition for matter and topology
+- **Complete English Translation**: All code documentation now in English for worldwide use
 
 ---
 
@@ -66,12 +72,13 @@ Requires-Dist: matplotlib>=3.3.0
 
 ```
 coordinate_system/
-├── coordinate_system.pyd/.so   # C++ core (vec3, quat, coord3)
-├── spectral_geometry.py        # FourierFrame [GL(1,C)], spectral analysis
-├── u3_frame.py                 # U3Frame [U(3)], gauge field theory
-├── differential_geometry.py    # Surface curvature calculation
-├── visualization.py            # 3D visualization
-└── curve_interpolation.py      # C2-continuous interpolation
+├── coordinate_system.pyd/.so      # C++ core (vec3, quat, coord3)
+├── complex_geometric_physics.py   # 🎄 Christmas Equation, CFUT unified theory
+├── spectral_geometry.py           # FourierFrame [GL(1,C)], spectral analysis
+├── u3_frame.py                    # U3Frame [U(3)], gauge field theory
+├── differential_geometry.py       # Surface curvature calculation
+├── visualization.py               # 3D visualization
+└── curve_interpolation.py         # C2-continuous interpolation
 ```
 
 ## Group Correspondence
@@ -79,6 +86,7 @@ coordinate_system/
 | Class | Group | DOF | Use Case |
 |-------|-------|-----|----------|
 | `coord3` | Sim(3) = R³ ⋊ (SO(3) × R⁺) | 10 | 3D coordinate transform |
+| `ComplexFrame` | U(3) complex field | 18 | 🎄 Unified field theory (CFUT) |
 | `FourierFrame` | GL(1,C) = U(1) × R⁺ | 2 | Spectral geometry, heat kernel |
 | `U3Frame` | U(3) = SU(3) × U(1) | 9 | Gauge field theory |
 
@@ -176,12 +184,63 @@ F_xy = conn_x.field_strength(conn_y)
 S_YM = F_xy.yang_mills_action()
 ```
 
+### 🎄 Complex Geometric Physics (Christmas Equation)
+
+```python
+from coordinate_system import (
+    ComplexFrame,
+    EnergyMomentumTensor,
+    ChristmasEquation,
+    create_flat_spacetime_frame,
+    create_curved_spacetime_frame,
+    create_gauge_field_frame,
+    M_PLANCK,
+    LAMBDA_TOPO
+)
+import numpy as np
+
+# Create complex frames
+flat_frame = create_flat_spacetime_frame()
+curved_frame = create_curved_spacetime_frame(curvature=0.1)
+gauge_frame = create_gauge_field_frame(field_strength=0.1)
+
+# Initialize Christmas Equation solver
+solver = ChristmasEquation()
+print(f"Planck mass: {solver.M_P:.3e} GeV")
+print(f"Topological coupling: {solver.lambda_topo:.4f}")
+
+# Compute geometric quantities
+G_tensor = solver.einstein_tensor(curved_frame)
+K_current = solver.chern_simons_current(gauge_frame)
+
+# Create matter energy-momentum tensor
+matter_real = np.diag([1.0, 0.1, 0.1, 0.1])
+matter_imag = np.zeros((4, 4))
+T_matter = EnergyMomentumTensor(matter_real, matter_imag)
+
+# Solve the Christmas Equation
+# M_P²/2 Ĝ_μν[U] + λ/(32π²) ∇̂_(μ K̄_ν)[U] = T̂_μν^(top)[U] + T̂_μν^(mat)
+solution = solver.solve_christmas_equation(gauge_frame, T_matter)
+print(f"Geometric term norm: {np.linalg.norm(solution['geometric_term']):.6e}")
+print(f"Topological term norm: {np.linalg.norm(solution['topological_term']):.6e}")
+print(f"Equation balanced: {solution['balanced']}")
+```
+
+**The Christmas Equation** unifies geometry and topology:
+- **Left side**: Geometry (Einstein tensor) + Topology (Chern-Simons current)
+- **Right side**: Topological source + Matter source
+- **Real part U^(R)**: Geometric properties (metric, curvature, spacetime)
+- **Imaginary part U^(I)**: Topological properties (phase winding, gauge symmetry)
+
 ---
 
 ## Key Formulas
 
 | Concept | Formula | Code |
 |---------|---------|------|
+| 🎄 **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()` |
+| Einstein Tensor | $\hat{G}_{\mu\nu} = R_{\mu\nu} - \frac{1}{2}g_{\mu\nu} R$ | `ChristmasEquation.einstein_tensor()` |
+| Chern-Simons Current | $\bar{K}_\mu = \varepsilon_{\mu\nu\rho\sigma} \text{Tr}(A^\nu F^{\rho\sigma})$ | `ChristmasEquation.chern_simons_current()` |
 | Intrinsic Gradient | $G_\mu = \frac{d}{dx^\mu} \log C(x)$ | `IntrinsicGradient` |
 | Curvature Tensor | $R_{\mu\nu} = [G_\mu, G_\nu]$ | `CurvatureFromFrame` |
 | Gaussian Curvature | $K = -\langle [G_u, G_v] e_v, e_u \rangle / \sqrt{\det g}$ | `compute_gaussian_curvature` |
@@ -218,6 +277,15 @@ S_YM = F_xy.yang_mills_action()
 
 ## Changelog
 
+### v7.0.0-alpha (2026-01-14)
+- 🎄 **Christmas Equation**: New `complex_geometric_physics.py` module
+- **Complex Frame Unified Theory (CFUT)**: Unified field equation implementation
+- **ComplexFrame**: U(x) = U^(R)(x) + iU^(I)(x) decomposition
+- **EnergyMomentumTensor**: Real-imaginary tensor decomposition
+- **ChristmasEquation**: Einstein tensor, Chern-Simons current, topological energy-momentum
+- **Complete English Translation**: All documentation and code comments in English
+- **DOI**: Added Zenodo DOI 10.5281/zenodo.14435613
+
 ### v6.0.4 (2025-12-08)
 - `frames.py` → `spectral_geometry.py`
 - Removed `fourier_spectral.py`

{coordinate_system-6.0.5 → coordinate_system-7.0.0}/README.md

@@ -7,16 +7,20 @@
 [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
 
 **Author:** PanGuoJun
-**Version:** 6.0.4
+**Version:** 7.0.0-alpha
 **License:** MIT
+**DOI:** [10.5281/zenodo.14435613](https://zenodo.org/records/14435613)
 
 ---
 
-## What's New in v6.0.4 (2025-12-08)
+## What's New in v7.0.0-alpha (2026-01-14)
 
-- **File Restructure**: `frames.py` → `spectral_geometry.py`, removed redundant `fourier_spectral.py`
-- **Unified Documentation**: Complete "Complex Frame Field Algebra" theory document
-- **Gaussian Curvature**: Unified to intrinsic gradient / Lie bracket method
+- **🎄 Christmas Equation**: New `complex_geometric_physics` module implementing unified field theory
+- **Complex Frame Unified Theory (CFUT)**: Geometry + Topology = Complex Matter + Topological Force
+- **Einstein Tensor**: Compute Ĝ_μν from complex frame field U(x)
+- **Chern-Simons Current**: Topological current K̄_μ for gauge field analysis
+- **Energy-Momentum Tensor**: Real-imaginary decomposition for matter and topology
+- **Complete English Translation**: All code documentation now in English for worldwide use
 
 ---
 
@@ -24,12 +28,13 @@
 
 ```
 coordinate_system/
-├── coordinate_system.pyd/.so   # C++ core (vec3, quat, coord3)
-├── spectral_geometry.py        # FourierFrame [GL(1,C)], spectral analysis
-├── u3_frame.py                 # U3Frame [U(3)], gauge field theory
-├── differential_geometry.py    # Surface curvature calculation
-├── visualization.py            # 3D visualization
-└── curve_interpolation.py      # C2-continuous interpolation
+├── coordinate_system.pyd/.so      # C++ core (vec3, quat, coord3)
+├── complex_geometric_physics.py   # 🎄 Christmas Equation, CFUT unified theory
+├── spectral_geometry.py           # FourierFrame [GL(1,C)], spectral analysis
+├── u3_frame.py                    # U3Frame [U(3)], gauge field theory
+├── differential_geometry.py       # Surface curvature calculation
+├── visualization.py               # 3D visualization
+└── curve_interpolation.py         # C2-continuous interpolation
 ```
 
 ## Group Correspondence
@@ -37,6 +42,7 @@ coordinate_system/
 | Class | Group | DOF | Use Case |
 |-------|-------|-----|----------|
 | `coord3` | Sim(3) = R³ ⋊ (SO(3) × R⁺) | 10 | 3D coordinate transform |
+| `ComplexFrame` | U(3) complex field | 18 | 🎄 Unified field theory (CFUT) |
 | `FourierFrame` | GL(1,C) = U(1) × R⁺ | 2 | Spectral geometry, heat kernel |
 | `U3Frame` | U(3) = SU(3) × U(1) | 9 | Gauge field theory |
 
@@ -134,12 +140,63 @@ F_xy = conn_x.field_strength(conn_y)
 S_YM = F_xy.yang_mills_action()
 ```
 
+### 🎄 Complex Geometric Physics (Christmas Equation)
+
+```python
+from coordinate_system import (
+    ComplexFrame,
+    EnergyMomentumTensor,
+    ChristmasEquation,
+    create_flat_spacetime_frame,
+    create_curved_spacetime_frame,
+    create_gauge_field_frame,
+    M_PLANCK,
+    LAMBDA_TOPO
+)
+import numpy as np
+
+# Create complex frames
+flat_frame = create_flat_spacetime_frame()
+curved_frame = create_curved_spacetime_frame(curvature=0.1)
+gauge_frame = create_gauge_field_frame(field_strength=0.1)
+
+# Initialize Christmas Equation solver
+solver = ChristmasEquation()
+print(f"Planck mass: {solver.M_P:.3e} GeV")
+print(f"Topological coupling: {solver.lambda_topo:.4f}")
+
+# Compute geometric quantities
+G_tensor = solver.einstein_tensor(curved_frame)
+K_current = solver.chern_simons_current(gauge_frame)
+
+# Create matter energy-momentum tensor
+matter_real = np.diag([1.0, 0.1, 0.1, 0.1])
+matter_imag = np.zeros((4, 4))
+T_matter = EnergyMomentumTensor(matter_real, matter_imag)
+
+# Solve the Christmas Equation
+# M_P²/2 Ĝ_μν[U] + λ/(32π²) ∇̂_(μ K̄_ν)[U] = T̂_μν^(top)[U] + T̂_μν^(mat)
+solution = solver.solve_christmas_equation(gauge_frame, T_matter)
+print(f"Geometric term norm: {np.linalg.norm(solution['geometric_term']):.6e}")
+print(f"Topological term norm: {np.linalg.norm(solution['topological_term']):.6e}")
+print(f"Equation balanced: {solution['balanced']}")
+```
+
+**The Christmas Equation** unifies geometry and topology:
+- **Left side**: Geometry (Einstein tensor) + Topology (Chern-Simons current)
+- **Right side**: Topological source + Matter source
+- **Real part U^(R)**: Geometric properties (metric, curvature, spacetime)
+- **Imaginary part U^(I)**: Topological properties (phase winding, gauge symmetry)
+
 ---
 
 ## Key Formulas
 
 | Concept | Formula | Code |
 |---------|---------|------|
+| 🎄 **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()` |
+| Einstein Tensor | $\hat{G}_{\mu\nu} = R_{\mu\nu} - \frac{1}{2}g_{\mu\nu} R$ | `ChristmasEquation.einstein_tensor()` |
+| Chern-Simons Current | $\bar{K}_\mu = \varepsilon_{\mu\nu\rho\sigma} \text{Tr}(A^\nu F^{\rho\sigma})$ | `ChristmasEquation.chern_simons_current()` |
 | Intrinsic Gradient | $G_\mu = \frac{d}{dx^\mu} \log C(x)$ | `IntrinsicGradient` |
 | Curvature Tensor | $R_{\mu\nu} = [G_\mu, G_\nu]$ | `CurvatureFromFrame` |
 | Gaussian Curvature | $K = -\langle [G_u, G_v] e_v, e_u \rangle / \sqrt{\det g}$ | `compute_gaussian_curvature` |
@@ -176,6 +233,15 @@ S_YM = F_xy.yang_mills_action()
 
 ## Changelog
 
+### v7.0.0-alpha (2026-01-14)
+- 🎄 **Christmas Equation**: New `complex_geometric_physics.py` module
+- **Complex Frame Unified Theory (CFUT)**: Unified field equation implementation
+- **ComplexFrame**: U(x) = U^(R)(x) + iU^(I)(x) decomposition
+- **EnergyMomentumTensor**: Real-imaginary tensor decomposition
+- **ChristmasEquation**: Einstein tensor, Chern-Simons current, topological energy-momentum
+- **Complete English Translation**: All documentation and code comments in English
+- **DOI**: Added Zenodo DOI 10.5281/zenodo.14435613
+
 ### v6.0.4 (2025-12-08)
 - `frames.py` → `spectral_geometry.py`
 - Removed `fourier_spectral.py`

{coordinate_system-6.0.5 → coordinate_system-7.0.0}/coordinate_system/__init__.py

@@ -14,6 +14,7 @@ Python Modules:
 - differential_geometry: Surface curvature via intrinsic gradient / Lie bracket
 - spectral_geometry: FourierFrame (GL(1,C)), spectral analysis, heat kernel
 - u3_frame: U3Frame (U(3)), gauge field theory, symmetry breaking
+- complex_geometric_physics: Christmas Equation, unified field theory (CFUT)
 - visualization: Coordinate system visualization
 - curve_interpolation: C2-continuous curve and frame interpolation
 
@@ -22,10 +23,10 @@ Group Correspondence:
 - FourierFrame ∈ GL(1,C) = U(1) × R⁺
 - U3Frame ∈ U(3) = SU(3) × U(1)
 
-Version: 6.0.4
+Version: 7.0.0-alpha
 """
 
-__version__ = '6.0.4'
+__version__ = '7.0.0-alpha'
 
 from .coordinate_system import vec3, vec2
 from .coordinate_system import quat
@@ -112,6 +113,23 @@ from .u3_frame import (
     SymmetryBreakingPotential,
 )
 
+# Complex Geometric Physics module (Christmas Equation, CFUT)
+from .complex_geometric_physics import (
+    # Core classes
+    ComplexFrame,
+    EnergyMomentumTensor,
+    ChristmasEquation,
+
+    # Utility functions
+    create_flat_spacetime_frame,
+    create_curved_spacetime_frame,
+    create_gauge_field_frame,
+
+    # Constants
+    M_PLANCK,
+    LAMBDA_TOPO,
+)
+
 # Visualization module
 from .visualization import (
     CoordinateSystemVisualizer,
@@ -177,6 +195,11 @@ __all__ = [
     'GaugeConnection', 'FieldStrength',
     'SymmetryBreakingPotential',
 
+    # Complex Geometric Physics (Christmas Equation, CFUT)
+    'ComplexFrame', 'EnergyMomentumTensor', 'ChristmasEquation',
+    'create_flat_spacetime_frame', 'create_curved_spacetime_frame', 'create_gauge_field_frame',
+    'M_PLANCK', 'LAMBDA_TOPO',
+
     # Visualization
     'CoordinateSystemVisualizer', 'CurveVisualizer', 'ParametricCurve',
     'visualize_coord_system', 'visualize_curve',