CarpetCode
home page
Documentation
Introduction (ps, 300 kB)
Internals (ps, 130 kB)
Mailing lists
Subscribe
Archive
Development
Bugzilla
Missing features
Known bugs
Related
Cactus
Feedback
Send email
Carpet is a mesh refinement driver for Cactus. Cactus is a framework for solving time-dependent partial differential equations on uniform grids, and Carpet is an extension of Cactus that make mesh refinement possible. Carpet was originally written in 2001 by Erik Schnetter at the TAT (Theoretische Astrophysik Tübingen) and is currently maintained at the AEI (Max-Planck-Institut für Gravitationsphysik, Albert-Einstein-Institut). These pages describe Carpet and its current development.
News
In January 2004, Daniel Kobras set up Bugzilla for Carpet. Bugzilla is a bug-tracking system that will, so we hope, help us remember what is missing or broken in Carpet.
In October 2003, Erik Schnetter, Scott H. Hawley, and Ian Hawke published the preprint "Evolutions in 3D numerical relativity using fixed mesh refinement" as gr-qc/0310042. Its main point is to present tests of Carpet with the BSSN code (AEI's spacetime evolution code), and to show that mesh refinement does not introduce instabilities.
In August 2003, these web pages were created.
May 2003 has informally been termed "Carpet month". In a flurry of activity, bugs were fixed and some features added. The BSSN code of the numerical relativity group at the AEI now works together with Carpet.
Documentation
We have accumulated a few pieces of documentation:
- An introduction (ps, 300 kB) to Carpet, as well as a guide to the first steps for using it. Everybody should have read this. (This is the same as the Arrangement Guide from the Carpet sources.)
- An explanation of the internal workings (ps, 130 kB) of Carpet. You should read this if you want to modify Carpet.
- The individual Thorn Guides of Carpet. They are available with the source code. They give details about the thorns' APIs and user interfaces.
- Thanks to Doxygen, we now have an overview over all the routines and data structures in Carpet. Most individual Doxygen tags are still missing, but the extracted documentation is already very useful. (The online documentation might not always be up to date; in case of doubt, extract the documentation yourself.)
Interacting with the developers
Most discussions about Carpet, i.e. user questions, feature requests, and bug reports, are held on the Carpet developers' mailing list developers@lists.carpetcode.org. You can subscribe and unsubscribe from our list management web page. You will also find the mailing list archive there. We thank Daniel Kobras for managing the mailing list server.
We have started to use Bugzilla to keep track of requested features or reported bugs in Carpet. You can submit or comment on issues from our Bugzilla pages once you have created an account there. The old list of missing features and list of known bugs have not yet been moved over to Bugzilla.
Getting the code
Carpet is distributed under the GNU General Public License (GPL). It might be released under the GNU Lesser General Public License (LGPL) in the future, to match the distribution terms of Cactus.
Carpet is a driver for Cactus. It works as a part of Cactus, and you will need to have the developers' version of Cactus installed before you can use Carpet. Please look at the Cactus web pages for and introduction to Cactus and for installation instructions.
Carpet is available via anonymous CVS. The CVSROOT is
:pserver:cvs_anon@cvs.carpetcode.org:/home/cvs, and
the module is called Carpet. This module is an
arrangement in Cactus, which means that you should check it out
into your Cactus arrangements directory. The
password for anonymous CVS access is anon. We thank
the Institut für
Astronomie und Astrophysik of the Universität Tübingen for
hosting the CVS server.
Pretty pictures
We are currently collecting pretty pictures and movies of simulations that were performed with Carpet. Sorry; there is nothing to see so far.
Making sense of results
Three-dimensional time-dependent simulation results are difficult enough to interpret when the grid is uniform. With mesh refinement, the sheer amount of available data makes it necessary to use professional tools to examine the data. This is not only the case for "big physics runs", where one (should) know in advance what to expect, but especially during development, where things do not always go as planned. Thomas Radke was kind enough to write an import module for the visualisation tool OpenDX. He has also produced an example picture (JPEG, 300 KB) from a test run with the scalar wave equation.
Related projects
- Cactus
- HDF5
- OpenDX
Last modified: Sun Jan 18 12:29:18 CET 2004