aboutsummaryrefslogtreecommitdiff
path: root/Carpet/CarpetWeb/index.html
blob: eeebf82016cc69e700118ea29067f9117984ee92 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
<?xml version="1.0" encoding="ISO-8859-15"?>
<!DOCTYPE html
     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
     "DTD/xhtml1-transitional.dtd">
<!-- $Header:$ -->
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-15" />
    <title>CarpetCode</title>
  </head>
  
  <body>

    <h1 align="center">CarpetCode</h1>

<table>
<tr>
<td valign="top" bgcolor="#ffcc77" width="1%">

<p><b>CarpetCode</b><br />
<a href="http://www.carpetcode.org/">home page</a></p>

<p><b>Documentation</b><br />
<a href="doc/documentation.ps">Introduction</a> (ps,&nbsp;300&nbsp;kB)<br />
<a href="doc/first-steps.ps">First Steps</a> (ps,&nbsp;160&nbsp;kB)<br />
<a href="doc/internals.ps">Internals</a> (ps,&nbsp;130&nbsp;kB)</p>

<p><b>Mailing lists</b><br />
<a href="http://lists.carpetcode.org/listinfo/developers/">Subscribe</a><br />
<a href="http://lists.carpetcode.org/archives/developers/">Archive</a><br />
<a href="http://lists.carpetcode.org/listinfo/carpet-cvs/">CVS messages</a><br />
<a href="http://lists.carpetcode.org/listinfo/carpet-darcs/">darcs messages</a></p>

<p><b>Development</b><br />
<a href="http://darcs.net/">Darcs</a><br />
<a href="http://bugs.carpetcode.org/">Bugzilla</a><br />
<a href="feature-requests.html">Missing&nbsp;features</a></p>

<p><b>Related</b><br />
<a href="http://www.cactuscode.org/">Cactus</a><br />
<a href="http://numrel.aei.mpg.de/">numrel@aei</a><br />
<a href="http://www.aei.mpg.de/~hawke/Whisky.html">Whisky</a></p>

<p><b>Carpet Users</b><br />
<a href="http://numrel.aei.mpg.de/">AEI Potsdam</a><br />
<a href="http://www.cct.lsu.edu/">CCT</a><br />
<a href="http://www.mpa-garching.mpg.de/hydro/index.shtml">MPA Garching</a><br />
<a href="http://www.astro.psu.edu/nr/">Penn State</a><br />
<a href="http://www.sissa.it/ap/RelAstro/">SISSA</a><br />
<a href="http://www.maths.soton.ac.uk/applied/relativity/">Southampton</a></p>

<p><b>Feedback</b><br />
<a href="mailto:schnetter@aei.mpg.de">Send email</a></p>

