coordinate-system 4.1.0__tar.gz → 5.2.1__tar.gz

{coordinate_system-4.1.0/coordinate_system.egg-info → coordinate_system-5.2.1}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.1
 Name: coordinate_system
-Version: 4.1.0
-Summary: High-performance 3D coordinate system library with right-handed conventions, Intrinsic Gradient Operator method for curvature computation, achieving machine-precision accuracy
+Version: 5.2.1
+Summary: High-performance 3D coordinate system with C2-continuous curve interpolation, Fourier frames with operator overloading, and advanced 3D visualization
 Home-page: https://github.com/panguojun/Coordinate-System
 Author: PanGuoJun
 Author-email: 18858146@qq.com
@@ -9,7 +9,7 @@ License: MIT
 Project-URL: Bug Reports, https://github.com/panguojun/Coordinate-System/issues
 Project-URL: Source, 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 metric-tensor connection-operator discrete-geometry surface-curvature intrinsic-gradient-operator
+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
 Platform: Windows
 Platform: Linux
 Platform: macOS
@@ -37,6 +37,8 @@ Classifier: Operating System :: MacOS
 Requires-Python: >=3.7
 Description-Content-Type: text/markdown
 License-File: LICENSE
+Requires-Dist: numpy>=1.19.0
+Requires-Dist: matplotlib>=3.3.0
 
 # Coordinate System Library
 
