From 3fe64420f18718e585cb36f4331edbf74a3d480e Mon Sep 17 00:00:00 2001 From: Jaron Kent-Dobias Date: Fri, 19 Oct 2018 15:37:25 -0400 Subject: added introduction to the documentation --- doc/introduction.rst | 39 +++++++++++++++++++++++++++++++++++++++ 1 file changed, 39 insertions(+) create mode 100644 doc/introduction.rst (limited to 'doc/introduction.rst') diff --git a/doc/introduction.rst b/doc/introduction.rst new file mode 100644 index 0000000..9f0b190 --- /dev/null +++ b/doc/introduction.rst @@ -0,0 +1,39 @@ + +************ +Introduction +************ + +A library for running the Wolff algorithm on arbitrary systems in arbitrary +fields. A "spin state" and "spin symmetry transformation" type must be supplied +to define a system, along with a spin-spin coupling, a spin-field coupling, +and a generator of transformations of rank two. The library then supplies the +tools to run Wolff cluster-flip Monte Carlo on the resulting system, with +arbitrary measurements taken along the way. + +A detailed description of the algorithm and its requirements can be found at https://arxiv.org/abs/1805.04019. + +Getting Wolff +============= + +This source for this library is available at https://git.kent-dobias.com/wolff/. + +Installation +============ + +The only dependencies are a modern C++ compiler, cmake, and the standard libraries. With those at hand, the Wolff library and the provided examples can be built and installed using + +.. code-block:: bash + + git clone https://git.kent-dobias.com/wolff/ + mkdir wolff/build + cd wolff/build + cmake .. + make install + +Custom install paths and compiler optimizations can be passed to cmake in the standard ways. + +License +======= + +Wolff is licensed under the MIT license, a copy of which is included with the source code. The terms can be found here: https://spdx.org/licenses/MIT.html. + -- cgit v1.2.3-70-g09d2