</td>
<td valign="top">

    <p>Carpet is a mesh refinement driver for <a
    href="http://www.cactuscode.org/">Cactus</a>.  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 <a
    href="http://www.tat.physik.uni-tuebingen.de/~schnette/">Erik
    Schnetter</a> at the <a
    href="http://www.tat.physik.uni-tuebingen.de/">TAT</a>
    (Theoretische Astrophysik T�bingen) and is currently maintained at
    the <a href="http://www.aei.mpg.de/">AEI</a> (Max-Planck-Institut
    f�r Gravitationsphysik, Albert-Einstein-Institut).  These pages
    describe Carpet and its current development.</p>
      
    <hr />

    <h2>News</h2>

    <p><b>December 7, 2004:</b> Jonathan Thornburg is organising a <a
    href="design-walkthrough.html">Carpet Design Walkthrough</a>,
    which will take place December 13 to 15 at the AEI and will be
    broadcast via the accessgrid and/or telephone.</p>

    <p><b>Sepbember 18, 2004:</b> There is now a new repository for
    the development version of Carpet.  This repository is managed by
    <a href="http://darcs.net/">darcs</a> instead of <a
    href="https://www.cvshome.org/">CVS</a>.  Darcs has a number of
    advantages, such as being able to use it while offline, or keeping
    some changes to yourself while developing.  This development
    version is <a href="get-carpet-darcs.html">publicly available</a>,
    and we encourage you to <a
    href="work-with-darcs.html">contribute</a>.  Note that the stable
    version of Carpet is still distributed via CVS.</p>

    <p><b>August 24, 2004:</b> The version of Carpet in the CVS
    repository is now stable.  That means that this version will see
    no substantial further development.  One of its main goal is to
    not change, so that parameter files continue to work unchanged
    with identical results.  We will continue to correct errors that
    we find in this version of Carpet; however, if this would
    necessitate major changes, and there is a work-around, then this
    might not happen in the interest of stability.</p>

    <p><b>July 31, 2004:</b> Carpet seems to have reached a point
    where it is stable enough to be useful for at least some projects.
    Consequently, people expressed the wish to have a version of
    Carpet which is stable and sees no disrupting development.  The
    idea is to have two "branches" of Carpet: a stable version for
    production use, and a development version which might not be as
    stable.  We plan to make the split in about three weeks.  The
    discussion about this is held on the mailing list; your input is
    welcome.</p>

    <p><b>April 7, 2004:</b> Up to now, all Carpet thorns have been
    living in a single arrangement for Cactus.  This caused problems,
    because stable thorns, development thorns, and outdated thorns
    were sitting next to each other, confusing newcomers.  We have <a
    href="#getting-the-code">moved the Carpet arrangement</a> to a new
    repository and split it into four.  Access to the old Carpet
    arrangement has been disabled.</p>

    <p><b>March 3, 2004:</b> We have recently had trouble with I/O
    throuth the <a
    href="http://zeus.ncsa.uiuc.edu/~jshalf/FlexIO/">FlexIO</a>
    library.  We suspect that it might have a bug that causes HDF5
    output to fail under certain, random conditions.  We have written
    a new thorn CarpetIOHDF5 which uses the <a
    href="http://hdf.ncsa.uiuc.edu/HDF5/">HDF5</a> library directly,
    while remaining compatible to the FlexIO file format.  Please test
    this thorn, and report any problems or incompatibilities you
    find.</p>

    <p>In <b>January 2004</b>, <a
    href="http://www.tat.physik.uni-tuebingen.de/~kobras/">Daniel
    Kobras</a> set up <a href="http://bugs.carpetcode.org/">Bugzilla
    for Carpet</a>.  <a href="http://www.bugzilla.org/">Bugzilla</a>
    is a bug-tracking system that will, so we hope, help us remember
    what is missing or broken in Carpet.</p>

    <p><a href="olds.html"><b>Old News...</b></a></p>

    <hr />

    <h2>Documentation</h2>

    <p>We have accumulated a few pieces of documentation:</p>
    <ul>
      <li>An <a href="doc/documentation.ps">introduction</a>
      (ps,&nbsp;300&nbsp;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.)</li>

      <li><a
      href="http://www.astro.psu.edu/nr/people/sperhake_ulrich.html">Ulrich
      Sperhake</a> wrote a tutorial outlining the <a
      href="doc/first-steps.ps">first steps</a> (ps,&nbsp;160&nbsp;kB)
      that one has to take to install Carpet and run an example
      application.</li>

      <li>An explanation of the <a href="doc/internals.ps">internal
      workings</a> (ps,&nbsp;130&nbsp;kB) of Carpet.  You should read
      this if you want to modify Carpet.</li>

      <li>The individual Thorn Guides of Carpet.  They are available
      with the source code.  They give details about the thorns' APIs
      and user interfaces.</li>

      <li>Thanks to <a
      href="http://www.stack.nl/~dimitri/doxygen/">Doxygen</a>, we now
      have an <a href="doxygen/html/index.html">overview</a> 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.)</li>
    </ul>

    <hr />

    <h2>Interacting with the developers</h2>

    <p>Most discussions about Carpet, i.e. user questions, feature
    requests, and bug reports, are held on the Carpet developers'
    mailing list <a
    href="mailto:developers@lists.carpetcode.org">developers@lists.carpetcode.org</a>.
    You can subscribe and unsubscribe from our <a
    href="http://lists.carpetcode.org/">list management web page</a>.
    You will also find the mailing list archive there.  We thank <a
    href="http://www.tat.physik.uni-tuebingen.de/~kobras/">Daniel
    Kobras</a> for managing the mailing list server.</p>

    <p>We have started to use <a
    href="http://www.bugzilla.org/">Bugzilla</a> to keep track of
    requested features or reported bugs in Carpet.  You can submit or
    comment on issues from our <a
    href="http://bugs.carpetcode.org/">Bugzilla pages</a> once you
    have created an account there.  The old <a
    href="feature-requests.html">list of missing features</a> have not
    yet been moved over to Bugzilla.</p>

    <hr />

    <h2 id="getting-the-code">Getting the code</h2>

    <p>Carpet is distributed under the <a
    href="http://www.gnu.org/licenses/licenses.html">GNU General
    Public License (GPL)</a>.  It might be released under the GNU
    Lesser General Public License (LGPL) in the future, to match the
    distribution terms of Cactus.</p>

    <p>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 <a
    href="http://www.cactuscode.org/">Cactus web pages</a> for an
    introduction to Cactus and for installation instructions.</p>

    <p>Carpet is available via anonymous <a
    href="http://www.cvshome.org/">CVS</a>.  The CVSROOT is
    <code>:pserver:cvs_anon@cvs.carpetcode.org:/home/cvs/carpet</code>,
    and there are several arrangements, each living in a directory.
    The arrangement <code>Carpet</code> contains the basic driver part
    that everybody needs.  The arrangement <code>CarpetExtra</code>
    contains useful add-ons and some example code.  Development of new
    thorns happens in the <code>CarpetDev</code> arrangement, which
    means that the code in there is not to be trusted.  And finally,
    there is a graveyard arrangement <code>CarpetAttic</code> of
    things that only used to be useful and are now in a state of
    decay.</p>

    <p>The password for anonymous CVS access is <code>anon</code>.  We
    thank the <a
    href="http://www.tat.physik.uni-tuebingen.de/">Institut f�r
    Astronomie und Astrophysik</a> of the Universit�t T�bingen for
    hosting the CVS server.</p>

    <hr />

    <h2>Pretty pictures</h2>

    <p>Here are some pretty pictures of simulations that were
    performed with Carpet:</p>

    <table>
    <tr>

      <td valign="top" width="10%">
      <p><a href="pictures/meudon-lapse-height.png"><img
      src="pictures/thumbnail-meudon-lapse-height.png" height="80"
      width="80" alt="lapse height field"/></a></p>
      </td>

      <td valign="top" width="38%">
      <p>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.</p>
      </td>

      <td valign="top" width="4">
      </td>

      <td valign="top" width="10">
      <p><a href="pictures/quadrupole.jpeg"><img
      src="pictures/thumbnail-quadrupole.jpeg" height="80" width="80"
      alt="quadrupole wave" /></a></p>
      </td>

      <td valign="top" width="38%">
      <p>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.</p>
      </td>

    </tr>
    <tr>

      <td valign="top">
      <p><a href="pictures/meudon-lapse-iso.png"><img
      src="pictures/thumbnail-meudon-lapse-iso.png" height="80"
      width="80" alt="lapse isosurfaces" /></a></p>
      </td>

      <td valign="top">
      <p>Lapse isosurfaces in a binary black hole system.  The same
      system as above, but the lapse function is rendered as
      isosurfaces.</p>
      </td>

      <td valign="top">
      </td>

      <td valign="top">
      <p><a href="pictures/collapse-vel-x.png"><img
      src="pictures/thumbnail-collapse-vel-x.png" height="80"
      width="80" alt="velocity component" /></a></p>
      </td>

      <td valign="top">
      <p>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.</p>
      </td>

    </tr>
    </table>

    <p>Sorry; no movies so far.</p>

    <hr />

    <h2>Making sense of results</h2>

    <p>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.  <a
    href="http://www.aei.mpg.de/~tradke/">Thomas Radke</a> was kind
    enough to write an <a
    href="http://www.cactuscode.org/VizTools/OpenDX.html">import
    module</a> for the visualisation tool <a
    href="http://www.research.ibm.com/dx/">OpenDX</a>.</p>

    <hr />

    <h2>Related projects</h2>

    <ul>
    <li>Physics: <a href="http://www.cactuscode.org/">Cactus</a>, <a
    href="http://numrel.aei.mpg.de/">numrel@aei</a>, <a
    href="http://www.aei.mpg.de/~hawke/Whisky.html">Whisky</a></li>

    <li>I/O: <a href="http://hdf.ncsa.uiuc.edu/HDF5/">HDF5</a>, <a
    href="http://www.zib.de/benger/F5/doc/">F5</a></li>

    <li>Visualisation: <a href="http://www.amiravis.com/">Amira</a>,
    <a href="http://www.opendx.org/">OpenDX</a></li>
    </ul>

    <hr />

    <p>
      <a href="http://www.xemacs.org/About/created.html"><img
      src="cbxSmall.jpg" alt="Created with XEmacs!" height="36"
      width="100" /></a>
      
      <a href="http://www.anybrowser.org/campaign/"><img
      src="logoab8.png" alt="Best Viewed With Any Browser" height="31"
      width="88" /></a>

      <a href="http://validator.w3.org/check?uri=referer"><img
      src="valid-xhtml10.png" alt="Valid XHTML 1.0!" height="31"
      width="88" /></a>
    </p>
    
    <address><a href="mailto:schnetter@uni-tuebingen.de">Erik Schnetter</a></address>
<p>
<!-- Created: Tue Aug 12 12:12:08 CEST 2003 -->
<!-- hhmts start -->
Last modified: Mon Dec 27 22:57:40 CET 2004
<!-- hhmts end -->
</p>

</td>
</tr>
</table>
  </body>
</html>