@@ -48,9 +50,57 @@ License-File: LICENSE
 [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
 
 **Author:** PanGuoJun
-**Version:** 4.0.2
+**Version:** 5.2.1
 **License:** MIT
 
+
+---
+
+## What's New in v5.2.1 (2025-12-01)
+
+### Fourier Frames with Operator Overloading
+
+**New Module: `fourier_frames`** - Elegant quantum coordinate transformations
+
+- **Operator Overloading Support**: Intuitive syntax for Fourier transforms
+  - `F_p @ psi` - Matrix multiplication operator
+  - `F_p * psi` - Multiplication operator
+  - `psi | F_p` - Bra-ket notation
+  - `~F_x` - Dual frame operator
+- **Quantum State Representation**: `QuantumState` and `StateVector` classes
+- **Heisenberg Uncertainty**: Built-in uncertainty principle computations
+- **Position <-> Momentum Transforms**: Seamless coordinate basis transformations
+
+### C2-Continuous Curve Interpolation
+
+**Enhanced Module: `curve_interpolation`** - Second-order smooth curves
+
+- **C2-Continuity**: Catmull-Rom spline for position interpolation
+- **SQUAD Interpolation**: Spherical Quadrangle for smooth quaternion interpolation
+- **13x Smoother**: Reduced maximum curvature from 13.93 to 1.05
+
+### Advanced 3D Visualization
+
+**New Module: `visualization`** - Professional curve and frame rendering
+
+- **RGB Frenet Frames**: Red=Tangent, Green=Normal, Blue=Binormal
+- **3D Curve Rendering**: High-quality visualization with matplotlib
+- **Export Support**: Save PNG/PDF outputs
+
+### Documentation
+
+- [Curve Interpolation Guide](CURVE_INTERPOLATION_README.md)
+- [C2 Interpolation Guide](C2_INTERPOLATION_GUIDE.md)
+- Full English documentation for global distribution
+
+
+
+### v5.2.1 (2025-12-01) - Handedness Control
+- ✨ **New**: C++ level handedness control (`set_handedness('left'/'right')`)
+- 🔧 **Fixed**: Frenet frames now respect coordinate system handedness
+- 📚 **Improved**: Global handedness setting for consistent behavior
+
+
 ## 🆕 What's New in v4.0.0
 
 ### 🎯 Fourier Spectral Geometry Analysis

{coordinate_system-4.1.0 → coordinate_system-5.2.1}/README.md

@@ -8,9 +8,57 @@
 [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
 
 **Author:** PanGuoJun
-**Version:** 4.0.2
+**Version:** 5.2.1
 **License:** MIT
 
+
+---
+
+## What's New in v5.2.1 (2025-12-01)
+
+### Fourier Frames with Operator Overloading
+
+**New Module: `fourier_frames`** - Elegant quantum coordinate transformations
+
+- **Operator Overloading Support**: Intuitive syntax for Fourier transforms
+  - `F_p @ psi` - Matrix multiplication operator
+  - `F_p * psi` - Multiplication operator
+  - `psi | F_p` - Bra-ket notation
+  - `~F_x` - Dual frame operator
+- **Quantum State Representation**: `QuantumState` and `StateVector` classes
+- **Heisenberg Uncertainty**: Built-in uncertainty principle computations
+- **Position <-> Momentum Transforms**: Seamless coordinate basis transformations
+
+### C2-Continuous Curve Interpolation
+
+**Enhanced Module: `curve_interpolation`** - Second-order smooth curves
+
+- **C2-Continuity**: Catmull-Rom spline for position interpolation
+- **SQUAD Interpolation**: Spherical Quadrangle for smooth quaternion interpolation
+- **13x Smoother**: Reduced maximum curvature from 13.93 to 1.05
+
+### Advanced 3D Visualization
+
+**New Module: `visualization`** - Professional curve and frame rendering
+
+- **RGB Frenet Frames**: Red=Tangent, Green=Normal, Blue=Binormal
+- **3D Curve Rendering**: High-quality visualization with matplotlib
+- **Export Support**: Save PNG/PDF outputs
+
+### Documentation
+
+- [Curve Interpolation Guide](CURVE_INTERPOLATION_README.md)
+- [C2 Interpolation Guide](C2_INTERPOLATION_GUIDE.md)
+- Full English documentation for global distribution
+
+
+
+### v5.2.1 (2025-12-01) - Handedness Control
+- ✨ **New**: C++ level handedness control (`set_handedness('left'/'right')`)
+- 🔧 **Fixed**: Frenet frames now respect coordinate system handedness
+- 📚 **Improved**: Global handedness setting for consistent behavior
+
+
 ## 🆕 What's New in v4.0.0
 
 ### 🎯 Fourier Spectral Geometry Analysis

{coordinate_system-4.1.0 → coordinate_system-5.2.1}/coordinate_system/__init__.py

@@ -4,6 +4,14 @@ from .coordinate_system import vec3, vec2
 from .coordinate_system import quat
 from .coordinate_system import coord3
 
+
+# Coordinate system handedness control (v5.2.1+)
+from .coordinate_system import (
+    set_handedness,
+    get_handedness,
+    is_left_handed,
+    is_right_handed
+)
 # Differential geometry module (v3.3.0+)
 from .differential_geometry import (
     # Classes
@@ -50,17 +58,17 @@ from .fourier_spectral import (
     FourierTransformer,
     SpectralAnalyzer,
     FrameFieldSpectrum,
-    
+
     # GPU accelerated transforms
     GPUFourierTransformer,
     BatchCoordTransformer,
-    
+
     # Spectral geometry operations
     spectral_intrinsic_gradient,
     spectral_curvature_calculator,
     berry_phase_calculator,
     topological_invariant_analyzer,
-    
+
     # Utility functions
     fft2_coord_field,
     ifft2_spectrum,
@@ -68,6 +76,35 @@ from .fourier_spectral import (
     radial_spectrum_average,
 )
 
+# Visualization module (v5.0.0+)
+from .visualization import (
+    # Visualizer classes
+    CoordinateSystemVisualizer,
+    CurveVisualizer,
+    ParametricCurve,
+
+    # Convenience functions
+    visualize_coord_system,
+    visualize_curve,
+)
+
+# Curve interpolation module (v5.1.0+)
+from .curve_interpolation import (
+    # Main class
+    InterpolatedCurve,
+
+    # Functions
+    generate_frenet_frames,
+    frame_field_spline,
+    frame_field_spline_c2,
+    reconstruct_curve_from_polygon,
+    compute_curvature_profile,
+
+    # Utility functions
+    catmull_rom,
+    squad_interp,
+)
+
 __all__ = [
     # Constants
     'ZERO3','UNITX','UNITY','UNITZ','ONE3','ONE4','ONEC',
@@ -106,8 +143,17 @@ __all__ = [
     'GPUFourierTransformer', 'BatchCoordTransformer',
     'spectral_intrinsic_gradient', 'spectral_curvature_calculator',
     'berry_phase_calculator', 'topological_invariant_analyzer',
-    'fft2_coord_field', 'ifft2_spectrum', 
+    'fft2_coord_field', 'ifft2_spectrum',
     'compute_spectral_density', 'radial_spectrum_average',
+
+    # Visualization (v5.0.0+)
+    'CoordinateSystemVisualizer', 'CurveVisualizer', 'ParametricCurve',
+    'visualize_coord_system', 'visualize_curve',
+
+    # Curve interpolation (v5.1.0+)
+    'InterpolatedCurve', 'generate_frenet_frames', 'frame_field_spline',
+    'frame_field_spline_c2', 'reconstruct_curve_from_polygon', 'compute_curvature_profile',
+    'catmull_rom', 'squad_interp',
 ]
 
 # Constants for unit vectors and zero point