safe-tensor: Dependently typed tensor algebra

[ library, math, mit ] [ Propose Tags ] [ Report a vulnerability ]
Versions [RSS] 0.1.0.0, 0.2.0.0, 0.2.1.0, 0.2.1.1
Change log CHANGELOG.md
Dependencies base (>=4.7 && <5), constraints (>=0.10 && <0.14), containers (>=0.6 && <0.7), deepseq (>=1.4 && <1.5), hmatrix (>=0.20 && <0.21), mtl (>=2.2 && <2.3), singletons (>=2.5 && <2.8) [details]
License MIT
Copyright 2020 Nils Alex
Author Nils Alex
Maintainer nils.alex@fau.de
Category Math
Home page https://github.com/nilsalex/safe-tensor#readme
Bug tracker https://github.com/nilsalex/safe-tensor/issues
Source repo head: git clone https://github.com/nilsalex/safe-tensor
Uploaded by nalex at 2021-02-27T17:37:40Z
Distributions
Downloads 776 total (7 in the last 30 days)
Rating (no votes yet) [estimated by Bayesian average]
Your Rating
  • λ
  • λ
  • λ
Status Docs available [build log]
Last success reported on 2021-02-27 [all 1 reports]

Readme for safe-tensor-0.2.1.1

[back to package description]

DOI Hackage-Deps Hackage Build Status

safe-tensor

Dependently typed tensor algebra in Haskell. Useful for applications in field theory, e.g., carrying out calculations for https://doi.org/10.1103/PhysRevD.101.084025

Rationale

Tensor calculus is reflected in the type system. We regard a tensor as a multilinear map from a product of vector spaces and duals thereof to the common field. The type of each tensor is its generalized rank, describing the vector spaces it acts on and assigning a label to each vector space. There are a few rules for tensor operations:

  • Only tensors of the same type may be added. The result is a tensor of this type.
  • Tensors may be multiplied if the resulting generalized rank does not contain repeated labels for the same (dual) vector space.
  • The contraction of a tensors removes pairs of vector space and dual vector space with the same label from the generalized rank.

It is thus impossible to perform inconsistent tensor operations.

There is also an existentially typed variant of the tensor type useful for runtime computations. These computations take place in the Error monad, throwing errors if operand types are not consistent.

The approach is described in detail in the Hackage documentation.