coordinate-system 2.5.7__tar.gz → 3.0.0__tar.gz

{coordinate_system-2.5.7/coordinate_system.egg-info → coordinate_system-3.0.0}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.1
 Name: coordinate_system
-Version: 2.5.7
-Summary: High-performance 3D coordinate system library with Intrinsic Gradient Operator method for curvature computation, achieving machine-precision accuracy
+Version: 3.0.0
+Summary: High-performance 3D coordinate system library with right-handed conventions, Intrinsic Gradient Operator method for curvature computation, achieving machine-precision accuracy
 Home-page: https://github.com/panguojun/Coordinate-System
 Author: PanGuoJun
 Author-email: 18858146@qq.com
@@ -48,20 +48,27 @@ License-File: LICENSE
 [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
 
 **Author:** PanGuoJun
-**Version:** 2.4.1
+**Version:** 3.0.0
 **License:** MIT
 
-## 🆕 What's New in v2.4.0
+## 🆕 What's New in v3.0.0
 
-**Critical Fix & Enhancement Release!**
+**Critical Coordinate System Update - Right-Hand System!**
 
-- 🔧 **Fixed Curvature Extraction** - Corrected antisymmetric part extraction: `K = (R_01 - R_10)/(2·det(g))`
-- ✨ **Machine Precision Accuracy** - Gaussian curvature now achieves **0.000% error** on spheres (machine precision)!
-- ✨ **New Convenience Functions** - Added `coord3.identity()`, `coord3.zero()`, `coord3.from_position()`, `coord3.from_rotation()`
-- 📚 **Updated Documentation** - Complete mathematical foundation with verified formulas
-- 🎯 **Removed Experimental Code** - Eliminated incorrect π division hack
+- ⚠️ **BREAKING CHANGE: Right-Hand Coordinate System** - Unified all operations to standard right-hand coordinate system
+  - `vec3.cross()` now uses right-hand rule (standard mathematical definition)
+  - Quaternion rotations follow right-hand convention (counter-clockwise is positive)
+  - `coord3.look_at()` and `coord3.from_forward()` updated accordingly
+  - **Migration Guide:** See [HANDEDNESS_CHANGE.md](HANDEDNESS_CHANGE.md) for details
+  - `cross_left()` method retained for backward compatibility
+- ✅ **Verified Correctness** - Complete test suite validates right-hand system behavior
+- 📚 **Updated Documentation** - All examples and documentation reflect new coordinate system
+- 🎯 **Enhanced Clarity** - Comments and docstrings clarified throughout
 
-**Breaking Change:** Previous versions had ~2.5% error due to incorrect curvature extraction. This version fixes the fundamental formula to achieve theoretical accuracy.
+**Why This Change:**
+1. Mathematical Standard: Right-hand system is the standard in mathematics and physics
+2. Better Interoperability: Compatible with OpenGL, NumPy, SciPy, and most scientific libraries
+3. Improved Readability: Standard cross product formulas match textbook definitions
 
 Perfect for computational geometry, geometric analysis, and discrete differential geometry research!
 
@@ -106,15 +113,8 @@ Perfect for computational geometry, geometric analysis, and discrete differentia
 
 For a comprehensive understanding of the mathematical principles behind coordinate systems, vectors, quaternions, and transformations, see our detailed mathematical guide:
 
-**[📖 Mathematical Foundation of Coordinate Systems](https://github.com/panguojun/Coordinate-System/blob/main/MATHEMATICAL_FOUNDATION.md)**
+**[📖 Mathematical Foundation of Coordinate Systems](https://github.com/panguojun/Coordinate-System)**
 
-This guide covers:
-- Vector mathematics (dot product, cross product, projections)
-- Quaternion theory and applications
-- Coordinate system transformations
-- Euler angles and gimbal lock
-- Interpolation methods (LERP, SLERP, NLERP)
-- Practical applications in graphics, physics, and robotics
 
 ---
 
@@ -192,19 +192,27 @@ lerped = vec3.lerp(v1, v2, 0.5)  # Linear interpolation
 
 ## Coordinate System Type
 
-This library uses a **left-handed coordinate system** for all vector and quaternion operations.
+This library uses a **right-handed coordinate system** for all vector and quaternion operations (as of v3.0.0).
 
 ```
-      +Y
-       |
-       |
-       |
-       +-----> +X
-      /
-     /
-   +Z
+         +Y
+          |
+          |
+          |
+          +-----> +X
+         /
+        /
+      +Z
 ```
 
+**Right-Hand Rule:**
+- Point your right hand's fingers along the +X axis
+- Curl them toward the +Y axis
+- Your thumb points along the +Z axis
+- Cross product: **X × Y = Z** (standard mathematical definition)
+
+**Migration from v2.x:** If your code relied on the previous left-handed system, see [HANDEDNESS_CHANGE.md](HANDEDNESS_CHANGE.md) for migration instructions.
+
 ---
 
 ## API Reference
@@ -425,7 +433,7 @@ v4 = v1 * 5                     # vec3(5, 0, 0)
 
 # Dot and cross products
 dot = v1.dot(v2)                # 0.0 (perpendicular)
-cross = v1.cross(v2)            # vec3(0, 0, 1) in left-handed system
+cross = v1.cross(v2)            # vec3(0, 0, 1) in right-handed system (X × Y = Z)
 
 # Length and normalization
 length = v1.length()            # 1.0

{coordinate_system-2.5.7 → coordinate_system-3.0.0}/README.md

@@ -8,20 +8,27 @@
 [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
 
 **Author:** PanGuoJun
-**Version:** 2.4.1
+**Version:** 3.0.0
 **License:** MIT
 
-## 🆕 What's New in v2.4.0
+## 🆕 What's New in v3.0.0
 
-**Critical Fix & Enhancement Release!**
+**Critical Coordinate System Update - Right-Hand System!**
 
-- 🔧 **Fixed Curvature Extraction** - Corrected antisymmetric part extraction: `K = (R_01 - R_10)/(2·det(g))`
-- ✨ **Machine Precision Accuracy** - Gaussian curvature now achieves **0.000% error** on spheres (machine precision)!
-- ✨ **New Convenience Functions** - Added `coord3.identity()`, `coord3.zero()`, `coord3.from_position()`, `coord3.from_rotation()`
-- 📚 **Updated Documentation** - Complete mathematical foundation with verified formulas
-- 🎯 **Removed Experimental Code** - Eliminated incorrect π division hack
+- ⚠️ **BREAKING CHANGE: Right-Hand Coordinate System** - Unified all operations to standard right-hand coordinate system
+  - `vec3.cross()` now uses right-hand rule (standard mathematical definition)
+  - Quaternion rotations follow right-hand convention (counter-clockwise is positive)
+  - `coord3.look_at()` and `coord3.from_forward()` updated accordingly
+  - **Migration Guide:** See [HANDEDNESS_CHANGE.md](HANDEDNESS_CHANGE.md) for details
+  - `cross_left()` method retained for backward compatibility
+- ✅ **Verified Correctness** - Complete test suite validates right-hand system behavior
+- 📚 **Updated Documentation** - All examples and documentation reflect new coordinate system
+- 🎯 **Enhanced Clarity** - Comments and docstrings clarified throughout
 
-**Breaking Change:** Previous versions had ~2.5% error due to incorrect curvature extraction. This version fixes the fundamental formula to achieve theoretical accuracy.
+**Why This Change:**
+1. Mathematical Standard: Right-hand system is the standard in mathematics and physics
+2. Better Interoperability: Compatible with OpenGL, NumPy, SciPy, and most scientific libraries
+3. Improved Readability: Standard cross product formulas match textbook definitions
 
 Perfect for computational geometry, geometric analysis, and discrete differential geometry research!
 
@@ -66,15 +73,8 @@ Perfect for computational geometry, geometric analysis, and discrete differentia
 
 For a comprehensive understanding of the mathematical principles behind coordinate systems, vectors, quaternions, and transformations, see our detailed mathematical guide:
 
-**[📖 Mathematical Foundation of Coordinate Systems](https://github.com/panguojun/Coordinate-System/blob/main/MATHEMATICAL_FOUNDATION.md)**
+**[📖 Mathematical Foundation of Coordinate Systems](https://github.com/panguojun/Coordinate-System)**
 
-This guide covers:
-- Vector mathematics (dot product, cross product, projections)
-- Quaternion theory and applications
-- Coordinate system transformations
-- Euler angles and gimbal lock
-- Interpolation methods (LERP, SLERP, NLERP)
-- Practical applications in graphics, physics, and robotics
 
 ---
 
@@ -152,19 +152,27 @@ lerped = vec3.lerp(v1, v2, 0.5)  # Linear interpolation
 
 ## Coordinate System Type
 
-This library uses a **left-handed coordinate system** for all vector and quaternion operations.
+This library uses a **right-handed coordinate system** for all vector and quaternion operations (as of v3.0.0).
 
 ```
-      +Y
-       |
-       |
-       |
-       +-----> +X
-      /
-     /
-   +Z
+         +Y
+          |
+          |
+          |
+          +-----> +X
+         /
+        /
+      +Z
 ```
 
+**Right-Hand Rule:**
+- Point your right hand's fingers along the +X axis
+- Curl them toward the +Y axis
+- Your thumb points along the +Z axis
+- Cross product: **X × Y = Z** (standard mathematical definition)
+
+**Migration from v2.x:** If your code relied on the previous left-handed system, see [HANDEDNESS_CHANGE.md](HANDEDNESS_CHANGE.md) for migration instructions.
+
 ---
 
 ## API Reference
@@ -385,7 +393,7 @@ v4 = v1 * 5                     # vec3(5, 0, 0)
 
 # Dot and cross products
 dot = v1.dot(v2)                # 0.0 (perpendicular)
-cross = v1.cross(v2)            # vec3(0, 0, 1) in left-handed system
+cross = v1.cross(v2)            # vec3(0, 0, 1) in right-handed system (X × Y = Z)
 
 # Length and normalization
 length = v1.length()            # 1.0

{coordinate_system-2.5.7 → coordinate_system-3.0.0}/coordinate_system/__init__.py

@@ -18,6 +18,7 @@ from .differential_geometry import (
     compute_intrinsic_gradient,
     compute_gaussian_curvature,
     compute_mean_curvature,
+    compute_riemann_curvature,
     compute_all_curvatures,
 )
 
@@ -43,10 +44,22 @@ from .curvature import (
     richardson_extrapolation,
 )
 
+# Riemann curvature module (v3.4.0+)
+from .riemann_curvature import (
+    # Classes
+    RiemannCurvatureCalculator,
+
+    # Main functions (renamed to avoid conflicts)
+    compute_riemann_curvature as compute_riemann_curvature_func,
+    compute_gaussian_curvature_riemann,
+    compute_full_riemann_tensor,
+    verify_riemann_properties,
+)
+
 __all__ = [
     # Constants
     'ZERO3','UNITX','UNITY','UNITZ','ONE3','ONE4','ONEC',
-    
+
     # Core types
     'vec3', 'vec2', 'quat', 'coord3', 'lerp',
 
@@ -58,6 +71,7 @@ __all__ = [
     'compute_intrinsic_gradient',
     'compute_gaussian_curvature',
     'compute_mean_curvature',
+    'compute_riemann_curvature',
     'compute_all_curvatures',
 
     # High-precision curvature module - Classical method (v2.3.0+)
@@ -72,6 +86,13 @@ __all__ = [
     'intrinsic_gradient_all_curvatures',
     'compare_methods',
 
+    # Riemann curvature module (v3.4.0+)
+    'RiemannCurvatureCalculator',
+    'compute_riemann_curvature_func',
+    'compute_gaussian_curvature_riemann',
+    'compute_full_riemann_tensor',
+    'verify_riemann_properties',
+
     # Utility functions
     'derivative_5pt', 'derivative_2nd_5pt', 'richardson_extrapolation',
 ]

{coordinate_system-2.5.7 → coordinate_system-3.0.0}/coordinate_system/differential_geometry.py

@@ -357,6 +357,103 @@ class IntrinsicGradientCurvatureCalculator:
 
         return K
 
+    def compute_riemann_curvature(self, u: float, v: float, proportional_correction: bool = True) -> float:
+        """
+        Compute Riemann curvature tensor component R^1_212
+        Based on the intrinsic gradient operator method with correct implementation
+        """
+        delta = self.h
+
+        # 计算中心标架
+        c_center = self.grad_op.calc_intrinsic_frame(u, v)
+
+        # 计算u方向的内禀梯度算子（使用中心差分）
+        c_u_plus = self.grad_op.calc_intrinsic_frame(u + delta, v)
+        c_u_minus = self.grad_op.calc_intrinsic_frame(u - delta, v)
+        G_u = (c_u_plus - c_u_minus) / (2 * delta)
+
+        # 计算v方向的内禀梯度算子（使用中心差分）
+        c_v_plus = self.grad_op.calc_intrinsic_frame(u, v + delta)
+        c_v_minus = self.grad_op.calc_intrinsic_frame(u, v - delta)
+        G_v = (c_v_plus - c_v_minus) / (2 * delta)
+
+        # 计算李括号 [G_u, G_v] = G_u ∘ G_v - G_v ∘ G_u
+        # 这需要计算二阶混合偏导数
+
+        # 计算 ∂²c/∂u∂v 和 ∂²c/∂v∂u
+        c_uv_pp = self.grad_op.calc_intrinsic_frame(u + delta, v + delta)
+        c_uv_pm = self.grad_op.calc_intrinsic_frame(u + delta, v - delta)
+        c_uv_mp = self.grad_op.calc_intrinsic_frame(u - delta, v + delta)
+        c_uv_mm = self.grad_op.calc_intrinsic_frame(u - delta, v - delta)
+
+        # 二阶混合偏导数 ∂²c/∂u∂v
+        d2c_dudv = (c_uv_pp - c_uv_pm - c_uv_mp + c_uv_mm) / (4 * delta * delta)
+
+        # 对于对称的联络，∂²c/∂v∂u = ∂²c/∂u∂v，所以李括号简化为零
+        # 但是我们需要考虑标架的非对易性
+
+        # 更精确的方法：直接计算联络系数的变化
+        # 提取法向量的导数（这是关键）
+        dn_du = G_u.VZ()  # 法向量在u方向的导数
+        dn_dv = G_v.VZ()  # 法向量在v方向的导数
+
+        # 计算切向量（根据曲面类型）
+        if isinstance(self.surface, Sphere):
+            R = self.surface.R
+            theta, phi = u, v
+            r_u = vec3(
+                R * math.cos(theta) * math.cos(phi),
+                R * math.cos(theta) * math.sin(phi),
+                -R * math.sin(theta)
+            )
+            r_v = vec3(
+                -R * math.sin(theta) * math.sin(phi),
+                R * math.sin(theta) * math.cos(phi),
+                0
+            )
+        elif isinstance(self.surface, Torus):
+            R = self.surface.R
+            r = self.surface.r
+            u_param, v_param = u, v
+            r_u = vec3(
+                -r * math.sin(u_param) * math.cos(v_param),
+                -r * math.sin(u_param) * math.sin(v_param),
+                r * math.cos(u_param)
+            )
+            r_v = vec3(
+                -(R + r * math.cos(u_param)) * math.sin(v_param),
+                (R + r * math.cos(u_param)) * math.cos(v_param),
+                0
+            )
+        else:
+            r_u = self.surface.tangent_u(u, v)
+            r_v = self.surface.tangent_v(u, v)
+
+        # 计算第二基本形式系数
+        L = -dn_du.dot(r_u)
+        M = -dn_du.dot(r_v)
+        N = -dn_dv.dot(r_v)
+
+        # 计算度量张量
+        E = r_u.dot(r_u)
+        F = r_u.dot(r_v)
+        G_metric = r_v.dot(r_v)
+        det_g = E * G_metric - F * F
+
+        # 对于2D曲面，黎曼曲率张量只有一个独立分量
+        # R^1_212 与高斯曲率的关系为：K = R^1_212 / det(g)
+        # 所以 R^1_212 = K * det(g) = (LN - M²)
+
+        R_1212 = L * N - M * M
+
+        # 比例修正（对于某些参数化可能需要）
+        if proportional_correction and isinstance(self.surface, Sphere):
+            # 对于球面的某些参数化，可能需要额外的修正
+            # 但是基于第二基本形式的计算通常不需要
+            pass
+
+        return R_1212
+
     def compute_mean_curvature(self, u: float, v: float) -> float:
         """
         Compute mean curvature
@@ -475,6 +572,29 @@ def compute_mean_curvature(
     return calc.compute_mean_curvature(u, v)
 
 
+def compute_riemann_curvature(
+    surface: Surface,
+    u: float,
+    v: float,
+    step_size: float = 1e-3,
+    proportional_correction: bool = True
+) -> float:
+    """
+    Compute Riemann curvature tensor component R^1_212
+
+    Args:
+        surface: Surface object
+        u, v: Parameter values
+        step_size: Step size for numerical differentiation
+        proportional_correction: Apply proportional correction for spherical coordinates
+
+    Returns:
+        Riemann curvature tensor component R^1_212
+    """
+    calc = IntrinsicGradientCurvatureCalculator(surface, step_size)
+    return calc.compute_riemann_curvature(u, v, proportional_correction)
+
+
 def compute_all_curvatures(
     surface: Surface,
     u: float,

{coordinate_system-2.5.7 → coordinate_system-3.0.0/coordinate_system.egg-info}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.1
 Name: coordinate_system
-Version: 2.5.7
-Summary: High-performance 3D coordinate system library with Intrinsic Gradient Operator method for curvature computation, achieving machine-precision accuracy
+Version: 3.0.0
+Summary: High-performance 3D coordinate system library with right-handed conventions, Intrinsic Gradient Operator method for curvature computation, achieving machine-precision accuracy
 Home-page: https://github.com/panguojun/Coordinate-System
 Author: PanGuoJun
 Author-email: 18858146@qq.com
@@ -48,20 +48,27 @@ License-File: LICENSE
 [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
 
 **Author:** PanGuoJun
-**Version:** 2.4.1
+**Version:** 3.0.0
 **License:** MIT
 
-## 🆕 What's New in v2.4.0
+## 🆕 What's New in v3.0.0
 
-**Critical Fix & Enhancement Release!**
+**Critical Coordinate System Update - Right-Hand System!**
 
-- 🔧 **Fixed Curvature Extraction** - Corrected antisymmetric part extraction: `K = (R_01 - R_10)/(2·det(g))`
-- ✨ **Machine Precision Accuracy** - Gaussian curvature now achieves **0.000% error** on spheres (machine precision)!
-- ✨ **New Convenience Functions** - Added `coord3.identity()`, `coord3.zero()`, `coord3.from_position()`, `coord3.from_rotation()`
-- 📚 **Updated Documentation** - Complete mathematical foundation with verified formulas
-- 🎯 **Removed Experimental Code** - Eliminated incorrect π division hack
+- ⚠️ **BREAKING CHANGE: Right-Hand Coordinate System** - Unified all operations to standard right-hand coordinate system
+  - `vec3.cross()` now uses right-hand rule (standard mathematical definition)
+  - Quaternion rotations follow right-hand convention (counter-clockwise is positive)
+  - `coord3.look_at()` and `coord3.from_forward()` updated accordingly
+  - **Migration Guide:** See [HANDEDNESS_CHANGE.md](HANDEDNESS_CHANGE.md) for details
+  - `cross_left()` method retained for backward compatibility
+- ✅ **Verified Correctness** - Complete test suite validates right-hand system behavior
+- 📚 **Updated Documentation** - All examples and documentation reflect new coordinate system
+- 🎯 **Enhanced Clarity** - Comments and docstrings clarified throughout
 
-**Breaking Change:** Previous versions had ~2.5% error due to incorrect curvature extraction. This version fixes the fundamental formula to achieve theoretical accuracy.
+**Why This Change:**
+1. Mathematical Standard: Right-hand system is the standard in mathematics and physics
+2. Better Interoperability: Compatible with OpenGL, NumPy, SciPy, and most scientific libraries
+3. Improved Readability: Standard cross product formulas match textbook definitions
 
 Perfect for computational geometry, geometric analysis, and discrete differential geometry research!
 
@@ -106,15 +113,8 @@ Perfect for computational geometry, geometric analysis, and discrete differentia
 
 For a comprehensive understanding of the mathematical principles behind coordinate systems, vectors, quaternions, and transformations, see our detailed mathematical guide:
 
-**[📖 Mathematical Foundation of Coordinate Systems](https://github.com/panguojun/Coordinate-System/blob/main/MATHEMATICAL_FOUNDATION.md)**
+**[📖 Mathematical Foundation of Coordinate Systems](https://github.com/panguojun/Coordinate-System)**
 
-This guide covers:
-- Vector mathematics (dot product, cross product, projections)
-- Quaternion theory and applications
-- Coordinate system transformations
-- Euler angles and gimbal lock
-- Interpolation methods (LERP, SLERP, NLERP)
-- Practical applications in graphics, physics, and robotics
 
 ---
 
@@ -192,19 +192,27 @@ lerped = vec3.lerp(v1, v2, 0.5)  # Linear interpolation
 
 ## Coordinate System Type
 
-This library uses a **left-handed coordinate system** for all vector and quaternion operations.
+This library uses a **right-handed coordinate system** for all vector and quaternion operations (as of v3.0.0).
 
 ```
-      +Y
-       |
-       |
-       |
-       +-----> +X
-      /
-     /
-   +Z
+         +Y
+          |
+          |
+          |
+          +-----> +X
+         /
+        /
+      +Z
 ```
 
+**Right-Hand Rule:**
+- Point your right hand's fingers along the +X axis
+- Curl them toward the +Y axis
+- Your thumb points along the +Z axis
+- Cross product: **X × Y = Z** (standard mathematical definition)
+
+**Migration from v2.x:** If your code relied on the previous left-handed system, see [HANDEDNESS_CHANGE.md](HANDEDNESS_CHANGE.md) for migration instructions.
+
 ---
 
 ## API Reference
@@ -425,7 +433,7 @@ v4 = v1 * 5                     # vec3(5, 0, 0)
 
 # Dot and cross products
 dot = v1.dot(v2)                # 0.0 (perpendicular)
-cross = v1.cross(v2)            # vec3(0, 0, 1) in left-handed system
+cross = v1.cross(v2)            # vec3(0, 0, 1) in right-handed system (X × Y = Z)
 
 # Length and normalization
 length = v1.length()            # 1.0

{coordinate_system-2.5.7 → coordinate_system-3.0.0}/coordinate_system_binding.cpp

@@ -5,11 +5,11 @@
  * Global version - English interface
  *
  * Author: PanGuoJun
- * Version: 1.0.2
+ * Version: 3.0.0 (Right-Handed Coordinate System)
  *
  * Build:
- *   python setup_coordinate.py build
- *   python setup_coordinate.py install
+ *   python setup.py build
+ *   python setup.py install
  */
 
 #include <pybind11/pybind11.h>
@@ -66,8 +66,8 @@ PYBIND11_MODULE(coordinate_system, m) {
 
         // Vector operations
         .def("dot", &vec3::dot, "Dot product", py::arg("other"))
-        .def("cross", &vec3::cross, "Cross product (left-handed)", py::arg("other"))
-        .def("cross_right", &vec3::cross_right, "Cross product (right-handed)", py::arg("other"))
+        .def("cross", &vec3::cross, "Cross product (right-handed)", py::arg("other"))
+        .def("cross_right", &vec3::cross_right, "Cross product (right-handed, alias)", py::arg("other"))
         .def("len", &vec3::len, "Length of vector")
         .def("length", &vec3::length, "Length of vector (alias)")
         .def("lenxy", &vec3::lenxy, "Length in XY plane")
@@ -471,9 +471,9 @@ PYBIND11_MODULE(coordinate_system, m) {
     m.def("dot", [](const vec3& a, const vec3& b) { return a.dot(b); },
         "Dot product", py::arg("a"), py::arg("b"));
     m.def("cross", [](const vec3& a, const vec3& b) { return a.cross(b); },
-        "Cross product (left-handed)", py::arg("a"), py::arg("b"));
-    m.def("cross_right", [](const vec3& a, const vec3& b) { return a.cross_right(b); },
         "Cross product (right-handed)", py::arg("a"), py::arg("b"));
+    m.def("cross_right", [](const vec3& a, const vec3& b) { return a.cross_right(b); },
+        "Cross product (right-handed, alias)", py::arg("a"), py::arg("b"));
     m.def("distance", [](const vec3& a, const vec3& b) { return (b - a).len(); },
         "Distance between two vectors", py::arg("a"), py::arg("b"));
     m.def("angle_between", [](const vec3& a, const vec3& b) { return vec3::angle(a, b); },
@@ -531,6 +531,7 @@ PYBIND11_MODULE(coordinate_system, m) {
     m.attr("EPSILON") = (real)EPSILON;
     m.attr("VERSION") = GCU_VERSION;
 
-    m.attr("__version__") = "1.0.2";
+    m.attr("__version__") = "3.0.0";
     m.attr("__author__") = "PanGuoJun";
+    m.attr("__coordinate_system__") = "right-handed";
 }

{coordinate_system-2.5.7 → coordinate_system-3.0.0}/pmsys_minimal.hpp

@@ -878,10 +878,10 @@ 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);
+        // 右手坐标系标准叉乘
+        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-2.5.7 → coordinate_system-3.0.0}/setup.py

@@ -2,7 +2,7 @@
 setup.py - Cross-platform setup for coordinate_system package
 
 Author: PanGuoJun
-Version: 2.5.7
+Version: 3.0.0
 License: MIT
 """
 
@@ -69,12 +69,12 @@ ext_modules = [
 
 setup(
     name='coordinate_system',
-    version='2.5.7',
+    version='3.0.0',
     packages=find_packages(),
     ext_modules=ext_modules,  # Add extension modules
 
     # Metadata
-    description='High-performance 3D coordinate system library with Intrinsic Gradient Operator method for curvature computation, achieving machine-precision accuracy',
+    description='High-performance 3D coordinate system library with right-handed conventions, Intrinsic Gradient Operator method for curvature computation, achieving machine-precision accuracy',
     long_description=long_description,
     long_description_content_type='text/markdown',