CarpetCode
home page
Documentation
Introduction (ps, 300 kB)
First Steps (ps, 160 kB)
Internals (ps, 130 kB)
Mailing lists
Subscribe
Archive
CVS messages
darcs messages
Development
Status reports
Download
Bugzilla
Missing features
Visualisation
Tools
Mailing list
Results
Publications
Related
Cactus
numrel@aei
Whisky
Taka
Carpet Users
AEI Potsdam
CCT
MPA Garching
Penn State
SISSA
Southampton
TAT/CPT
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 later brought into production use by Erik Schnetter, Scott Hawley, and Ian Hawke at the AEI (Max-Planck-Institut für Gravitationsphysik, Albert-Einstein-Institut). Carpet is currently maintained at the CCT (Center for Computation & Technology) at LSU. These pages describe Carpet and its current development.
News
February 26, 2006: We have started to collect a list of publications and theses that use Carpet. Please tell us if you have written a publication or a thesis using Carpet.
February 25, 2006: Christian Ott has contributed code to Carpet, making the refined regions track apparent horizon centroids, merging and un-merging refined regions as necessary. (Movie, animated gif, 730 kB.) After Burkhard Zink's mechanism which tracks the density maximum in a star, this is the second implementation of a production level adaptive mesh refinement criterion in Carpet.
February 25, 2006: The official Cactus benchmarks now include benchmarks with Carpet. You can assess Carpet's scaling and compare its performance on different machines by generating graphs from the benchmark result database on these pages.
July 15, 2005: We have now a page that links to all past montly status reports.
June 6, 2005: We have updated the downloading instructions for Carpet.
June 6, 2005: Version 1.0.3 of the pre-compiled darcs binary is now available.
April 13, 2005: Thomas Radke has implemented a new communication scheme in Carpet. Instead of sending many small messages in an interleaved manner, Carpet now collects all messages into an internal buffer and sends only one big message with MPI. This circumvents certain problems with internal limitations of MPICH, and it also improves the performance greatly.
March 9, 2005: We have started to move towards a new stable version of 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.)
- Ulrich Sperhake wrote a tutorial outlining the first steps (ps, 160 kB) that one has to take to install Carpet and run an example application.
- 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 have not yet been moved over to Bugzilla.
Pretty pictures
Here are some pretty pictures of simulations that were performed with Carpet:
|
|
Cut through a binary black hole system. Height field of the lapse function (approximately the time dilatation) in a binary black hole system calculated from Meudon initial data. The system is cut between the two black holes, so that only one black hole is visible. The white boxes indicate the hierarchy of refinement regions. |
|
A quadrupole wave. Two rotating scalar charges create a quadrupolar wave, mimicing the gravitational wave trail of a binary black hole system. The small bumps and riddles are artifacts caused by the discontinuous charge distribution. To be improved. |
|
|
|
Lapse isosurfaces in a binary black hole system. The same system as above, but the lapse function is rendered as isosurfaces. |
|
A velocity component in a stellar core collapse. The x component of the fluid velocity in a stellar core collapse. This simulation was performed by Christian Ott. |
Moving pictures: We can show a movie (animated gif, 3.1 MB) of a scalar wave equation with adaptive mesh refinement. The refinement criterion is a very simplistic local truncation error estimate. We also have a movie (animated gif, 730 kB) of a moving refinement region tracking a black hole.
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.
Related projects
Last modified: Sun Feb 26 2006