coordinate-system 6.0.1__cp313-cp313-win_amd64.whl → 6.0.4__cp313-cp313-win_amd64.whl

coordinate_system/__init__.py

@@ -1,25 +1,31 @@
 # coordinate_system/__init__.py
 """
-Coordinate System Package
+Coordinate System Library
 =========================
 
-A comprehensive 3D coordinate system library with differential geometry support.
+High-performance 3D coordinate system and differential geometry library.
 
-Core Components:
+Core Components (C++ Layer):
 - vec3, vec2: Vector types
-- quat: Quaternion for rotations
-- coord3: 3D coordinate frame
+- quat: Quaternion for rotations (SU(2))
+- coord3: 3D coordinate frame (Sim(3) group)
 
-Modules:
-- differential_geometry: Surface curvature computation
-- frames: Complex frame algebra and spectral geometry
+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
 - visualization: Coordinate system visualization
-- curve_interpolation: Curve and frame interpolation
+- curve_interpolation: C2-continuous curve and frame interpolation
 
-Version: 6.0.1
+Group Correspondence:
+- coord3 ∈ Sim(3) = R³ ⋊ (SO(3) × R⁺)
+- FourierFrame ∈ GL(1,C) = U(1) × R⁺
+- U3Frame ∈ U(3) = SU(3) × U(1)
+
+Version: 6.0.4
 """
 
-__version__ = '6.0.1'
+__version__ = '6.0.4'
 
 from .coordinate_system import vec3, vec2
 from .coordinate_system import quat
@@ -67,11 +73,11 @@ from .differential_geometry import (
     richardson_extrapolation,
 )
 
-# Complex frame module (ComplexFrame spectral geometry)
-from .frames import (
+# Spectral geometry module (FourierFrame, GL(1,C) group)
+from .spectral_geometry import (
     # Core classes
-    ComplexFrame,
-    ComplexFrameSpectrum,
+    FourierFrame,
+    FourierFrameSpectrum,
 
     # Spectral geometry core
     IntrinsicGradient,
@@ -92,6 +98,20 @@ from .frames import (
     GPU_AVAILABLE,
 )
 
+# U(3) Frame module (U(3) group, gauge field theory)
+from .u3_frame import (
+    # Core U(3) classes
+    U3Frame,
+    SU3Component,
+
+    # Gauge field classes
+    GaugeConnection,
+    FieldStrength,
+
+    # Symmetry breaking
+    SymmetryBreakingPotential,
+)
+
 # Visualization module
 from .visualization import (
     CoordinateSystemVisualizer,
@@ -145,13 +165,18 @@ __all__ = [
     'compare_methods',
     'derivative_5pt', 'derivative_2nd_5pt', 'richardson_extrapolation',
 
-    # Complex frame module
-    'ComplexFrame', 'ComplexFrameSpectrum',
+    # Spectral geometry module (FourierFrame, GL(1,C))
+    'FourierFrame', 'FourierFrameSpectrum',
     'IntrinsicGradient', 'CurvatureFromFrame', 'BerryPhase', 'ChernNumber',
     'SpectralDecomposition', 'HeatKernel', 'FrequencyProjection', 'FrequencyBandState',
     'spectral_transform', 'inverse_spectral_transform',
     'HBAR', 'GPU_AVAILABLE',
 
+    # U(3) Frame module (Gauge theory)
+    'U3Frame', 'SU3Component',
+    'GaugeConnection', 'FieldStrength',
+    'SymmetryBreakingPotential',
+
     # Visualization
     'CoordinateSystemVisualizer', 'CurveVisualizer', 'ParametricCurve',
     'visualize_coord_system', 'visualize_curve',

coordinate_system/fourier_spectral.py

@@ -7,8 +7,8 @@ Complex Frame Spectral Analysis - 向后兼容模块
 
 请直接使用 frames 模块：
     from coordinate_system.frames import (
-        ComplexFrame,
-        ComplexFrameSpectrum,
+        FourierFrame,
+        FourierFrameSpectrum,
         spectral_transform,
         inverse_spectral_transform,
     )
@@ -30,8 +30,8 @@ warnings.warn(
 # 从 frames 重导出所有内容
 from .frames import (
     # 核心类
-    ComplexFrame,
-    ComplexFrameSpectrum,
+    FourierFrame,
+    FourierFrameSpectrum,
 
     # 谱几何核心
     IntrinsicGradient,
@@ -53,12 +53,12 @@ from .frames import (
 )
 
 # 向后兼容别名（旧名称映射到新名称）
-QFrame = ComplexFrame
-QFrameSpectrum = ComplexFrameSpectrum
-QuantumFrameSpectrum = ComplexFrameSpectrum
-QuantumFrameTransformer = ComplexFrame  # ComplexFrame 现在包含变换方法
-Frame = ComplexFrame  # 简称别名
-FrameSpectrum = ComplexFrameSpectrum  # 简称别名
+QFrame = FourierFrame
+QFrameSpectrum = FourierFrameSpectrum
+QuantumFrameSpectrum = FourierFrameSpectrum
+QuantumFrameTransformer = FourierFrame  # FourierFrame 现在包含变换方法
+Frame = FourierFrame  # 简称别名
+FrameSpectrum = FourierFrameSpectrum  # 简称别名
 
 
 def quantum_frame_transform(coord_field, grid_size=None, use_gpu=False, hbar=HBAR):
@@ -112,8 +112,8 @@ def compute_radial_spectrum(spectrum):
 # 导出列表
 __all__ = [
     # 核心类（新名称）
-    'ComplexFrame',
-    'ComplexFrameSpectrum',
+    'FourierFrame',
+    'FourierFrameSpectrum',
 
     # 谱几何核心
     'IntrinsicGradient',