[Users] Cactus documentation in Kranc-generated thorns?
schnetter at cct.lsu.edu
Tue Apr 2 17:35:01 CDT 2013
I recommend using ThornDoc and ArrangementDoc instead of ThornGuide. This
directory should show up when you "make ArrangementDoc".
On Tue, Apr 2, 2013 at 5:36 PM, Kelly, Bernard J. (GSFC-660.0)[UNIVERSITY
OF MARYLAND BALTIMORE COUNTY] <bernard.j.kelly at nasa.gov> wrote:
> Hi Ian.
> Yes, I saw the McLachlan/doc directory, but of course that won't show up
> in a Cactus-generated ThornGuide, even if it *did* contain the information
> we're talking about.
> It's true that thorn documentation can easily go out of date, but if the
> .tex file is date-stamped (or even release-stamped), it should inform the
> reader as to how up-to-date it is. And the current alternative is no
> documentation at all ...
> From: Ian Hinder <ian.hinder at aei.mpg.de>
> Date: Tuesday, April 2, 2013 5:28 PM
> To: Bernard Kelly <bernard.j.kelly at nasa.gov>
> Cc: "users at einsteintoolkit.org" <users at einsteintoolkit.org>
> Subject: Re: [Users] Cactus documentation in Kranc-generated thorns?
> On 2 Apr 2013, at 23:16, "Kelly, Bernard J. (GSFC-660.0)[UNIVERSITY OF
> MARYLAND BALTIMORE COUNTY]" <bernard.j.kelly at nasa.gov> wrote:
> I recently went through the main McLachlan_BSSN.m Kranc/Mathematica
> script, noting the exact form of the BSSNOK evolution equations, as well
> as their CCZ4 and GSFC variants. It occurred to me that these would be
> useful things to have in a human-readable format, as part of the ML_BSSN
> (say) thorn documentation. But of course, there *is* not ML_BSSN/doc
> directory by default.
> Can McLachlan.m incorporate external documentation? Perhaps something
> stored in the "prototype" subdirectory could be added to the newly
> generated thorn?
> There is arrangement documentation in McLachlan/doc. This could be added
> to. I have always wanted Kranc to output documentation LaTeX files
> including the equations in tensorial form, but have not implemented this.
> One problem was that there was no good way to automatically line-break the
> equations in LaTeX. I think there are some hacks, but nothing reliable. I
> would prefer the equation documentation to be automatically-generated, as
> otherwise it risks becoming out of date.
> Ian Hinder
> Users mailing list
> Users at einsteintoolkit.org
Erik Schnetter <schnetter at cct.lsu.edu>
-------------- next part --------------
An HTML attachment was scrubbed...
More information about the Users