diff options
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/index.rst | 1 | ||||
| -rw-r--r-- | doc/introduction.rst | 39 |
2 files changed, 40 insertions, 0 deletions
diff --git a/doc/index.rst b/doc/index.rst index 98f1e76..7b156d3 100644 --- a/doc/index.rst +++ b/doc/index.rst @@ -5,6 +5,7 @@ Wolff Library .. toctree :: :maxdepth: 2 + introduction examples models system 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. + |