Ricci
A Mathematica package for doing tensor calculations in differential geometry
Version 1.63
Last Updated
May 29, 2022
Ricci is a Mathematica package for
doing symbolic tensor computations that arise in differential geometry.
It has the following features and capabilities: |
-
Manipulation of tensor expressions with and without indices
-
Implicit use of the Einstein summation convention
-
Correct manipulation of dummy indices
-
Display of results in mathematical notation, with upper and lower indices
-
Automatic calculation of covariant derivatives
-
Automatic application of tensor symmetries
-
Riemannian metrics and curvatures
-
Differential forms
-
Any number of vector bundles with user-defined characteristics
-
Names of indices indicate which bundles they refer to
-
Complex bundles and tensors
-
Conjugation indicated by barred indices
-
Connections with and without torsion
Limitations: Ricci does not support computation of explicit
values for tensor components in coordinates, or derivatives of tensors
depending on parameters (as in geometric evolution equations or calculus
of variations), although support for these is planned for a future release.
Ricci also has no explicit support for general relativity, or for other
mathematical physics or engineering applications, and none is planned.
Disclaimer: Be warned that I make no claims that this is a professional-quality
software package. I have tried to make it as general and error-free as
possible, and I think it is reasonably robust. However, I did most of the
work on this package in my "spare time", with only very limited programming
assistance, so I haven't had time to check everything. I am no longer actively maintaining the program, but I will try to fix
any bugs that you encounter.
If you use this package at all, I would appreciate it if you would send
me a message at johnmlee@uw.edu
describing
your experience, and telling me whether you found the package useful or
not. I'd especially like to hear about any bugs, anomalous behavior, things
that look like they should simplify but don't, suggestions for improvement,
things that seem to take longer than they should, etc. If I get e-mail
from you, I'll put you on my mailing list to be informed whenever I release
a new production version.
How to get Ricci
Before you obtain or use Ricci, please read the copyright
notice. Then download the following files:
-
Manual.pdf:
User's Manual (380K - about 90 pages when printed)
- Ricci.m:
the source file for the latest version of Ricci (291K)
-
Example.txt:
an example of Ricci usage (ASCII, 20K).
-
Changes.txt:
A list of all significant changes to Ricci since the first beta release
(ASCII, 6K).
-
Ricci.tex:
TeX macros needed for Ricci's TeXForm output (ASCII, 2K)
Once you have downloaded the files, put the source file Ricci.m in the directory
in which you place Mathematica input files. If you plan to use TeXForm
output from Ricci, put Ricci.tex in the directory in which TeX looks for its
input files.
Using Ricci
Ricci requires Mathematica version 2.0 or greater. The source takes approximately
283K bytes of disk storage, including about 49K bytes of on-line documentation.
I have tested the current version of the package with Mathematica 5.0 under Windows.
Although I haven't tested it in other situations, I know of no reason why it should
not run on any platform using Mathematica 2.0 or later.
To use Ricci, put the Ricci.m source file into a
directory of your own that is accessible to Mathematica. (You may need to change
the value of Mathematica's $Path variable in your initialization file--see
the documentation for the version of Mathematica that you're using.) Then load
the Ricci package by typing the following Mathematica command:
<<Ricci.m
Once you've loaded Ricci into Mathematica, you can type ?name
for information about any Ricci function or command.
Changes in Version 1.63
- Fixed TagUnset error caused by change in Mathematica 12.2 and later
Here's a log of changes in prior versions of Ricci.
John M. Lee
University of Washington
Department of Mathematics
Box 354350
Seattle, WA 98195-4350
USA
Phone: (206) 543-1735
E-mail: johnmlee@uw.edu