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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: coordinate_system
-Version: 5.2.0
+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
@@ -50,13 +50,13 @@ Requires-Dist: matplotlib>=3.3.0
 [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
 
 **Author:** PanGuoJun
-**Version:** 5.2.0
+**Version:** 5.2.1
 **License:** MIT
 
 
 ---
 
-## What's New in v5.2.0 (2025-12-01)
+## What's New in v5.2.1 (2025-12-01)
 
 ### Fourier Frames with Operator Overloading
 
@@ -94,6 +94,13 @@ Requires-Dist: matplotlib>=3.3.0
 - 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-5.2.0 → coordinate_system-5.2.1}/README.md

@@ -8,13 +8,13 @@
 [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
 
 **Author:** PanGuoJun
-**Version:** 5.2.0
+**Version:** 5.2.1
 **License:** MIT
 
 
 ---
 
-## What's New in v5.2.0 (2025-12-01)
+## What's New in v5.2.1 (2025-12-01)
 
 ### Fourier Frames with Operator Overloading
 
@@ -52,6 +52,13 @@
 - 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-5.2.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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: coordinate_system
-Version: 5.2.0
+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
@@ -50,13 +50,13 @@ Requires-Dist: matplotlib>=3.3.0
 [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
 
 **Author:** PanGuoJun
-**Version:** 5.2.0
+**Version:** 5.2.1
 **License:** MIT
 
 
 ---
 
-## What's New in v5.2.0 (2025-12-01)
+## What's New in v5.2.1 (2025-12-01)
 
 ### Fourier Frames with Operator Overloading
 
@@ -94,6 +94,13 @@ Requires-Dist: matplotlib>=3.3.0
 - 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-5.2.0 → coordinate_system-5.2.1}/coordinate_system_binding.cpp

@@ -535,4 +535,30 @@ PYBIND11_MODULE(coordinate_system, m) {
     m.attr("__version__") = "4.0.1";
     m.attr("__author__") = "PanGuoJun";
     m.attr("__coordinate_system__") = "right-handed";
+
+    // ===========================================================================
+    // Coordinate System Handedness Control
+    // ===========================================================================
+    m.def("set_handedness", [](const std::string& handedness) {
+        if (handedness == "left" || handedness == "LEFT") {
+            set_coordinate_handedness(true);
+        } else if (handedness == "right" || handedness == "RIGHT") {
+            set_coordinate_handedness(false);
+        } else {
+            throw std::invalid_argument("handedness must be 'left' or 'right'");
+        }
+    }, "Set coordinate system handedness ('left' or 'right')", py::arg("handedness"));
+
+    m.def("get_handedness", []() -> std::string {
+        return get_coordinate_handedness() ? "left" : "right";
+    }, "Get current coordinate system handedness");
+
+    m.def("is_left_handed", []() -> bool {
+        return get_coordinate_handedness();
+    }, "Check if using left-handed coordinate system");
+
+    m.def("is_right_handed", []() -> bool {
+        return !get_coordinate_handedness();
+    }, "Check if using right-handed coordinate system");
+
 }

{coordinate_system-5.2.0 → coordinate_system-5.2.1}/pmsys_minimal.hpp

@@ -148,6 +148,25 @@ inline real lerp(real h1, real h2, real alpha) {
     return h1 * (1.0 - alpha) + h2 * alpha;
 }
 
+// ==============================================================================
+// Coordinate System Handedness (Left/Right)
+// ==============================================================================
+namespace {
+    // Global handedness setting: true = left-handed (default), false = right-handed
+    bool g_use_left_handed_system = true;
+}
+
+// Set coordinate system handedness
+inline void set_coordinate_handedness(bool use_left_handed) {
+    g_use_left_handed_system = use_left_handed;
+}
+
+// Get current coordinate system handedness
+inline bool get_coordinate_handedness() {
+    return g_use_left_handed_system;
+}
+
+
 inline real sign(real x) {
     return x < 0 ? -1.0 : (x > 0 ? 1.0 : 0.0);
 }
@@ -877,12 +896,22 @@ struct vector3
     }
     DEVICE_CALLABLE vector3 cross(const vector3& v) const
     {
-        vector3 n;
-        // 默认使用左手顺序！
-        n.x = -(y * v.z - z * v.y);
-        n.y = -(z * v.x - x * v.z);
-        n.z = -(x * v.y - y * v.x);
-        return n;
+        // Use global handedness setting
+        if (g_use_left_handed_system) {
+            // Left-handed system
+            vector3 n;
+            n.x = -(y * v.z - z * v.y);
+            n.y = -(z * v.x - x * v.z);
+            n.z = -(x * v.y - y * v.x);
+            return n;
+        } else {
+            // Right-handed system
+            vector3 n;
+            n.x = (y * v.z - z * v.y);
+            n.y = (z * v.x - x * v.z);
+            n.z = (x * v.y - y * v.x);
+            return n;
+        }
     }
     DEVICE_CALLABLE vector3 cross_left(const vector3& v) const
     {

{coordinate_system-5.2.0 → coordinate_system-5.2.1}/setup.py

@@ -2,7 +2,7 @@
 setup.py - Cross-platform setup for coordinate_system package
 
 Author: PanGuoJun
-Version: 5.2.0
+Version: 5.2.1
 License: MIT
 """
 
@@ -69,7 +69,7 @@ ext_modules = [
 
 setup(
     name='coordinate_system',
-    version='5.2.0',
+    version='5.2.1',
     packages=find_packages(),
     ext_modules=ext_modules,  # Add extension modules