coordinate-system 2.4.0__cp313-cp313-win_amd64.whl → 2.4.1__cp313-cp313-win_amd64.whl

{coordinate_system-2.4.0.dist-info → coordinate_system-2.4.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: coordinate_system
-Version: 2.4.0
+Version: 2.4.1
 Summary: High-performance 3D coordinate system library with machine-precision Gaussian curvature computation (0.000% error) using corrected antisymmetric extraction formula
 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:** 2.4.0
+**Version:** 2.4.1
 **License:** MIT
 
 ## 🆕 What's New in v2.4.0
@@ -99,154 +99,6 @@ Perfect for computational geometry, geometric analysis, and discrete differentia
 
 ---
 
-## 🆕 Differential Geometry (NEW in v2.2.0)
-
-### Surface Representation
-
-```python
-from coordinate_system import Sphere, Torus, Surface
-
-# Create a sphere
-sphere = Sphere(radius=2.0)
-
-# Create a torus
-torus = Torus(major_radius=3.0, minor_radius=1.0)
-
-# Or define your own surface by subclassing Surface
-class MySurface(Surface):
-    def position(self, u, v):
-        # Return vec3(x, y, z) for parameters (u, v)
-        pass
-```
-
-### Metric Tensor (First Fundamental Form)
-
-```python
-from coordinate_system import compute_metric
-import math
-
-# Compute metric tensor at a point
-g = compute_metric(sphere, u=math.pi/4, v=math.pi/3)
-
-print(f"E = {g.E:.6f}")   # u-direction metric
-print(f"F = {g.F:.6f}")   # cross term (0 if orthogonal)
-print(f"G = {g.G:.6f}")   # v-direction metric
-print(f"det(g) = {g.det:.6f}")
-print(f"Metric correction = {g.correction_factor():.6f}")
-```
-
-### Connection Operator (Intrinsic Gradient)
-
-```python
-from coordinate_system import compute_connection
-
-# Compute connection operator (frame derivative)
-G_u = compute_connection(sphere, u=math.pi/4, v=math.pi/3, direction='u')
-G_v = compute_connection(sphere, u=math.pi/4, v=math.pi/3, direction='v')
-
-print(f"G_u norm: {G_u.norm():.8f}")
-print(f"G_v norm: {G_v.norm():.8f}")
-```
-
-**Aliases available:**
-- `compute_frame_derivative` (standard mathematical term)
-- `compute_intrinsic_gradient` (intuitive name)
-- `compute_geometric_gradient` (alternative)
-
-### Curvature Tensor
-
-```python
-from coordinate_system import compute_curvature_tensor
-
-# Compute complete curvature tensor R_uv
-R_uv = compute_curvature_tensor(
-    sphere,
-    u=math.pi/4,
-    v=math.pi/3,
-    use_lie_derivative=True  # CRITICAL for accuracy!
-)
-
-print(f"Curvature tensor norm: {R_uv.norm():.8f}")
-
-# R_uv is a 3×3 coord3 object with structure:
-# [[R_11, R_12, R_13],   ← Tangent-tangent (intrinsic)
-#  [R_21, R_22, R_23],   ← Tangent-normal (second fundamental form)
-#  [R_31, R_32, R_33]]   ← Normal-normal (extrinsic)
-```
-
-### Gaussian Curvature (Quickest Method)
-
-```python
-from coordinate_system import Sphere, compute_gaussian_curvature
-import math
-
-# One-line curvature computation!
-sphere = Sphere(radius=2.0)
-K = compute_gaussian_curvature(sphere, u=math.pi/4, v=math.pi/3)
-
-print(f"Gaussian curvature K = {K:.6f}")
-# Expected: K = 1/R² = 0.25 for a sphere
-
-# Theoretical value
-K_theory = 1.0 / (2.0 ** 2)
-error = abs(K - K_theory) / K_theory * 100
-print(f"Relative error: {error:.2f}%")  # Typically < 3% !
-```
-
-### Accuracy Comparison
-
-**On a sphere with radius R=2 (24 test points across different angles):**
-
-| Method | Antisymmetric Extraction | Accuracy | Notes |
-|--------|-------------------------|----------|-------|
-| Old (R_10 only) | ❌ | ~2.5% error | Previous versions |
-| **v2.4.0 (Corrected)** | ✓ | **0.000% error** | **Machine precision!** 🎉 |
-
-**Key Formula:** `K = (R_01 - R_10) / (2 · det(g))`
-
-The antisymmetric part `(R_01 - R_10)/2` correctly eliminates metric influence and extracts pure curvature. This formula is verified against traditional Christoffel symbol methods and achieves identical results at machine precision (< 10⁻¹⁵ error).
-
-### Key Parameters
-
-```python
-# For constant curvature surfaces (spheres):
-K = compute_gaussian_curvature(
-    surface,
-    u, v,
-    scale_factor=2.0,           # Optimal for spheres
-    use_metric_correction=True,  # Essential!
-    use_lie_derivative=True      # Critical for accuracy!
-)
-
-# These are the default values, optimized for best accuracy
-```
-
-### Complete Example
-
-See `examples/curvature_computation.py` for comprehensive demonstrations, or `examples/quickstart.py` for the simplest possible usage.
-
-```python
-# examples/quickstart.py
-import math
-from coordinate_system import Sphere, compute_gaussian_curvature
-
-# Step 1: Create a sphere
-sphere = Sphere(radius=2.0)
-
-# Step 2: Choose a point
-u, v = math.pi/4, math.pi/3
-
-# Step 3: Compute curvature (one line!)
-K = compute_gaussian_curvature(sphere, u, v)
-
-# Step 4: Compare with theory
-K_theory = 1.0 / (2.0 ** 2)  # K = 1/R²
-print(f"Computed: K = {K:.6f}")
-print(f"Theory:   K = {K_theory:.6f}")
-print(f"Error: {abs(K-K_theory)/K_theory*100:.2f}%")
-```
-
----
 
 ## 📚 Documentation
 

{coordinate_system-2.4.0.dist-info → coordinate_system-2.4.1.dist-info}/RECORD

@@ -1,10 +1,10 @@
 coordinate_system/__init__.py,sha256=S-h_uoibcICCh5Tk_-Q6_aMwiCQ2vvKUgE4BzqCHpJ0,7086
-coordinate_system/coordinate_system.cp313-win_amd64.pyd,sha256=w_KFCOSkqLcIo448VGUG619dljhA-VI69VACS8tw3Og,499712
+coordinate_system/coordinate_system.cp313-win_amd64.pyd,sha256=s5nl32y0Xs1sxBe3l6agWPEh6WgzRaIEua33Q7TH_aI,496128
 coordinate_system/curvature.py,sha256=o2XQ7BryvzEyo9cCYhKleeRg6UzacfShSeYyGQkGnwo,26040
 coordinate_system/differential_geometry.py,sha256=yKn1pItaE-tepy-HAetkVfb-jRbDY7RKv68NKk4jsSQ,26345
 coordinate_system/two_stage_curvature.py,sha256=e4fYAhiUc8NwtBi5hz5se4if4i8zZzG8smNlWNwuJpw,7219
-coordinate_system-2.4.0.dist-info/LICENSE,sha256=tDnRkJxBYPzWdfh2gArRqrUPJxQZRZHJVs68qqBHIq4,1083
-coordinate_system-2.4.0.dist-info/METADATA,sha256=W5D_izOqph_fpPyOzTHdBZZ-XxaxInsokUjindsaQ0Y,23738
-coordinate_system-2.4.0.dist-info/WHEEL,sha256=4-iQBlRoDdX1wfPofc7KLWa5Cys4eZSgXs6GVU8fKlQ,101
-coordinate_system-2.4.0.dist-info/top_level.txt,sha256=R6LguuPPZ5esrIsDTqPGi9UxCvZPIXwn7KRKX87c79M,18
-coordinate_system-2.4.0.dist-info/RECORD,,
+coordinate_system-2.4.1.dist-info/LICENSE,sha256=tDnRkJxBYPzWdfh2gArRqrUPJxQZRZHJVs68qqBHIq4,1083
+coordinate_system-2.4.1.dist-info/METADATA,sha256=1Jjg-JdeH9nYq5xavTYPDiL-EAd89M-Of7_jIpYVyBw,19414
+coordinate_system-2.4.1.dist-info/WHEEL,sha256=4-iQBlRoDdX1wfPofc7KLWa5Cys4eZSgXs6GVU8fKlQ,101
+coordinate_system-2.4.1.dist-info/top_level.txt,sha256=R6LguuPPZ5esrIsDTqPGi9UxCvZPIXwn7KRKX87c79M,18
+coordinate_system-2.4.1.dist-info/RECORD,,