coordinates.base#

Base classes and metaclass infrastructure for defining coordinate systems inPyMetric.

This module provides the foundational machinery for all coordinate system definitions. It includes:

  • _CoordinateSystemBase: the abstract base class for coordinate systems, supporting symbolic and numerical operations,

  • _CoordinateMeta: a metaclass that handles automatic symbolic construction and validation of coordinate classes,

  • class_expression(): a decorator to mark symbolic methods that are evaluated on demand.

Coordinate systems built on this foundation can define custom metric tensors, symbolic expressions, and conversions to/from Cartesian coordinates. These systems support tensor calculus operations such as gradients, divergences, and Laplacians, all respecting the underlying geometry.

Attributes

DEFAULT_COORDINATE_REGISTRY

The default registry containing all initialized coordinate system classes.

Functions

class_expression([name])

Mark a class method as a symbolic expression ("class expression") in a coordinate system.

This Page