coordinate-system 4.0.1__cp313-cp313-win_amd64.whl → 4.0.3__cp313-cp313-win_amd64.whl

{coordinate_system-4.0.1.dist-info → coordinate_system-4.0.3.dist-info}/METADATA

@@ -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.dist-info → coordinate_system-4.0.3.dist-info}/RECORD

@@ -1,10 +1,10 @@
 coordinate_system/__init__.py,sha256=Qhg-sS6SCHD0TMQ1MaATyEajuv9m8Ip91xewaohpAek,8600
-coordinate_system/coordinate_system.cp313-win_amd64.pyd,sha256=8gN5GiIHPqfqe7xSP_QIWVM_p8nR7V_h2nrWNU7TbGk,497664
+coordinate_system/coordinate_system.cp313-win_amd64.pyd,sha256=K7z-jG4p_jSYxjii1ZZ5Bs3lOjCTC5AZGT1VR-vbUyY,495616
 coordinate_system/curvature.py,sha256=zrgY9QEuFq2tz0HB4mvXfPV-GwMpeE-F5cM--U8Ihfo,11541
 coordinate_system/differential_geometry.py,sha256=whbgMyWQB4AUbZbiaDDAY6YZD7CHs1BVtnvOLN_gqQE,20628
 coordinate_system/fourier_spectral.py,sha256=0rA9_ZS7W-pSKQ1aD9Ds93An5rQ14EWZWM43mOC_UIc,16496
-coordinate_system-4.0.1.dist-info/LICENSE,sha256=tDnRkJxBYPzWdfh2gArRqrUPJxQZRZHJVs68qqBHIq4,1083
-coordinate_system-4.0.1.dist-info/METADATA,sha256=40U-bAEARpHXbih07RmFStFcfo8VaSuEVlnO9NdZ_i4,20842
-coordinate_system-4.0.1.dist-info/WHEEL,sha256=4-iQBlRoDdX1wfPofc7KLWa5Cys4eZSgXs6GVU8fKlQ,101
-coordinate_system-4.0.1.dist-info/top_level.txt,sha256=R6LguuPPZ5esrIsDTqPGi9UxCvZPIXwn7KRKX87c79M,18
-coordinate_system-4.0.1.dist-info/RECORD,,
+coordinate_system-4.0.3.dist-info/LICENSE,sha256=tDnRkJxBYPzWdfh2gArRqrUPJxQZRZHJVs68qqBHIq4,1083
+coordinate_system-4.0.3.dist-info/METADATA,sha256=0_Pgr__XrTeISK7jJS6gS8ANFJSJW2r2IKCdPsIb-wg,20872
+coordinate_system-4.0.3.dist-info/WHEEL,sha256=4-iQBlRoDdX1wfPofc7KLWa5Cys4eZSgXs6GVU8fKlQ,101
+coordinate_system-4.0.3.dist-info/top_level.txt,sha256=R6LguuPPZ5esrIsDTqPGi9UxCvZPIXwn7KRKX87c79M,18
+coordinate_system-4.0.3.dist-info/RECORD,,