OGRePy: An Object-Oriented General Relativity Package for Python

2024-09-05

arXiv.org

AI Summary

The current Python ecosystem lacks a modern, open-source symbolic tensor library tailored for general relativity, making it difficult to uniformly model tensors, metrics, and coordinate systems while automatically handling index raising/lowering, covariant differentiation, and coordinate transformations. Method: We introduce the first native object-oriented Python framework for tensor calculus, built atop SymPy, which tightly integrates coordinate systems, index configurations, and tensor algebra to enable fully automated symbolic derivation of covariant derivatives, curvature tensors, and geodesic equations. Contribution/Results: We propose an “object-oriented tensor modeling paradigm” ensuring representational consistency throughout computations; leverage optimized algorithms from OGRe to support complete tensor operation chains. The library rigorously preserves mathematical correctness while substantially lowering the barrier to analytical research in curved spacetimes, and has been successfully applied to diverse problems in general relativity.

Technology Category

• Machine Learning: Matrix & Tensor Methods
• Knowledge Representation and Reasoning: Geometric, Spatial, and Temporal Reasoning
• Computer Vision: Visual Reasoning & Symbolic Representations

Application Category

• Graph Algorithms and Modeling for the Web: Algorithms and analysis for heterogeneous, signed, attributed, multi-relational, temporal, higher-order, and annotated Web-related graphs
• Systems and Infrastructure for Web, Mobile and WoT: Experiences and lessons learnt from Web-based algorithms and system deployments
• Semantics and Knowledge: Scalable techniques for the creation, curation, publication, maintenance, and consumption of large, Web-based, structured, reusable, knowledge graphs and ontologies

Abstract

We present OGRePy, the official Python port of the popular Mathematica tensor calculus package OGRe (Object-Oriented General Relativity) - a powerful, yet user-friendly, tool for advanced tensor calculations in mathematics and physics, especially suitable for general relativity. The Python port uses the same robust and performance-oriented algorithms as the original package, and retains its core design principles. However, its truly object-oriented interface, enabled by Python, is more intuitive and flexible than the original Mathematica implementation. It utilizes SymPy for symbolic computations and Jupyter as a notebook interface. OGRePy allows calculating arbitrary tensor formulas using any combination of addition, multiplication by scalar, trace, contraction, partial derivative, covariant derivative, and permutation of indices. Transformations of the tensor components between different index configurations and/or coordinate systems are performed seamlessly behind the scenes as needed, eliminating user error due to combining incompatible representations, and guaranteeing consistent results. In addition, the package provides facilities for easily calculating various curvature tensors and geodesic equations in multiple representations. This paper presents the main features of the package in great detail, including many examples of its use in the context of general relativity research.

Problem

• Performs symbolic tensor calculations for general relativity
• Automates tensor operations and coordinate transformations
• Provides a user-friendly Python alternative to Mathematica's OGRe

Innovation

• Object-oriented Python package for tensor calculations
• Automates tensor operations with SymPy integration
• Enhances research and teaching in general relativity