Coordinate System
coordinate_system is a mathematical library for computable coordinate systems,
quaternionic frames, and object-level spatial calculus in Python.
Version 13.0.0 is a major cleanup release. The package root is now deliberately pure: it exposes coordinate objects, frame-field calculus, curvature operators, spectral geometry, complex-frame algebra, and curve/surface construction tools. Application-oriented physical wrappers and report generators have been removed from the public package surface.
Core Idea
A computable coordinate system is a local spatial measuring object:
C = (o, q, s) or C = (o, R, D), with E = R D.
ois the affine origin.qorRis the local orientation.sorDis the local scale/ruler structure.
The differential datum of a frame field is the logarithmic or relative local variation of neighboring coordinate objects. The integral operation is the ordered composition that reconstructs global geometry from those local changes.
Installation
pip install coordinate-system
From source:
git clone https://github.com/panguojun/Coordinate-System.git
cd Coordinate-System
pip install -e .
Source builds require a C++17 compiler and pybind11. Runtime dependency is
kept minimal: numpy is required; plotting and SciPy features are optional.
Public Mathematical Layers
Core Coordinate Objects
from coordinate_system import vec3, quat, coord3, ONEC
p = vec3(1.0, 2.0, 3.0)
q = quat(1.0, 0.0, 0.0, 0.0)
scale = vec3(1.0, 1.0, 1.0)
C = coord3(p, q, scale)
CCS Surface Geometry
import math
from coordinate_system import Sphere, compute_ccs_geometry_package
sphere = Sphere(radius=2.0)
pkg = compute_ccs_geometry_package(sphere, math.pi / 4.0, math.pi / 3.0)
print(pkg.K) # Gaussian curvature
print(pkg.H) # Mean curvature
print(pkg.g) # First fundamental form
print(pkg.h) # Second fundamental form
print(pkg.center_frame)
The package keeps the theorem chain explicit:
coord frame -> finite relative variation -> metric/shape data -> curvature invariants
Convenience CCS Wrapper
import math
from coordinate_system import CCS, Sphere
ccs = CCS(step_size=1e-4)
sphere = Sphere(radius=2.0)
print(ccs.gaussian(sphere, math.pi / 4.0, math.pi / 3.0))
print(ccs.mean(sphere, math.pi / 4.0, math.pi / 3.0))
Curve and Surface Construction
import math
from coordinate_system import AnalyticSphere, interpolate_surface_coords
surface = AnalyticSphere(radius=1.0)
frames = interpolate_surface_coords(
surface,
[(math.pi / 3.0, 0.0), (math.pi / 3.0, math.pi / 2.0)],
samples=16,
)
points = [item.frame.o for item in frames]
These APIs are mathematical construction tools. Downstream CAD, rendering, or simulation systems can consume the resulting coord frames, but those application layers are not part of the package root.
Spectral and Complex Frames
from coordinate_system import ComplexFrame, GaugeConnection, FourierFrame
U = ComplexFrame()
A = GaugeConnection()
The complex-frame layer is kept as a mathematical utility for unitary frames, connections, field-strength-like algebra, and spectral constructions. It should not be read as a validated physical model by itself.
API Boundary in 13.0.0
Removed from the public package root:
- CFUT wrapper APIs
- Lambda wrapper APIs
- topological physics application functions
- research registry helpers
- report-generation scripts
- dark-matter, dynamic-stall, and validation application examples
Kept in the mathematical package root:
vec3,vec2,quat,coord3CCS,Surface,Sphere,Torus- metric, intrinsic-gradient, curvature, and CCS geometry package APIs
- spectral geometry utilities
- complex-frame algebra utilities
- curve interpolation, curve intersection, and analytic surface coord tools
Development Smoke Test
python -c "import coordinate_system as cs; print(cs.__version__, cs.Sphere(2).theoretical_gaussian_curvature)"
python -m unittest discover -s test
License
MIT License. Copyright (c) 2024-2026 Pan Guojun.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file coordinate_system-13.0.0.tar.gz.
File metadata
- Download URL: coordinate_system-13.0.0.tar.gz
- Upload date:
- Size: 87.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
08408b33624419239919d196159bc8ed892246043737cf9f6ca0392b43ddf9bf
|
|
| MD5 |
2f774d420c29db35c7c5beec4d7f66c2
|
|
| BLAKE2b-256 |
91fd995b2c0a784855cb4a68bb874d3473b6f788410fcb18b15d5ba1773d4e8a
|
File details
Details for the file coordinate_system-13.0.0-cp313-cp313-win_amd64.whl.
File metadata
- Download URL: coordinate_system-13.0.0-cp313-cp313-win_amd64.whl
- Upload date:
- Size: 219.6 kB
- Tags: CPython 3.13, Windows x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
f73bd423e52a1d56dc88785a32334613c12cd39e1c34c2cfd3304de66ac22b7c
|
|
| MD5 |
317b59e590147be972046f92400e9b4a
|
|
| BLAKE2b-256 |
d6f32d317978f7d10c08d1d0cb013e74ce71fd96c10eb14be5127b7b2fe3e6e9
|
