coordinate-system 4.0.1__tar.gz → 4.0.3__tar.gz

{coordinate_system-4.0.1/coordinate_system.egg-info → coordinate_system-4.0.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: coordinate_system
-Version: 4.0.1
+Version: 4.0.3
 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
@@ -48,7 +48,7 @@ License-File: LICENSE
 [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
 
 **Author:** PanGuoJun
-**Version:** 3.0.0
+**Version:** 4.0.2
 **License:** MIT
 
 ## 🆕 What's New in v4.0.0
@@ -71,24 +71,24 @@ License-File: LICENSE
 
 ## 🆕 What's New in v3.0.0
 
-**Critical Coordinate System Update - Right-Hand System!**
+**Critical Coordinate System Update - Left-Hand System!**
 
-- ⚠️ **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)
+- ⚠️ **BREAKING CHANGE: Left-Hand Coordinate System** - Unified all operations to standard left-hand coordinate system
+  - `vec3.cross()` now uses left-hand rule (common in computer graphics)
+  - Quaternion rotations follow left-hand convention (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
+  - `cross_right()` method retained for backward compatibility
+- ✅ **Verified Correctness** - Complete test suite validates left-hand system behavior
 - 📚 **Updated Documentation** - All examples and documentation reflect new coordinate system
 - 🎯 **Enhanced Clarity** - Comments and docstrings clarified throughout
 
 **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
+1. Graphics Standard: Left-hand system is common in computer graphics and DirectX
+2. Better Interoperability: Compatible with DirectX, Unity, and many game engines
+3. Improved Readability: Standard cross product formulas match graphics pipeline definitions
 
-Perfect for computational geometry, geometric analysis, and discrete differential geometry research!
+Perfect for computer graphics, game development, and 3D visualization applications!
 
 ---
 
@@ -210,7 +210,7 @@ lerped = vec3.lerp(v1, v2, 0.5)  # Linear interpolation
 
 ## Coordinate System Type
 
-This library uses a **right-handed coordinate system** for all vector and quaternion operations (as of v3.0.0).
+This library uses a **left-handed coordinate system** for all vector and quaternion operations (as of v3.0.0).
 
 ```
          +Y
@@ -218,18 +218,18 @@ This library uses a **right-handed coordinate system** for all vector and quater
           |
           |
           +-----> +X
-         /
-        /
-      +Z
+          \
+           \
+            +Z
 ```
 
-**Right-Hand Rule:**
-- Point your right hand's fingers along the +X axis
+**Left-Hand Rule:**
+- Point your left 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)
+- Cross product: **X × Y = Z** (common in computer graphics)
 
-**Migration from v2.x:** If your code relied on the previous left-handed system, see [HANDEDNESS_CHANGE.md](HANDEDNESS_CHANGE.md) for migration instructions.
+**Migration from v2.x:** If your code relied on the previous right-handed system, see [HANDEDNESS_CHANGE.md](HANDEDNESS_CHANGE.md) for migration instructions.
 
 ---
 
@@ -267,7 +267,7 @@ v3 = v1 * v2           # Component-wise multiplication
 
 ```python
 dot = v1.dot(v2)       # Dot product (float)
-cross = v1.cross(v2)   # Cross product (vec3)
+cross = v1.cross(v2)   # Cross product (vec3) - Left-hand rule
 length = v.length()    # Vector length
 v.normalize()          # Normalize in-place
 normalized = v.normcopy()  # Return normalized copy
@@ -451,7 +451,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 right-handed system (X × Y = Z)
+cross = v1.cross(v2)            # vec3(0, 0, -1) in left-handed system (X × Y = -Z)
 
 # Length and normalization
 length = v1.length()            # 1.0
@@ -516,8 +516,8 @@ child_in_world = child * parent
 # Create look-at transformation (custom implementation needed)
 def look_at(eye, target, up=vec3(0, 1, 0)):
     forward = (target - eye).normcopy()
-    right = up.cross(forward).normcopy()
-    up_corrected = forward.cross(right)
+    right = forward.cross(up).normcopy()  # Left-hand cross product
+    up_corrected = right.cross(forward)
     return coord3.from_axes(right, up_corrected, forward)
 
 camera = look_at(vec3(10, 10, 10), vec3(0, 0, 0))
@@ -537,8 +537,8 @@ class Camera:
 
     def create_look_at(self, eye, target, up):
         forward = (target - eye).normcopy()
-        right = up.cross(forward).normcopy()
-        up_corrected = forward.cross(right)
+        right = forward.cross(up).normcopy()  # Left-hand cross product
+        up_corrected = right.cross(forward)
 
         c = coord3()
         c.o = eye

{coordinate_system-4.0.1 → coordinate_system-4.0.3}/README.md

@@ -8,7 +8,7 @@
 [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
 
 **Author:** PanGuoJun
-**Version:** 3.0.0
+**Version:** 4.0.2
 **License:** MIT
 
 ## 🆕 What's New in v4.0.0
@@ -31,24 +31,24 @@
 
 ## 🆕 What's New in v3.0.0
 
-**Critical Coordinate System Update - Right-Hand System!**
+**Critical Coordinate System Update - Left-Hand System!**
 
-- ⚠️ **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)
+- ⚠️ **BREAKING CHANGE: Left-Hand Coordinate System** - Unified all operations to standard left-hand coordinate system
+  - `vec3.cross()` now uses left-hand rule (common in computer graphics)
+  - Quaternion rotations follow left-hand convention (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
+  - `cross_right()` method retained for backward compatibility
+- ✅ **Verified Correctness** - Complete test suite validates left-hand system behavior
 - 📚 **Updated Documentation** - All examples and documentation reflect new coordinate system
 - 🎯 **Enhanced Clarity** - Comments and docstrings clarified throughout
 
 **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
+1. Graphics Standard: Left-hand system is common in computer graphics and DirectX
+2. Better Interoperability: Compatible with DirectX, Unity, and many game engines
+3. Improved Readability: Standard cross product formulas match graphics pipeline definitions
 
-Perfect for computational geometry, geometric analysis, and discrete differential geometry research!
+Perfect for computer graphics, game development, and 3D visualization applications!
 
 ---
 
@@ -170,7 +170,7 @@ lerped = vec3.lerp(v1, v2, 0.5)  # Linear interpolation
 
 ## Coordinate System Type
 
-This library uses a **right-handed coordinate system** for all vector and quaternion operations (as of v3.0.0).
+This library uses a **left-handed coordinate system** for all vector and quaternion operations (as of v3.0.0).
 
 ```
          +Y
@@ -178,18 +178,18 @@ This library uses a **right-handed coordinate system** for all vector and quater
           |
           |
           +-----> +X
-         /
-        /
-      +Z
+          \
+           \
+            +Z
 ```
 
-**Right-Hand Rule:**
-- Point your right hand's fingers along the +X axis
+**Left-Hand Rule:**
+- Point your left 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)
+- Cross product: **X × Y = Z** (common in computer graphics)
 
-**Migration from v2.x:** If your code relied on the previous left-handed system, see [HANDEDNESS_CHANGE.md](HANDEDNESS_CHANGE.md) for migration instructions.
+**Migration from v2.x:** If your code relied on the previous right-handed system, see [HANDEDNESS_CHANGE.md](HANDEDNESS_CHANGE.md) for migration instructions.
 
 ---
 
@@ -227,7 +227,7 @@ v3 = v1 * v2           # Component-wise multiplication
 
 ```python
 dot = v1.dot(v2)       # Dot product (float)
-cross = v1.cross(v2)   # Cross product (vec3)
+cross = v1.cross(v2)   # Cross product (vec3) - Left-hand rule
 length = v.length()    # Vector length
 v.normalize()          # Normalize in-place
 normalized = v.normcopy()  # Return normalized copy
@@ -411,7 +411,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 right-handed system (X × Y = Z)
+cross = v1.cross(v2)            # vec3(0, 0, -1) in left-handed system (X × Y = -Z)
 
 # Length and normalization
 length = v1.length()            # 1.0
@@ -476,8 +476,8 @@ child_in_world = child * parent
 # Create look-at transformation (custom implementation needed)
 def look_at(eye, target, up=vec3(0, 1, 0)):
     forward = (target - eye).normcopy()
-    right = up.cross(forward).normcopy()
-    up_corrected = forward.cross(right)
+    right = forward.cross(up).normcopy()  # Left-hand cross product
+    up_corrected = right.cross(forward)
     return coord3.from_axes(right, up_corrected, forward)
 
 camera = look_at(vec3(10, 10, 10), vec3(0, 0, 0))
@@ -497,8 +497,8 @@ class Camera:
 
     def create_look_at(self, eye, target, up):
         forward = (target - eye).normcopy()
-        right = up.cross(forward).normcopy()
-        up_corrected = forward.cross(right)
+        right = forward.cross(up).normcopy()  # Left-hand cross product
+        up_corrected = right.cross(forward)
 
         c = coord3()
         c.o = eye
@@ -714,4 +714,4 @@ Built with ❤️ using:
 
 ---
 
-**Note**: For the latest updates and documentation, visit the [GitHub repository](https://github.com/panguojun/Coordinate-System).
+**Note**: For the latest updates and documentation, visit the [GitHub repository](https://github.com/panguojun/Coordinate-System).

{coordinate_system-4.0.1 → coordinate_system-4.0.3/coordinate_system.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: coordinate_system
-Version: 4.0.1
+Version: 4.0.3
 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
@@ -48,7 +48,7 @@ License-File: LICENSE
 [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
 
 **Author:** PanGuoJun
-**Version:** 3.0.0
+**Version:** 4.0.2
 **License:** MIT
 
 ## 🆕 What's New in v4.0.0
@@ -71,24 +71,24 @@ License-File: LICENSE
 
 ## 🆕 What's New in v3.0.0
 
-**Critical Coordinate System Update - Right-Hand System!**
+**Critical Coordinate System Update - Left-Hand System!**
 
-- ⚠️ **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)
+- ⚠️ **BREAKING CHANGE: Left-Hand Coordinate System** - Unified all operations to standard left-hand coordinate system
+  - `vec3.cross()` now uses left-hand rule (common in computer graphics)
+  - Quaternion rotations follow left-hand convention (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
+  - `cross_right()` method retained for backward compatibility
+- ✅ **Verified Correctness** - Complete test suite validates left-hand system behavior
 - 📚 **Updated Documentation** - All examples and documentation reflect new coordinate system
 - 🎯 **Enhanced Clarity** - Comments and docstrings clarified throughout
 
 **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
+1. Graphics Standard: Left-hand system is common in computer graphics and DirectX
+2. Better Interoperability: Compatible with DirectX, Unity, and many game engines
+3. Improved Readability: Standard cross product formulas match graphics pipeline definitions
 
-Perfect for computational geometry, geometric analysis, and discrete differential geometry research!
+Perfect for computer graphics, game development, and 3D visualization applications!
 
 ---
 
@@ -210,7 +210,7 @@ lerped = vec3.lerp(v1, v2, 0.5)  # Linear interpolation
 
 ## Coordinate System Type
 
-This library uses a **right-handed coordinate system** for all vector and quaternion operations (as of v3.0.0).
+This library uses a **left-handed coordinate system** for all vector and quaternion operations (as of v3.0.0).
 
 ```
          +Y
@@ -218,18 +218,18 @@ This library uses a **right-handed coordinate system** for all vector and quater
           |
           |
           +-----> +X
-         /
-        /
-      +Z
+          \
+           \
+            +Z
 ```
 
-**Right-Hand Rule:**
-- Point your right hand's fingers along the +X axis
+**Left-Hand Rule:**
+- Point your left 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)
+- Cross product: **X × Y = Z** (common in computer graphics)
 
-**Migration from v2.x:** If your code relied on the previous left-handed system, see [HANDEDNESS_CHANGE.md](HANDEDNESS_CHANGE.md) for migration instructions.
+**Migration from v2.x:** If your code relied on the previous right-handed system, see [HANDEDNESS_CHANGE.md](HANDEDNESS_CHANGE.md) for migration instructions.
 
 ---
 
@@ -267,7 +267,7 @@ v3 = v1 * v2           # Component-wise multiplication
 
 ```python
 dot = v1.dot(v2)       # Dot product (float)
-cross = v1.cross(v2)   # Cross product (vec3)
+cross = v1.cross(v2)   # Cross product (vec3) - Left-hand rule
 length = v.length()    # Vector length
 v.normalize()          # Normalize in-place
 normalized = v.normcopy()  # Return normalized copy
@@ -451,7 +451,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 right-handed system (X × Y = Z)
+cross = v1.cross(v2)            # vec3(0, 0, -1) in left-handed system (X × Y = -Z)
 
 # Length and normalization
 length = v1.length()            # 1.0
@@ -516,8 +516,8 @@ child_in_world = child * parent
 # Create look-at transformation (custom implementation needed)
 def look_at(eye, target, up=vec3(0, 1, 0)):
     forward = (target - eye).normcopy()
-    right = up.cross(forward).normcopy()
-    up_corrected = forward.cross(right)
+    right = forward.cross(up).normcopy()  # Left-hand cross product
+    up_corrected = right.cross(forward)
     return coord3.from_axes(right, up_corrected, forward)
 
 camera = look_at(vec3(10, 10, 10), vec3(0, 0, 0))
@@ -537,8 +537,8 @@ class Camera:
 
     def create_look_at(self, eye, target, up):
         forward = (target - eye).normcopy()
-        right = up.cross(forward).normcopy()
-        up_corrected = forward.cross(right)
+        right = forward.cross(up).normcopy()  # Left-hand cross product
+        up_corrected = right.cross(forward)
 
         c = coord3()
         c.o = eye

{coordinate_system-4.0.1 → coordinate_system-4.0.3}/coordinate_system_binding.cpp

@@ -337,6 +337,7 @@ PYBIND11_MODULE(coordinate_system, m) {
 
         // Methods
         .def("Q", [](const coord3& self) { return self.Q(); }, "Get rotation as quaternion")
+		.def("R", [](const coord3& self) { return coord3(self.R()); }, "Get rotation as coord3")
         .def("P", &coord3::pos, "Get position")
         .def("V", &coord3::tovec, "Convert to vector")
         .def("normalize", &coord3::normalize, "Normalize axes")

{coordinate_system-4.0.1 → coordinate_system-4.0.3}/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-4.0.1 → coordinate_system-4.0.3}/setup.py

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