diff options
author | Anton Khirnov <anton@khirnov.net> | 2014-12-01 13:16:05 +0100 |
---|---|---|
committer | Anton Khirnov <anton@khirnov.net> | 2014-12-01 13:18:08 +0100 |
commit | db77d3ae71ed866ea58ab0bafb9a1d8dba59981c (patch) | |
tree | 598d308dac97f0f5dcb8f1942b73b63e5e623b9e /README | |
parent | b4cc938cd7378fa4e1d6ec2eb966e6fc657f10e1 (diff) |
Add readme, licence and gitignore files.
Diffstat (limited to 'README')
-rw-r--r-- | README | 33 |
1 files changed, 33 insertions, 0 deletions
@@ -0,0 +1,33 @@ +Overview +======== + +This is a small C library for constructing initial data data for Brill waves +(see e.g. http://arxiv.org/abs/gr-qc/9302023) to be used in 3+1 general +relativity simulations. + +The construction involves solving an elliptic equation for the conformal factor. +This is done using a pseudo-spectral method by expanding the conformal factor in +the basis of SB functions (see Boyd 2000, chapter 17.9). The pseudo-spectral +matrix is inverted with LAPACK. + +Building and installation +========================= + +The library requires GSL and LAPACKE (the C interface to LAPACK) to be present +where the compiler and linker can find them. A C99-compliant compiler and a +POSIX environemtn are expected. + +Simply running 'make' will then build the shared library libbrilldata.so. That +must be copied manually to where your linker will find it (or set +LD_LIBRARY_PATH accordingly on systems that support it). + +Usage +===== + +The public C API is described in the brill_data.h header. + +Licence +======= + +This library is free software, available under GNU GPLv3 (see the LICENCE file +for full licence text). |