Metadata-Version: 2.4
Name: diffforms
Version: 0.2.2
Summary:  A symbolic differential form library with exterior calculus operations and sympy integration. Applications involve General Relativity and differentialform descriptions of Manifolds.
Author: Adam Shaw
Project-URL: Homepage, https://pypi.org/project/diffforms/
Project-URL: Repository, https://codeberg.org/adamshaw5505/Differential-Forms.git
Keywords: differential forms,sympy,polyforms,exterior derivative
Requires-Python: >=3.12
Description-Content-Type: text/markdown
Requires-Dist: wheel>=0.43.0
Requires-Dist: sympy>=1.12.0
Requires-Dist: ipython>=8.19.0
Requires-Dist: numpy>=2.3.5

General
=======
The Diffform python package implements differential forms and poly-forms from differential geometry. It includes some usual operations found in exterior calculus, include exterior product, differential operator. The main advantage of this package over other differential form packages ( e.g. [pycartan](https://github.com/TUD-RST/pycartan) ) is that it allows for polyforms and there is no dependence on basis forms.

This package is a part-time project during my PhD, updates should be suspected to end eventually. Bugs and mistakes may (possibly will) be prevalent.

Documentation will be implemented when I find the time, when I have time I will try to implement comments in the class/functions as a rudimentary form of documentation.

ToDo List
=========
This is the list of possible implementation, in an approximate order of priority (interest to me):

- [X] Differential Forms
- [X] Exterior Product
- [X] Simplification of Forms
- [X] Exterior Differential Operator
- [X] Substitution of factors/forms
- [X] Vector fields
- [X] Generic tensor product
- [X] Insertion of vector fields
- [X] Generic Tensor Contractions
- [X] Implement substitution for Tensors
- [X] Hodge star given metric/frame (Working?)
- [X] Spin connection computation
- [] Lie Derivative on generic Tensor (add weight)
- [ ] Fallback to symbolic Hodge star without basis (or if form isn't in basis)
- [ ] Solving 1-form simple linear equations
- [ ] Vector Field Commutator
- [ ] Separate G-Structure Commands into separate files/subfolders

Dependencies
============
Make sure you have the following python packages:

- wheel (needed for installing through pip)
- sympy

Installation
============
Package should be uploaded to pip fairly frequently and is currently under [diffforms](https://pypi.org/project/diffforms/)
