aboutsummaryrefslogtreecommitdiff
path: root/README
diff options
context:
space:
mode:
Diffstat (limited to 'README')
-rw-r--r--README33
1 files changed, 33 insertions, 0 deletions
diff --git a/README b/README
new file mode 100644
index 0000000..6f00bda
--- /dev/null
+++ b/README
@@ -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).